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.
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
vrs in these cases relates to the Version, Release and SM level of the Com-plete being installed.
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.
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. |
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" |
||||||||||||||||
|
|||||||||||||||||
| User Exits | TUDUEX1 | ||||||||||||||||
| Return Codes |
|