Te Ug 73 20110121

Wavelink Terminal Emulation Client User Guide
Version 7.3 tn-ug-20110121
Revised 21/1/2011
ii
Copyright2011byWavelinkCorporation.Allrightsreserved. WavelinkCorporation 10808SouthRiverFrontParkway,Suite200 SouthJordan,Utah84095 Telephone:(801)3169000 Fax:(801)3169099 Email:customerservice@wavelink.com Website:http:\\www.wavelink.com Nopartofthispublicationmaybereproducedorusedinanyform,orbyanyelectricalor mechanicalmeans,withoutpermissioninwritingfromWavelinkCorporation.Thisincludes electronicormechanicalmeans,suchasphotocopying,recording,orinformationstorageand retrievalsystems.Thematerialinthismanualissubjecttochangewithoutnotice. Thesoftwareisprovidedstrictlyonanasisbasis.Allsoftware,includingfirmware,furnished totheuserisonalicensedbasis.Wavelinkgrantstotheuseranontransferableandnon exclusivelicensetouseeachsoftwareorfirmwareprogramdeliveredhereunder(licensed program).Exceptasnotedbelow,suchlicensemaynotbeassigned,sublicensed,orotherwise transferredbytheuserwithoutpriorwrittenconsentofWavelink.Norighttocopyalicensed programinwholeorinpartisgranted,exceptaspermittedundercopyrightlaw.Theusershall notmodify,merge,orincorporateanyformorportionofalicensedprogramwithotherprogram material,createaderivativeworkfromalicensedprogram,orusealicensedprogramina networkwithoutwrittenpermissionfromWavelink.TheuseragreestomaintainWavelinks copyrightnoticeonthelicensedprogramsdeliveredhereunder,andtoincludethesameonany authorizedcopiesitmakes,inwholeorinpart.Theuseragreesnottodecompile,disassemble, decode,orreverseengineeranylicensedprogramdeliveredtotheuseroranyportionthereof. Wavelinkreservestherighttomakechangestoanysoftwareorproducttoimprovereliability, function,ordesign. Theinformationinthisdocumentisboundbythetermsoftheenduserlicenseagreement.
Table of Contents
Table of Contents
Chapter 1: Introduction 6 FeaturesoftheTEClient..........................................6 AboutThisGuide................................................7 Chapter 2: Installation and Licensing 9 ConfiguringandDeployingtheTEClient ...........................9 UsingAvalanchetoConfiguretheTEClient ....................11 UsingAvalanchetoDeploytheTEClientandConfiguration......12 UsingActiveSynctoConfigureandDeploytheTEClient.........13 LicensingtheTEClient ...........................................14 TypesofLicenses ...........................................14 LicensingMethods..........................................15 ManuallyLicensingtheTEClient .........................16 UsingtheLicenseServertoLicensetheTEClient............16 UsingtheDemoLicense .................................17 ConfiguringtheLicenseServerAddress........................18 Chapter 3: Host Profiles 20 ConfiguringaHostProfile ........................................20 AddingorModifyingaHostProfile...........................21 HostProfileConfigurationOptions............................22 HostTab ...............................................23 TermProxyTabs ........................................25 IBMSettingsTab ........................................27 VTSettingsTab .........................................27 HTTPProxyTab........................................28 HTTPSProxyTab.......................................28 AccessListTab .........................................28 AutologinSettings ......................................29 AutoLaunchTab ........................................30 ConfigurationTab.......................................31 LanguageTab ..........................................31 ModemTab............................................31 SubnetSpecificAddresses................................35 HostProfilesandSSL/TLS........................................36 InstallingtheSSL/TLSSupportUtilityontheHostSystem ........37 InstallingtheSSL/TLSSupportPackageontheClient ............37 EnablingSSL/TLS...........................................37 HostProfilesandWavelinkConnectProorTermProxy................40 ConfiguringaConnectProorTermProxyOnlyHostProfile ......40 ConfiguringConnectPro/TermProxyFailover ...................42
Table of Contents
Chapter 4: Emulation Parameters 43 ConfiguringEmulationParameters ................................43 AccessingGlobalParametersUsingMicrosoftActiveSync........44 AccessingGlobalParametersUsingAvalanche..................46 AccessingPerHostParametersUsingMicrosoftActiveSync......47 AccessingPerHostParametersUsingAvalanche................49 UsingtheConfigurationManager .................................50 ModifyingEmulationParameters .............................51 UsingtheFindFunction .....................................52 SwitchingtoAlphabetizedView ..............................52 Chapter 5: Scripting 54 OverviewofScripting ............................................54 LaunchingtheScriptEditor .......................................55 CreatingScriptsUsingtheScriptEditor.............................56 SelectingtheActivationMethod ..............................57 CreatingtheScriptCode.....................................58 CreatingVariables ..........................................58 SelectingHostProfiles.......................................59 PerformingScriptCapturing......................................60 EditingScripts ..................................................62 ImportingScripts ................................................63 SavingandExportingScripts......................................63 DeployingScripts................................................64 ExecutingScripts................................................64 SelectfromMenu ...........................................65 OnKeyCombination........................................66 WhenSessionConnects ......................................66 OnBarcode,MSR,orRFIDScan...............................66 OnScreenUpdate ...........................................67 Chapter 6: Keyboard Creator 69 LaunchingtheKeyboardCreator ..................................69 SelectingKeyboardFiles..........................................70 CreatingKeyboards ..............................................71 AddingaKeyboard .........................................71 SizingKeyboards ...........................................72 DeletingKeyboards .........................................72 ImportingKeyboardGraphics.....................................72 CreatingandConfiguringKeys....................................73 AddingaNewKey ..........................................74 SizingandPositioningKeysandRows .........................76 DeletingKeys...............................................77 DeployingtheKeyboardtotheTEClient ...........................77
Table of Contents
Chapter 7: Resource Editor 78 LaunchingtheResourceEditor....................................78 AddingaBitmap................................................79 AddingaSound .................................................79 EditingFiles ....................................................80 DeployingFilestotheTEClient ...................................80 Chapter 8: Reformatting Emulation Screens 81 PerformingaScreenCapture ......................................82 UsingtheScreenReformatter .....................................83 TreeView ..................................................84 InitialScreenView ..........................................85 ModifiedScreenView .......................................85 DescriptiveView............................................86 StatusBar..................................................87 ToolBar ...................................................88 ImportingScreens ...............................................88 OrganizingScreens ..............................................89 ModifyingaScreen ..............................................90 Renaming,Duplicating,orDeletingaScreen....................90 CopyingText ...............................................91 AddingTexttotheModifiedScreen...........................92 ChangingtheFontSize ......................................93 ResizingtheModifiedScreen.................................93 ChangingtheBackgroundColoroftheScreen ..................94 AssigninganInitialFieldValue ...............................95 CreatingScreenComments ...................................96 UsingScreenTemplates......................................96 VerifyingaScreen ...............................................97 AddingHostProfileVerification..............................98 AddingTextVerification .....................................98 AddingCursorVerification...................................99 AddingFieldVerification ....................................99 OrderingorDeletingVerificationItems........................100 SpeakeasyandScriptingSupport..................................100 AddingTexttoSpeechSupport ...............................100 AddingSpeechtoTextSupport ...............................102 AddingScriptingSupport ....................................108 OrderingScreenActions.....................................109 DeployingReformattedScreens ...................................110 ExportingScreens ...............................................110 ExportingaMasterFile ......................................110 ExportingaScreenCaptureFile ...............................111 Chapter 9: Using the TE Client 112 CreatinganEmulationSession ....................................112
Table of Contents
LaunchingtheTEClient .....................................112 InitiatinganEmulationSession ...............................114 DisconnectinganEmulationSession ...........................115 ExitingtheTEClient.........................................116 WorkingwithMultipleConcurrentEmulationSessions ...............117 AllowingMultipleConcurrentSessions ........................117 InitiatinganAdditionalEmulationSession.....................118 SwitchingBetweenActiveEmulationSessions..................119 UsingtheVirtualEmulationKeyboard .............................120 UsingtheDefaultVirtualEmulationKeyboard..................121 Usingthe5250/3270VirtualEmulationKeyboard................122 UsingtheVT/HPVirtualEmulationKeyboard ..................124 UsingtheWEBVirtualEmulationKeyboard ....................126 UsingScreenPanning............................................127 UsingActiveText ................................................128 SimpleNumberMenuItem...................................129 AS/400StyleFunctionKey ...................................129 UsingtheTEClientDiagnosticsUtility.............................130 PerformingaKeyboardTest ..................................131 PerformingaWindowsKeyboardTest .........................132 PerformingaScanTest.......................................133 UsingtheTEClientOptionsMenu .................................134 LaunchingtheTEClientUsingCommandLineArguments ...........136 LaunchingtheTEClientviaCommandPrompt.................136 CreatingaCommandLineURLHostProfile....................136 Chapter 10: Industrial Browser (WEB Emulation) 137 BasicNavigation ................................................137 SpecifyingtheHomePage........................................138 Chapter 11: Avalanche Integration 139 SessionMonitor.................................................139 ConfiguringSessionMonitor .................................139 LaunchingSessionMonitor...................................141 SessionOverride ............................................142 TracingSessions ............................................142 RealTimeStatistics..............................................143 ViewingRealTimeStatistics..................................144 ModifyingRealTimeStatistics................................146 Chapter 12: Configuring the TE Client from the Mobile Device 147 ConfiguringHostProfilesfromtheClient...........................147 AccessingHostProfilesfromtheClient........................147 CreatingaNewHostProfilefromtheClient ....................148 ModifyinganExistingHostProfile............................149 DeletinganExistingHostProfile ..............................149
Table of Contents
EditingPerHostEmulationParametersfromtheClient...............150 VTXXSettings..............................................151 IBMHostSettings ...........................................152 WEBSettings ...............................................152 MessageSettings ............................................153 FontSettings ...............................................155 DisplaySettings.............................................156 ViewSettings ...............................................157 CursorSettings .............................................158 BeepsSettings ..............................................159 TelnetSettings ..............................................160 PrinterSettings .............................................160 Appendix A: Common Configuration Tasks 162 ConfiguringPasswords...........................................162 ConfiguringPrintingOnaNetwork................................164 ConfiguringTEClientDisplaySettings .............................164 ConfiguringTEClientLockdown ..................................166 ConfiguringKeyMacros..........................................167 ConfiguringScreenPanning ......................................169 ConfiguringActiveText...........................................170 ConfiguringScanHandlers .......................................171 ConfiguringAutologinforVTEmulation...........................172 ConfiguringTelnetNegotiationStringsforVTEmulation .............173 ConfiguringWorkstationIDsfor5250/3270Emulation................174 EnablingBatteryStrengthandSignalStrengthIcons..................175 Appendix B: Wavelink Contact Information Glossary Index 178 179 186
Chapter 1: Introduction
TheTEClientisanapplicationinstalledonamobiledeviceordesktopcomputerthat connectstoIBM5250/3270,VT100/220,XTERM,HP,andWEBhosts.TheClient connectstoapplicationsontheremotehostandemulatestheterminal.TheClient usesTelnet,SSH,SSL/TLS,HTTP,orHTTPStoconnecttoanemulationhost. Thissectioncontainsthefollowinginformation:
FeaturesoftheTEClient AboutThisGuide
Features of the TE Client

TheTEClienthasseveralfeaturesdesignedtomakeitmorefunctionalandeasyto use.Someofthemostnoticeablefeaturesinclude: HostProfilesandEmulationParameters.TheClientuseshostprofilestoconfigure howthedevicecontactstheemulationhost.TheClientallowsuptofouremulation sessionsconcurrently.ThebehavioroftheClientduringasessionisconfiguredusing emulationparameters.Emulationparametersincludeoptionsforsending informationtoaprinter,configuringdisplaysettings,devicelockdown,keymacros, screenpanning,usingActiveTextandscanhandlers,andconfiguringautologinsand negotiationstrings. KeyboardCreator.Thekeyboardcreatorallowsyoutocreateacustomvirtual keyboardtouseduringanemulationsession.Additionally,importyourowngraphic files(bitmaps)tocreateuniquebuttonsforthekeyboard. ScreenReformatter.Thescreenreformatterallowsyoutoredesignhowthe emulationscreenisdisplayedonthemobiledevice.Includeonlythetextoroptions youwanttobeavailabletotheuser.Youcanalsoaddothertextorscriptingand Speakeasyactionsforeachscreen. Scripting.Customscriptscanbeincorporatedintoanemulationsession.Youcan recordscriptsorusetheScriptEditortowritethem.Scriptscanbestartedwhenthe sessionconnectsorthescreenrefreshes,fromamenu,orbyaspecifickey combinationorwhenascanisprocessed.Youcanalsoincorporatethemintothe screenreformattertorunwithspecificscreens.
Speakeasy.SpeakeasyisanoptionalcomponentofTerminalEmulationthatcanturn texttospeechorprocessspokencommandsandoutputtextonthemobiledevice. Speakeasyislicensedandinstalledseparately. ConnectPro.TheConnectProserverisanoptionalcomponentofTerminalEmulation thathandlessessionpersistence.ConnectProactsasaproxybetweenthemobile deviceandtheemulationhost.Ifthedevicelosesconnectivityorgoestosleep,the ConnectProservermaintainsthesessionuntilthedevicereconnects.ConnectProis freewithTerminalEmulationbutisinstalledseparately. LicenseServer.TheLicenseServerisanoptionalcomponentofTerminalEmulation thathandleslicensingforTEClients.Itdistributeslicenseswirelesslyandtracks licensesthathaventbeenusedrecentlyifyouneedtoredistributeyourlicenses.The LicenseServerisfreewithTerminalEmulationbutisinstalledseparately. WEBemulation.TheTEClientincludesanIndustrialBrowserinterfacethatgives youtheabilitytoaccesswebbasedapplicationsfromamobiledevice.Developyour ownwebpagesusingMETAtagsandIDAcommandstoenablespecificfunctionality intheIndustrialBrowser.TheIndustrialBrowserissupportedPocketPC2003, WindowsMobile5.0,Windows2000/XP,andWindowsCE.NET4.2/5.0. Avalancheintegration.IfyouuseWavelinkAvalancheinconnectionwiththeTE Client,Avalancheprovidesasessionmonitor.Thesessionmonitorincludesan overridefeaturethatallowsyoutotakecontroloftheTEClient.Italsoincludesa loggingfeaturethatallowsyoutocreateatraceforemulationsessions.Avalanche alsoretrievesrealtimestatisticsfromtheClientsoyoucanviewthemattheConsole.
About This Guide

Thisguideassumesthatthereaderhasthefollowing:
FamiliaritywithWindowsCEoperatingsystemsandthemobiledevicetowhich
youaredeployingtheWavelinkTEClient.
Knowledgeofwirelessnetworksandwirelessnetworkingprotocols(IEEE
802.11b).
KnowledgeofTCP/IP,includingIPaddressing,subnetmasks,routing,BOOTP/
DHCP,WINS,andDNS.
KnowledgeofTelnetservicesandterminalemulation,includingIBM5250/3270,
HP,andVT100/220.
KnowledgeofWavelinkAvalancheandAvalancheEnablers(forusersthatintend
toinstallandconfiguretheTEClientviaAvalanche).
KnowledgeofMicrosoftActiveSync(forusersthatintendtoinstallandconfigure
theTEClientusingActiveSync. Thefollowingtableliststhedocumentconventionsusedinthismanual. Courier New Anytimeyoutypespecificinformationintoatextbox(such asafilename),thatoptionappearsinthe Courier New textstyle.Thistextstyleisalsousedforanykeyboard commandsthatyoumightneedtopress. Examples: Type Enter tocontinue. PressCTRL+ALT+DELETE. Bold Anytimeyouinteractwithanoption(suchasabuttonor descriptionsofdifferentoptionsinadialogbox),thatoption appearsintheBoldtextstyle. Examples: ClickFile>Open. Italics Anytimethisdocumentreferstoanothersectionwithinthe document,thatsectionappearsintheItalicstextstyle.This styleisalsousedtorefertothetitlesofdialogboxes. Examples: SeeFeaturesoftheTEClientonpage 6formoreinformation. TheScriptEditordialogboxappears. Forconcisionandclarity,thetermAvalancheConsoleusedinthismanualappliesto bothAvalancheMCandAvalancheSE.Formoreinformationabouteachproduct, refertothespecificuserguide.InstructionsforactionsperformedinAvalancheare tailoredtotheAvalanche5.0JavaConsole. ForacompletelistofTerminalEmulationtermsandcomponents,refertotheGlossary onpage 179.
Chapter 2: Installation and Licensing

TheTEClientmustbeconfiguredandinstalledonamobiledevicebeforeyoucanuse itforemulation.Italsoneedstobelicensedbeforeyoucanuseitwithfull functionality. TheTEClientisconfiguredtoautomaticallyreinstallintheeventofacoldboot.The coldbootrecoveryprocessensuresthatboththeTEClientapplicationand configurationsurvivethecoldboot.
NOTE TheGenericTEClientwillnotsurviveacoldboot.
ToallowtheTEClienttosurviveacoldboot,abackupcopyoftheClientisstoredin thenonvolatileFlashmemoryofthedevice.Acopyofanyconfigurationfilesforthe Clientarealsostoredinthislocation. Coldbootrecoveryprocessesvaryacrossmobiledevices.EachClientusesthe recoverymethodofthemobiledeviceforwhichithasbeendesigned. Thissectionprovidesthefollowinginformation:
ConfiguringandDeployingtheTEClient LicensingtheTEClient
Configuring and Deploying the TE Client

TheTEClientisconfiguredandinstalledusingoneofthefollowingmethods:
WavelinkAvalanche.IfyourmobiledeviceisrunningtheAvalancheEnabler,
youcanuseAvalanchetodeploytheTEClientandClientconfigurationstoa mobiledevice.
MicrosoftActiveSync.YoucaninstalltheTEClientconfigurationutilityonahost
PC.TheconfigurationutilityusesanActiveSyncconnectionbetweenthehostPC andthemobiledevicetodeploytheClientandconfigurationstothemobile device.
ThirdPartyApplications.Wavelinksupportssomethirdpartydeployment
applications.Formoreinformationaboutsupporteddeploymentsforyourdevice, pleaseseetheWavelinkWebsite.Ifyouchoosetouseathirdpartyapplicationto
10
configureandinstalltheTEClient,pleaseseethedocumentationforthat applicationfordetailsonthisprocess. DependingontheTEClientinstallationandconfigurationutilitythatyouareusing, sometoolsthatallowyoutoconfigureTEClientfeaturesmaynotbeavailable.Tools forconfigurationmayincludethefollowing:

Host Profiles
Ahostprofilecontainsalloftherequiredinformationfora mobiledevicetoconnecttoahostsystem,includinganalias, IPaddress,TCPport,andotheremulationspecific parameters.TheTEClientsupportsmultiplehostprofilesto allowauseratthedevicetoeasilycreateemulationsessions withvarioushostsystems.Forinformationontheoptions availableforahostprofile,seeHostProfilesonpage 20. Emulationparametersprovidecontrolovermanyaspectsof anemulationsession,includingkeymacros,textandscreen display,andbarcodescanning.Youmaycontrolthesettings ofanemulationsessiononagloballeveloronaperhost level.Forinformationonsettingemulationparameters,see EmulationParametersonpage 43. YoucanautomateactionsfortheTEClientusingscripting. Forexample,youmightcreatealoginscriptforusers.You mayrecordscripts,oryoumayusetheScriptEditortocreate newscriptsormodifyexistingscripts.Forinformationon creatingscriptsfortheTEClient,seeScriptingonpage 54. TheScreenReformatter(includedinTEClient7.1andlater versions)isanapplicationthatallowsyoutomodifythe appearanceofTEClientemulationscreens.Youcancreatea screenlayoutthatincludesitemsyouwantthemobiledevice usertosee,anddoesnotincludeitemsthatshouldnotbe visibletotheuser. UsetheTerminalEmulationKeyboardCreatortomodifythe standardTEClientvirtualkeyboardstomeettheneedsof yourproductionenvironment.TheKeyboardCreatorallows youtocompletelymodifythelayoutofthevirtualkeyboard foreachemulationtype.Additionally,importyourown graphicfiles(bitmaps)tocreateyourownuniquebuttonsfor thekeyboard.
Emulation Parameters
Script Editor
Screen Reformatter
Keyboard Creator
11
Resource Editor
TheResourceEditorallowsyoutodeploygraphicand soundfilestoyourmobiledevices.Youmayadd,modify anddeployany .bmp or .wav fileusingtheResource Editor. Localizationallowsyoutoconvertstringsoftextfromone languagetoanother.UsetheLocalizationtooltocreate conversions,thenconfiguretheTEClienttousethe appropriatelanguage.Forexample,youmightcreate supportfilestoconvertserverstringsfromEnglishto Spanish. IfyouhavealreadyconfiguredaTEClientandyouwantto usethatconfigurationforotherClients,youcanimportor exportsettings.
Localization
Import/Export Settings
Thissectionincludesinformationonusingthefollowingconfiguration/installation options:
UsingAvalanchetoConfiguretheTEClient UsingAvalanchetoDeploytheTEClientandConfiguration UsingActiveSynctoConfigureandDeploytheTEClient Using Avalanche to Configure the TE Client

YoucanusetheAvalancheConsoletoupdatetheTEClientconfiguration.
To configure the TE Client through Avalanche: 1 EnsurethattheTEClientAvalanchepackagehasbeenaddedtoanAvalanche
softwareprofile.
2 LaunchtheAvalancheConsole. 3 IntheProfilestab,locatetheprofilethatcontainstheTEClientpackage. 4 IntheSoftwarePackagestab,selecttheTEClientsoftwarepackageandclick
Configure. TheConfigureSoftwarePackagedialogboxappears.
12
Figure 2-1. ConfiguringtheTEClientPackage
5 Fromthemenulist,selecttheconfigurationtoolthatyouwanttouse. 6 Edittheconfigurationoptionsasdesired. 7 AfteryouhaveconfiguredthenewsettingsfortheTEClient,usetheAvalanche
Consoletodeploythenewconfigurationtothemobiledevice.
Using Avalanche to Deploy the TE Client and Configuration

AfteryouhaveconfiguredtheTEClient,deploytheconfiguration(andtheClient,ifit isnotyetinstalled).
To deploy the TE Client and/or its configuration: 1 FromtheAvalancheJavaConsole,selecttheProfilestabandclickthenameofthe
softwareprofilewiththeTEClientpackage.
2 Enabletheprofileandapplyittothelocationwhereyouwantitdeployed.If
desired,addselectioncriteriatotheprofiletorestrictthedevicesitisdeployedto.
3 EnabletheTEClientsoftwarepackage.
13
4 IfyouhaveAutoDeployenabled,theprofileisimmediatelydeployedtothe
mobiledeviceserver(s).Ifyouneedtomanuallydeploy,youcaneitherperforma universaldeploymentorrightclicktheservertowhichyouaredeployingand clickDeployNowinthecontextmenu.

5 Waitforthedevicetoupdateaccordingtoitsschedule,orrightclickadevicein
theMobileDeviceInventoryandclickUpdateNow.Youcanalsoupdatefromthe devicebylaunchingtheAvalancheEnablerandtappingFile>Connect.
Using ActiveSync to Configure and Deploy the TE Client

UsetheMicrosoftActiveSyncinstallationandconfigurationutilitytoconfigurehost profiles,emulationparameters,andlocalization.Afteryouhavecreatedthe configuration,pushtheconfigurationfilestothemobiledeviceoveraMicrosoft ActiveSyncconnectionbetweenthehostsystemandthemobiledevice.
To configure the TE Client using Microsoft ActiveSync: 1 CreateanActiveSyncconnectionbetweenthehostsystemandthedeviceyouare
deployingto.ThiscanbeaGuestoraStandardpartnership.
2 DownloadandruntheActiveSyncTEClientinstallationandconfigurationutility
onthehostsystem. TheWavelinkProductConfigurationdialogboxappears.
Figure 2-2. ActiveSyncInstallationandConfigurationUtility
14
3 ClicktheiconbuttonstoopentheTEClientconfigurationtoolsandconfigurethe
Clientasdesired.
4 UsethebuttonsApplication&Config,ApplicationOnly,andConfigOnlyto
deploytheClientand/oritsconfigurationtothedevice.
Licensing the TE Client

TheTEClientrequiresalicenseforfullfunctionality.YoucanusetheClientwithouta license,butyouwillbelimitedtothedemoversionwithoutfullfunctionality. TEClientlicensingisonaperclientbasis,notonaperconnectionbasis.Thismeans thatasinglelicenseallowstheTEClienttoengageinthemaximumnumberof emulationsessionsthattheTEClientisconfiguredtosupport(uptofourconcurrent sessions). WhentheTEClientdoesnothaveavalidlicense,itoperatesindemomode.Whenthe TEClientisoperatingindemomode,itwillbehaveasfollows:
Eachtimethatyouattempttoinitiateaterminalemulationsession,theTEClient
willbeginbroadcastinginanattempttolocatealicenseserver.Atthatpoint,you arepromptedtoeitherenteralicenseortoinitiatethesessionindemomode.
Whileindemomode,youmayinitiateterminalemulationsessionswithhosts.
However,eachterminalemulationsessionthatyouinitiatewillautomatically disconnectafteronehour. Thissectioncontainsthefollowinginformation:
TypesofLicenses LicensingMethods ConfiguringtheLicenseServerAddress Types of Licenses

Emulationlicensesarespecifictoanemulationtype(e.g.,alicensecanbeissuedfor VTemulationorWEBemulation). TherearetwotypesofTEClientlicenses:platformlicensesandmaintenancelicenses.
15
Platformlicenses.Aplatform(orbase)licenseauthorizesyoutouseaversionof
theTEClientandanybuildsassociatedwiththatversion.Forexample,ifyou purchaseda6.0TEClientlicense,thenyouareentitledtouse6.00xxbuilds.Ifyou wanttoupgradetothe7.00xxTEClient,thenyoumusteitherbuya7.0platform licenseorpurchaseamaintenancelicense.Platformlicensesdonotexpire,butthey donotallowyoutoupgradetoanewerversionoftheTEClient.
Maintenancelicenses.AmaintenancelicenseallowsyoutoupgradeyourTE
ClientwhennewmajorversionsoftheTEClientbecomeavailable.Forexample,a maintenancelicenseallowsyoutoupgradefromTEClient6.xtoTEClient7.x. Maintenancelicensesarevalidonlythroughaspecificdate.Aftertheexpiration date,ifyouupgradetheTEClient,itwillreverttooperatingindemomode.
NOTE Maintenancelicenseswereaddedtothe5.0versionoftheTEClient.Only
platformlicensesareavailablefor4.xTEClients.
Licensing Methods
TherearethreewaystolicensetheTEClient:
Prelicensing.TheTEClientmaycomepreinstalledandprelicensedonyour
mobiledevice.Forprelicensinginformation,pleaseconsultyourmobiledevice manufacturer.
Manuallicensing.YoumayusetheTEClientinterfaceonthemobiledeviceto
manuallyinputlicensinginformation.
LicenseServer.YoumayuseaLicenseServertoautomaticallyprovideTEClient
licensestothemobiledevicesonyournetwork.
NOTE ToobtainTerminalEmulationlicenses,pleasecontactWavelinkcustomer
service. Thissectionprovidesthefollowinginformation:
ManuallyLicensingtheTEClient UsingtheLicenseServertoLicensetheTEClient
16
UsingtheDemoLicense
Manually Licensing the TE Client
YoumaykeyinyourauthorizationinformationmanuallythroughtheTEClient interfaceonthemobiledevice.
To manually license a TE Client: 1 Onthemobiledevice,launchtheTEClient. 2 YoucanaddalicensebyclickingOptions>Authorizationorbyattemptingto
establishaconnectiontoahost.Whenyouattempttoconnect,theAuthorizing Terminaldialogboxappears.TapAddLicense. TheAuthorizationdialogboxappears.

3 IntheLicenseeNametextbox,typethenameofthepersonorcompanyforwhich
theClientislicensed.
4 IntheSerial#textbox,typetheserialnumberforthelicense. 5 IntheExp.Datetextbox,typetheexpirationdateofthelicense,intheformatof
MMDDYYYY.
6 IntheAuth.Codetextbox,typetheauthorizationcodeforthelicense. 7 IntheUser#textbox,enterausernumber. NOTE EachTEClientshouldhaveauniqueusernumber.Theusernumbercanbeany
numberbetween1andthemaximumnumberofusersforwhichthelicenseprovides.
8 IntheLimittextbox,enterthemaximumnumberofusersforthelicense. 9 TapAuthorize.
ThelicensetypeappearsinthePlatformtextbox.
Using the License Server to License the TE Client
ThelicenseserverisaWavelinkapplicationthatisresponsibleforsupplyinglicenses tomobiledevicesthatareusingtheTEClient.
17
NOTE TheTerminalEmulationlicenseservershouldnotbeconfusedwiththe
Avalanchelicenseserver.TheyareseparateWavelinkapplications. ForinformationaboutinstallingandconfiguringtheTEClientlicenseserver,referto theTerminalEmulationLicenseServerReferenceGuide. Whenyouattempttoinitiateanemulationsessionwithahost,iftheTEClientisnot alreadylicensed,itwillautomaticallyattempttoobtainalicensefromalicenseserver.

To use the license server to obtain a license: 1 TheTEClientbroadcastsarequestforalicenseonthelocalIPnetwork.Or,ifyou
haveconfiguredthelicenseserveraddress,theClientsendsarequesttothe specifiedlicenseserver.
NOTE Ifthelicenseserverisnotonthelocalnetworkyoumustconfigurethelicense
serverIPaddressinorderforthedevicetoobtainalicense.Formoreinformation,see ConfiguringtheLicenseServerAddressonpage 18. TheAuthorizingTerminaldialogboxdisplaysonthemobiledevicewhiletheTE Clientattemptstolocatealicenseserver.

2 Licenseserverswithanavailablelicenserespondbyofferingalicense. 3 TheTEClientacceptsthefirstlicensethatitreceivesandsendsareplytothe
licenseserver.TheAuthorizingTerminaldialogboxonthemobiledeviceindicates thatalicensehasbeenobtained. Ifnolicenseserverrespondstotherequestforalicense,thentheAuthorizing Terminaldialogboxcontinuestodisplayuntilyouclosethedialogbox,runthe Clientwithademolicense,orchoosetomanuallyaddalicense.

Using the Demo License
Thedemonstrationlicenseautomaticallydisconnectsanemulationsessionafterone hour.
To use the TE Client demo license: 1 LaunchtheTEClient. 2 UsetheTEClienttoinitiateanemulationsessionwithahost.
18
3 IfyouhaveconfiguredtheTEClientwithonlyonehostprofile,theAuthorizing
Terminaldialogboxappears. Ifyouhavemorethanonehostprofile,theSelectHostdialogboxappears.Select thehostwithwhichyouwanttoestablishanemulationsessionandthe AuthorizingTerminaldialogboxappears.

4 IntheAuthorizingTerminaldialogbox,tapStartDemo.
TheTEClientusesthedemonstrationlicenseandattemptstoconnecttothehost thatyouselected.Beforedisplayingthehostemulationscreen,theTEClient displaysascreenthatindicatesthatyouareusingademonstrationlicense.
Figure 2-3. TEClientRunninginDemonstrationMode
Configuring the License Server Address

Amobiledevicewillautomaticallyfindthelicenseserveronthelocalsubnet. However,ifyourlicenseserverislocatedonanothersubnet,youwillneedto configurethemobiledevicewiththeIPaddressofthelicenseserver. UsetheConfigurationManagertoconfigurethelicenseserverIPaddress.
To configure the IP address of a remote license server: 1 AccesstheConfigurationManager.Forinstructionsonhowtoaccessthe
ConfigurationManager,seeConfiguringEmulationParametersonpage 43.
19
2 IntheConfigurationManager,locatetheEmulation>Common>LicenseServer
Addressparameter.
3 UsetheLicenseServerAddressdialogboxtoconfiguretheIPaddressofthelicense
server.
Figure B-4. ConfiguringtheLicenseServerIPAddress
4 ClickOK. 5 Savethenewconfiguration. 6 ClosetheConfigurationManageranddownloadthenewconfigurationtothe
mobiledevice.
NOTE FormoreinformationaboutusingtheConfigurationManager,seeUsingthe
ConfigurationManageronpage 50.
Chapter 3: Host Profiles
20

AhostprofiledefinestheparametersthattheTEClientshouldusewhenitattempts toinitiateaconnectionwithaspecifichost.Youmayconfigureanunlimitednumber ofhostprofiles. WhenauseratthemobiledeviceattemptstousetheTEClienttoinitiateasession withahost,theTEClientdisplaysalistofavailablehostprofiles. Theuserselectsthehosttowhichtheywishtoconnect,andtheTEClientusesthe hostprofilesettingstoattempttoestablishasessionwiththehost. Thissectionprovidesthefollowinginformation:
ConfiguringaHostProfile HostProfilesandSSL/TLS HostProfilesandWavelinkConnectProorTermProxy
Configuring a Host Profile

Whenyouconfigureahostprofile,youdefinehowtheTEClientcreatesanemulation session.Thesesettingsmayincludetheemulationtype,IPaddressofthehost,SSL/ TLS,WAN,ConnectProorothersettings.UsetheHostProfilesdialogboxtoconfigure hostprofiles. FromtheHostProfilesdialogbox,configuretheoptionsforhowtheClientshould connecttothehost.Thissectioncontainsthefollowinginformationonconfiguring hostprofiles:
AddingorModifyingaHostProfile HostProfileConfigurationOptions
To access the Host Profiles dialog box from the ActiveSync configuration utility:
ClickHostProfiles.
To access the Host Profiles dialog box from Avalanche:
Fromthesoftwareprofile,selecttheTEClientsoftwarepackagefromthelistand
clickConfigure.Fromthelistthatappears,selectHostProfilesandclickLaunch.
21
Figure 3-1. HostProfilesDialogBox
EachhostprofilethatyouconfigureappearsinalistintheHostProfilesdialogbox. Usethearrowbuttonsatthebottomofthelisttoreorderprofilesinthelist.
Adding or Modifying a Host Profile

YoucanusetheHostProfilesdialogboxtocreateanewhostprofileormodifyan existingone.
To create or modify a host profile: 1 AccesstheHostProfilesdialogbox. 2 Tocreateanewhostprofile,clickNew.Tomodifyanexistinghostprofile,select
theprofilefromthelist. VarioustabsappearintheHostProfilesdialogboxthatallowyoutoconfigurethe parametersforanewhostprofile.Thetabsthatappeararedependentonthetype ofemulationthatyouselectforthehostprofile.Forinformationaboutthevarious tabsintheHostProfilesdialogbox,seeHostProfileConfigurationOptionsonpage 22.
22
3 UsethetabsintheHostProfilesdialogboxtoconfigurethehostprofile. 4 Ifyouwanttodeleteahostprofile,selectitfromthelistandclickDelete. 5 Afteryouhavefinishedconfiguringhostprofiles,clickOK.
Thehostprofileconfigurationissaved.
6 Downloadthehostprofileconfigurationtothemobiledevice. NOTE Forinformationaboutdownloadingconfigurationstomobiledevices,see
ConfiguringandDeployingtheTEClientonpage 9.
Host Profile Configuration Options

ThissectiondescribestheoptionsavailableinthetabsintheHostProfilesdialogbox. Thetabsmayinclude:
HostTab TermProxyTabs IBMSettingsTab VTSettingsTab HTTPProxyTab HTTPSProxyTab AccessListTab AutologinSettings AutoLaunchTab ConfigurationTab LanguageTab ModemTab
23
Host Tab
UsetheHosttabintheHostProfilesdialogboxtoconfigurethebasicsettingsofthe hostprofile.Theoptionsmayvarydependingonthetypeofemulationyouhave selected.
Figure 3-2. ConfiguringHostSettings
ThefollowinglistdescribestheoptionsandconfigurableparametersintheHosttab.
Name
Indicatesthenameofthehostprofile,whichshouldbe synonymouswiththename(alias)ofthehostsystemto whichthemobiledeviceconnectswhenthehostprofileis used. PossibleValues:150alphanumericcharacters
24
Type Address Port Only Use TermProxy Connections
Indicatesthetypeofemulationthatthemobiledeviceuses whenconnectedtothehostsystem. IndicatestheIPaddressorhostnameofthehostsystemto whichthemobiledevicewillconnect. IndicatestheTCPportnumberonwhichthehostsystemis listeningforemulationrequestsfromClients. IndicateswhethertheTEClientshouldonlyconnecttothe hostthroughaTermProxyorConnectProserver.Ifyou enablethischeckbox,youmustconfigurethehost information(name,IPaddress,emulationtype,andport) andyoumustalsoconfiguretheTermProxy1tab. connecttothehostsystem.WhenyouenableSSL/TLS,the portwillautomaticallychangeto992.
Use SSL/TLS Encryption IndicateswhethertheTEClientshoulduseSSL/TLSto
Verify Server Certificates
IndicateswhethertheTEClientshouldusecertificate verificationbeforeallowingaconnectiontothehost.Ifyou enablecertificateverification,clickSelectVerification CertificatestousetheCertificateManagertoimporttrusted servercertificatesand/orcreateyourowncertificates. ClickthisbuttontoaccesstheCertificateManager,which allowsyoutoimporttrustedservercertificatesand/orcreate yourownservercertificatesforSSL/TLScertificate verification. EnablethisoptionifyouwanttouseSSHtoencryptthedata betweentheConnectProorTermProxyserverandthehost. Ifyouenablethisoption,theUseSSL/TLSencryption optionwilldisable.
NOTE TerminalEmulationsupportsbothSSH1andSSH2.
Select Verification Certificates
Use SSH encryption
Tunnel Telnet using SSH EnablethisoptionifyouwanttouseaTelnetconnection Local Port Forwarding tunnelingthroughaSSHserver. Address
EntertheIPaddressoftheSSHhostthatwillperformthe tunneling.
25
Port
EntertheportoftheSSHhostthatwillperformthe tunneling.
TermProxy Tabs
YoumayconfigureuptothreeConnectPro/TermProxyconnections.Usethe TermProxytabstospecifytheparametersoftheConnectPro/TermProxyconnection. ThefollowinglistdescribestheconfigurableoptionsintheTermProxytab:

TermProxy Server
SelecttheConnectProorTermProxyservertowhichtheTE Clientwillconnect. PossibleValues:
None.SpecifiesnoTermProxyoralternatehostisused. Version2.x.SpecifiesTermProxy2.x.TermProxy2.xwill
acceptconnectionsfromanyTEClient.
Version3.x.SpecifiesTermProxy3.x.TermProxy3.xwill
onlyacceptconnectionsfrom5.x(orgreater)TEClients.
Version4.x.SpecifiesTermProxy4.xorConnectPro. AlternateTelnetHost.Specifiesanalternatehostsystem
forfailoverpurposes.
Address Port
IndicatestheIPaddressoftheproxyserveroralternatehost system. IndicatestheTCPlisteningportoftheproxyserveror alternatehostsystem.
26
Terminate TermProxy Session
IndicateswhentheConnectProorTermProxyservershould terminatetheconnectiontothehost. PossibleValues:
Never.Theproxyserverneverterminatesthesession
establishedwiththehost.TheClientisresponsiblefor terminatingthesession.
OnNetworkError.Theproxyserverterminatesthe
sessionwiththehostwhenanetworkerroroccurs,such asalossofnetworkconnectivity.
OnSessionExit.Theproxyserverterminatesthesession
withthehostwhenthesessionisterminatedbythe Client.
Always.Theproxyserverwillterminatethesessionwith
thehostonanetworkerrororwhenthesessionis terminated.
Client Reconnects if Unexpectedly Disconnected Reconnect String
IndicatesiftheClientwillattempttoreconnectifthesession withtheproxyserverislostandtheClienthasnotreceiveda disconnectmessagefromtheproxyserver. Specifiesthereconnectstringthatthemobiledeviceshould usewhenconnectingtothehost.(Youmayalsoconfigure reconnectstringsinTermProxyorConnectPro.) connecttotheproxyserveroralternateTelnethost. (TermProxy2.xdoesnotsupportSSL/TLSconnections.)
Use SSL/TLS Encryption SpecifieswhethertheTEClientshoulduseSSL/TLSto
Verify Server Certificates
IndicateswhethertheTEClientshouldusecertificate verificationbeforeallowingaconnectiontothehost.Ifyou enablecertificateverification,clickSelectVerification CertificatestousetheCertificateManagertoimporttrusted servercertificatesand/orcreateyourowncertificates. ClickthisbuttontoaccesstheCertificateManager,which allowsyoutoimporttrustedservercertificatesand/orcreate yourownservercertificatesforSSL/TLScertificate verification.
Select Verification Certificates
27
Use Custom encryption
EnabletheUseCustomencryptionoptiontoencryptdata betweenthemobiledeviceandtheTermProxy/ConnectPro server. OnceyouenabletheUseCustomencryptionoption,theKey textboxisactive.Typethepasswordspecifiedinthe TermProxy/ConnectProconfigurationinthetextbox.
Key
IBM Settings Tab
UsetheIBMSettingstaboftheHostProfilesdialogboxtoconfigurethecreationofa workstationIDformobiledevicesconnectingtoanIBMhost.TheworkstationID includesstaticcharactersandthefollowingswitches,whichareusedtocapture dynamicdatathatisspecifictoeachmobiledevice:
%a%d.CapturesspecificoctetsoftheIPaddressofthemobiledevice.For
example,use%a%b%c%dtocaptureallfourIPoctetsoftheaddressofthemobile device,oruse%dtocaptureonlythelastoctetoftheIPaddressofthemobile device.
%m%r.CapturesspecificoctetsoftheMACaddressofthemobiledevice.For
example,use%p%q%rtocapturethelastthreeoctetsoftheMACaddressofthe mobiledevice.
%s.Capturesthesessionnumber. %t.CapturestheAvalancheterminalIDofthemobiledevice.(Ifthemobiledevice
doesnothaveanAvalancheEnabler,thenthisparameterisnotvalid.) AworkstationIDcanbe120alphanumericcharactersplusswitches,butIBMhosts usuallytruncateworkstationIDsthataremorethan10characters.TheworkstationID shouldnotbeginwithanumericcharacter.
NOTE TheIBMSettingstabonlyappearsyouhaveconfiguredthehostprofileforan
IBMtypeemulationintheHosttab.
VT Settings Tab
UsetheVTSettingstabintheHostProfilesdialogboxtoconfigureaTelnet negotiationstringforthehostconnection. ATelnetnegotiationstringisusedtoidentifyamobiledevicetoahostsystemandto presentaClientwiththeappropriateemulationoptions.Thehostsystemcanthen
28
supplyinformationtothemobiledevicebasedonTelnetnegotiationstring(for example,menusordisplayoptions).Thestringcanbe120alphanumericcharacters. TheVTSettingstabonlyappearsifyouhaveconfiguredthehostprofileforVTor HPtypeemulationintheHosttab.

HTTP Proxy Tab
UsetheHTTPProxytabtoconfigureproxyconnectionsforWEBemulation. ThefollowinglistdescribestheoptionsandconfigurableparametersintheHTTP Proxytab.

Connection Type
Indicatesthetypeofconnectionforthehostprofiletouse. PossibleValues:<DirectConnection><UseExplorer Default><UseProxyServer>
Proxy Server Port
Indicatesthelocationoftheproxyserver. Indicatesthenetworkportfortheproxyserver.
Do not use the proxy IndicateswhethertheTEClientshouldusetheproxyserver server when contacting whencontactinghoststhatresideonthesamenetwork. local hosts HTTPS Proxy Tab
UsetheHTTPSProxytabtoconfiguresecureproxyconnectionsforWEBemulation. SeetheHTTPProxyTabsectionforadescriptionoftheoptionsavailable.
Access List Tab
UsetheAccessListtabtocreatealistofwebaddressestheClientcanaccess. ThefollowinglistdescribestheoptionsintheAccessListtab.
Allowed Web Server Addresses
ListsthewebaddressesthattheTEClientispermittedto connectto.
Allow web servers on the IndicateswhethertheTEClientcanconnectwithanyweb local network (subnet) serveroronlywithserversonthelocalnetwork. Add Address Delete Address
SelectthisbuttontoaddanewIPorwebaddresstothelist ofaddressesthatTEClientispermittedtoconnectwith. Selectthisbuttontodeleteanaddressinthelist.
29
Autologin Settings
UsetheAutologintabintheHostProfilesdialogboxtoconfigureautologin parametersforthemobiledevice,suchasausernameandpassword.Thistabwill presentdifferentoptionsdependingontheemulationtype. ThefollowinglistdescribesconfigurableoptionsontheAutologintabifyouare usingVT/HPemulation:

Name - Prompts
Indicatestheusernamepromptthatthehostsystemuses. PossibleValues:060alphanumericcharacters DefaultValue:login
Name - CFG in terminal
Indicateswhetherusersshouldconfiguretheresponsetothe loginpromptatthemobiledevice. PossibleValues:<Enabled><Disabled>
Name - Responses
Indicatestheresponsethatthemobiledeviceshouldsendto theloginprompt.
Possible Values:030alphanumericcharacters
Password - Prompts
Indicatesthepasswordpromptthatthehostsystemuses. PossibleValues:060alphanumericcharacters
Password - CFG in terminal
Indicateswhetherusersshouldconfiguretheresponsetothe passwordpromptatthemobiledevice. PossibleValues:<Enabled><Disabled>
Password - Responses
Indicatesthepasswordthatthemobiledeviceshouldsendto thehostsystematthepasswordprompt. PossibleValues:030alphanumericcharacters
Command - Prompts
Indicatesthecommandpromptthatthehostsystemsendsto theTEClientaftertheloginiscomplete. PossibleValues:060alphanumericcharacters
30
Command - CFG in terminal
Indicateswhetherusersshouldconfiguretheresponsetothe commandlinepromptatthemobiledevice. PossibleValues:<Enabled><Disabled>
Command - Responses
Indicatesthecommandthatthemobiledeviceshouldsend thehostsystematthecommandprompt. PossibleValues:030alphanumericcharacters
ThefollowinglistdescribesconfigurableoptionsontheAutologintabifyouare usingIBMHOSTemulation:
User Name Password Program/Procedure Menu Current Library
TheusernametheClientshouldusewhenconnectingtothe host. ThepasswordtheClientshouldusewhenconnectingtothe host. Aprogram/procedurethatshouldrunwhentheClient connects. ThenameofthemenuyouwantdisplayedwhentheClient connects. ThenameofalibrarytheClientshouldnavigatetowhenit connects.
NOTE Whenconfiguring5250autologinfortheAS/400,the QRMTSIGN systemvalue mustbesetbeforetheautologinwillfunctionproperly.Use WRKSYSVAL QRMTSIGN andchangetheparameterto *VERIFY.Thissettingverifiesthattheuserhasaccess tothesystem,allowingtheusertobypassthesignon.Thedefaultis *FRCSIGNON. AutoLaunch Tab
UsetheAutoLaunchtabintheHostProfilesdialogboxtoconfigureahostprofileto automaticallylaunchwhentheTEClientstarts.Youcanconfigureautolaunchforone hostprofileforeachsession.Session1willconnectwhentheClientstarts,andthe othersessionswillautomaticallyconnecttothehostwhenyouswitchtothem. Ifyouwanttoconfiguremorethanoneprofiletoautomaticallylaunch,youmust increasethenumberofsessionsspecifiedintheemulationparameters.Formore information,seeAllowingMultipleConcurrentSessionsonpage 117.
31
NOTE EachhostprofileisautomaticallylaunchedonlyonceeachtimetheClientruns. Configuration Tab
UsetheConfigurationtabintheHostProfilesdialogboxtoaccessandconfigure perhostemulationparameters.ClickModifytoopentheConfigurationManager,or clickResettorestorethedefaultsettingsforthishost.

NOTE Formoreinformationaboutglobalandperhostemulationparameters,see
EmulationParametersonpage 43.
Language Tab
UsetheLanguagetabintheHostProfilesdialogboxtoconfigureTerminalEmulation languagesupport. ThefollowinglistdescribestheoptionsintheLanguagetab:

Display Language Server Language Keyboard Type Modem Tab
SpecifiesthelanguagefortheTEClientdisplay. Specifiesthelanguagefortheserver. Specifiesthekeyboardtobeused.
IfthemobiledevicehasaGPRSormodemconnection,youcanconfigureWWAN settingsinahostprofile.TheWWANconfigurationsaredependentonyournetwork environmentaswellasyourcellularcarrier. Thefollowinglistprovidesinformationabouteachofthesettingsavailableinthe Modemtab.However,youmayneedtocontactyourcellularproviderornetwork administratorforinformationregardingspecificsetup.
32
Figure 3-3. ModemOptions
Connection name, or Indicatesthenameofthemodemconnection. blank to not use modem
Leavetheconnectionnameblankifthehostprofiledoesnot useamodemconnection. Iftheprofilewillbeusingoneofthedevicesexisting modemconnections,thenspecifythenameofthat connection.Eachdifferentconnectionmusthaveaunique connectionname.
33
Overwrite this IndicateswhethertheTEClientshouldoverwritethe connection if it exists on connectioniftheconnectionisalreadyonthedevice. the device
Enablethisoptionifanythingabouttheconnectionmustbe changed. Disablethisoptioniftheprofilewillbeusingoneofthe devicesexistingmodemconnections.

Auto-disconnect modem IndicateswhethertheTEClientshoulddisconnectthis when all sessions end modemconnectionafterallsessionsthatuseithaveended.
ThisoptionworkswithGPRSconnections(thathavean AccessPointName)whentheUsewirelessLANif availableisdisabled.ThisoptionalsoworkswithPPP connections(thatuseDialingInstructions).

Use wireless LAN if available
WhenenabledandthedevicehasawirelessLAN connection,theTEClientdoesnotmakethemodem connection. Whendisabled,theTEClientalwaysusesthemodem connection.
Select connection details TouseaGPRSservicefortheconnection,selectAccessPoint
Name. Touseadialupmodemconnection,selectDialing Instructions.

Access Point Name (APN) IfconnectiondetailsaresettoAccessPointName,then or Number specifytheAPN.(ThenameoftheGPRSgateway,obtained
fromthecellularserviceprovider.) IftheconnectiondetailsissettoDialingInstructions,enter thenumberexactlyasitshouldbedialed.

User name Password Domain
Theusernametobeusedduringauthentication. Thepasswordtobeusedduringauthentication. Thedomaintobeusedduringauthentication.Thisshouldbe providedbytheISPornetworkadministrator.
34
ByclickingtheAdvancedbutton,youcanaccesstheTCP/IPPropertiesdialogbox, whichhasthefollowingoptions:
Figure 3-4. TCP/IPProperties
Obtain an IP address automatically Use the following IP address IP address Obtain DNS server address automatically
Ifthisoptionisenabled,theIPaddressofthedeviceis assignedbythenetworkthedeviceconnectsto. Ifthisoptionisenabled,thedevicesIPaddressforthe connectionisspecifiedbytheIPaddressfield. ThisfieldspecifiestheIPaddresstobeusedwhilethis connectionisactive. Ifthisoptionisenabled,theconnectionsDNSandWINS serveraddressesareassignedbythenetworkthedevice connectsto. Ifthisoptionisenabled,theconnectionusesthespecified DNSorWINSserveraddresses.
Use the following DNS server addresses
35
Preferred DNS server Alternate DNS server Preferred WINS server Alternate WINS server Software Compression IP Header Compression
TheIPaddressoftheDNSservertobeusedwhilethis connectionisactive. TheIPaddressofasecondaryorbackupDNSservertobe usedwhilethisconnectionisactive. TheIPaddressoftheWINSservertobeusedwhilethis connectionisactive. TheIPaddressofasecondaryWINSservertobeusedwhile thisconnectionisactive. Ifthisoptionisenabled,softwarecompressionisnegotiated ontheconnectionlink. Ifthisoptionisenabled,IPheadercompressionisnegotiated ontheconnectionlink.
Subnet-Specific Addresses
Whencreatingahostprofile,youmayenterasubnetspecificaddressratherthanan IPaddressoraDNSname.Asubnetspecificaddresswillhavethefollowingformat: 0.X.X.X/X.ThespecifiedaddressiscombinedwiththemobiledeviceIPaddressto determinethehostsaddress.Thenumberaftertheslashdeterminesthenumberof bitsofthesubnetspecificaddressthatshouldbeignored.Thisisusuallythesameas thenumberofbitsatthestartofthesubnetmask. Examples: ForamobiledevicewithanIPaddressof10.20.30.40:
Whenconnectingtoasubnetspecificaddressof0.1.2.3/8,thedevicewilllook
forahostat 10.1.2.3
forahostat 10.20.2.3
forahostat 10.20.30.3 SubnetspecificaddressingisalsoavailableforWEBemulation.However,youshould usea | characterinsteadofa / charactertodenotethenumberofbits.
36
Examples: ForamobiledevicewithanIPaddressof10.20.30.40:
Whenconnectingtoasubnetspecificaddressof
http://0.1.2.3|8 thedevicewilllookforahostat: http://10.1.2.3/
Whenconnectingtoasubnetspecificaddressof
https://0.0.0.3|24:8080/start.asp thedevicewilllookforahostat: https://10.20.30.3:8080/start.asp
Host Profiles and SSL/TLS

TheTEClientsupportsSSLorTLSencryptedTelnetsessionstohostserversortoa WavelinkTermProxyorConnectProserver.TheTEClientalsosupportscertificate validationforSSL/TLSconnections.Forspecificinstructionsonhowtoinstalland configureSSLorTLS,seeUsingSSL/TLSwithTerminalEmulationontheWavelink Website.
NOTE WavelinkConnectProorTermProxyserversprovideSSL/TLSsupportfor connectionsbetweenthemobiledeviceandtheproxyserver.Theydonotsupport SSL/TLSconnectionsbetweentheproxyserverandhost.
ToconfigureSSLorTLS,youwillneedtheselfextractingsupportutilityandeither theAvalanche,ActiveSync,orAirBeamSSL/TLSpackagefortheClient.The Avalanchepackagesaredevicespecific;theActiveSyncandAirBeampackagesare notdevicespecific. ToenableanduseSSL/TLSfortheTEClient,performthefollowingsteps:
InstallingtheSSL/TLSSupportUtilityontheHostSystem InstallingtheSSL/TLSSupportPackageontheClient EnablingSSL/TLS
37
Installing the SSL/TLS Support Utility on the Host System

TheSSL/TLSsupportutilityisaselfextractingexecutablethatinstallstherequired filesthatwillallowyoutoconfigureSSL/TLSandcertificates.YoucanobtaintheSSL/ TLSsupportpackagefromtheWavelinkWebsite.
Installing the SSL/TLS Support Package on the Client

TheTEClientwillnotbeabletoinitiateSSL/TLSconnectionswithhostsuntilyou installtheSSL/TLSsupportpackageonthemobiledevice. UseoneofthefollowingmethodstodeploytheSSL/TLSsupportpackagetothe mobiledevice:
AvalancheConsole.TheSSL/TLSsupportpackageisavailableasanAvalanche
softwarepackage.Addthepackagetoasoftwareprofileanddeployittothe desireddevices.
MicrosoftActiveSync.TheSSL/TLSsupportpackageisavailableasabundled
packagethatyoucandeployoveraMicrosoftActiveSyncconnectionbetweena hostsystemandthemobiledevice.
ThirdPartyApplication.TheSSL/TLSsupportpackageisavailableforsome
thirdpartydeploymentapplications.
Enabling SSL/TLS
SSL/TLSisenabledviatheHostProfilesdialogbox.Itisconfiguredperhostprofile. WhenyouconfigureahostprofiletouseSSL/TLS,theTCPportforthehostprofileis automaticallychangedto992,whichisthestandardportnumberforSSL/TLS.Ifthe hostsystemusesadifferentport,thenchangetheporttothecorrectsetting.
To configure a host profile to use SSL/TLS: 1 AccesstheHostProfilesdialogbox. 2 Fromtheleftpanelofthedialogbox,selectthehostprofilethatyouwantto
configure.
3 Dependingontheconnectionrequirementsforthehostprofile,selectoneofthe
following:
Ifthehostprofilespecifiesadirectconnectiontoaserver,thenenabletheUse
SSL/TLSEncryptionoptionboxintheHosttab.
38
IfthehostprofilespecifiesaconnectiontoaWavelinkConnectProor
TermProxyserver,thenenabletheUseSSL/TLSEncryptionoptionboxinthe TermProxytab.
NOTE YouwillnotbeabletoconfiguretheUseSSL/TLSEncryptionoptionboxinthe
TermProxytabuntilyouselectanoptionfromtheTermProxyServermenulist.
Figure 3-5. EnablingSSLforaHostProfile
4 Ifyouwanttouseservercertificates,enabletheVerifyservercertificatesoption
andclicktheSelectVerificationCertificatesbutton. TheCertificateManagerdialogboxappears. ClickInsertCertificatetobrowsetoandimportaservercertificate. ClickCreateCertificatetocreateacertificateandprivatekeythatyoucanthen exporttoaConnectProorTermProxyserverorotherhostsystem.
39
Figure 3-6. ManagingSSL/TLSCertificates
NOTE Thecertificatesthatyouimportand/orconfigureareavailableforallhost profilesthatyouconfigure.Theimportedcertificatesareaddedtoalistwhichthe ClientwillcheckwheninitiatinganSSL/TLSsessionwithahost.Ifthehostdoesnot presentacertificatethatisinthelist,thentheClientwillnotestablishaconnection withthehost.
Afteryouhavefinishedimporting/configuringcertificates,clickOK. TheCertificateManagerdialogboxcloses.
5 Afteryouhavefinishedconfiguringthehostprofile,clickOK.
Thenewhostprofileconfigurationissavedtothehostsystem.
6 Downloadthenewhostprofileconfigurationtothemobiledevice.
40
NOTE ForinformationaboutusingMicrosoftActiveSyncorAvalanchetodownload
configurationstomobiledevices,seeConfiguringandDeployingtheTEClienton page 9.
Host Profiles and Wavelink ConnectPro or TermProxy

TheTEClientprovidesintegrationwithWavelinkConnectPro(knowninearlier versionsasTermProxy).ConnectProprovidesproxyservicestoassistinsession persistencebetweentheClientandhostsystems.ConnectProisfreewhenyouare usingTerminalEmulation.
NOTE FormoreinformationaboutWavelinkTermProxyorConnectPro,refertothe
productreferenceguides. WhenyouuseConnectProorTermProxy,usethehostprofiletoconfigurehowthe Clientwilluseit.Eachhostprofilehasthefollowingoptions:
ConfiguringaConnectProorTermProxyOnlyHostProfile ConfiguringConnectPro/TermProxyFailover
NOTE TermProxysupportviatheHostProfilesdialogboxisonlyavailableinversion 5.0(andnewer)ofTerminalEmulation.WhileTermProxy2.xallowsconnections fromanytypeofTEClient,TermProxy3.xorConnectProrequiresa5.0(ornewer) Client.
Configuring a ConnectPro- or TermProxy-Only Host Profile

IfthehostprofilehasaConnectProorTermProxyserverspecifiedintheTermProxy tab,theClientwilltrytoconnecttotheproxyserverfirst.WhentheTEClientcannot connecttothespecifiedproxyserver,itwillattemptadirectconnectiontothehost. YoucanconfiguretheClientsothatitwillonlyallowconnectionstothehostthrough aproxyserver,however.
To configure a TermProxy-only connection to a host system: 1 AccesstheHostProfilesdialogbox.
41
2 Selectthehostprofilethatyouwanttoconfigure. 3 IntheHosttab,enabletheOnlyUseTermProxyConnectionscheckbox.
Figure 3-7. EnablingTermProxyOnlyConnections
4 UsetheTermProxytabtoconfigurethesettingsfortheConnectProorTermProxy
server.
NOTE FormoreinformationaboutsettingsintheTermProxytab,seeTermProxyTabs
onpage 25.
42
Configuring ConnectPro/TermProxy Failover

UsetheTermProxytabsintheHostProfilesdialogboxtoconfigurehostand ConnectProorTermProxyfailover.Youmayconfigureuptothreefailover connectionsforahostprofile. WhentheTEClientattemptstoinitiateaconnectionwithahost,itwilltrythe addresseslistedintheTermProxytabsfirst.IfitisunabletocontacttheConnectPro orTermProxyserverslisted,oriftherearenoserverslistedintheTermProxytabs,it willtrytoconnecttothehostdirectly.Connectionattemptsoccurinthefollowing order:
HostspecifiedintheTermProxy1tab HostspecifiedintheTermProxy2tab HostspecifiedintheTermProxy3tab HostspecifiedintheHosttabofthehostprofile

IftheTEClientisunabletocontactanyofthespecifiedhosts,thenitwillreturnan errormessage.
To configure TermProxy failover servers for a host profile: 1 AccesstheHostProfilesdialogbox. 2 SelectthehostprofileforwhichyouwanttoconfigureTermProxyfailover. 3 ConfiguretheHosttab. 4 ConfiguretheTermProxytabs. NOTE FormoreinformationaboutthesettingsintheHostandTermProxytabs,see
HostProfileConfigurationOptionsonpage 22.
Chapter 4: Emulation Parameters
43

MakechangestohowtheClientinteractswiththehostwiththeConfiguration Managerutility,whichprovidesanorganizedlistofparametersthatyoucanmodify. ThesemayincludeCOMportusage,display,logging,orscanneroptions. Emulationparameterscanbeappliedgloballyforallhostconnections,orsetona perhostbasis:
GlobalEmulationParameters.Globalemulationparametersapplytoallofthe
hostprofileswithwhichyouhaveconfiguredaClient. Whenyouchoosetomodifyglobalemulationparameters,youaccessanduse ConfigurationManagertomodifythe Termcfg.bin configurationfile. ConfigurationManagerdisplaysthenameofthefilethatitismodifyinginthetitle bar.
PerhostEmulationParameters.Perhostemulationparametersapplyonlytoa
specifichostprofile.Anyparameterschangedonaperhostbasiswilloverride globalparameters.Youcanaccesstheemulationparametersforaspecifichost profilethroughtheHostProfilesdialogbox. Whenyouchoosetomodifyperhostemulationparameters,youaccessanduse ConfigurationManagertomodifythe Hostcfg.bin configurationfile. ConfigurationManagerdisplaysthenameofthefilethatitismodifyinginthetitle bar.
NOTE Perhostparametersareasubsetofparameters.NotallTEClientemulation
parametersareavailableformodificationonaperhostbasis. Thissectionprovidesthefollowinginformation:
ConfiguringEmulationParameters UsingtheConfigurationManager
Configuring Emulation Parameters

ThissectionprovidesinformationaboutaccessingtheConfigurationManagerto modifyglobalandperhostemulationparameters.
44
Thefollowingtasksoutlinetheprocessofconfiguringemulationparameters:
1 UsetheproductconfigurationutilityortheTEClientAvalanchesoftwarepackage
toaccesstheConfigurationManager.
2 UsetheConfigurationManagertomodifyemulationparametersandsavethenew
emulationparametersconfigurationfile.
3 Downloadthenewconfigurationfiletothemobiledevice.
Whenyoudownloadtheconfigurationfiletothemobiledevice,anyexisting configurationfileisoverwritten.
Accessing Global Parameters Using Microsoft ActiveSync

IfyouusetheproductinstallationandconfigurationutilitytoinstalltheTEClientto themobiledeviceviaaMicrosoftActiveSyncconnection,usethesameproduct installationandconfigurationutilitytoaccesstheConfigurationManagerandmodify globalemulationparameters.
To access global emulation parameters from the Microsoft ActiveSync utility: 1 Onthehostsystem,launchtheTEMicrosoftActiveSyncutility.
TheWavelinkProductConfigurationdialogboxappears.
2 ClicktheEmulationParametersbutton.
TheConfigurationManagerappears.
45
Figure 4-1. ConfigurationManager
3 UsetheConfigurationManagertoconfiguretheglobalemulationparametersfor
theTEClient.
NOTE ForinformationaboutusingConfigurationManager,seeUsingtheConfiguration
Manageronpage 50.
4 Afteryouhaveconfiguredtheemulationparameters,clicktheSavebuttontosave
yourchanges.
5 ClosetheConfigurationManager. 6 Downloadthenewemulationparameterstothemobiledevice. NOTE Formoreinformationaboutdownloadingconfigurationtomobiledevices,see
46
Accessing Global Parameters Using Avalanche

IfyouuseAvalanchetoinstalltheTEClientonthemobiledevice,usetheAvalanche ConsoletoaccesstheConfigurationManagerandmodifyglobalemulation parameters.
To access global emulation parameters from Avalanche Console: 1 Onthehostsystem,launchtheAvalancheConsole. 2 IntheProfilestab,selecttheprofilethatcontainstheTEClientpackage. 3 IntheSoftwarePackagesregion,selecttheTEClientsoftwarepackageandclick
4 Fromthelist,selectEmulationParametersandclickLaunch.
47
5 UsetheConfigurationManagertoconfiguretheglobalemulationparametersfor
theTEClient.
NOTE ForinformationaboutusingtheConfigurationManager,seeUsingthe
yourchanges.
7 ClosetheConfigurationManager. 8 Downloadthenewemulationparameterstothemobiledevice. NOTE Formoreinformationaboutdownloadingconfigurationtomobiledevices,see
Accessing Per-Host Parameters Using Microsoft ActiveSync

IfyouusedtheproductconfigurationutilitytoinstalltheTEClientonthemobile deviceviaaMicrosoftActiveSyncconnection,usethesameproductconfiguration utilitytoaccessandconfigureperhostemulationparameters.
To access per-host emulation parameters from the Microsoft ActiveSync utility: 1 Onthehostsystem,launchtheTEMicrosoftActiveSyncinstallationutility.
2 ClicktheHostProfilesbutton.
TheHostProfilesdialogboxappears.
3 Fromthelistofhostprofiles,selectthehostprofilethatyouwanttoconfigure. 4 SelecttheConfigurationtab.
48
Figure 4-3. SelectingtoConfigurePerHostEmulationParameters
5 ClickModify.
6 UsetheConfigurationManagertoconfigureemulationparametersforthehost
profilethatyouhaveselected.
Manageronpage 50.
yourchanges.
8 ClosetheConfigurationManager. 9 ClosetheHostProfilesdialogbox. 10 Downloadthenewemulationparameterstothemobiledevice.
49
Accessing Per-Host Parameters Using Avalanche

IfyouusedAvalanchetodeploytheTEClienttothemobiledevice,usetheTEClient softwarepackageintheAvalancheConsoletoaccessandconfigureperhost emulationparameters.
To access per-host emulation parameters from Avalanche Console: 1 Onthehostsystem,launchtheAvalancheConsole. 2 IntheProfilestab,selecttheprofilethatcontainstheTEClientpackage. 3 IntheSoftwarePackagesregion,selecttheTEClientsoftwarepackageandclick
4 Fromthelist,selectHostProfilesandclickLaunch.
TheHostProfilesdialogboxappears.
5 Fromthelistofhostprofiles,selectthehostprofilethatyouwanttoconfigure. 6 SelecttheConfigurationtab. 7 ClickModify.
8 UsetheConfigurationManagertoconfigureemulationparametersforthehost
profilethatyouhaveselected.
Manageronpage 50.
yourchanges.
10 ClosetheConfigurationManager. 11 ClosetheHostProfilesdialogbox. 12 Downloadthenewemulationparameterstothemobiledevice.
50
Using the Configuration Manager

TheConfigurationManageristheutilitythatallowsyoutomodifyglobaland perhostemulationparameters.
TheleftpaneoftheConfigurationManagerdisplaystheemulationparametersthat youcanmodify.Theemulationparametersaregroupedbycategory:
COM Emulation Indicators Scanner
Parametersinthiscategoryconfigurethefunctionof theCOMportonmobiledevices. Parametersinthiscategoryconfigureterminal emulationfunctionsonmobiledevices. Parametersinthiscategoryconfigurethefunctionof indicatorsonmobiledevices. Parametersinthiscategoryconfigurethefunctionof barcodescannersonmobiledevices.
51
Whenyouselectaparameterintheleftpane,informationabouttheparameter displaysintherightpane.
Figure 4-5. EmulationParameterInformation
Modifying Emulation Parameters

Determinetheemulationparametersthatyouwanttomodifyandusethe ConfigurationManagertomakemodifications.
To modify an emulation parameter: 1 AccesstheConfigurationManager. 2 IntheleftpaneoftheConfigurationManager,locatetheparameterthatyouwant
tomodify.
3 Doubleclicktheemulationparameterorrightclicktheemulationparameterand
chooseEditfromthemenulist. Adialogboxappearsthatallowsyoutomodifytheparameterconfiguration.
Figure 4-6. ModifyinganEmulationParameter
52
4 Afteryouhaveconfiguredtheparameter,clickOKtokeepthesetting. 5 Afteryouhaveconfiguredtheemulationparameters,clicktheSavebuttontosave
yourchanges.
6 ClosetheConfigurationManager. 7 Downloadthenewconfigurationtothemobiledevice.
Using the Find Function

UsetheFindfunctionoftheConfigurationManagertolocateparametersor informationbysupplyingapartialorfullstringthattheConfigurationManagercan usetolocatetheparameterorinformationthatyouwanttofind.
To use the find function: 1 FromtheConfigurationManager,clickEdit>Find.
TheFinddialogboxappears.
2 Inputawordorphrasefortheparameterorinformationthatyouwanttofind.
Figure 4-7. InputtingaStringtoFind
3 EnabletheSearchalltextcheckboxtosearchnotonlytheparameters,butalsothe
helpfiles.
4 ClickFindNexttobeginthesearch.
ContinuetoclickFindNextuntilyoulocatetheparameterorinformationfor whichyouaresearching.
Switching to Alphabetized View

Bydefault,emulationparametersaredisplayedinahierarchicaltreeview.Youmay switchtoanalphabetizedview,ifyoudesire.
53
To switch to the alphabetized view in Configuration Manager: 1 IntheConfigurationManager,accesstheViewmenu. 2 IntheViewmenu,disabletheTreeModeoption.
TheConfigurationManagernowdisplaystheemulationparametersinan alphabetizedlist.
Figure 4-8. AlphabetizedViewintheConfigurationManager
Chapter 5: Scripting
54
TheScriptEditorprovidestheabilitytocreateandexecutescriptsthatautomate processesontheTEClient.TheScriptEditorisincludedinTEClient5.1andlater versions.Thissectionincludesthefollowinginformation:
OverviewofScripting LaunchingtheScriptEditor CreatingScriptsUsingtheScriptEditor PerformingScriptCapturing EditingScripts ImportingScripts SavingandExportingScripts DeployingScripts ExecutingScripts
Overview of Scripting
ThefollowingstepsoutlinetheprocessofcreatingscriptsusingtheScriptEditor:
1 LaunchtheScriptEditor.YoucanlaunchthescripteditorfromtheAvalanche
ConsoleortheActiveSyncconfigurationutility.
2 CreateascriptusingtheScriptEditor.YoucanusetheScriptEditortomanually
createthescriptcode. Or CreateascriptusingtheScriptCaptureoption.YoucanturnonScreenCapture andperformtheactionsyouwantincludedinyourscript.

3 Configureanexecutionmethodforyourscript.Youneedtoselectfromthe
availableoptionsthewayyouwanttoexecuteyourscript.
55
4 DeploythescripttotheTEClient.UseAvalancheorActiveSynctodeploythe
scripttotheClient.
5 Duringanemulationsession,executeyourscriptfromtheTEClient.Usingthe
activationmethodyouselectedforthescript,youcanactivateandexecuteyour script. TerminalEmulationallowsoneactivescriptperemulationsession.Whileonescriptis running,otherscriptsarenotallowedtorun.Scriptsshouldbedesignedtoperform theirfunctionandthenimmediatelyexit.Thisallowsthenextscripttorun. Scriptscanonlyberunwhileasessionisconnectedtoahost.Whenaconnectionis dropped,thescriptisterminated.Ifyouswitchbetweensessions,thescriptrunning inthefirstsessionwillbesuspendeduntilthatsessionisactiveagain. Scripts

NOTE TheactionsandsettingsyouusetocreateTerminalEmulationscriptsare locatedinaseparatedocumentcalledWavelinkTerminalEmulationScriptingReference Guide.Thedocumentexplainstheusageofeachactionindetailandprovides examples.TheScriptingReferenceGuideislocatedontheWavelinkwebsite.
Launching the Script Editor

IfyouareusingAvalancheConsoletodeploytheTEClient,youcanlaunchtheScript EditorfromtheAvalancheConsole.Scriptscreatedbyorimportedintothe AvalancheScriptEditorwillautomaticallybedeployedtotheremotedevices.
To launch the Script Editor from the Avalanche Java Console: 1 FromtheAvalancheConsole,navigatetotheProfilestab,andselecttheprofile
thatcontainstheTEClientpackage.
2 IntheSoftwarePackagesregion,selecttheTEClientsoftwarepackageandclick
3 SelectScriptEditorandclickLaunch.
TheScriptEditoropens.
56
4 ClickAddtoaddanewscriptandopentheNewScriptconfigurationdialogbox.
Figure 5-1. ScriptEditorConfigurationDialogBox
Fromthisdialogbox,youcancreateandconfigurescripts.
To launch the Script Editor from the ActiveSync configuration utility: 1 Onthehostsystem,launchtheTEMicrosoftActiveSyncutility.
2 ClicktheEmulationParametersbutton.
TheScriptEditoropens.
3 ClickAddtoopentheNewScriptconfigurationdialogbox. 4 Fromthisdialogbox,youcancreateandconfigurescripts.
Creating Scripts Using the Script Editor

ThissectionprovidesstepsforcreatingscriptsmanuallyusingtheScriptEditorand includesthefollowinginformation:
SelectingtheActivationMethod
57
CreatingtheScriptCode CreatingVariables SelectingHostProfiles Selecting the Activation Method

Whenyoucreateascript,youassignitauniquenameandanactivationmethod.A scriptwithnoactivationmethodselectedcanstillbecalledbyanotherscript,butit cannotbeactivatedbyitself.Youcanselectfromthefollowingactivationmethods:
Select from Menu On Key Combination
Activatesthescriptfromascriptexecutionoption addedintheTEClientmenu. Activatesthescriptwhenthekeycombinationis pressed.ForinformationonusingtheDiagnostics Utilitytoobtainkeyvalues,seeUsingtheTEClient DiagnosticsUtilityonpage 130. Activatesthescriptwhenasessionbeginsforthe hostprofilethescriptsupports.Youshouldnothave morethanonescriptsettostartwhenasession beginsbecausethefirstscriptstartedwillprevent anyotherscriptsfromrunningwhileitwaitsforthe initialscreen. Activatesthescriptwhenanitemisscanned.This optionisonlyavailableafteryouhavecreatedthe stringvariable Scan_String toobtaintheinitial scandataandthenumbervariable Scan_Type to obtainthetypeofscandata. RefertoTerminalEmulationScriptingReferenceGuide forthevaluesofdifferentsymbologies.
When Session Connects
On Barcode, MSR, or RFID Scan
NOTE Ifyouwanttoperformspecialprocessingonitemsscannedintothe computer,theScanHandlerisoftenpowerfulenoughtomakethechanges youneed.TheScanHandlersettings,foundintheConfigurationManager, arelocatedinEmulationParameters>Scanner>Common>ScanHandler.
58
On Screen Update
Activatesthescripteverytimethetextonthe emulationscreenchanges.Thisincludesupdates fromthehostorwhentheuserpressesakeyandthe keyvalueisshownonthescreenItisrecommended thatyoulimitthehostprofilesthatascriptusingthis methodwillsupport.
Toselecttheactivationmethodforascript,launchtheScriptEditorconfiguration dialogboxandchoosetheappropriatemethodontheGeneraltab.
Creating the Script Code

Onceyouhavenamedyourscriptandselectedanactivationmethod,youcanusethe ActionstabintheScriptEditortobuildthescript. Fordetailedinformationandexamplesaboutbuildingthescriptcoderefertothe TerminalEmulationScriptingReferenceGuide.
Creating Variables
TherearethreetypesofvaluesrecognizedbyTerminalEmulationscripting:Booleans (TRUEorFALSEvalues),numbers(integers),andstrings.Everyactionthatreturnsa valuereturnsoneofthesetypes.Variablesprovideawaytosavetheresultofan actionforuselaterasanargumentforanothercommand. VariablescanbecreatedandeditedundertheappropriateVariabletabwhileediting thescript.Itisalsopossibletocreatenewvariableswhileeditinganaction. Whenascriptfirststarts,allthevariableswillhaveknownvalues:Booleanvariables willbeFALSE,numbervariableswillbe0,andstringvariableswillbeempty.One possibleexceptiontothisiswhenascriptactivatesanotherscript. Whenavariableispersistent,thevalueremainsafterthescriptexits.Persistent variablesarenotscriptorsessionspecific;onceavalueisassigned,anyscriptinany emulationsessioncanuseapersistentvariabletoaccessthatvalue. Twoscriptsarereferencingthesamepersistentvariableifbothscriptscontaina persistentvariableofthesametypeandsamename. Writingnewvaluestopersistentvariableswillslowyourapplication,sotheyshould beusedonlywhennecessary.Ifyouwanttouseapersistentvariablethatwillchange valuesfrequently,writeyourscriptwitharegularvariablethatonlychangesthe valueofthepersistentvariablebeforethescriptpausesorexits.
59
To create a variable: 1 Determinewhichtypeofvariableyouwanttocreate:Boolean,numberorstring. 2 FromtheScriptEditor,selectthetabthatcorrespondswiththetypeofvariable
youwanttocreate.
3 ClickAdd. 4 IntheEditVariabledialogbox,enterthenameofthenewvariable.
Figure 5-2. AddingaNewVariable
5 EnabletheMakethisvariablepersistentcheckboxifyouwouldlikethevariable
topersistafterthescriptexits.Thisallowsittobeusedbyotherscriptsorsessions.
6 ClickOK.
Thenewvariableappearsinthecorrespondingtab.
Selecting Host Profiles

Foreachscript,youcanspecifywhichhostprofileswillbesupportedbythat script.YoumayselecthostprofilesfromtheHostProfilestab. Ifthescriptisgeneratedbyscriptcapturing,itisagoodideatolimitthatscripttoa hostprofilethatwasinusewhenthescriptwascaptured.Thedefaultnohost profileallowsthescripttoberunwhenanyhostprofileisused.
To select host profiles: 1 FromtheScriptEditor,selecttheHostProfilestab. 2 ClickAdd.
TheSelectHostdialogboxopens.
60
3 Selectwhichhostyouwanttousefromthelistofhosts. NOTE Ifyouhavenotcreatedanyhostprofiles,thisdialogboxwillbeempty. 4 ClickOK.
ThehostappearsintheHostProfilestab.
Performing Script Capturing

Scriptcapturingisaneasywaytogenerateascriptthatwillautomatedoing somethingyoucandomanually.Whilescriptcapturingisturnedon,itwillcapture thekeypressesandmouse/cursormovementssotheycanbereplayedwhenthescript isactivated.AscriptisrecordedfromthedevicewheretheClientisrunning.
To perform a script capture: 1 LaunchtheClientandpositionthemouseorcursorattheemulationscreenyou
wanttobeatwhenthescriptstarts.
2 FromtheTermorOptionsmenu,selectScripting>StartCapture.
Figure 5-3. StartingScriptCapture
3 Attheprompt,selectYestoverifythecurrentscreentext.
61
Figure 5-4. VerifyingtheCurrentScreenTest
SelectingYesmakesthecapturedscriptstartwithan If_not commandthattells thescripttoexitifthecurrentscreendoesnotmatch.Unlessyouknowthatyour scriptwillonlyrunfromthecorrectscreen(forexample,ascriptthatisrunonly whenasessionfirststarts,orascriptcalledbyanotherscript),youshouldselect Yes.SelectNoifyoudonotwanttoverifythecurrentscreentext. IfyouselectNo,clickVerifyScreenContentsandSaveCursorPositionbuttons whenyoustartyourscriptcapture.Thiswillcauseyourscripttowaitforthe Clienttofinishupdatingthescreenbeforeprocessingscriptactions.
4 Performanyactionsyouwanttoincludeinthescript.Specialactionbuttons
relatedtorecordingthescriptappearonthescreen.
Figure 5-5. VerifyScreenContentsandSaveCursorPositionButtons
VerifyScreenContents(orScreen)willcausethegeneratedscripttopauseand waitforthescreentobeupdated.Thepausesarenecessarybecausethescriptscan runmuchfasterthantheinteractionwiththehost.SaveCursorPosition(or Cursor)willensurethatthecursorismovedtothecorrectpositionbeforethe scriptcontinues.FieldDataID(orID)allowsyoutoassignsymbologiesand/or
62
DataIDstoafieldsothatscandatawithmatchingcriteriaissenttothatfield.Stop Capture(orStop)endsthescriptcapture.
NOTE TheFieldDataIDfeature,specifictoIBM5250emulation,allowsyoutouse scriptingtoconfigureFieldDataIdentifiers.FieldDataIdentifiersassignauniqueID (suchasaletter)toeachfieldonthescreen.Anytimeabarcodebeginningwiththat IDisscanned,thebarcodeinformationautomaticallypopulatesthecorresponding field.FordetailedinformationandexamplesabouttheFieldDataIDfeature,referto theTerminalEmulationScriptingReferenceGuide. 5 Eachtimethescreenchanges,clickVerifyScreenContentsbutton. 6 Whenyouarefinishedcapturingtheactionsyouwantinthescript,clickStop
Capture. Onceyouhavecapturedascript,theScriptEditoropens.Thisallowsyoutoname thescriptandselectanactivationmethod.YoucouldalsousetheActionstabto addactionsforanyerrorconditionthattheusermayencounter.
Editing Scripts
Youcaneditscriptsthatarecreatedmanuallyandscriptsthataregeneratedfromthe scriptcaptureoption.
To edit scripts: 1 LaunchtheScriptEditor. 2 SelectthescriptyouwanttoeditfromtheScriptEditorscriptlist. 3 ClickEdit. 4 MakethedesiredchangesintheScriptEditorconfigurationdialogbox. 5 ClickOKtosaveyourchanges.
Onceyouhavecompletededitingthescriptyouhavetwooptions:
ExportthescripttoaspecifiedlocationusingtheExportbuttonintheScript
Editor.RefertoSavingandExportingScriptsonpage 63formoreinformation.
63
DeploythescripttotheClientandexecuteitbylaunchingtheTEClientand
performingtheactivationmethodyouassignedtothisscript.RefertoExecuting Scriptsonpage 64formoreinformation.
Importing Scripts
YoucanusetheImportbuttonintheScriptEditortoimportpreviouslycreated scripts.YoucanonlyimportscriptsthathavebeencreatedusingtheScriptEditor.
To import a script: 1 FromtheScriptEditor,clicktheImportbutton.
TheSelecttheScriptFiledialogboxopens.
2 Navigatetoandselectthescriptfile. 3 ClickOpen.
ThefileisimportedintotheScriptEditorandthenameappearsinthelist. Onceyouhaveimportedthefile,youcaneditthescript.RefertoEditingScriptson page 62formoreinformation.
Saving and Exporting Scripts

Afteryoufinishbuildingascript,yourscriptisautomaticallysavedintheScript Editor.Youcanalsoexportascriptandsaveitinaspecificlocationonthenetwork. Scriptsaresavedas .wls files.ScriptscannotbeviewedoutsidetheScriptEditor andmustbeimportedbackintotheScriptEditortovieworedit.
To export a script: 1 FromtheScriptEditorscriptlist,selectwhichscriptyouwanttoexport. 2 ClicktheExportbutton.
TheCreatetheScriptFiledialogboxopens.
64
Figure 5-6. ExportingaScript
3 Navigatetothelocationtowhichyouwanttoexportyourscript. 4 ClickSave.
ToviewanexportedscriptyouwillneedtoimportthatscriptintotheScript Editor.RefertoImportingScriptsonpage 63formoreinformation.
Deploying Scripts
ScriptsaredeployedtotheTEClientthenexttimetheClientsyncsusingAvalanche orActiveSync.ForinformationondeployingconfigurationstotheClient,see ConfiguringandDeployingtheTEClientonpage 9.
Executing Scripts
Whenyoucreateascript,youconfigureanactivationmethodforthatscript.This sectionprovidesinformationaboutactivatingscriptsusingeachofthefollowing activationmethods:
SelectfromMenu
65
OnKeyCombination WhenSessionConnects OnBarcode,MSR,orRFIDScan OnScreenUpdate

Forinformationonassigninganactivationmethodtoascript,refertoSelectingthe ActivationMethodonpage 57.
Select from Menu

ThisoptionallowsyoutoactivateascriptfromtheOptionsmenu.Youcannotstarta scriptwhileascriptisrunningforthecurrentsessionorifthesessionisnot connected.
To activate a script from the TE Client menu: 1 LaunchtheTEClient. 2 FromtheOptionsmenu,selectScripting>ExecuteScript.
Figure 5-7. ExecutingaScriptfromtheMenu
3 Ifmorethanonescriptisavailableforthecurrenthostprofile,selectwhichscript
youwanttousefromthelist.
66
On Key Combination
Thisoptionletsyoulaunchascriptwheneveraspecifiedkeycombinationispressed, ifitiscurrentlypossibleforascripttorun.Youcannotstartascriptwhileascriptis runningforthecurrentsessionorifthesessionisnotconnected.
To execute a script on key combination: 1 LaunchtheTEClient. 2 Pressthekeycombinationyouassignedforexecutingthescript.
When Session Connects

Thisoptioncausesthescripttoactivatewhenthehostprofileitsupportsisactivated. Ifyouusethisoption,Wavelinkstronglyrecommendsthatyoulimitthescripttothe appropriatehostprofiles.Youshouldhaveyourscriptwaitfortheappropriatescreen toappearbeforeitactivatesinordertopreventerrors.Thefirstscriptthatstartswill preventanyotherscriptsfromrunningwhileitwaitsfortheinitialscreen,soyou shouldnothavemorethanonescriptsettostartwhenasessionconnects.
To execute when the session connects: 1 LaunchtheTEClient. 2 FromtheTermorOptionsmenu,selectConnect. 3 Selectthehosttowhichyouwanttoconnect. 4 ClickOK.
Thescriptwillrunuponconnection.
On Barcode, MSR, or RFID Scan

Thisoptionrunsascripteachtimethescannerisused.Toexecuteascriptusingthis method,launchtheTEClientandthenusethescanner. Thefollowingisasamplescriptyoucanuseifyouwanttoinsertastring(which couldbejustonecharacterlong)afterthefirstsixcharactersofanybarcodeatleastsix characterslong. Afewnotesaboutthesamplescript:
ScanData isastringvariablewiththeoriginalbarcode.
67
NewString isavariablewhereyoustorethenewbarcode. ScanType isthenumbervariablethatkeepsthetypeofscandatareceived. OldLength isanintegervariable. XXYY isthestringyouinsert.

OldLength=String_Length(ScanData) If (Number_Greater_Than_Or_Equal(OldLength,6)) NewString=String_Combine(String_Left(ScanData,6), XXYY ) NewString = String_Combine(NewString,String_Right(ScanData, Number_Minus(OldLength,6))) Else NewString = ScanData End_If Scan_String(NewString,ScanType) Return ThissecondexampleconvertsanyDataMatrixscanvaluestoPDF417scanvalues.The ScanData and ScanType variablesdescribedforthepreviousexampleareused again. If (Number_Equal(ScanType,Get_Scan_Type_Value("DATAMATRIX"))) Scan_String(ScanData,Get_Scan_Type_Value("PDF417")) Else Scan_String(ScanData,ScanType) End_If Return
On Screen Update
Thisoptioncausesthescripttobeactivated(ifactivationisallowed)everytimethe textontheemulationscreenchanges.Thisincludesupdatesfromthehostorwhen theuserpressesakeyandthekeyvalueisshownonthescreen. Thefollowingexamplegeneratesascriptthatentersacommandeachtimea particularstringappearsonthescreen: Label:Start:
68
If (String_Equal(Get_Screen_Text_Columns(1,1,5),Ready, 0,FALSE)) Keypress_String(Proceed) Keypress_Key(Enter) End_If Wait_For_Screen_Update Goto: Start Return Ifthisscriptissettoactivatewhenthesessionfirstconnects,itwillworkasdesired withonelimitation.Becauseitisalwaysactivated,nootherscriptscanbeactivated duringtheemulationsession. Hereisanalternateimplementation: If (String_Equal(Get_Screen_Text_Columns(1,1,5), Ready, 0, FALSE)) Keypress_String(Proceed) Keypress_Key(Enter) End_If Return Ifthescriptissettoruneachtimethescreenupdates,yougetthedesiredbehavior. Becausethescriptisnotactiveallthetime,otherscriptscanbeactivatedaswell.
NOTE Usethisactivationoptioncarefullyasitcancauseascripttobeexecuted
frequently.
Chapter 6: Keyboard Creator
69

Thekeyboardcreatorallowsyoutomodifyorcreatecustomvirtualkeyboardstouse duringanemulationsession.Additionally,importyourowngraphicsfiles(bitmaps) tocreateuniquebuttonsforthekeyboard.Thissectionprovidesthefollowing information:
LaunchingtheKeyboardCreator SelectingKeyboardFiles CreatingKeyboards ImportingKeyboardGraphics CreatingandConfiguringKeys SizingandPositioningKeysandRows DeployingtheKeyboardtotheTEClient
Launching the Keyboard Creator

TheKeyboardCreatorisinstalledaspartoftheTEClient.
To launch from Avalanche: 1 FromtheAvalancheConsole,navigatetotheProfilestab,andselecttheprofile
3 SelectKeyboardCreatorandclickOK.
TheKeyboardCreatoropens.
To launch from the ActiveSync configuration utility: 1 Onthehostsystem,launchtheActiveSyncutility.
70
2 ClicktheKeyboardCreatorbutton.
TheKeyboardCreatorappears.
Selecting Keyboard Files

Keyboardfilescontainallthekeyboardsneededforagivenemulation(5250,3270, VT100,VT220,HP,orWEB).UseTable61todeterminethenameofthekeyboardfile thatshouldbeeditedforaparticularemulationtype.
File Name EM5250.KB EM3270.KB EMVT.KB EMHP.KB EMWEB.KB EMNONE.KB EMNUM.KB Emulation Type 5250 3270 VT100, VT220 HP WEB Displayed when a session is not connected Displayed for numeric keyboard
Table 6-1: EmulationTypesandFileNames
The .KB filesareusedbythekeyboardcreator.Whenyousaveyourkeyboard modifications,amatchingfilewiththe .KBB extensionisalsosaved.Thisfileisa binaryrepresentationofthekeyboardfileandwillbeusedbytheClienttodisplaythe keyboards.

To select a keyboard file: 1 Determinethenameofthekeyboardfileyouarecreating. 2 IntheSelectthefiletypefromthedropdownlist.
Figure 6-1. SelectingtheFileType
71
Creating Keyboards
Therearetwodefaultkeyboards:thedefaultalphakeyboardandthedefaultnumeric keyboard.Thedefaultalphakeyboardisdisplayedbydefault.Thedefaultnumeric keyboardisdisplayedwheninanumericfield(5250and3270only). Thissectionprovidesthefollowingkeyboardinformation:
AddingaKeyboard SizingKeyboards DeletingKeyboards Adding a Keyboard

Multiplekeyboardscanbeincludedineachkeyboardfile.Thekeyboardsarelinked togetherbyshiftkeys(specialkeyswhichdisplayanotherkeyboard).
To add a keyboard: 1 LaunchtheKeyboardCreator. 2 SelectKeyboard>NewKeyboardfromthemenu. 3 Enteranewnameforthekeyboard.
Figure 6-2. CreatingaNewKeyboard
NOTE Keyboardnamesmuststartwithaletter,mayonlycontainnumbersorletters,
andcanonlybe11characterslong.
4 UsetheKeyconfigurationoptionstoconfigureeachkeyofthekeyboard.
RefertoCreatingandConfiguringKeysonpage 73formoreinformation.
72
Sizing Keyboards
Youcanusethemousetoresizeakeyboard.Asyouincreasethesizeofthekeyboard, thesizeoftheapplicationareawilldecrease.
To resize the keyboard: 1 Mouseoverthetopborder,rightsideborder,ortheupperrightcornerofthe
keyboard.
2 Whenthedoublesidedarrowsappear,clickanddragthekeyboardtothedesired
size.
Deleting Keyboards
Whendeletingakeyboardthathaskeysassociatedwithit,anoptionwillbe presentedfordealingwithanyconnectionstothekeyboard.Keysthatreferencethe keyboardcanbedeleted,settoanemptyvalueorredirectedtoanotherkeyboard.
To delete a keyboard: 1 SelectKeyboard>DeleteKeyboardfromthemenu. 2 Selectwhatactiontotakeforreferencedkeys.
Figure 6-3. DeletingaKeyboard
Importing Keyboard Graphics

Thedefaultkeyboarddrawsthekeysonthecomputerscreen.However,youcan importagraphictobedisplayedinsteadofthecreatedkeys.Animportedgraphic willbeembeddedinthe .KB and .KBB files,soyouwillnotneedtosavethe importedgraphicfileonthedeviceseparately.
73
Whenyouimportagraphictouseasakeyorsetofkeys,youwillstillneedtocreate andpositionkeyvalues.Usethesliderbartochangehowdarkthegraphicandkeys arewhileeditingsothatyoucansizeandpositionthekeyscorrectly.

NOTE Besuretolabelthebuttonsyoucreate.Ifthemobiledeviceisunabletodisplay
thebitmapimage,thelabelswillstillappear.
To import a graphic: 1 IntheKeyboardCreator,clickImport. 2 Navigatetothelocationofthebitmapimageyouwanttoimport. 3 ClickOpen. 4 ClicktheSizeKeyboardtoGraphicbuttontomakethekeyboardthesamesizeas
theimportedgraphic.
5 Usethesliderbartoadjustthehowdarkandhowlightthegraphicsandbuttons
appearwhenediting.
Creating and Configuring Keys

Therearethreetypesofkeysthatcanbeonakeyboard:
Normalkeysrepresentletters,numbers,orothercharactersintheemulationand
canalsorepresentspecialemulationspecificfunctionkeys.
Shiftkeyscanpointtoanyotherkeyboardinthecurrentkeyboardfile. Hidekeyshidethekeyboardandallowanunobstructedviewoftheemulation
screen. Thissectionprovidesthefollowinginformation:
AddingaNewKey SizingandPositioningKeysandRows DeletingKeys
74
Adding a New Key

Youcanaddnewkeystoakeyboardandconfigurethekeyvaluesandconfigurethe followingoptions:
Label.Enterthetextthatwillappearonthevirtualkeywhenitisdisplayed. Reverse.Enablethisoptionforakeythatindicatestheactivekeyboardtype. KeyValue.SelectfromKey,Normal,Keyboard(shift),orHide.Keyvaluesallow

youtoselectemulationspecificactionstobeassignedtothekeys.Thelistofkeys availablewillvarydependingontheemulationtypeselected.
NOTE Normalkeyvaluescanbedisplayedorenteredasacharactervalue(theactual charactercreatedbythekeystrokeisshown),adecimalvalue(forcharacterswhich cannotbeshown),orahexadecimalvalue(forscancodesofspecialfunctionkeys). To add a new key: 1 SelectKeyboard>AddKey.
Thenewkeywillappearinthetopleftcornerofthekeyboard,ordirectlytothe rightofaselectedkey(ifitwillfit).
75
Figure 6-4. AddingaNewKey
2 Modifythevaluesforthekeyusingthekeyconfigurationoptions.
Figure 6-5. ConfiguringaNewKey
76
3 Repeattocreateadditionalkeysforthekeyboard.
Sizing and Positioning Keys and Rows

YoucanusetheconfigurationoptionsintheKeyregionoftheKeyboardCreatorto modifythesizeandpositionofthekeysonthekeyboard. TheFineAdjustmentsdropdownmenuallowsyoutoselectwhatobjectyouwantto modify:
KeyPosition.Selectthisoptiontomoveaselectedkeyonthekeyboard.Youcan
alsoadjustthekeypositionbyclickingonthekeyanddraggingittothedesired position.
RowPosition.Selectthisoptiontomoveanentirerow. KeyboardPosition.Selectthisoptiontomoveallthekeysonthekeyboard. KeySize.Selectthisoptiontoadjustthesizeofthekey.

Onceyouselecttheobjectyouwanttomodify,youcanusethearrowbuttonsto moveorsizethekeysandrows.TheAdjustDistancesliderdetermineshowmuch ofaneffecteachclickofanarrowbuttonwillhave.Thisissetonascaleof110 pixels.
To position a key: 1 SelectanexistingkeyorclickNewKey. 2 FromtheFineAdjustmentsdropdownmenu,selectKeyPosition. 3 Useoneofthefollowingmethodstomovethekey:
Usethearrowbuttonstopositionthekeyinthedesiredlocation. Draganddropthekeytothedesiredlocation.
To position a row: 1 Clickakeyintherowyouwanttoposition. 2 FromtheFineAdjustmentsdropdownmenu,selectRowPosition. 3 Usethearrowbuttonstopositiontherowinthedesiredlocation.
77
To resize a key: 1 SelectanexistingkeyorclickNewKey. 2 FromtheFineAdjustmentsdropdownmenu,selectKeySize. 3 Usethearrowstoadjustthesize.
Deleting Keys
Youcandeletekeysthatyoudonotwantfromthekeyboard.
To delete a key: 1 Selectthekeyyouwanttodelete. 2 SelectKeyboard>RemoveKey.
Deploying the Keyboard to the TE Client

Onceyouhavecompletedcreatingyourkeyboardandkeys,clicktheSaveiconto saveyourkeyboard,andthenexittheKeyboardCreator.YourTEClientwillupdate withthenewkeyboardthenexttimethemobiledevicesyncs.
Chapter 7: Resource Editor
78

TheResourceEditorallowsyoutoimportsoundandpicture(.wav and .bmp format)filesthatcanbedeployedtoyourmobiledevices.Thissectionprovidesthe followinginformation:
LaunchingtheResourceEditor AddingaBitmap AddingaSound EditingFiles DeployingFilestotheTEClient
Launching the Resource Editor

TheResourceEditorispartoftheTEClientsoftwarepackagethatallowsyouto import .wav and .bmp filestoyourdevices.
To launch from the ActiveSync configuration utility: 1 Onthehostsystem,launchtheActiveSyncutility.
2 ClicktheResourceEditorbutton.
TheResourceEditorappears.
To launch from Avalanche: 3 FromtheAvalancheConsole,navigatetotheProfilestab,andselecttheprofile
5 Fromthemenulist,selectResourceEditorandclickOK.
TheResourceEditoropens.
79
Figure 7-1. LaunchingtheResourceEditor
Adding a Bitmap
Anygraphicfilewitha .bmp extensioncanbeaddedtotheResourceEditor.
To add a bitmap: 1 FromtherightpaneoftheResourceEditor,clickAddnewbitmap.
TheOpendialogboxappears.
2 NavigatetothedesiredfileandclickOpen.
ThefileappearsbeneaththeBitmapsfolderintheleftpaneoftheResourceEditor.
Adding a Sound
Anysoundfilewitha .wav extensioncanbeaddedtotheResourceEditor.
To add a sound: 1 FromtherightpaneoftheResourceEditor,clickAddnewsound.
TheOpendialogboxappears.
2 NavigatetothedesiredfileandclickOpen.
80
ThefileappearsbeneaththeSoundsfolderintheleftpaneoftheResourceEditor. PlaythesoundbyselectingitandclickingPlayintherightpaneoftheeditor.
Editing Files
YoucanusetheResourceEditortorenameorremovefiles.
To rename files: 1 IntheleftpaneoftheResourceEditor,expandtheappropriatefolderandselect
thedesiredfile.
2 IntherightpaneoftheResourceEditor,clickRename.
TheRenameResourcedialogboxappears.
3 Enterthenewfilenameintheavailabletextbox. 4 ClickOK.
ThenewfilenameappearsintheleftpaneoftheResourceEditor.
To remove files: 1 IntheleftpaneoftheResourceEditor,expandtheappropriatefolderandselect
thedesiredfile.
2 IntherightpaneoftheResourceEditor,clickRemove.
TheResourceEditordialogboxappears.
3 ClickYes.
ThefileisremovedfromtheResourceEditor.
Deploying Files to the TE Client

Onceyouhavefinishedaddingbitmapandsoundfiles,clicktheSaveicontosave yourchanges,andthenexittheResourceEditor.YourTEClientwillupdatewiththe newfilesthenexttimethemobiledevicesyncs.
Chapter 8: Reformatting Emulation Screens
81

TheTEClientscreenreformatterallowsyoutomodifytheappearanceofTelnet emulationscreens.Youcancreateascreenlayoutthatincludesitemsyouwantthe mobiledeviceusertosee,andexcludesitemsthatshouldnotbevisibletotheuser. ThescreenreformatteralsoallowsyoutoaddscriptingandSpeakeasyactionstoa screen. Thescreenreformatterdoesnotchangetheactualemulationscreen,onlythe appearanceofthescreenasitdisplaysonthedevice.Therefore,anyscriptsspecificto anemulationscreenwillstillworkcorrectly.Inaddition,anyotheritemsspecifictoan emulationscreenwillcontinuetofunctionproperlyeveniftheyarenotvisibleonthe modifiedscreen.
NOTE ThescreenreformatterisincludedinTEClient7.1andlaterversions.
Thefollowingstepsoutlinetheprocessofmodifyingemulationscreensusingthe screenreformatter:
1 Performascreencapture.UsethescreencapturefunctionwithintheTEClientor
SessionMonitortocaptureanyemulationscreen(s)youwanttoreformat.
2 ImportthescreencaptureintotheScreenReformatter.Importthecaptured
screen(s)youwanttoreformat.
3 Reformattheemulationscreen.Copytheregionsoftheemulationscreenwhich
youwouldliketoincludeonthemodifiedscreen.Youcanalsomodifythescreen furtherbychangingthebackgroundcolorandaddingthingsliketext,scripts,and Speakeasyfunctions.

4 Assignverificationitems.Youcanselectahostprofileand/oritemsonthe
emulationscreenwhichwillbeverifiedtodeterminewhetherthereformatted screenshouldbedisplayed.
5 SavethereformattedscreensaspartoftheClientconfiguration.Afteryouhave
modifiedthescreen(s)asdesired,clicktheSaveicontosaveyourchanges.
6 DeploytotheTEClient.ThereformattedscreensaredeployedtotheTEClient
thenexttimeitsyncs. ThescreenreformattermodifiesthescreensforaspecificClient.Youcanexport modifiedscreensinordertousethemwithotherClients,however.
82
Thissectioncontainsthefollowinginformation:
PerformingaScreenCapture UsingtheScreenReformatter ImportingScreens OrganizingScreens ModifyingaScreen VerifyingaScreen SpeakeasyandScriptingSupport DeployingReformattedScreens ExportingScreens

NOTE TheScreenReformatterdoesnotworkwithWebemulation.
Performing a Screen Capture

Inordertoreformatthescreensforanemulationsession,youneedtoperforma screencapture.YoucandothisfromtheTEClientorfromaSessionMonitor.Screen capturesaresavedwiththeextension .wltsc inthelocationofyourchoice. Screencapturefilescanbecombinedandreorderedduringtheeditingprocess.
To capture: 1 FromtheWindowsTEClientTermmenu,selectScreenCapture.
Or FromSessionMonitor,selectFile>ScreenCapture.
NOTE FormoreinformationaboutusingSessionMonitor,refertoSessionMonitoron
page 139.
83
TheScreenCaptureFiledialogboxappears.
2 SpecifythelocationwhereyouwanttosavethescreencaptureandclickSave.
TheScreenCaptureFiledialogboxclosesandacheckmarkappearsnexttothe ScreenCapturemenuitem,indicatingthatscreencapturingisenabled.
3 Connecttothedesiredhostprofileandaccessthescreensthatyouwantto
reformat.
4 Whenyouhavefinishedcapturingthedesiredscreens,selectScreenCapturefrom
theOptionorTermmenu. ThescreencaptureissavedandthecheckmarknexttotheScreenCapturemenu itemdisappears,indicatingthatscreencapturingisdisabled.

NOTE ScreencapturingisalsodisabledwhenyouclosetheTEClient.
Using the Screen Reformatter

Fromthescreenreformatter,youcanimportscreens,organizeandmodifythem,and savethemasmasterfilestobedeployedtotheclient.Thescreenreformattershould beaccessedfromtheClientpackageyouwantthescreenstobeassociatedwith. TheScreenReformatteriscomposedofseveraldifferentsectionsorviewsthatcanbe resizedtofityourcontents.TheScreenReformatteralsohasastatusbarandatool bar. TheScreenReformatterelementsaredescribedinthefollowingsections:
TreeView InitialScreenView ModifiedScreenView DescriptiveView StatusBar ToolBar
84
To access the screen reformatter from the Windows TE Client: 1 OpentheTEClient. 2 FromtheTermmenu,selectConfigure>ScreenReformatter.
TheInputPassworddialogboxappears.
3 EnterthepasswordintheInputHostConfigPasswordtextboxandclickOK.
TheScreenReformatteropens.
To access the screen reformatter from Avalanche: 1 FromAvalanche,selectthesoftwareprofileassociatedwiththeTEpackage. 2 SelectthepackagefromtheSoftwarePackageslistandclickConfigure.
TheConfigureSoftwarePackagedialogboxappears.
3 SelectScreenReformatterandclickLaunch.
To access the screen reformatter from the ActiveSync configuration utility: 1 OpentheTEClientconfigurationutility. 2 ClicktheScreenReformatterbutton.
Tree View
TheTreeViewistheleftsectionofthescreenreformatter.Itdisplaysallofthescreens imported.Youcanusethetreeviewtonavigatetoaspecificscreen;select,delete, duplicate,orrenamescreens;createcollectionstoorganizethescreens;and draganddropscreenstoreorderthemorputtheminacollection.
85
Figure 8-1. TreeView
TochangetheappearanceoftheTreeView,youcanrightclickintheTreeVieworuse theoptionsintheViewmenu.YoucanhidetheTreeView,displayorhidethe expansionbuttonsforcollections,ordisplaysmallorlargethumbnailsofthescreens.
Initial Screen View

TheInitialScreenViewisthebottomsectionoftheScreenReformatter.Thisview displaysthescreenthatwascaptured,beforemodifications.Youcantoggleagrid displayoverthescreenviewbyclickingView>ShowGrid.
Modified Screen View

TheModifiedScreenViewisthetopleftsectionoftheScreenReformatter.Thisview displaysthemodifiedversionofthecapturedscreen.TheModifiedScreenView consistsoftheareascopiedfromtheoriginalscreencapture,aswellasanyadded text.
86
Figure 8-2. ModifiedScreenView
Thesolidwhitelineoutlinesthescreenarea,andthedottedlinessurroundareasof addedorcopiedtext.ResizethescreenareaortheModifiedScreenViewbyclicking theborderanddraggingit.Youcanalsospecifythenumberofrowsandcolumnsby rightclickingtheviewandselectingScreenSize.Toggleagriddisplayoverthe screenviewbyclickingView>ShowGrid.
Descriptive View
TheDescriptiveViewisthetoprightsectionoftheScreenReformatter.Thisview displaysinformationabouttheModifiedScreen.
87
Figure 8-3. DescriptiveView
TheDescriptiveViewinformationisdividedintothefollowingsections:
ScreenVerifyCriteria.Thissectioncontainsalistofitemsthatareusedto
determinewhetherthemodifiedemulationscreenshouldbedisplayed.Inorder forthemodifiedscreentobedisplayed,allofthetextandfieldverificationitems mustmatch.Iftherearemultiplecursororhostprofileverificationitems,onlyone ofeachmustmatch.
ModifiedScreenCreation.ModifiedScreenCreationcontainsalistofactionsthat
willbeusedtoreformatthescreen.Theseincludeaddedtextandcopiedtext.
SupportingActions.SupportingactionsarescriptingorSpeakeasyactions
performedbytheScreenReformatterwhenamodifiedscreenisused.
ScreenComments.Anycommentsonhowthescreenismodifiedorthepurpose
ofthescreenwillappearinthissection.
ScreenDetails.Thissectioncontainsinformationabouttheoriginalscreen
capture.
Status Bar
ThestatusbarislocatedatthebottomoftheScreenReformatterwindow.Youcan choosetodisplayorhidethestatusbarbyenablingordisablingtheStatusBaroption intheViewmenu. Theleftsideofthestatusbardisplaysinformationaboutmenuoptionsandtoolbar buttonswhenthemousepointerishoveringoverthem.Therightsideofthestatus barindicateswhenthe Caps Lock, Num Lock, and Scroll Lock areengaged.
88
Tool Bar
Thetoolbarprovidesbuttonsforcommonactionsinthescreenreformatter.Youcan displayorhidethetoolbarbyenablingordisablingtheToolbaroptionintheView menu.ThefollowingtableprovidesinformationabouteachToolBarbutton. ClickthisbuttontoaccesstheOpendialogboxandimportascreen captureormasterfile. ClickthisbuttontosavescreenreformattingchangesaspartoftheClient configuration.Ifyouwanttosavethescreensinordertousethemwitha differentClient,useFile>ExportMasterFile. Clickthisbuttontoundothelastchange.
Clickthisbuttontoredothelastchange.
Clickthisbuttontodisplaythehelpindex.
Clickthisbuttontosearchforaspecificitemwithinthehelp.
Importing Screens
Whenyouperformascreencapture,thescreensaresavedasa .wltsc file.These filescanbeimportedintothescreenreformatterinordertomodifythescreens.After youmodifyscreens,youcansavethemasamasterfilewitha .wlrmf extensionif youwanttoexportthemforadifferentdeviceorTEClient. Youcanmergescreencapturefilesandmasterfilestomakeiteasiertomanage modifiedscreens.Importthefirstfile,andthenimportadditionalfilestomergethem withthecurrentlyopenscreens.
NOTE Whenthereareduplicatescreensinthescreencapturewhenyouimportit,each
screenwillonlybeimportedonce.Anyduplicateswillbediscarded.
89
Duringamerge,thereformatterwillonlyimportnewscreens.Iftherearescreensin thefileyouareaddingthatmatchscreensalreadyopen,thereformatterwilldiscard them.

To import screens: 1 FromtheFilemenu,selectImportScreenCaptureorImportMasterFile.
TheImportScreenCapturedialogboxappears.
2 Navigatetoandselectthedesiredscreencaptureormasterfile. 3 ClickOpen.
Ifyoualreadyhaveascreenfileopen,thescreenreformatterwillpromptyouto eitherdiscardtheopenfileormergetheopenfilewiththenewfile.Whenyou merge,youarepromptedtoindicatewhichcollectiontoaddthenewscreensto. TheScreenReformatterdialogboxappears,indicatingthenumberofuniquescreens thatwereadded.
Organizing Screens
TheTreeViewallowsyoutoorganizescreensintocollectionstomakethemeasierto manage.Createacollectiontogroupsimilarscreenstogetherorapplytextallofthem simultaneously.Eachscreencanonlybelongtoonecollectionatatime.Screenscanbe reorderedormovedtocollectionsbydraggingthemintothecorrectpositioninthe TreeView. TheModifiedScreenViewandInitialScreenViewshowonescreenatatime.Youcan navigatetoadifferentscreenbyclickingonitintheTreeView,usingtheHome, End, Page Up, and Page Down keys,orbyusingtheoptionsintheViewmenu.
To create a new collection: 1 IntheTreeView,selectthenameofthecollectionwhereyouwanttoadda
subcollection.Ifyouwantthenewcollectiontobeatoplevelcollection,selecta toplevelcollection.
2 RightclickthenameofthecollectionandselectAddCollection.
TheAddCollectiondialogboxappears.
3 Typethenameofthenewcollectioninthetextbox.
90
4 Ifyouwouldlikethenewcollectiontobeatoplevelcollection,enablethe
Toplevelcollectionoption.
5 ClickOkay.
ThecollectionisaddedtotheTreeViewandyoucandraganddropscreensinto thenewcollection.
Modifying a Screen
Thissectionprovidesinstructionsformodifyingscreencaptures.Thefollowing informationisincluded:
Renaming,Duplicating,orDeletingaScreen CopyingText AddingTexttotheModifiedScreen ResizingtheModifiedScreen ChangingtheBackgroundColoroftheScreen AssigninganInitialFieldValue CreatingScreenComments UsingScreenTemplates Renaming, Duplicating, or Deleting a Screen
Ascreencanberenamed,duplicated,ordeletedbyrightclickingonitintheTree Viewandselectingtheappropriateoptionfromthecontextmenu. Duplicatingascreenmaybeusefulwhenyouwanttocreatemultiplereformatted screenoptionsforthesameinputscreen.Forexample,youcouldcreatetwo reformattedversionsoftheloginscreenfortwolanguages.Createhostprofiles dependingonthelanguageused,thenassociateeachreformattedversionwithahost profile.
91
Copying Text
Youcancopytexttouseinthemodifiedview.Whenyoucopytext,youcanchange theattributesofthetextandbackground.Youcanalsoapplyacopiedregiontoallthe screensinthecurrentcollection.
To copy: 1 Clickanddragthemouseovertheareayouwishtocopy.
Figure 8-4. CopyingaRegion
Whenyoureleasetheleftmousebutton,amenulistappears.
2 SelectCopyRegiontocopytheselectedregiontotheModifiedScreenView.
TheReformattedScreenCopyAttributesdialogboxappears.
3 Ifyouwanttheselectedregiontoappearoneachscreeninthecollection,enable
theAddthistexttoallscreensincollectionoption.
NOTE Thiswilladdthetexttoallthescreensinthecurrentcollectionbutwillnotadd
thetexttoscreensinanysubcollections.
92
4 Ifyouwanttousethetextexactlyasitappearsintheoriginalscreen,enabletheDo
notchangetheattributesoption. Or Ifyouwanttocustomizetheappearanceofthetext,enabletheUsethesecustom attributesoption. Thefollowingoptionsbecomeavailable:
Onlyusewhenthecursorisinthecopiedareacheckbox.Whenthisoptionis
selected,thespecifiedtextattributeswillbeappliedonlywhenthecursorisin thecopiedregion.Whenthecursorisnotinthecopiedregion,thetextwill appearbuttheoriginalattributeswillbeused.Ifthisoptionisnotselected,the textwillalwaysusethespecifiedattributes.
ForegroundColor,BackgroundColorandWeightdropdownmenus.Youcan
edittheappearanceofthetextbyselectingthedesiredcolorsandweightfrom thesemenus.
Italicized,Underlined,CrossedOut,Reversed,Blinking,DoubleWidth,
DoubleWidthandDoubleHeightcheckboxes.Youcanfurtheralterthetext appearancebyenablingthesecheckboxes.
5 Whenyouarefinishededitingthetextformatting,clickOK.
TheReformattedScreenCopyAttributesdialogboxclosesandthecopiedtext appearsintheModifiedScreenView.
Adding Text to the Modified Screen

Ifdesired,youcanaddtextthatwillappearonthemodifiedscreen.Youcanedittext thathasbeenaddedtothemodifiedscreen.
To add text: 1 FromtheEditmenu,selectAddText.
Or IntheModifiedScreenView,rightclickandselectAddTextfromthecontext menu. TheReformattedScreenTextdialogboxappears.
93
2 Enteryourtextintheavailabletextbox. 3 Edittheappearanceofthetextwiththeavailabledropdownmenusand
checkboxes.
4 Ifyouwantthetexttobeaddedtoallofthescreensinthecurrentcollection,
enabletheChangethisexactlineoftexteverywhereinthecollection.
5 Whenyouarefinishededitingthetext,clickOK.
TheReformattedScreenTextdialogboxcloses,andthetextappearsintheModified ScreenView. Tomakechangestoexistingtext,rightclickthetextandselectEditTextfromthe contextmenu.
Changing the Font Size

Themodifiedscreencanuseadifferentfontsizethantheoriginalscreen.Whenyou usetheEdit>FontSizeoption,youcanchangethefontsizefortheentirescreen.You alsohavetheoptionofchangingthefontsizeforallthescreensforthecurrentClient. Whenyouapplythefontsizetoallscreens,thisincludesanyscreensimportedlater.
To change the font size for a screen: 1 Selectthescreenyouwantthechangetobeappliedto. 2 ClickEdit>FontSize.
TheModifiedFontSizedialogboxappears.
3 EnabletheUsethisfontpointsizeoptionandtypethedesiredfontsizeinthebox. 4 IfyouwantthisfontsizeappliedtoallthescreensforthisClient,enabletheApply
toallscreensoption.
5 ClickOK. 6 TheModifiedFontSizedialogboxclosesandthefontsizeisadjusted.
Resizing the Modified Screen

Youcanadjustthesizeofthemodifiedscreentofitthescreenofthetargetdevice.You canclickanddragthebordersofthescreenintheModifiedScreenView,orusethe followingstepstoresizeitbythenumberofrowsandcolumnsyouwantdisplayed. WhenyouusetheEdit>ScreenSizeoption,youhavetheoptionofchangingthe
94
screensizeforallthescreensforthecurrentClient.Whenyouapplythescreensizeto allscreens,thisincludesanyscreensimportedlater.
To resize: 1 FromtheEditmenu,selectScreenSize.
Or IntheModifiedScreenView,rightclickandselectScreenSizefromthecontext menu. TheModifiedScreenSizedialogboxappears.

2 AdjustthenumbersintheRowsandColumnstextboxes. 3 IfyouwantthisfontsizeappliedtoallthescreensforthisClient,enabletheApply
toallscreensoption.
4 ClickOK.
TheModifiedScreenSizedialogboxcloses,andthescreensizeadjusts.
Changing the Background Color of the Screen

Toimprovethereadabilityofthescreenandimproveitsappearance,thescreen reformatterallowsyoutochangethebackgroundcolorofthescreen.Thechangecan beappliedtothecurrentscreen,allscreens,orthescreensinthecurrentcollection.
To change the background color of the screen: 1 FromtheEditmenu,selectBackgroundColor.
Or IntheModifiedScreenView,rightclickandselectBackgroundColorfromthe contextmenu. TheModifiedBackgroundColordialogboxappears.

2 Tospecifythebackgroundcolorforthescreen,enabletheUsethisbackground
coloroptionandselectthenewbackgroundcolorfromthedropdownlist.
3 Ifyouwanttoapplythebackgroundcolortoobjectsalreadyonthemodified
screen,enabletheApplytoalltextandcopyregionsalreadyonthescreen checkbox.
95
4 Ifyouwanttoapplythecolortoallthescreensinthecurrentlyselectedcollection,
ortoallthescreensopen,enabletheApplytoallscreensinthecollectionor Applytoallscreensoption.
5 ClickOKtoapplythebackgroundcolor.
Thecolorisappliedtotheselectedscreen(s).Toreverttousingthedefault backgroundcolorforthescreen,opentheModifiedBackgroundColordialogboxand enabletheUsethedefaultbackgroundcoloroption.
Assigning an Initial Field Value

Ifyouhaveafieldthatalwaysorfrequentlyrequiresthesamevalue,youcanassign aninitialvaluetothefieldwhentheClientaccessesthatscreen.Forinstance,ifthere isaQuantityfieldandthevalueisusually1,youcanpopulatethefieldwith1,and theusercanavoidreenteringthatvalueeachtimethescreenisaccessed.Ifthe quantitychanges,theusercanchangethevalueinthefield.
NOTE Thisoptionisonlyavailablewithblockorientedterminalemulation,suchas
5250or3270.Itisnotavailableforcharacterorientedterminals.
To assign an initial field value to a field: 1 IntheInitialScreenView,rightclickonthefieldtowhichyouwanttoassignan
initialvalue.
2 SelectAddFieldInitialValuefromthecontextmenu.
TheInitialFieldValuedialogboxappears.
3 EnterthedesiredfieldvalueintheavailabletextboxandclickOK.
TheInitialFieldValuedialogboxclosesandtheinitialvalueisassigned.Theinitial fieldvaluewillbeassignedevenifthefieldisnotcopiedtothemodifiedscreen.
NOTE TheScreenReformatterdoesnotverifyanyfielddata.Youmustensurethatthe
valueyouenterisvalidforthatfield.
96
Creating Screen Comments

Screencommentscanhelpinkeepingyourreformattedscreensorganizedbyadding supplementalinformationaboutthescreen.Youcanlistinformationaboutthescreen, anymodificationsoractionsonthescreen,orthesituationthescreeniscreatedfor. ScreencommentsaredisplayedintheDescriptiveView.Whenyouexportamaster file,thescreencommentsareexportedwiththerestofthereformatting.
To create a screen comment: 1 Selectthescreenforwhichyouwanttocomment. 2 ClickEdit>ScreenComments.
Or RightclicktheDescriptiveViewandselectEditScreenCommentsfromthe contextmenu. TheScreenCommentsdialogboxappears.

3 Typethecommentsforthescreen.Whenyouhavefinishedyourcomments,click
OK. ThedialogboxclosesandthescreencommentsappearintheDescriptiveView.
Using Screen Templates

Whenseveralmodifiedscreenswillhaveasimilarappearance,youcansavea modifiedscreenasatemplatetostreamlinetheprocessofmodifyingscreens.A templatewillcontainallthemodifications,actions,andverificationitemsfora modifiedscreen. Youcanhavemultipletemplatescreenssimultaneously,buttemplateswillnotbe exportedinamasterfile.
To create a screen template from an existing modified screen: 1 Selectthemodifiedscreenyouwanttouseasatemplate. 2 ClickFile>SaveTemplate.
TheSaveTemplateFiledialogboxappears.
3 NamethetemplatefileandclickSavetosavethefiletothedesiredlocation.
97
To apply a modified screen template to a screen: 1 Selectthescreenyouwantthetemplateappliedto. 2 ClickFile>LoadTemplate.
TheLoadTemplateFiledialogboxappears.
3 NavigatetothetemplatefileyouwanttoapplyandclickOpen.
Themodifications,actions,andverificationitemsinthetemplateareappliedtothe currentmodifiedscreen.
Verifying a Screen
Inordertohavethescreenreformatterdisplaythecorrectmodifiedscreen,you shouldidentifyverificationitemsontheoriginalhostscreenthatmustbematchedin orderforthemodifiedscreentobedisplayed.Eachmodifiedscreenshouldhave verificationitems(oracombinationofitems)uniquetotheassociatedhostscreenso thatitwilldisplayattheappropriatetime. Thescreenreformattercomparestheverificationitemsforeachreformattedscreen withthecurrenthostscreenanddisplaysthefirstreformattedscreenwithcriteriathat match. ThescreenreformatterstartswiththefirstmodifiedscreenintheTreeViewand continuesdownthelistuntilitfindsascreenwithmatchingcriteria.Ifthefirst(top) screenintheTreeViewonlyhashostprofileverification,thereformatterwillalways displaythatfirstreformattedscreenforallhostscreensusingthathostprofile.Itwill notcontinuetosearchforabettermatch. Hostprofiles,textonthehostscreen,cursorpositiononthehostscreen,andfieldsare allitemsthatcanbeusedtoverifyascreen. Thissectionincludesinstructionsforthefollowing:
AddingHostProfileVerification AddingTextVerification AddingCursorVerification AddingFieldVerification
98
OrderingorDeletingVerificationItems Adding Host Profile Verification

Whenyouuseahostprofileasaverificationitem,themodifiedscreenwillonlybe displayedwhenthespecifiedhostprofileisinuse.Ifyoudonotspecifyahostprofile, thereformattedscreencanbeusedbyallhostprofiles.Wavelinkrecommendsalways usingahostprofileverification.
To add host profile verification: 1 FromtheEditmenu,selectAddVerifyHostProfile.
Or IntheInitialScreenView,rightclickandselectVerifyHostProfilefromthe contextmenu. TheHostProfileVerificationdialogboxappears.

2 Selectthedesiredhostprofilefromthedropdownmenu. 3 Ifyouwanttoapplythesamehostprofileverificationtoallthescreensinthe
collection,enabletheAddthisverificationtoallscreensinthecollectionoption.
4 ClickOK.
TheHostProfileVerificationdialogboxclosesandhostprofileverificationisadded forthescreenorscreens.ThenameofthehostprofileappearsintheScreenVerify CriteriaintheDescriptiveView. Toremoveahostprofileverificationitem,rightclicktheitemintheDescriptive ViewandclickDeleteitem.
Adding Text Verification

Selecttextontheoriginalemulationscreenthatmustbeverifiedbeforethemodified screenisdisplayedtoamobiledeviceuser.Theselectedtextwillstillbeverifiedeven ifitisnotcopiedtothemodifiedscreen.Youcanchoosetextthatmustbeexactlythe same,textthatmustbedifferent,ortextthatmustnotchange.Textverificationis casesensitive,andanyspacesatendofatextselectionwillbediscardedbefore verification.
To add text verification: 1 Clickanddragthemouseoverthetextyouwanttoverify.
99
2 Fromthecontextmenu,selectoneofthefollowingoptionstoverifytext:
VerifyTextMatches.Thetextmustmatchexactlyorthemodifiedscreenwill
notbeused.
VerifyTextDifferent.Thetextmusthaveatleastonecharacterdifferentorthe
modifiedscreenwillnotbeused.
VerifyTextDoesntChange.Ifthetextchangesatanypoint,themodified
screenwillnolongerbeused. ThetextverificationitemappearsintheScreenVerifyCriteriasectionofthe DescriptiveViewwindow.
Adding Cursor Verification

Selectaspecificcursorlocationontheoriginalemulationscreenthatmustbeverified beforethemodifiedscreenisdisplayedtoamobiledeviceuser.Theselectedlocation willstillbeverifiedevenifitisnotcopiedtothemodifiedscreen.
To add cursor verification: 1 Clickanddragthemouseoverthecursorlocationyouwanttoverify. 2 Fromthecontextmenu,selectVerifyCursor.
ThecursorverificationitemappearsintheScreenVerifyCriteriasectionofthe DescriptiveViewwindow.
Adding Field Verification

Youcanselectaspecificfieldontheoriginalemulationscreenthatmustbeverified beforethemodifiedscreenisdisplayedtoamobiledeviceuser.Theselectedfields sizeandlocationonthehostscreenwillstillbeverifiedevenifitisnotcopiedtothe modifiedscreen.
To add field verification: 1 Rightclickonthefieldyouwanttoverify. 2 Fromthecontextmenu,selectVerifyField.
ThefieldverificationitemappearsintheScreenVerifyCriteriasectionofthe DescriptiveViewwindow.
100
Ordering or Deleting Verification Items

Whenyouhavemultipleverificationitemsonthemodifiedscreen,youcandetermine theorderinwhichtheitemsareverified.
To arrange items in the desired order: 1 RightclickanareathatyouhaveconfiguredforverificationintheInitialScreen
View.
2 Fromthecontextmenu,selectoneofthefollowingoptions:
SelectMakeFirstItemtodesignatethecurrentitemasthefirsttobeverified. SelectMakeNextItemtodesignatethecurrentitemasthenextverification
iteminthelist.
SelectMakePreviousItemtodesignatethecurrentactionastheprevious
verificationiteminthelist.
SelectMakeLastItemtodesignatethecurrentitemasthelastbeverified. SelectDeleteItemtoremovethecurrentverificationitem.
Speakeasy and Scripting Support

TheScreenReformatterallowsyoutoaddsupportforTerminalEmulationfeatures suchasSpeakeasyandscripting.WhenyouuseSpeakeasyorscriptingactionsinthe screenreformatter,theactionsareconsideredscreenactions.Thissectionprovides informationaboutthefollowing:
AddingTexttoSpeechSupport AddingSpeechtoTextSupport AddingScriptingSupport OrderingScreenActions Adding Text-to-Speech Support

Youcanaddtexttothemodifiedscreenthatwillbeconvertedintospeechandplayed backtothemobiledeviceuser.Thiscanbetextfromthehostscreenortextaddedjust forthemodifiedscreen.Multipletexttospeechactionswillbeprocessedwithouta
101
pauseiftheyareadjacent.Youcanalsousethescreenreformattertosettexttospeech settings.
NOTE TexttospeechsupportisonlyavailableifyouhavelicensedWavelink
SpeakeasysoftwareinadditiontotheTEClient.
To add text-to-speech: 1 ClickEdit>AddTexttoSpeechText.
Or IntheInitialScreenView,rightclickandselectAddTexttoSpeechfromthe contextmenu. TheTexttoSpeechTextdialogboxappears.

2 TypeyourtextintheTexttobespokentextbox.Thisboxcanbeleftemptyifyou
onlywanttochangethetexttospeechsettings.
3 TypethedesiredtexttospeechsettingsinthePersistentTexttoSpeechSettings
touseand/ortheTemporaryTexttoSpeechSettingstousetextboxes.
NOTE Eachsettingmuststartwith tts_ andusetheformat setting=value. Multiplesettingscanbespecifiedandshouldbeseparatedbycommas.Thecomplete listofsettingsisavailableintheTerminalEmulationScriptingReferenceGuide. 4 ClickOK.
TheTexttoSpeechTextdialogboxclosesandyourtextisaddedtothescreen.It alsoappearsintheSupportingActionssectionoftheDescriptiveView.
To use existing text for text-to-speech: 1 Clickanddragthemouseoverthetextyouwanttocopy.
Whenyoureleasetheleftmousebutton,amenulistappears.
2 SelectTexttoSpeechCopy.
TheTexttoSpeechCopydialogboxappears.
102
3 TypethedesiredtexttospeechsettingsinthePersistentTexttoSpeechSettings
touseand/ortheTemporaryTexttoSpeechSettingstousetextboxes.
NOTE Eachsettingmuststartwith tts_ andusetheformat setting=value. Multiplesettingscanbespecifiedandshouldbeseparatedbycommas.Thecomplete listofsettingsisavailableintheTerminalEmulationScriptingReferenceGuide.
TheTexttoSpeechactionappearsintheSupportingActionssectionofthe DescriptiveView.
Adding Speech-to-Text Support

Youcanaddaspeechtotextactiontothemodifiedscreen.Thisactionconvertsthe usersspeechintotextthatwillbeprocessedaccordingtothegrammar(s)specified.It canprintthetexttothescreenaskeyboarddataorperformanactionassociatedwith thecommand. TheLocalActionsandGlobalActionstabsintheSpeechtoTextdialogboxallowyou toassignspecialactionstoSpeechtoTextresults,insteadofhavingthoseresults treatedaskeyboarddata.ForeachSpeechtoTextresultreceived,theLocalActions aretestedfirst.IfnoLocalActionsmatch,thentheGlobalActionsaretested.Ifno GlobalActionsmatch,theresultwillbetreatedaskeyboarddataandusethesettings configuredintheGeneraltab. GlobalActionsaresharedamongallthescreens,sochangingaGlobalActionforone SpeechtoTextsupportactionwillchangetheactionforallthescreens.Becausethe LocalActionstakepriorityoverGlobalActions,youcanoverrideaGlobalActionby creatingaLocalActionforthesameresultvalue.Forexample,youcouldadda GlobalActionthatlistsavailablecommandswhentheusersayshelp.Ifthereisa screenwherenotallthecommandsareavailable,useaLocalActiontooverridethe GlobalActionwithalistspecifictothatscreen.
NOTE SpeechtotextsupportisonlyavailableifyouhavelicensedWavelink Speakeasysoftware.IfyouhaveSpeakeasy1.24orlater,thescreenreformatter supportsdynamicgrammargeneration.Insteadofusinganexistinggrammar,usea listofwordsorphrasesseparatedby|(pipecharacter)togenerateaninternal grammar.SeetheSpeakeasyReferenceGuideformoreinformationondynamic grammargeneration.
103
To add speech-to-text: 1 ClickEdit>AddSpeechtoText.
Or IntheInitialScreenView,rightclickandselectAddSpeechtoTextfromthe contextmenu. TheSpeechtoTextdialogboxappears.
Figure 8-5. SpeechtoTextoptions
2 SelecttheSpeechtoTextGrammartousefromthedropdownmenu.
Or EnabletheUsemorethanonegrammaroptionandchoosethedesiredgrammars fromthelistboxes.Use CTRL + Click toselectmultipleitemsfromthelist.You cannotincludegrammarsfrombothmodes.
104
3 Ifdesired,selectakeyfromtheAdditionalkeypressafterresultdropdown
menu.Thespecifiedkeypresswillbeprocessedafterthespeechtotextaction.
4 IfyouwouldliketheSpeechtoTextenginetoverifythetextresult,enableVerify
Result. ThiswillmakeaVerifytabappear.
Figure 8-6. VerifyTab
5 ClicktheVerifytabandentertheanyofthefollowinginformation:
EnteraquestionintheVerificationQuestiontextbox. EnteragrammarnameintheVerificationGrammartousetextbox. EnteraresponseintheGrammarResponseifRighttextbox. EnteraresponseintheTexttoSpeechifRighttextbox.
105
EnteraresponseintheTexttoSpeechifWrongtextbox. Enteranumber(inseconds)intheTimeouttextbox.Thisishowlongthe
screenreformatterwillwaitforverificationthatitrepeatedthecorrectresult.If noverificationisreceived,theresultisdiscardedandnoactionisperformed.
6 ReturntotheGeneraltab. 7 Ifyouarenotusingaheadsetmicrophone,enabletheDelaySpeechtoTextto
avoidfeedbackcheckbox.Thiswillensurethatthemicrophoneignoresinput whiletexttospeechactionsarehappening.
8 IfyouwanttouseaspeechsettingintheSpeechtoTextaction,enterthesettingin
theSpeechtoTextSettingstousetextbox.
NOTE Eachsettingmuststartwith stt_ andusetheformatsetting=value. Multiplesettingscanbespecifiedandshouldbeseparatedbycommas.Ifavalueis notanumber,thentheSpeechtoTextenginewillusethevalueclosesttothevalue textdescriptionprovided.ThecompletelistofsettingsisavailableintheTerminal EmulationScriptingReferenceGuide.Onceasettinghasbeenchanged,thatvaluewillbe usedforfutureSpeechtoTextactionsuntilitischangedagain. 9 Ifyouwanttoconfigurelocalorglobalactionsforthescreen,selectthe
appropriatetabandclickAdd. TheResult/Actiondialogboxappears.
106
Figure 8-7. Result/ActionforSpeechtoText
10 Typethespeechtotextresultthatyouwanttoconfigureanactionforinthetext
boxandthenselecttheactionthatwillbeperformedwhentheusersaysthat.
NOTE Thespeechtotextresultsmustbeanexactmatchfortheactiontobeperformed.
Speechtotextresultsarecasesensitive.
Replacetheresultwiththistext.Replacesthespeechtotextresultwiththe
providedtext.Whenthisreplacementismade,theAdditionalkeypressafter resultvalueoftheGeneraltabisnotused,soifyouwanttouseanadditional
107
keypress,youshouldincludeithere.Forinstructionsondeterminingthevalue ofakeypress,seePerformingaKeyboardTestonpage 131. Use \ followedbythe4digithexadecimalnumbertospecifyaTelnetkey press,and \U followedbythe4digithexadecimalnumbertospecifya Unicodecharacter.Ifyouwanttoactuallyoutputabackslashcharacter,use \\ Forexample,toreplacetheresulteurowithfollowedbyaVT Enter keypress,usethisvalue: \U20ac\000d
Performakeypress.Replacesthespeechtotextresultwithakeypress.You
canusethenameofthekey(suchas F3 or Enter)orthehexadecimal number.
Startascript.Replacestheresultwithascript.Useanexistingscriptorclick
EditScriptstolaunchtheScriptEditor.Assigninitialvaluestothevariablesin thescriptbyusingacommadelimitedlistinsideofparenthesesfollowingthe scriptname.Forexample,torunthescriptDoItNowandsetthestringvariable UsertoluckyandthenumbervariablePositionto17,youwouldtypethis: DoItNow(User="lucky",Position=17)
PauseSpeechtoTextwhilethescriptisrunning.Disablesspeechtotextfor
thescreenreformatterwhilethescriptisrunning.Enablethisoptionifthe scriptisalsousingspeechtotextsothatonlyoneapplicationistryingtouse speechtotextatatime.
PerformanIDAaction.Replacestheresultwiththeastandardaction.Manyof
theseactionsarealsoavailableotherways,suchasbywritingascriptorusinga keypressvalue.
SetaSpeechtoTextorTexttoSpeechsetting.Replacestheresultbychanging
theSpeakeasysettingsfortheClient.Eachsettingmuststartwith stt_ or tts_ andusetheformat setting=value.Ifavalueisnotanumber,then theenginewillusethevalueclosesttothevaluetextdescriptionprovided.The completelistofsettingsisavailableintheTerminalEmulationScriptingReference Guide. Youcanchangemultiplesettingswithacommadelimitedlist(nospaces).The listmustcontainonlySpeechtoTextsettings,oronlyTexttoSpeechsettings. Youcannotmixthetwotypesofsettings.Ifyouneedtodothat,thencreateand callascriptinsteadofusingthisoption.
108
StandardBeep.ReplacestheresultwithastandardTEbeep.Ifthebeephas
beenmodifiedintheemulationparameters,themodifiedbeepwillbeused.
ErrorBeep.ReplacestheresultwithaTEerrorbeep.Ifthebeephasbeen
modifiedintheemulationparameters,themodifiedbeepwillbeused.
Restartthesupportingactionsforthisscreen.Replacestheresultwitharestart
ofthesupportingactionsforthescreen.Anytexttospeechactionsandscript actionswillberepeated.
DoNothing.Ignorestheresult.Thisoptionisusefulifagrammarisbeingused
thatcanreturnresultsthatdontapplytothecurrentscreen. ClickOKtosavethechangestotheLocal/GlobalActionandreturntotheSpeech toTextdialogbox.
11 Whenyouhaveconfiguredspeechtotextforthemodifiedscreen,clickOK.
TheSpeechtoTextdialogboxclosesandthespeechtotextactionisaddedtothe modifiedscreen. Ifyouneedtomodifythespeechtotextaction,rightclicktheactioninthe DescriptiveViewandselectEditSpeechtoText.
Adding Scripting Support

Ifdesired,youcandesignateascripttorunwhenthemodifiedscreenisfirst displayed.Thescriptcanprovideadditionalfunctionalitytothemodifiedscreen.
To add a script: 1 ClickEdit>AddScriptingSupport.
Or IntheInitialScreenView,rightclickandselectAddScriptingSupportfromthe contextmenu. TheScriptingSupportdialogboxappears.

2 SelectthedesiredscriptfromtheScripttolaunchdropdownmenu.
109
NOTE TheScripttolaunchdropdownmenuonlydisplaysscriptsthathavebeen savedintheScriptEditor.FormoreinformationaboutTerminalEmulationscripting, refertoWavelinkTerminalEmulationScriptingReferenceGuide. 3 Selecthowthescreenreformatterwillhandlethescript:
Ifyouwanttoensurethatthescriptdoesnotrunmultipletimes,enablethe
Dontlaunchthescriptifitisalreadyrunningcheckbox.
Ifyouwantthescripttoabortwhenthemodifiedscreenisnolongerinuse,
enabletheStopthescriptwhenreformattingchangesoption.
Ifyouwantthescreenreformattertowaituntilthescripthascompletedbefore
itproceedstothenextactionforthescreen,enabletheWaitforthescriptto finishbeforeperformingthenextsupportingaction.
4 ClickOK.
TheScriptingSupportdialogboxclosesandthescriptisaddedtotheSupported ActionslistedintheDescriptiveView.
Ordering Screen Actions

Whenyouhavemultipleactionsonthemodifiedscreen,youcandeterminetheorder inwhichtheactionsoccur.TheactionsarelistedintheDescriptiveViewinthe SupportedActionssection.SupportedscreenactionsareSpeakeasyandscripting actions.Youshouldlistthetexttospeechactionsbeforeanyspeechtotextactions.
To arrange actions in the desired order: 1 SelectthedesiredactionintheModifiedScreenView. 1 ClicktheEditmenu.
Or RightclickintheInitialScreenView. Amenulistappears.
2 Selectoneofthefollowingoptions:
110
MakeFirstActiontodesignatethecurrentactionasthefirstactiontobe
performed.
MakeNextActiontodesignatethecurrentactionasthenextactioninthelist. MakePreviousActiontodesignatethecurrentactionasthepreviousactionin
thelist.
MakeLastActiontodesignatethecurrentactionasthelastactiontobe
performed.
DeleteActiontoremovethecurrentaction.
Deploying Reformatted Screens

Onceyouhavefinishedmodifyingyourscreens,clickSavetosaveyourscreensand exittheScreenReformatter.TheTEClientwillupdatewiththenewscreensthenext timethedevicesyncs.
Exporting Screens
Youcanexportscreensaseitherascreencaptureorasamasterfile.Amasterfile containstheoriginalscreensandallmodifications,scriptingandSpeakeasyactions, andcomments.Ascreencapturecontainsonlytheoriginalscreens.
ExportingaMasterFile ExportingaScreenCaptureFile Exporting a Master File

OnceyouhavemodifiedscreensforaspecificClient,youcanexportthescreensin ordertousethemforadifferentClient.Amasterfileisonethatcontainsmodified screens,alongwiththeoriginalscreencaptureinformation.Youcancreateamaster filebyexportingallthescreensyouhavemodifiedorbyexportingacollection.
To export: 1 FromtheFilemenu,selectExportCollectiontoMasterFiletoexportthecurrent
collection. Or
111
FromtheFilemenu,selectExportMasterFiletoexportallthescreenscurrently open.Ifyouhavenotsavedyourmodifications,theScreenReformatterdialogbox appears,askingifyouwouldliketosaveyourchanges.ClickYes. TheExportMasterFiledialogboxappears.

2 Navigatetothelocationwhereyouwouldliketosavethefile,andenteranamein
theFileNametextbox.
3 ClickOK.
TheExportMasterFiledialogboxclosesandthemasterfileissaved.
Exporting a Screen Capture File

Ascreencapturefileonlycontainstheoriginalemulationscreens.Youcanmerge screencapturefilesandthensavethemasasinglefile,ordeleteunnecessaryscreens andresavethecapturefilesoitissmaller.Thefilecanthenbeusedatadifferent locationorforadifferentTEClient.
To export screens to a screen capture file: 1 FromtheToolsmenu,clickExportScreenCapture. 2 TheExportScreenCapturedialogboxappears. 3 Navigatetothelocationwhereyouwanttosavethefileandtypeanameforthe
screencapturefile.ClickSave. ThefilecanbeopenedandmodifiedatotherlocationsorforotherClients.
Chapter 9: Using the TE Client
112

AfteryouhaveinstalledandconfiguredtheTEClientonamobiledevice,youcan connecttotheemulationhost.ThissectionprovidesinformationaboutusingtheTE Clientonthemobiledevice.Itincludesthefollowinginformation:
CreatinganEmulationSession WorkingwithMultipleConcurrentEmulationSessions UsingtheVirtualEmulationKeyboard UsingScreenPanning UsingActiveText UsingtheTEClientDiagnosticsUtility UsingtheTEClientOptionsMenu LaunchingtheTEClientUsingCommandLineArguments
Creating an Emulation Session

TheTEClientisdesignedtoconnectamobiledevicetoanemulationhost.This sectionprovidesthefollowinginformation:
LaunchingtheTEClient InitiatinganEmulationSession DisconnectinganEmulationSession ExitingtheTEClient Launching the TE Client

DependingonthemethodthatyouusedtoinstalltheTEClient,youwillhave differentoptionsforlaunchingtheTEClient. IfyouinstalledtheTEClientthroughMicrosoftActiveSyncoranotherthirdparty application,thenyouwillbeabletolaunchtheapplicationfromtheWindowsCE Startmenuorfromthedesktop.
113
IfyouinstalledtheTEClientusingAvalanche,thenyouwillalsobeabletolaunchthe TEClientfromtheStartmenuorfromtheAvalancheEnablerinterfaceonthedevice.
To launch the TE Client from the Start menu: 1 Onthemobiledevice,accessStart>Programs. 2 IntheProgramsfolder,doubleclicktheTelnetCEClientshortcuticon.
Figure 9-1. TEClientShortcutIcon
TheTEClientlaunchesonthemobiledeviceanddisplaysthedefaultscreen.
Figure 9-2. TEClientDefaultScreen
To launch the TE Client from the Avalanche Enabler: 1 Onthemobiledevice,launchtheAvalancheEnabler. 2 IftheProgramsviewisnotavailableintheAvalancheEnabler,accesstheView
menuandenabletheProgramsview. TheTEClientshortcuticonappearsintheProgramsviewoftheAvalanche Enabler.
114
Figure 9-3. TEClientShortcutIconintheAvalancheEnabler
3 IntheProgramsviewoftheAvalancheEnabler,doubleclicktheTelnetCEicon.
TheTEClientlaunchesonthemobiledeviceanddisplaysthedefaultscreen.
Initiating an Emulation Session

UsetheTEClienttoinitiateanemulationsessionwithanyhostforwhichyouhave configuredahostprofile.
NOTE Formoreinformationabouthostprofilesandconfiguringhostprofilesforthe
TEClient,seeHostProfilesonpage 20.
To initiate an emulation session with a host: 1 Onthemobiledevice,launchtheTEClient.
TheTEClientdisplaysthedefaultscreen.
2 Press Enter.
TheSelectHostdialogboxappears.
115
Figure 9-4. SelectHostDialogBox
NOTE IfyouhaveconfiguredonlyonehostprofilefortheTEClient,theSelectHost dialogboxdoesnotappear.Instead,theTEClientautomaticallyattemptstoconnect tothehostforwhichyouhaveconfiguredthehostprofile. 3 IntheSelectHostdialogbox,selectthehosttowhichyouwanttoconnectandclick
OK. TheTEClientattemptstoestablishanemulationsessionwiththehost.
NOTE Iftheclientdoesnothavealicense,thentheAuthorizingTerminaldialogbox
appears.FormoreinformationaboutTEClientlicensing,seeLicensingtheTEClienton page 14.
Disconnecting an Emulation Session

UsetheTEClientOptionsmenutodisconnectfromanactiveemulationsession.
NOTE Ifyouhavemultiplesessions,youmustswitchtothesessionthatyouwantto
disconnectbeforeyoucandisconnect.Youcanonlydisconnecttheactivesession.
116
To disconnect from an emulation session: 1 AccesstheOptionsmenu. 2 IntheOptionsmenu,selectDisconnectSession[n][name],where:
[n]isthesessionnumberthatyouwanttodisconnect. [name]isthenameofthehostyouwanttodisconnect.
Figure 9-5. DisconnectinganEmulationSession
Thesessionthatyouselectedisterminated.
Exiting the TE Client

YoucanusetheOptionsmenutoexittheTEClient.Dependingontheconfiguration oftheClient,youmayberequiredtosupplyanexitpasswordbeforeyoucanexit.
NOTE Bydefault,theTEClientisnotconfiguredwithanexitpassword.Formore informationaboutconfiguringanexitpasswordfortheTEClient,seeConfiguring Passwordsonpage 162. To exit and close the TE Client:
FromtheTEClient,selectOptions>Exit.
117
Figure 9-6. ExitingtheTEClient
IfyouhaveconfiguredtheTEClientwithanexitpassword,theInputPassword dialogboxappears.TypetheexitpasswordandclickOK. TheTEClientcloses.
Working with Multiple Concurrent Emulation Sessions

AlthoughtheTEClientonlyhasonesessionactiveatatime,itcanmaintain connectionstomultiplehostssimultaneously.Thissectionprovidesthefollowing information:
AllowingMultipleConcurrentSessions InitiatinganAdditionalEmulationSession SwitchingBetweenActiveEmulationSessions Allowing Multiple Concurrent Sessions

Bydefault,theTEClientisconfiguredtoallowausertoengageinonlyoneemulation sessionatatime.However,theClientcansupportuptofourconcurrentemulation sessions.(Thesemayincludesessionstothesamehostortodifferenthosts.)To
118
provideformorethanoneactiveemulationsession,youmustconfiguretheTEClient toallowmultipleconcurrentsessions. WhentheTEClientisconfiguredtosupportmultiplesessions,thenmultiple connectionoptionsappearintheTEClientOptionsmenu.

To modify the maximum number of concurrent sessions: 1 AccesstheConfigurationManager. 2 LocatetheEmulation>Common>NumberofSessionsparameter. 3 UsetheNumberofSessionsdialogboxtospecifythemaximumnumberofsessions.
Youcanhaveupto4sessions.
Figure I-7. ModifyingtheMaximumNumberofConcurrentSessions
4 ClickOK. 5 Savethenewconfiguration. 6 ClosetheConfigurationManageranddownloadthenewconfigurationtothe
mobiledevice. FormoreinformationaboutusingtheConfigurationManager,seeUsingthe ConfigurationManageronpage 50.
Initiating an Additional Emulation Session

IftheTEClientisengagedinoneormoreemulationsessions,youmayinitiatean additionalemulationsessionfromtheOptionsmenu.
To initiate an additional emulation session: 1 EnsurethattheTEClientisconfiguredtoallowmultipleconcurrentsessions. 2 AccesstheTEClientOptionsmenu.
TheOptionsmenudisplaystheavailablesessions(between1and4)andindicates whichsessionsareconnectedtoahostandwhichareunconnected.
119
3 FromtheOptionsmenu,selectanunconnectedsessionthatyouwanttouseto
connecttothehost.
Figure 9-8. AvailableUnconnectedEmulationSession
TheTEClientnowdisplaysthedefaultscreen.(Thedefaultscreenpromptsyouto press Enter toconnecttoahost.)

4 Press Enter.
5 UsetheSelectHostdialogboxtoselectthehostwithwhichyouwanttoestablish
anemulationsession.
6 SelectOK.
TheTEClientattemptstoconnecttothehostthatyouhaveselected.
Switching Between Active Emulation Sessions

IftheTEClientisengagedinmorethanoneemulationsession,usetheOptionsmenu toswitchbetweenthesessions.
To switch between emulation sessions: 1 IntheTEClient,accesstheOptionsmenu.
120
2 IntheOptionsmenu,selecttheactivesessionthatyouwanttoview.
Figure 9-9. SwitchingtoaDifferentEmulationSession
TheTEClientswitchestheviewtotheemulationsessionthatyouselected.
NOTE YoucanalsousetheNextSessorPrevSesskeysinthevirtualemulation keyboardtoswitchbetweensessions.Forinformationaboutaccessingthevirtual emulationkeyboard,seeUsingtheVirtualEmulationKeyboardonpage 120.
Using the Virtual Emulation Keyboard

TheTEClienthasadefaultvirtualemulationkeyboardoryoucanconfigureyour ownvirtualkeyboards.YoucanaccessthekeyboardthroughtheTEClientOptions menu. Thetypeofemulationkeyboardthatdisplaysisdependentontheemulationtypeof thecurrentemulationsession.Thefollowingsectionsprovideinformationonthe buttonsforthevirtualkeyboards:
UsingtheDefaultVirtualEmulationKeyboard Usingthe5250/3270VirtualEmulationKeyboard
121
UsingtheVT/HPVirtualEmulationKeyboard UsingtheWEBVirtualEmulationKeyboard
Ifthereisnoactivesession,thenthedefaultvirtualemulationkeyboardappears.
To access the virtual emulation keyboard: 1 AccesstheTEClientOptionsmenu. 2 SelectView>EmulationKeyboard.
Figure 9-10. AccessingtheVirtualEmulationKeyboard
Thevirtualemulationkeyboardappears.
Using the Default Virtual Emulation Keyboard

ThefollowingfigureshowsthedefaultTEClientvirtualemulationkeyboard.
Figure 9-11. TEClientVirtualEmulationKeyboard
122
Thefollowinglistdescribesthefunctionsofthekeysinthedefaultvirtualemulation keyboard:
TermConfig Prog Info
Allowsyoutoaccessandconfiguretheemulation parametersforaspecifichostprofile. Shows/hidesthefollowinginformationaboutthemobile device:
TEClientversioninformation MACaddress IPaddress ESSID

Next Session Host Config Prev Session Keyclks Quiet Diags Enter Close
CyclestothenextTEClientsession. Allowsyoutoaccessandconfigurethehostprofilesforthe TEClient. Cyclestothepreviousemulationsession. Turnskeyclickson/off. Turnsquietmodeon/off. AllowsyoutoaccesstheTEClientdiagnostictools. Connectsthesession. Disconnectsthesession.(Onlyavailablewhenthesessionis connected.)
Using the 5250/3270 Virtual Emulation Keyboard

ThefollowingfigureshowstheTEClientvirtualemulationkeyboardfor5250/3270 emulation.
123
Figure 9-12. TEClient5250/3270VirtualEmulationKeyboard
Thefollowinglistdescribesthefunctionofthecontrolkeysthatappearatthebottom ofthevirtualemulationkeyboard:
Alpha
Displaysthealphakeysfor5250/3270emulation,including:
az Tab,CapsLock,Shft,Res,Backspace,FieldExit,Enter,
Space,Alt
Num
Displaysthenumerickeysfor5250/3270emulation, including:
010 Mathematicalsymbols Reset,Backspace,FieldExit,Enter,ArrowKeys Tab,Shft,Space

Func1
Displaysthefunctionkeysfor5250/3270emulation, including:
F1F24 RollUp,RollDown,Enter
124
Func2
Displaysotherfunctionkeysfor5250/3270emulation, including:
Dup,Print,Clear Attn,Help,Home Insert,RollUp,RollDown Delete,SysRq,ErInp,Reset

Punc
Displayspunctuationcharactersfor5250/3270emulation, including:
Variouspunctuationandmathematicalsymbols Reset,FieldExit,Enter
Alt
Displaysthedefaultvirtualemulationkeyboard.For informationaboutthekeysinthedefaultvirtualemulation keyboard,seeUsingtheDefaultVirtualEmulationKeyboardon page 121. Hidesthevirtualkeyboard.
Off
Using the VT/HP Virtual Emulation Keyboard

ThefollowingfigureshowstheTEClientvirtualemulationkeyboardforVT/HP emulation.
Figure 9-13. TEClientVT/HPVirtualEmulationKeyboard
125
Thefollowinglistprovidesinformationaboutthevariouscontrolkeysthatappearat thebottomoftheVT/HPvirtualemulationkeyboard.
Alpha
DisplaysthealphakeysforVT/HPemulation,including:
az Esc,Capslock,Tab,Space,Enter,Backspace Shft,Ctl,Alt
Num
DisplaythenumerickeyboardforVT/HPemulation,which containsthefollowingkeys:
09 Esc,Tab,Ins,Rem,Backspace,Enter,Space Shft
Func
DisplaysthefunctionkeysforVT/HPemulation,including:
F1F10 Esc,Tab,Prev,Next,Find,Sel,Space,Backspace,Enter Shft,Ctrl,Alt

Punc
DisplaythepunctuationkeysforVT/HPemulation, including:
PunctuationKeys Backspace,enter,Space
Cfg
Displaythedefaultvirtualemulationkeyboard.For informationaboutthekeysinthebasicemulationkeyboard, seeUsingtheDefaultVirtualEmulationKeyboardonpage 121. Hidesthevirtualkeyboard. Movesthecursorinthedirectionofthearrowkeythatyou press.
Off Arrow Keys
126
Using the WEB Virtual Emulation Keyboard

ThefollowingfigureshowstheTEClientvirtualemulationkeyboardforWEB emulation.
Figure 9-14. TEClientWEBVirtualEmulationKeyboard
ThefollowinglistdescribesthefunctionofthekeysintheWEBvirtualemulation keyboard.
Back Fwd Stop Refresh Home Prev Sess Next Sess Close Key Clicks Quiet Info
Returnsthebrowsertothepreviouswebpage. ReturnstothescreendisplayedbeforeBackwasselected. Stopsthewebpagefromloading. Reloadsthecurrentwebpage. Returnsthebrowsertothespecifiedhomepage. Cyclestothepreviousemulationsession. Cyclestothenextemulationsession. Disconnectsthesession.(Onlyavailablewhenthesessionis connected.) Turnskeyclickson/off Turnsquietmodeon/off. Shows/hidesthefollowinginformationaboutthemobile device:TEClientversioninformation,MACaddress,IP address,ESSID. AllowsyoutoaccesstheTEClientdiagnostictools.
Diags
127
Alpha
DisplaysthealphakeysforWEBemulation,including:
az Shift,Ctl,Alt Esc,Tab,Caps,Enter,Space
Num
DisplaysthenumerickeyboardforWEBemulation, including:
09 Shft Esc,Tab,Ins,Enter,Space
Func
DisplaysthefunctionkeysforWEBemulation,including:
F1F24
Punc
DisplaysthepunctuationkeysforWEBemulation, including:
Punctuationkeys Enter,Space
Cfg Off Arrow Keys
Displaythevirtualemulationkeyboard. Hidesthevirtualkeyboard. Movesthewebpageupanddownorfromsidetoside.
Using Screen Panning

Bydefault,thescreenpanningfeatureoftheTEClientisenabled. ThescreenpanningfeatureoftheTEClientallowsausertotapanddragthestylusto movearoundtheemulationscreen. Screenpanninghastwomodesofoperation:
128
Standard.Bydefault,standardscreenpanningisenabledontheTEClient.When
standardscreenpanningisenabled,thescreenscrollsinthedirectionthattheuser dragsthestylusacrossthescreen.Standardscreenpanningsimulatestheeffectof draggingthedisplayofthemobiledeviceovertheemulationscreen.
Reversed.Whenreversedscreenpanningisenabled,thescreenscrollsinthe
oppositedirectionthattheuserdragsthestylus.Reversescreenpanningsimulates theeffectofdraggingtheemulationscreenbeneathafixedviewport(thatis, mobiledevicedisplay).
NOTE Forinformationaboutconfiguringscreenpanning,seeConfiguringScreen
Panningonpage 169.
Using ActiveText
Bydefault,theActiveTextfeatureoftheTEClientisenabled. ActiveTextallowstheTEClienttoidentifymenuitemsandfunctionsinanemulation screenandconvertthemtointeractiveobjectsthatausercandoubleclicktoexecute. WhenastringoftextisturnedintoActiveText,ausercanperformthefollowing actionsontheActiveTextobject:
Singleclick.Asingleclickhighlightsthestringoftextandindicatesthatithas
becomeanActiveTextobject.
Doubleclick.Adoubleclickexecutesthemenuitemorthefunctionthathasbeen
convertedtoanActiveTextobject. YoucanconfiguretheTelnetClienttorecognizetwotypesoftextstringsthatwillbe convertedtoActiveTextobjects:
SimpleNumberMenuItem AS/400StyleFunctionKey
NOTE ForinformationaboutconfiguringActiveText,seeConfiguringActiveTexton
page 170.
129
Simple Number Menu Item

TheTelnetClientcanrecognizenumberedoptionsinamenuandconvertthemtoan ActiveTextobject. TheTelnetClientrecognizesastringofcharactersinthefollowingformatasasimple numbermenuitem:
Abeginningoflineoraspace Anumber(astringofdigits) Aperiod(.) Aspace Anonspacecharacter

Forexample,theTelnetClientwouldconvertthemenuitem90.SignOffinan emulationtoActiveText.TheusercouldthendoubleclicktheActiveTexttoinvoke the90.SignOffmenuoption.
AS/400-Style Function Key

TheTelnetClientcanrecognizeAS/400stylefunctionkeycommandsinanemulation screen. TheTelnetClientrecognizesthefollowingstringofcharactersasanAS/400/style functionkey:
Abeginningoflineoraspace Thecharacter F Anumber(stringofdigits) Anequaltocharacter(=) Anonspacecharacter

Forexample,theTelnetClientwouldconvertthefunctionkeycommand F3=Exit toActiveText.TheusercouldthendoubleclicktheActiveTexttoinvokethe F3=Exit command.
130
Using the TE Client Diagnostics Utility

TheTEClientdiagnosticsutilityallowsyoutofindscancodesforspecificcharacter sequencesandverifyscandata:
PerformingaKeyboardTest UsingtheTEClientOptionsMenu PerformingaScanTest

ThediagnosticsutilityisaccessedthroughtheTEClientvirtualkeyboard.
To access the diagnostics utility: 1 IntheTEClient,accessthevirtualemulationkeyboard. 2 Inthevirtualkeyboard,clickDiags. NOTE Diagsappearsinthedefaultvirtualemulationkeyboard.ForVT/HPemulation, DiagsappearsintheCfgdisplayofthevirtualkeyboard.For5250/3270emulation, DiagsappearsintheAltdisplayofthevirtualkeyboard.
TheProgramDiagnosticsscreenappearsintheTEClient.
Figure 9-15. TEClientDiagnosticsUtility
131
3 SelectoneoftheoptionsintheProgramDiagnosticsscreen:
Press K toperformakeyboardtest,whichallowsyoutoobtainscancodesfor
theexternalkeyboardandtheTEClientvirtualkeyboard.
Press S toperformascantest,whichallowsyoutodeterminethetypeof
barcodeforascan.
Press W toperformaWindowskeyboardtest,whichallowsyoutoobtainscan
codesfortheWindowsvirtualkeyboard.
Press Q toquitthediagnosticsutility. Performing a Keyboard Test

UsetheTEClienttoobtainscancodesfortheexternalkeyboardandtheTEClient virtualkeyboard.
To perform a keyboard test: 1 EnsurethatyouhaveanactiveVT/HPor5250/3270emulationsession. NOTE AnactivesessionisrequiredtotesttheTEClientvirtualkeyboard.Thevirtual
keyboarddisplayskeysbasedonthecurrentemulationsessiontype.
2 UsetheTEClientvirtualkeyboardtoaccesstheProgramDiagnosticsscreen. 3 Press K tobeginakeyboardtest.
TheKeyboardTestscreenappears.
4 Usetheexternalkeyboardorthevirtualkeyboardtosubmitacharactersequence
totheTEClient. TheTEClientdisplaysthescancodeforthecharactersequence.
132
Figure 9-16. PerformingaKeyboardTest
5 Whenyouarefinished,press Q toreturntothediagnosticsutility.
Performing a Windows Keyboard Test

UsetheTEClientdiagnosticsutilitytoobtainscancodesfortheWindowsvirtual keyboard.
To use the diagnostics utility to obtain Windows scan codes: 1 IntheTEClient,accessthediagnosticsutility.
TheProgramDiagnosticsscreenappears.
2 Press W tobeginaWindowskeyboardtest.
TheWindowsKeyboardTestscreenappears.
3 AccesstheWindowsvirtualkeyboard. 4 PressacharactersequenceintheWindowsvirtualkeyboard.
Thediagnosticsutilitydisplaysthescancodeforthecharactersequence.
133
Figure 9-17. PerformingaWindowsKeyboardTest
Performing a Scan Test

UsetheTEClientdiagnosticsutilitytoperformascantest.Ascantestallowsyouto verifythetypeandvalueofscanneddata.Thescantestutilitydoesnotprocessany scanhandlers,scanidentifiers,orpreorpostamblestrings.However,scan identifiersthatyouhaveconfiguredareaddedtothescan.
To use the diagnostics utility to perform a scan test: 1 IntheTEClient,accessthediagnosticsutility.
TheProgramDiagnosticsscreenappears.
2 Press S tobeginascan/MSRtest.
TheScan/MSRTestscreenappears.
3 Usethescanneronthemobiledevicetoperformatestscan.
TheScan/MSRTestscreendisplaystheresultsofthescan.
134
Figure 9-18. PerformingaScanTest
Using the TE Client Options Menu

ThissectionprovidesadescriptionofeachoptionintheTEClientOptionsmenu.The availabilityofsomeoptionsdependsonthecurrentsession.
Connect Session [n] Disconnect Session [n] Session [n] [name]|unconnected
Usesthecurrentsession[n]toinitiateaemulation connectionwithahost. Disconnectsthecurrentsession[n]. Switchesbetweensessions,where:
[n] indicatesthesessionnumber. [name] indicatesthenameofthehost. unconnected indicatesthatthesessionisnot

currentlyinuse.
Web > Back Web > Forward
Returnstothepreviouswebpage. GoestothescreenbeforeBackwasused.
135
Web > Stop Web > Refresh Web > Home Web > Text Size Scripting > Execute Script
Stopsthewebpagefromloading. Reloadsthecurrentwebpage. Returnsthebrowsertothespecifiedhomepage. Changesthetextsize.Theavailableoptionsare:Largest, Larger,Medium,Smaller,Smallest. Activatesascript.
Scripting > Cancel Script Stopsascriptthatisrunning. Scripting > Start Capture Beginscapturingkeypressesandmouse/cursormovements
forscriptgeneration.
Scripting > Stop Capture Endsscriptcapturing. Scripting > Verify Screen Pausesthescriptandwaitforascreenupdate. Contents Scripting > Save Cursor Position
Pausesthescriptandwaitforthespecifiedcursorposition.
Scripting > Set Field Data SetsthefielddataID. ID Configure > Host Profiles ConfigureshostprofilesfortheTEClient. Configure > Emulation Configure > Scripting Configure > Authorization
ConfiguresemulationparametersfortheTEClient. EditsscriptsfortheTEClient. ConfigureslicensingfortheTEClient.
Configure > Localization ConfigureslocalizationfortheTEClient. Configure > Resources View > Emulation Keyboard View > Numeric Keyboard View > Current Config
AccessestheResourceEditor. Shows/hidesthevirtualemulationkeyboard. Shows/hidesthenumerickeyboard. Showsthedisplaysettingsfortheemulationsession.
136
Logging > Screen Capture About Exit
Togglesscreencapturingonandoff. ProvidesinformationabouttheTEClient. ExitsandclosestheTEClient.Dependingonthe configurationoftheTEClient,youmayneedtosupplyan exitpassword.
Launching the TE Client Using Command Line Arguments

TheTEClientsupportstwocommandlinearguments:onethatlaunchestheClient, andonethatcreatesahostprofiletoconnecttoaspecificURL.
Launching the TE Client via Command Prompt

YoucanusethecommandprompttolaunchtheTEClient.
To launch the TE Client from a command prompt: 1 Openacommandprompt. 2 Type TelnetCE /profile followedbythenameofthehostprofiletowhich
youwanttoconnect.
3 Press Enter.
Theemulationsessionislaunchedandconnectedtothespecifiedhostprofile.
Creating a Command Line URL Host Profile

Youcanusethecommandprompttocreateanewhostprofilethatconnectstoa specifiedURL.
To create a command line URL host profile: 1 Openacommandprompt. 2 Type /url followedbytheURLtowhichyouwanttoconnect. 3 Press Enter.
Anewemulationsessionislaunched,andanewhostprofileiscreated.
Chapter 10: Industrial Browser (WEB Emulation)
137

ThissectionprovidesinformationaboutusingtheTerminalEmulation(TE)Industrial Browser.TheIndustrialBrowserallowsyoutoaccesswebbasedapplicationsfroma mobiledevice.TheIndustrialBrowserisincludedintheTEClient6.0andnewer.It functionsonthefollowingplatforms:PocketPC2003,WindowsMobile5.0,Windows 2000/XP,andWindowsCE.NET4.2/5.0. TheIndustrialBrowsersupportsalistofMETAtagsandIDAcommandsthatallow youtodevelopcustomwebpagesthatenablespecificfunctionalityintheIndustrial Browser.ForinformationondevelopingwebpagesfortheIndustrialBrowser,seethe IndustrialBrowserReferenceGuide. InordertouseWEBEmulation,youmustconfigureahostprofilewiththeaddressof thewebpage(s)youwanttheIndustrialBrowsertoaccess.Forinformationon configuringhostprofilesettingsforWEBemulation,seeHostProfileConfiguration Optionsonpage 22. ThissectionprovidesinformationaboutusingtheTEIndustrialBrowser,including thefollowing:
BasicNavigation SpecifyingtheHomePage
Basic Navigation
TheTEIndustrialBrowserinterfaceprovidesbasiccommandsfornavigatingweb pages.
To navigate within the Industrial Browser: 1 CreateaWEBemulationsession. 2 Tapandholdonthescreen.
Acontextmenuappears.
3 Fromthismenu,youcanselectfromthefollowingoptions: Back Forward
Gobackonepage. Goforwardonepage.
138
Stop Refresh Home Text Size
Stopsthewebpagefromloading. Reloadsthecurrentwebpage. Returnsthebrowsertothespecifiedhomepage. Displaysamenuwiththefollowingtextsizeoptions:Largest,Larger, Medium,Smaller,Smallest
Specifying the Home Page

ThehomepageisthefirstpageuserswillseewhenusingtheIndustrialBrowser;itis alsothepageuserswillbereturnedtowhentheyselectHome.Thehomepagewillbe thelocationyousetupinthehostprofileforWEBemulation.ThiscaneitherbeanIP addressoraspecificwebaddress.RefertoHostProfileConfigurationOptionson page 22formoreinformation.
Chapter 11: Avalanche Integration
139

AdditionalfeaturesareavailablefortheTEClientwhenyouchoosetoinstalltheTE ClientusingAvalanche.AvalancheinstalledTEClientsofferthefollowingfeatures:
SessionMonitor.AllowsyoutomonitorandtotakecontroloftheTEClient
remotelyfromtheAvalancheConsole.
RealTimeStatistics.Allowsyoutoviewrealtimestatistics,includingsession
lengthandnumberofscans,fromtheAvalancheConsole. TotakeadvantageoftheAvalanchefeaturesoftheTEClient,yourAvalanche environmentmustmeetthefollowingrequirements:
AvalancheManager(3.4ornewerforrealtimestatistics,3.5ornewerforSession
Monitor),AvalancheMC,orAvalancheSE
AvalancheEnabler3.x(ornewer),installedandlicensedonthedevice TEClient5.x(ornewer),installedandlicensedonthedevice
Session Monitor
TheSessionMonitorutilityallowsyoutoviewtheTEClientsessionfromthe AvalancheConsole.SessionMonitorincludesanoverridefeaturethatallowsthe AvalancheusertotakecontroloftheTEClient.SessionMonitoralsoincludesa loggingfeaturethatallowsyoutocreateatraceforemulationsessions. Thissectionsprovidesthefollowinginformation:
ConfiguringSessionMonitor LaunchingSessionMonitor SessionOverride TracingSessions Configuring Session Monitor

AfteryouhaveaddedtheTEClientsoftwarepackagetoanAvalanchesoftware profile,configurethefollowingSessionMonitorparameters:
140
SessionMonitorAddress.ThesearetheIPaddressesofcomputersthattheTE
Clientallowstodosessionmonitoring.Ifnoaddressesarespecified,theTEClient allowssessionmonitoringfromanycomputer.
SessionMonitorOverrideTimeout.Thisisthemaximumnumberofminutesthat
SessionMonitorisallowedtooverridethesession.Afterthetimeexpires,the overridesettingisdisabledandcontrolreturnstotheClientdevice.Thedefault timeoutforoverridemodeissetto0(never).Thismeanstheoverridemodewill nevertimeoutandtheClientregainscontrolonlyifoverridemodeisdisabled manually.
SessionMonitorPassword.ThisisthepasswordrequiredforSessionMonitor
connections.Thepasswordisloadedintheemulationparametersfileandisnever enteredbytheuser.Ithasa63characterlimit.Ifnopasswordisentered,theTE ClientwillnotacceptSessionMonitorconnections.
SessionMonitorPort.ThisistheportthattheTEClientlistensonforSession
Monitorconnections.
To configure Session Monitor: 1 LaunchtheAvalancheConsole. 2 IntheProfilestab,selectthesoftwareprofilethatcontainstheTEClientpackage. 3 IntheSoftwarePackageslist,selecttheTEClientsoftwarepackageandclick
4 SelectEmulationParametersandclickLaunch.
TheConfigurationManagerlaunches.
5 NavigatetoEmulation>SessionMonitor. 6 DoubleclicktheSessionMonitoroptionstochangetheparameters. NOTE TheSessionMonitorPasswordistheonlyrequiredconfiguration.Theother
parametersareoptionalconfigurations.
7 OnceyouhaveconfiguredtheSessionMonitorparameters,saveyourchanges.
141
8 Closetheconfigurationutility. 9 PerformanAvalancheupdatetodownloadthenewconfigurationtothemobile
device.
Launching Session Monitor

YoucanlaunchSessionMonitorfromtheAvalancheConsole.
To launch Session Monitor 1 LaunchtheAvalancheConsole. 2 FromtheMobileDeviceInventory,rightclickthedeviceyouwanttomonitor. 3 Fromthecontextmenuthatappears,selectSessionMonitor.
TheSessionMonitorscreenopensandconnectstothesession.Theyellowlined boxrepresentswhatthedeviceusercansee.
NOTE YoumusthaveaSessionMonitorpasswordconfiguredintheemulation
parameters,ortheSessionMonitoroptionwillnotbeavailable.
Figure 11-1. ConnectingtoSessionMonitor
142
NOTE IfboththemobiledeviceandtheAvalanchePChaveSSLsupportinstalled,the
SessionMonitortrafficwillbeencrypted.
Session Override
Whenyouusesessionoverride,onlytheuserattheAvalancheConsolewillbeableto controltheTEClient.
To enable override mode
InSessionMonitor,clickMonitor>SessionOverride.
Figure 11-2. EnablingSessionOverride
Thesessionremainsinoverridemodeuntiltheoverridetimeoutminutesexpireor untiltheSessionMonitoruserdisablesthesessionoverrideoption.
Tracing Sessions
UsetheLogFileSettingsdialogboxtoconfiguretheSessionMonitorlogfiletotrace SessionMonitorsessions.AtracewilltrackallthenetworktrafficbetweentheClient andthehost.
To trace a session: 1 InSessionMonitor,clickFile>LogToFile. 2 Configurethelogfilesettings. 3 IntheLogFilePathtextbox,enterthepathtothedirectorywhereyouwantto
savethelogfile.
4 ClickOK.
143
Figure 11-3. ConfiguringLogFileSettings
Thelogfileissavedas sessionlog.txt inthedirectoryspecifiedinLogFile Pathtextbox.If sessionlog.txt alreadyexists,thelogfilewillattempttosave as sessionlog2.txt, sessionlog3.txt,etc.untilitfindsanonexistingfile nameinthespecifiedlogfilepath.
Real-Time Statistics
TheTEClientperiodicallytransmitsemulationspecificinformationtoAvalanche Console.TheAvalancheConsoledisplaystheinformationitreceivesintheProperties taboftheMobileDeviceDetailsdialogboxforthemobiledevice. TheAvalancheConsoledisplaysemulationsessioninformationincludingthecurrent TE Clientversion,themobiledevicebatterypower,SSLsupportanduse,session connecttime,andrunningtimeofthecurrentsession.
NOTE TouserealtimestatisticswiththeTEClient,youmusthaveAvalanche
configuredtoallowcollectionofstatistics.ThismayincludeoptionsontheEnabler andoptionssetattheAvalancheConsoleforthemobiledeviceserver. Bydefault,theTE ClienttransmitsstatisticalinformationtotheAvalancheserver everyfiveminutes(300seconds).YoucanmodifythisRealTimeStatsIntervalproperty inthePropertiestaboftheMobileDeviceDetailsdialogbox. Thissectionprovidesthefollowinginformation:
ViewingRealTimeStatistics
144
ModifyingRealTimeStatistics Viewing Real-Time Statistics

YoucanviewtherealtimestatisticsfromthePropertiestaboftheMobileDevice Detailsdialogbox.
To view the statistics: 1 LaunchtheAvalancheConsole. 2 FromtheMobileDeviceInventory,rightclickthedevice. 3 Fromthecontextmenu,selectMobileDeviceDetails.
TheMobileDeviceDetailsdialogboxopens.
4 ClickthePropertiestab.
ThePropertiestabcontainsanumberofentriesspecifictotheTE Client. ThefollowinglistdescribestheTE ClientstatisticsthataredisplayedintheProperties tab.

General > RealTimeStatsInterval
IndicateshowoftentheAvalancheEnablersendsrealtime statisticsinformationtotheserver.Theintervalismeasured inseconds. Default:300seconds
Telnet > Average Time Total Telnet > Average Time Display
Indicatesthelengthoftimethesessionstatisticsaretracked. Default:600seconds Indicatestheintervaltimeforbarcode,MSR,andRFIDscans andtransactions.Thedefaultsetting(60seconds)meansthat scansdisplayasanumberofscansperminute.Ifyouchange thistopropertyto120seconds,thescansdisplayasnumber ofscanspertwominutes. Default:60seconds
(Realtime) > Time Running
DisplaysthecurrentrunningtimefortheTEClient.
145
(Realtime) > Version (Realtime) > SSL Supported (Realtime) > SSH Supported (Realtime) > Battery Power
DisplaysthecurrentversionoftheTEClient. IndicateswhetherSSLissupported. IndicateswhetherSSHissupported. Indicatestheremainingbatterypowerofthemobiledevice.
(Realtime) > Session <n> Displaystheamountoftimethesessionhasbeenrunning, Connect Time where<n>indicatesthesession(14). (Realtime) > Session <n> IndicateswhetherthesessionisusingSSL,where<n> SSL in Use indicatesthesession(14). (Realtime) > Session <n> Displaysthenumberofbarcodescansper<x>secondsforthe Barcode Scans session,where<n>indicatesthesession(14)and<x>
indicatesthetimesetintheTelnetAverageTimeDisplay property.
(Realtime) > Session <n> DisplaysthenumberofMSRscansper<x>secondsforthe MSR Scans session,where<n>indicatesthesession(14)and<x>
indicatesthetimesetintheTelnetAverageTimeDisplay property. MSRscaninformationdisplaysonlyifthemobiledevice supportsMSRscanning.

(Realtime) > Session <n> Displaysthenumberoftransactionsper<x>secondsforthe Transaction session,where<n>indicatesthesession(14)and<x>
indicatesthetimesetintheTelnetAverageTimeDisplay property.
(Realtime) > Session <n> DisplaysthenumberofRFIDscansper<x>secondsforthe RFID session,where<n>indicatesthesession(14)and<x>
indicatesthetimesetintheTelnetAverageTimeDisplay property. RFIDscaninformationdisplaysonlyifthemobiledevice supportsRFIDscanning.
146
Modifying Real-Time Statistics

Whilemanyoftheemulationsessionparametersindicatetheyarechangeable,you shouldonlymodifyRealTimeStatsInterval,TelnetAverageTimeTotal,andTelnet AverageTimeDisplay.
To modify a statistic: 1 LaunchtheAvalancheConsole. 2 Fromthelistofmobiledevices,rightclickthedeviceyouwanttomonitor. 3 SelectMobileDeviceDetails.
TheMobileDeviceDetailsdialogboxopens.
4 ClickthePropertiestab. 5 SelectthepropertyyouwanttochangeandclickEditProperty. 6 Typethenewvalueforthepropertyinthedialogboxthatappears. 7 ClickOK. 8 Updatethedevicetosendthenewpropertyvaluestothedevice. NOTE IftheTEClientiscurrentlyrunning,modifiedrealtimestatisticswillnot displayuntilthenextrealtimestatisticstransmissiontoAvalanche.Forexample,if youmodifythe RealTimeStatsInterval propertyfrom300secondsto5 seconds,itmaywaittheremainingsecondsofthe300secondintervalbeforethe statisticsbegintoupdateeveryfiveseconds.
Chapter 12: Configuring the TE Client from the Mobile Device
147

Generally,theTEClientisconfiguredusingtheconfigurationutilityassociatedwith yourinstallationmethod.However,youcanaccesscertainTEClientparametersfrom theClient,including:
ConfiguringHostProfilesfromtheClient EditingPerHostEmulationParametersfromtheClient
IfyoumakechangesintheTEClientconfigurationfromthedevice,thosechanges willbeoverwrittenwhenyoudownloadanewTE Clientconfigurationtothemobile deviceusingMicrosoftActiveSyncorAvalanche.
Configuring Host Profiles from the Client

YoucanperformthefollowingconfigurationtasksusingtheTEClientinterface:
AccessingHostProfilesfromtheClient CreatingaNewHostProfilefromtheClient ModifyinganExistingHostProfile DeletinganExistingHostProfile Accessing Host Profiles from the Client
Toadd,modify,ordeletehostprofile,youmustaccesstheHostProfilesdialogbox.
To access the host profiles dialog box from the Client: 1 Onthemobiledevice,launchtheTEClient. 2 TapOptions>Configure>HostProfiles.
3 IntheInputHostConfigPasswordtextbox,typethepasswordandclickOK.
148
NOTE Thedefaultpasswordis system.Forinformationaboutmodifyingthis password,seeConfiguringPasswordsonpage 162.Ifnopasswordisconfigured,theTE Clientwillnotpromptyouforapassword.
TheEditHostProfiledialogboxappears.
4 UsetheEditHostProfiledialogboxtoadd,modify,ordeletehostprofiles.
Creating a New Host Profile from the Client

YoucanusetheEditHostProfiledialogboxtocreateanewhostprofileforthe TE Client.
To create a new host profile from the Client: 1 Onthemobiledevice,launchtheTEClient. 2 TapOptions>Configure>HostProfilestoaccesstheEditHostProfilesdialogbox. 3 IntheEditHostProfiledialogbox,clickAdd.
AnewEditHostProfiledialogboxappears.
4 UsetheEditHostProfiledialogboxtoconfigurethebasicparametersofthehost
profile(alias,emulationtype,etc.).
5 TapConfigtoaccessandconfigureotherparametersthatarespecifictothe
emulationtype.
NOTE Forinformationabouthostprofileparameters,seeHostProfileConfiguration
Optionsonpage 22.
6 Afteryouhavefinishedconfiguringthehostprofile,tapSaveintheEditHost
Profiledialogbox. TheEditHostProfilesdialogboxappears,andyouarereturnedtothefirstEditHost Profiledialogbox,whichnowdisplaysthenewhostprofile.

7 TapDone.
TheEditHostProfiledialogboxcloses.
149
Modifying an Existing Host Profile

YoucanusetheEditHostProfiledialogboxtomodifytheparametersofanexisting hostprofilefromthemobiledevice.
To modify an existing host profile: 1 FromtheTEClient,tapOptions>Configure>HostProfilestoaccesstheEdit
HostProfilesdialogbox.
2 InthelistofprofilesintheEditHostProfiledialogbox,selectthehostprofiledialog
boxthatyouwanttomodify.
3 TapEdit. 4 UsetheEditHostProfiledialogboxtomodifythebasicparametersofthehost
profile(alias,emulationtype,etc.).
5 TapConfigtoaccessandconfigureotheremulationtypespecificparametersfor
thehostprofiles.
NOTE FormoreinformationabouttheparametersintheEditHostProfiledialogbox andtheparametersintheotheremulationtypespecificdialogboxes,seeHostProfile ConfigurationOptionsonpage 22. 6 Afteryouhavemodifiedtheparametersforthehostprofile,tapSave.
Thechangesthatyouhavemadeareappliedtothehostprofile.TheEditHost ProfiledialogboxclosesandyoureturntothefirstEditHostProfiledialogbox.
7 TapDone.
TheEditHostProfiledialogboxcloses.
NOTE ToexiteitheroftheEditHostProfiledialogboxeswithoutsavingthechanges
thatyouhavemade,press Esc.
Deleting an Existing Host Profile

YoucanusetheEditHostProfiledialogboxtodeleteanexistingprofileonthemobile device.
150
To delete an existing host profile: 1 FromtheTEClient,tapOptions>Configure>HostProfilestoaccesstheEdit
HostProfilesdialogbox.
2 FromthelistofhostprofilesintheEditHostProfiledialogbox,selectthehost
profilethatyouwanttodelete.
3 TapDelete.
ThehostprofileisdeletedfromthelistofhostprofilesintheEditHostProfiles dialogbox.
4 TapDone.
TheEditHostProfiledialogboxclosesandyoureturntotheprimaryTEClient interface.
NOTE ToexittheEditHostProfiledialogboxwithoutsavingthechangesthatyouhave
made,press Esc.
Editing Per-Host Emulation Parameters from the Client

Youcanmodifycertainperhostemulationparametersfromthemobiledeviceafter theClienthasbeeninstalled.Parametersavailableforeditingwillvarydependingon thetypeofemulation,butmayincludethefollowingtabs:
VTXXSettings IBMHostSettings WEBSettings MessageSettings FontSettings DisplaySettings ViewSettings CursorSettings
151
BeepsSettings TelnetSettings PrinterSettings

To access the emulation parameters for a host profile on the device: 1 FromtheTEClient,clickOptions>Configure>Emulation.
2 IntheInputTerminalConfigPasswordtextbox,typethetermconfigpassword
andtapOK.
NOTE ThedefaultTermConfigpasswordisconfig.Forinformationabout modifyingtheTermConfigpassword,seeConfiguringPasswordsonpage 162.Ifno passwordisconfigured,theTEClientwillnotpromptyouforapassword.
3 IntheSelectHostdialogbox,selectthehostprofilethatcontainstheemulation
parametersthatyouwanttomodifyandtapOK.
4 Modifytheemulationparametersforthehostprofile. 5 Afteryouhaveconfiguredtheemulationparametersforthehostprofile,selectthe
OKbuttonintheupperrightcorneroftheSettingsdialogbox. TheSettingsdialogboxcloses.
VTXX Settings
UsetheVTXXtabintheSettingsdialogboxtoconfigureparametersforVTtype emulation. ThefollowinglistdescribestheparametersintheVTXXtab.
Local Echo
IndicateswhethertheTEClientechoescharactersthatit receivedfromaVThost.
152
Send 8-Bit Control Codes Indicateswhethertouse8bitANSIcontrolcodesfor
VTtypeemulation.
Backspace Sends Delete IndicateswhethertheTEClientshouldsendadeletecontrol
characterwhenauserpressesthebackspacekey.
IBM Host Settings

UsetheIBMHosttabintheSettingsdialogboxtoconfigureparametersforIBMtype emulation. ThefollowingtabledescribestheconfigurableoptionsintheIBMHosttab.
5250 - Column Separator IndicateswhethertheTEClientdisplaysaperiodorvertical Dot linebetweeneachcharacterwhenthehostsystemusesa
specialcolumnformatmode.
5250 Swap Enter Key / Field Exit
Indicateswhethertheenterkeyismappedtothefieldexit keyandtheclearkeyismappedtotheenterkey.
3270 - Alternate System IndicateswhethertheTEClientencodes3270system Request requestsasrequestsinsteadofdefaultinterruptprocesses.
WEB Settings
UsetheWEBtabintheSettingsdialogboxtoconfigureparametersforWEB emulation. ThefollowingtabledescribestheconfigurableoptionsintheWEBtab.
WEB Allow Compression Determineswhetherthebrowserwillautomatically
decompressanycompressedinformationitreceives.
WEB Allow Cookies WEB Automatic SIP WEB Default Scanner Auto Keys
Indicateswhetherthewebserverisabletoaccesscookieson theclient. DetermineswhethertheSIPkeyboardisautomatically displayedwhenthecursorismovedtoaneditfield. Determinesthedefaultpostscanactionforwebpages withoutTaborEnterkeyMETAtags. PossibleValues:<NoKeys><Enter><Tab><EnterandTab>
153
WEB Default Text Size
Indicateswhetherthedefaulttextsizeshouldbeusedwhen thebrowserfirstappears. PossibleValues:<Smallest><Smaller><Medium><Larger> <Largest><NoChange>
WEB Detect Out-OfRange
IndicateswhethertheTEClientwillpreventtheuserfrom interactingwithawebpageifthewirelessLANadapteris notassociatedwithanaccesspoint. Determinesifembeddedimagesand/orplaceholdersshould bedisplayedonwebpages. Indicatesthetypeofwebenginethatshouldbeused.The Enhancedengineisrequiredtosupportseveraladvanced features. PossibleValues:<Standard><Enhanced>
WEB Display Images WEB Engine Type
WEB Error 404 Override Determineswhetheracustomorstandard404errormessage
isdisplayed.
WEB Error Messages
Determineswhetherservererrormessagesrelayedfromthe serveraredisplayed.
Message Settings
UsetheMessagetaboftheSettingsdialogboxtoconfigurethesettingsformessages thatthemobiledevicereceivesfromthehostsystem.Certainparametersinthe Messagetabareapplicableonlyto5250and3270typeemulation.
154
ThefollowinglistdescribestheconfigurableoptionsintheMessagetab.
Message Line (5250/3270 Only)
SpecifiesthelinefromthehostscreenthattheTEClient readstodisplayasthemessageline.TheClientdisplaysthe messagelineeachtimeitscontentschange.Whenthe contentsofthemessagelinearenotvalid,thelineappearsin reversevideoatthetopofthedisplay. PossibleValues:024 Default:24

NOTE Useavalueof0topreventthedisplaymessage.
Auto Reset Delay (5250/3270 Only)
Indicatestheamountoftime(inseconds)theTEClientwaits beforesendingaresettothehostwhentheResetRequired parameterissettoNever. PossibleValues:05(seconds) Default:2
Message Beeps (5250/3270 Only)
Indicatesthenumberofadditionalbeepsthatoccuronthe mobiledevicewhentheTEClientreceivesasystemmessage. PossibleValues:0255 Default:0
155
Reset Required (5250/3270 Only)
Indicatesthesituationsthatrequiretheusertopressthereset key. Optionsinclude:
OnAllMessages.Requiresaresetonscreensthat
displayinformationonline24(thebottomdisplay line).
OnErrors.Requiresaresetonscreensthathavean
errorindicator.
Never.Requiresareset,buttheTEClient
automaticallyperformstheresetwhenitdetectsan errorindicator.
Use Enter As Reset
Indicateswhethertheenterkeyonthemobiledevice functionsastheresetkeywhenthemobiledeviceisinan errorstate.
Font Settings
UsetheFonttabintheSettingsdialogboxtoconfigurethewaythattextdisplaysfor thehostconnection. ThefollowinglistdescribestheconfigurableoptionsintheFonttab.
Name Size Weight Left (Clipping)
IndicatesthefontthattheTEClientusestodisplaytextinthe emulationscreen. Indicatesthesize(inpoints)inwhichtextdisplaysinthe emulationscreens. Indicatestheweightthatisappliedtotextintheemulation screens. Indicatestheamountofwhitespace(infontpoints)thatthe TEClientcropsfromtheleftofthecharacter. PossibleValues:0255
156
Right (Clipping)
Indicatestheamountofwhitespace(infontpoints)thatthe TEClientcropsfromtherightofthecharacter. PossibleValues:0255
Top (Clipping)
Indicatestheamountofwhitespace(infontpoints)thatthe TEClientcropsfromthetopofthecharacter. PossibleValues:0255
Bottom (Clipping)
Indicatestheamountofwhitespace(infontpoints)thatthe TEClientcropsfromthebottomofthecharacter. PossibleValues:0255
Display Settings
UsetheDisplaytabintheSettingsdialogboxtoconfigurehowtheTEClientdisplays. ThefollowinglistdescribestheconfigurableoptionsintheDisplaytab.
Force Black/White Menu Hide Menu (Button)
IndicateswhethertheTEClientdisplaysinblackandwhite. IndicateswhethertheTEClientdisplaystheTEClientmenu duringanactivesession. Clickthisbuttontoaccessadialogboxthatwillallowyouto configureakeysequencethatwillhide/revealtheTEClient menuduringanactivesession. Indicatesthekeysequencethatisconfiguredtohide/reveal theTEClientmenuduringanactivesession. IndicateswhethertheTEClientdisplaysthevertical scrollbarduringasession. IndicateswhethertheTEClientdisplaysthehorizontal scrollbarduringasession. configureakeysequencethathides/revealstheTEClient emulationkeyboard.
Hide Menu (Text Box) Vertical Scrollbar Horizontal Scrollbar
Hide Keyboard (Button) Clickthisbuttontoaccessadialogboxthatwillallowyouto
Hide Keyboard (Text Box)
Indicatesthekeysequencethatisconfiguredtohide/reveal theTEClientemulationkeyboard.
157
View Settings
UsetheViewtabintheSettingsdialogboxtoconfigurehowtheviewscreen functionsforthehostconnection. ThefollowinglistdescribestheconfigurableoptionsintheViewtab.
Free Cursor Scrolling (Full Screen Mode)
Indicateswhetherauserisallowedtomovethecursorinto protectedareasofthescreen. IndicateswhethertheTEClientusesfullscreenmode,which allowstheusertoscrollaroundthevirtualdisplay.
Scroll Offsets - Vert Specifiesthenumberofcolumnsthattheverticaldisplay (Full-Screen Mode Only) moveswhenthecursorcrossestheverticaledgeofthe
screen.Use0toindicatethecurrentverticaldisplaysize. PossibleValues:080
Scroll Offsets - Horz Specifiesthenumberofrowsthatthevirtualdisplaymoves (Full-Screen Mode Only) whenthecursorcrossesthehorizontaledgeofthescreen.
Use0toindicatethecurrentverticaldisplaysize. PossibleValues:024
Fixed Screen Mode
IndicateswhethertheTEClientfixesthedisplayonthe mobiledevicetoaspecificpositioninthevirtualdisplay. Whenfixedscreenmodeisenabled,thesameportionofthe virtualdisplayappearsonthedisplayscreenwithoutregard tothelocationofthecursor.

NOTE Ifyouenablefixedscreenmode,youmustalsospecify
thepositionintheFixedScreenWindowOrigingroup.
Window Origin - Left (Fixed-Screen Mode Only) Window Origin - Top (Fixed-Screen Mode Only)
Specifiesthevirtualscreencolumnwherethedisplayscreen ofthemobiledeviceisfixed. PossibleValues:179 Specifiesthevirtualscreenrowwherethedisplayscreenof themobiledeviceisfixed. PossibleValues:124
158
Cursor Settings
UsetheCursortabintheSettingsdialogboxtoconfigurethefunctionofthecursorin emulationscreensforthehostconnection. ThefollowinglistdescribestheconfigurableoptionsintheCursortab.
Cursor Edge Zones - Left Specifiestheleftborderofthecursorzoneinthevirtual
display.Whenthecursormovesoutsideoftheborder,the TEClientrepositionsthescreenoverthevirtualdisplay, centeringthecursoronthedisplayscreenofthemobile device. PossibleValues:Upto255 DefaultValue:4

Cursor Edge Zones Right
Specifiestherightborderofthecursorzoneinthevirtual display.Whenthecursormovesoutsideoftheborder,the TEClientrepositionsthescreenoverthevirtualdisplay, centeringthecursoronthedisplayscreenofthemobile device. PossibleValues:Upto255 DefaultValue:1
Tiling - Vert Mode
DetermineshowtheTEClienthandlesverticaltiling. Optionsinclude:
None.TheTEClientrepositionsthescreenonthe
cursor.
TopOnly:TheTEClientrepositionsthescreeninthe
uppermostrowoftiles.
All.TheTEClientalwaystilesvertically.
DefaultValue:<TopOnly>
159
Tiling - Horz Mode
DetermineshowtheTEClienthandleshorizontaltiling. Optionsinclude:
None.TheTEClientpositionsthescreenaroundthe
cursor.
LeftOnly.TheTEClientpositionsthescreenaround
theleftmostcolumnoftiles.
All.TheTEClientalwaystileshorizontally.
DefaultValue:<LeftOnly>
Tiling - Vert Tiling - Horz
Specifiestheheightofthelogicalscreenintilesfortiling mode. Specifiesthewidthofthelogicalscreenintilesfortiling mode.
Beeps Settings
UsetheBeepstabintheSettingsdialogboxtoconfigurethebeepsthatthemobile deviceplayswhenitreceivesmessagesorerrorsfromthehostsystem. ThefollowinglistdescribestheconfigurableoptionsintheBeepstab.
Message Beep
Indicatesthesoundthatthemobiledevicegenerateswhenit receivesamessagefromthehostsystem. PossibleValues:Default,SystemAsterisk, SystemExclamation,SystemExit,SystemHand, SystemQuestion
Error Beep
Indicatesthesoundthatthemobiledevicegenerateswhenit receivesanerrorfromthehostsystem. PossibleValues:Default,SystemAsterisk, SystemExclamation,SystemExit,SystemHand, SystemQuestion
160
Silent Mode Test
Indicateswhethersilentmodeisenabled.Ifsilentmodeis enabled,themobiledevicewillnotplaybeeps. Teststhebeepsettingsthatareconfigured.Themobile devicewillplaythebeepsthatareconfiguredformessages anderrors,inthatorder.
Telnet Settings
UsetheTelnettabintheSettingsdialogboxtoconfiguretheTelnetautoconnect featureforconnectionstothehostsystem. ThefollowingoptionisavailableontheTelnettab.
Auto Connect
Indicateswhetherthemobiledeviceshouldattemptto reconnecttothehostsystemwhenthehostsystem terminatesthesession.
Printer Settings
UsethePrintertabintheSettingsdialogboxtoconfiguretheprinterthatthemobile deviceisusingforthehostconnection. ThefollowinglistdescribestheoptionsandconfigurableparametersinthePrinter tab.
Printer
Indicatestheprinterthatthemobiledeviceuses. PossibleValues:PS1000,PS1001,PS1004,LINEPRINTER, DUMB,COMTEC,PATHFINDER,RASCAL,RENEGADE, COMTECL_PS,CODE_COURIER,COMTEC_RF, COMTEC_RF_960,TEC,UserDefined
Port Baud
IndicatestheCOMportonthemobiledevicetowhichthe printerisconnected. Indicatesthebaudrateoftheserialconnectiontotheprinter. PossibleValues:9600,14400,19200,38400,57600,115200
Parity
Indicatestheparityoftheserialconnectiontotheprinter. PossibleValues:None,Even,Mark,Odd,Space
161
Data
Indicatesthedatabits(thenumberofbitsineachoctet)of theserialconnectiontotheprinter. PossibleValues:4,5,6,7,8
Stop
Indicatesthenumberofstopbitsthattheserialconnectionto theprinteruses. PossibleValues:1,2
Wakeup
Indicatesthestringofcharactersthatthemobiledevice sendstotheprinterasawakeup.Youcanrepresentthe wakeupstringasanASCIIorhexvalue.
HexValue.Typethehexvaluesofthecharactersthat
youwantthemobiledevicetosendtotheprinter.For example,0000sendstwonullstotheprinter.
ASCIIValue.Use<>toencloseASCIIhexvalues.
Forexample, <00> <00> sendstwonullstothe printer.
Hardware Flow Control Software Flow Control
Indicateswhethertheserialconnectiontotheprinteruses hardwareflowcontrol. Indicateswhethertheserialconnectiontotheprinteruses softwareflowcontrol.
Appendix A: Common Configuration Tasks
162

Thissectionprovidesinformationaboutwheretolocateandconfigurecommon parametersfortheTEClient,including:
ConfiguringPasswords ConfiguringPrintingOnaNetwork ConfiguringTEClientDisplaySettings ConfiguringTEClientLockdown ConfiguringKeyMacros ConfiguringScreenPanning ConfiguringActiveText ConfiguringScanHandlers ConfiguringAutologinforVTEmulation ConfiguringTelnetNegotiationStringsforVTEmulation ConfiguringWorkstationIDsfor5250/3270Emulation EnablingBatteryStrengthandSignalStrengthIcons
Configuring Passwords
CertaincomponentsoftheTEClientarepasswordprotected.Usersmustsupplya passwordtoperformthefollowingtasksfromtheClient:
Manuallyconfigurehostprofiles Manuallyconfigureperhostemulationparameters ExittheTEClient
163
NOTE Bydefault,anexitpasswordisnotconfigured.Ifanexitpasswordisnot configured,usersarenotpromptedforapasswordwhentheychoosetoexittheTE Clientapplication.
Thefollowingtableprovidesinformationaboutanddescribeswhereeachofthese parameterscanbeconfigured.
Location in Configuration Manager
Function
Parameter Name
Default Setting
ConfigureHost Profiles ConfigurePerHost EmulationParameters ExitTEClient
Emulation>Common Emulation>Common Emulation>Common
RFConfigPassword TermConfigPassword ProgramExit Password
SYSTEM CONFIG <None>
Table A-1: ConfiguringTEClientPasswords
To configure a password: 1 AccesstheConfigurationManager. 2 IntheConfigurationManager,locatethepasswordparameter(seeTableA1)that
youwanttomodify.
3 Usethedialogboxforthepasswordparametertoconfigurethepassword.
Figure A-1. ConfiguringtheTerminalConfigurationPasswords
4 ClickOK. 5 Savetheconfigurationanddownloadittothemobiledevice.
164
NOTE FormoreinformationaboutusingtheConfigurationManager,seeUsingthe
Configuring Printing On a Network

Mostmobiledevicesdonotuseaprinterthatisdirectlyconnected.Instead,mobile devicesprintoverthenetworkviaIP. UsetheConfigurationManagertoconfiguremobiledevicesforIPprinting.
To configure the TE Client for printing: 1 AccesstheConfigurationManager. 2 IntheConfigurationManager,doubleclicktheEmulation>Printing>Printer
Protocolparameter.
3 InthePrinterProtocoldialogbox,selectTCPIP.
Figure A-2. ConfiguringMobileDevicesforIPPrinting
4 ClickOK. 5 Savetheconfigurationanddownloadittothemobiledevice. NOTE FormoreinformationaboutusingtheConfigurationManager,seeUsingthe
Configuring TE Client Display Settings

YoucanmodifyandcustomizeTEClientdisplaysettings,including:
165
WhethertheWindowsStartmenudisplayswhiletheTEClientisactive. WhethertheTEClientmenudisplayswhiletheTEClientisengagedinan
emulationsession.
Whethertheverticalorhorizontalscrollbarsdisplayduringanactiveemulation
session. UsetheConfigurationManagertocustomizethese(andother)displayfeaturesofthe TE Client. TableA2providesalistofdisplayoptionsandtheparameters(intheConfiguration Manager)thatareusedtocustomizetheseoptions.
Location in the Configuration Manager
Display Option
Parameter Name
Default Setting
HideWindowsStart Menu HideTEClientMenu HidetheTEClient VerticalScrollbar HidetheTEClient HorizontalScrollbar CreateaKey SequencetoHide/ RevealtheTEClient commandbar SpecifytheFontthat EmulationUses SpecifytheFontSize thatEmulationUses
Emulation>Display Emulation>Display Emulation>Display Emulation>Display Emulation>Display
HideStartMenu HideMenu HideVerticalScrollbar HideHorizontal Scrollbar MenuToggleKey
<ShowStandardStart Menu> <No> <Yes> <Yes> <Default>(Nokey sequenceconfigured)
Emulation>Display Emulation>Display
FontName FontSize
<Standard> <7>
Table A-2: CustomizingtheTEClientDisplay
To configure a display setting: 1 AccesstheConfigurationManager. 2 IntheConfigurationManager,locatethedisplayoptionthatyouwanttomodify. 3 Usethedialogboxfortheparametertoconfigurethedisplayoption. 4 ClickOK.
166
5 Savetheconfigurationanddownloadittothemobiledevice. NOTE FormoreinformationaboutusingtheConfigurationManager,seeUsingthe
Configuring TE Client Lockdown

YoucanconfigureseveralTEClientparameterstoeffectivelylockdowntheTEClient andpreventusersfromlaunchingotherapplicationsonthemobiledevice.
NOTE WhenyouconfigureTEClientlockdown,recordyourpasswordsandkey sequencesinasecurelocationforadministrativepurposes.Ifyouforgetthe passwordsthatyouhaveconfigured,youwillneedtorebootthesystemand reconfiguretheClient.
TableA3liststheparametersintheConfigurationManagerthatyoumustuseto effectivelylockdowntheTEClient.
Location in the Configuration Manager
Parameter to Modify
Parameter Setting
WinCEHideStartMenu WinCEHideMenu* WinCEMenuToggleKey*
Emulation>Display Emulation>Display Emulation>Display
<HideStartMenu> <Yes> Donotconfigureatogglekey (bydefault,notogglekeyis configured) Configureasecurepassword Configureasecurepassword Configureasecurepassword Configureanexitkey
RFConfigPassword TermConfigPassword ProgramExitPassword ProgramExitKey
Emulation>Common Emulation>Common Emulation>Common Emulation>Common
*HidingandpreventingaccesstotheTEClientisnotmandatorytolockingdowntheTEClient,but providesanadditionallayerofsecurity.
Table A-3: ConfiguringTEClientLockdown
To configure TE Client lockdown: 1 AccesstheConfigurationManager. 2 IntheConfigurationManager,modifythelockdownparameters.
167
3 Savetheconfigurationanddownloadittothemobiledevice. NOTE FormoreinformationaboutusingtheConfigurationManager,seeUsingthe
Configuring Key Macros

UsetheConfigurationManagertocreate,configure,orremovekeymacrosfor emulation.Keymacrosallowyoutouseakeysequenceonthedevicetosendamacro sequence,adifferentscancode,orperformalocalfunction. ScancodesforkeysequencescanbedeterminedfromtheDiagnosticsUtilityintheTE Client.Scancodesvarybetweenemulationtypes,soensureyouusethecorrect emulationtypewhenobtainingascancodeforakeymacro. Theformatofakeymacroshouldbe: CODE:[key sequence or \CODE] Where CODE isthescancodeforthekeysequence,andeverythingfollowingthe : isthemacro.Youcanusecharactersorscancodesinthemacro. Examples: 0008:\0020 Inthisexample,pressingthebackspacekey(0008)willsendaspace(0020). 0001:username\000Dpassword\000D Inthisexample,pressing CTRL + A (0001)willsendusernameEnter passwordEnter.
To configure a key macro: 1 FromtheClient,usetheDiagnosticsUtilitytodeterminethescancodeforthekeys
orkeycombinations.
1 AccesstheConfigurationManager. 2 IntheConfigurationManager,locateandrightclicktheEmulation>Common>
KeyMacroparameter. Amenulistappears.
168
3 SelectAddtocreateanewmacroorEdittochangeanexistingmacro.
TheKeyMacrosdialogboxappears.
4 UsetheKeyMacrosdialogboxtoconfigurethekeymacro.
Figure A-3. ConfiguringaKeyMacro
5 Afteryouhaveconfiguredthekeymacro,clickOK.
ThekeymacronowappearsbeneaththeKeyMacrosparameterinthe ConfigurationManager.
Figure A-4. KeyMacroinConfigurationManager
6 Todeleteanexistingmacro,rightclickthemacroyouwanttodeleteandselect
Reset.
7 Savetheconfigurationanddownloadittothemobiledevice. NOTE Formoreinformationaboutmodifyingconfigurationparametersandusingthe
ConfigurationManager,seeUsingtheConfigurationManageronpage 50.
169
Configuring Screen Panning

ThescreenpanningfeatureoftheTEClientallowsausertoscrollaroundthescreen bytappinganddraggingthestylus.Bydefault,screenpanningisenabledontheTE Client. Screenpanninghastwomethodsofoperation:StandardandReversed.Whenscreen panningisoperatinginStandardmode,theviewwindowmovesinthesame directionasthepenisdragged.Forexample,thescreenwillscrolltotheupperleft corneroftheemulationwindowasthepen(ormousecursor)isdraggedtothe upperleftcornerofthescreen. Whenscreenpanningisreversed,theviewwindowmovesintheoppositedirection asthepenisdragged.Forexample,thescreenwillscrolltothelowerrightcorneras thepenisdraggedtotheupperleftcorner.Ifyouwanttousereversescreenpanning, youmustenablestandardscreenpanning.
To configure screen panning: 1 AccesstheConfigurationManager. 2 IntheConfigurationManager,locateandrightclickEmulation>Display>
ScreenPanning. TheScreenPanningdialogboxappears.
3 UsetheScreenPanningdialogboxtoenableordisablescreenpanningfortheTE
Client.
Figure A-5. ConfiguringScreenPanning
4 ClickOK. 5 Ifyouwanttoenable/disablereversescreenpanning,doubleclickEmulation>
Display>ScreenPanningReversedparameters. TheScreenPanningReverseddialogboxappears.
170
6 UsetheScreenPanningReverseddialogboxtoenableordisablereversescreen
panning.
7 ClickOK. 8 Savetheconfigurationanddownloadittothemobiledevice.
Configuring ActiveText
TheActiveTextfeatureoftheTEClientidentifiescertainstringsoftextandconverts themtoobjectsthatausercanselectandclick. TheActiveTextfeaturecanidentifytwotypesofstrings:
Simplemenuitem AS/400stylefunctionkey
Bydefault,bothtypesofActiveTextareenabledontheTEClient. TableA4indicatestheparametersinConfigurationManagerthatcontrolthe differenttypesofActiveText.
ActiveText Type Configuration Manager Parameter
SimpleMenuItem AS/400StyleFunctionKey
Emulation>Common>SimpleNumberMenuActiveText Emulation>Common>FunctionKeyActiveMenu
Table A-4: ActiveTextParametersinConfigurationManager
To configure ActiveText: 1 AccesstheConfigurationManager. 2 IntheConfigurationManager,locateanddoubleclicktheparameterforthetype
ofActiveTextthatyouwanttoconfigure. AdialogboxfortheActiveTexttypeappears.
3 UsethedialogboxtoenableordisabletheActiveText.
171
Figure A-6. ConfiguringActiveText
4 ClickOK. 5 Savetheconfigurationanddownloadittothemobiledevice. NOTE Formoreinformationaboutmodifyingconfigurationparametersandusingthe
ConfigurationManager,seeEmulationParametersonpage 43.
Configuring Scan Handlers

Scanhandlersallowyoutodefinespecialfunctionsthatareappliedtotheprocessing ofascan.Ascanhandlerallowsyoutostripdatafromthebeginningorendofascan and/ortoreplacecertaincharacterswithinascan. Forinformationoncreatingandconfiguringscanhandlers,seetheexplanationlisted ontherightpaneloftheConfigurationManagerwhenyouselectScanHandler.
To add a scan handler: 1 AccesstheConfigurationManager. 2 InConfigurationManager,locateanddoubleclicktheScanner>Common>Scan
Handlerparameter. TheScanHandlerdialogboxappears.
3 UsetheScanHandlerdialogboxtoconfigureanewscanhandler.
172
Figure A-7. ConfiguringaScanHandler
4 ClickOK. 5 ThenewscanhandlernowappearsbeneaththeScanHandlerparameterinthe
ConfigurationManager.
6 Savetheconfigurationanddownloadittothemobiledevice. NOTE Formoreinformationaboutmodifyingconfigurationparametersandusingthe
ConfigurationManager,seeEmulationParametersonpage 43.
Configuring Autologin for VT Emulation

Youcanconfigurethemobiledevicetosendautomaticresponsestopromptsfroma host.ThisallowsforautomaticloginforVT/HPemulation. Becauseautologinisspecifictoeachhostsystem,autologinisconfiguredintheHost Profilesdialogbox.
To configure a mobile device for automatic login to a host: 1 AccesstheHostProfilesdialogbox. 2 FromthelistofhostprofilesintheHostProfilesdialogbox,selectthehostfor
whichyouwanttoconfigureautologinparameters.
3 EnsurethatyouhaveselectedaVTorHPtypeemulationfromtheEmulation
dropdownmenuintheHosttaboftheHostProfilesdialogbox.
4 SelecttheAutologintab. 5 ConfiguretheAutologintab.
173
Figure A-8. ConfiguringVTAutologin
NOTE ForinformationabouttheparametersintheAutologintab,seeAutologin
Settingsonpage 29.
6 AfteryouhaveconfiguredtheAutologintab,clickOK. 7 Downloadthenewconfigurationtothemobiledevice. NOTE Formoreinformationaboutconfiguringhostprofiles,seeHostProfileson
page 20.
Configuring Telnet Negotiation Strings for VT Emulation

ATelnetnegotiationstringisusedtoidentifyamobiledevicetoahostsystemandto presentaClientwiththeappropriateemulationoptions.BecauseTelnetnegotiation stringsarehostspecific,theyareconfiguredintheHostProfilesdialogbox.Telnet negotiationstringsarespecifictoVT/HPemulationtypes.
174
To configure a Telnet negotiation string: 1 AccesstheHostProfilesdialogbox. 2 FromthelistofhostprofilesintheHostProfilesdialogbox,selectthehostfor
whichyouwanttoconfiguretheTelnetnegotiationstring.
3 EnsurethatyouhaveselectedaVTorHPtypeemulationfromtheTypedrop
downlistintheHosttaboftheHostProfilesdialogbox.
4 IntheHostProfilesdialogbox,selecttheVTSettingstab. 5 IntheTelnetNegotiationStringtextbox,configuretheTelnetnegotiationstring
thatthemobiledeviceshouldusewhenconnectingtothehostsystem.
6 ClickOK. 7 Downloadthenewconfigurationtothemobiledevice.
Configuring Workstation IDs for 5250/3270 Emulation

TheTEClientallowsyoutodynamicallygenerateaworkstationIDforamobile deviceusing5250/3270emulation.BecauseworkstationIDsarespecifictoeachhost connection,workstationIDsareconfiguredintheHostProfilesdialogbox.
To configure the TE Client to dynamically generate a workstation ID: 1 AccesstheHostProfilesdialogbox. 2 FromthelistofhostprofilesintheHostProfilesdialogbox,selectthehost
connectionforwhichyouwanttoconfigureaworkstationID.
3 Ensurethatyouhaveselected5250/3270emulationfromtheTypedropdownlist
intheHosttab.
4 SelecttheIBMSettingstab. 5 UsetheWorkstationIDtextboxtoconfigurethedynamicgenerationofa
workstationIDformobiledevicesthatusethehostprofile.
175
Figure A-9. ConfiguringtheWorkstationID
6 ClickOK. 7 Downloadthenewconfigurationtothemobiledevice.
Enabling Battery Strength and Signal Strength Icons

BatterystrengthandwirelesssignalstrengthindicatoriconsareavailableinTEClient 5.1andnewerversions.Youmayconfigurethefollowingindicatoriconsettings:
Whethertodisplaythesignalstrengthicon Whethertodisplaythebatterypowericon Whethertodisplaytheicon(s)ontheWindowssystemtray,theTEClient

commandbar,orelsewhereonthescreen
Thesize(largeorsmall)oftheicon(s)
176
TableA5providesinformationaboutconfiguringtheindicatorsettingstomeetyour needs:
Parameter in Configuration Manager
Desired Effect
Setting
Notes
Displayicon(s)inWindows tasktrayonly Displayicon(s)inTEClient commandbaronly Displayicon(s)inTEClient commandbarorWindows systemtray(whicheveris available,startingwiththe Windowssystemtray) Displayicon(s)onemulation screen(notinthecommand barorthesystemtray) Specifylocationandsizeof icons
Indicators> IndicatorsPreferred OffScreen Indicators> IndicatorsPreferred OffScreen Indicators> IndicatorsPreferred OffScreen
<SystemTray Only> <Command BarOnly> <Command BarorSystem Tray>
Donothidethe Windowsstartmenu DonothidetheTE Clientcommandbar
Indicators> IndicatorsPreferred OffScreen Indicators> IndicatorsScreen Settings
<No>
Selectyour preferred optionfor locationand size
SetIndicators PreferredOffScreento No
Table A-5: ConfiguringBatteryandSignalStrengthIndicators
To enable the battery power indicator: 1 AccesstheConfigurationManagerforglobalemulationparameters. 2 IntheConfigurationManager,locatetheIndicatorsfolder.
177
Figure A-10. Indicatorsfolder
3 UsetheEnableBatteryStrengthIndicatorparametertoenable/disablethebattery
strengthindicatoricon.
4 UsetheEnableSignalStrengthIndicatorparametertoenable/disablethewireless
signalstrengthindicator.
5 UsetheIndicatorsPreferredOffScreenparametertoconfigurewheretheicon(s)
aredisplayed(theWindowssystemtray,theTEClientcommandbar,oronthe screenitself).
6 IfyoudidnotusetheIndicatorsPreferredOffScreenparametertodisplayicons
onlyintheWindowssystemtrayorTEClientcommandbar,thenusethe IndicatorsScreenSettingsparametertoconfigurethelocationandrelativesize (largeorsmall)oftheindicatoricon(s)onthescreen.

7 Savetheconfigurationanddownloadittothemobiledevice. NOTE Formoreinformationaboutconfiguringglobalemulationparameters,see
EmulationParametersonpage 43.
Appendix B: Wavelink Contact Information
178
Appendix B: Wavelink Contact Information

Ifyouhavecommentsorquestionsregardingthisproduct,pleasecontactWavelink CustomerService. EmailWavelinkCustomerSupportat:CustomerService@wavelink.com ForcustomerswithinNorthAmericaandCanada,calltheWavelinkTechnical Supportlineat8013169000(option2)or8886999283. Forinternationalcustomers,calltheinternationalWavelinkTechnicalSupportlineat +80092835465. ForEurope,MiddleEast,andAfrica,hoursare9AM5PMGMT. Forallothercustomers,hoursare7AM7PMMST.
Glossary
179
Glossary
802.11/a/b/g
TheIEEEstandardsforwirelessEthernet.802.11providesfor wirelessnetworkingspeedsupto2Mbpsat2.4GHz.802.11b provideswirelessnetworkingspeedsupto11Mbpsat2.4 GHz.802.11aprovideswirelessnetworkingspeedsupto54 Mbpsat5GHz. AdevicethatactsasabridgebetweenwirelessLANsand wiredLANs. AsinglesteptakenbytheScreenReformatter. Amodeofoperationinwirelessnetworkswherewireless devicescommunicatedirectlywitheachotherwithoutthe useofanaccesspoint.Alsosometimesreferredtoaspeerto peermodeoranindependentbasicserviceset(IBSS). Seeaccesspoint. AdynamicimplementationofWEPkeys,wherethekey usedonthewirelessnetworkchangesperiodically.Clients mustsynchronizetheirWEPkeyusewiththeAP. Asoftwarecomponentthatfacilitatescommunication betweentheAvalancheConsoleandAvalancheEnablers. Asoftwarecomponentinstalledonmobiledeviceswhich allowsyoutoconfigureandmanagethedeviceusingthe AvalancheConsole.TheEnablerfacilitatescommunication betweenthemobiledeviceandanAvalancheserver. Wavelinksmanagementapplicationthatallowsyouto centrallyconfigureandmanageinfrastructureandmobile devicesthroughoutyournetwork. Aspeciallybundledpieceofsoftware(e.g.,anapplication) thatyoucandownloadtoadeviceusingAvalanche. Adownload(orconfiguration)thatisavailabletoaclient throughAvalanche.Examplesofupdatesincludesoftware packagesandnetworkprofiles.Thedeletionoforphaned packagesfromadeviceisanothertypeofupdate.
access point action ad hoc mode
AP automatic WEP
Avalanche Server Avalanche Enabler
Avalanche Console
Avalanche Software Package Avalanche Update
Glossary
180
BOOTP ConnectPro
BootstrapProtocol.Aprotocolthatallowsclientsto automaticallyobtainIPparametersfromaBOOTPserver. AnoptionalcomponentofTerminalEmulationthathandles sessionpersistence.ConnectProactsasaproxybetweenthe mobiledeviceandtheemulationhost.Ifthedeviceloses connectivityorgoestosleep,theConnectProserver maintainsthesessionuntilthedevicereconnects. ConnectProisfreebutisinstalledseparately. ThetoprightsectionoftheScreenReformatter.Thisview displaysinformationabouttheInitialScreenandModified Screen. DynamicHostConfigurationProtocol.AnIPservicethat allowsDHCPclientstoautomaticallyobtainIPparameters fromaDHCPserver. DomainNameSystem.Aservicethatprovideshostnameto IPaddressmapping. ConfigurationsfortheTEClientthatallowsyoutoset terminalemulationrelatedbehavioronamobiledevice. Theseparameterscanbeglobalorhostspecific. SeeAvalancheEnabler. ExtendedServiceSetID.Theidentifierofanextended servicesetfordevicesthatareparticipatinginan infrastructuremodewirelessLAN. FileTransferProtocol.ATCPbasedservicethatprovides connectionorientedfiletransfers. AhostsystemthatprovidesFTPservices.Usersarerequired tologintotheFTPservicetogainaccesstofilesthatcanbe downloadedfromtheserver. Adeviceonalocalnetworkthroughwhichdatatoother networksisrouted.Alsocalledarouter. Aserverorworkstationthathostsaspecificsoftwareor networkservice.
Descriptive View
DHCP
DNS emulation parameters
Enabler ESS ID
FTP FTP Server
gateway host
Glossary
181
host profile
AconfigurationfortheTEClientthatallowsyoutosavehost information(suchasIPaddressandTelnetport)onmobile devices. HyperTextTransferProtocol/SecureHyperTextTransfer Protocol.ProtocolsusedforWEBemulation.HTTPisan insecureprotocol.HTTPSisbasedonTLSandismoresecure thanHTTP. IndependentBasicServiceSet.Seeadhocmode. InternetControlMessageProtocol.PartoftheTCP/IPsuite thatprovidesservicesfortestingnetworkconnections. Aspecialvalueusedtoinvokeadeviceaction,program action,oremulatoractionwithintheTEClientIndustrial Browser. TheTEClientincludesanIndustrialBrowserinterfacethat givesyoutheabilitytoaccesswebbasedapplicationsfroma mobiledevice.DevelopyourownwebpagesusingMETA tagsandIDAcommandstoenablespecificfunctionalityin theIndustrialBrowser.TheIndustrialBrowserissupported PocketPC2003,WindowsMobile5.0,Windows2000/XP,and WindowsCE.NET4.2/5.0. Awirelessnetworkconfigurationusedwhendevices communicatewitheachotherthroughanaccesspoint. Avaluesuppliedtoafieldwheneverthemodifiedscreenis used. ThebottomsectionoftheScreenReformatter.Thisview displaysthescreenthatwascaptured,beforemodifications. InternetProtocoladdress.Avirtualaddressthatuniquely identifiesanetworkconnection. LocalAreaNetwork TheLicenseServerisanoptionalcomponentofTerminal EmulationthathandleslicensingforTEClients.Itdistributes licenseswirelesslyandtrackslicensesthathaventbeenused recentlyifyouneedtoredistributeyourlicenses.ConnectPro isfreewithTerminalEmulationbutisinstalledseparately.
HTTP/HTTPS
IBSS ICMP IDA command
Industrial Browser
infrastructure mode Initial Field Value Initial Screen View IP address LAN License Server
Glossary
182
localization MAC address
AserviceoftheTelnetCEClientthatallowsyoutoconfigure theClienttodisplayinaspecificlanguage. MediaAccessControladdress.Thehardcodedlayer2 addressofadevice,whichconsistsofa12digithexadecimal number.Thefirst6hexadecimalcharactersidentifythe manufacturer.Thelast6hexadecimalnumbersareunique foreachnetworkdeviceproducedbythemanufacturer.The MACaddressisalsosometimescalledthehardwareaddress. Afilethatcontainsseveralmodifiedscreensalongwith originalscreencaptures.Masterfilesareidentifiedbya .wlrmf fileextension. Megabyte Megabits/second Tagsthatallowspecificfunctionalityinthebrowserforweb pages. Aportabledevicewithawirelessnetworkconnection. ThethetopleftsectionoftheScreenReformatter.Thisview displaysthemodifiedversionofthecapturedscreen. Seesubnetmask. Asetofpreconfigurednetworkparameters(ESSID,IP address,etc.)thatcanbedownloadedtoadeviceusing Avalanche. AsoftwarepackagethathasbeendeployedtoanEnabler throughAvalanche,buthassincebeendisabledorisnot recognizedbytheserver. AnIPservicethatisusedtotestIPconnectivity. RandomAccessMemory.Volatilememoryinacomputer system. Statisticsanddetailsaboutthemobiledevicethataresentto theAvalancheConsole.Thatinformationcanthenbeviewed fromtheMobileDeviceDetailsdialogbox.Therealtime statisticsfeatureisonlyavailableforAvalanchedeployedTE Clients.
master file
MB Mbps META tag mobile device Modified Screen View net mask network profile
orphaned package
ping RAM real-time statistics
Glossary
183
return
Astatementthatendstheprocessingofthecurrentfunction andreturnscontroltothecallingfunction,withorwithouta returnvalue. RadioFrequency.Usuallyusedinthecontextofatypeof networkconnection. ATelnetfeaturethatallowsyoutoimportanddeploysound orpicturefilestoyourmobiledevices. Seegateway. Inordertousethescreenreformatter,yourecordthescreens usingtheTEClient.Theresultingscreencapturefileis importedintothescreenreformatterandmodified.Screen capturefilesareidentifiedbya .wltsc fileextension. Thescreenreformatterallowsyoutoredesignhowthe emulationscreenisdisplayedonthemobiledevice.Include onlythetextoroptionsyouwanttobeavailabletotheuser. YoucanalsoaddothertextorscriptingandSpeakeasy actionsforeachscreen. Specificdevicepropertiesthatallowyoutofilterspecific mobiledevicesonthenetworkforAvalanche.Youcanfilter byMACaddress,IPaddress,devicetype,operatingsystem, etc.Selectioncriteriaareusedtotargetspecificmobile devicesforupdates. AnAvalancheintegratedcomponentoftheTEClientthat allowsauserattheAvalancheConsoletomonitororcontrol theTEClient.ThisisavailableforAvalanchedeployedTE Clientsonly. Aspeciallybundledpieceofsoftware(e.g.,afirmware updatetoaradiocardoranapplication)thatyoucan downloadtoaclientusingAvalanche. SpeakeasyisanoptionalcomponentofTerminalEmulation thatcanturntexttospeechorprocessspokencommands andoutputtextorcommandsonthemobiledevice. Speakeasyislicensedandinstalledseparately.Seethe SpeakeasyReferenceGuideformoreinformation.
RF Resource Editor router screen capture file
screen reformatter
selection criteria
Session Monitor
software package
Speakeasy
Glossary
184
SSH
SecureShell.AprotocolencapsulatingTelnetthatusesa securechanneltosendencryptedinformationacrossa network. SecureSocketsLayer/TransportLayerSecurity.Protocolsthat encryptinformationusinghandshakesandciphers.TLSis basedonSSLandismoreadvanced.YoucaninstallSSL/TLS supportsothattheClient/hostconnectionisencrypted. ServiceSetIdentifier.Auniquename,upto32characters long,thatisusedtoidentifyawirelessLAN.TheSSIDis attachedtowirelesspacketsandactsasapasswordto connecttothenetwork. ManualimplementationofWEPkeys. Anorderedsequenceofsymbolschosenfroma predeterminedset. Alogicalnetworkwhereeachclientisparticipatingonthe sameIPnetwork. AtypeoffilterthatallowsIPclientstodeterminewhichpart oftheirIPaddressdefinesthenetworkandwhichpart definesthehost. TransmissionControlProtocol/InternetProtocol.Asuiteof protocolsthatprovidesvirtualaddressing,connection orientedandconnectionlesscommunication,andanumber ofothernetworkservicesandutilities. ATCP/IPprotocolthatallowsaClienttoconnectand interactwitharemotehostsystem. SeeConnectPro. TrivialFileTransferProtocol.AUDPbasedservicethat providesconnectionlessfiletransfers. SeeSSL/TLS. InthecontextofAvalanche,anytimethedevicesEnabler contactsthemobiledeviceserverandobtainsnewfilesor configurationinformation.
SSL/TLS
SSID
static WEP string subnet subnet mask
TCP/IP
Telnet TermProxy TFTP TLS update
Glossary
185
verification item WEP Windows CE Windows Enabler
Anitemontheoriginalhostscreenthatmustbeverified beforethemodifiedscreenwillbedisplayed. WiredEquivalentPrivacy.Anencryptionstandardfor wirelessnetworks. AMicrosoftWindowsbasedoperatingsystemformobile devices. AnAvalancheEnablerthatisdesignedforMicrosoft Windows9x/ME/NT/2000/XPsystemswithinstalled802.11a/ b/gwirelesscards. WindowsInternetNamingService.Aservicethatprovides WindowsnametoIPaddressmapping.
WINS
Index
186
Index
Numerics
5250/3270virtualkeyboard 122 802.11/a/b 179 find 52 using 50 configuring activetext 170 autologinforVTemulation 172 emulationparameters 43 failover 42 hostprofiles 20 IPprinting 164 keymacros 167 licenseserverIPaddress 18 passwords 162 scanhandlers 171 screenpanning 169 sessionmonitor 139 TEClientdisplaysettings 164 TEClientlockdown 166 telnetnegotiationstringsforVT emulation 173 TermProxyonlyconnections 40 workstationIDsfor5250/3270 emulation 174 connectingtohosts 112 contactinformation 178 copyingtext 91 creating commandlineURLhostprofile 136 creatingscriptcode 58 cursorsettings 158 cursorverification 99
A
accesspoint 179 accessing globalemulationparameters 44 perhostemulationparameters 47 activetext configuring 170 using 128 adhocmode 179 adding hostprofiles 21 addingtext 92 alphabetizedview,configuration manager 52 AP 179 autologinforVTemulation,configuring 172 automaticWEP 179 AvalancheEnabler 179 AvalancheManager,defined 179 AvalancheServer 179 Avalanchesoftwarepackage,defined 179 Avalancheupdate 179
B
batterystrengthicon 175 beepssettings 159 BOOTP 180
C
capturingscreens 82 certificateverification,enabling 40 comments 96 configurationmanager alphabetizedview 52
D
deletingscreens 90 demolicense,using 17 deploying ResourceEditorfiles 80 deployingkeyboards 77 deployingreformattedscreens 110
Index
187
deployingscripts 64 descriptiveview 86 DHCP 180 diagnosticsutility performingakeyboardtest 131 performingascantest 133 performingaWindowskeyboardtest 134 diagnosticsutility,using 130 disconnectingaTelnetsession 115 displaysettings 156 displaysettings,configuring 164 DNS 180 duplicatingscreens 90
F
field assigninginitialvalue 95 verification 99 find 52 fontsettings 155 FTP 180 FTPserver 180
G
gateway 180 globalemulationparameters accessing 44
E
editingscripts 62 emulationparameters configuring 43 defined 180 modifying 51 usingconfigurationmanager 50 Enabler 180 enabling certificateverification 40 indicatoricons 175 SSL 37 ESSID 180 executingscripts onbarcode,MSRorRFIDscan 66 onkeycombination 66 onscreenupdate 67 selectfrommenu 65 whensessionconnects 66 exitingtheTEClient 116 exporting 63 masterfile 110 screencapturefile 111 exportingscripts 63
H
host 180 hostfailover 42 hostprofileverification 98 hostprofile,defined 181 hostprofiles 59 adding 21 andSSL/TLS 36 andTermProxy 40 commandlineURL 136 configurationsettings 30 configuring 20 hostsettings 23 IBMsettings 27 languagesettings 31 manuallyconfiguring 147 TermProxysettings 25 VTsettings 27 WEBsettings 27
I
IBMHostsettings 152 IBSS 181 ICMP 181 IDACommands,defined 181 importing
Index
188
masterfile 88 screens 88 importingkeyboardgraphics 72 importingscripts 63 indicatoricons 175 IndustrialBrowser basicnavigation 137 hostprofilesettings 137 using 137 infrastructuremode 181 initialfieldvalue 95 initialscreenview 85 initiatingaTelnetsession 114 InitiatinganAdditionalTelnetSession 118 installing SSLsupportpackageonhostsystem 37 SSLsupportpackageonmobiledevice 37 IPaddress 181 IPprinting,configuring 164
deleting 77 positioning 76 sizing 76
L
LAN 181 languagesettings 31 launching ResourceEditor 78 sessionmonitor 141 TEClient 112 licenseserverIPaddress,configuring 18 licensing demolicense 17 manuallylicensingtheTEClient 16 methods 15 types 14 usinglicenseserver 16 localization defined 182 lockdown,configuring 166
K
keymacros,configuring 167 keyboardcreator launching 69 keyboardfiles 70 keyboardtest 131 keyboards adding 71 creating 71 deleting 72 deploying 77 importinggraphics 72 keys 73 positioningrows 76 sizing 72 sizingrows 76 keys addingkeys 74 configuring 73 creating 73
M
MACaddress 182 masterfile exporting 110 importing 88 MB 182 Mbps 182 messagesettings 152 METAtag,defined 182 mobiledevice 182 modemsettings 31 modifiedscreenview 85 modifying emulationparameters 51 realtimestatistics 146 multipleconcurrentsessions 117
Index
189
N
netmask 182 networkprofile,defined 182
editingfiles 80 launching 78 RF 183 router 183
O
openingscreenreformatter 83 optionsmenu 134 orphanpackage,defined 182 orphanedpackage 182
S
savingscripts 63 scanhandlers,configuring 171 scantest 133 screenactions 109 screenpanning configuring 169 using 127 screenreformatter using 136 screenreformatter,launching 83 screens capturing 82 deleting 90 deploying 110 duplicating 90 importing 88 organizing 89 renaming 90 resizing 93 template 96 verification 97 scriptcapturing 60 scriptcode 58 scripteditor 54 launchingfromAvalancheManager 55 scripting creatingvariables 58 scriptingsupport 108 scripts 63 creatingscripts 56 deploying 64 editing 62 importing 63 overview 54
P
passwords,configuring 162 performingscriptcapturing 60 perhostemulationparameters accessing 47 beepssettings 159 cursorsettings 158 displaysettings 156 fontsettings 155 IBMhostsettings 152 IndustrialBrowsersettings 152 messagesettings 152 printersettings 160 telnetsettings 160 viewsettings 157 VTXXsettings 151 ping 182 printersettings 160
R
RAM 182 realtimestatistics 143 modifying 146 viewing 144 recordingascript 60 resizingthescreen 93 ResourceEditor addingbitmap 79 addingsound 79 deployingfiles 80
Index
190
saving 63 selecting hostprofiles 59 selectioncriteria 183 sessionmonitor configuring 139 launching 141 sessionoverride 142 tracingsessions 142 using 139 signalstrengthicon 175 sizingkeyboards 72 softwarepackages,defined 183 Speakeasysupport 100 speechtotextsupport 102 SSID 184 SSL andhostprofiles 36 certificates 37 enabling 37 enablingcertificateverification 40 installingsupportpackageonhost system 37 installingsupportpackageonmobile device 37 staticWEP 184 statusbar 87 subnet 184 subnetmask 184 switchingbetweenactiveTelnetsessions 119
optionsmenu 134 telnet 184 TelnetClient autologinforVTemulation 172 configuringactivetext 170 configuringIPprinting 164 configuringkeymacros 167 configuringlicenseserverIPaddress 18 configuringpasswords 162 configuringscanhandlers 171 configuringscreenpanning 169 configuringtelnetnegotiationstringsfor VTemulation 173 configuringworkstationid 174 disconnectingasession 115 initiatingaTelnetsession 114 licensingwithlicenseserver 16 manuallyconfiguringhostprofiles 147 multipleconcurrentsessions 117 realtimestatistics 143 sessionmonitor 139 using 112 telnetnegotiationstrings,configuring 173 telnetsettings 160 template 96 TermProxy andhostprofiles 40 configuringfailover 42 configuringTermProxyonly connections 40 text adding 92 copying 91 verification 98 texttospeechsupport 100 TFTP 184 TLS 36 toolbar 88 tracingsessions 142 treeview 84
T
TCP/IP 184 TEClient configuringdisplaysettings 164 configuringlockdown 166 diagnosticsutility 130 exiting 116 launching 112 manuallylicensing 16
Index
191
U
updates,defined 184 using activetext 128 configurationmanager 50 find 52 IndustrialBrowser 137 realtimestatistics 143 screenpanning 127 screenreformatter 136 sessionmonitor 139 sessionoverride 142 standardvirtualemulationkeyboard 120 TEClientdiagnosticsutility 130 TEClientoptionsmenu 134
automatic 179 defined 185 staticwep 184 WindowsCE 185 WindowsEnabler 185 WINS 185 workstationid,configuring 174
V
variables 58 verification 97 cursor 99 field 99 hostprofile 98 orderingitems 100 text 98 viewsettings 157 viewingrealtimestatistics 144 virtualkeyboard 5250/3270 122 using 120 VT/HP 124 WEB 124 VT/HPvirtualkeyboard 124 VTXXsettings 151
W
Wavelinkcontactinformation 178 webpages specifyingthehomepage 138 WEBvirtualkeyboard 124 WEP

Te Ug 73 20110121

Caricato da

Informazioni sul documento

Descrizione originale:

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Te Ug 73 20110121

Caricato da

Copyright:

Formati disponibili

Wavelink Terminal Emulation Client User Guide

Version 7.3 tn-ug-20110121

Features of the TE Client

About This Guide

Chapter 2: Installation and Licensing

Chapter 2: Installation and Licensing

Configuring and Deploying the TE Client

Chapter 2: Installation and Licensing

configureandinstalltheTEClient,pleaseseethedocumentationforthat applicationfordetailsonthisprocess. DependingontheTEClientinstallationandconfigurationutilitythatyouareusing, sometoolsthatallowyoutoconfigureTEClientfeaturesmaynotbeavailable.Tools forconfigurationmayincludethefollowing:

Chapter 2: Installation and Licensing

UsingAvalanchetoConfiguretheTEClient UsingAvalanchetoDeploytheTEClientandConfiguration UsingActiveSynctoConfigureandDeploytheTEClient Using Avalanche to Configure the TE Client

Chapter 2: Installation and Licensing

Figure 2-1. ConfiguringtheTEClientPackage

5 Fromthemenulist,selecttheconfigurationtoolthatyouwanttouse. 6 Edittheconfigurationoptionsasdesired. 7 AfteryouhaveconfiguredthenewsettingsfortheTEClient,usetheAvalanche

Using Avalanche to Deploy the TE Client and Configuration

Chapter 2: Installation and Licensing

mobiledeviceserver(s).Ifyouneedtomanuallydeploy,youcaneitherperforma universaldeploymentorrightclicktheservertowhichyouaredeployingand clickDeployNowinthecontextmenu.

Using ActiveSync to Configure and Deploy the TE Client

Figure 2-2. ActiveSyncInstallationandConfigurationUtility

Chapter 2: Installation and Licensing

Licensing the TE Client

TypesofLicenses LicensingMethods ConfiguringtheLicenseServerAddress Types of Licenses

Chapter 2: Installation and Licensing

Chapter 2: Installation and Licensing

establishaconnectiontoahost.Whenyouattempttoconnect,theAuthorizing Terminaldialogboxappears.TapAddLicense. TheAuthorizationdialogboxappears.

Chapter 2: Installation and Licensing

serverIPaddressinorderforthedevicetoobtainalicense.Formoreinformation,see ConfiguringtheLicenseServerAddressonpage 18. TheAuthorizingTerminaldialogboxdisplaysonthemobiledevicewhiletheTE Clientattemptstolocatealicenseserver.

licenseserver.TheAuthorizingTerminaldialogboxonthemobiledeviceindicates thatalicensehasbeenobtained. Ifnolicenseserverrespondstotherequestforalicense,thentheAuthorizing Terminaldialogboxcontinuestodisplayuntilyouclosethedialogbox,runthe Clientwithademolicense,orchoosetomanuallyaddalicense.

Chapter 2: Installation and Licensing

Terminaldialogboxappears. Ifyouhavemorethanonehostprofile,theSelectHostdialogboxappears.Select thehostwithwhichyouwanttoestablishanemulationsessionandthe AuthorizingTerminaldialogboxappears.

TheTEClientusesthedemonstrationlicenseandattemptstoconnecttothehost thatyouselected.Beforedisplayingthehostemulationscreen,theTEClient displaysascreenthatindicatesthatyouareusingademonstrationlicense.

Figure 2-3. TEClientRunninginDemonstrationMode

Configuring the License Server Address

Chapter 2: Installation and Licensing

Figure B-4. ConfiguringtheLicenseServerIPAddress

4 ClickOK. 5 Savethenewconfiguration. 6 ClosetheConfigurationManageranddownloadthenewconfigurationtothe

Chapter 3: Host Profiles

Chapter 3: Host Profiles

ConfiguringaHostProfile HostProfilesandSSL/TLS HostProfilesandWavelinkConnectProorTermProxy

Configuring a Host Profile

Chapter 3: Host Profiles

Figure 3-1. HostProfilesDialogBox

Adding or Modifying a Host Profile

Chapter 3: Host Profiles

3 UsethetabsintheHostProfilesdialogboxtoconfigurethehostprofile. 4 Ifyouwanttodeleteahostprofile,selectitfromthelistandclickDelete. 5 Afteryouhavefinishedconfiguringhostprofiles,clickOK.

Host Profile Configuration Options

Chapter 3: Host Profiles

UsetheHosttabintheHostProfilesdialogboxtoconfigurethebasicsettingsofthe hostprofile.Theoptionsmayvarydependingonthetypeofemulationyouhave selected.

Figure 3-2. ConfiguringHostSettings

Indicatesthenameofthehostprofile,whichshouldbe synonymouswiththename(alias)ofthehostsystemto whichthemobiledeviceconnectswhenthehostprofileis used. PossibleValues:150alphanumericcharacters

Chapter 3: Host Profiles

Type Address Port Only Use TermProxy Connections

Use SSL/TLS Encryption IndicateswhethertheTEClientshoulduseSSL/TLSto

Verify Server Certificates

Select Verification Certificates

Use SSH encryption

Chapter 3: Host Profiles

YoumayconfigureuptothreeConnectPro/TermProxyconnections.Usethe TermProxytabstospecifytheparametersoftheConnectPro/TermProxyconnection. ThefollowinglistdescribestheconfigurableoptionsintheTermProxytab:

SelecttheConnectProorTermProxyservertowhichtheTE Clientwillconnect. PossibleValues:

IndicatestheIPaddressoftheproxyserveroralternatehost system. IndicatestheTCPlisteningportoftheproxyserveror alternatehostsystem.

Chapter 3: Host Profiles

Terminate TermProxy Session