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

Usage Notes
TRACE STORE (ESA/390, z/Architecture)
hexloc
restrict 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 may 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)
CONVERT UTF-8 to UNICODE (CUTFU)
MOVE LONG (MVCL)
MOVE LONG EXTENDED (MVCLE)
MOVE LONG UNICODE (MVCLU)
MOVE STRING INSTRUCTION (MVST)
TRANSLATE EXTENDED (TRE)
TRANSLATE ONE TO ONE (TROO)
TRANSLATE ONE TO TWO (TROT)
TRANSLATE TWO TO ONE (TRTO)
TRANSLATE TWO TO TWO (TRTT)
2. If the DATA option is specified, the length of the virtual storage that is monitored
for alteration is defined by the length of the DATA string. If this length added to
the specified hexloc generates a wraparound address range, the ending
address of the storage to be monitored is set to the end of storage as defined
by CP’s current architecture.
3. Guest control register values and translation table contents define the address
space structure of the virtual machine. Program execution (and the STORE
command) can change that structure over time. The TRACE command
operands that specify a guest address space to be traced by a trace trap use
the guest control register and translation table values to determine the segment
table origin (STO) of the address space to be traced at the time the TRACE
command is issued. The STO is contained in the trace trap and can be
Chapter 2. CP Commands 1649