User-written terminal error programs, The sample terminal error program – IBM SC33-1683-02 User Manual

Page 469

Advertising
background image

This example generates 10 terminal error blocks, one of which is reserved for
the terminal whose symbolic ID is TM02, and the other nine are reusable. Each
TEB has space for five error status elements plus a common error bucket. Of
the five ESEs, two are reserved for error codes ‘81’ and ‘87’; the remaining
ESEs are available to be assigned dynamically. The thresholds for error code
‘87’ and the common error bucket are being changed. No specific error code is
to be accounted for in the common error bucket.

User-written terminal error programs

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 21.

Table 21. Supplied source files and macros

Name

Type

Description

Library

DFHXTEP

Source

Sample terminal error
program (assembler
language)

CICSTS13.CICS.SDFHSAMP

DFHXTEPT

CSECT

Sample terminal error
tables (assembler
language)

CICSTS13.CICS.SDFHSAMP

DFHTEPM

Macro

Sample TEP program
generator (assembler
language)

CICSTS13.CICS.SDFHMAC

DFHTEPT

Macro

TEP table generator
(assembler language)

CICSTS13.CICS.SDFHMAC

* TABLE SPECIFICATIONS

DFHTEPT

TYPE=INITIAL,MAXTIDS=10,

MAXERRS=5

* PERMANENT TERMINAL DEFINITIONS

DFHTEPT

TYPE=PERMTID,TRMIDNT=TM02

* PERMANENT ERROR CODE DEFINITIONS

DFHTEPT

TYPE=PERMCODE,CODE=81

DFHTEPT

TYPE=PERMCODE,CODE=87,

COUNT=2,TIME=(1,MIN)

* OTHER THRESHOLD OVERRIDES

DFHTEPT

TYPE=ERRCODE,CODE=BUCKET,

COUNT=3,TIME=(3,MIN)

* CONCLUDE TABLE GENERATION

DFHTEPT

TYPE=FINAL

END

Figure 20. Example of the use of DFHTEPT macros to generate DFHTEP tables

the sample terminal error program

Chapter 8. Writing a terminal error program

437

Advertising