DISPLAY
3. When multiple operands are entered on a line for location or register displays, the default display type is the same as the
previous explicit display type. The explicit specification of a
display type defines the default for subsequent operands for the current 1isplav function. If a dash or colon is omitted between
the hexloc1 and hexloc2 operands and they are separated by one or mJre blanks, only the storaqe contents at those two specific
locations are displayed. Blanks are used to separate operands or
sets of operands if more than one is entered on the same =ommand line. Blanks must not be used to the right or left of the ranqe or length delimiters (: or -or .), unless it is intended to
take the default value of the missing operand defined by the blank.
For example: display 10 20 T40 80 G12 5 L60-100 displays the respectively:
hexadecimal location 10 hexadecimal location 20 hexadecimal location 40 with EBCDIC translation
hexadecimal location 80 with EBCDIC translation
general register 12
general register 5
hexadecimal locations 60 through 100 4. To terminate the DISPLAY function while data is being displayed at
the terminal, press the attention key (or its equivalent). When the 1isplay terminates, another command may be entered.
5. The command does not distinguish between
nonshared storage; it displays any of the virtual
addressable storage whether shared or not.
shared and
machine's
6. Use the DISPLAY command to display the contents of various storage
locations, reqisters, and control words at the terminal. By
examining this type of information during the program's execution, you nay be able to determine the cause of program errors. Usually, an address stop is set to stop the program execution at a specified
point. The system enters the CP environment and you may then issue
the DISPLAY command.
7. When yoa must examine large portions of storage, use the DUMP command rather than the DISPLAY command. Because the terminal
operates at a much slower speed than the printer, only limited
amounts of storaqe should be printed (via the DISPLAY command) at
the terminal.
8. When runninq with a discontiguous saved segment (DCSS), you can
display storage locations outside the range of your virtual machine
size if they are within the Dess. If there exist locations between
the upper limit of your virtual machine and the address at which
the Dess saved, an attempt to display those locations (or
associated keys) results in a "nonaddressable storage" message. One or more of the followinq responses is displayed, depending upon the
operands specified.
Section 5. Format of CP Commands 77
DfflPLAY xxxxxx word1 word2 word3 word4 rkeyl *EBCDIC TRANSLATION*
This is the response you receive when you display storage
locations; xxxxxx is the hexadecimal storage location of wordl. Word1 is displayed (word-aliqned) for a single location
specification. Up to four words are displayed on a line, followed, by an EBCDIC translation of those four words. Periods are represented by nonprintable characters. Kultiple lines are used (if required) for a range of locations. If translation to
EBCDIC is requested (Thexloc), alignment is made to the next lower
16-byte boundary; otherwise, alignment is made to the next lower
fullword boundary. If the location is at a 2K page boundary, the
key for that paqe is also displayed.
xxxxxx TO xxxxxx KEY = kk
This is the response you receive when you display storage keys; XXXX[X is a storage location and kk is the associated storage key.
GPR n = qenreql qenreg2 genreg3 qenreg4
This is the response you receive when you display general n is the register whose contents are genreg1. The
contents of the following consecutive registers are genreg2, and so on. The contents of the reqisters are displayed in hexaiecimal. Up to four reqisters per line are displayed for a
ranqe of reqisters. Multiple lines are displayed if required, with
a of four lines needed to display all 16 general reqisters. FPR n = xxxxxxxxxxxxxxxx .xxxxxxxxxxxxxxxxx E xx
This is the response you receive when you display floating-point registers; n is the even-number floating-point register whose contents are displayed on this line. The contents of the requested
floatinq-point reqisters are displayed in both the internal
hexaiecimal format and the E format. One register is displayed per
line. Multiple lines are displayed for a range of registers.
78 IBM VM/37Q CP Command Reference for General Users
Previous Page Next Page