Sample terminal error program messages
The messages logged to the transient data destination CSMT (or, optionally, to the destination specified in the OPTIONS operand of DFHTEPM TYPE=INITIAL) are of six types, each identified by a unique message prefix.
You can control the selection of each type of message by using the appropriate parameters specified on the PRINT operand of DFHTEPM TYPE=INITIAL.
These messages are:
- DFHTEP, ERROR – error text
- During DFHTEP module generation, the PRINT parameter specified
ERRORS. This message can be suppressed by using the NOERRORS option.
The error text is one of the following:
- Unsupported error code, “xx”
- The error code presented to DFHTEP by DFHTACP is unknown to DFHTEP.
- “DFHTEPT” not defined in system
- The DFHTEP table could not be loaded into storage.
- Unknown error status message, “xxxx”
- The error status message presented from a remote 3270 type device could not be decoded.
None of these errors should occur.
- DFHTEP, ACTION – action flag names
- During
DFHTEP module generation, the PRINT parameter specified TACPACTION
or TEPACTION or both. If both are specified, this message is logged
twice each time DFHTEP is called. The first message indicates the
action flags as set by DFHTACP on entry to DFHTEP. The second message
indicates the action flags as returned to DFHTACP by DFHTEP after
error processing. These messages can be suppressed by using the NOTACPACTION
and NOTEPACTION options. The action flag names and descriptions are listed here. For further information about the actions taken by DFHTACP, see the description of the TEPCAACT field in Addressing the contents of the communication area.
- Flag name
- Description
- LINEOS
- Place line out of service
- NONPRGT
- Nonpurgeable task exists on terminal
- TERMOS
- Place terminal out of service
- ABENDT
- Abend task on terminal
- ABORTWR
- Abort write, free terminal storage
- RELTTIOA
- Release incoming message
- SIGNOFF
- Sign off terminal.
- DFHTEP, TID - tid
- During the DFHTEP module generation, the PRINT parameter specified TID. This message contains the symbolic terminal ID of the device associated with the error. This message can be suppressed by using the NOTID option.
- DFHTEP, DECB - DECB information
- During the DFHTEP module generation, the PRINT parameter specified DECB. This two-line message contains the DECB (printed in hexadecimal format) of the terminal causing the error. The DECB is contained in the TACLE (displacement +16 [decimal]). See the TACLE DSECT described in Writing a terminal error program. This message can be suppressed by using the NODECB option.
- DFHTEP, TACLE - TACLE information
- During the DFHTEP module generation, the PRINT parameter specified TACLE. This message (printed in hexadecimal format) contains the first 16 bytes of the TACLE passed to DFHTEP by DFHTACP. See the TACLE DSECT described in Writing a terminal error program. This message can be suppressed by using the NOTACLE option.
- DFHTEP, ESE - ESE information
- During
the DFHTEP module generation, the PRINT parameter specified ESE.
This message contains the error status element. The message can be
suppressed by using the NOESE option.
An ESE is either 6 bytes or 12 bytes long, depending on whether the TIME option was specified when generating the TEP tables. The formats are as follows:
Table 1. Format of error status element on DFHTEP, ESE messages—NOTIME specified Display Length (bytes) Significance — NOTIME specified 0 2 Error threshold counter or weight value in binary format 2 2 Current error count or weight value in binary 4 1 Error code 5 1 Not used. Table 2. Format of error status element on DFHTEP, ESE messages—TIME specified Display Length (bytes) Significance — TIME specified 0 5 Error threshold counter or weight value in binary format 5 3 Timed threshold value in hundredths of a second 8 4 Time of first occurrence of this error. Time given as binary integer in hundredths of a second.