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
*AKM Sets cell phone mode available on Vx810. Values are CP (cell
phone) or CLASSIC.
*APNAME In the ENHANCED UI, 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).
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.
*CPAD Time between key presses (cell phone mode). Value is between 0 - 10000, default is 1500 milliseconds (1.5 sec).
*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).
*DEBUG Sets viewing of OS debug trace.
*DEBUGO May be used to enable additional logging, but should not be used in production since they will rapidly fill the log.
SYSTEM CONFIGURATION FILE Environment Variable Descriptions
*DIAG Executes a diagnostic or key-loading program once in terminal VTM; 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.
*IPPMKI Sets communication parameters for internal PIN pad key loading from VTM.
*LOG May be used to reserve an area in the file system for a circular, memory-based log in kilobytes. The allowable range is between 50 and 1024.
*LOGP Enables selection of another serial port when retrieving system logs.
*MA This is used in ENHANCED mode. It's set when MULTI-APP download is chosen.
*MAXSEM Controls the total number of global semaphore.
*MAXSHM Controls the total number of active shared memory handles available in the system.
*MENUx Used to add menus to the VTM screen system.
*MENUxy Used to add menus to the VTM screen system.
*MERR Modem profile load error code.
*MN Modem configuration file name.
*OFF An automatic transition from idle (sleep) to OFF occurs if the unit is continuously idle for five minutes, OFF variable is set to adjust this time period.
*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
Table 14 CONFIG.SYS Environment Variables (continued)
Environment Variable Descriptions
*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 VTM password; password for the current group.
*SCTOUT Smart card time-out control. Value is 1 ms - 86400000 (1 day).
*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 VTM entry password.
*SMUI Indicates which VTM is in use. This can be set by selecting either ORIGINAL UI or ENHANCED UI from the VTM Menu 8 (or VTM Menu 4 on Vx670). This can also be edited directly.
The values are:
*TIME Number of system timers; default 10: used with set_timer().
*TMA Name of the Remote Diag to run.
*TURNOFF Number of second it takes to press the CANCEL key to turn off battery-powered units. Values range from a minimum of 1 second to a maximum of 9 seconds. Default is 4 seconds.
*TURNON Number of second it takes to hold the ENTER key to turn on battery-powered units. Values range from a minimum of 1 second to a maximum of 5 seconds. Default is 3 seconds.
*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
*USBCLIENT Determines the type of USB client device. This is allowed to have two values—HID and RS-232. If no value is defined for the *USBCLIENT environment variable, the default is set to HID for Trident terminals, and RS-232 for PIN pads.
*VALID List additional groups to search during file authentication for certificate and signature files using VeriShield.
*ZA ZonTalk application ID.
*ZB The max block size on download.
*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.
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.
Table 14 CONFIG.SYS Environment Variables (continued)
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.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 15 Verix eVo Device Handles
Device /dev Name <svc.h>
Variable Magnetic card reader /dev/mag DEV_CARD Real-time clock /dev/clock DEV_CLOCK
Beeper /dev/stderr DEV_BEEPER
Console (keypad and display)
/dev/console DEV_CONSOLE
COM port 1 /dev/com1 DEV_COM1
COM port 2 /dev/com2 DEV_COM2
COM port 3 /dev/com3 DEV_COM3
COM port 4/ Integrated thermal printer
/dev/com4 DEV_COM4
COM port 5 /dev/com5 DEV_COM5
COM port 6 /* com 6 */ DEV_COM6
COM port 8 /* com 8 */ DEV_COM8
COM port 9 /* com 9 */ DEV_COM9
COM port 10 /* com 10 */ DEV_COM10
Mag card /* mag card */ DEV_CARD
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[
USB host /* PP1000SE and Vx810 device */ DEV_USBSER
Semtek device driver
/* Semtek device driver */ DEV_SEMTEK
Customer smart card
SYSTEM CONFIGURATION FILE Environment Variables Application Information