Entry And Addressability; Coding For The 3270 'Unavailable Printer' Condition - IBM SC34-6814-04 Customization Manual

Cics transaction server for z/os
Table of Contents

Advertisement

v Updates to recoverable resources. If the resources are locked by another task,
You should also note that you cannot use the NEP to suppress DFHZNAC
messages.

Entry and addressability

On entry, your NEP should issue the commands:
EXEC CICS ADDRESS COMMAREA
EXEC CICS ADDRESS EIB
These commands provide addressability to the communication area passed by
DFHZNAC, and to the EXEC interface block, respectively.
If you write your node error program in assembler language, you generate the
communication area DSECT by coding:
DFHNEPCA TYPE=DSECT
If you write your program in C, you include the communication area definitions by
coding:
#include <dfhnepca>

Coding for the 3270 'unavailable printer' condition

The 'unavailable printer' condition arises when a print request is made using the
3270 print request facility, and there are no printers on the control unit, or when the
printers are in one of the following conditions:
v Out of service
v Not in TRANSCEIVE or RECEIVE status for automatic transaction initiation
v With a task currently attached
v Busy on a previous operation
v Requiring intervention.
The procedure is applicable to 3270 logical units or to the 3270 compatibility mode
logical unit when using the PRINTER and ALTPRINTER operands of the CEDA
DEFINE TERMINAL command.
The terminal control program recognizes this condition, and issues a READ
BUFFER request to collect the data into a terminal I/O area. The TIOA is of the
same format as it is when an application program has issued a terminal control
read buffer request.
The terminal control program VTAM section (DFHZCP) then queues the TCTTE to
the node abnormal condition program with error code X'42' (TCZCUNPRT). The
node abnormal condition program (DFHZNAC) writes to the CSNE transient data
queue:
v DFHZC2497 UNAVAILABLE PRINTER (device types 3270P and LUTYPE3)
v DFHZC3493 INVALID DEVICE TYPE FOR A PRINT REQUEST (all other printer
506
Customization Guide
the CSNE unit of work could be suspended or shunted.
device types).

Advertisement

Table of Contents
loading

Table of Contents