Client Configuration Keywords
The PL/B Client Interface uses a program information file to specify its connection information. Below is a sample configuration file:
[Version]
PLBSERVE=86
[Environment]
PLBCS_PORTNUM=3933
PLBCS_HOSTNAME=63.162.221.37
Keywords with an associated value are placed in sections. The sections are indicated by surrounding the section name with square brackets. The [version] and [environment] sections are required and at a minimum should contain the keywords and values as follows:
The [version] section of the configuration file must contain the keyword PLBSERVE. Its value indicates the current version of the software.
The [Environment] section of the configuration file must contain two entries with the host connection information and any of the optional keywords:
|
Keyword |
Specifies ... |
|
the optional default delay seconds timeout. | |
|
the optional default auto retry count. | |
|
an alias for PLBCS_CMDLN. | |
|
the optional default command line executed when no command line parameters are given. | |
|
whether optional caching should be used or not. | |
|
the optional number of days a cached item will be retained if not used. | |
|
the optional directory in which cached items are stored. | |
|
the optional computer name for a CE device. | |
|
an optional user defined error message delay value. | |
|
an optional user defined error message. | |
|
the required host name or IP address. | |
|
the optional maximum number of in-memory cached items in a LRU list. | |
|
the optional maximum memory size in kilobytes of the in-memory cache. | |
|
to optionally disable generation of keep-alive messages. | |
|
PLBCS_LOCALIP |
the optional local IP address. |
|
the optional key used to encrypt log on identifications to and from all clients. | |
|
the optional keyword that limits the client virtual memory size. | |
|
the optional keyword that allows connection to one of several servers. | |
|
the required IP port number to use. | |
|
the optional key used to encrypt messages to and from all PLBCLIENT workstations. | |
|
the optional maximum time allowed where no messages are received from the server. | |
|
an optional user defined error message retry value. | |
|
optionally start the client service after installation. | |
|
the optional time to wait before taking the service failure action. | |
|
an optional descriptive string for the NT service. | |
|
the optional actions for client module failures. | |
|
the optional service restart capability. | |
|
optionally restricts the number of client processes. | |
|
an optional user defined error message title. | |
|
a user name for a Windows CE device. |
The [Environment] section of the configuration file may also contain the following runtime keywords. This allows a specific client to be configured without having the keywords at the server. Also, any of the following keywords specified in the PLBCLIENT INI take precedent over the same keyword specified in the server's ini file. The keywords are defined the the PLB Runtime Reference.
PLBWIN_PRTPREV
PLB_PRTTIME
PLB_PRTRETRY
PLB_PRTDEBUG
PLBWIN_SYSPORT
PLBWIN_ICON
PLBWIN_DOSCOLORS
PLBWIN_RTL
PLBWIN_FBOLD
PLBWIN_FSIZE
PLBWIN_FONT
PLBCE_TASKBAR (Windows CE ONLY!)
PLBWIN_NOHELP
PLBWIN_FILE
PLBWIN_EDIT
PLBWIN_HELP
PLBWIN_DOSFONT
PLBWIN_PRTSCR
PLBWIN_TERMINAL
PLBWIN_TERMINAL_DEBUG
See Also: PL/B Client Command Syntax, Manifest Files
|
|