Command Reference › TRACE Command › Definitions

Definitions

LIST [ userid [ macname ] ]

Lists all active traces and their trace number for the specified user IDs and macros. Both userid and macname can contain the pattern matching characters % and *. The default value for userid is the issuing user ID and the default for macname is all macros.

MACRO

Indicates that the command is to trace the specified macros. A trace number is generated from this parameter which you can use later to stop tracing.

[ macname ]

Specifies the filename of the executable macros to trace. The macro name can contain the pattern matching characters % and *. The default is all macros. You must specify the macname parameter if you use any of the subsequent parameters.

[ LINES first last ]

Indicate the numbers of the first line and the last line of the range of macro lines to trace. The default for first is 0 and the default for last is the last line of the macro.

[ OPT option ]

Specifies the amount of information the command is to include in the trace messages. If the macros are written in EXEC2, you can use one of the following options:

• ALL
• ERR
• OFF
• ON

If the macros are written in REXX, you can use one of the following options:

• A
• C
• ERR
• I
• N
• OFF
• R
• ALL
• E
• ERROR
• L
• O
• ON

[ USER userid ]

Specifies that the command is to trace the indicated macros when run by this userid; userid can contain the pattern matching characters * and %. The default is your user ID.

[ TO destuser ]

Specifies the user ID to receive trace messages. The default is the user ID specified on the USER parameter. Specifying a destuser value of ‘*’, sends the messages or print file to the CA VM:Secure product server.

[ TYPE | MSG | PRINT ]

Indicates where to send the trace messages:

• TYPE sends the messages to the terminal of the TO user ID; when the TO user ID and the USER user ID are the same, TYPE is the default. When the user ID specified on the TO parameter is different than the user ID specified on the USER parameter, CA VM:Secure changes the TYPE parameter to MSG
• MSG sends the messages using CP MSGNOH or MSG to the terminal of the TO user ID; when the TO user ID and the USER user ID are different, MSG is the default
• PRINT sends the messages in a printer spool file to the virtual reader of the TO user ID

STOP { tracenumber | * | [ USER ] userid }

Cancels the specified active trace. The tracenumber is the number CA VM:Secure assigns to each trace; you can use the LIST parameter to determine this number. The * cancels all traces currently defined on the system. The USER userid parameter cancels all traces that apply to the specified user ID. The USER keyword is required only if the user ID is all numeric.

CLOSE { tracenumber | * | [ USER ] userid }

Closes a printer spool file for the specified active trace, but tracing continues. Use the CLOSE parameter only to close traces that were started with the PRINT parameter. The tracenumber is the number CA VM:Secure assigns to each trace; use the LIST parameter to determine this number. The * cancels all traces currently defined on the system. The USER userid parameter cancels all traces that apply to the specified user ID. The USER keyword is required only if the user ID is all numeric.