gtpo1mhkOperations

Stand-Alone Dump Postprocessor (SADPRT) Utility

The stand-alone dump postprocessor (SADPRT) utility is a utility program that runs under IBM MVS control to create a printed storage dump from the data captured on the SADUMP tape.

The dump output is unformatted; that is, TPF dump tags and formatted storage blocks do not display as they do in an online TPF dump. However, the data is translated into EBCDIC on the right-hand side of each page to assist you with locating items in the dump. The general purpose registers and store status information (if a STORE STATUS was issued before the dump) are displayed at the beginning of the dump.

The address range of main memory that is printed from the dump tape may be limited by optionally specifying the following PARM= parameter in the EXEC statement:
PARM=(start_address,end_address)

where:

start_address
is the beginning address of the range to print (8 bytes).

end_address
is the end address of the range to print (8 bytes).

Parameters are positional. You must specify leading zeros if start_address or end_address is less than 8 characters. If you omit a parameter, you must specify a comma (,) in place of that parameter. If you omit start_address, the beginning address range defaults to 0. If you omit end_address, the end of the address range defaults to the end of the dump. If you do not specify the PARM parameter, the SADPRT utility prints the entire dump.

The PARM= parameter errors are reported by an ABEND accompanied by one of the following messages:

The following are some examples of how to code the PARM= parameter :

Setup

The SADPRT utility is assembled and link-edited during the system initialization program (SIP). The tape device must be able to read the format that was used by the tape device that created the dump. If multiple tape reels were used, they must be coded on the DUMPTAP DD card in the same order that they were created, as shown in Sample JCL for Processing the SADPRT Utility.

Sample JCL for Processing the SADPRT Utility

The following example shows the JCL required to process the SADPRT utility on an IBM MVS system:

//STEP1    EXEC PGM=SADPRT40,REGION=8K,PARM=(001D0E00,003BC000)
//STEPLIB  DD   DSN=*LINK.LIBRARY*,DISP=SHR
//DUMPTAP  DD   DSN=DUMP.TAPE,UNIT=TAPE,DISP=OLD,LABEL=(,NL),
//  VOL=SER=(VOL001,VOL002)
//DUMPPRT  DD   SYSOUT=A
//SYSABEND DD   SYSOUT=A
//SYSUDUMP DD   SYSOUT=A
/*
Note:
Replace *LINK.LIBRARY* with the library containing SADPRT40.

Processing Procedures

If you do not specify the PARM= parameter, the entire dump is printed. If the dump was created on multiple tape volumes, the SADPRT utility calls for them in the order that they are specified in the VOL=SER= parameter of the DUMPTAP DD card. Because nonlabeled tapes are used, no internal sequence checking is performed. The tapes must be mounted in the correct order.

Normal End-of-Job

The dump output is spooled to the SYSOUT class specified on the DUMPPRT DD card. See Sample JCL for Processing the SADPRT Utility for more information. The SADPRT utility suppresses duplicate print lines to conserve paper. For example, only the first line of a large storage area containing binary zeros appears in the dump.

Abnormal End-of-Job

The SADPRT utility issues no error messages of its own other than the PARM= error messages that were previously listed. Abnormal conditions are handled and reported by IBM MVS error recovery.