Go to the Keystroke POS Home Page

Keystroke Multistore Utilities

Below is a list of Multistore Utilities (Multistore Module required) and a description of what each one does.

CHKNUM.EXE

Checks two specified files for the Next Number value stored in them.

CHKSTAMP.EXE

Checks that the specified files belong to the same data set by reading date/time stamp written to the file using the STAMP program.

COPYNUM.EXE

Copies the Next Number values from EXTRACT.MRG.

DATENAME.EXE

Changes the name of a file to a name representing the current date.

EXTRACT.EXE

Extracts transactions into the file EXTRACT.MRG so they can be imported with the Storemrg program.

INVLINK.EXE

Reads the current inventory data file and then writes QOH information to a file named 'KSIL#.DAT' were # is the store number.

STAMP.EXE

Stamps the specified files with the current Date/Time by writing a serialized representation of the Date/Time the utility was run to the first record of each file. Used with Chkstamp.

STOREMRG.EXE

Merges the existing transactions from the merge file EXTRACT.MRG (created by the EXTRACT.EXE utility)

STRUPDTE.EXE

Runs the Update Inventory function from the Store-Link module.


CHKNUM.EXE:

Checks two specified Keystroke Database files for the Next Number value stored in them.  The syntax to run the program is:

CHKNUM FILE1 FILE2

If the Next Number in each file is different, then the program will return an error.

Error Levels:

0 = OK - Next Number is SAME in both files
1 = Number in First file is HIGHER than in Second File
2 = Number in First file is LOWER than in Second File
3 = Bad/Missing FileNames
4 = Bad Files (size <2048 or not a multiple of 128)

The program writes the results to the file CHKNUM.LOG.

Example (test customer files before copying them):

CHKNUM DATA\KSCST.DAT DATA\HOLD\KSCST.DAT
IF EXIST(CHKNUM.ERR) GOTO BAD
:GOOD
COPY DATA\HOLD\KSCST*.DAT DATA\KSCST*.DAT
GOTO EXIT
:BAD
ECHO Bad set of files, not copied.
:EXIT

Keystroke POS Point Of Sale Software


CHKSTAMP.EXE:

Checks that the specified files belong to the same data set by reading date/time stamp written to the file using the STAMP program. Specify only one file name (supports wild cards to actually represent several names).

The program will write the results to the file CHKSTAMP.LOG. It will also return ErrorLevel 1 if any files don't match or ErrorLevel 2 if any files are not valid.

Example (test files before copying them):

DEL CHKSTAMP.ERR
CHKSTAMP DATA\KS*.DAT
IF NOT EXIST(CHKSTAMP.ERR) GOTO GOOD
IF FIND "ERRORLEVEL=1" CHKSTAMP.ERR GOTO NOMATCH
IF FIND "ERRORLEVEL=2" CHKSTAMP.ERR GOTO BAD
IF ERRORLEVEL 2 GOTO BAD
:GOOD
COPY DATA\NEW\KS*.DAT DATA\*.*
GOTO EXIT
:NOMATCH
ECHO At least one of the files did not match
:BAD
ECHO Bad set of files, not copied.
:EXIT

Keystroke POS Point Of Sale Software


COPYNUM.EXE:

Copies the second record (FileData which holds the next number values) from the transaction file EXTRACT.MRG to the customer data file KSCST.DAT.

Supports the standard Keystroke command line switches.

It also supports the following special switches :

/M - Merge directory, follow this switch with the location of the EXTRACT.MRG file.

Keystroke POS Point Of Sale Software


DATENAME.EXE:

Changes the name of a file to a name representing the current date.

The syntax is:

DATENAME FileName1 FileName2 [FORMAT=MMDDYY]

where FileName1 is the file to be renamed and filename2 is the mask to name the file to. Note that the mask must be entered with an * in it where the * will be replaced with YYMMDD (e.g. DATENAME KSTRN001.MRG *.MRG will rename the file KSTRN001.MRG to 101514.MRG).

The FORMAT= switch is optional. It may be used to change the date pattern from YYMMDD to MMDDYY or DDMMYY. (If used, the FORMAT= switch must come after the two file names.)

Note that a dash and a letter (-A, -B, -C, etc.) may also be added after the date if the filename already exists. The program will make a file called DATENAME.LST that will contain the name of the file created.

This program can be used in MultiStore polling procedures to provide a backup for each day's EXTRACT.MRG so that it can be recovered more easily.

Keystroke POS Point Of Sale Software


EXTRACT.EXE:

Extract transactions into the file EXTRACT.MRG so they can be imported with the Storemrg program.

Supports most of the standard Keystroke command line switches as well as the following special switches:

/M : Merge Directory - put the name of the directory that contains the merge file after this switch. (/M C:\DATA)

/NOLOCK : Don't update transaction lock date.

/NODISPLAY : Don't display status.

/FORCEDATE : Save End Date of Extract even if before last Extract's End Date.

Start= : Starting Date - put the date to mark as the start of the extracted period after this switch. (Start=04/10/00)

End= : Ending Date - put the date to mark as the end of the extracted period after this switch. (End=05/26/00)

StartTime= : Starting Time - put the time to mark as the start of the extracted period after this switch. (StartTime=05:30a)

EndTime= : Ending Time - put the time to mark as the end of the extracted period after this switch. (EndTime=18:15)

Extract= : List of characters that define what to extract (see Supported Categories below). Default is Extract=CV1WQO5RYyA0T9

Include= : Add additional characters to list of categories to extract. (e.g. Include=s to extract serial numbers)

Exclude= : Remove characters (Don't Extract) from list of categories to extract. (e.g. Exclude=C to not extract customers)

/NUMBERS : Extract serial numbers from inventory.

Additional optional parameters are available to establish a range (or filter) of records to extract. These parameters can be specified in the file EXTRACT.DAT. See Keystrok\Doc\Extract.doc for more information.

Keystroke POS Point Of Sale Software


INVLINK.EXE:

Reads the current inventory data file and then write QOH information to a file named 'KSIL#.DAT' were # is the store number as recorded in the Keystroke Configuration Module. The new file can then be read from an inventory record by pressing [Shift+F5] to display the QOH for all the stores for which a 'KSIL#.DAT' file is available.

Supports the standard Keystroke command line switches.

Note:
The serial number from the KEYSTROK.LIC file is stored in the KSIL#.DAT file. These files will not be used unless each one has a different serial number. When generating these files for several stores on the same machine, copy the KEYSTROK.LIC file for each store into that store's data directory.

Keystroke POS Point Of Sale Software


STAMP.EXE

Stamps the specified files with the current Date/Time by writing a serialized representation of the Date/Time the utility was run to the first record of each file. You must specify one (and only one) filename (but it can include wild cards to actually represent several names). The specified size of each file must be at least 2048 bytes and be divisible by 128 (all Keystroke Database and Transaction files meet these parameters).

This stamp can then be used by the CHKSTAMP.EXE utility to ensure all the files are from the same data set.

Examples:

To stamp the inventory files enter:

STAMP DATA\KSINV*.DAT

To stamp all Keystroke Database and Transaction files enter:

STAMP DATA\KS*.DAT

Keystroke POS Point Of Sale Software


STOREMRG.EXE:

Merges the existing transactions from the file EXTRACT.MRG (created by the EXTRACT.EXE utility) into data files. Please see the Multi-Store section of your User Guide for complete documentation.

Supports most of the standard Keystroke command line switches as well as the following special switches:

NOTE:

These switches can also be specified in the file STOREMRG.DAT. See documentation on Multi-Store / Store Merge for more information.

/M : Merge Directory - put the name of the directory that contains the merge file after this switch. (/M C:\DATA)

/NOP : No Pause - Eliminates warning prompts.

/NOINV : No Inventory - do not add new inventory.

/NONEXTNUMS : No Next Nums - do not update Next Number on transactions. (Customer Next Number is always updated. Use COPYNUM.EXE to restore it). This should be used when merging in both directions for stores that enter data in the same data set but at 2 locations.

Storemrg= : List of characters that define what to type of records to merge in.

Default is Storemrg=CV1WQO5RYyA0T9

Include= ; Add additional characters to list of categories to merge. (e.g. Include=s to merge serial numbers).

Exclude= : Remove characters (Don't Merge) from list of categories to merge in. (e.g. Exclude=C to not merge customers).

/SALESONLY : Do not include purchase transactions. (same as EXCLUDE=OR5y).

/NOCUST : Do not add new customers. *(OLD use EXCLUDE=C instead)*.

/NOVAR : No Variances. *(OLD use EXCLUDE=0 instead)*.

/NOTIMECLOCK : No Time Clock entries. *(OLD use EXCLUDE=T instead)*.

/NOAUDIT : No Audit entries. *(OLD use EXCLUDE=9 instead)*.

/NUMBERS : Merge in Serial Numbers. (Erases all current serial numbers then adds back in those from merge file).

Additional optional parameters are available to establish a range (or filter) of records to merge. These parameters can be specified in the file STOREMRG.DAT. See Keystrok\Doc\StoreMrg.doc for more information.

Keystroke POS Point Of Sale Software


STRUPDTE.EXE:

Runs the Update Inventory function from the Store-Link module. All parameters are set in the Store-Link Update parameters.

Supports all the standard Keystroke command line switches.

Keystroke POS Point Of Sale Software


END OF LIST

Keystroke POS Point of Sale Software

Home | Products | Support | Dealers | Downloads | Search | Contact | Questions?
Keystroke | SW Comparison | Where To Buy | Download Evaluation Software

|