Show TOC

Background documentationServer-Related Parameters

 

POS server-specific parameters

The parameters in this section control the behavior of the server. These options are only applicable to POS, ISP, Back Office, or POS Server. If you are not using one of these applications, disable these options with comment marks.

APPNLOGLVL

Function

Defines the level of messages which are logged to a .log file. The messages are always logged to the server.

Possible values

Enter one of the following:

0 - log standard messages.

1 - also log open/close/consolidation messages.

2 - also log application datagrams.

3 - also log full application details.

Note Note

Higher log levels include lower value levels.

End of the note.

Default value

0

BUSRVBACKUP

Function

Places copies of the Btree layaway and customer databases on the backup server when the cashier runs the End of Day function.

Note Note

You must set this option to Y to use the backup server for layaway transactions when the server is offline.

End of the note.

Possible values

Y - yes, place a copy of the databases on the backup server.

N - no, do not place a copy of the databases on the backup server.

Default value

N

BUSRVEODEXIT

Function

Forces the backup server to exit the application after the cashier runs the End of Day function. You must exit the application to perform administrative tasks outside the application, such as running disk utilities and loading software updates. You use this option to assign a number to the exit, which is used by a .bat file containing the commands for the administrative tasks.

Possible values

Enabled: enter a number between 1-5.

Disabled: enter 0 to prevent the server from exiting the application when the cashier runs the End of Day function.

Default value

0

CLOSESYNCTIMEOUT

Function

Defines, in milliseconds, the length of time the server waits for a message from the POS indicating that the POS is synchronized with the server's closing process.

This option works in conjunction with the TERMCLOSELOG, STORETOTRESPTIMEOUT, and TERMCLOSERETRIES options to eliminate double posting of data during the Close Terminal function.

Possible values

Enter a number.

Default value

16000

CREDIT_MSG1_SERVER

Function

Defines the text of the warning message that is triggered when the NCR 2127 credit service is down. The message appears in a popup window in the server console when the service becomes unavailable.

Possible values

Enter an alphanumeric string using up to 20 characters. Enclose the string in quotation marks.

DETAILEDAPPLYLOGGING

Function

When any of the download files (plutxn.asc, xreftxn.asc, suppattr.asc or suppdata.asc) are being applied on the POS Server, if one of the download file records causes an error (fails to apply), the POS Server will log additional information in the apply.log file. This option should be enabled if detailed download apply logging is required.

Possible values

Y - yes, the POS Server will add additional information in the apply.log file.

N - no, the POS Server will not log any additional information to the apply.log file.

Default value

Y

The following table shows the format of the additionally logged information. The format of any existing logging information within the apply.log file remains unchanged.

Field Name

Position

Description

Values

Time Stamp

Jan 16

This field will indicate the date and time when the record failed to apply.

Example:

Aug 18 15:18:48:

File Name

17 – 31

This field will contain the name of the download file that has generated an error.

plutxn.asc, xreftxn.asc, suppattr.asc, suppdata.asc

Key Word

33 – 42

This field will contain FAULTLINE#. This will indicate that the current LOG line contains detailed logging information.

FAULTLINE#

Line Number

44 – 52

This field will contain the actual line number (within the apply file) that has failed to apply.

1 to 999999999

Action Code

54 – 55

This field will contain the Action Code Add/Modify/Delete that has failed.

1, 2, 3, 99

PLU Number

57 – 76

This field will contain the PLU number (if present in the download file record and readable by the POS Server).

PLU Number – If Present (or) Blank

Line Data

78 – 137

This field will contain the first 60 characters of the download file line that has failed to apply

FREE_MODEM

Function

Makes the credit/polling modem in the server available for other remote access functions after the store is closed. Other uses could include third party polling, and remote access.

Note Note

Do not use this option to make the modem available for other functions if you are using credit and polling.

End of the note.

Possible values

Y - yes, make the modem available for other functions.

N - no, do not make the modem available for other functions.

Default value

N

GTOAUTOREP

Function

Prints reports automatically as part of the End of Day function. Only the reports that can be generated by terminal group are available for this option. Add a copy of this option for each report you want to include.

Possible values

Enabled: enter one of the following:

320 - Sales report

321 - Flash Sales report

322 - Tender report

330 - Sales Analysis report

Disabled: enter comment marks.

Default value

Disabled

LWAYADDCUSTADMIN

Function

Defines if the C1 and C2 customer administration records are written to the TLog every time the cashier performs a layaway transaction. If the customer information is not available, as much data as possible is taken from the layaway information.

The C1 record includes the following fields: customer number, customer type, last name, first name, and street address.

The C2 record contains fields holding additional customer information, such as city address and phone number.

If this option is set to Y, and no customer information is available, a warning message appears on the POS.

Possible values

Y - yes, write the C1 and C2 record to the TLog when the cashier performs a layaway.

N - no, do not write the C1 and C2 records to the TLog when the cashier performs a layaway.

Default value

N

LWAYCUSTBACK

Function

Places copies of the Btree layaway and customer databases in the sdata\backup folder on the server at the end of the day.

Possible values

Y - yes, place copies of the databases in the folder.

N - no, do not place copies of the databases in the folder.

Default value

N

LWAYPURGE

Function

Automatically purges the layaway database on the server when the cashier runs the End of Day function.

Possible values

Y - yes, purge the layaway database when the cashier runs the End of Day function.

N - no, do not purge the layaway database when the cashier runs the End of Day function.

Default value

N

MAX_SEQ_TXN_UPDATES

Function

This parameter controls the number of sequenced update files that are maintained on the server. It only does so if TRACKDOWNLOADUPDATES= N.

Possible values

0-99

Default value

0

MINIDUMPPATH

Function

The folder where the dump file is to be generated.

Possible values

C:\Program Files\SAP\Retail Systems\Point of Sale\logs

Default value

The temporary folder as defined in %TEMP%.

MINIDUMPTERMINATE

Function

Indicates if the process should terminate after a diagnostic dump file is created.

By terminating the process after a diagnostic dump is created, no further processing is possible for any registered exception handlers.

Possible values

Y - yes, in certain situations a program error can cause an indefinite exception recursion. Therefore this flag should be set to Y by default.

N - no, process termination can be disabled by setting this flag to N if further exception handling is required. For example, exception handling implemented by SAP partners.

Default value

Y

MINIDUMPTYPE

Function

MiniDump type used for diagnostic dump file generation when calling MiniDumpWriteDump().

Possible values

MINIDUMPTYPE=0x0

The values are defined in dbghelp.h

MiniDumpNormal = 0x00000000

MiniDumpWithDataSegs = 0x00000001

MiniDumpWithFullMemory = 0x00000002

MiniDumpWithHandleData = 0x00000004

MiniDumpFilterMemory = 0x00000008

MiniDumpScanMemory = 0x00000010

MiniDumpWithUnloadedModules = 0x00000020

MiniDumpWithIndirectlyReferencedMemory = 0x00000040

MiniDumpFilterModulePaths = 0x00000080

MiniDumpWithProcessThreadData = 0x00000100

MiniDumpWithPrivateReadWriteMemory = 0x00000200

MiniDumpWithoutOptionalData = 0x00000400

MiniDumpWithFullMemoryInfo = 0x00000800

MiniDumpWithThreadInfo = 0x00001000

MiniDumpWithCodeSegs = 0x00002000

MiniDumpWithoutAuxiliaryState = 0x00004000

MiniDumpWithFullAuxiliaryState = 0x00008000

MiniDumpWithPrivateWriteCopyMemory = 0x00010000

MiniDumpIgnoreInaccessibleMemory = 0x00020000

MiniDumpWithTokenInformation = 0x00040000

For more information, see http://msdn.microsoft.com/en-us/library/windows/desktop/ms680519%28v=vs.85%29.aspx

Default value

0x00000000

NEWPARM_SECS

Function

Defines, in seconds, the time between checks on the server for the parm\newparm.trg file, which contains downloaded updates from head office. The updates are applied whenever the .trg file is found. To trickle the changes to the POS, use Manager Code 414.

Possible values

Enter a number between 5-99999.

Default value

30

NUMALPHASKU

Function

Requires PLUs to be numeric. To make this option available, select Alpha-Numeric from the PLU Type drop down list in the PLU Configuration Maintenance window in the Configurator.

Possible values

Y - yes, require that PLUs be numeric.

N - no, do not require that PLUs be numeric.

Default value

N

POLLCDS

Function

Writes a copy of the Department by Cashier by Terminal report group data to the file upload\ssssqq.cds on the server when the cashier runs the End of Day function, so that it can be polled by the head office. SSSS is the store number, and qq is the End of Day sequence number. You can define report groups using Manager Code 6 (Terminal Define) in the POS Xpress.

Possible values

Y - yes, write a copy of the data to the server.

N - no, do not write a copy of the data to the server.

Default value

N

POLLGTO

Function

Copies Terminal report group data into the file upload\ssssqq.gto on the server when the cashier runs the End of Day function, so the data can be polled by the head office. SSSS is the 4 character store number, qq is the 2 character terminal number.

Possible values

Y - yes, copy the data to the ssssqq.gto file.

N - no, do not copy the data to the ssssqq.gto file.

Default value

N

POLLLOCUPD

Function

Writes a copy of the store’s local parameter database changes to the upload folder on the server so that they can be polled by the head office.

Possible values

Y - yes, write a copy of the local parameter database changes to the server.

N - no, do not write a copy of the local parameter database changes to the server.

Default value

N

POSTSALESPERSONTOTALSTODB

Function

This option is used to control when to paste the Sales Person productivity information into the database.

Possible values

0 - paste sales person productivity information into the database at End of Day.

1- no, do not process at all.

2 - paste sales person productivity information into the database throughout the day.

Default value

0

PPLANDATFILE

Function

Defines the path on the server to the People Planner’s clock.dat file for posting clock in/out data. If you are not using the People Planner application, disable this option with comment marks.

Possible values

Enabled: enter the full path to People Planner’s clock.dat file (for example, c:\pboot\pp\clock.dat).

Disabled: enter comment marks.

Default value

Disabled

PRICECHANGELOGGING

Function

Defines if changes to the retail price are recorded in the store's TLog and the txn_price_change table in the SQL database. Price changes are recorded if they are made through the PLU apply process, or through Manager Code 16 - PLU Maintenance.

Possible values

0 - price changes are not logged.

1 - log price changes made at the store only.

2 - log all price changes.

Default value

0

PRINTDBPOSTRATIO

Function

Indicates how often to print the following ratio: Posted x Transactions and y Transactions Remaining; x is the number of transactions posted in the last interval; y is the number of transactions still left to post to the database.

Will only be used if the value is non-zero and the Debug Trickle Level is set to summary (1) or higher.

Possible values

720 minutes (maximum).

1 minute (minimum).

Default value

0 - which is when the function is turned off.

PROMOAUTOEXPIRY

Function

Defines the number of hours that promotion information is held in the PLU record before it automatically expires and forces a new lookup in the promotion database.

Possible values

Enter a number between 1-24 (hours).

Default value

24

PROMOSBYSKUONLY

Function

Searches for promotions in the Promotions table only by PLU. When you use this option, the promotion look up time is shortened.

Possible values

Y - yes, search for promotions only by PLU.

N - no, do not search for promotions only by PLU.

Default value

N

SALESTOTBYTERMGROUP

Function

Accumulates sales totals by terminal group. You must accumulate sales totals by terminal group if you want to print reports by group. You can define groups using Manager Code 6 (Terminal Define) in the POS Xpress. If sales totals are not accumulated by terminal group, they are accumulated by terminal number.

Possible values

Y - yes, accumulate sales totals by terminal group.

N - no, accumulate sales totals by terminal number.

Default value

N

SDISKEWARN%

Function

Warns the cashier that a large percentage of the server’s available disk space has been used. A warning message appears on the Back Office/ISP screen and on the POS Xpress screen when a cashier opens or closes a terminal.

Possible values

Enter a number between 1-100%.

Default value

85%

Note Note

89% or higher for Unix servers is recommended.

End of the note.
SERVERDELETESEXPIREDPROMOS

Function

Defines if information related to promotions is automatically purged from the database when the promotion expires.

Possible values

Y - yes, delete expired promotion information from the database automatically.

N - no, do not automatically delete expired promotion information from the database.

Default value

N

STORETOTRESPTIMEOUT

Function

Defines, in seconds, the length of time the POS waits for messages from the server indicating the status of the close request.

This option works in conjunction with the TERMCLOSELOG, CLOSESYNCTIMEOUT, and TERMCLOSERETRIES options to eliminate double posting of data during the Close Terminal function.

Possible values

Enter a number.

Default value

8

TERMCLOSERETRIES

Function

Defines the number of times the server tries to close a terminal if it encounters an error.

This option works in conjunction with the TERMCLOSELOG, CLOSESYNCTIMEOUT, and STORETOTRESPTIMEOUT options to eliminate double posting of data during the Close Terminal function.

Possible values

Enter a number.

Default value

3

TRACKDOWNLOADUPDATES

Function

Updates the audit tracking table.

Possible values

Y - yes, update the audit tracking table.

N - no, do not update the audit tracking table.

Default value

Y

TRICKLELOGLVL

Function

Defines the level of trickle messages that are logged to a .log file. The messages are always logged to the server. This option is for the DOS, Unix Back Office/ISP, and for the POS Server.

Possible values

Enter one of the following:

0 - do not log any trickle messages.

1 - log trickle activity summary messages.

2 - also log the TLog trickle detail messages.

Note Note

Higher log levels include lower value levels.

End of the note.

Default value

0

TXNSYNC_SECS

Function

Defines, in seconds, how often the backup server checks the parameter files in the txnsave folder on the server for updates that must be downloaded to the backup server and the local POS.

Possible values

Enter a number over 30.

Default value

300 seconds.

Server command file specification

The option in this section allows server commands, such as requesting totals from all registers, to be executed. When the trigger file (defined in the CMDFILE portion of this option) is placed on the server, usually by the head office, the file is automatically detected and the server executes the commands it contains.

SRVCMDFILE

Function

Sets up the option to allow server commands to be executed. All the files required for this option are located on the server. The trigger file must be in the same folder as the server application; the response files do not have to be located in the same folder. You must enter a value for each component of this option.

Possible values

Format: CMDFILE,GOODRESPFILE,ERRORRESPFILE,NSECS

Enabled:

CMDFILE - enter the name or the full path and name of the file that contains the commands that the server executes; this file is automatically deleted after execution.

GOODRESPFILE - enter the name or the full path and name of the file that the server writes successful responses to.

ERRORRESPFILE - enter the name or the full path and name of the file that the server writes error responses to.

NSECS - enter the number of seconds between instances of the server checking for the presence of the CMDFILE.

Disabled: enter comment marks.

Default value

Disabled

Unix server-specific parameters

The option in this section sets up the Unix CVTLOG daemon. The daemon converts TLogs from binary format to ASCII format.

CVTLOG_FULLBUSINESSDATE

Function

If set to Y, defines the business date in the ASCII TLog records as MMDDYYYY, instead of MMDD.

Corresponds to the CVTLOG's BDY option.

Possible values

Y - yes, enabled.

N - no, disabled.

Default value

N (disabled).