Addressing The Contents Of The Tacle - IBM SC34-6814-04 Customization Manual

v Abend write has no effect if the TCTTE was associated with a READ request. In

Addressing the contents of the TACLE

The TACLE is created by the terminal control program when the error occurs, and
contains all the I/O error information provided by BSAM.
To address the contents of the TACLE, the user-written terminal error program
should contain the COPY DFHTACLE and COPY DFHTCTLE statements, in that
order. These define the complete DFHTCTLE DSECT. The symbolic names in this
DSECT are used to address fields in both the TACLE and the real line entry
associated with the error.
The TACLE consists of a 16-byte prefix (defined by COPY DFHTACLE) and a
further 48-byte section, which is a modified copy of the DECB of the real line entry
at the time the TACLE was created.
To address the TACLE, the user-written terminal error program should therefore
contain the statements:
COPY DFHTACLE
COPY DFHTCTLE
L TCTLEAR,TEPCATCA
USING DFHTCTLE,TCTLEAR
Note that fields normally part of the real line entry DECB have offsets increased by
16 in the TACLE.
The following fields in the DECB copy in the TACLE do not represent data copies
from the real line entry:
TCTLEDCB
This field in the TACLE points to the real line entry; in the real line entry, it points to
the BSAM DCB for the line group.
TCTLECSW
TCTLEALP
These are used in the TACLE for SAM error information.
The following statements give direct addressability to the real line entry:
COPY DFHTCTLE
COPY DFHTCTTE
L
USING DFHTCTLE,TCTLEAR
L
USING DFHTCTTE,TCTTEAR
DROP
L
USING DFHTCTLE,TCTLEAR
and DFHTACP writes the 'DFHTC2522 INTERCEPT REQUIRED' message to
CSMT; if the task is not marked nonpurgeable, it is abended with code 'AEXY' or,
rarely, 'AEXZ'.
this case the normal result is that, if the line and terminal remain in service, the
read is retried.
(Offset 24 in TACLE,
8 in real TCTLE)
(Offsets 46, 48 in TACLE,
30, 32 in real TCTLE)
TCTLEAR,TEPCATCA
TCTTEAR,TCTLEPTE
TCTLEAR
TCTLEAR,TCTTELEA
POINT TO TACLE
POINT TO TACLE
POINT TO ERROR TCTTE
POINT TO TCTLE
Chapter 8. Writing a terminal error program
473