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

TRACE TRAP
TRACE TRAP
►►
TRace
Authorization
Purpose
TRAP
Operands
Usage Notes
Responses
ident
options
Privilege Class: G
1658 z/VM: CP Commands and Utilities Reference
Use TRACE TRAP to alter a named trace trap.
TRAP
applies the options you specify to a single event.
All primary TRACE operands establish units of control called traps. Each trap,
except for TRACE ALL, is assigned a unique identifier and has its own set of
options, such as TERM, PRINT, RUN, and STEP.
TRACE ALL creates a unique set of traps replacing any active TRACE ALL
command. These traps each have an identifier of “ALL,” which may be used for
changing trace options or deleting the trap. For those traps for which SIM and
NOSIM are valid options, you can specify SIM or NOSIM with TRAP.
Any valid option you may specify with the TRAP operand you may specify
without any primary TRACE operand. Not specifying a primary TRACE operand
has the same effect as a TRACE TRAP command processed for each event in
the current trace set.
ident
identifies a trace trap describing the event; it must be one to four characters
long. If a trap already exists with the given identifier, it is replaced by the trap
for the newly defined event. You cannot use the word ALL as an identifier; on
the TRACE TRAP command, this option is not valid.
options
except for ID, you can specify any of the options. For a full explanation of the
options, see “TRACE: Options” on page 1604.
1. Note that you cannot specify the ID option with TRACE TRAP to change the
identifier of an existing trap. In order to change the identifier, you must redefine
the trap.
2. With the exception of SIM and NOSIM, you can use TRACE TRAP to modify
only those options listed here. To change unique options not listed here, you
must redefine the trap. However, you can use TRACE TRAP to modify the SIM
and NOSIM on any trap for which they are valid options.
3. For more information, see “Usage Notes” on page 1601.
For response information, see “TRACE: Command Responses” on page 1610.
►◄