NCR RSD Atlanta 7730GAI Electronic Pricing Transmitter User Manual Manual Chapter 6

NCR Corporation, RSD - Atlanta Electronic Pricing Transmitter Manual Chapter 6

Manual Chapter 6

Chapter 6: Configuring the DecisioNet SystemEnvironmentOverviewThis chapter describes how to configure the DecisioNet Systemenvironment after the software is installed. Configuration isaccomplished using an ASCII editor, such as Windows Notepad, andediting the parameters in the configuration files listed below. All ofthese files are located in the /dnet/data directory followinginstallation.• DecisioNet CBS Configuration files (dncbsconfig.xml)• DecisioNet Configuration File (dnconfig.xml)• DecisioNet Host Bridge Conguration file (dnhostbridge.xml)• DecisioNet Task Manager Configuration file (taskman.cfg)Three of these files are in XML format. XML is a mark-up language thatenables different programs to understand the structure of a file. Thisfacilitates the exchange of information between programs. Whenediting these XML format files, care must be taken to only modify theparameter or option setting.The fourth file listed is the Task Manager file. This is not an XMLformat file, but still may be modified using an ASCII editor. Details areprovided in the following sections on how to access and changeparameters in these files.6
6-2 Chapter 6: Configuring the DecisioNet System EnvironmentXML File FormatXML files use element tags to identify the specific entries or sectionswithin the file. It is very important that the element tags not bemodified. When changing parameters with an ASCII editor, you needto locate the parameter in the file and change the parameter setting toone specific to your site. The following shows the first part of theDecisioNet Configuration file (dnconfig.xml). The shaded areasidentify the formatting information that should not be changed.<?xml version="1.0"?><!DOCTYPE config SYSTEM "dnconfig.dtd"><config> <section name="Ipc"> <!-- <param name="ServerIP">127.0.0.1</param> --> <param name="TraceLevel">0</param> </section> <!-- ************************************************************ --> <!-- * LogTally Manager Configuration parameters * --> <!-- ************************************************************ --> <section name="LogTally Manager"> <!-- Section: LogTally Manager --> <!-- --> <!-- SystemLogging --> <!-- --> <!-- Specifies whether or not to log to the OS system log. d --> <!-- --> <!-- Values: Y(yes) or N(no) --> <!-- --> <!-- Default = Y (yes) --><param name="SystemLogging">Y</param>Identifying a Parameter in an XML Format FileAll information inside of a greater than (<) and less than (>) symbol ispart of the mark-up language and should not be changed. Only theparameter entry can be changed and still have the file functionproperly. A parameter entry is identified as follows:<param name="SystemLogging">Y</param>
Chapter 6: Configuring the DecisioNet System Environment 6-3Notice the parameter that may be changed is pointed to by the endingless than symbol (>) of the parameter name tag and the beginninggreater than symbol (<) or the parameter close tag (</param>). In thisexample, the parameter that can be changed is the bolded Y character .Commented InformationComments are identified with comment tags, <!-- at the start of aline and --!> at the end of the line. Some parameters arecommented out as is shown in for the ServerIP parameter in theprevious example. Before you can use a commented out parameter,you must remove the comment tags at both ends of the line.Using an Editor to Locate a ParameterThis section described how to use Notepad to open the DecisioNetConfiguration file (dnconfig.xml) and use the search option to locateand change a specific parameter.1. Click the Start icon at the bottom left of the screen.2. Select Programs > Accessories > Notepad.3. In Notepad, select File > Open…4. Use the Open dialog to locate the dnet/data directory.5. Use the drop down arrow and change the Files of Type: selectionto All Files (*.*).6. Select the dnconfig.xml file and click Open.7. Select Search > Find… and then enter the parameter name youwant to locate and change in the Search dialog Find What: entrybox.8. Click the Find Next button.If you locate the parameter name in the comments area of theparameter you are looking for, click the Find Button again. Forexample, if you searched for MaxNumberUpdateRetries, theparameter name entry that you are looking for would look asfollows:
6-4 Chapter 6: Configuring the DecisioNet System Environment<param name="MaxNumberUpdateRetries">10</param>9. Edit the parameter as needed and click File > Save to save thechange.Configuration File CommentsConfiguration files contains comments to describe each parameter. Thefollowing example shows the "Maximum Number of Bedcheck Retries"parameter from the ESL Manager section of the DecisioNetConfiguration file.<!-- Section: ESL Manager --> <!-- --> <!-- MaxNumberBedcheckRetries --> <!-- --> <!-- Maximum number of times an Bedcheck request is retried --> <!-- at the ESL Manager level when errors occur. After --> <!-- retries are exhausted, spool record is marked with last --> <!-- error received. The record is always retried so that --> <!-- both the minimum number of retries have been done and so --> <!-- that the minimum retry period has elapsed, but retrying --> <!-- stops when either the maximum number of retries have --> <!-- have been done or the maximum retry period has elapsed, --> <!-- whichever comes first. --> <!-- --> <!-- Values: non negative integer --> <!-- --> <!-- default = 10 --> <param name="MaxNumberBedcheckRetries">10</param>All of the configuration file parameters and their defaults are listed inthis chapter to assist you to search, locate and change site-specificparameters.Refer to Appendix B: DecisioNet Configuration Files and read the specificparameter comment section for details about each parameter.
Chapter 6: Configuring the DecisioNet System Environment 6-5Setting Performance Boost in Windows NT 4.0Following installation, set the foreground and background applicationsto get equal time.1. Select the Control Panel from the Settings menu from the Starticon.2. Choose the System icon.3. Click on the Performance tab.4. Slide the Boost Selector to “None” to indicate “No PerformanceBoost.”5. Click on Apply to accept these changes.6. Click on OK in the Performance Dialog Box.7. Close the Control Panel.Configure the system as described in this chapter, beginning with thesection “Configuring the CBS Communications.”
6-6 Chapter 6: Configuring the DecisioNet System EnvironmentConfiguring the DecisioNet SystemAfter installing new software, you must configure the followingDecisioNet System parameters for your store's environment:• CBS address configuration• Site-specific DecisioNet software application configurationCBS ConfigurationDecisioNet 3.0 uses Ethernet to communicate with CBSs installed atyour site. Each CBS must have a unique number and host name or IPaddress specified in the DecisioNet CBS Configuration file(dncbsconfig.xml). Refer to the "CBS Hardware Configuration"section in Chapter 3, Installing the Hardware Infrastructure for detailsabout setting IP addresses and host names.HostnameThe hostname format is as follows:ncrdnetnnnnnn.<domain>where:nnnnnn is the last 6 digits of the MAC address that is listed on theserial number label of the CBS.IP AddressThe IP address format is as follows:xxx.xxx.yyy.zwhere, depending on the type of IP adressing:xxx represents network IDsyyy is the subnet IDz is the host ID
Chapter 6: Configuring the DecisioNet System Environment 6-7A unique number (1-99) is assigned to the CBS during RFinfrastructure installation as described in the CBS Installation section ofChapter 3 in this guide. Whether you use a hostname or IP address isdetermined by the type of Ethernet environment in your store.Static IP AddressingFor stores that use static IP addressing, a block of addresses areassigned to the site. Check with the local IT Administrator concerningthe network addressing scheme used in the store. Unique IP addressare selected from the site block to identify each CBS used at the site.Dynamic IP AdressingFor sites that use a DHCP Server and use Auto DNS to dynamicallyassign IP addresses, hostnames would be used to identify the CBSsused at the site.Setting CBS ParametersUse an ASCII text editor as described earlier in this chapter to open theDecisioNet CBS Configuation File (dncbsconfig.xml). The defaultfile looks as follows:<?xml version="1.0"?><!DOCTYPE cbsconfig SYSTEM "dncbsconfig.dtd"><cbsconfig><cbs><id>1</id><hostname>ncrdnetnnnnnn.atlantaga.ncr.com</hostname></cbs></cbsconfig>1. Depending on the number of CBSs that you have at your site, copyand paste the outlined section of the file to create a <cbs> section foreach CBS.
6-8 Chapter 6: Configuring the DecisioNet System Environment2. Edit the <id> parameter to identify a unique number (1-99) for eachCBS.3. Edit the <hostname> parameter to identify the IP address anddomain name, or a host name and domain name for each CBS.4. Save the file.CBS Number CBS MAC Address1 08000E382EE711 08000E383B4512 08000E39412E13 08000E39C245For example, if your site had a domain name of STORENET and CBSsinstalled as shown in the table above, the DNCBSCONFIG.XML filewould be as follows:<?xml version="1.0"?><!DOCTYPE cbsconfig SYSTEM "dncbsconfig.dtd"><cbsconfig><cbs><id>1</id><hostname>ncrdnet382EE7.STORENET</hostname></cbs><cbs><id>11</id><hostname>ncrdnet383B45.STORENET</hostname></cbs><cbs><id>12</id><hostname>ncrdnet39412E.STORENET</hostname></cbs><cbs><id>13</id><hostname>ncrdnet39C245.STORENET</hostname></cbs></cbsconfig>
Chapter 6: Configuring the DecisioNet System Environment 6-9Application ConfigurationSite-specific application parameters are defined in the following threefiles:• DecisioNet Configuration file (dnconfig.xml)• DecisioNet Task Manager configuration file (taskman.cfg)• Decisionet Host Bridge Configuration file (dnhostbridge.xml)Note: This section identifies the parameters in the first two files.Changes to the Host Bridge Configuration file are typically done by theprogramming team to match the site-specific requirements of theCustom Data Reader. Details about changing the Host BridgeConfiguration file are included in the "Host Bridge Utility Guide" onthe DecisioNet Implementation Guide (B005-0000-1250).DecisioNet Configuration file (dnconfig.xml)The DecisioNet Configuration contains the following sections withparameters specific to the individual DecisioNet software module.• Inter-Process Communication (IPC)• Log and Tally Manager• CBS Manager• ESL Manager• DecisioNet Console• Data ReaderThe following tables show each parameter and the default valuefollowing software installation.IPC SectionParameter DefaultServerIP 127.0.0.1TraceLevel 0
6-10 Chapter 6: Configuring the DecisioNet System EnvironmentLog and Tally Manager SectionParameter DefaultSystemLogging YCheckAction YMaxTallies 50TallyUpdateFrequency 10TraceLevel 0TraceFile dnltmanager.trcEventsMax 10000EventsNumberToRemove 1000EventsDaysToRemove 30HandleEmail YHandleAlarm YHandleConsole YHandleSystemTray YHandleExecProcess YHandlePager YHandleEslTag YHandleThirdParty NHandleSnmpTrap NManualTagLinkID MANUALManualTagLinkType 99PagerTagLinkID PAGERPagerTagLinkType 98CBS Manager SectionParameter DefaultMaxWorkerThreads 20MaxConnectionsPerCBS 10TODUpdateFrequency 60NumberCBSAttempts 3NumberESLAttempts 5BroadcastSends 5
Chapter 6: Configuring the DecisioNet System Environment 6-11Parameter DefaultConnectTimeout 10ResponseTimeout 15MaxFailureFrequency 15TallyUpdateFrequency 60ResultTableExpirationTime 60BufferFullAttempts 20BufferFullPause 2CBSBusyAttempts 20CBSBusyPause 2QuickFind 1SimulationMode 0StoreID 255TraceLevel 0TraceFile cbsmanager.trcESL Manager SectionFor all recurrence or lifetime settings:P=period xY=year xM=month xD=dayT=time xH=hour xM=minutes xS=secondswhere x = length of timeFor all start date settings, format is YYYYMMDDhhmmssParameter DefaultPeriodicVerify 0VerificationRecurrence P0Y0M0DT1H0M0SVerificationStartDate 20000101000000PeriodicExistenceBedcheck 0ExistenceBedcheckRecurrence P0Y0M7DT0H0M0SExistenceBedcheckStartDate 20000101000000PeriodicHardwareBedcheck 0HardwareBedcheckRecurrence P0Y1M0DT0H0M0SHardwareBedcheckStartDate 20000101000000
6-12 Chapter 6: Configuring the DecisioNet System EnvironmentParameter DefaultPeriodicSumcheckBedcheck 0SumcheckBedcheckRecurrence P0Y0M1DT0H0M0SSumcheckBedcheckStartDate 20000101000000TransactionRecordLifetime P0Y0M0DT2H0M0SSuccessfulSpoolRecordLifetime P0Y0M0DT0H1M0SErroredSpoolRecordLifetime P0Y0M3DT0H0M0SMaxNumberUpdateRetries 10MaxUpdateRetryPeriod PT10MMinNumberUpdateRetries 2MinUpdateRetryPeriod PT1SMaxNumberBedcheckRetries 10MaxBedcheckRetryPeriod PT10MMinNumberBedcheckRetries 2MinBedcheckRetryPeriod PT1SMaxNumberFindRetries 2MaxFindRetryPeriod PT5MMinNumberFindRetries 0MinFindRetryPeriod PT1SMaxNumberAssignRetries 10MaxAssignRetryPeriod PT10MMinNumberAssignRetries 2MinAssignRetryPeriod PT1SMaxNumberForceSearchModeRetries 10MaxForceSerchModeRetryPeriod PT10MMinNumberForceSearchModeRetries 2MinForceSerchModeRetryPeriod PT1SMaxCBSUpdateResponseWait PT5MSumcheckCorrectiveAction 1PingUnresponsiveTags 1IgnoreUnresponsiveTags 1AutoFindAfterNoResponse 1SearchModeAfterNotFound 1AutoAssignAfterFind 1ForceSearchModeAfterFindFail 1UnresponseTagRecurrence P0Y0M1DTH0M0S
Chapter 6: Configuring the DecisioNet System Environment 6-13Parameter DefaultUnresponsiveTagStartDate 20000101000000PriceChecking 1DefaultUpdatePriority 3DefaultBedcheckPriority 5DefaultVerifyPriority 7DefaultFindPriority 10DefaultAssignTimeslotPriority 3DefaultForceSearchModePriority 3TransactionResolveSleepTime 50TransactionThreadSleepTime 500SpoolLogThreadSleepTime 200ProcessingThreadSleepTime 0MaxHistoryDepth 10MaxAutofindSequence 1MaxPricecheckCorrectiveDepth 3MaxTransactionRecordBlock 128MaxESLTransactionRecordBlock 128MaxESLRecordBlock 128MaxUpdateImageBeforeRefresh P0Y0M7DTH0M0SOperatingMode NORMALDecisioNet Console SectionParameter DefaultTraceFileName dnConsoleTrace.trcTraceLevel 0PrintOverlaysEnabled 1ForcePrintEnabled 0PriceLevelPresent 1ProductUnitPresent 1ESLDefaultToProduct 1ReportSQL1 (Details for Report 1)ReportSQL1SelectColumn 1ReportSQL1KeyColumn 3
6-14 Chapter 6: Configuring the DecisioNet System EnvironmentParameter DefaultReportSQL1Button 1ReportSQL2 (Details for Report 2)ReportSQL2SelectColumn 1ReportSQL2KeyColumn 4ReportSQL2Button 1ReportSQL3 (Details for Report 3)ReportSQL3SelectColumn 0ReportSQL3KeyColumn 2ReportSQL3Button 0ReportSQL4 (Details for Report 4)ReportSQL4SelectColumn 0ReportSQL4KeyColumn 3ReportSQL4Button 0ReportSQL5 (Details for Report 5)ReportSQL5SelectColumn 0ReportSQL5KeyColumn 3ReportSQL5Button 0Data Reader SectionParameter DefaultPriceDecimalPosition 2UnitPriceDecimalPosition 2DebugFilename DataReaderServer.logDebugLevel 2PriceLessThanDollar CentSignUnitPriceLessThanDollar LeadingZeroDecimalSymbol CommaRoundingType Normal
Chapter 6: Configuring the DecisioNet System Environment 6-15DecisioNet Task Manager (taskman.cfg)The DecisioNet Task Manager starts as a service and automaticallystarts DecisioNet applications as tasks. The Task Managerconfiguration file (taskman.cfg) specifies how to manage theDecisioNet tasks. The table lists each parameter and the installeddefault.This is not an XML format file. You can still use an ASCII editor tosearch for the parameter and then change the default. The format of theparameter setting is:<PARAMETER>=<SETTING>For example:KILLINTERVAL=15Parameter Default SettingFREQUENCY 1KILLINTERVAL 15DEADCHECK 3EXCEPTION excphdlr.exe -vCONTEXT DNETTFILES dnet.tm\*.infCONTEXT TASK_MANAGERTFILES taskman.tm\*.infStarting a Windows NT DecisioNet SystemDecisioNet Release 3.0 software is configured to start as an automaticservice when you re-boot your system. When you have finished settingconfiguration parameters, re-boot the system so all DecisioNetenvironment variables and system options at set.After the system re-boots, use the following procedure to start theDecisioNet Console.1. Click on the Start icon.2. Select Programs > DecisioNet > DecisioNet Console.
6-16 Chapter 6: Configuring the DecisioNet System Environment
Chapter 6: Configuring the DecisioNet System Environment 6-17About PasswordsYou must enter a Username and Password to access the DecisioNetConsole. The default Username is system and the default password ismanager. To protect the DecisioNet System from unauthorized access,it is recommended that you change the password on the systemUsername to a password other than manager once you have installedthe system.Maintaining Username/ PasswordYou can add, change, or delete a Username and Password by using aMySQL database editor and editing the User table in the DNETdatabase. The following example shows how to use the FreeMascondatabase editor to add a new user.1. Start the FreeMascon database editor.2. Select localhost to display the available databases.
6-18 Chapter 6: Configuring the DecisioNet System Environment3. Select DNET to display the DecisioNet database tables.4. Do one of the following to open the DecisioNet users table:• Double-click on the users table icon, or• Click the users table icon to highlight it and then click Open…at the lower left corner of the screen.The initial entry in the table is the default Username(OS_USER_NAME), system, and the default Password (PASSWORD),manager.5. Click the + (plus) icon on the bottom of the screen to add a newrecord.6. Enter the new user information. The maximum length of each fieldis 25 characters.
Chapter 6: Configuring the DecisioNet System Environment 6-197. Enter other users as needed.8. Close the FreeMascon editor when finished.

Navigation menu