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

TRACE STORE (ESA/XC)
Usage Notes
1652 z/VM: CP Commands and Utilities Reference
decimal digits. The access list entry token within the access register is used in
conjunction with the host-access register translation tables to locate the address
space to be traced.
ASITasit
restricts tracing to events in the address space identified by the address space
identification token, asit.
PRI
restricts tracing to the current primary address space.
SPACEowner:space_name
limits tracing to the address space identified by owner:space_name, where
owner: specifies the user ID that owns the address space and space_name is
the name of the address space—the owner’s user ID can be omitted if the
owner is the user issuing the command. The space name is a string of
alphanumeric and national characters, 1 to 24 characters long.
range
limits tracing to changes to at location within the specified range.
The range can be a single address or a pair of addresses separated by a
period (.) or a hyphen (-). A hyphen denotes a starting and ending range. A
period denotes a starting address and a byte count. A data location is
considered to be within the range if the first byte is within the range.
hexloc
limits tracing to a specific location for the conditions set by the DATA and MASK
operands. The operand hexloc can be any valid address. It cannot be a range
of addresses.
DATA hexstring
specifies a hexadecimal data string to be matched when a store occurs into the
specified hexloc. The length of the data string determines the bounds of the
test. If the MASK option is also specified, the mask is logically applied to both
storage and the DATA string before the comparison is made. The DATA
operand requires the INTO hexloc operand.
MASK hexstring
specifies a hexadecimal string that forms a mask for data comparison when a
store occurs in the specified hexloc. When you specify the MASK option, the
mask is logically applied to both storage and the DATA string before the
comparison is made. Only those bits and bytes that are binary ones are
checked. The MASK operand requires the INTO hexloc operand and the DATA
option. The length of the MASK string must be the same as the length of the
string you specified for the DATA option.
options
For an explanation of the options, see “TRACE: Options” on page 1604.
1. TRACE STORE does not trace storage alterations caused by the following
instructions:
All DIAGNOSE instructions
All Cryptographic facility instructions
All VECTOR instructions
Asynchronous I/O instructions
IUCV/VMCF/APPC
COMPRESSION CALL (CMPSC)
CONVERT UNICODE to UTF-8 (CUUTF)