Descriptions
Table 14 lists the currently available Group 1 CONFIG.SYS environment variables and their descriptions. Environment Variables Application Information further discusses variable usage. CONFIG.SYS files residing in other groups are for application use only.
Table 14 CONFIG.SYS Environment Variables
Variable Description
*APNAME In the ENHANCED UI (new system mode), this is the name of the application residing in a GID.
Note: During FULL download, *APNAME is displayed in the confirmation process. If *APNAME is not defined, APPLICATION is displayed, instead.
*ARG Arguments for the startup application specified in *GO.
*B Sets the number of communication buffers.
Minimum is 1; maximum is 256 (default).
*BCM Sets the Backward Compatibility Mode used on Vx670 terminals. This allows the legacy 8-line display applications to use the larger 16-line display terminal without modification.
The values are:
CHKSUM Disables checksum verification on startup.
CHKSUM = 2 checksum disabled; default is checksum enabled.
*COMBO Sets the application group to use a modem or TCP/IP.
0=modem,1=TCP/IP
COM2HW If this variable is not present, OS performs default module detection at power up. If the variable is present, the OS uses this value as the value represents the type of modem installed and bypasses the module detection process.
Note: The value of this variable is erased by full downloads as it is an ordinary variable, this forces re-detection of the module when the module is replaced.
COM3HW If this variable is not present, the OS performs default module detection at power up. If the variable is present, the OS uses this value as the value that represents the type of modem installed and bypasses the module detection process.
Note: The value of this variable is erased by full downloads as it is an ordinary variable, this forces re-detection of the module when the module is replaced.
0 = Backward compatibility is set to OFF (default).
1 = Sets the application in lines 5-12, without arrow extensions.
2 = Like 1, but with arrow extensions at the bottom of the screen.
SYSTEM CONFIGURATION FILE
Environment Variable Descriptions
*COM2RB Indicates the size of the asynchronous receive buffer on COM2 only. If this variable doesn’t exist, the default size (1024 bytes) is taken.
Note: The buffer size ranges from 1024 to 8192 bytes. If any value is specified outside this range, the default value is used.
*COM3RB Indicates the size of the asynchronous receive buffer on COM3 only. If this variable doesn’t exist, the default size (1024 bytes) is taken.
Note: The buffer size ranges from 1024 to 8192 bytes. If any value is specified outside this range, the default value is used.
*DARK Sets the scale factor for the print strobe activation time to compensate for different types of thermal papers.
*DBMON Configures the baud rate for the debug monitor (in the form pb).
Valid values for p are 0–2, setting the COM port; default is 1 (COM1). Valid values for b are 0–13; default is 9 (115,200 kbps).
Baud rate setting is ignored when configured for USB (p = 0).
*DEFRAG Sets automatic flash defragmentation on terminal power up.
*DIAG Executes a diagnostic or key-loading program once in terminal system mode; allows a diagnostic program to run once when security is preventing access.
*DOT0a Indicates the maximum number of dots to print per strobe when the nRAD_HPWR signal line is low.
Note: This variable does not apply to Vx670.
*DOT1a Indicates the maximum number of dots to print per strobe when the nRAD_HPWR signal line is high.
Note: This variable does not apply to Vx670.
*FA When this variable is set to 1, all signature files are retained in terminal memory; default is 1.
*FILE Maximum number of files that can be open simultaneously.
Minimum is 10; maximum is 224; default is 30.
*GO File Group 1 application filename to execute.
*GKE Indicates the type of event that has to be generated when the user has pressed green key.
Table 14 CONFIG.SYS Environment Variables (continued) Variable Description
Environment Variable Descriptions
*OFFD Indicates the amount of time that OS will delay between receiving the SVC_SHUTDOWN call and powering down the terminal. This variable is read on system restarts or reboots.
The range is 2 seconds (default) to a maximum of 60 seconds.
*PIPE Controls the number of pipe handles available.
Minimum is 0; maximum is 256 (default).
*POW Specifies the number of milliseconds needed to achieve SLOW MODE (sleeping) state which involves a sustained period of idleness for applications and drivers.
*PRNT If set to zero in group 1, will prevent download errors from printing.
*PRTFNT Specifies the amount of SRAM allocated for printer font tables (in 1-KB increments). The range is 0 to 256, and the default is 64.
*PRTLGO Specifies the amount of SRAM allocated for printer logos (in 12-KB increments). The range is 0 to 10, and the default is 1.
*PW Group access system mode password; password for the current group.
*SMDL Enables poll-for-direct download during the start-up sequence before displaying the copyright screen.
*SMGIDS Used in ENHANCED download UI to store a comma-separated list of GIDS. It is the list that is last chosen by the user during a FULL MULTI-APP download for application deletion. This can be edited by the user.
Example:
*SMGIDS = 1,3,5,11
*SMPW System mode entry password.
*SMUI Indicates which system mode is in use. This can be set by selecting either ORIGINAL UI or ENHANCED UI from the System Mode Menu 8 (or System Mode Menu 4 on Vx670). This can also be edited directly.
The values are:
*TIME Number of system timers; default 10: used with set_timer().
*UNZIP Group 1 CONFIG.SYS file. Automatic decompression of only one archive.
If *UNZIP is set, the zip archive automatically decompresses at startup.
UNZIP Limited results about the file decompression process can be obtained using the variable UNZIP in CONFIG.SYS, which is set to 0 when UNZIP.OUT starts, and to 1 on successful
conclusion.
Table 14 CONFIG.SYS Environment Variables (continued) Variable Description
0 = ORIGINAL (default).
1 = ENHANCED.
SYSTEM CONFIGURATION FILE
Environment Variable Descriptions
*USBMEM Specifies the amount of memory reserved for buffer space. By default the memory reserved is 16KB.
*VALID List additional groups to search during file authentication for certificate and signature files using VeriShield.
*ZA ZonTalk application ID.
*ZP ZonTalk host telephone number; can use embedded dialing control characters.
Note: This variable is used to hold phone numbers for modem downloads, where as for TCP/IP downloads it holds the IP address and port number of the VeriCentre host. The *ZP variable should be assigned
appropriately prior to selecting either modem or TCP/IP download.
*ZT ZonTalk terminal ID.
*ZINIT External modem initialization string.
Default is ATM0V0&D2.
• V0 - sets terse mode (numeric responses),
• &D2 - drop DTR to hang up.
*ZRESET External modem reset string.
Default is ATZ0.
*ZRESP External modem connect response.
Default is CONNECT 2400.
*ZSWESC External modem flag to use ‘+++’ to escape into command mode, rather than DTR transitions.
Default is DTR.
*ZTCP Specifies the name of an application file to run at the time of TCP/IP download.
*ZX If this variable is not present and has a value other than 1, the terminal retains the last download message on the screen (including “COMM ERRORS”, “APPLICATION NOT FOUND”,
“INVALID TERMINAL ID” or other VeriCentre messages). If the variable is present and *ZX=1, it subsequently checks for the existence of the message “DOWNLOAD DONE” in the final message packet sent from the download host. It reboots without waiting for the user to press a key.
Table 14 CONFIG.SYS Environment Variables (continued) Variable Description
Environment Variable Descriptions
Device Variables For convenience, the system library defines a set of global variables containing device names. Use these variables in place of previous /dev names. The device names and corresponding handles are shown in Table 15.
*CPAD When the Vx810 operates in cell phone alpha mode, the OS translates the repeated key presses that take place within 1.5 seconds of each other (default) to the next alpha character in the alpha shift sequence for that key. If a key is pressed more than 1.5 seconds after the last, the OS returns the key as input Additional variables Terminals can include several other CONFIG.SYS variables.
Also, the application can create several application-specific variables. Consult your application specification for additional CONFIG.SYS variable definitions. Remember that the *name convention is used by system variables. Use the # character to preserve a variable between downloads.
a. This variable does not apply to Vx670.
On Vx810, the application may set the battery and power CONFIG.SYS variables but they do not affect the Vx810 platform.
Table 14 CONFIG.SYS Environment Variables (continued) Variable Description
Barcode reader /* bar code reader */ DEV_BAR
MSO300 Biometric /* MSO300 Biometric device*/ DEV_BIO
CTLS /* Contactless device */ DEV_CTLS
USB keyboard /* USB Keyboard HID converted to make and break code*/
DEV_KYBD[
SYSTEM CONFIGURATION FILE
Environment Variables Application Information