Keystroke POS Point Of Sale Software - Keystroke Classic Readme

This file contains changes to the program since the manual and/or addendums have been printed. Keystroke POS software is owned by Specialized Business Solutions ("SBS") of Long Beach, CA and is protected by United States and international copyright laws (Copyright (c) 1988-2006. All rights reserved).

Last Documentation Print Dates:
03/01/98 - User Guide Version 4
07/27/00 - Windows Features and 4.1 Addendum

Name	Code	DOS	Windows
Logo Screen	LOGO	LOGO.EXE	KCLOGO.DLL
Sales Manager	TRN	TRN.EXE	KCTRN.DLL
Database Manager	DBM	DBM.EXE	KCDBM.DLL
Variance Module	VAR	VAR.EXE	KCVAR.DLL
Purchase Manager	POR	POR.EXE	KCPOR.DLL
Report Manager	RPT	RPT.EXE	KCRPT.DLL
Label Manager	LBL	LBL.EXE	KCLBL.DLL
Account Receivable	AR	AR.EXE	KCAR.DLL
Configuration Manager	CNF	CNF.EXE	KCCNF.DLL
Quote Manager	QTE	QTE.EXE	KCQTE.DLL
Closeout Manager	CLOSEOUT	CLOSEOUT.EXE	KCCLOSEO.DLL

Store Link	STR	STR.EXE	KCSTR.DLL
Matrix Manager	MTX	MTX.EXE	KCMTX.DDLL
General Ledger Link	GLLINK	GLLINK.EXE	KCGLLINK.DLL
CYMA Link	CYMA	CYMALINK.EXE	KCCYMALI.DLL
Importer	IMP	IMP.EXE	KCIMP.DLL
Production	PROD	PROD.EXE	KCPROD.DLL
Script Editor	SCRPT	SCRPT.EXE	KCSCRPT.DLL
Forms Editor	FMTR	FMTR.EXE	KCFMTR.DLL

** Changes prior to 01/03/03 are in the file README4.TXT on the Keystroke CD. **

Installation - When a directory is manually entered, the program no longer appends \Keystrok to it.

GLLINK - Fixed Error 9 when editing Department Accounts from brand new GLLINK.DAT file.

TRN/etc. - Changed the retrieval of payments and other transaction type records to be more tolerant of the way different systems handle the math of floating point numbers.

RPT - Database - Inventory - On Sale List - if Grouped by Department - Summary then it was not printing correctly.

LOGO - Windows Version - changed background picture to Classic. Also changed icons to Classic icons.

TRN - Payment Authorization - If a payment is not approved, then the program no longer puts you in the Auth Code field (to eliminate accidentally entering a code). Use the [Up] arrow to move to the Auth Code field to enter one.

TRN/POR/REMDUPES - DOS Only - The program was not finding payments on previous transactions.

RPT - If the Inventory Analysis is run from the DOS prompt (via a cue) by using a scheduling program. It was possible that the report would run at the exact same time it did on the day before. This would sometimes cause the data from the previous report to be included in the new report. The program now stamps the report data using a combination of the date as well as the time to eliminate this problem.

LICENSE DISK - Added the ability for Keystroke Classic to use a license disk from Keystroke POS (v5 or higher). If used during installation, you may get a warning message that the patch file won't work since it is from a different version.

VAR - If Enable Deli Scale is on, then Stock Number field will now display up to 6 characters (still limited to 5 digit stock number).

RPT - A clerk that does not have access to reports was still able to edit the Report Cues. Now must have Access Report Manager security to do this.

AR - Statements - Changed the Invoice Total field to be just for Invoices. Added a Item Total field that includes Finance Charges, Payments and Invoice Totals.

QTE - Matrix Items - DOS Only - If an Matrixed Inventory Item is selected from the Look up list ([Ins]), then the program was not bringing up the matrix grid to select the matrix item.

POR - Receiving function was not handling Serial Numbers correctly. If a second item was received then its serial numbers were not put in the line item comment nor were they always updating the serial number list on the inventory item.

WINDOWS VERSION - The Transaction Warning (need to save) message now works when you try to close the program by using a windows function ([Alt+F4], clicking on the X, selecting Close from the window menu, etc.).

TRN - Forms - The 'DUPLICATE' field will now print 'REVERSING' if it is a reversing (Void) transaction.

IMPTRN/IMPPOR - Fixed Payment Loop - Name field so that if looking up payment by it it is not case sensitive.

TRN - ICVERIFY - Program will now through out an leading characters in the response from ICVerify that is not either an N or a Y.

- TRN/POR/AR/RPT/STOREMRG/GLLINK/DELUTIL/REMDUPES/DELTRANS - DOS Only - The program was not always finding a payment or invoice if another one existed near the same date/time (within 7 seconds) of the one it was looking for. (problem since v4.21 Build 20).

LOGO - Added another check to make sure a machine number is in use to help guard against problems that Windows Redirector (all versions) is having when reporting status of files over the network.

TRN/CNF - PCCharge Check Authorization - Added a Enter Check Number parameter that can be used with Check-D.L. and Check-Phone (MICR entry always includes the Check Number).

CLOSEOUT - If running in limitied functionality mode (clerk doesn't have Full Closeout Security) then the report was not printing the correct totals for the Deposit and Drawer columns.

TRN - PCCharge w/ MAPP - program no recognizes the CAPTURE COMPLETE message the MAPP uses on Credits and Voids.

TRN - PCCharge - Credit Cards - program will now send Sales Tax (required for purchase cards). If the method is set up as a Purchase Card then it always has sent the sales tax. With this method, it is possible for PCCharge to recognize a purchase card without having to specify that it is one.

TRN - Technical Note (don't worry about it if it doesn't make sense to you) - PCCharge authorization - program will now send a CID of 0001 on all transactions unless changed by purchase card method.

03/17/03 - v4.21 - Build 52

TRN/QTE - Script - Select Item from Range - If several select from Range scripts were run together, the program would sometimes not see that any items were available in the later scripts.

CHGNUMS - Would give Error 63 and crash if the comment file (KSINVCMT.DAT or KSCSTCMT.DAT) was bigger than 4MB.

IMPORTER - When adding new records, the program was using the Edit Default screen. It now will use the Add default screen (if a Default Add screen does not exist, then it will still use the Default Edit screen).

TRN - PCCharge - Debit Cards (ATM w/ Pin Pads) - If cash was being given back (amount put on card is greater than amount remaining so Change is given), then the program was increasing the amount charged to the card by the change amount (essentially doubling the change amount charged). With Credit Memos, this same problem was causing the card to be charged twice the amount that the customer was being applied to the customer's account.

CNF - Setup - Customer Display - The Keep Port Open parameter was being turned off every time the Cash Drawer setup was saved.

TRN/QTE - Scripting with Merge Same Items parameter. If a script added items, and the Merge Same Items parameters was on, the program was not merging all the items correctly and was not returning the cursor back to correct place on the screen.

LBL - Windows Printers - The LPI, CPI, TopMargin, and LeftMargin settings from .WPD files were not being used.

CLOSEOUT - Windows Printers - The CPI= parameter in the Windows Printer Driver (PRD.TXT or .WPD files) was not being used on the closeout report. A workaround was to set the CPI column setting in the code table to the correct setting.

TRN - Skip Tendered field was not working with payment types using Check or PCCharge authorization methods.

- RPT/KSR - Audit Report - Line Item Changed - the Shipped Qty amounts were always printing the Order Qtys.

TRN - ICVERIFY - Program will now treat any response that does not start with an N as an approval. Removed change from build 41 that threw out any leading characters in the response from ICVerify that was not either an N or a Y.

MTX - When adding a new element, the starting code is no 0 (zero) instead of the exclamation point.

MTX - When selecting a code for a new element from the ASCII list, the following characters are no longer included: "!<>*~,=. The use of these characters as element codes (and therefore Matrix Codes) can cause problems within Keystroke and/or when exporting the data to other programs.

STR - Reports - The Use InvLink files parameter was not working. If on, then stores that had a KSIL file were not being included on the report.

DBM - Update Price - program was sometimes rounding up one extra penny when a price mask was used and 3 digit cost/pricing was not enabled.

AR - When editing an ROA payment that was applied to Previous Finance Charges, the program was list this as a separate line instead of at the top with the current amounts.

TRN - Reversing Trans (Voids) - The program will now set the Clerk Number on the reversing to the Clerk that initially selected the transaction be reversed.

IMP - Serial Numbers - Fixed program so that the last serial number in list does not require a Chr$(255) on the end of it. This allows a single serial number to be imported (which still replaces the current list of serial numbers) without requiring the special delimiter character of ASCII 255.

VAR - When a variance is about to be posted, the program now checks for any unconfirmed items (this with a blank physical qty - created by the autofill function). If any are found, the program will display a warning message saying how many exist and asking if you would like the program to set the physical qty on all of those items to 0 (Yes will set them to 0 and take you back to the main entry screen so you can see the new totals, No goes forward without changing the lines, Cancel takes you back to main screen without changing the lines). If you select No, the program will display another message warning the those items that have not been confirmed will not be posted.

FILE LOCKED BY ANOTHER USER or ERROR 55 - If the program enters an Error State, it should not open any more files until the error state has been cleared. However, in certain cases, the program would still open the first file of a file set (like KSTRNHDR.DAT or KSINV.DAT) and then recognize that an Error State exists and not open the rest. Since the program was already in an Error State, it would assume that the first file was never opened (even though it was). This would leave the file open and locked, resulting in either an Error 55 (if on the same machine that did it) or a File is Locked by Another User message on a different machine. The program now recognizes the Error State before opening the first file in a file set and therefore won't open it. (Note: This problem has existed in all version of Keystroke but only appears very rarely since it requires: 1) an error to occur first, 2) the program to proceed with another write operation, 3) the program to not be running a routine that clears out the file locks and error states. One of the few places that this would happen is using [F7] to manually open a cash drawer when there is something wrong with the port that drawer is supposedly hooked up to).

PROD - When the screen was displaying the price of the items (instead of the cost), the totals at the bottom were wrong. This is just a display issue and does not affect the production in any way. (You can switch between the Cost and Price display by pressing [Shift+F9]).

TRN - Payments - No Overpayment - When doing a return (or any time the amount left to tender is negative) and the payment type being used had the No Overpayment parameter on, the program was not taking into account that the amounts were negative and so was limiting the payment in the wrong way.

CHGNUMS - was not working correctly with more that 32,000 records. Also, if you [Esc] out of it while it says "Packing" then the program was not restoring the original files.

CHGNUMS - added check for Matrix files (KSMTX.DAT). The program will not renumber inventory if this file exists (v5 does).

TRN - PCCharge Payment Entry - if the Skip Tendered parameter was on on the payment type, then you could not [Esc] out of the authorization process.

TRN - FORMS - Payment Loop - Reference - The program will now hide Exp Date of a credit card when it is printed on a form. It does this by removing the last 5 characters from the Payment Loop Reference field if the payment appears to be a credit card (Auth/Ref parameter is on, the reference is at least 18 characters in length, and the only space is 6 characters from the end).

RECMRG - If new date or register numbers are being assigned to the transactions, then audit records will not be merged in. (i.e. if the /ADD switch is not used or the DATE= or /R switches are used, the Audit entries will be skipped).

RECMRG - If the TIME= switch was used, the payments in the file being merged from were being altered so that the program would not be able to find them if the same file was used again. However, even though this problem has been fixed, it is recommended to always merge from a copy of the original file.

WINDOWS ONLY - Indexing on characters from the extended ASCII character set was not working correctly under windows. The program would either lock up, give an Error 28, or would just not sort them correctly. This was do to Microsoft changing the definition and order of these characters. The programs code has been modified to force the characters back to there original definitions when working with them. This does not happen very often since these characters are not available on a standard keyboard and can only be generated by holding down the [Alt] key while entering their ASCII number on the numeric keypad or by selecting the from a list. The only place where a problem has actually occurred is when purchasing matrixed items that used extended characters for the element codes.

LOGO - If the current data set is from Keystroke POS (version is greater than 4.9) then the program will display a message stating that you can't run Keystroke Classic with Keystroke POS data files.

FORMS - Windows Printers - Added support for LPI= and TopMargin= (in the PRD.TXT file) when printing forms.

COMMENTS - Fixed possible Error 5 after a lot of changes were made to a comment.

- TRN - If using the In-House w/ MICR Reader Authorization method, the program was crashing with an Error 9 or a 2 billion error.

- TRN - PCCharge-ATM (Debit)- If the Skip Tendered Field parameter was on, then the program would immediately display and Invalid Card Number message.

LBL - Price Tags by Purchases - added the field PO Sub-Number to the list of fields available to be printed. (This is the letter that follows the Transaction Number on Invoices that were created by Orders.)

- TRN - If the clerk was changed while in the Complete Sale box (or just before entering it), then the program was not updating the list of Payment Types based on the new clerk's security level.

LOGO - If an invalid v5 registration file exists, the program will now delete it and then use the v4 file instead.

- DBM - Search and Replace - The Replace screen will no longer display fields that you do not have the security to modify.

- TRN - PCCharge - changed Sales Tax amount sent to PCCharge to always be a positive number.

TRN - Printed Forms - Changed Payment Loop-Terms to use masked credit card numbers.

- TRN - Customer Pole Display - The program was not displaying items if Merge Same Items parameters was on and the item already existed on the transaction.

- CNF - Pack - There was a remote possibility that line items (after the first line item) on a transaction could be dropped by the pack function.

- MATRIX ITEMS - In rare instances, the indexes would loose track of some of the matrix records. This only happens when the first character of the record's code is different from other records and also depends on how similar the rest of the codes are and in what order they are added. Packing the file with this new release will bring back the lost records.

TRN - PCCharge - Program will no longer allow an amount of 0.00 to be processed.

- TRN/QTE - Price/Tax formulas - Limit By Code was not working correctly on formulas with a code of *.

QTE - Changed the % Profit/Markup column to accept decimal amounts (e.g. 1.5%). The program will accept and use any number of decimals but will only display up to 1 of them (e.g. 1.25% can be entered and will be used, but it will be displayed as 1.3%).

POR - Receiving - If the same line item was received more that once during the same session, then the program was only using the last entry.

VAR - If an item is entered using either a Deli Scale or EAN-128 bar code (Variable Weights), then the Confirm Qty parameter will be ignored and the program will automatically move on to the next line.

TRN/QTE - Price Formulas with a Minimum based on single line were not working if there were any other formulas that had minimums based on a Price Code's totals.

IMPPOR - UpdateBy=V (search for matching transaction based on Vendor) was not working on Purchase Invoices nor Reserved Orders.

STR - The program was not looking up items by description but was still allowing the line item to be used as a non-inventory item. Now it first looks the item up, and if not found, asks if you want to add it to the database. If you answer No, then it will be left on the transfer as a non-inventory item. If you answer Cancel (or press [Esc]) then the program will remove the line item.

TRN/POR - If Delete Filled Orders is turned on, the program will now only delete the Order if something (and it would have to be the final thing) is shipped/received from it. This mainly affects saving a blank order. Before, the program would delete it (since there was nothing left to ship/receive) but not create an invoice (since there was nothing shipped/received).

RPT - On reports that used the Method-Cash or Weighted Cash, the program was sometimes not finding old invoices that had been paid by a recent ROA payment. This was due to a rounding error caused by different computers rounding fractional numbers differently.

TRN - PCCHARGE - Gift Cards - Some gift cards contain an invalid expiration date in their mag stripe. Since gift cards don't use expiration dates anyway, the program will now ignore (leave blank) the expiration date field on all gift cards.

VAR - The program will no longer save a Variance that does not have any inventory items entered on it.

TRN - PCCharge - Added support for putting an F in front of the card number to force a "duplicate" transaction (one with the same account and amount as a previous charge) to go through.

TRN - PCCharge - Voids - When doing reversing transactions (voids) with host based processors, the program was not sending TransID number (so the payment was always being processed as a return instead of a void).

DATENAME.EXE - added an optional FORMAT= switch to change the date format from YYMMDD to MMDDYY or DDMMYY. See DATENAME.DOC for more info.

CNF/TRN - Authorization Methods - added support for Payment Processing through Mercury Payment Systems (MPS). This works the same as the PCCharge process but is done through a different company.

TRN - Sales Orders - the program was not allowing deposits using payment types that were mark as "No Over Pay".

GETMAIL.EXE - The program will no longer run if neither the SUBJECT= or NOTETEXT= parameters are note used.

TRN - Forms - Changed the Sales Tax Amount field to only print EXEMPT if the tax percentage is 0% and the Tax Amount is 0.00. (It use to print EXEMPT if the tax rate was 0% even if there was a Tax Amount).

CNF - Authorization Methods - added Mercury Payment Systems (MPS) to the list of available authorization types when adding a new method.

TRN - Authorize Cards - The routine that parsed out credit card swipes now supports Track 2 data without and expiration date (gift cards).

STR - Editing a Store Transfer - There were two separate problems that would occur if the Current Store (or "From:" store) was set to a different store than the one on the transfer that was selected. The first problem was that the program would look up the inventory information for each line item from the store in use before the transfer was selected instead of the store that the transfer was From. This would cause some line items to appear blank and would possibly cause the wrong inventory item to be displayed if the [F3]-edit key was used. The other problem was if the selected transfer was from a previous transfer file (not the current one), then either no line items or the wrong line items would be displayed.

CNF - Mercury/PCCharge Authorization Methods - added a "Card # Display Width" field. This specifies how many characters are displayed in the Card Number field on the screen when entering a payment using this method. The default is 30 and should not be set to anything higher. You may want to set it to a lower number (like 10) so that most of the number is hidden. No matter what this width is set to, the program will always accept up to 200 characters and save up to 30. If the field width is less than the number of characters in the card number, then you can still review the card number by placing the cursor in this field and using the Left and Right arrows to scroll around.

TRN - Authorize Credit Card - The program now hides the payment information while an authorization is in progress.

POR/STOREMRG - If the total value (Cost*Qty) of the item was over $2,100.00, then the program was setting the Avg Cost to be the new cost instead of calculating the true average cost (The system is suppose to do this when the value is over $2,100,000.00).

- LOGO - DOS Only - The serial number and license info was not being displayed on the logo screen (from build 76).

TRN - MPS - Debit Cards - Voiding a transaction (Reversing) - The PIN number needs to be reentered by the customer. So when a payment of this type is used, the reversing function will remove the payment so the clerk can reenter it.

CNF - Settings - Parameters - added a "Supports 5 Digit Price" parameter below "Enable Deli Scales" (which must be on to see it). If this parameter is on, then the bar code label from a deli scale can contain 5 digits for the total (up to $999.99) instead of just 4 (up to $99.99). If you turn this on, make sure your deli scale is also set to 5 digits, otherwise the deli scale may print a number other that 0 in this position which will greatly inflate the amount being charged.

TRN - Scripts - Prompt for Comment - if both the Message and the Comment are blank, then the program will now display the comment box. (If the message is blank, and the comment is not, then the comment is added to the line item without displaying it on the screen, the has not changed).

AR - Statements - When printing payments, the program will now print the Payment's Terms instead of Name + Reference. This allows credit card numbers to be masked.

- AUDIT - Adding Database Entries - the program was not recording which database the record was added to.

- LBL - Error in Windows Version - (From Build 77) - the file BIN\KCLBL.DLL used to create the Build 77 CD was corrupted. (Workaround is to copy it from another build (71 through 76) or the web site.

- TRN - Price Formulas - If a price formula had a Minimum base on Price Code Dollar amount, then the program was checking the total for the Price Code after the formula was applied instead of before. It now correctly checks the minimum based on the total amount for that price code before the formula is applied.

10/08/04 - v4.21 Build 81

CNF - Sales Payments - when adding a new payment, the default Closeout Calculator is now the Check Calculator (instead of Standard).

VAR - Entry by Stock Number - remove 5 digit limit so Matrix Items and Alternate codes can be used.

AR/TRN - ROA Payments and Credit Memos were not using the exact current time but would stamped with a time of a few seconds to several minutes prior to when they were entered. Was only a problem if include ROA Payments in Closeout and you entered an ROA payment soon after running a closeout.

POR - If editing a Purchase Order with no line items on it, the program will now start in Order/Recvd mode.

- IMPTRN/IMPPOR - Payments - was not saving Clerk Number, Register Number, or Store Number.

- TRN - Payment Authorization - InHouse check list - was not working correctly if payment reference was more than 30 characters long.

12/08/04 - v4.21 - Build 82

- RPT - Filters - using the Windows version under Windows XP, filters were not working if checking for a single extended ascii character.

- LOGO - DOS Only - Fixed Error 9 when converting Price Formulas from versions prior to v4.0. Only happened when there were a lot of them (over several hundred).

- TRN/POR/QTE/STR - <Ctrl+Enter> was allowing blank lines to be added at the bottom of the transaction.

- TRN - PCCharge payment authorization - Changed the program to write to a .TMP file and then rename it to .INP. Also added more checks to make sure files used in processing a cleared before processing begins. This is to help with networks that are not handling the file locking correctly.

12/14/04 - v4.21 - Build 83

- IMPPOR - When importing a purchase transaction with a vendor, if the Vendor Part Number field on the line item is not specified, then the program would set that Vendor's part number on the inventory item to blank.

COMMENTS - Program will now replace all Carriage Returns and Line Feed characters (chr$(13) and chr$(10)) with chr$(20) which is the internal paragraph marker for Keystroke whenever a comment is written to the data files. (Windows version only).

TRN - Edit Payments - DOS Only - the Auth Code field was displaying as blank when editing a payment that originally had an auth code.

02/18/05 - v4.21 - Build 84

TRN/CNF - Pin Pads - Added support for the Verifone Everest Pin Pad. (Note that Pin Pads are only supported when using the the Mercury or PCCharge Authorization methods.)

- LOGO - program no longer gives error if XSA*.DAT files (Matrix Sales Analysis files) are over 8mb (these files do not have a size limit).

- AR/ARPAYOFF.EXE - Automatic Payments - when applying payments to invoices, and there were invoices with the same transaction number for the same customer (which can happen with ones created by Sales Orders or Void/Reversing transactions, the program would sometimes created payments with the same date/time stamp for the different invoices. This would cause one of the invoices to see the payments for the other invoice and throw its amount due out of balance.

04/06/05 - v4.21 - Build 90

- KSKERNEL (DOS Only) Moved routines around to use about 6K less memory.

- PAIDOUT - If a paid out was done while an old transaction file was in use, it was possible for the Paid Out entry to be written to the older file (thus causing a Post Dated transaction message later on).

- TRN - Scripting - The Sale Unit field on items added via a script was always blank.

CNF - Printer Codes - The program no longer strips ASCII Character Number 0 (the Null character) from the beginning of printer code strings. (It still strips them from the end).

- TRN - If the "Prompt For Clerk" parameter was on, then the program was displaying the tax rate as 0% while in the Enter Clerk box.

LOGO - INI Files / Command Line Switches - Added DRAWEROFF and DISPLAYOFF command line switches and DrawerOff= and DisplayOff= INI file switches. If these are used (and set to 1 in the INI file) then the program will not use the cash Drawer or customer pole display. The settings for these devices can sTill be accessed and changed in the configuration manager but nothing will be sent to them. This should be used on a back room or other machine were a cash Drawer or pole display doesn't exist.

*** End of README ***

Keystroke Classic Read Me

Copyright © 1988 - 2008 Specialized Business Solutions | (800) 359-3458
Keystroke is trademark of Specialized Business Solutions. | All other products are trademarks or registered trademarks of their companies.