Common subroutines

A number of subroutines are provided in the sample DFHXTEP for use by the error processors. Each subroutine entry has a label of the form “TEPxxxxx” where “xxxxx” is the subroutine name

. All labels within a subroutine start with TEPx where “x” is the first character of the subroutine name. All subroutines are arranged within the module in alphabetical order in the subroutine section. Register conventions and use of the subroutine are given as comments at the beginning of each subroutine in the source listing.

The following subroutines are available for writing your own error processors:

TEPACT
Used to output the names of the action bits set by DFHTACP and the sample DFHTEP in the communication area field TEPCAACT if appropriate PRINT options are selected when the program is generated.
TEPDEL
Used to delete the terminal error block and error status elements for a terminal from the TEP error table on exit from an error processor.
TEPHEXCN
Used by TEPPUTTD to convert a 4-bit hexadecimal value to its 8-bit printable equivalent.
TEPINCR
Used to update and test the count and time threshold totals maintained in the terminal's error status element.
TEPLOC
Used to locate or assign terminal error blocks and error status elements for a terminal ID.
TEPPUTTD
Used to output character or hexadecimal data to a user-defined transient data destination.
TEPTMCHK
Used by TEPINCR to determine whether the time threshold has been passed.
TEPWGHT
Used to update the weight/time threshold values maintained in the terminal's error status elements.
Figure 1. Overview of the sample terminal error program (DFHXTEP)
The picture shows the structure of the sample terminal error program, as described in the preceding pages. The program is seen to move through the following stages: entry and initialization; terminal ID and error code lookup; error processor selection (a number of alternative error processors are shown, some of which make use of common subroutines); error processor execution; general exit.


dfha3c00147.html | Timestamp icon Last updated: Sunday, 4 June 2017