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

TRACE G
TRACE G
►►
TRace
Notes:
Authorization
Purpose
Operands
(1)
G
0-F
,
▼ n
-m
Privilege Class: G
DATA
DATA
0-FFFFFFFF
range
MASK
MASK
MASK
0-FFFFFFFF
0-FFFFFFFF
hexstring
options
1 Do not put blanks between the operands that describe the register or range of registers to be
traced.
1632 z/VM: CP Commands and Utilities Reference
Use TRACE G to trace changes in your virtual machine general purpose registers.
Note: You can trace all changes or only those that cause a particular register, or
set of registers, to assume a specified value.
G...
identifies the general register or range of general registers whose alterations
you want to trace. If you are specifying a range of general purpose registers,
use a hyphen between the first register number and last register number in the
range.
You may specify the register numbers in either decimal or hexadecimal.
Wrap-around ranges (that is, ranges whose ending register is less than the
starting register) are permitted. For example, trace G10-2 is a valid range; it
establishes tracing of alterations to registers 10, 11, 12, 13, 14, 15, 0, 1, and 2.
DATA range
specifies a data value or range of data values to be checked to see if any of the
altered registers assume a value within the range. The range may be a single
value or a pair of values separated by a period (.) or a hyphen (-). A hyphen
denotes a starting and ending range. A period denotes a starting range for a
byte count. Range values are viewed as unsigned 32-bit integers. If no data
range is specified for general register alteration tracing, 0-FFFFFFFF is
assumed. Wrap-around data ranges are not allowed.
MASK hexstring
specifies a hexadecimal string that forms a mask for data comparison. The
MASK string is logically applied to both the register and the data range before a
comparison is made.
options
For an explanation of the options, see “TRACE: Options” on page 1604.
►◄