TUDUEX1 - Select Dumps by User-Defined Criteria

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:


How To Use TUDUEX1

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.

TUDUEX1 Conventions

The following table summarizes the TUDUEX1 linkage conventions.

Feature Convention
Attributes None required.
Type Batch.
Size No restriction .
Registers at Entry
Register 1 Points to the directory record of the dumped program selected for print
Register 13 Address of an 18-word z/OS-compatible save area
Register 14 Return address
Register 15 Entry point address
Registers at Return Registers must be unchanged except register 15, which contains the return code.
Return Codes
0 Print this dump.
4 Skip this dump; continue processing with the next dump.
Considerations Will be loaded by TUDUMP.