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

DUMP Registers
Usage Notes
Responses
v From register 1 through register 15 if you are dumping general, control, or
access registers
v From register 1 through register 6 (or 0 through 15 if floating-point extensions
are available) if you are dumping floating-point registers.
END
. regcount
regcount is a decimal number from 1 to 16 or a hexadecimal number from 1 to
F specifying the number of registers (starting with register 1) whose contents
are to be dumped. If you specify G, GG, GH, X, XG, XH, or AR, regcount can
be a decimal number from 1 to 16 or a hexadecimal number from 1 to F.
If dump type Y is specified, regcount must be 1, 2, 3, or 4 (or 0 through 15 if
floating-point extensions are available).
The sum of reg1 and regcount must be a number that does not exceed the
maximum register number for the type of registers being dumped.
Specify END to dump the contents of all remaining registers. END is the
default. The remaining registers are as follows:
v From register 1 through register 15, if you are dumping general, control, or
access registers
v From register 1 through register 7 (or 0 through 15 if floating-point extensions
are available), if you are dumping floating-point registers.
*dumpid
is an asterisk followed by a 1- to 97-character identifier that is to be assigned to
the dump (may be truncated to 80 characters for a z/Architecture guest). If
specified, *dumpid must be the last operand you enter on the command line.
1. The G and X operands are valid for an ESA/390, ESA/XC, or z/Architecture
guest. For an ESA/390 or ESA/XC guest, these operands refer to the full
four-byte register. For a z/Architecture guest, these operands refer to the
low-order four bytes of the full eight-byte register.
2. The GG and XG operands are valid for an ESA/390, ESA/XC, or z/Architecture
guest. For an ESA/390 or ESA/XC guest, these operands refer to the full
four-byte register. For a z/Architecture guest, these operands refer to the full
eight-byte register.
3. The GH and XH operands are valid only for a z/Architecture guest. These
operands refer to the high-order four bytes of the full eight-byte register.
4. When a dash (-), colon (:), or period (.) is not preceded by a register number,
the first register number defaults to 0. When a dash, colon, or period is not
followed by a register number, the last register defaults to END.
5. For more information, see “Usage Notes” on page 351.
Response 1:
Dump Register
GPR nn = genreg0 genreg1 genreg2 genreg3
402 z/VM: CP Commands and Utilities Reference
is the response that is sent to the virtual printer when you dump the general
registers using D G or D GG from an ESA/390 or ESA/XC guest. nn indicates the
first (or only) register whose contents are dumped.