Copyright 2003 by Gasboy International LLC All rights reserved.
The information in this document is confidential and proprietary. No further disclosure shall be made without
permission from Gasboy International LLC. Gasboy International LLC believes that the information in this document
is accurate and reliable. However, we assume no responsibility for its use, nor for any infringements of patents or
other rights of third parties resulting from its use. We reserve the right to make changes at any time without notice.
GASBOY INTERNATIONAL LLC LANSDALE, PA
SITE CONTROLLER RELATED PUBLICATIONS
SITE CONTROLLER II - VERSION 2.3 AND LATER
Part No. Title
C09212 SC II Manager’s Manual
C01918 SC II Installation Manual
C09213 SC II Configuration Manual
C09159 SC II Pocket Reference
C09204 Check Point Reference Manual
C35745 Profit Point Clerk’s Manual
C35746 Profit Point Reference Manual
C35923 Point of Sale and Shift Change
SITE CONTROLLER III - VERSION 3.3 AND ABOVE
Part No. Title
C35920 CFN3 Manager’s Manual for Windows NT, version 3.3
C09326 CFN3 Configuration Manual for Windows NT, version 3.3
C35921 CFN3 Pocket Reference
C09204 Check Point Reference Manual
C35745 Profit Point Clerk’s Manual
C35746 Profit Point Reference Manual
C35923 Point of Sale and Shift Change, version 003
If necessary, begin by installing the shift-change package on the Site Controller. Follow the
instructions in the Installation section in this chapter.
Once the package has been installed on the Site Controller, the next step is to determine if the
Alter utility needs to be run. You need to run the Alter utility only if you want to change the
reports or the reports have not been configured. If you are upgrading the package and you are not
changing your reports, you don’t need to run Alter. If the reports have been preconfigured at the
factory you don’t need to run Alter. The instructions in the Installation section explain how to
determine if the reports have been configured. The Alter utility chapter takes you step by step
through the process of configuring the reports.
Once the reports are configured, you can start using the package. The Files, menus, and reports
chapter explains how to run the package on both the Profit Point and the Check Point. The default
package configuration prints reports on the receipt printer and saves ten days of journal log files on
the site. Refer to the Package configuration section in this chapter to change the defaults.
The information in the Command syntax chapter is useful for learning how to run the package
from the command line on the Site Controller. Normally, all of the commands are run from the
Profit Point or Check Point, so this portion of the manual is more of a reference for the advanced
user. This chapter is particular useful for users who dial into the site remotely to run scripts on the
Site Controller: this should only be done by personnel who understand the system at an advanced
level.
The information in the Report file formats chapter is useful for downloading the reports from the
Site Controller to a central office. This section of the manual contains both the file- naming
conventions and file formats
The information used to generate the reports is contained in files on the hard disk. The Disk journal layout chapter provides the technical information for interpreting disk journal files. It is a
reference for the advanced user who needs to download information from the Site Controller that is
not included in the reports. Journal files can be very large and take a long time to download, so you
want to download them only when you can’t obtain the information you need some other way.
The PLU merge file format chapter contains information on transferring pricing information to
Profit Points. This transfer is useful in controlling pricing from a central office. A central operator
can remotely upload the price changes to each of the stores, transfer the file to each Profit Point
and rest assured that all stores are selling items at the correct price.
INSTALLATION
For CFN3, the standard reporting package is automatically installed.
For CFN2, the standard reporting package is released on a separate disk labeled Standard
Reporting Package.
03/07/03 Gasboy CFN Series
2 Installation and Diagnostics Point of Sale and Shift Change
1. Insert the Standard Reporting Package disk into the floppy drive.
2. At the prompt, type INSTALL. Follow the prompts to complete the package installation. (Use
the -a option only at start-up as it is irreversible!)
3. To verify that the Unique shift #’s for every console parameter on page 9 of SYS_PAR is set
to Yes, at the prompt, type VARIABLE. Verify (on the second line) that there is a Y
following Unique on the next screen.
4. Make sure the Disk Journal entry on page 1 of SYS_PAR specifies: P:JOURNAL.LOG.
5. When the reporting package has been configured at the factory, the DAY.FMT and
SHIFT.FMT files are present in the P:BIN directory. To verify these files are present, at the
prompt type: DIR P:BIN/*.FMT.
6. If the DAY.FMT file is present, skip this step. Otherwise, at the prompt, typ e SETUP DAY.
Follow the prompts to complete the configuration of the end-of-day report.
7. If the SHIFT.FMT file is present, skip this step. Otherwise, at the prompt, type SETUP
SHIFT. Follow the prompts to complete the configuration of the shift report.
8. If you will be using clerk report and CLERK.FMT is not present, at the prompt type SETUP
CLERK. Follow the prompts to complete the configuration of the clerk report.
9. To verify that the reporting package has been installed and configured, sign on to each of the
Check Points or Profit Points, do a no-sale, and end the shift on each POS. After a shift report
has been printed on each of the Check Points or Profit Points, sign on to any Check Point or
Profit Point and end the day. An end-of-day report will be printed.
***** System Shift Variables by Console (003) *****
Site Shift Number: #1 Serial Number: #3 Unique: Y Final Drop: N
Current Day: Wed Previous Day: Wed # Days: 6 Init Bal: 150
Day Reports: 0 copies to Logger, 1 to Receipt printer
Shift Reports: 0 copies to Logger, 1 to Receipt printer
Clerk Reports: 0 copies to Logger, 1 to Receipt printer
Attendant Reports: 0 copies to Logger, 1 to Receipt printer
Audit Day Reports: 0 copies to Logger, 0 to Receipt printer
Audit Shift Reports: 0 copies to Logger, 0 to Receipt printer
Audit Clerk Reports: 0 copies to Logger, 0 to Receipt printer
Audit Attendant Reports: 0 copies to Logger, 0 to Receipt printer
Host OS version:
The Operating System/2 Version is 3.00
Console 1 Shift Number: #0 Serial Number: #4 Pending Close: N
Console 2 Shift Number: #0 Serial Number: #1 Pending Close: N
Console 3 Shift Number: #0 Serial Number: #2 Pending Close: N
Console 4 Shift Number: #0 Serial Number: #0 Pending Close: N
** Attendants
Attendant 1234 - Shift 2
Gasboy CFN Series 03/07/03
Point of Sale and Shift Change Installation and Diagnostics 3
PACKAGE CONFIGURATION
The SETUP command is used to set configuration variables-the number of days to maintain
previous log files, where and how many copies of each report to print, plus final safedrop
requirement.
For attendant the number digits, offset, whether to use the clerk number as the attendant number,
the tender to report on, optional second tender, and if to display tax.
SETUP works like SYS_PAR, displaying the configuration variables, allowing you to individually
change a configuration variable, displaying the changes, and saving the changes made only if you
elect to save them.
Run SETUP only afte r installation, and run it from the R* or A* prompt. After running the SETUP
command, you do not have to reboot for the changes to be effective.
SETUP -P will print the current configuration to the screen.
DIAGNOSTICS
The VARIABLE command is used to list shift variables for each POS.
• For each POS, a Y or N is used to indicate the status of pending closes for the prior shift. The
shift number remains at 0 during a shift until the clerk performs a reportable event.
• The version of the reporting package contained in VERSION.VAR in the P:REPORTS
directory is displayed in parentheses on the first line.
• The Unique shift #’s for every console parameter on page 9 of SYS_PAR is listed, with a N
for No and a Y for Yes.
• The final drop is listed, with a Y for final drop required and N for no final safe drop allowed.
• The file extension used for the current and previous days shift and end-of-day reports is listed
along with the numb e r o f days of previous log files to keep on line and the printer to print the
end-of-day report on.
• The Initial Drawer Balance is shown, a CF will show if set to carry forward Drawer Balance.
• The number of copies configured to print on the logger or receipt printer will be shown for
each type of report.
• Attendant Status will be shown if there is any activity.
The -L option is used with the variable comma nd to display the status of the variables every 5
seconds until a
The syntax for using the variable command is:
VARIABLE
VARIABLE -L
CTRL C is entered.
03/07/03 Gasboy CFN Series
2. Alter utility
INTRODUCTION
The Alter utility allows the standard shift end-of-day and clerk reports to be tailored to the
customer’s preferences. P rior to running the utility, the customer report order form must be
completed. The Alter utility prompts for information in the order it appears on that order form. The
utility runs on both the PC and the Site Controller.
Before starting
Before starting Alter, run the command:
A:print product;a>>log
to print a list of the departments and products you will be using. Make sure you know all of the
following:
• What are all the fuel products you will be using and what are their product numbers.
• What are all the merchandise products and departments you will be using, and what are their
product/department numbers.
• If you will be tracking any stock numbers on reports, know what their names and stock
numbers are.
• Know which departments and products you want to itemize on your reports, and which ones
you want to combine into one total. (A common mistake is to list too many departments in a
report, which can make the report too long to be useful.)
• Know what tenders you want to list on your reports.
• If you have any need to do refunds, payouts, or coupons which are treated as special
departments, know what product/department numbers to use.
• If you have offroad discounts, know what the discount and the offroad-tax product and
departments are.
If you are using a Check Point and you have any PLU products, they should have the same
category number of a product/department, and they should have type 9 enabled by the ENABLE
PRODUCT command.
The example shows a department, FOUNTAIN,
with four PLU products: coffee and small,
medium, and large drinks. The actual
department has the same product number as
category number. All PLUs assigned to that
department have t he same category number as
the product/department number (in this case,
35) of the department they are assigned to. All
PLUs also have type 9 enabled.
All products and departments should be loaded in the Site Controller before you run Alter.
Remember to enable special product types, such as: refunds and coupons (type 1), payouts (type
2), fuels (type 8), Check Point PLUs (type 9).
NOTE: Do not use # in the description of fuels, merchandise, or adjustments.
*PR PRO:AI 35
Pr Cat Name Enabled
35 35 FOUNTAIN 9
45 35 Coffee 9
46 35 Sm Drink 9
47 35 Md Drink 9
48 35 Lg Drink 9
03/07/03 Gasboy CFN Series
Point of Sale and Shift Change Alter utility 5
On the PC
To alter the standard shift report at the PC, type ALTER SHIFT. To alter the standard end-of-day
report at the PC, type ALTER DAY. To alter the clerk report, type ALTER CLERK.
On the Site Controller
To alter the standard shift report at the Site Controller, type SETUP SHIFT. To alter the standard
end-of-day report at the Site Controller, type SETUP DAY. To alter the standard clerk report at
the Site Controller, type SETUP CLERK.
After the Alter utility has completed, setup runs the
Lint utility which displays the amount of memory
used on the Site Controller as shown.
Total Program Space = 21632
(21Kbytes)
Total Buffer Space = 512
(0Kbytes)
Total Bytes Format File = 8994
(8Kbytes)
Grand Total Bytes = 31138
(30Kbytes)
Total Free Bytes = 18013
LOGGING EVENTS
Alter starts by prompting for events to be logged at the top of the report. You are prompted for
each event which may be logged. Events are logged in the order they occur. Press
exclude an event type from the log or press 1 then ENTER to include the event type in the log.
For example, the these
prompts would be
answered as shown to
log begin-shift, a dddrawer, safe-drop, and
end-shift events in the
standard shift report:
FUEL SALES
After the events to be logged have been selected, enter the product code and name for fuel
departments in the order they are to appear on the report. For shift and end-of-day reports, up to 9
fuel departments are usually listed (you can have up to 27, but if you exceed 9, you will not be able
to have the maximum number of merchand i s e departments or st ock numbers, adjustments, or
tenders). All fuel departments must be entered for the total fuel sales to equal the sum of all fuel
departments appearing on the report.
For example, if the first fuel department is Unleaded and the product code is 4, press
by ENTER to for the fuel department number and type Unleaded then press ENTER to enter the
description.
After the fuel department number and description have been entered, you must verify they are
correct. Press
with the fuel department product code.
Each time a fuel department has been entered and verified, you are prompted to enter the next fuel
department starting with the product code. Enter all fuel departments in the order you wish them to
ENTER to
Log Sign on Events? (Yes press 1, No press ENTER):↵
Log Sign off Events? (Yes press 1, No press ENTER):↵
Log Begin Shift Events? (Yes press 1, No press ENTER):1↵
Log Add Drawer Events? (Yes press 1, No press ENTER):1↵
Log Safe Drop Events? (Yes press 1, No press ENTER):1↵
Log Final Drop Events? (Yes press 1, No press ENTER):↵
Log End Shift Events? (Yes press 1, No press ENTER):1↵
Log Load Drawer Events? (Yes press 1, No press ENTER):↵
4 followed
ENTER to verify and accept, or re-enter the fuel department info rmation starting
03/07/03 Gasboy CFN Series
6 Alter utility Point of Sale and Shift Change
appear on the report. All fuel departments in the system must be listed on both the shift and end-ofday reports for the sum of individual fuel departments to equal the total fuel sales totals.
When you have entered and verified the last fuel department, press
ENTER to exit fuel sales and
continue with merchandise sales. Press ENTER a second time to verify you are done with fuel
sales or continue entering fuel departments. Pressing ENTER to the following two prompts exits
fuel sales.
After you enter and verify the maximum number of fuel departments, Alter automatically exits and
prompts for merchandise sales as shown.
Enter Fuel Department Number (Press ENTER to exit): 4 ↵
Enter Fuel Department Description: Unleaded ↵
Press ENTER to confirm Fuel Department #4 is Unleaded (or re-enter).
Enter Fuel Department Number (Press ENTER to exit):
Press ENTER to confirm (or re-enter).
Exiting, Maximum number of fuel departments reached.
Enter Merchandise Department/Stock Number (Press ENTER to exit):
MERCHANDISE SALES
When you exit fuel sales, you are prompted to enter the first merchandise department or stock
number appearing on the report. Up to 18 merchandise departments or stock numbers may usually
be listed on shift reports, and up to 27 merchandise departments or stock numbers may usually be
listed on end-of-day reports. (If you exceed these limits, you will have to make reductions in the
numbers of fuel departments, adjustments, or tenders you have.)
Merchandise departments
Merchandise departments range from 1 to 99 on both the Profit Point and the Check Point. For
example, if 36 is the number of your Soda department, the following prompts wo uld be answered
to enter and verify the Soda department:
Enter Merchandise Department/Stock Number (Press ENTER to exit): 36 ↵
Press ENTER if department or enter item modifier digit : ↵
Merchandise Department printed on Report? (Yes press 1, No press ENTER):1↵
Enter Merchandise Department Description: Soda ↵
Press ENTER to confirm Merchandise Department #36 is Soda (or re-enter): ↵
Stock numbers
Stock numbers range from 1 to 65,535. There is a major difference between Profit Point and
Check Point stock numbers:
• Profit Point stock numbers are three-to-five digits (100-65,535).
• Check Point stock numbers are two digits (1-99, the same as merchandise departments).
A modifier digit on the Profit Point allows the use of the same stock number for different sizes of
the product (see the next section, Modifier digits on the Profit Point for details).
Because merchandise departments do not have modifier digits, the modifier digit is used on the
Check Point to distinguish between merchandi se departments and stock numbers, since both are 1-
99.
Gasboy CFN Series 03/07/03
Point of Sale and Shift Change Alter utility 7
After entering the merc handise depart ment or stock number, the Press ENTER if department or
enter item modifier digit prompt appears. You can respond in these ways:
• Don’t enter a modifier digit when entering a merchandise department on either the Profit
Point or Check Point.
• Always enter a 0 modifier digit when entering a stock number on the Check Point.
• On the Profit Point, for stock numbers with modifier digits, enter a digit from 1 to 4. For
stock numbers that do not have a modifier digit, you may enter a 0 for the modifier digit or
simply press
ENTER .
Modifier digits on the Profit Point
As explained above, modifier digits allow the use of the same stock number for different sizes of
the product. For example, if the fountain department contained a single dr i nk stock number for
drinks of various sizes, then the following prompts would be answered for, in this example, stock
number 142:
Enter Merchandise Department/Stock Number (Press ENTER to exit): 142 ↵
Press ENTER if department or enter item modifier digit : 1 ↵
Enter Stock Item Description: 12 oz. drink ↵
Press ENTER to confirm Stock #142 is 12 oz. drink (or re-enter): ↵
Enter Merchandise Department/Stock Number (Press ENTER to exit): 142 ↵
Press ENTER if department or enter item modifier digit : 2 ↵
Enter Stock Item Description: 16 oz. drink ↵
Press ENTER to confirm Stock #142 is 16 oz. drink (or re-enter): ↵
Enter Merchandise Department/Stock Number (Press ENTER to exit): 142 ↵
Press ENTER if department or enter item modifier digit : 3 ↵
Enter Stock Item Description: 24 oz. drink ↵
Press ENTER to confirm Stock #142 is 24 oz. drink (or re-enter): ↵
Enter Merchandise Department/Stock Number (Press ENTER to exit): 142 ↵
Press ENTER if department or enter item modifier digit : 4 ↵
Enter Stock Item Description: 32 oz. drink ↵
Press ENTER to confirm Stock #142 is 32 oz. drink (or re-enter): ↵
Modifier digits on the Check Point
The alter native to using different modifier d igits for different sizes is a diffe rent stock number fo r
each size of a product, as illustrated in the following example. Stock numbers 60 through 63 are
stock numbers for the fountain department, with 60 being a 12 oz. refill, 61 a 16 oz. refill, 62 a 24
oz. refill and 63 a 32 oz. refill:
Enter Merchandise Department/Stock Number (Press ENTER to exit): 60 ↵
Press ENTER if department or enter item modifier digit : 0 ↵
Enter Stock Item Description: 12 oz. refill ↵
Press ENTER to confirm Stock #60 is 12 oz. refill (or re-enter): ↵
Enter Merchandise Department/Stock Number (Press ENTER to exit): 61 ↵
Press ENTER if department or enter item modifier digit : 0 ↵
Enter Stock Item Description: 16 oz. refill ↵
Press ENTER to confirm Stock #61 is 16 oz. refill (or re-enter): ↵
Enter Merchandise Department/Stock Number (Press ENTER to exit): 62 ↵
Press ENTER if department or enter item modifier digit : 0 ↵
Enter Stock Item Description: 24 oz. refill ↵
Press ENTER to confirm Stock #62 is 24 oz. refill (or re-enter): ↵
Merchandise Department/Stock Number (Press ENTER to exit): 63 ↵
Press ENTER if department or enter item modifier digit : 0 ↵
Enter Stock Item Description: 32 oz. refill ↵
Press ENTER to confirm Stock #63 is 32 oz. refill (or re-enter): ↵
03/07/03 Gasboy CFN Series
8 Alter utility Point of Sale and Shift Change
Nonprinting merchandise departments
You may want to print the sum of merchandise departments as a single line on the report. When
two or more merchandise department totals are included on a single line, designate all departments
that are to appear on the line as nonprinting, except for the last department. You will be pr o mpted
to enter the merchandise department description once, after yo u enter the first merchandise
department.
For example, if merchandise departments 10, 11, and 12 are to appear on the report as C Store,
then the following prompts would be answered as shown to enter and verify the C Store
merchandise de partment:
Enter Merchandise Department/Stock Number (Press ENTER to exit): 10 ↵
Press ENTER if department or enter item modifier digit : ↵
Merchandise Department printed on Report? (Yes press 1, No press ENTER): ↵
Enter Merchandise Department Description: C Store ↵
Press ENTER to confirm Merchandise Department #10 is C Store (or re-enter): ↵
Enter Merchandise Department/Stock Number (Press ENTER to exit): 11 ↵
Press ENTER if department or enter item modifier digit : ↵
Merchandise Department printed on Report? (Yes press 1, No press ENTER): ↵
Press ENTER to confirm Merchandise Department #11 is C Store (or re-enter): ↵
Enter Merchandise Department/Stock Number (Press ENTER to exit): 12 ↵
Press ENTER if department or enter item modifier digit : ↵
Merchandise Department printed on Report? (Yes press 1, No press ENTER): 1 ↵
Press ENTER to confirm Merchandise Department #12 is C Store (or re-enter): ↵
NOTE: You should use nonprinting merchandise departments sparingly. If the departments you
are summing belong to the same category, consider enabling product attribute 9.
Grouping items by department
While you may enter stock numbers and departments in any order, it is desirable to group items by
department. You should follow the selected items in the department by the department when all
items in that department have not been selected.
For example, if the tobacco department contains stock numbers 350, 351, 352, 271, 272, 273 and
you want to list only items 350 and 351 in merchandise sales, then answer the prompts as shown
below:
Enter Merchandise Department/Stock Number (Press ENTER to exit): 350 ↵
Press ENTER if department or enter item modifier digit : 0 ↵
Enter Stock Item Description: Cig. Pack ↵
Press ENTER to confirm Stock #350 is Cig. Pack (or re-enter): ↵
Enter Merchandise Department/Stock Number (Press ENTER to exit): 351 ↵
Press ENTER if department or enter item modifier digit : 0 ↵
Enter Stock Item Description: Generic Pack ↵
Press ENTER to confirm Stock #351 is Generic Pack (or re-enter): ↵
Enter Merchandise Department/Stock Number (Press ENTER to exit): 32 ↵
Press ENTER if department or enter item modifier digit : ↵
Merchandise Department printed on Report? (Yes press 1, No press ENTER): 1 ↵
Enter Merchandise Department Description: Tobacco ↵
Press ENTER to confirm Merchandise Department #32 is Tobacco (or re-enter): ↵
Do above items belong to Merchandise Department (Yes press 1, No press ENTER):1 ↵
Gasboy CFN Series 03/07/03
Point of Sale and Shift Change Alter utility 9
Total merchandise sales
On both the shift and end-of-day reports, the sum of departments and stock numbers on the report
should equal the Total Merchandise Sales. You can do this by:
• either listing all merchandise depa rtments on the report
• or using the optional miscellaneous taxable and non-taxable totals to included unlisted
merchandise departments.
After you have entere d and verified the merchandise departments and stock numbers that appea r in
merchandise sales, press
After you exit merchandise sales, you are asked if all merchandise departments have been listed. If
you want to include the miscellaneous taxable and non-taxable totals press
press 1 then ENTER .
Pressing
miscellaneous taxable and non-taxable totals on the report:
Enter Merchandise Department/Stock Number (Press ENTER to exit):↵
Press ENTER to confirm (or re-enter):↵
Have all merchandise departments been listed?(Yes press 1, No press ENTER):↵
ENTER to the following three prompts exits merchandise sales and includes the
After you enter and verify the maximum number of merchandise department/items, Alter
automatically asks if all merchandise departments have been listed:
Exiting, Maximum number of merchandise dept/item reached.↵
Have all merchandise departments been listed? (Yes press 1, No press ENTER):↵
ENTER twice to exit merchandise sales.
ENTER , otherwise
SALES ADJUSTMENTS
Offroad discount
When you exit merchandise sales, you are prompted for the product code of the Offroad Discount
department. If your site does offroad sales, enter the offroad discount product code, otherwise
simply press
For example, if the offroad discount product code is 16 and the offroad tax product code is 17,
then the following prompts would be answered as shown to enter and verify the offroad discount
departments:
Enter Offroad Discount Department Number (Press ENTER to exit): 16↵
Enter Offroad Tax Department Number (Press ENTER to exit): 17↵
Press ENTER to confirm Offroad Discount Department #16
and Offroad Tax Department #17 (or re-enter):↵
In some states, you might have an offroad discount department without an offroad tax departmentthat is, there is no offroad tax at your location. In this case, instead of setting up an offroad
discount department, set up the offroad discount as an adjustment department.
ENTER to continue with sales adjustments.
03/07/03 Gasboy CFN Series
10 Alter utility Point of Sale and Shift Change
Adjustment departments
After you have entered the offroad numbers, you are prompted to enter the product code and
description of the adjustment department in the order they will app ear on the report. All adjustment
departments-that is, all refund and payout departments-should be listed. The recommended
maximum number of adjustment departments is 7 (see the Table of recommended numbers at the
end of this chapter). Refund and payout departments may be listed in any order on the report.
For example, if the first line in sales adjustments is refund department Coupons with product code
40, then the following prompts would be answered as shown to enter and verify the Coupons
refund department:
Enter Adjustment Department Number (Press ENTER to exit): 40 ↵
Enter Adjustment Department Description: Coupons ↵
Payout Department (Yes press 1, No press ENTER): ↵
Press ENTER to confirm Refund Department #40 is Coupons (or re-enter): ↵
An example of a payout department with product code 39 is:
Enter Adjustment Department Number (Press ENTER to exit): 39 ↵
Enter Adjustment Department Description: Vendor Payout ↵
Payout Department (Yes press 1, No press ENTER): 1 ↵
Press ENTER to confirm Payout Department #39 is Vendor Payout(or re-enter):↵
After you have entered and verified all of the adjustment departments, press
sales adjustments and continue with payment types (also called tenders). Pressing ENTER to the
following two prompts exits sales adjustments:
Enter Adjustment Department Number (Press ENTER to exit):↵
Press ENTER to confirm (or re-enter):↵
After you enter and verify the maximum number of adjustment departments, Alter automatically
exits and prompts for tenders as shown below:
Exiting, Maximum number of adjustment departments reached.↵
Accept Checks (Yes press 1, No press ENTER):↵
ENTER twice to exit
PAYMENT TYPES
When you exit sales adjustments, you are prompted for each payment type (also called tender) that
may be accepted. Press
you do accept.
The recommended maximum number of authorized tenders is 9, in addition to the legal tenders,
checks, and food stamps (see the Table of recommended numbers at the end of this chapter).
Authorized tenders include club, debit, and credit cards.
Once you have accepted the maximum number of tenders or have been prompted for all tenders
that may be accepted, Alter exits tenders. After you exit tenders, you have the option to list all
credit tenders or group unlisted credit tenders in the Other Credit total line. Press
credit tenders: otherwise press 1 then ENTER .
For example, the following prompts would be answered as shown below to accept checks, food
stamps, club, VISA, MasterCard, and include the Other Credit total line:
Gasboy CFN Series 03/07/03
ENTER for tenders you don’t accept or press 1 then ENTER for te nders
ENTER to list all
Point of Sale and Shift Change Alter utility 11
Accept Checks (Yes press 1, No press ENTER): 1↵
Accept Food stamps (Yes press 1, No press ENTER): 1↵
Accept Club Cards (Yes press 1, No press ENTER): 1↵
Accept CENEX Regional (Yes press 1, No press ENTER):↵
Accept CENEX Local (Yes press 1, No press ENTER):↵
Accept CITGO Fleet (Yes press 1, No press ENTER):↵
Accept IAES (Yes press 1, No press ENTER):↵
Accept Debit checking (Yes press 1, No press ENTER):↵
Accept Debit savings (Yes press 1, No press ENTER):↵
Accept Wright Express (Yes press 1, No press ENTER):↵
Accept Amer Express (Yes press 1, No press ENTER):↵
Accept Visa (Yes press 1, No press ENTER): 1↵
Accept Master Card (Yes press 1, No press ENTER): 1↵
Accept Discover (Yes press 1, No press ENTER):↵
Accept FINA (Yes press 1, No press ENTER):↵
Accept AMOCO (Yes press 1, No press ENTER):↵
Accept CITGO Plus (Yes press 1, No press ENTER):↵
Accept Diamond Shamrock (Yes press 1, No press ENTER):↵
Accept CITGO Red (Yes press 1, No press ENTER):↵
Accept CITGO Silver (Yes press 1, No press ENTER):↵
...(your list may be longer)
Have all accepted credit tenders been listed?(Yes press 1, No press ENTER):↵
Pressing
1 then ENTER at the Have all accepted credit tenders been listed prompt accepts
what you have entered. Pressing ↵ will place Other Credit in the tenders column of the shift
report.
FUEL BY TENDER
For end-of-day reports, when you exit tenders, you are asked if you want to include the Fuel by
Tender section. Press
The prompt is:
Include Fuel by Tenders section? (Yes press 1, No press ENTER): 1 ↵
CASH WITHDRAWALS
When you exit Fuel by Tender, you are asked if you want to include Cash Withdrawals in the
Exceptions section. If you allow cash withdrawals, you usually want to list them as exceptions.
Press
1 then ENTER to list cash withdrawals; otherwise, simply press ENTER .
The Cash Withdrawal prompt is:
Include Cash Withdrawals? (Yes press 1, No press ENTER): 1 ↵
UPC ITEMS
When you exit Cash Withdrawals, you are asked if you want to include counts of scanned and
hand-entered UPC Items in the Sales Analysis section. If you are using Profit Points you usually
include UPC Items. Press
1 then ENTER to include this section, otherwise simply press ENTER .
1 then ENTER to include UPC Items; otherwise, simply press ENTER .
03/07/03 Gasboy CFN Series
12 Alter utility Point of Sale and Shift Change
The UPC Items prompt is:
Include UPC Items? (Yes press 1, No press ENTER): 1 ↵
PATRONAGE SALES
When you exit UPC Items, you are asked if you want to include the Patronage Sales section. Press
1 then ENTER to include the Patronage Sales section otherwise, simply press ENTER .
The Patronage Sales section prompt is:
Include Patronage Sales total? (Yes press 1, No press ENTER): 1 ↵
AVERAGE SECONDS
When you exit Patronage Sales, you are asked if you want to include the Average Seconds section.
If you are using Profit Points, you usually include the Average Seconds section. Press
ENTER to include the Average Seconds section otherwise, simply press ENTER .
The Average Seconds section prompt is:
Include Average Seconds section? (Yes press 1, No press ENTER): 1 ↵
1 then
SETTLEMENT AMOUNT
When you exit Average Seconds, yo u are asked if you want to include the Settlement Amount.
This section applies only to the end-of-day report, since settlements are reported only on a daily,
not shift, basis. Press
ENTER .
The Settlement Amount prompt is:
Include Settlement Amount? (Yes press 1, No press ENTER): 1 ↵
FINAL SAFEDROP
For shift reports, when you exit Average Seconds, you are asked if you want to i nclude Final
Safedrop in Drawer Accounting. If you require your clerks to change shift, count their drawer, and
record the final safe drop, then press
clerks to count their drawer and perform a safe drop prior to changing shift, then simply press
ENTER .
The Final Safedrop in Drawer Accounting prompt is:
Include Final Safedrop in Drawer Accounting? (Yes press 1, No press ENTER): 1 ↵
1 then ENTER to include the Settlement Amount, otherwise, simply press
1 then ENTER to include the safedrop. If you require your
Gasboy CFN Series 03/07/03
Point of Sale and Shift Change Alter utility 13
TABLE OF RECOMMENDED NUMBERS
The following table lists the recommended and maximum numbers of fuel, merchandise, and
adjustment departments for the shift and end-of-day reports.
(The recommended number of authorized tenders is 9 and there is no maximum number.)
The recommended number is adjusted upward for merchandise and adjustments when you enter
fewer than the recommended number of fuels or merchandise departments. When you use
merchandise departments that include items or nonprinti ng mer chandise departments, the
recommended number is adjusted downward.
Recommended Shift End-of-day
fuel 9 9
merchandise 18 27
adjustment 7 7
Maximum Shift End-of-day
fuel 27 27
merchandise 85 85
adjustment 99 99
03/07/03 Gasboy CFN Series
3. Command syntax
INTRODUCTION
This document lists the syntax for the command and executable files for the standard reporting
package on the Site Controller.
All of the commands that are run from the Profit Point menu may be run from the terminal by
typing in the command without any arguments: you are then prompted to enter the necessary
information to carry out the command.
Commands that are run from other commands-such as the NEX TSHFT command running the
NEXT CLERK command-normally require the command to be entered with all of the necessary
arguments. The syntax for all commands is shown in the rest of this chapter with the command
arguments.
None of the command files accessed by the clerk or manager menus (see the Files, menus, and reports chapter for a list of these command files) will run when the site is not configured to track
unique shifts per console.
CASH DRAWER COMMANDS
The four commands that affect the drawer are LDDRAWER, ADDRAWER, SAFEDROP, and
COUNT.
• Use the command LDDRAWER to enter the initial amount in the cash drawer at the beginning
of the shift on a POS. (This will be done automatically by the Site Controller if so configured
in SYS_PAR.)
• Use the commands ADDRAWER and SAFEDROP to reconcile a cash drawer amount when
you put money into or take money out of a cash drawer to adjust the till.
• When a final safe drop is required, use the COUNT command to enter the drawer balance and
final safe drop amount. You will be prompted for the ending drawer balance and asked to
confirm the final safe drop amount.
(Note that when running COUNT, you cannot reprint the final safe drop slip. This is because
the COUNT command creates two reports, safe drop and shift, and only the last one (the shift
report) can be reprinted.)
In addition to printing on the log printer, a slip is printed on the receipt printer when each of these
commands is run. Use the REPRINT command to print a copy of the slip if it is not automatically
printed.
The syntax for these commands is the command
followed by the POS number and dollar amount as
shown.
The SETUP SHIFT, SETUP DAY, and SETUP CLERK commands are used to customize the shift
and end-of-day reports on the site.
The SETUP commands make a copy of the existing format file that can be used to undo the
changes. After making a copy of the existing format file, SETUP runs the ALTER command to
create a new format file for either the shift or end-of-day reports. After the ALTER command
finishes, the FMTLINT command is run to output the memory utilization to the screen.
The syntax for using SETUP, ALTER, and FMTLINT are shown below:
SETUP SHIFT
SETUP DAY
SETUP CLERK
ALTER CLERK
ALTER SHIFT
ALTER DAY
NOTE: SETUP SHIFT -D, SETUP DAY -D, and SETUP CLERK -D are used to generate the
default report configuration for demo purposes. Running these command wipes out the existing
report configuration, so do not run them on a working site!
The syntax for using UNINSTAL to re cover the rep ort configurati on and ALTER for demo
purposes is:
SETUP SHIFT -D
FMTLINT [filename]
SETUP DAY -D
SETUP CLERK -D
END THE SHIFT
The NEXTSHFT command is used to change shift on a particular POS, each POS, create a clerk
report, or change shift for an attendant.
Loads next shift and prints report for console or clerk/fueler id number
n Changes shift for console n and prints shift report
-? Displays this message
-s Changes shift for all console at Site and prints unique shift reports
-c[n] Changes shift and prints report for Clerk id number n
-a[n] Changes shift and prints report for Attendant number n
-pn Prints report to console n.
-dn specifies n number of digits in attenda nt number.
-on specifies n number of offset digits into card data for attendant number.
The Unique shift #’s for every console parameter must be set to Yes, because the standard shift
format files do not support doing a shift change on the whole system. They support only shift
changes on a POS-by-POS basis.
03/07/03 Gasboy CFN Series
16 Command Syntax Point of Sale and Shift Change
POS
The NEXTSHIFT command defaults to the POS shift change and if no arguments are entered will
prompt for the POS#. The POS specified at the prompt or from the command line will change
shifts and a report will be printed unless no reportable activity has occurred at that POS. In that
case, an empty shift message will be given and the shift wo n’t change. The -s option changes shift
for each console at the site and prints unique reports.
Attempting to change shift on a POS when the prior shift has not closed results in a pending close
message and the site remaining in the same shift on that POS-provided that your setup has been
configured to require a final safe drop.
After the NEXTSHFT command has changed the shift on either the system or a POS, the
LISTNEXT command runs automatically in background to generate the shift report, if the finalsafe-drop option is disabled. When a final safe drop is required to close the shift, the data needed
to generate the shift report is stored in a file, and the shift report is generated after the final safe
drop has been made using the COUNT command.
Clerk/Fueler ID
The -c option specifies a c lerk report and although no shift is tracked for individual clerks, a report
will be generated on all activity of the clerk/fueler ID across the entire site to that point in the day.
If no clerk number is specified, you will be prompted.
A fueler ID can be assigned to an Island cluster using a fueler ID card or FUELER.BIN at the
terminal.
After the clerk is specified, LISTNEXT is called and runs in the background to generate the report.
Attendant
LISTNEXT
An attendant collects cash from customers at a full service island and charges the sale to a cash
card, (Gasboy Club card or if using the Attendant special handler GASBOY ACCESS CARD) on
an Island POS. When the attendant’s shift is over, or a cash drop is desired, the attendant will
change shift, and a slip will be printed. The slip will report the amount that attendant is responsible
for in that shift. The attendant shifts are tracked separately, and are independent from the POS and
site shifts. The attendant number is part of the account field on the club card and the number of
digits (up to 4 digits) and offset is configured using setup.
The -a option specifies an attendant shift change. A report of the attendant responsibility for that
shift will be printed and the change will be logged to the journal and the logger. The permission
level for the log event command must be set lower than that o f the user who will be running
NEXTSHIFT.
After the attendant is specified, LISTNEXT is called and runs in the background to generate the
report.
The possible LISTNEXT arguments include a filename which is the name of a journal file in the
P:REPORTS directory. The letter j can be used as an abbreviation for journal and p may be used
as an abbreviation for previous.
LISTNEXT creates a batch file on the PC to create the report.
The CASHIER or PRATTEND command is called by PC Batch file to output the shift report to
standard out and a flat file.
Gasboy CFN Series 03/07/03
Point of Sale and Shift Change Command Syntax 17
In each case, PC Batch file will also call PRNTRPT.CMD. PRNTRPT will print the report(s) to
the preconfigured printers, create backups and append the flat file if less than 24 hours have passed
since the last end of day.
The arguments specified by the standard shift format file are the shift reference number, shift
number, POS number, date, time, datetime, initial drawer balance and drawer count. The drawer
count is the amount of cash in the drawer just prior to the final safe drop. The clerk enters the
drawer count after running the count command to close the shift when set to require fina l safedrop.
The syntax for LISTNEXT, CASHIER, RPNRPT, and PRATTEND are shown below:
-an displays totals for attendant 'n'. if none, or -aAll, gives a totaled report of all.
-c[n] display totals for clerk 'n'.
-sn gives report for shift n.
-gn use 'n' digits for attendant number.
-on offset of 'n' digits into card data.
-tn(mm) designates tender type n and subtype mm to report for.
-p processes the previous journal file.
-e gives separate report for each attendant found.
-f outputs raw data into 'flatfile'.
-y date and time of report
-nx(-m) transaction number x or range. Will wrap after 9999
-x disp lay taxes separate.
infile - Journal file to process. Defaults to /jo urnal.log.
END THE DAY
The NEXTDAY command is used to end the day and begin a new day. The NEXTDAY command
runs the NEXT DAY command to close the current day. (Note that NEXTDAY and NEXT DAY
are not identical commands.)
When printing the end-of-day report on the receipt printer, use the POS number associated with the
receipt printer the end-of-day report will be printed on. If you are not printing the end- of-day
report on a receipt printer, enter any existing POS number (1-4).
The syntax for the NEXTDAY command is:
NEXTDAY [POS#]
Once the NEXT DAY command has begun, the LISTDAY 0 command is run in background to
wait for the NEXT DAY command to complete. The NEXT DAY command is complete when the
JOURNAL.LOG file is renamed PREVIOUS.LOG in the root directory. Immediately after the
NEXT DAY command completes, the LISTDAY 0 command moves the PREVIOUS.LOG file to
the P:REPORTS directory.
The Drop argument is either Y when the clerk is required to close the prior shift or N when the
clerk performs all safe drops prior to breaking shift.
When the day closes without being interrupted, the PREVIOUS.LOG file is not in the root
directory. So when you run the NEXTDAY command with a P REVIOUS.LOG file in the root
directory, the command assumes the day-closing has been interrupted and continues processing the
PREVIOUS.LOG file in the root directory without closing the current day. The NEXT DAY
command is not run and the LISTDAY 1 command is run in background to complete the
processing of the PREVIOUS.LOG file.
When the clerk is not required to close the prior shift, the LISTDAY command runs the
LISTNEXT command in background to generate shift reports and the LISTONE command to
generate the end-of-day report. W hen the clerk is required to close the prior shift, the data needed
to generate the shift report is stored in a file, and the shift report is generated after the final safe
drop has been made using the COUNT command.
After all shift reports have been processed, the LISTONE command is used to generate the end-ofday report. The end-of-day report is printed on the printer(s) it is configured to print on. When the
end-of-day report is configured to print on the receipt printer, the LISTONE command uses the
POS number associated with the receipt printer to determine which receipt printer will print the
report.
The syntax for the LISTNEXT command is the same as shown above for the NEXTSHFT
command. The syntax for the LISTONE command is:
LISTONE [Extension] [POS#] [Trans]
Trans is the transaction number of the last transaction of the previous day.
The LISTONE command runs CASHIER and PRBOTH to generate the end-of-day reports. The
arguments specified by the standard end-of-day format file are the day of the week, date, site ID,
system shift reference number and datetime. The arguments for PRBOTH are the journal log file
and the flat file.
The syntax for the CASHIER and PRBOTH commands is shown below:
PRBOTH is not supported in software versions below V3.4.
PRITEM.BIN and PRHOUR.BIN have been replaced by command files PRITEM.CMD and
PRHOUR.CMD, with the same syntax.
PRITEM [Journal] -f [Flat]
PRHOUR [Journal] -f [Flat]
PRNTRPT [Report type] [Report number] [Day of week extension] [Date and time][Printer
POS] [Report flag]
REPRINT A REPORT
The REPRINT command is used to reprint an existing shift or end-of-day rep ort.
The first argument is always the POS number of the receipt printer used to reprint the report,
followed by the type of report to be reprinted.
Gasboy CFN Series 03/07/03
Point of Sale and Shift Change Command Syntax 19
• The day argument is used to reprint the last end-of-day report.
• The last argument is used to reprint the last report reprinted on that receipt reprinter. The last
report includes shift and drawer accounting slips. Note that it is not possible to reprint the final
safe drop slip, since a shift report is always generated after the final safe drop.
• The pday argument is used to reprint an end-of-day report.
• The shft argument is used to reprint a shift report.
• The clrk argument is used to reprint a clerk report.
• The atnd argument is used to reprint an attendant report.
The syntax for the reprint command is:
REPRINT [Printer POS] day
REPRINT [Printer POS] last
REPRINT [Printer POS] pday [Day]
REPRINT [Printer POS] shft [Day] [Shift] [POS#]
REPRINT [Printer POS] clrk [Day] [clerk#]
REPRINT [Printer POS] atnd [Day] [attendant#]
REGENERATE A REPORT
NOTE: The serial numb er for all regenerated reports is zero.
The REPORT command is used to r egenerate shift and end-of-day reports using an existing jo urnal
file on the site.
The first argument is always the POS number of the receipt printer used to print the report,
followed by the type of report to be regenerated.
• To regenerate yesterday’s end-of-day report, use the yday argument.
• The pday argument is used to regenerate an end-of-day report using the file extension of the
journal log file’s name. The j ournal log file extension is a number that ranges from 1 to n,
where n is the maximum number of journal log files saved in the reports directory. The
variable n is set with the SETUP command.
• The shft argument is used to regenerate a shift report for the current day.
• The pshft argument is used to regenerate a shift report for a previous day using the file
extension of the journal log file.
• The clrk argument is used to regenerate a clerk report for the current day
• The pclrk argument is used to regenerate a clerk report for a previous day
• The atnd argument is used to regenerate an attendant report for the current day.
• The patnd argument is used to regenerate an attendant report for the previous day.
(The Attendant reports will be regenerated for the entire day, not per shift.)
Attempting to regenerate a shift report for the current shift or a shift greater than the current shift
results in the invalid shift message and no rep ort being genera ted.
Attempting to regenerate a shift report for the prior shift when the prior shift has not closed results
in the close in progress message and no report being generated.
Attempting to regenerate a shift report for any shift when the prior shift has not closed and the
current shift is empty results in the close in progress message and no report being gener ated.
The syntax for the REPORT command is:
The COMPARE command is used in command files to compare two character strings without case
sensitivity. COMPARE returns a value of zero when the two strings are equal.
The syntax for using the COMPARE command in a command file is:
COMPARE [string 1] [string 2]
THE AUDIT COMMAND
The AUDIT command is used to generate clerk, attendant, intra-shift and intra-end-of-day reportsin other words, a report on a shift or day before that shift or day has closed. Report files are
created, and printed if configured, and an Event is logged to the disk journal file.
The first argument is the POS number of the receipt printer used to print the report, followed by
the type of report to be generated.
The syntax for the AUDIT command is:
AUDIT [Printer POS] shft [Shift] [POS#]
AUDIT [Printer POS] day
AUDIT [Printer POS] clrk [clerk#]
AUDIT [Printer POS] atnd [attendant#]
To generate an intra-shift report, use the shft argument. To generate an intra-end-of-day report,
use the day argument.
The filenames for the shift audit reports are PASHF%S%C.%W and ashft%S%C.%W, where %S is
the shift number on console number %C, and %W is the day of the week.
The filenames for the day audit reports are PADAY.%W and ADAY.%W, where %W is the day of
the week.
The filename for the clerk audit report is PACL%C.%W where %C is the clerk number.
The filename for the clerk audit report is PAAT%A.%W where %A is the attendant number.
Gasboy CFN Series 03/07/03
Point of Sale and Shift Change Command Syntax 21
MISCELLANEOUS JOURNAL UTILITIES
PRVOID
PRBOTH
PRVOID.BIN displays all voids found in
the journal. It lists by console and shift, and
gives totals. You can also specify which
console or shift to report on.
PRVOID [-?] [-cn] [-sn] [-p]
[-f flatfile] [infile]
Processes the journal file specified by infile
and displays items voided by console.
-? Displays this message.
-c Di splays voids for co nsole n.
-s Displays voids for shift n.
-p Processes the previous journal file.
-f Outputs raw data into flatfile.
PRBOTH prints sale totals by item per hour
or both.
PRBOTH [-h] [-i|u] [[-]-r] [-u][-f
flatfile] [-p] [infile]
Processes the journal file specified by infile.
------>Subtotal for shift 1 $19.75
=======
>>Total for Console 4 2 $19.75
-------------------------------------->Total for Shift 1 $221.34
=======
>>Total All Voids 8 $221.34
PRTENDER
PRTENDER.BIN creates a report similar to the site PRINT TRANSACTION command. The
report is a file in the reports directory named ptend###.rpt where ### is the tender type and/or
subtype you which to report on. For example: prtender -t2 reports all credit transaction, prtender t324 reports citgo red credit transactions, -t0 reports all club card transactions.
PJ stands for Print Journal, and will display transactions and events recorded in the disk journal. PJ
supports a variety of command line arguments to customize the output.
Displays totals for attendant 'n' from infile and is illustrated under LISTNEXT.
GETLOG
GETLOG is not supported in software versions below V3.4.
GETLOG appends the standalone log file from one or more Profit Points to the journal.log file.
GETLOG [Profit Point #]
If you do not specify a number for the Profit Point, logs will be retrieved from all Profit Points and
appended to the journal.
The command file i s named getlog.cmd. I f you rename or copy getl og.cmd to event.cmd (in the
site's path) then each time a Profit Point comes up, its POS.log will be retrieved and appended to
the journal.log.
03/07/03 Gasboy CFN Series
Loading...
+ 78 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.