Writing Your Own Terminal Error Program; Why Write Your Own Terminal Error Program; Restrictions On The Use Of Exec Cics Commands - IBM SC34-6814-04 Customization Manual

Writing your own terminal error program

You can write your own terminal error program in any of the languages supported
by CICS. However, CICS-supplied code is provided in assembler language only.
The names of the supplied source files and macros, and the libraries in which they
can be found, are listed in Table 24.
The user-written DFHTEP receives control in the same manner as the
CICS-supplied sample DFHTEP, described in "The communication area" on page
451. It should therefore use the communication area as its basic interface with
DFHTACP.

Why write your own terminal error program?

v There are some situations in which CICS may try to send a message to an
v There could be application-related activity to be carried out when a terminal error
v Not all errors represent communication-system failures - for example, SAM

Restrictions on the use of EXEC CICS commands

There are certain restrictions on the commands that a TEP can issue. The use of
any commands that require a principal facility causes unpredictable results,
and should be avoided. In particular, you should not use commands that invoke
the following functions:
v Terminal control ("CEMT-type" commands, such as EXEC CICS INQUIRE
v BMS (except routing)
v ISC communication (including function shipping).
470
Customization Guide
Table 24. Supplied source files and macros
Name Type
DFHXTEP Source
DFHXTEPT CSECT
DFHTEPM Macro
DFHTEPT Macro
DFHTEPCA Macro
input-only terminal; for example, an 'invalid transaction ID' message, or a
message wrongly sent by an application program. You should provide a terminal
error program to reroute these messages to a system destination such as CSMT
or CSTL or other destinations, by means of transient data or interval control
facilities.
occurs. For example, if a message is not delivered to a terminal because of an
error condition, it may be necessary to notify applications that the message
needs to be redirected.
end-of-data conditions.
TERMINAL, are permissible)
Description
Sample terminal error
program (assembler
language)
Sample terminal error
tables (assembler
language)
Sample TEP program
generator (assembler
language)
TEP table generator
(assembler language)
Assembler-language
communication area
Library
CICSTS32.CICS.SDFHSAMP
CICSTS32.CICS.SDFHSAMP
CICSTS32.CICS.SDFHMAC
CICSTS32.CICS.SDFHMAC
CICSTS32.CICS.SDFHMAC