In addition to being able to define the JCL PARM string, you can also define your own criteria to select dumps from the dump SD-file for print by using the TUDUEX1 exit.
TUDUEX1 is a user-written service routine that can be used to implement user-defined tests and restrictions when printing dumps out of the Com-plete dump file.
When Com-plete is initially installed, a dummy TUDUEX1 module exists as a member of the distribution source library to serve as a guide. This routine must be coded and assembled.
This document covers the following topics:
TUDUEX1 is called after each dump header record is read by TUDUMP and checked according to the key values input with the JCL PARM string. When TUDUEX1 gets control, register 1 points to the dump directory record. An LR R3,R1 instruction is performed at start of TUDUEX1, using R3 as base register for the dump directory dsect (DSDDDIRE). RF is set to zero. Your tests and restrictions referring to the directory data can now be inserted. For the layout of this DSECT, see CCSDLIB in the distributed source library.
TUDUEX1 can provide return code 0 to allow printing of dump, return code 4 to disallow the dump to be printed, or can abend to terminate TUDUMP.
The following table summarizes the TUDUEX1 linkage conventions.
| Feature | Convention | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Attributes | None required. | ||||||||
| Type | Batch. | ||||||||
| Size | No restriction . | ||||||||
| Registers at Entry |
|
||||||||
| Registers at Return | Registers must be unchanged except register 15, which contains the return code. | ||||||||
| Return Codes |
|
||||||||
| Considerations | Will be loaded by TUDUMP. |