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

TRACE GOTO/CALL/RETURN
TRACE GOTO/CALL/RETURN
►►
TRace
Authorization
Purpose
Operands
GOto name
CALL name
RETurn
SUSpend
Privilege Class: G
1636 z/VM: CP Commands and Utilities Reference
Use TRACE GOTO, TRACE CALL, and TRACE RETURN to activate TRACE sets
by name.
GOto name
causes a trace set by the given name to become active. Specify name as a
unique 1- to 8-character identifier. If no trace set exists by that name, a new,
empty set is created. No program degradation occurs from an empty (null) trace
set. The previous trace set is unchanged but no longer active. If empty, it may
be deleted automatically.
You can use TRACE GOTO as the first command in a tracing session to
establish the name of an initial trace set. If traps are created without issuing a
TRACE GOTO, the initial trace set containing them is named INITIAL.
CALL name
causes a trace set by the given name to become active. If no trace set exists
by that name, a new, empty set is created. No program degradation occurs
from an empty (null) trace set. The previous trace set is unchanged and is
placed in a return list on a last-in, first-out basis.
You can enter the QUERY TRACE RETURNS command to display a list of
trace sets currently in the return list; the order is from most to least recent.
Recursive calling is not allowed; it is not permitted to call any trace set that has
itself called a trace set.
TRACE CALL is designed to be used with TRACE RETURN.
RETurn
causes the first trace set on the return list to be removed from the list and
become active. The previous trace set is unchanged but no longer active; if
empty, the previous trace set is deleted automatically.
SUSpend
causes the trace set being loaded to have no effect until the next TRACE
GOTO, TRACE CALL, or TRACE RETURN occurs. You can enter TRACE
commands to place traps for trace events in the set without affecting the
program that is currently in operation. A suspended trace set causes no
program degradation.
►◄