Configuring Client Settings

The Studio Client uses a configuration file named wlclient.cfg to configure the Studio Client settings. This is a text file that resides in the Studio Client install folder.

If you use Wavelink Avalanche to install the Client, use the Studio Settings configuration utility to the settings in the wlclient.cfg. Otherwise, use a text editor such as Notepad to open and edit the configuration file.

The following text shows an example of a wlclient.cfg file.

[WLClient.cfg]
AllowExit=1
AutoLaunchAppIP=192.168.3.5
AutoLaunchAppPort=1079
AutoLaunchAppToken=
ConnectOutOfRange=Out of Range
ClearOnOpen=1
EnableLogging=0
ExitKey=0
ExitOnDisconnect=0
HideFullScreen=1
IncludeDataOnWidget=0
InitialFullScreen=0
InitialMenuHidden=0
LogFileName=wlclient.log
OsHandleAppKeys=0
OutOfRangeString=Roaming...
SilentMode=0
TCPAutoConnectSession=0
WavelinkDeviceID=3042
Wrap=0

Different settings may be available on different device models. The following table lists some of the settings that are supported in the configuration file:

ActionKeyAsEnter

Specifies if the Action key can be used as Enter. The default value is 0. The possible values are:

0 - Disabled
1 - Enabled

AllowExit

Specifies if the Exit command is available from the Client menu bar. The default value is 1. The possible values are:

0 - Disabled
1 - Enabled

AutoLaunchAppIP

Specifies the IP address of a host to which the Client will try to connect at startup. This value is not configured by default. AutoLaunchAppPort and AutoLaunchAppIP must be used together.

AutoLaunchAppPort

Specifies the port at the AutoLaunch host to which the Client will try to connect at startup. This value is not configured by default. AutoLaunchAppPort and AutoLaunchAppIP must be used together.

AutoLaunchAppToken

Specifies the name of an application to which the Client will try to connect at startup. This value is not configured by default. Do not use this setting with AutoLaunchAppPort and AutoLaunchAppIP.

ClearOnOpen

Specifies if the session log is cleared each time you run the Client. The default value is 1. The possible values are:

0 - Disabled
1 - Enabled

ConnectOutOfRange

Specifies the message displayed when the Client attempts to connect to a host when the device is outside of wireless network coverage. The default message is:

Out of Range

DisableUserConfig

Used in conjunction with UserConfigPassword to password protect the configuration options within the Studio Client. When enabled, the terminal configuration options can only be accessed by entering the password (the value entered for UserConfigPassword). The default value is 0. The possible values are:

0 - Disabled
1 - Enabled

DiscoveryPort

Specifies the port which the Client uses for AutoDiscovery. The default port is 905, using both Wavelink Studio 3.6-3.8 and 4.1 AutoDiscovery.

To use Studio 3.6-3.8 AutoDiscovery only, set the port value to 902.

To use Studio 4.1 AutoDiscovery only, set the port value to any other value that matches the AutoDiscovery port on the host.

EnableLogging

Specifies if all communication between the Client and the host is saved in the session log. The default value is 0. The possible values are:

0 - Disabled
1 - Enabled

ExitKey

Specifies the ASCII value of a key used to exit the session at a menu. Not configured by default.

For example:
ExitKey=32

When the spacebar is pressed at a menu screen, the session will close.

ExitOnDisconnect

Specifies if the client will exit when the connection with the server is lost. The default value is 0. The possible values are:

0 - Disabled
1 - Enabled

FontName

Specifies the font family for display text. The specified font must be one of the system fonts.

For example:
FontName=Courier New

FontSize

Specifies the font size (in points) for display text. Not configured by default.

HideFullScreen

Specifies if the option to toggle full screen mode appears in the Client menu bar. The default value is 0. The possible values are:

0 - Disabled (user cannot toggle full screen mode)
1 - Enabled (user can toggle full screen mode)

HideMenuKey

Specifies the ASCII value of a key that shows and hides the Client menu bar (including the virtual keypad) when pressed in an application.

For example:
HideMenuKey=9

The Tab key will toggle the menu bar.

IncludeDataOnWidget

Specifies if data from the RFInput field is included with the widget if you are using both widgets and RFInput at the same time. The default value is 0. The possible values are:

0 - Disabled
1 - Enabled

InitialFullScreen

Specifies if the client starts in full screen (hiding the Windows Start menu) mode. The default value is 0. The possible values are:

0 - Disabled
1 - Enabled

InitialMenuHidden

Specifies if the menu bar and virtual keypad are available to the user within a Client application. The default value is 0. The possible values are:

0 - Disabled (unavailable)
1 - Enabled (available)

LogFileName

Specifies the complete path, including the file name, for the session log. The default value is wlclient.log.

For example:
LogFileName=\temp\test.log

NumColumns

Specifies the number of text columns. This property is used to define text size and is only valid when FontSize is not configured. Not configured by default.

NumRows

Specifies the number of text rows. This property is used to define text size and is only valid when FontSize is not configured. Not configured by default.

OSHandleAppKeys

Specifies if the Client will take over the application keys on the device. Disabled by default. The possible values are:

0 - Disabled
1 - Enabled

OutOfRangeString

Specifies the message to appear when the Client attempts to send data to the host but is outside of wireless network coverage. The default message is:

Roaming...

ShowBlankMenu

Specifies if the Client menu bar is accessible.The default value is 0. The possible values are:

0 - Disabled
1 - Enabled

ScanAheadMode

Determines is the scanner is disabled between individual GetEvent or RFInput calls. The possible values are:

0 = Disables scanner between calls.
1 = Scanner enabled between calls and scans are buffered, but cleared if widgets are changed.
2 = Scanner enabled between calls and scans are buffered.

SilentMode

Specifies whether to enable or disable audio capabilities on the mobile device. The default value is 0. The possible values are:

0 - Disables silent mode (enables audio)
1 - Enables silent mode (disables audio)

TCPAutoConnectSession

Specifies if the Client automatically attempts to reconnect to the host after a connection is closed. The default value is 0. The possible values are:

0 - Disabled
1 - Enabled

UserConfigPassword

Specifies the password for entering the terminal configuration menu when DisableUserConfig is enabled. This value is not configured by default.

For example:
UserConfigPassword=cfg

WavelinkDeviceID

The unique identifier returned by a request for the mobile device type. These identifiers are defined by Wavelink. Do not change this value.

Wrap

Specifies if display text that exceeds the width of the screen wraps to the next line. The default value is 1. The possible values are:

0 - Disabled (does not wrap text)
1 - Enabled (wraps text)

 


Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other

Privacy and Legal