Addressing The Contents Of The Communication Area - IBM SC34-6814-04 Customization Manual

Addressing the contents of the communication area

After your terminal error program receives control from DFHTACP, it should obtain
the address of the communication area by means of an EXEC CICS ADDRESS
COMMAREA command.
You generate the communication area DSECT by coding DFHTEPCA
TYPE=DSECT in your program. The layout of the communication area is shown in
Figure 25.
0XL4
TEPCALDS DS XL1
TEPCAGDS DS XL2
DS XL1
TEPCATCA DS A
TEPCECIA DS A
TEPCECIL DS H
TEPCAACT DS XL1
TEPCATID DS CL4
TEPCATDB DS F
Figure 25. The DFHTACP/DFHTEP communication area
The parameter list contains the following information:
TEPCALDS
TEPCAGDS
TEPCATCA
TEPCECIA
TEPCECIL
TEPCAACT
IN/OUT
PARM
Standard Header
I Function Code
I Component Code
Reserved
I Address of TACLE being processed
I Address of TCTUA
I Length of TCTUA
I/O User action byte
I Terminal identity
I Current time of day binary
Function Code. The Function Code is a printable character representing the
identity of the task within the TCP which invoked DFHTEP. It always has
the value '1'.
Component Code. This always has the value 'TC', representing a
component of the TCP.
Contains the address of the TACLE being processed.
Contains the address of the terminal control table user area (TCTUA).
Contains the length of the TCTUA.
The User action byte. One of the main uses of the communication area is
to transmit the actions that are to be taken for a terminal. TEPCAACT
contains the following flags, which can be reset within DFHTEP:
LINEOS (X'80')
Place line out of service
NONPRGT (X'40')
Nonpurgeable task exists on the terminal
TERMOS (X'20')
Place terminal out of service
ABENDT (X'10')
Abend the task on the terminal
Always '1'
Always 'TC'
Chapter 8. Writing a terminal error program
471