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

TRSOURCE ID (Definition Operands)
EVENT
specifies the recording mode for tracing. This mode must match the capabilities
of the guest virtual machine.
If you specify BLOCK, the guest virtual machine passes blocks of trace data to
the control program. These blocks are written to a system trace file.
If you specify EVENT, the virtual machine passes individual records directly to
the control program. Each trace record is written to a system trace file.
The DATA Trace
Trace type DATA allows the user to dynamically define trace entries to record
execution of most code paths in CP. The LOC parameter specifies which instruction,
when executed, triggers recording of information. Data link parameters define what
information is collected when the trace springs.
Note: Any or none of the following DATA parameters may be specified on a
TRSOURCE command. Specification of a given parameter must be
consistent with the state of the traceid as defined by previously entered
parameters, including parameters entered via previous invocations of the
TRSOURCE command.
LOC { address instruction }
{ modname + disp instruction }
DL datalinks
IF datalink { EQ } { datalink }
{ NE } { constant }
{ GT }
{ GE }
{ LT }
{ LE }
THEN { DL datalinks }
{ }
{ IF ... ENDIF }
ELSE { DL datalinks }
{ }
{ IF ... ENDIF }
ENDIF
1686 z/VM: CP Commands and Utilities Reference
LOC address
specifies the address in the CP nucleus that identifies the trace point at which
the data is to be collected.
LOC modname + disp
specifies the CP module name and displacement into that module that identifies
the trace point at which the data is to be collected. If the module is written in a
higher-level language, an 8-character module name must be supplied.
See Type Data Usage Note 6 on page 1691 for a list of restricted locations.
instruction
identifies in hexadecimal characters the contents of storage at the specified
trace point. Matching the specified instruction with the contents of storage
verifies that the trace point is at the intended location in the CP nucleus. The
instruction supplied must be at least as long as the instruction to be verified.
Only that instruction is verified, and any extraneous hexadecimal data is