A host profile defines the settings that the Velocity 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, or other settings. You may configure an unlimited number of host profiles from the device or through the Velocity Console.
When a device user attempts to initiate a session with a host, the Velocity Client displays a list of available host profiles. The user selects the host he wants to connect to, and the Velocity Client uses the host profile settings to connect to the host.
Depending on the emulation type, different options are available when configuring a host profile. The following options are available when you configure a host profile in the Velocity Client:
The IP address or host name of the host system to which the mobile device will connect. You can specify a URL (e.g., http:// or https://) or file name (e.g., file://).
Port
The TCP port number on which the host system is listening for emulation requests from Clients. By default, the port is set to 23. When Use SSH or Use SSH Tunnel is selected, the default port is changed to 22.
Type
The emulation type that the mobile device uses when connected to the host system.
Server Language
Allows the Client to interpret international characters from a specific codepage. The default for this setting is 37 IBM EBCDIC for 5250/3270 emulations and DEC VT (this option is not located on the drop-down) for VT emulations.
Workstation ID
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. It supports the following variables:
•%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.
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.
This option is only available to IBM emulation types.
Retry Workstation ID
Allows the Velocity Client to retry the workstation ID with a letter appended to it.
Native Mode
Forces the Velocity Client to display screens in Native Mode (black and green screen) when a user connects to this host profile. If this option is not selected, the Client's HTML rendering engine is used to update the appearance of screens.
Auto Carriage Return
Automatically applies the Enter or Send function after a menu option is selected from the Velocity Client.
Enable Logging
Enables the creation of a log file on devices using this project on the Velocity Client. The logging file allows for more in-depth troubleshooting by Ivanti support personnel. This file is stored on the device in the com.wavelink.velocity folder.
Log File Max Size (kB)
The maximum allowable size for the log file before the oldest entries are automatically removed. This cannot be altered unless Enable Logging is set to Yes. By default, this is set to 1024 kilobytes.
The user name prompt that the host system uses. 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 - 60 alpha-numeric characters.
Password
The password prompt that the host system uses. 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 Velocity or through the Velocity Console. 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 - 60 alpha-numeric characters.
Program/Procedure
Menu
Current Library
Command
The command prompt that the host system sends to the Velocity 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.
The IP address or host name of the licensing server. If the devices are on the same local network as the licensing server, the address does not need to be specified as the Client will actively broadcast and find the server.
Port
The TCP port number on which the License Server is listening for license requests from Clients. By default, the port is set to 1820. This field cannot be set until a License Server Address is specified.
Site ID
The site ID associated with the License Server. This field cannot be set until a License Server Address is specified.
Site IDs are set as part of the License Server's initial setup. For more information, see the Terminal Emulation License Server Reference Guide on the Ivanti Web site.
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. When this option is selected, the Auto Login User and Auto Login Password fields appear and must be filled out and the Port field is changed to 22.
This setting requires a public key to authenticate against the SSH server. The public key can only be associated with a host profile from the Velocity Console application.
You can only select this option or Use SSH Tunnel, but not both.
Use SSH Tunnel
Sets whether or not to use SSH tunneling. If you are using 5250 emulation with SSH, you must use SSH tunneling. When this option is selected, the Auto Login User, Auto Login Password, Tunnel Address, and Tunnel Port fields appear below and the Port field is changed to 22.
This setting requires a public key to authenticate against the SSH server. The public key can only be associated with a host profile from the Velocity Console application.
You can only select this option or Use SSH, but not both.
Auto Login User
The username for accessing the SSH server.
This option is only available when Use SSH or Use SSH Tunnel is selected.
Auto Login Password
The password associated with the SSH username.
This option is only available when Use SSH or Use SSH Tunnel is selected.
Tunnel Address
The IP address or host name for the SSH tunnel.
This option is only available when Use SSH Tunnel is selected.
Tunnel Port
The TCP port number associated with the Tunnel Address for SSH tunneling.
This option is only available when Use SSH Tunnel is selected.
Uses SSL 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 SSL. When this option is selected, the Port field is changed to 992.
This option cannot be enabled if Only Use ConnectPro connections is selected.
Indicates whether the Velocity Client should only connect to the host through a ConnectPro server. If you enable this checkbox, you cannot select the Use SSL setting in the SSL Settings section.
Type
The version number of the ConnectPro 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 ConnectPro Session
Indicates when the ConnectPro server should terminate the connection to the host.
Possible values include:
•Never. The proxy server never terminates the session established with the host. The Client is responsible for manually terminating the session.
•OnNetworkError. The proxy server terminates the session with the host when a network error occurs, such as a loss of network connectivity.
•OnSessionExit. The proxy server terminates the session with the host when the session is terminated by the Velocity Client. By default, this option is selected.
•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 Velocity 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. By default, this is set to Yes.
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.
Use Custom Encryption
Uses a Ivanti custom encryption method to encrypt the connection to the ConnectPro server. When you use custom encryption, provide an encryption key in the Key field below.
Key
Specifies a custom encryption key.
To add a host profile
1.Tap the Add button in the top-right corner of the screen.
2.Configure the host profile as desired.
3.Tap the Back button on your device
4.Tap Yes on the Confirm Changes dialog to save the host profile.
5.Tap the host profile from the Host Profiles screen to connect.
To edit a host profile
1.From the Host Profiles screen, tap and hold a host profile.
The Modify Host Profile dialog appears.
2.Tap Edit.
3.If a password is required, type the password in the text box and tap OK. (The default password is system.)
4.Edit the host profile as desired.
5.Tap the Back button on your device to save the changes.
6.Tap the host profile from the Host Profiles screen to connect.
To delete a host profile
1.From the Host Profiles screen, tap and hold a host profile.
2.If a password is required, type the password in the text box and tap OK. The default password is system.