User's Manual

ManualsBrandsNCR Corporation, RSD - Atlanta ManualsElectronicsElectronic Pricing Transmitter

Configuration Files

Overview

This appendix contains an example of each of the following

configuration files:

• Base Software Configuration file (basesw.cfg).

• Application Configuration file (esappl.cfg)

• CBS Parameter table (cbsparam.tbl)

• Measurement Units Configuration table (esmeasur.tbl)

• Serial Number Configuration table (eplserial.cfg)

• Log Monitor file Configuration (logmon.cfg)

• EPL Backup information file (eplbackup.ini)

• Status Tag Manager Configuration file (status.cfg)

In a default Windows NT system, these files are in the \epl\data\

directory. In a default NCR UNIX or SCO UNIX system, these files are

in the /appl/epl/data/directory.

Note: When a new version of DecisioNet software is installed, the

basesw.cfg, esappl.cfg, esmeasur.tbl, logmon.cfg, and status.cfg files

are installed in the samples directory. This prevents the existing files in

the data directory from being destroyed. If you want to replace the

existing configuration files with the new ones, copy the new files the

samples directory to the data directory and re-configure your system.

Note: When you modify the application parameters in EPL

Administration or the configuration files (*.cfg), stop EPL Applications

and restart EPL Applications so that the system acknowledges the

changes made to the configuration.

Summary of content (42 pages)

PAGE 1
C Configuration Files Overview This appendix contains an example of each of the following configuration files: • Base Software Configuration file (basesw.cfg). • Application Configuration file (esappl.cfg) • CBS Parameter table (cbsparam.tbl) • Measurement Units Configuration table (esmeasur.tbl) • Serial Number Configuration table (eplserial.cfg) • Log Monitor file Configuration (logmon.cfg) • EPL Backup information file (eplbackup.ini) • Status Tag Manager Configuration file (status.
PAGE 2
C-2 Configuration Files DecisioNet Windows NT Configuration Files The following sections show the default configuration files in a DecisioNet Windows NT system. Base Software Configuration File (basesw.cfg) The following is an example basesw.cfg file. It contains an explanation of each parameter in the file. Some parameters are set using the EPL Administrator configuration screens. Use an editor to set the CBSCOMM_PORT parameter from the DOS system prompt.
PAGE 3
Configuration Files #Specifies the time slots that are used for downlink # messages to an EPL. They are assigned as follows: # 0: 1,2,3,7,8,9 # 1: 4,5,6,10,11,12 # 2: 1,2,3 # 3: 4,5,6 # 4: 7,8,9 # 5: 10,11,12 # (0-5) [0] #"TIMESLOT_GROUP",0 #Specifies store identification # Mandatory field "STORE_ID", 100 #Specifies RS-232 device name # Mandatory. "CBSCOMM_PORT", "COM1" #Communication port speed # (9600) [9600] "CBSCOMM_SPEED", 9600 #Addresses of the connected CBS's. These addresses are # comma separated.
PAGE 4
C-4 Configuration Files # optimize threshold values [3.7] #"OPTFACTOR_SIGNALTHRESHOLD","3.7" #Standard deviation multiplier used for calculating maximum # amount of noise on an uplink [3.0] #"OPTFACTOR_NOISETHRESHOLD","3.0" #The period within which the Data Scheduler needs to send a LIVE # notice to the CBS Manager.
PAGE 5
Configuration Files #Range of serial #'s corresponding to tags where sumcheck # test for EPL error status turns on the H/W error bit. # Price update message for display register #2 and #3 # affects event time "EPLPTF_B", "10000, 15000" "EPLPTF_C", "10000, 15000" "EPLPTF_D", "10000, 15000" #Determines whether schaudit.log. log #files will be created in the data directory.
PAGE 6
C-6 Configuration Files ################################################# #IPC ################################################# #If set to YES then debug messages from the IPC code will be #displayed. [NO] #"ES_ENABLEIPCTRACING","NO" #YES to enable sockets IPC. Use for communication between # heterogeneous operating systems. Don't use with WIN95.
PAGE 7
Configuration Files "POWERB_ADDRESS" "POWERC_ADDRESS" "POWERD_ADDRESS" "POWERE_ADDRESS" "POWERF_ADDRESS" "POWERG_ADDRESS" "POWERH_ADDRESS" "POWERI_ADDRESS" "POWERJ_ADDRESS" #These parameters are set by ESADMIN, and define the addresses for # the master and alternate master CBSs "MASTER_ADDRESS" "ALTMASTER_ADDRESS" #These parameters are set by ESADMIN, and define how receive antennas # are configured "RECEIVEA_ADDRESS" "RECEIVEB_ADDRESS" "RECEIVEC_ADDRESS" "RECEIVED_ADDRESS" #These parameters define how fre
PAGE 8
C-8 Configuration Files #User defined actions go here "LOGMON_ALERTACTION1", "echo SW "LOGMON_ACKACTION1", "echo SW DOWN > c:\epl\data\STATMOD.001" OK > c:\epl\data\STATMOD.001" ################################################# #LOGGER ################################################# #The following parameter controls whether messages will be logged #to Storeminder.
PAGE 9
Configuration Files Application Configuration File (esappl.cfg) The Application Configuration file contains parameters that are defined by using the EPL Administrator Application Configuration screen. # # Amount of time to display a register. # 1 - .72 secs # 2 - 1.45 secs # 3 - 2.90 secs # 4 - 5.
PAGE 10
C-10 Configuration Files LOAD_EPL_LOGALL, 0 # # There are 3 options. NORMAL, ROUNDUP and TRUNCATE # NORMAL implies that the price/unit price will be rounded to the next whole # number if greater than .5 else it will be rounded down. # ROUNDUP implies that the price/unit price will be always rounded to the next # whole number. # TRUNCATE implies that the price/unit price will be truncated to the next # whole number.
PAGE 11
Configuration Files C-11 DISPLAY_ON_PURGE_DATA, " " # # When a tag is removed, what should be displayed on the tag. # 0 - Don't change anything. Keep whatever was displayed last. # 1 - Display the enunciators on the tag i.e. periods, commas, etc.
PAGE 12
C-12 Configuration Files # Whether or not the EURO symbol is displayed or not. # EURO_PRICING, 0 # # Filename for reports # EPL_TABLE_RPT_FILENAME, epltable.rpt BEDCHECK_LOG_RPT_FILENAME, esbedchk.rpt SAVE_SYSERROR_LOG_RPT_FILENAME, error.rpt SAVE_SENDLOG_RPT_FILENAME, send.rpt SAVE_AUDITLOG_RPT_FILENAME, audit.rpt SAVE_ADM_SYSERROR_LOG_RPT_FILENAME, error.rpt SAVE_ADM_SENDLOG_RPT_FILENAME, send.rpt SAVE_ADM_AUDITLOG_RPT_FILENAME, audit.rpt SAVE_ADM_FDA_RPT_FILENAME, esfda.
PAGE 13
Configuration Files C-13 Measurement Units Configuration Table (esmeasur.tbl) This table defines the measurement units available for selection on the Application Configuration screen. The following measurement units are the default values. Additional entries may be made using the format shown. The maximum number of entries is 99. 01,"OZ" 02,"LB" 03,"g" 04,"L" 05,"mL" 06,"Gal." 07,"QT" 08,"PT" 09,"CT" 10,"Kg" 11,"Pound" 12,"Quart" 13,"Pint" 14,"100 Units" 15,"50 Sq. Feet" 16,"100 Sq.
PAGE 14
C-14 Configuration Files Serial Number Configuration Table (eplserial.cfg) This table defines in hexadecimal numbers the serial number range for each EPL type. Note that EPL types 2, 4 and 6 are not shown in this table. That is because types 1 and 2, 3 and 4, and 5 and 6 are the same except that their price and unit price locations are reversed.
PAGE 15
Configuration Files C-15 Log Monitor Configuration File (logmon.cfg) The Log Monitor configuration file contains the information displayed in the Log Monitor modal dialog box and the Log Monitor report. The file can be edited to include site-specific error and corrective action information. Refer to Appendix D for details on customizing the Log Monitor functionality. # The EPL Log Monitor generates alerts based upon the contents of this # configuration file.
PAGE 16
C-16 Configuration Files ERROR, "EPL External Data Interface logged errors that could cause serious EPL system problems. Immediate investigation of these problems is recommended." [ESBRIDGE] ERROR, "EPL Bridge logged errors that are causing serious EPL software problems. Immediate investigation of these problems is recommended. Call NCR field personnel for assistance." [ESPLURDR] ERROR, "EPL PLU Reader logged errors that are causing serious EPL software problems.
PAGE 17
Configuration Files C-17 Call NCR field personnel for assistance." [ESFDA] WARNING, "EPL Failure Detection and Anaysis detected warnings that may lead to EPL system problems later. Investigation of these problems is recommended. Call NCR field personnel for assistance." ERROR, "EPL Failure Detection and Analysis detected errors that are causing serious EPL system problems. Immediate investigation of these problems is recommended. Call NCR field personnel for assistance.
PAGE 18
C-18 Configuration Files is running or not." 2103, "Unable to communicate with the EPL Table Manager. Check to see if the EPl Table Manager is running." 2500, "Promo Mismatch. (Meaning-A promotion change has been made to an item linked to an EPL but the change was not detected by the EPL system. This can be caused if EXTDI is not running or is running less frequently that the Promo Message Verifier)." 2701, "Communication link not established error message indicates that the CBS is not responding.
PAGE 19
Configuration Files C-19 configuration problem. Use the ESADMIN base config menu option to configure antenna C. 2719, "Receive antenna D off error message identifies a problem with receive antenna D or CBS receive antenna D port. The error may also occur when receive antenna D is improperly configured using ESADMIN. 2720, "Unconfigured receive antenna D error message indicates a hardware configuration problem. Use the ESADMIN base config menu option to configure antenna D.
PAGE 20
C-20 Configuration Files EPL Backup Information File (eplbackup.ini) This file identifies which files are backed up when the EPL Backup Utility is run. Wildcard (*) entries are used. Refer to the \epl\data\ directory following installation to determine which files are included in the backup. Additional files may be added. [Backup Files] C:\epl\data\esmeasur.tbl= C:\epl\data\labeldf.*= C:\epl\data\espasswd.*= C:\epl\data\EBATINF.*= C:\epl\data\EBATESL.*= C:\epl\data\esitem.* = C:\epl\data\*.tly= C:\epl\data
PAGE 21
Configuration Files C-21 EPL Status Tag Manager Configuration File (status.cfg) The Status Tag Manager uses this file to display system status information on EPLs. Refer to Appendix D for details about using this file with the Status Tag Manager. # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # EPL Status Tag Manager configuration file Each entry in this configuration file defines a message to be displayed on a SmarTalker status tag.
PAGE 22
C-22 Configuration Files [EPL SYSTEM] MODE, I EPLID, DEFAULT_MSG, "EPL" [EPL SYSTEM] MODE, I EPLID, DEFAULT_MSG, "SYSTEM" [EPL SYSTEM] MODE, A EPLID, DEFAULT_UPMSG, "HW DEFAULT_DOWNMSG, "HW IDLETIME, 300 OK" FAIL" [EPL SYSTEM] MODE, I FILENAME, "c:\epl\data\STATMOD.
PAGE 23
Configuration Files C-23 DecisioNet UNIX Configuration Files The following sections show the default configuration files in a DecisioNet UNIX system. Base Software Configuration File (basesw.cfg) The following is an example basesw.cfg file. It contains an explanation of each parameter in the file. Some parameters are set using the EPL Administrator configuration screens. Use an editor to set the CBSCOMM_PORT parameter from the DOS system prompt.
PAGE 24
C-24 Configuration Files #Specifies the time slots that are used for downlink # messages to an EPL. They are assigned as follows: # 0: 1,2,3,7,8,9 # 1: 4,5,6,10,11,12 # 2: 1,2,3 # 3: 4,5,6 # 4: 7,8,9 # 5: 10,11,12 # (0-5) [0] #"TIMESLOT_GROUP",0 #Specifies store identification # Mandatory field "STORE_ID", 100 #Specifies RS-232 device name # Mandatory. "CBSCOMM_PORT", "COM1" #Communication port speed # (9600) [9600] "CBSCOMM_SPEED", 9600 #Addresses of the connected CBS's.
PAGE 25
Configuration Files C-25 #Standard deviation multiplier used for calculating minimum uplink # signal strength. If this value is zero, the CBS Manager will not # optimize threshold values [3.7] #"OPTFACTOR_SIGNALTHRESHOLD","3.7" #Standard deviation multiplier used for calculating maximum # amount of noise on an uplink [3.0] #"OPTFACTOR_NOISETHRESHOLD","3.0" #The period within which the Data Scheduler needs to send a LIVE # notice to the CBS Manager.
PAGE 26
C-26 Configuration Files #Range of serial #'s corresponding to tags where the # CBS Manager must send a downlink burst for loading # data into display register #2 twice "EPLPTF_A", "10000, 15000" #Range of serial #'s corresponding to tags where sumcheck # test for EPL error status turns on the H/W error bit. # Price update message for display register #2 and #3 # affects event time "EPLPTF_B", "10000, 15000" "EPLPTF_C", "10000, 15000" "EPLPTF_D", "10000, 15000" #Determines whether schaudit.log.
PAGE 27
Configuration Files C-27 #Designates the number of EPL records processes at one time when description #changes are checked. [100] "LDM_RECORDS_NUMBER",100 ################################################# #IPC ################################################# #If set to YES then debug messages from the IPC code will be #displayed. [NO] #"ES_ENABLEIPCTRACING","NO" #YES to enable sockets IPC. Use for communication between # heterogeneous operating systems. Don't use with WIN95.
PAGE 28
C-28 Configuration Files "FDA_MAXNOISE", 80 #These parameters are set by ESADMIN, and define how power supplies # are configured "POWERA_ADDRESS" "POWERB_ADDRESS" "POWERC_ADDRESS" "POWERD_ADDRESS" "POWERE_ADDRESS" "POWERF_ADDRESS" "POWERG_ADDRESS" "POWERH_ADDRESS" "POWERI_ADDRESS" "POWERJ_ADDRESS" #These parameters are set by ESADMIN, and define the addresses for # the master and alternate master CBSs "MASTER_ADDRESS" "ALTMASTER_ADDRESS" #These parameters are set by ESADMIN, and define how receive antennas
PAGE 29
Configuration Files C-29 ################################################# #LOG MONITOR ################################################# "SVLOGMON_CMDLINE", "-m30 -h10" #Configure the Log Monitor to use the following editor #"LOGMON_EDITOR", "editor" #User defined actions go here "LOGMON_ALERTACTION1", "echo SW "LOGMON_ACKACTION1", "echo SW DOWN > c:\epl\data\STATMOD.001" OK > c:\epl\data\STATMOD.
PAGE 30
C-30 Configuration Files Application Configuration File (esappl.cfg) The Application Configuration file contains parameters that are defined by using the EPL Administrator Application Configuration screen. # # Amount of time to display a register. # 1 - .72 secs # 2 - 1.45 secs # 3 - 2.90 secs # 4 - 5.
PAGE 31
Configuration Files C-31 MEASUREMENT_TYPE, 1 # # Whether or not to log a message during an EPL Load. # 0 - Don't Log a message # LOAD_EPL_LOGALL, 0 # # There are 3 options. NORMAL, ROUNDUP and TRUNCATE # NORMAL implies that the price/unit price will be rounded to the next whole # number if greater than .5 else it will be rounded down. # ROUNDUP implies that the price/unit price will be always rounded to the next # whole number.
PAGE 32
C-32 Configuration Files DATE_FORMAT, mmddyy # # Decimal symbol (. or ,) # DECIMAL_SYMBOL, "." # # When a tag is purged, what should be displayed on the tag. # 0 - Don't change anything. Keep whatever was displayed last. # 1 - Display the enunciators on the tag i.e. periods, commas, etc. # 2 - Display the configured text on the tag # DISPLAY_ON_PURGE,0 DISPLAY_ON_PURGE_DATA, " " # # When a tag is removed, what should be displayed on the tag. # 0 - Don't change anything. Keep whatever was displayed last.
PAGE 33
Configuration Files C-33 # RANDOM_WEIGHT_PRICE_DISPLAY,0 # # Do items stored in the POS PLU file contain a check digit or not? # 0 - Items don't include a check digit # 1 - Items include a check digit # PLU_EAN_CHECK_DIGIT,0 # # When decimal place is less than 2 for parameter # determines whether to display a space after the decimal # position or display unit price to two # 0 - Display unit price to two decimal # 1 - Display a space # MAX_ONE_UP_DEC_POS_FOR_CENTS, 0 the EURO tag, this in the second place
PAGE 34
C-34 Configuration Files 225, 170, 183, 152, 29, 86, 147, 175, 267, 188, 218, 131, 276, 9, 32, 124, 158, 251, 108, 266, 151, 253, 182, 115, 196, 124, 143, 208, 17, 235, 28, 49, 111, 109, 99, 116, 233, 254, 219, 161, 119, 278, 83, 36, 2 "MINSIGNAL", 60.86, 56.01, 52.56, 50.09, 48.33 "MAXNOISE", 53 Measurement Units Configuration Table (esmeasur.tbl) This table defines the measurement units available for selection on the Application Configuration screen.
PAGE 35
Configuration Files C-35 Log Monitor Configuration File (logmon.cfg) The Log Monitor configuration file contains the information displayed in the Log Monitor modal dialog box and the Log Monitor report. The file can be edited to include site-specific error and corrective action information. Refer to Appendix D for details on customizing the Log Monitor functionality. # The EPL Log Monitor generates alerts based upon the contents of this # configuration file.
PAGE 36
C-36 Configuration Files ERROR, "EPL External Data Interface logged errors that could cause serious EPL system problems. Immediate investigation of these problems is recommended." [ESBRIDGE] ERROR, "EPL Bridge logged errors that are causing serious EPL software problems. Immediate investigation of these problems is recommended. Call NCR field personnel for assistance." [ESPLURDR] ERROR, "EPL PLU Reader logged errors that are causing serious EPL software problems.
PAGE 37
Configuration Files C-37 Call NCR field personnel for assistance." [ESFDA] WARNING, "EPL Failure Detection and Anaysis detected warnings that may lead to EPL system problems later. Investigation of these problems is recommended. Call NCR field personnel for assistance." ERROR, "EPL Failure Detection and Analysis detected errors that are causing serious EPL system problems. Immediate investigation of these problems is recommended. Call NCR field personnel for assistance.
PAGE 38
C-38 Configuration Files is running or not." 2103, "Unable to communicate with the EPL Table Manager. Check to see if the EPl Table Manager is running." 2500, "Promo Mismatch. (Meaning-A promotion change has been made to an item linked to an EPL but the change was not detected by the EPL system. This can be caused if EXTDI is not running or is running less frequently that the Promo Message Verifier)." 2701, "Communication link not established error message indicates that the CBS is not responding.
PAGE 39
Configuration Files C-39 configuration problem. Use the ESADMIN base config menu option to configure antenna C. 2719, "Receive antenna D off error message identifies a problem with receive antenna D or CBS receive antenna D port. The error may also occur when receive antenna D is improperly configured using ESADMIN. 2720, "Unconfigured receive antenna D error message indicates a hardware configuration problem. Use the ESADMIN base config menu option to configure antenna D.
PAGE 40
C-40 Configuration Files /appl/epl/data/*.log= /appl/epl/data/*.cfg= /appl/epl/data/*.tly= /appl/epl/data/*.tbl= /appl/epl/data/tblaudit.* /appl/epl/data/schaudit.* /appl/epl/data/eplbackup.ini= /appl/epl/data/labeldf.*= /appl/epl/data/espasswd.*= /appl/epl/data/ebatinf.*= /appl/epl/data/ebatesl.*= /appl/epl/data/esitem.
PAGE 41
Configuration Files C-41 EPL Status Tag Manager Configuration File (status.cfg) The Status Tag Manager uses this file to display system status information on EPLs. Refer to Appendix D for details about using this file with the Status Tag Manager. # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # EPL Status Tag Manager configuration file Each entry in this configuration file defines a message to be displayed on a SmarTalker status tag.
PAGE 42
C-42 Configuration Files [EPL SYSTEM] MODE, I EPLID, DEFAULT_MSG, "EPL" [EPL SYSTEM] MODE, I EPLID, DEFAULT_MSG, "SYSTEM" [EPL SYSTEM] MODE, A EPLID, DEFAULT_UPMSG, "HW DEFAULT_DOWNMSG, "HW IDLETIME, 300 OK" FAIL" [EPL SYSTEM] MODE, I FILENAME, "/appl/epl/data/STATMOD.