z/VM: CP Commands and Utilities Reference - z/VM - IBM

G-5 0-G5
G5- G5-end
G5 G5
T Error
T- T0-end
T-1000
T0-1000
T1000-
T1000-end
T1000 T1000
PSW Current
3. When displaying a range of addresses or subchannels, the command operand
must be followed by an address, a range, or by a hyphen (-), colon (:), or period
(.). When displaying registers, the command operand can stand alone.
4. If you enter a command line that contains an operand that is not valid, the
DISPLAY command terminates when it encounters that operand. Any previous
valid operands are processed before termination occurs.
5. The DISPLAY command lets you display storage in the following formats:
v Hexadecimal string/word segments
v EBCDIC or ASCII translation
v Hexadecimal word segments with EBCDIC translation
v Instruction
v Storage key
DISPLAY
Note: The EBCDIC translation is displayed only when the storage location
contains the hexadecimal representation contained in a system
translation table. This table is tailorable by the system programmer via
the system configuration file. The IBM supplied table supports
translations for the hexadecimal representation of the digits 0 through 9,
the uppercase and lowercase letters A through Z, and a number of
special characters. In all other cases, a period (.) is displayed.
If you enter multiple operands on a single command line to display
storage and do not specify the format that you want the DISPLAY
command processor to use, the last format type you explicitly enter on
the command line defines the type of display you receive. That is,
whenever you explicitly enter a display type, you implicitly define the
default for subsequent operands of the current display function. If you do
not enter any display format type on the command line, the system
defaults are employed.
For example, the command display 10 20 T40 80 G12 5 L60-100 displays the
following, respectively:
v Hexadecimal location 10 without EBCDIC translation
v Hexadecimal location 20 without EBCDIC translation
v Hexadecimal location 40 with EBCDIC translation
v Hexadecimal location 80 with EBCDIC translation
v The contents of general register 12
v The contents of general register 5
v Hexadecimal locations 60 through 100 without EBCDIC translation.
6. Use the DISPLAY command to display the contents of various storage locations,
registers, and control words. You can examine this information during program
execution, and may be able to determine the cause of program errors.
To do this, you would typically define a TRACE trap, using the TRACE
command, that will stop program execution at a specified point. Once program
execution suspends, your virtual machine enters the CP environment, and you
Chapter 2. CP Commands 283