Use this command to display a specified number of bytes from a program
beginning at a relative starting address. You can display
real-time programs (both file resident and core resident), control
programs, and core image restart area programs (FCTB, ACPL, ICDF, IPLB, SIGT,
RIAT, and IPAT).
Requirements and Restrictions
- The LOADSET parameter and the version variable are valid only
after the E-type loader restart routine ends.
- This command cannot be used to display the following programs:
- The core copy of private programs cannot be displayed.
- The core copy of an I-stream unique program. To display the core
copy, use the ZRPGM command to lock the program in core and then use the ZDCOR
command to display the program.
- The core copy of ACPL, IPLA, and IPLB, because the core copy is only in
storage at restart time. The core copy cannot be displayed.
- You cannot enter this command for the file copies of C load
modules.
Format
- progname
- is a 4- to 6-character alphanumeric program name.
- version
- is a 2-character alphanumeric program version code. This parameter
can be specified only for real-time programs.
- rsa
- is the 1- to 6-digit hexadecimal relative starting address (offset) in the
program listing.
- bytes
- is the hexadecimal number of bytes to display from
X'01'-X'FFF'.
- Note:
- The maximum number of bytes for CIMR and IPL components is
X'FEF'.
- Instr
- displays the data in the disassembled format rather than the hexadecimal
format.
- Note:
- You can display only as many as X'400' bytes at a time in
disassembled format.
- Loadset
- specifies the loadset that contains the program you want to
display.
- lsname
- is the 5- to 8-character alphanumeric name of a loadset.
- BASE
- indicates that you want to display the base version of the program.
You can specify this option for the LOADSET parameter only for
real-time programs.
- Copy
- specifies which copy of the program to display:
- F
- displays the file copy.
- C
- displays the core (main storage) copy.
- B
- displays both the file and core copies.
- Type
- specifies which copy on file to display.
- R
- displays either the prime or the duplicate copy of the program.
- P
- displays the prime copy of the program.
- D
- displays the duplicate copy of the program.
- Note:
- This parameter is ignored if you specify the C option for the COPY
parameter.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZDPGM HELP
ZDPGM ?
- If you specify a relative starting address that does not begin on a
fullword boundary, the program adjusts that address to the next lower fullword
boundary. However, if you specify the INSTR parameter, the program
adjusts the address to the next lower halfword address.
- If you do not specify a program version code or a loadset name and there
is more than one version of the program active in core, the activation number
of the ECB determines the version of the program that is displayed.
- You can display the file copy of a real-time program in a loadset
even if the loadset is not active.
- You can display the core copy of a real-time program contained in a
loadset that was deactivated if the PAT slot for the program version was not
deleted. However, if the loadset is activated again, you cannot display
the old core copy of the real-time program in the loadset because all
references to that loadset use the copy of the program that was activated in
core.
- The ZDPGM command displays program records in the image that is currently
used by the processor. It cannot be used to display the
real-time program records of any other image. If the CIMR
component on the current image logically references another image, the logical
copy is displayed. In this case, the response message specifies the
actual image that was displayed.
- If you enter the ZDPGM command before the E-type loader restart
routine completes, you cannot specify the Loadset parameter or the
version variable. Therefore, you can use this command to
display only the base version of a program.
- Enter the ZAPGM command to change data in a program.
Examples
The following example displays the first 20 bytes of the CVAP program in
EBCDIC format.
+--------------------------------------------------------------------------------+
|User: ZDPGM CVAP |
| |
|System: DPGM0010I 14.30.56 BEGIN DISPLAY OF FILE COPY FOR |
| CVAP.40 ACTIVE IN LOADSET BASE |
| 00000000- 00FF0E4E C3E5C1D7 95019115 47808014 ....CVAP n.j..... |
| 00000010- 0A320010 9501911D 47808020 0A320018 ....n.j. ........ _ |
| END OF DISPLAY - ZEROED LINES NOT DISPLAYED |
+--------------------------------------------------------------------------------+
The following example displays 30 bytes of the prime file copy of the CVAP
program beginning at a relative starting address of X'28A'.
+--------------------------------------------------------------------------------+
|User: ZDPGM CVAP 28A.30 TYPE-P |
| |
|System: DPGM0010I 14.31.23 BEGIN DISPLAY OF FILE COPY FOR |
| CVAP.40 ACTIVE IN LOADSET BASE |
| 00000288- 401047F0 827CD505 40209390 4780831E ..0b@N. .l...c. |
| 00000298- 41404010 4630827C 12004780 82A81840 . ...b@ ....by. _ |
| 000002A8- 0A2C1851 185ED203 50008E04 D7015010 .....;K. &;..P.&; |
| 000002B8- 5010 &; |
| END OF DISPLAY - ZEROED LINES NOT DISPLAYED |
+--------------------------------------------------------------------------------+
The following example displays the CVAP program in disassembled
format.
+--------------------------------------------------------------------------------+
|User: ZDPGM CVAP 28A.20 INST |
| |
|System: DPGM0010I 15.28.54 BEGIN DISPLAY OF FILE COPY FOR |
| CVAP.40 ACTIVE IN LOADSET BASE |
| 0000028A 47F0 827C B 636(,R8) |
| 0000028E D505 4020 9390 CLC 32(6,R4),912(R9) |
| 00000294 4780 831E BC 8,798(,R8) |
| 00000298 4140 4010 LA R4,16(,R4) |
| 0000029C 4630 827C BCT R3,636(,R8) |
| 000002A0 1200 LTR R0,R0 |
| 000002A2 4780 82A8 BC 8,680(,R8) |
| 000002A6 1840 LR R4,R0 |
| 000002A8 0A2C GETCC |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
Related Information
See TPF Main Supervisor Reference for more
information about displaying program data.