Tracing SAF Requests › SAF SECTRACE Command

SAF SECTRACE Command

This command has the format:

SECTRACE [SET operand][MODIFY operand][ENABLE|DISABLE][DELETE][DISPLAY] id=trapid|ALL

SET|T operand

Defines a SAF SECTRACE trap. By default defines the trap as enabled.

MODIFY|F operand

Changes one or more operands of a named SAF SECTRACE trap. A SAF SECTRACE SET command must have previously defined the trap.

ENABLE

Activates the named SAF SECTRACE trap. A SAF SECTRACE SET command must have previously defined the trap.

DISABLE

Deactivates the named SAF SECTRACE trap. The trap definition is retained and can be reactivated by a subsequent SAF SECTRACE ENABLE command.

DELETE

Removes the named SAF SECTRACE trap definition.

D|DISPLAY

Displays the status and operands of the named SAF SECTRACE trap.

ID=trapid|ALL

Names the SAF SECTRACE trap. Define multiple trace requests by specifying a unique ID for each. Required with all SAF SECTRACE commands except the SAF SECTRACE SET command. If you do not supply an ID value with the SET command, the SAF SECTRACE command assigns a value. The format of the default trace ID is TRACE (nnn),where (nnn), is the next available sequential number.

ALL

Specifies that all IDs are to be traced.

Note: You must enter the ID on the MODIFY command before any other operand.

SECTRACE Command Use

The protection table of the SECTRACE command is shown below:

The ST command starts the SECTRACE address space and this address space remains up (but not active) until the next IPL. The only time the address space does anything is when the SAF SECTRACE is active. No attempt should be made to cancel the SECTRACE address space as unpredictable result might occur.

You can enter the SECTRACE command at an operator's console, at a terminal that acts as a console, or through SYS1.PARMLIB. When the first SAF SECTRACE command is entered, CA Top Secret automatically starts the SAF SECTRACE address space.

When you enter commands at a console, you can enter multiple keywords and operands by pressing ENTER after each line. SAF SECTRACE prompts you at the operator's console issuing the command for more operands until you type:

END		or
CANCEL.

This example shows the WTOR message asking for continuance of the SAF SECTRACE operands:

nn CAS21100 CONTINUE SECTRACE SPECIFICATION, CANCEL, OR END
 
R nn,JOBNAME=jobname,END