4680-4690 Supermarket Application

Support of 4610 Printer

Note
Before using this information and the product it supports, be sure to read the general information under Notices on page ix.
Second Edition (March 1998)
This is the second edition of the IBM 4680-4690 Supermarket Application: Support of 4610 Printer. This edition
applies to the 4680-4690 IBM Supermarket Application licensed program, program number 5799QYL PRPQ
P85532, and to all subsequent releases and modifications until otherwise indicated in new editions.
Copyright International Business Machines Corporation 1998. All rights reserved.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Notices. . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Preface. . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Chapter 1. Planning and Installing the 4610 Printer Feature . . . . . . . 1
4610 Printer Feature Introduction . . . . . . . . . . . . . . . . . . 1
4610 Printer Feature Prerequisites . . . . . . . . . . . . . . . . . . 2
Installing the 4610 Printer Feature . . . . . . . . . . . . . . . . . . 2
4610 Printer Feature Personalization . . . . . . . . . . . . . . . . . 2
Changing Terminal Options . . . . . . . . . . . . . . . . . . . . . 2
Selecting Enhanced Printing Options . . . . . . . . . . . . . . . . 5
Planning the Terminal Options for the 4610 Printer . . . . . . . . . . . 10
Handling Terminal Memory Requirements . . . . . . . . . . . . . . . 14
Descriptors for the 4610 Printer Feature . . . . . . . . . . . . . . . 14
Sales Descriptors for the 4610 Printer Feature . . . . . . . . . . . . 14
Report Descriptors for the 4610 Printer Feature . . . . . . . . . . . . 15
Specifications for Combining Like Items and Grouping By Department . . . . 16
Combine Like items . . . . . . . . . . . . . . . . . . . . . . 16
Price Override . . . . . . . . . . . . . . . . . . . . . . . . 16
Type 2 UPCs (Imbedded Prices) . . . . . . . . . . . . . . . . . 16
Weighted Items. . . . . . . . . . . . . . . . . . . . . . . . 17
Department Key Items . . . . . . . . . . . . . . . . . . . . . 17
Price Required Items. . . . . . . . . . . . . . . . . . . . . . 17
Miscellaneous Sales . . . . . . . . . . . . . . . . . . . . . . 17
Item Exceptions . . . . . . . . . . . . . . . . . . . . . . . 17
Pricing Methods . . . . . . . . . . . . . . . . . . . . . . . 17
Linked Items. . . . . . . . . . . . . . . . . . . . . . . . . 17
Coupons . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Group by Department . . . . . . . . . . . . . . . . . . . . . 17
Chapter 2. 4610 Printer Feature Operations . . . . . . . . . . . . . 19
Customer Checkout Procedures . . . . . . . . . . . . . . . . . . 19
End of Transaction for Sales Transactions . . . . . . . . . . . . . . 19
Partial Receipt Print on Demand . . . . . . . . . . . . . . . . . 20
Non-Sales and No-Sales Transactions . . . . . . . . . . . . . . . 21
System Error Messages . . . . . . . . . . . . . . . . . . . . . 21
Runtime Error Codes . . . . . . . . . . . . . . . . . . . . . . 21
Errors at the Terminal . . . . . . . . . . . . . . . . . . . . . . 21
4610 Printer Restrictions . . . . . . . . . . . . . . . . . . . . . 21
Suspend/Retrieve . . . . . . . . . . . . . . . . . . . . . . . 22
Transaction Types that Stop Combining/Grouping and Separating of Items 22
Chapter 3. 4610 Printer Feature Programmers Information . . . . . . . 23
I/O Session Numbers . . . . . . . . . . . . . . . . . . . . . . 23
4610 Printer Feature Global Variables . . . . . . . . . . . . . . . . 24
4610 Printer Feature Common Routines . . . . . . . . . . . . . . 24
Duplicate Receipt/Post Printing Buffering . . . . . . . . . . . . . . . 25
Terminal Sales User Exits . . . . . . . . . . . . . . . . . . . . . 27
Copyright IBM Corp. 1998 iii
WRITE FORM . . . . . . . . . . . . . . . . . . . . . . . . . 27
Saving and Restoring Fonts . . . . . . . . . . . . . . . . . . . . 27
Font Selection User code . . . . . . . . . . . . . . . . . . . . . 27
Submitting Print Lines for Post Printing and Multiple Receipt Printing . . . . . 28
Modules for Partial Receipt Print on Demand. . . . . . . . . . . . . . 29
Reprint Receipt Using 15 SIGNON . . . . . . . . . . . . . . . . . 29
Supermarket Database EAMP4nnn . . . . . . . . . . . . . . . . . 29
Alternate Menu Support . . . . . . . . . . . . . . . . . . . . . 30
iv 4610 Supermarket Application Printer Support
Figures
1. Application Personalization . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Supermarket Features Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. Personalize Extended Terminal Options Menu . . . . . . . . . . . . . . . . . . . . 4
4. Change 4610 Extended Terminal Options . . . . . . . . . . . . . . . . . . . . . . 4
5. Duplicate Receipt Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
6. Check Printing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
7. Printer Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
8. Post Transaction Printing Options . . . . . . . . . . . . . . . . . . . . . . . . . 7
9. Sales/Returns/Coupons Header Font Attributes . . . . . . . . . . . . . . . . . . . . 8
10. Sales, Return, and Coupon Section Headers . . . . . . . . . . . . . . . . . . . . . 9
11. 4610 Printer Station Paper Widths . . . . . . . . . . . . . . . . . . . . . . . . 10
12. Duplicate Receipt Printing Worksheet . . . . . . . . . . . . . . . . . . . . . . . 10
13. Check Printing Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
14. Error Handling Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
15. Post Transaction Printing Worksheet . . . . . . . . . . . . . . . . . . . . . . . 13
16. Sales, Returns, and Coupons Section Headers Worksheet . . . . . . . . . . . . . . . 13
17. Printer Station Widths Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . 14
Copyright IBM Corp. 1998 v
vi 4610 Supermarket Application Printer Support
Tables
1. I/O Session Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2. Terminal Sales Common Routines . . . . . . . . . . . . . . . . . . . . . . . . 24
3. Customer Receipt Buffer Format . . . . . . . . . . . . . . . . . . . . . . . . . 25
Copyright IBM Corp. 1998 vii
viii 4610 Supermarket Application Printer Support
Notices
References in this publication to IBM products, programs, or services do not imply
that IBM intends to make these available in all countries in which IBM operates. Any
reference to an IBM product, program, or service is not intended to state or imply
that only IBMs product, program, or service may be used. Any functionally
equivalent product, program, or service that does not infringe any of IBMs
intellectual property rights may be used instead of the IBM product, program, or
service. Evaluation and verification of operation in conjunction with other products,
except those expressly designated by IBM, are the users responsibility.
IBM may have patents or pending patent applications covering subject matter in this
document. The furnishing of this document does not give you any license to these
patents. You can send license inquiries, in writing, to the IBM Director of Licensing,
IBM Corporation, 500 Columbus Avenue, Thornwood, NY 10594 USA.
Trademarks
The following terms are trademarks of the IBM Corporation in the United States or
other countries or both:
IBM
Other company, product, and service names, which may be denoted by a double
asterisk (**), may be trademarks or service marks of others.
Copyright IBM Corp. 1998 ix
x 4610 Supermarket Application Printer Support
Preface
This manual provides the information needed to install, operate and maintain the
software for the IBM 4680-4690 Supermarket Support of 4610 Printer.
This document contains three major sections and one appendix.
v Chapter 1. Planning and Installing the 4610 Printer Feature on page 1.
v Chapter 2. 4610 Printer Feature Operations on page 19.
v Chapter 3. 4610 Printer Feature Programmers Information on page 23.
Copyright IBM Corp. 1998 xi
xii 4610 Supermarket Application Printer Support
Chapter 1. Planning and Installing the 4610 Printer Feature
This section provides information about:
v Product introduction
v Installation prerequisites
v Feature personalization and options planning
v Terminal memory requirements
v Sales and report descriptors.
4610 Printer Feature Introduction
The IBM 4680-4690 Supermarket Application Support of the 4610 Printer provides
enhanced printing capabilities for the terminals in your store. In addition to the usual
printing requirements, the 4610 printer:
v Quickly performs post transaction printing. Post transaction printing allows you to
wait until the end of the transaction before printing the receipt.
v Prints from 1 to 9 receipts.
v Flips a check automatically so that check MICR reading, check face printing, and
franking is performed with minimal intervention from the operator.
Printing the entire receipt at one time optimizes the printing speed of the printer and
enables additional capabilities that may be customized to perform any of the
following functions:
v Combine identical items into one entry.
v Sort items in the post transaction, printed receipt by department number in
ascending order.
v Remove voided items on the post printed receipt if the PLU and price match a
previous item.
v Separate items sold, items returned, and coupons into their own groups on the
post transaction, printed receipt.
v Create your own unique header lines for each section of the receipt (for example,
sales, returns, and coupons). Up to three lines may be configured for each
header.
v Select both Combine Identical Items and Group by Department. This decision
should be tested on your hardware platform to ensure you achieve acceptable
performance.
v Enable one or multiple receipts to be reprinted in post printing using the keying
sequence 15 SIGNON (using user code provided in Reprint Receipt Using 15
SIGNON on page 29 and with post printing enabled).
The 4610 printer has two print stations, a ribbon cartridge, and buttons for
controlling the paper advance and testing the printer. The two print stations are:
v The thermal customer receipt station
v The impact document insert station, for printing on an inserted document, such
as a check or a form
Note: The 4610 printer does not have a summary journal station. Electronic
journaling is handled through an application function
The 4610 cable plugs directly into socket 7 on the terminal system unit.
Copyright IBM Corp. 1998 1
4610 Printer Feature Prerequisites
The 4610 Printer Feature has several prerequisites for installation:
v IBM 4690 Operating System V1, Maintenance Level 9750 or higher
v IBM 4680-4690 Supermarket Application, Maintenance Level 9801 with EFIX
1963
v IBM 4680-4690 Supermarket Support of 4610 Printer, PRPQ P85532, program
number 5799-QYL
v Electronic Journal capability, such as IBM Electronic Journal for 4690, PRPQ
P85520, program number 5799-QXL
v If you are using IBM Electronic Marketing, program number 5799-PHN, you need
the Electornic Marketing EFIX 1959
Refer to the IBM 4690 Operating System: Users Guide for information on how to
install optional development support programs.
Installing the 4610 Printer Feature
The programs and data for this feature are supplied on the 4610 Printer Feature
Installation diskette. Follow the instructions provided in the README file on the
diskette.
To view the README file:
1. Insert the 4610 printer feature diskette into drive A: of the store controller.
2. From the system main menu Type 7 and press Enter to select Command Mode.
3. Type TYPE A:README.DOC | MORE to display the README file.
4. Follow the instructions in README.DOC to complete the installation of the
feature software.
4610 Printer Feature Personalization
Each terminal can have its own extended terminal options file, or one or more
terminals can use the extended terminal default file (EAMP4000). The application
provides this default file. You can change the default file during personalization, but
you should not delete it. You can also add, change, delete, or print option files for
specific terminals. When adding a new options file, use a previously defined file as
a model to save time.
You must create a set of options for each terminal in a unique group. You will need
a set of extended terminal options worksheets for each unique group of terminals.
Number each set to correspond to the terminal numbers to which they apply.
The only shared set of options is terminal 000. If you do not specify an extended
options record for a terminal, the terminal 000 extended options record is used. If a
terminal finds its own set of options, it ignores the 000 set of options.
Changing Terminal Options
This section describes the IBM 4610 Printer Feature terminal options and should be
used in conjunction with the IBM 4680-4690 Supermarket Application: Guide to
Operations.
2 4610 Supermarket Application Printer Support
|
|
When you install the 4680-4690 Supermarket 4610 Printer Feature, the 4610
extended terminal options for the IBM 4610 printer are installed as a Supermarket
Feature and, as such, are accessible through the Supermarket Features menu
selection on the Application Personalization screen as selection number 7 shown in
Figure 1.
Type 7 and press Enter. The Supermarket Features menu displays. The exact
selection number for the 4610 Extended Terminal Options feature depends on the
other Supermarket features you have already installed. Type the selection number
for 4610 Extended Terminal Options. In Figure 2, the selection number is 3.
After selecting 4610 Extended Terminal Options, the menu in Figure 3 on page 4
displays.
This screen is identical to that presented by the standard supermarket terminal
options and functions in an identical manner. From this screen, you can change,
APPLICATION PERSONALIZATION
Select one of the following to personalize:
1 Terminal Options
2 Store Options
3 Tax Tables
4 Descriptors
5 User Procedure
6 Item Record File Procedures
7 Supermarket Features
Type your selection number, then press Enter. 7
F1HELP F2 F3QUIT F4 F5 F6 F7 F8 F9AUDIT F10
Figure 1. Application Personalization
Supermarket Features PAGE 1
Select one of the following:
1 Unattended Close Personalization
2 EFT Store Options
3 4610 Extended Terminal Options
4 Check Personalization
5 Terminal Logging/Item Lookup
Type your selection number, then press ENTER. 3
F1 F2 F3QUIT F4 F5 F6 F7 F8 F9 F10
Figure 2. Supermarket Features Menu
Chapter 1. Planning and Installing the 4610 Printer Feature 3
add, copy, erase, or print a set or sets of terminal options. The remainder of this
section is an example of the screens used to change a set of options for terminal
number 2.
Type 1 and the number of the terminal (2 in this example) and press Enter. The
Change 4610 Extended Terminal Options menu displays as shown in Figure 4.
Choosing selection 1 (All Terminal Options) allows both options groups, Enhanced
Printing Options and IBM 4610 Options, to be changed at the same time. Selections
2 and 3 allow modifications to the specific option groups Enhanced Printing Options
and IBM 4610 Printer Options, respectively.
PERSONALIZE 4610 EXTENDED TERMINAL OPTIONS
Select one of the following:
1 Change a Set of Options
2 Add a Set of Options
3 Copy a Set of Options
4 Erase a Set of Options
5 Print a Set of Options
Type your selection number. 1
Type the number of the terminal for which
options are being processed. 2
When complete, press Enter.
F1HELP F2 F3QUIT F4 F5 F6 F7 F8 F9AUDIT F10
Figure 3. Personalize Extended Terminal Options Menu
CHANGE 4610 EXTENDED TERMINAL 2 OPTIONS Page 1 of 1
Terminal 2
Select one of the following:
1 All Terminal Options
2 Enhanced Printing Options
3 IBM 4610 Printer Options
Type selection number, then press Enter. 2
F1HELP F2 F3QUIT F4 F5 F6 F7 F8 F9 F10
Figure 4. Change 4610 Extended Terminal Options
4 4610 Supermarket Application Printer Support
Selecting Enhanced Printing Options
This section shows the Enhanced Printing Options screens. From these screens,
you can select various enhanced printing options for your system.
Number of Duplicate Copies
This option controls the number of duplicate customer receipts to print at the
end-of-transaction. A duplicate receipt is an exact copy of the original receipt. The
number specified in this option is the number of extra receipts printed after the
original receipt. Setting the Number of Duplicate Copies to 0 specifies that only the
original receipt is printed. Setting this field to n specifies that the original receipt and
n duplicates are printed. You can print up to 8 duplicates. The original receipt is
either printed during the transaction, or post-printed at the end-of-transaction
depending on the settings of other options. If the number of duplicate copies is set
to zero, the second option (Automatic Duplicate Print) is hidden because it does not
apply.
Reprinted Receipts
In this version of the PRPQ you can enable an option to reprint one or multiple
receipts at the end of a transaction by using a key sequence. There are three
requirements that must be met before you can use this post-print option. First, you
must enter a 9 in the Number of Duplicate Copies field. Second, you must either
have APAR IR36937, which defines the function used or integrate the user code
provided in User Exit 6. (See Reprint Receipt Using 15 SIGNON on page 29 for
the user code.) Third, you must select post printing.
ENHANCED PRINTING OPTIONS Page 1 of 6
Terminal 2
DUPLICATE RECEIPT PRINTING
Type the necessary information to control duplicate receipt printing.
NUMBER OF DUPLICATE COPIES 0 Number of duplicate receipt copies to
print.
NOTE: If 9 is selected for NUMBER OF DUPLICATE COPIES and the
post printing option is enabled, receipts can be reprinted outside
of a transaction by entering 15 SIGN ON/OFF. The user will not
be prompted to reprint receipts at the end of a transaction. If
not post printing, (i.e. line by line printing), then 9 copies
will be printed just as any other number. See help for details.
For additional print selections, press PgDn. If complete, press Enter.
F1HELP F2 F3QUIT F4 F5 F6 F7 F8 F9 F10
Figure 5. Duplicate Receipt Printing
Chapter 1. Planning and Installing the 4610 Printer Feature 5
Pause Before Printing
This option specifies whether an operator prompt to insert a check for printing
displays. If this option is set to Y, the insert check prompt is presented to the
operator of the terminal regardless of the presence of a check in the document
insert station.
Print Check Face
This option allows the check printing feature to be enabled or disabled. Setting this
option to N is equivalent to assigning a check format of zero to the check tender
using the standard Tender Definition options.
Override Out of Paper Error
This option allows a manager to override an out-of-paper error on the customer
receipt station. If this error is overridden by a manager at the terminal, then any
ENHANCED PRINTING OPTIONS Page 2 of 6
Terminal 2
CHECK PRINTING OPTIONS
Type the necessary information to control check printing.
(Y/N)
PAUSE BEFORE PRINTING N Prompt for check insertion before
check printing.
PRINT CHECK FACE Y Print face of check after check franking.
For additional print selections, press PgDn. If complete, press Enter.
F1 F2 F3QUIT F4 F5 F6 F7 F8 F9 F10
Figure 6. Check Printing Options
ENHANCED PRINTING OPTIONS Page 3 of 6
Terminal 2
PRINTER ERROR HANDLING
Type the necessary information to control printer error handling.
(Y/N)
OVERRIDE OUT-OF-PAPER ERROR N Allow manager to override out-of-paper
errors.
For additional print selections, press PgDn. If complete, press Enter.
F1 F2 F3QUIT F4 F5 F6 F7 F8 F9 F10
Figure 7. Printer Error Handling
6 4610 Supermarket Application Printer Support
subsequent out-of-paper errors from the customer receipt are ignored and the
application is allowed to continue until the current transaction is completed. This
allows a terminal with a faulty printer to complete its current transaction without
holding up the customer.
Print Post Transaction
This option specifies whether to print the (original) customer receipt during the
transaction or at the end of the transaction. If this option is set to N, the customer
receipt is printed during the transaction and all other post-printing options on this
screen are unavailable and are hidden. If the option is set to Y, the customer
receipt is buffered during the transaction and printed at the end of the transaction.
This facility allows the receipt to be altered or cleaned in various ways before
actually printing it. Therefore, the remaining options on this screen are available and
visible only if Print Post Transaction is set to Y.
Combine Identical Items
This option allows a post-printed receipt to be altered by combining sales items by
their item number. All items that are identical are grouped together so that all
occurrences of an item are listed together on the receipt as if the item was sold
using the Quantity Key. (Please see Specifications for Combining Like Items and
Grouping By Department on page 16 for details.)
Group Department Sales
This option allows a post-printed receipt to be altered by grouping sales items by
their department. All items are sorted by their department and are printed on the
receipt by department in ascending order.
ENHANCED PRINTING OPTIONS Page 4 of 6
Terminal 2
POST TRANSACTION PRINTING
Select (Y=Yes, N=No) to delay receipt printing until end of transaction
and to configure the appearance of the receipt if this option is chosen.
(Y/N)
PRINT POST TRANSACTION Y Delay printing until end of transaction.
COMBINE IDENTICAL ITEMS Y Group sales of identical items on the
receipt.
GROUP DEPARTMENT SALES N Group sales of items from within the same
department on the receipt.
REMOVE VOIDED ITEMS Y Do not print voided items.
SEPARATE SALES,RETURNS,CPNS Y Print all returns and coupons separately
from normal sales information.
SALE/RETURN/COUPON HEADERS Y Print headings before Sales, Returns and
Coupons receipt sections.
For additional print selections, press PgDn. If complete, press Enter.
F1 F2 F3QUIT F4 F5 F6 F7 F8 F9 F10
Figure 8. Post Transaction Printing Options
Chapter 1. Planning and Installing the 4610 Printer Feature 7
Remove Voided Items
This option allows item voids to be removed from a post-printed receipt. Voids will
be removed if the PLU and price match previous items.
Separate Sales, Returns, and Coupons
This option allows item sales, returns, and coupons to be separated (and grouped)
into three sections on a post-printed receipt. If this option is set to Y, the Sales,
Returns, and Coupons Headers option is available. In addition, a separate screen
(Figure 9) is displayed to customize the lines of each header section.
Sales, Returns, and Coupon Section Headers
This option allows printing of sale, return, and coupon header lines on a
post-printed receipt. above their respective sale and return sections. The header
lines to be printed are defined on the next personalization screen shown in
Figure 10 on page 9.
SALES/RETURNS/COUPONS HEADER FONT ATTRIBUTES PAGE 5 of 6
TERMINAL 2
SALES LINE | RETURN LINE | COUPON LINE
1 2 3 | 1 2 3 | 1 2 3
-----------|-------------|------------
| |
Inter-char spacing: 3 3 3 | 3 3 3 | 3 3 3 (3-8)
| |
A or B font: A A A | A A A | A A A (A or B)
| |
Overlined: N N N | N N N | N N N (Y or N)
| |
Emphasized: N N N | N N N | N N N (Y or N)
| |
Double-High: N N N | N N N | N N N (Y or N)
| |
Double-Wide: N N N | N N N | N N N (Y or N)
| |
Inverted Mode: N N N | N N N | N N N (Y or N)
| |
Underlined: N N N | N N N | N N N (Y or N)
For additional print selections, press PgDn. If complete, press Enter.
F1HELP F2 F3QUIT F4 F5 F6 F7 F8 F9 F10
Figure 9. Sales/Returns/Coupons Header Font Attributes
8 4610 Supermarket Application Printer Support
IBM 4610 Printer Stations Width Options
The 4610 printer station width options are currently the only options specific to the
4610 printer. These customer and document insert station width settings are the
default characters-per-line for the two printer stations. This is accomplished by
setting the inter-character spacing for resident font A of the IBM 4610 printer. The
settings of 38, 40, 44, 48, and 52 map to font inter-character spacings of 5, 4, 3, 2,
and 1 for the customer receipt station and 3, 3, 2, 1, and 1 for the document insert
station.
The settings 38, 40, 44, 48, and 52 correspond approximately to 13.6, 14.5, 15.5,
17, and 18.5 characters per inch, respectively, on the customer receipt printer. The
settings 38, 40, 44, 48, and 52 correspond approximately to 15, 15, 16.7, 18.7, and
18.7 characters per inch, respectively, on the document insert station. Figure 11 on
page 10 shows the personalization screen to set the default widths.
ENHANCED PRINTING OPTIONS PAGE 6 of 6
TERMINAL 2
POST TRANSACTION PRINTING
Enter the required Sales, Return, and Coupon Section Heading text.
SALES LINE 1 ***************************************************
SALES LINE 2 * Regular Items *
SALES LINE 3 ***************************************************
RETURNS LINE 1 ***************************************************
RETURNS LINE 2 * Returned Items *
RETURNS LINE 3 ***************************************************
COUPONS LINE 1 ***************************************************
COUPONS LINE 2 * Coupons *
COUPONS LINE 3 ***************************************************
If complete, press Enter.
F1 F2 F3QUIT F4 F5 F6 F7 F8 F9 F10
Figure 10. Sales, Return, and Coupon Section Headers
Chapter 1. Planning and Installing the 4610 Printer Feature 9
Planning the Terminal Options for the 4610 Printer
For general notes on the planning of terminal options see the IBM 4680-4690
Supermarket Application: Planning and Installation Guide. This section only
describes those options that are specific to the 4610 printer feature. Unless
otherwise stated all other terminal options described in the IBM 4680-4690
Supermarket Application: Planning and Installation Guide remain unchanged
Planning for Duplicate Receipt Printing Options
Plan for the following options to set up 4610 printers to operate with the
Supermarket Application. Use the worksheet in Figure 12.
Number of Duplicate Receipts: Choose: 0 through 8
Default: 0
This sets the number of duplicate receipts that are printed after the original or initial
printed receipt.
Planning for Check Printing Options
Plan for the following options to set up 4610 printers to operate with the
Supermarket Application. Use the worksheet in Figure 13 on page 11.
Pause before Printing: Choose: Y (Yes) or N (No)
IBM 4610 PRINTER OPTIONS Page 1 of 1
Terminal 2
4610 PRINTER STATION WIDTHS
Select the default widths (38, 40, 44, 48, or 52 characters per line)
for the 4610 Customer Receipt and Document Insert stations.
DEFAULT CUSTOMER RECEIPT WIDTH 38 Default width for Customer Receipt
station.
DEFAULT DOCUMENT INSERT WIDTH 38 Default width for Document Insert
station.
If complete, press Enter.
F1 F2 F3QUIT F4 F5 F6 F7 F8 F9 F10
Figure 11. 4610 Printer Station Paper Widths
Duplicate Receipt Printing Worksheet
TERMINAL ___
NUMBER OF DUPLICATE COPIES _ Number of duplicate receipt copies to
(0) print.
Figure 12. Duplicate Receipt Printing Worksheet
10 4610 Supermarket Application Printer Support
Default: N
Choosing Y causes an insert check operator prompt to appear even if a check is
present in the document insert station.
Print Check Face: Choose: Y (Yes) or N (No)
Default: N
Choosing Y enables check face printing. Choosing N disables check face printing
and is equivalent to assigning check format zero to the check tender type using the
standard terminal options/tender type definitions.
Planning for Error Handling Options
Plan for the following options to set up 4610 printers for error recovery. Use the
worksheet in Figure 14.
Override Out-of-Paper Error: Choose: Y(Yes) or N(No)
Default: N
Choosing Y allows a manager override of an out-of-paper error on the customer
receipt station, which enables terminal operation to continue even while that error
condition is present.
Planning for Post Transaction Printing Options
Plan for the post transaction printing options. Use the worksheet in Figure 15 on
page 13.
Print Post Transaction: Choose: Y(Yes) or N(No)
Check printing Worksheet
TERMINAL ___
PAUSE BEFORE PRINTING _ Prompt for check insertion before check
(N) printing.
PRINT CHECK FACE _ Print face of check after check franking
(N)
Figure 13. Check Printing Worksheet
Printer Error Handling Worksheet
TERMINAL ___
OVERRIDE OUT-OF-PAPER ERROR _ Allow manager to override 'out-of-paper'
(Y/N) errors.
Figure 14. Error Handling Worksheet
Chapter 1. Planning and Installing the 4610 Printer Feature 11
Default: N
If N is selected, no other post printing options are available. If Y is selected, printing
of the customer receipt is delayed until the end of the transaction, and other post
printing options are available for controlling the information that prints on the
receipt.
Combine Identical Items: Choose: Y(Yes) or N(No)
Default: N
Choosing Y groups items of the same item code together on the receipt. Note that
coupons are treated normally.
Group Department Sales: Choose: Y(Yes) or N(No)
Default: N
Choosing Y groups items belonging to the same department number together on
the receipt.
Remove Voided Items: Choose: Y(Yes) or N(No)
Default: N
Choosing Y removes voided item lines and the original item lines from the customer
receipt.
Separate Sales, Returns, Coupons: Choose: Y(Yes) or N(No)
Default: N
Choosing Y separates sale items from return items and coupons on the receipt.
Sale/Return/Coupon Section Headers: Choose: Y(Yes) or N(No)
Default: N
Choosing Y prints user-defined sale, return, and coupon header lines on the
customer receipt above their respective sections
12 4610 Supermarket Application Printer Support
Sales and Returns Section Headers
Plan for the sales, returns, and coupon section headers on the receipt. Use the
worksheet in Figure 16.
Choose: 0 characters through 56 characters.
Default: Null string.
The following worksheet highlights the section heading input fields. Note that the
maximum length of the header is determined by the customer receipt width chosen
in width options.
Planning for the 4610 Printer Station Widths
Plan for the 4610 printer station widths for the customer receipt and document
insert stations. Use the worksheet in Figure 17 on page 14.
Default Customer Receipt Width: Choose: 38, 40, 44, 48, or 52.
Post Transaction Printing Worksheet
TERMINAL ___
PRINT POST TRANSACTION _ Delay printing until end of transaction.
(Y/N)
COMBINE IDENTICAL ITEMS _ Group sales of identical items on the
(Y/N) receipt.
GROUP DEPARTMENT SALES _ Group sales of items from within the same
(Y/N) department on the receipt.
REMOVE VOIDED ITEMS _ Do not print voided items.
(Y/N)
SEPARATE SALES,RETURNS,CPNS _ Print all returns separately from normal
(Y/N) sale information.
SALE/RETURN/COUPON HEADERS _ Print headings before Sales and Returns
(Y/N) receipt sections.
Figure 15. Post Transaction Printing Worksheet
Sales, Returns, and Coupons Section Headers Worksheet
TERMINAL ___
SALES LINE 1 ________________________________________________________
SALES LINE 2 ________________________________________________________
SALES LINE 3 ________________________________________________________
RETURNS LINE 1 ________________________________________________________
RETURNS LINE 2 ________________________________________________________
RETURNS LINE 3 ________________________________________________________
COUPON LINE 1 ________________________________________________________
COUPON LINE 2 ________________________________________________________
COUPON LINE 3 ________________________________________________________
(12345678901234567890123456789012345678901234567890123456)
Figure 16. Sales, Returns, and Coupons Section Headers Worksheet
Chapter 1. Planning and Installing the 4610 Printer Feature 13
Default: 38
This option sets the default number of characters per line for the customer receipt
station. The settings 38, 40, 44, 48, and 52 correspond approximately to 13.6, 14.5,
15.5, 17, and 18.5 characters per inch, respectively.
Default Document Insert Width: Choose: 38, 40, 44, 48, or 52.
Default: 38
This option sets the default number of characters per line for the document insert
station. The settings 38, 40, 44, 48, and 52 correspond approximately to 15, 15,
16.7, 18.7, and 18.7 characters per inch, respectively, on the document insert
station.
Handling Terminal Memory Requirements
Due to the multiple receipt and post-printing features of the 4610 printer, additional
terminal memory is reserved when the terminal is loaded. The amount of additional
memory used is approximately equal to the amount of memory required for the
summary log array. Hidden options affecting the processing of the summary log still
apply. For more information on hidden options, refer to the IBM 4680-4690
Supermarket Application: Planning and Installation Guide.
The software for the IBM 4610 Printer Feature uses an additional 20 KB of memory
for code space at the terminal. The amount of memory used for data varies but is
not less than 40 KB per head data space. This is because the post printing buffer is
allocated based on the amount of free memory available and will vary from system
to system.
It is strongly suggested that this feature be used with the Big Memory Model
version of the 4680-4690 Supermarket Application to ensure that enough memory is
available for buffering.
Descriptors for the 4610 Printer Feature
This section contains sales and report descriptors. All sales and report descriptors
for the 4610 are 40 characters in length.
Sales Descriptors for the 4610 Printer Feature
These descriptors are located in file EAMP4SDS.DAT.
Printer Station Widths Worksheet
TERMINAL ___
DEFAULT CUSTOMER RECEIPT WIDTH __ (38, 40, 44, 48, or 52)
DEFAULT DOCUMENT INSERT WIDTH __ (38, 40, 44, 48, or 52)
Figure 17. Printer Station Widths Worksheet
14 4610 Supermarket Application Printer Support
"PRINT DUPLICATES PRESS ENTER OR CLEAR"
"PRINTER OUT OF PAPER/PRINT COVER UP "
"INVALID PRINTER COMMAND "
"PRINT BUFFER FULL "
Report Descriptors for the 4610 Printer Feature
These descriptors are located in file EAMP4RDS.DAT.
" STORE NUMBER @ EXTENDED TERMI"
"NAL OPTIONS @ PAGE "
"**** END OF TERMINAL OPTIONS REPORT ****"
" *** NO INFORMATION TO BE PRINTED ***"
"REPORTED AT "
"Page "
"of "
" - STORE "
" "
"2 "
"ENHANCED PRINTING OPTIONS "
" DUPLICATE RECEIPT PRINTING "
"NUMBER OF DUPLICATE COPIES X Number o"
"f duplicate receipt copies to print "
"AUTOMATIC DUPLICATE PRINT X Automati"
"cally print duplicate(s) at EOT "
" "
" "
" "
" "
" MICR OPTIONS "
"PAUSE AFTER MICR READ X Prompt f"
"or check insertion after MICR read "
"PRINT CHECK FACE X Print fa"
"ce of check after check franking "
"STORE NAME TO PRINT ON CHECK XXXXXXXX"
"XXXXXXXXXX "
" "
" "
" "
" PRINTER ERROR HANDLING "
"OVERRIDE OUT-OF-PAPER ERROR X Allow ma"
"nager to override out-of-paper errors "
" "
" "
" "
" POST TRANSACTION PRINTING "
"PRINT POST TRANSACTION X Delay pr"
"inting until end of transaction "
"COMBINE IDENTICAL ITEMS X Group sa"
"les of identical items on receipt "
"GROUP DEPARTMENT SALES X Group sa"
"les of department items on receipt "
"REMOVE VOIDED ITEMS X Do not p"
"rint voided items "
"SEPARATE SALES,RETURNS,CPNS X Print re"
"turns,coupons separately from normal "
"sales "
"SALE/RETURN/COUPON HEADINGS X Print he"
"adings before Sales/Returns/Coupons "
"sections "
"SALES LINE 1: XXXXXXXXXXXXXXXXXXXXXXX"
"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "
"SALES LINE 2: XXXXXXXXXXXXXXXXXXXXXXX"
"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "
"SALES LINE 3: XXXXXXXXXXXXXXXXXXXXXXX"
"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "
"RETURNS LINE 1: XXXXXXXXXXXXXXXXXXXXXXX"
Chapter 1. Planning and Installing the 4610 Printer Feature 15
"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "
"RETURNS LINE 2: XXXXXXXXXXXXXXXXXXXXXXX"
"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "
"RETURNS LINE 3: XXXXXXXXXXXXXXXXXXXXXXX"
"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "
"COUPONS LINE 1: XXXXXXXXXXXXXXXXXXXXXXX"
"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "
"COUPONS LINE 2: XXXXXXXXXXXXXXXXXXXXXXX"
"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "
"COUPONS LINE 3: XXXXXXXXXXXXXXXXXXXXXXX"
"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "
" "
" "
" "
" "
"3 "
" IBM 4610 PRINTER OPTIONS "
" 4610 PRINTER STATION WIDTHS "
"DEFAULT CUSTOMER RECEIPT WIDTH "
"DEFAULT DOCUMENT INSERT WIDTH "
" "
" "
" "
" "
" "
"CHANGE OPERATOR OPTIONS AUTH. LIST "
"ADD OPERATOR OPTIONS AUTH. LIST "
"DISPLAY OPERATOR OPTIONS AUTH. LIST "
"OPERATOR OPTIONS AUTH. LIST REPORT "
"EXTENDED TERMINAL OPTIONS "
" "
"Operator Options List "
"OPTION NUMBER AND DESCRIPTION "
"AUTHORIZATION "
" "
" 1 Enhanced Printing Options "
" 2 IBM 4610 Printer Options "
Specifications for Combining Like Items and Grouping By Department
The 4610 printer options have separate fields for controlling the format of the
post-printed receipt; one field allows you to combine identical items, and another
field allows you to group items by departments. The following rules are used to
show how different types of transactions will be handled with these two options. In
this release of the PRPQ you may select one or both of these options.
Combine Like items
Individual items with the same UPC code and the same price will be combined
together on the post-transaction, printed receipt. Exceptions are listed below.
Price Override
If the price is overridden for an item with an identical UPC code to other items
purchased, that item must be listed separately from items that can be combined on
the receipt. If an item has a price that is overridden more than once each override
entry will appear separately on the receipt even if the adjusted price is the same.
Type 2 UPCs (Imbedded Prices)
Type 2 UPCs with matching item code prices will not be combined together.
16 4610 Supermarket Application Printer Support
Weighted Items
Under no circumstances will weighted items (items scaled at the front end) be
combined. Each item will be listed separately on the receipt.
Department Key Items
Department key items will be combined if they have the same UPC code and the
same price.
Price Required Items
Price required items whose prices do match will be combined into one listing on the
receipt. If some price required items have different prices they will be listed
separately.
Miscellaneous Sales
If miscellaneous sales items are entered with identical prices, they will be combined
on the receipt. If they are entered with different prices, they are listed separately.
Item Exceptions
Items entered under any exception condition (for example, tax exempt or food
stamps) should not be combined with items that have the same UPC code and
were entered normally.
Pricing Methods
Items of pricing methods 0 and 1 with promotional pricing of quantities greater than
one, will be combined. Due to the complexities of pricing, items entered with pricing
method 2 through 5 will not be combined and will be listed individually on the
receipt.
Linked Items
PLU sale items with a linking record will be combined. On the post-transaction,
printed receipt, the print line for the linking record will follow the primary item entry
and will use combining as well.
Coupons
All coupons are to be listed individually on the receipt. There will be no combining
of coupons even for the same item and the same reduction amounts. This allows
the customer to easily verify that all coupons have been processed.
Group by Department
If the option to group by department is selected, items on your post-transaction,
printed receipt are sorted by item department number in ascending order.
Chapter 1. Planning and Installing the 4610 Printer Feature 17
18 4610 Supermarket Application Printer Support
Chapter 2. 4610 Printer Feature Operations
This section contains the information needed by the terminal operator to use the
IBM 4610 Printer feature. Two new operations are available to the operator
depending on how the feature personalization options were defined.
Customer Checkout Procedures
Customer Checkout procedures are fully described in the IBM 4680-4690
Supermarket Application: Guide to Operations. This section provides information
specific to the 4610 printer support feature.
End of Transaction for Sales Transactions
End-of-transaction processing automatically occurs when sufficient funds have been
tendered to satisfy the balance due. If Terminal Options are configured to print
greater than zero duplicate receipts and the duplicates are not configured to be
printed automatically, the following sequence occurs.
Manually Printing Duplicate Receipts
Personalization Options: 4610 Extended terminal options
Key Sequence Discussion: If post-printing is disabled, the operator prompt
appears at the end of the transaction after the original receipt prints. If post-printing
is enabled, the prompt appears at the end of transaction before the receipt prints.
After the receipts print or the clear key is pressed, the end of transaction message
appears (for example, Thank you, Come Again).
Alternate Keying Sequence: None
Check Printing
Check printing is initiated when the Check key is pressed.
Keying Sequence
PROMPT ACTION DESCRIPTION
Print Duplicates
Press Enter or Clear Enter Press the Enter key if duplicate
receipts are required.

The duplicate receipts will print.

Clear Press the Clear key if duplicate

receipts are not required.
The duplicate receipts will not be
printed.
Copyright IBM Corp. 1998 19
Personalization Options: 4610 Extended terminal options
Key Sequence Discussion: After the check key is pressed, the operator must
choose whether to print the check face as described above. After making this
choice, the operator is prompted to enter an account number.
Alternate Keying Sequence: None
Note: With the 4610 Printer feature, the check handling process requires little user
intervention. After the check key is pressed and the appropriate choice is
made, the check printing process begins. The check is inserted face down
with the bottom edge of the check at the right side of the document insert
station. At this point, the account number may be entered or, optionally, the
account number may be read from the check. Franking proceeds
immediately following input of the account number. If the check face is to be
printed, the check is then automatically flipped and the face of the check is
printed. Otherwise, the check is ejected from the document insert station.
This new check handling sequence occurs automatically whenever a 4610
printer is attached and the 4610 printer feature is installed. The order of the
sequence may not be altered; however, printing on the face of the check
may be skipped, either by setting an Enhanced Printing Option available with
the 4610 Printer Feature or by pressing Clear at the prompt described
above. When check face printing does not occur, the check is not flipped.
For more information on Enhanced Printing Options, see the 4680-4690
Supermarket Application: Planning and Installation Guide.
Partial Receipt Print on Demand
This function allows the operator to print a partial receipt on demand during a
sales transaction. This allows the operator to review a receipt during the transaction
and discard it. Items on the receipt are listed in the order in which they were
scanned or keyed with no post printing options performed. A partial receipt can be
printed multiple times during a sales transaction.
To enable this function receipt post-printing must be enabled in personalization. The
receipt created by this function has a header/trailer that indicates the receipt is not
legal. At the end of the transaction the real receipt is printed.
To start this function the operator keys 15 and presses SIGNON. When processing
completes the receipt prints and the operator can continue with the sales
transaction.
Keying Sequence
PROMPT ACTION DESCRIPTION
Enter to bypass or
Clear to print check Enter The check face will not be printed

Clear the check face will be printed after

the account number is entered.
20 4610 Supermarket Application Printer Support
Non-Sales and No-Sales Transactions
Post printing applies only to sales transactions. Therefore, if post printing is
enabled, non-sales and no-sales transactions are not affected; that is, any prints to
the 4610 customer receipt printer will be performed immediately.
Note: The 4610 printer does not have a summary journal station.
System Error Messages
The format of the unique data for errors specific to this feature is:
P4MMIIIEEEENNNNNNNN
where:
v MM = the particular 4610 printer feature module in ASCII
v III = I/O Session Number (those used by this feature are listed below)
v EEEE = Error return from ERR
v NNNNNNNN = Runtime Error Message
Runtime Error Codes
Runtime errors generated by code specific to the 4610 printer feature are reported
to the error log in the same format as other base application error codes. There are
no additional runtime error codes for this feature.
Errors at the Terminal
The following 4610 printer specific errors are reported at the terminal:
B893 B893 PRINTER OUT OF PAPER,
PRINTER COVER OPEN
Severity: 1
Explanation: The printer customer receipt station is
out of paper or the station cover has been opened.
User Response: Insert a fresh customer receipt roll,
close the station cover, press the flashing scroll receipt
button
Programmer Response: None
B894 B894 INVALID PRINTER COMMAND
Severity: 1
Explanation: The printer has received a control that it
does not recognize.
User Response: Press Clear
Programmer Response: The error is logged in the
Application System Log report. Refer to the IBM
4680-4690 Supermarket Application: Guide to
Operations to obtain the format of the logged error data.
B895 B895 PRINT BUFFER FULL
Severity: 2
Explanation: The printer customer receipt station
buffer is full.
User Response: The operator must end the
transaction immediately
Programmer Response: None
4610 Printer Restrictions
The following restrictions apply to the 4610 printer.
Chapter 2. 4610 Printer Feature Operations 21
Suspend/Retrieve
When a transaction is suspended using any of the enhanced printer options, the
suspended receipt will match the options selected. However, the retrieved receipt
will only allow the post-printed option if selected; all other post printing enhanced
options will not apply.
Group by Department/Separate Sales, Returns, and Coupons
If you have selected post printing with Group Department Sales or Separate Sales,
Returns, and Coupons, the items will not appear on the receipt in the order in which
they were sold. Because these are moved to different sections of the receipt based
on department or item type, the original order of the receipt is not preserved.
Voids
If you are using post printing with Group Department Sales or Separate Sales,
Returns, and Coupons and you choose to show voids on the receipt, the voids are
printed at the bottom of their respective sections.
Transaction Types that Stop Combining/Grouping and Separating of
Items
If you are using post printing with any of the enhanced printer options enabled and
receive a partial tender, the combining, sorting, and separating of the additional
items is stopped because they cannot be distinguished from each other and the
receipt will become difficult to understand.
If a transaction discount is taken at the end of an order and no more items are sold,
all the options you have selected are used. However, if a discount is given and
more items are sold, the combining, sorting, and separating is stopped, and the
remaining items after the first groups are printed.
If the user sends a Line Type 29 (Print as Passed) to the printer routine with any of
the enhanced options selected, the combining, sorting, and separating of items is
again stopped because the print line cannot be handled or placed.
22 4610 Supermarket Application Printer Support
Chapter 3. 4610 Printer Feature Programmers Information
This section contains information for programmers who want to enhance or
customize this feature to suit their particular business needs. This section includes
information regarding:
v I/O session numbers used
v Global Variables available for modification/reference
v Common routines available for user exit programming
v Details of the post-printing and multiple receipt printing mechanisms
v A listing of user exits that may be used to modify this feature
v Detailed information and recommendations on programming this feature
v A listing of the files specific to this feature and their formats
v Alternate Menu Support
I/O Session Numbers
The following I/O Controller and Terminal Session Numbers are used by this
feature:
Table 1. I/O Session Numbers
Device/File
Name Description
I/O Session
Number
Controller/Terminal
Usage
EAMP4RDS Report Descriptors 6 Controller
EAMP4nnn Extended Terminal Options
File
9 Controller
EAMP4DEF Screen Defaults 36 Controller
EAMP4SDS Sales Descriptors 60 Terminal
EAMP4TNA Operator Options
Authorization
61 Controller
EAMP4nnn Extended Terminal Options
File
64 Contoller and Terminal
The following session numbers are documented in the IBM 4680-4690 Supermarket
Application: Programming Guide, but as they are used extensively for this feature it
is useful to document them here:
Session 34 Printer Customer Receipt station
Session 35 Printer Document Insert station
Session 36 Printer Summary Journal station
Note: Session number 36 is not valid for printers without a journal station. Any
attempts to write to this session number may be ignored.
Copyright IBM Corp. 1998 23
4610 Printer Feature Global Variables
User exits can use several data variables. These variables are documented on
include files that are provided with the base product. The include files reside on the
printer feature installation diskettes.
Terminal Sales Include Files:
v EAMP4VAJ.J86 contains global variables to indicate that a 4610 printer is
attached and that MICR hardware is available.
v EAMP4VGJ.J86 contains global Enhanced Printer Options variables
4610 Printer Feature Common Routines
Common routines are available to checkout support and terminal sales user exits.
These routines should be used for consistency and to reduce coding requirements
within the exits.
Table 2 shows the Terminal Sales Common Routines.
Table 2. Terminal Sales Common Routines
PRT4610.SAVE.FONT.AND.SPACING Saves fonts for later retrieval.
PRT4610.RESTORE.FONT.AND.SPACING Restores fonts that have been previously
saved.
ENABLE.BUFFERING Enables lines written to the customer receipt
station to be buffered.
DISABLE.BUFFERING Prevents lines written to the customer receipt
station from being buffered.
BUFFER.RECEIPT.LINE Buffers a line being written to the customer
receipt.
CR.BUFFER.GUILLOTINE Buffers guillotine cuts written to the customer
receipt station.
In order to call any of the following functions in any user exit code, the following
header file EAMP4EXJ.J86 should be included.
The routines are described in more detail below.
PRT4610.SAVE.FONT.AND.SPACING
This routine pushes existing fonts onto a stack so that they can be restored later. It
has the following definition:
SUB PRT4610.SAVE.FONT.AND.SPACING PUBLIC
PRT4610.RESTORE.FONT.AND.SPACING
This routine restores fonts from the stack. It has the following definition:
SUB PRT4610.RESTORE.FONT.AND.SPACING(SESSION.NUM) PUBLIC
ENABLE.BUFFERING
This routine allows lines written to the customer receipt printer station to be buffered
in the customer receipt print buffer. It has the following definition:
24 4610 Supermarket Application Printer Support
SUB ENABLE.BUFFERING
DISABLE.BUFFERING
This routine prevents lines written to the customer receipt station from being
buffered. It has the following definition:
SUB DISABLE.BUFFERING
BUFFER.RECEIPT.LINE
This routine causes a line to be written to the customer receipt station using the
WRITE command to be buffered. It has the following definition:
SUB BUFFER.RECEIPT.LINE(PRT.LINE$) PUBLIC
Note: It is recommended that the base print routine TSPREC01 be used to write
lines to the customer receipt. In this case it is not necessary to call
BUFFER.RECEIPT.LINE. Only if the user writes directly to the printer, using
the WRITE statement, will it be necessary to call this routine.
CR.BUFFER.GUILLOTINE
This routine inserts guillotine cuts into the customer receipt buffer. It has the
following definition:
SUB CR.BUFFER.GUILLOTINE PUBLIC
Note: If the base routine DO.GUILLOTINE.CUT is called, it is not necessary to call
this routine.
Duplicate Receipt/Post Printing Buffering
To handle post-printing and multiple receipt printing, lines written to the customer
receipt are buffered in memory for the duration of the transaction. To reduce the
amount of memory occupied by this buffer and to optimize performance, data
compression is used by the buffering mechanism. In addition, each line keeps an
index into the TLOG array so that data such as item code and department may be
easily retrieved for each item.
Data Structures
The customer receipt print buffer, CR.PRINT.BUFFER$, is implemented as a
one-dimensional string array. Each entry in this buffer holds information for a single
line that is printed on the customer receipt during the transaction. Entries start at
array index 1 and work upwards. Each entry consists of the actual data that is
printed on the receipt, together with several items of control information for the line.
In order to use as little memory as possible in the storage of actual receipt text, this
text is held in compressed format, using a run length encoding method to more
efficiently store consecutive space characters that are embedded within the text.
Under this method three or more spaces occurring together are encoded by
replacing them with the character CHR$(255) followed by the binary representation
of the number of characters.
Table 3 on page 26 summarizes the format of the entries in the customer receipt
print buffer.
Chapter 3. 4610 Printer Feature Programmers Information 25
Table 3. Customer Receipt Buffer Format
Field Name Type Offset Length Description
CONTROL BIN 0 1 Control Character
v Bit 7 = X'80' Sorted item
v Bit 6 = X'40' Partial tender flag
v Bit 5 = X'20' Cut paper after line
v Bit 4 = X'10' Return item
v Bit 3 = X'08' Ignore this line
v Bit 2 = X'04' Reserved
v Bit 1 = X'02' Reserved
v Bit 0 = X'01' Reserved
LINEFEEDS PD 1 1 Number of linefeeds following the line (range 0 to
99)
TLOGINDEX PD 2 2 Index into the TLOG array SL.STR$ for the
current line.
The CONTROL field is used to control various aspects of printing. The following
controls are defined:
v whether the line represents a sortable item. An item is considered sortable if it is
an ordinary sales item, a return or a void. Lines such as headers, partial tender
lines and non-sales lines are not sortable.
v whether the line is a partial tender line. This information may be used by the Post
Printing feature if sorting has been selected. In the event of a partial tender being
performed at the terminal the partial tender line does not print until the end of the
receipt.
v whether the customer receipt is guillotined after the line has printed.
v whether or not the item is a return item. This information is used by the Post
Printing feature to group sale and return items into different sections.
v whether to ignore this line during sorting.
The LINEFEEDS field indicates the number of line feeds that follow the line.
The TLOGINDEX field identifies the index into the TLOG array, SL.STR$, which
relates to the current print line. Note that the information in the TLOG array is not
used by the multiple receipt printing feature, but may be used by the Post Printing
feature, where modifications may be required to the order in which the information
is presented on the receipt.
The print buffer is dimensioned during the initialization phase of terminal loading. Its
size is determined by the amount of free memory in the terminal (using the FRE
function) between the maximum and minimum limits of 1000 lines and 50 lines
respectively.
Whenever the contents of the buffer are printed, the store headers are printed first,
followed by the buffered lines and finally the store trailers followed by a guillotine
cut or line feeds (depending on how this option is configured).
26 4610 Supermarket Application Printer Support
Terminal Sales User Exits
The following user exits may be used when programming with this feature:
Exit TSUPEC01 - Before Processing the First Entry in a Transaction
Suggested Global Variables for Update: CR.PRINT.BUFFER$
Comments: If you want to add lines to the receipt between the header lines and the
first item it may be done here.
Exit TSUPEC02 - After a Customer Checkout Transaction is Completed
Suggested Global Variables for Update: CR.PRINT.BUFFER$
Comments: You can add lines between the last line of a transaction and the trailer
lines here.
Exit TSUPEC20 - Before Writing a Line to the Cash Receipt
Suggested Global Variables for Update: CR.PRINT.BUFFER$
Comments: Most writes to the customer receipt for post-printing and multiple receipt
printing should be performed here. Furthermore, print lines may be modified here
including print lines issued during post-printing; that is, print lines from the receipt
buffer.
WRITE FORM
The IBM 4610 printer does not support the WRITE FORM command. Any user exits
that attempt to write to the customer receipt or document insert stations using this
command cause the printer to return an Unknown printer command error message.
Instead, you should make appropriate modifications to test for a 4610 printer and
then use the appropriate WRITE or WRITE FORM statement depending on the
result. You may use the variable PRT4610.ENABLE, which is declared in the
include file EALP4VAJ.J86. This variable is non-zero if a 4610 printer is attached to
the terminal, and 0 if any other printer is attached. Refer to the 4690 OS Application
Interface Specification for 4610 Printer for more information regarding 4610 printer
commands.
Saving and Restoring Fonts
Fonts are saved in an array and restored from the array to ensure that they are not
inappropriately set.
If other fonts are desired, you should use the PRT4610.SAVE.FONT.AND.SPACING
routine to save the currently loaded font, and afterwards use the
PRT4610.RESTORE.FONT.AND.SPACING routine to restore the font.
Font Selection User code
The following code is required to change the default font in the 4610 printer.
Inter-character Spacing is the distance between characters.
In module EAMTSUVA.J86, add the following variable declarations:
Chapter 3. 4610 Printer Feature Programmers Information 27
INTEGER*1 GLOBAL
INTER.CHAR.SPACING
INTEGER*2 GLOBAL
FONT.ATTRIBUTE
In module EAMTSUSU.J86, add the following function declaration:
SUB PRT4610.FONT.INIT(SESS.NUM,STACK.SIZE) EXTERNAL
INTEGER*2 SESS.NUM,STACK.SIZE
END SUB
In module EAMTSU07.J86, add the following code in function TSUPEC07:
FONT.ATTRIBUTE = 0nH
INTER.CHAR.SPACING = 05H (FONT A) 03H (FONT B)
CALL PRT4610.FONG.INIT(34,4)
The n in FONT.ATTRIBUTE is a hex number. To select Font A, enter 0; to select
Font B, enter 1. For example, for FONT A, enter 00H. The n in
INTER.CHAR.SPACING can be a number from 3 to 8. On Font A, the default is 5;
on Font B, the value should be set to 3 so that previously set up lines do not wrap.
Recompile EAMTSUPC.BAS and relink EAMTS10L.INP.
Note: The examples are provided as is. IBM neither maintains nor services them.
Nothing in this publication shall be construed as a representation or warranty
by IBM that implementation or use of the examples is cleared of the
intellectual property rights of third parties.
Submitting Print Lines for Post Printing and Multiple Receipt Printing
If you want to add code to submit your own print lines for post-printing or multiple
receipt printing through user exits there are two options:
v Calling the base print routine TSPREC01
v Calling the 4610 printer routine BUFFER.RECEIPT
Use the following guidelines when the choice is made to issue writes directly to the
printer:
1. As WRITE FORM is not supported, you must format the print line. For details
refer to the 4690 OS Application Interface Specification for 4610 Printer.
2. If the line to be written exceeds the default width of the paper, the line is
wrapped. The line is not truncated.
3. Remember to add the linefeed command at the end of the print line. Otherwise,
the printer will hang.
4. Follow the recommendations for saving and restoring fonts given above.
If you want to use the base print routine to print to the receipt but do not want the
line to be buffered use the call DISABLE.BUFFERING.
Note: Buffering is automatically enabled and disabled depending on whether sales
or non-sales lines are being written to the receipt. Be aware of where your
lines are being printed so you can restore the buffering flag to the correct
value after the lines have been written.
28 4610 Supermarket Application Printer Support
If you want to write a line to the receipt that prints immediately, even with post
printing enabled use a WRITE statement; this line is not buffered unless
BUFFER.RECEIPT.LINE is called.
If you do not go through the base print routine but want to submit a line to post
printing, BUFFER.RECEIPT LINE must be used as indicated above. Also, ensure
that the line is not printed immediately by setting up the print line and passing this
to the buffer routine without using the WRITE statement first. If post-printing is not
enabled, the WRITE statement is necessary for the line to be written on the original.
If the line is added other than through the base print routine, it is not considered
eligible for sorting or cleaning and will be printed on the post-printed receipt in the
position it would have originally appeared.
Modules for Partial Receipt Print on Demand
The modules for this function are:
v EAMTS11C.BAS Sales Control Processor (modified)
v EAMP4DMC.BAS Demand Printing Routine (new)
Reprint Receipt Using 15 SIGNON
The following explains how to set up User Exit 6 to perform the 15 SIGN/OFF
outside of the transaction with the base code support.
1. Make sure User Exit 6 is activated in terminal options
2. Add the following code to the corresponding modules.
In module EAMTSUVA.J86, add the following variable declaration:
INTEGER*1 GLOBAL \
DUP.4610.RECEIPT ! flag if printing duplicate receipts
In module EAMTSUSU.J86, add the following function declaration:
SUB PRINT.DEMAND.RECEIPT EXTERNAL
END SUB
In module EAMTSU06.J86, add the following code in function TSUPEC06:
IF (TS.PROCEDURE = 15) AND DUP.4610.RECEIPT THEN BEGIN
CALL PRINT.DEMAND.RECEIPT
TS.USER.RETURN = -1
ENDIF
3. Recompile EAMSTUPC.BAS and relink EAMTS10L.INP. Make sure the new
printer code is linked in also.
Note: The examples are provided as is. IBM neither maintains nor services them.
Nothing in this publication shall be construed as a representation or warranty
by IBM that implementation or use of the examples is cleared of the
intellectual property rights of third parties.
Supermarket Database EAMP4nnn
The 4610 Extended Terminal Options File (EAMP4nnn) contains 4610 printer
handling options that vary from terminal to terminal. The records in this file are
random and are organized to simplify the personalization procedure and to ensure
its accuracy.
Chapter 3. 4610 Printer Feature Programmers Information 29
Extended terminal options are not described here. Refer to the IBM 4680-4690
Supermarket Application: Planning and Installation Guide for information on
extended terminal options.
The prime version of this file is kept on the master controller. A mirrored version is
kept on all other eligible controllers.
This file has the file name EAMP4nnn, where nnn is the terminal number.
File Name: 4610 Extended Terminal Options
Organization: Random
Distribution Class: Compound
File Copies: 1 per terminal
Record Length: 512 bytes
Alternate Menu Support
The menus necessary for personalizing the 4610 printer support are included with
this PRPQ and run under the supermarket application default menus support. The
menu entries to invoke these new options occur in two places:
1. as a Feature Personalization menu selection under the Application
Personalization menu
2. as Change Feature Descriptor and Print Feature Descriptor under the
Descriptors selection of the Application Personalization menu.
If alternate menus are to be used, the following steps must be performed:
1. Add the entry Extended Terminal Options to the appropriate part of the feature
personalization menu under application personalization.
Note: When this new menu entry is selected it calls the EAMP40ML.286
executable.
2. Add the following entries to the Descriptors screens under application
personalization
a. Change Feature Descriptors
b. Printer Feature Descriptors
3. Appropriate steps should be taken to allow the modification and reporting of the
files EAMP4RDS.DAT and EAMP4SDS.DAT as is currently done with other
feature descriptors.
For additional information about Extended Terminal Options, refer to IBM 4680-4690
Supermarket Application: Planning and Installation Guide.
30 4610 Supermarket Application Printer Support
Chapter 3. 4610 Printer Feature Programmers Information 31

Printed in the United States of America

on recycled paper containing 10%
recovered post-consumer fiber.