This task adds ticket printer number to the agency printer ticket table. It displays all ticket numbers held in all printer ticket tables and loads the last days remainder tickets onto the printer ticket table. It is also used to delete ticket printer numbers.
Transaction Name:
TicketPrinterLinkage_1_0
Can any other transaction(s) perform this same task?
No other transaction can perform this task.
Can this task be performed in a sessionless environment?
This task must be used in a sessioned environment.
Are the request and response identical on both the Apollo and Galileo systems?
The request and response are identical on both Apollo and Galileo.
List any industry-specific knowledge required to understand this task in terms of the specific business process.
Knowledge to add printers in the AAT and issue stock.
Explain any special limits or distinct restrictions to the input data that may not be readily apparent.
There are no special limitations.
Request:
Unless otherwise specified, use ALL CAPS in any request data.
Use the <TicketNumberUpdateMods> (4074) to request an Update to Printer Ticket Numbers. The <LinkageAction> tag will be sent to display, switch on / off, the Ticket Table. The <PrinterParameters> tag will be sent with the Ticket Number information when the printer ticket table is to be updated.
Prerequisite tasks:
No prerequisite tasks are required.
Expected response:
If the Update Printer Ticket Numbers transaction completes successfully, the <DPOK> tag will be returned to indicate a good response.
When a request is sent to display the ticket numbers, the <PrinterParameters>, <TicketStockInfo> and <SatelliteTicketPrinting> tags, are returned to indicate good response. The <PrinterParameters> returns with the printer details i.e. LNIATA, mode, type etc. The <TicketStockInfo> tag returns with starting and ending stock numbers, stock range, check digit, STP printer designator etc. The <SatelliteTicketPrinting> tag returns with the STP details.
Error and warning responses:
If the Update Printer Linkage transaction encounters an error, it will be in the <ErrText> tag. The following error messages may be received:
Apollo:
8822 - RESTRICTED
8823 - TABLE MISSING
8825 - INVALID FORMAT INCOMPLETE
8831 - TABLE ALREADY EXIST
8833 - INVALID LNIATA
8841 - INVALID ENTRY
8846 - VERIFY CHECK DIGIT
8851 - INVALID NEED LINKAGE
8877 - VERIFY STARTING TICKET NUMBER BELOW MINIMUM LENGTH
8882 - VERIFY ENDING TICKET NUMBER BELOW MINIMUM LENGTH
8911 - INVALID FORMAT
Galileo
8822 – INVALID FORMAT DATA
8824 - INVALID GTID
8825 - INVALID FORMAT INCOMPLETE
8828 - VERIFY NUMBER OF TICKETS
8829 - VERIFY TICKET NUMBER
8830 - TABLE ALREADY EXISTS
8833 - TABLE MISSING
8843 - CHECK DIGIT ERROR ON 1ST TKT NUMBER
8848 - RANGE NOT IN STOCK
8852 - TRYING TO ADD AGENCY STOCK TO AN STP
8907 - INVALID NEED PRINTER LINKAGE
8910 - INVALID SINE
Follow-on requests:
No follow-on requests exist.
Additional Printer Linkage capabilities:
Ticket Printer Tables
Ticket stock control numbers can be added to the agency's printer ticket table (HMTNF5203A-444000800001/4440008499/500—The total number of coupons (500) in this entry is not required for Apollo host users).
All of the ticket numbers held in a printer ticket table can be displayed (HMTN/D).
All of the ticket numbers held in a printer ticket table for a specific printer can be displayed (HMTNF5203A/D).
Ticketing Services can create the capability of adding ticket stock control numbers to the agency’s INS table in Structure Data. (HMTNSTOCK1/F5203A-444000800001/4440008499/500/D—Valid only for Italy.)
The Delete parameter allows you to remove an assigned range of Tickets from the Table for a specific Printer LNIATA. You must delete the existing range of Tickets from the Table for a specific Printer LNIATA prior to adding a new range of Tickets to it. (HMTNF3032E/DELETE)
The following entry is only available on the Galileo host:
Unused tickets can be returned to the agency ticket stock record at the end of the day (HMTNF5203A/RETURN).
The last days remainder tickets can be loaded onto the printer ticket table (HMTNF5203A-44400080512/4440008100/050—The first number must contain the check digit).
|
<TicketNumberUpdateMods> |
Terminal Equivalents: |
Apollo: HMTN |
Galileo: HMTN |
|
||||
|
Ordering |
KLR |
Min/Max |
XML Tag |
||||
|
Required |
DPLP |
1-1 |
<LinkageAction> |
||||
|
<TicketNumberUpdate> |
||||||
|
Ordering |
KLR |
Min/Max |
XML Tag |
|||
|
A |
DPPP |
1-1 |
<PrinterParameters> |
||
|
B |
DPST |
1-1 |
<TicketStockInfo> |
||
|
C |
DP43 |
1-1 |
<SatelliteTicketPrinting> |
||
|
<TicketNumberUpdateMods> |
Terminal Equivalents: |
Apollo: HMTN |
Galileo: HMTN |
|
||||
|
Ordering |
KLR |
Min/Max |
XML Tag |
||||
|
Required |
DPLP |
1-1 |
<LinkageAction> |
||||
|
<TicketNumberUpdate> |
|
|
||||
|
Ordering |
KLR |
Min/Max |
XML Tag |
||
|
|
DPOK |
1-1 |
<DPOK> |
||
|
<TicketNumberUpdateMods> |
Terminal Equivalents: |
Apollo: HMTN |
Galileo: HMTN |
|
||||
|
Ordering |
KLR |
Min/Max |
XML Tag |
||||
|
A |
DPPP |
1-1 |
<PrinterParameters> |
||||
|
B |
DPLP |
1-1 |
<LinkageAction> |
||||
|
<TicketNumberUpdate> |
|
|
||||
|
Ordering |
KLR |
Min/Max |
XML Tag |
||
|
|
DPOK |
1-1 |
<DPOK> |
||
|
<TicketNumberUpdateMods> |
Terminal Equivalents: |
Apollo: HMTN |
Galileo: HMTN |
|
||||
|
Ordering |
KLR |
Min/Max |
XML Tag |
||||
|
A |
DPPP |
1-1 |
<PrinterParameters> |
||||
|
B |
DPST |
1-1 |
<TicketStockInfo> |
||||
|
<TicketNumberUpdate> |
|
|
||||
|
Ordering |
KLR |
Min/Max |
XML Tag |
||
|
|
DPOK |
1-1 |
<DPOK> |
||
|
<TicketNumberUpdate> |
|
|
||||
|
Ordering |
KLR |
Min/Max |
XML Tag |
||
|
|
EROR |
1-1 |
<ErrText> |
||