IBM SC34-6814-04 User Manual

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.

The parameter list contains the following information:

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:

Place line out of service

Nonpurgeable task exists on the terminal

Place terminal out of service

Abend the task on the terminal

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

Chapter 8. Writing a terminal error program