TUDUMP - Dump Print Utility Program

#### Search Results

Search

# TUDUMP - Dump Print Utility Program

The batch utility program TUDUMP provides the means to obtain hard copy printouts of dump entries in the online dump file of the COMSD data set. Sample execution job control is given in the Com-plete distribution source library in member JCLTUDUM.

When an online program abnormally terminates, it generates a dump entry in the online dump file of the COMSD data set. These dump entries may be reviewed interactively by use of the utility program UDUMP. To obtain a printout of one or more specific dump entries, execute the batch program TUDUMP, or use the PRINT option of UDUMP.

- How to Use TUDUMP

- Parameter Input

- TUDUMP Conventions

## How to Use TUDUMP

The job control required to execute program TUDUMP is illustrated below:

    //TUDUMP     JOB   ... job-card information ...
    //TUDUMP     EXEC  PGM=TUDUMP,REGION=512K,
    //  PARM='D=mmdd1-mmdd2,I=tid,N=nn1-nn2,P=xxxxxx,L=nn,
    //             T=hhmmss1-hhmmss2,E=aaannnn,SHORT'
    //STEPLIB    DD    DSN=COM.LOAD,DISP=SHR
    //SYSPRINT   DD    SYSOUT=X
    //SYSUDUMP   DD    SYSOUT=X
    //COMSD      DD    DSN=COM.SD,DISP=SHR

    * $$ JOB JNM=TUDUMP,DISP=D,CLASS=?   ......  POWER JOB CARD INFORMATION
    * $$ LST DISP=D,CLASS=A
    // JOB   TUDUMP                      ......  JOB CARD INFORMATION
    // LIBDEF    PHASE,SEARCH=SAGLIB.COMvrs                <---- Note 1
    // DLBL      COMCAT,'????????',,VSAM                   <---- Note 2
    // DLBL      COMSD,'COM.VSAM.SDFILE',,VSAM,CAT=COMCAT
    // EXEC      TUDUMP,SIZE=AUTO,PARM='D=mmdd1-mmdd2,I=tid,N=nn1-nn2,     *
                 P=xxxxxx,L=nn,T=hhmmss1-hhmmss2,E=aaannnn,SHORT,
    /*
    /&
    * $$ EOJ

1. vrs in these cases relates to the Version, Release and SM level of the Com-plete being installed.

2. Change ???????? to the required catalog file name.

Descriptions of the DD/DLBL statements used in the preceding job control are given in the table in the next section.

## Parameter Input

The specific dump entry in the online dump file for which a printout is desired is identified to TUDUMP via parameter information. The format of the parameter information is:

    D=mmdd1-mmdd2,I=tid,L=nn,N=nn1-nn2,P=xxxxxx,T=hhmmss1-hhmmss2,
    SHORT

All parameters are optional, as is their sequence. No parameter input means print the entire dump file.

The arguments are:

D=mmdd1-mmdd2 | Default: D=0101-1231
| Specifies a range (mmdd1 through mmdd2) of the date a dump entry was generated. The date is the date as it appears in the UDUMP ALL display. Note that mmdd1 and mmdd2 are three- to four-digit numbers in the form month (one- to two-digits), day (two digits).
E=aaannnn | Default: E=ALL
| Specifies the error code (as shown on the UDUMP ALL overview) to be selected (e.g. E=ABS0006).
I=tid | Default: I=ALL
| Specifies the tid of the terminal causing the dump entry to be generated. Note that tid is a one- to three-digit number.
LINECNT=nn | Default: L=55
| Specifies the number of lines to be printed on each page of output. Note that nn must be between 1 and 99.
N=nn1-nn2 | Default: N=001-032
| Specifies the number range (nn1 through nn2) of the dumps as they exist in the online dump file. Either a range or a specific dump number may be specified.
P=xxxxxx | Default: P=ALL
| Specifies the name of the online program that abnormally terminated, causing the dump entry to be generated. The name xxxxxx is the name of the program as it appears in the UDUMP ALL display. To print all programs, specify ALL. To print only programs starting with a "U", specify UTI. To print all programs without "U" in the first position of their name, specify NOUTI.
T=hhmmss1- hhmmss2 | Default: T=000000-235959
| Specifies a range (hhmmss1 through hhmmss2) of time when a dump entry has been generated. The time is the time as it appears in the UDUMP ALL display. Note that hhmmss1 and hhmmss2 are five- to six-digit numbers in the form hour (one- to two-digits), minutes (two digits), seconds (two digits).
SHORT | Indicates that only the regs page(s) is to be printed.

The following table summarizes the TUDUMP DD/DLBL names.

DD/DLBL | Description
--- | ---
SYSPRINT/SYSLST | Output file for error messages and for generating the printout of the dump z/OS Default DCB: RECFM=FA, LRECL=133, BLKSIZE=133 z/VSE DEVADDR=SYSLST.
COMSD | SD library z/OS Default DCB: None.

## TUDUMP Conventions

The following table summarizes the TUDUMP coding conventions.

Feature | Convention
--- | ---
SYSIN/SYSIPT | None
PARM/SYSPARM | Format: "D=mmdd1-mmdd2,I=tid,L=nn,N=nn1-nn2, P=xxxxxx,T=hhmmss1-hhmmss2,SHORT"
D=mmdd1-mmdd2 | Range of date
I=tid | Terminal ID
L=nn | Number of lines per page (1 to 99)
N=nn1-nn2 | Range of online dump numbers
P=xxxxxx | Program name
T=hhmmss1-hhmmss2 | Range of time
E=aaannnn | Error Code
SHORT | Indicator: print regs page(s) only
User Exits | TUDUEX1
Return Codes |
00 | Normal completion
04 | Dump not found

### On this page

- How to Use TUDUMP
- Parameter Input
- TUDUMP Conventions