A host profile defines the settings that the TE Client should use when it attempts to initiate a connection with a specific host. The host profile may include the emulation type, IP address of the host, IP address of the ConnectPro server, or other settings. You may configure an unlimited number of host profiles from the device or through Wavelink Avalanche.
When a device user attempts to initiate a session with a host, the TE Client displays a list of available host profiles. The user selects the host he wants to connect to, and the TE Client uses the host profile settings to connect to the host.
Depending on the emulation type, there are different options available when configuring a host profile. The following options may be available when you configure a host profile:
Profile name |
The name of the host profile. |
Type |
The emulation type that the mobile device uses when connected to the host system. |
Address |
The IP address or host name of the host system to which the mobile device will connect. When creating a host profile, you may enter a subnet-specific address rather than an IP address or a DNS name, which looks like: 0.X.X.X/X. The specified address is combined with the mobile device IP address to determine the host’s address. The number after the slash determines the number of bits of the subnet-specific address that should be ignored. Examples: For a mobile device with an IP address of 10.20.30.40: • When connecting to a subnet-specific address of 0.1.2.3/8, the device will look for a host at 10.1.2.3 • When connecting to a subnet-specific address of 0.0.2.3/16, the device will look for a host at 10.20.2.3 • When connecting to a subnet-specific address of 0.0.0.3/24, the device will look for a host at 10.20.30.3 Subnet-specific addressing is also available for WEB emulation. However, you should use a | character instead of a / character to denote the number of bits. Examples: For a mobile device with an IP address of 10.20.30.40: • When connecting to a subnet-specific address of • When connecting to a subnet-specific address of Variables can be used with both DNS names and IP addresses. To prompt a device user for all or part of the address, use a variable delineated by %. For example: 192.168.42.%Store Number% The text that is inside the % indicators is the information that appears in the prompt on the device. In the above example, the prompt on the device would ask the user for "Store Number". If the user provides the store number 123, the Client attempts to connect to 192.168.42.123. |
Port |
The TCP port number on which the host system is listening for emulation requests from Clients. |
Only use TermProxy connections |
Indicates whether the TE Client should only connect to the host through a ConnectPro or TermProxy server. If you enable this checkbox, you must configure the host information (name, IP address, emulation type, and port). |
Use SSL/TLS encryption |
Uses SSL/TLS to encrypt the information sent to the host. There is no additional software for SSL/TLS on Smart devices, but the host must be configured for SSL/TLS. When you enable SSL/TLS encryption, you must use a certificate. Tap the Manage Certificates button, then tap Insert Certificate. Tap the name of the certificate in the list and then Accept Certificate. The certificate must be saved as certificates.pem on the device in the root directory of the first listed mounted storage (not part of the root file system). This may be internal storage or an SD card. |
Use SSH encryption |
Uses SSH to encrypt the information sent to the host. There is no additional software for SSH on the device, but the host must be configured for SSH. |
Display in black and white |
Uses white text on a black background for the display. |
Foreground color |
Sets the color of all text displayed on a screen. When Default is selected, the existing text color of a screen is used, which is typically green. If the Display in black and white setting is selected, this option is ignored. |
Background color |
Sets the color of the screen background. When Default is selected, the existing background color of a screen is retained, which is typically black. If the Display in black and white setting is selected, this option is ignored. |
Keyboard Tags |
Assigns keyboard tags to a host profile for using specific custom keyboards created with the Wavelink Productivity Pack. Each tag should be separated by a comma. The order of keyboards presented from the TE Client is governed by their order in the Productivity Pack, not by the order of tags. If a tag is shared by multiple keyboards, keyboards are likewise given preference by their order in the Productivity Pack. If no keyboard tags are provided for a host profile and custom keyboards exist on a device with Terminal Emulation, the custom keyboards are used instead of the device's default keyboards for all host profiles. For more information, see the Productivity Pack Help Guide on the Wavelink website. To disable keyboard swiping, enter the keyboard tag |
Width of telnet window (columns) |
The number of columns to display on the device screen. Setting a value other than 0 removes the green frame around the Telnet window. |
Height of telnet window (rows) |
The number of rows to display on the device screen. Setting a value other than 0 removes the green frame around the Telnet window. |
Tunnel Telnet using SSH Local Port Forwarding |
Sets whether or not to use tunneling. If you are using 5250 emulation with SSH, you must use SSH tunneling. |
Address |
The IP address or host name for SSH tunneling. |
Port |
The TCP port number for SSH tunneling. |
User Name |
The username for SSH. |
Password |
The password for SSH. |
Type |
The version number of the ConnectPro or TermProxy server. |
Address |
The IP address or host name of the server. To prompt a device user for all or part of the address, use a variable delineated by %. Variables can be used in DNS names or IP addresses. For example: 192.168.42.%Store Number% The text that is inside the % indicators is the information that appears in the prompt on the device. In the above example, the prompt on the device would ask the user for "Store Number". If the user provides the store number 123, the Client attempts to connect to 192.168.42.123. |
Port |
The TCP port number on which the proxy server is listening for emulation requests from Clients. |
Terminate TermProxy Session |
Indicates when the ConnectPro or TermProxy server should terminate the connection to the host. Possible Values: • Never. The proxy server never terminates the session established with the host. The Client is responsible for terminating the session. • On Network Error. The proxy server terminates the session with the host when a network error occurs, such as a loss of network connectivity. • On Session Exit. The proxy server terminates the session with the host when the session is terminated by the Client. • Always. The proxy server will terminate the session with the host on a network error or when the session is terminated. |
Client Reconnects if Unexpectedly Disconnected |
Specifies if the Client will attempt to reconnect if the session with the proxy server is lost and the Client has not received a disconnect message from the proxy server. |
Reconnect string |
Specifies the reconnect string that the Smart device should use when connecting to the host. (Alternately, you may configure reconnect strings in ConnectPro.) |
Use SSL/TLS encryption |
Uses SSL/TLS to encrypt the information sent to the host. There is no additional software for SSL/TLS on Smart devices, but the host must be configured for SSL/TLS. When you enable SSL/TLS encryption, you must use a certificate. Tap the Manage Certificates button, then tap Insert Certificate. Tap the name of the certificate in the list and then Accept Certificate. The certificate must be saved as certificates.pem on the device in the root directory of the first listed mounted storage (not part of the root file system). This may be internal storage or an SD card. |
Use Custom Encryption |
Uses a Wavelink custom encryption method to encrypt the connection to the ConnectPro server. When you use custom encryption, provide an encryption key. |
Workstation ID (5250) |
An ID for mobile devices connecting to an IBM host. The ID may include static characters and the following switches, which are used to capture dynamic data specific to each mobile device: • %a - %d. Captures specific octets of the IP address of the mobile device. For example, use %a%b%c%d to capture all four IP octets of the address of the mobile device, or use %d to capture only the last octet of the IP address of the mobile device. • %m - %r. Captures specific octets of the MAC address of the mobile device. For example, use %p%q%r to capture the last three octets of the MAC address of the mobile device. • %s. Captures the session number. • %t. Captures the Avalanche terminal ID of the mobile device. (If the mobile device does not have an Avalanche Enabler, then this parameter is not valid.) A workstation ID can be 1-20 alphanumeric characters plus switches, but IBM hosts usually truncate workstation IDs that are more than 10 characters. The workstation ID should not begin with a numeric character. |
Telnet Negotiation String |
A Telnet negotiation string for the host connection. A Telnet negotiation string is used to identify a mobile device to a host system and to present a Client with the appropriate emulation options. The host system can then supply information to the mobile device based on Telnet negotiation string (for example, menus or display options). The string can be 1-20 alpha-numeric characters. |
User Name |
The user name the Client should use when connecting to the host. To prompt a user for a specific user name, use a variable delineated by a %. %Gun Number% The text included within the % indicators is the information that appears in the prompt on the device. In the above example, the prompt on the device would ask the user for "Gun Number" as their user name. |
Password |
The password the Client should use when connecting to the host. To accept a variable value, you can use a value delineated by a % after enabling the Use prompt scheme when editing the host profile in TE or through the TE Host Profile Payload in Avalanche. For example: %Store Number% In the above example, the prompt on the device would ask the user for a "Store Number" as their password. |
Program/ |
A program/procedure that should run when the Client connects. |
Menu |
The name of the menu you want displayed when the Client connects. |
Current Library |
The name of a library the Client should navigate to when it connects. |
|
Prompts |
Responses |
Name |
The user name prompt that the host system uses. Possible Values: 0 - 60 alpha-numeric characters. To prompt a user for a specific user name, you can use a variable delineated by a %. For example: %Gun Number% The text included within the % indicators is the information that appears in the prompt on the device. In the above example, the prompt would ask the user for "Gun Number" as their user name. |
The response that the mobile device should send to the login prompt. Possible Values: 0 - 30 alpha-numeric characters. |
Password |
The password prompt that the host system uses. Possible Values: 0 - 60 alpha-numeric characters. To accept a variable value, you can use a value delineated by a % after enabling the Use prompt scheme when editing the host profile in TE or through the TE Host Profile Payload in Avalanche. For example: %Store Number% In the above example, the prompt on the device would ask the user for a "Store Number" as their password. |
The password that the mobile device should send to the host system at the password prompt. Possible Values: 0 - 30 alpha-numeric characters. |
Command |
The command prompt that the host system sends to the TE Client after the login is complete. |
The command that the mobile device should send the host system at the command prompt. Possible Values: 0 - 60 alpha-numeric characters. |
AutoLaunch Session |
The Client attempts to connect to the specified host each time the Client is launched. Only one host profile on the device should have autolaunch set. |
Server Language |
Sets the language used by the server. |
To configure a host profile from the device:
1 From the TE Client, tap Menu > Host Profiles.
2 If the password is required, type the password in the text box and tap OK. (The default password is system.)
3 Click Add New to create a new host profile, or tap the name of the existing host profile that you want to edit.
4 Configure the options as desired and tap Save.
5 Press the Back button to return to the main Client screen.
The topic was:
Inaccurate
Incomplete
Not what I expected
Other