gtpo1mhk | Operations |
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:
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:
where x is a non-hexadecimal character.
The following are some examples of how to code the PARM= parameter :
PARM=(00040000,00AF8000)
PARM=(,00AF8000)
PARM=(00040000)
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.
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 /*
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.
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.
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.