DP (Disk Print)

Purpose
Print physical disk records.
Usage notes
Use this function to print all records from a physical disk extent in character format or one of the two dump formats. Begin and end positions must be specified as a range of tracks.
Options
You can use the various SET processing options to control the print output:
  • SET PRINTOUT defines the destination of the print output. If set to PRINTOUT=SYSOUT, you can use the PB (Print Browse) function to browse the accumulated output.
  • SET RECLIMIT controls how many bytes of each record are printed.
  • SET DATAHDR determines whether header information, such as record number, is printed.
  • The format of the print output also depends on the settings of SET PAGESIZE, SET PRINTLEN and SET PRTTRANS.
  • Use SET DUMP to specify the dump format.

Specify a logical record length to deblock the physical records. If it is not a multiple of the physical record size, the remainder is printed as a short record.

Use the LISTONLY keyword to specify how much information you want to print. You can request the home address and all count, key, and data fields of each track, or only count or key fields. The default is to print all key and data fields.

For a CKD disk, use the dump type to specify how much information you want to print. You can request the home address and all count, key, and data fields of each track, or only count or key fields. The default is to print all key and data fields.

Related functions
DRS
Locate data on a disk
DSP
Print records from a data set
Read syntax diagramSkip visual syntax diagram
Syntax

>>-DP--+-INPUT=ddname--------------------+--+-------------+----->
       +-DSNAME=dsname-+---------------+-+  '-BEGIN=begin-'   
       |               '-VOLSER=volser-' |                    
       '-VOLSER=volser-------------------'                    

                .-FORMAT=CHAR---.  .-LISTONLY=KD-------.   
>--+---------+--+---------------+--+-------------------+-------->
   '-END=end-'  '-FORMAT=format-'  '-LISTONLY=listonly-'   

>--+-----------------+-----------------------------------------><
   '-RECSIZE=recsize-'   

begin
Start position in one of the following forms:
cylhd
Where the last two digits represent the head, and the other digits represent the cylinder (CKD)
Rnnnnnn
To indicate the track number (CKD)
*
The first track of the data set (the default).

Depending on the value of the SET CYLHD processing option, you specify either the absolute disk location or the relative location within the data set.

ddname
Refers to a DD or TSO ALLOC statement.
dsname
Name of a disk data set.
end
End position in one of the following forms:
cylhd
Where the last two digits represent the head, and the other digits represent the cylinder (CKD)
Rnnnnnn
To indicate the track number (CKD)
Nnnnnnnn
The number of tracks (CKD) to be processed
*
The last track of the data set (the default).

Depending on the value of the SET CYLHD processing option, you specify either the absolute disk location or the relative location within the data set.

format
The format of the output:
CHAR
Character format (the default)
HEX
Hexadecimal format.
listonly
For a CKD disk, the information you want printed:
KD
Key and data fields of each record (the default)
CNT
Home address and count fields of each record
CKD
Home address and record 0 fields, followed by the count, key, and data fields
KEY
Only the key fields.
recsize
Logical record size to be used to deblock each physical record into logical records. The maximum is 65 535. The physical block size does not need to be a multiple of recsize. For a CKD disk, only the data field is deblocked.
volser
Volume serial number for a non-cataloged data set.
//DP  JOB (acct),'name'  Disk Print
//*
//HFMBAT    PROC
//HFMBAT    EXEC PGM=HFMMAIN
//STEPLIB  DD DSN=HFM.SHFMMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//         PEND
//*
//ZDTOOLS  EXEC HFMBAT
//DISK     DD DSN=FMO.H0GB210.SHFMMOD1,DISP=SHR
//SYSIN    DD *
$$FILEM SET CYLHD=RELATIVE
$$FILEM DP  INPUT=DISK,BEGIN=R0,END=N10
$$FILEM EOJ
/*