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.
About this task
You generate the communication area DSECT by coding
DFHTEPCA TYPE=DSECT in your program. The layout of the communication
area is shown in Figure 1.
Figure 1. The DFHTACP/DFHTEP communication area
IN/OUT
PARM
0XL4 Standard Header
TEPCALDS DS XL1 I Function Code Always '1'
TEPCAGDS DS XL2 I Component Code Always 'TC'
DS XL1 Reserved
TEPCATCA DS A I Address of TACLE being processed
TEPCECIA DS A I Address of TCTUA
TEPCECIL DS H I Length of TCTUA
TEPCAACT DS XL1 I/O User action byte
TEPCATID DS CL4 I Terminal identity
TEPCATDB DS F I Current time of day binary
The parameter list contains the following information:
- TEPCALDS
- 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’.
- TEPCAGDS
- Component Code. This always has the value ‘TC’, representing a component of the TCP.
- TEPCATCA
- Contains the address of the TACLE being processed.
- TEPCECIA
- Contains the address of the terminal control table user area (TCTUA).
- TEPCECIL
- Contains the length of the TCTUA.
- TEPCAACT
- 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
- ABORTWR (X'08')
- Abend write, free terminal storage
- RELTTIOA (X'04')
- Release TCAM incoming message. (TCAM is no longer supported.)
- SIGNOFF (X'02')
- Call sign-off program.
On return to DFHTACP, the flags represent the actions as modified by DFHTEP.
- TEPCATID
- Contains the identity of the terminal in error.
- TEPCATDB
- Contains the time of day when the error occurred, in binary format.