NET/MASTER Management Services (MS) Command Reference Manual

LBANNER

TRACE ALTER

NonStop NET/MASTER MS Commands

2–568 115412 Tandem Computers Incorporated

TRACE ALTER The TRACE ALTER command alters the trace parameter settings in a running trace to

the current settings in the trace parameter list (TPL). If you start a new trace (using the

TRACE START command) but then make changes to the parameter settings for that

trace (using the TRACE trace-spec command), you can use this command to implement

the changes to the running trace. Since parameter settings are reset after a TRACE

START command, you must reenter the original settings in addition to the new

settings if you want to supplement the trace parameter settings of a running trace.

All current values in the TPL (except the trace ID, trace file name, pages specification,

and wrap-around specification) are used when altering a trace. After a trace is altered,

the trace parameter settings in the TPL are reset to their default values. You can use

the SHOW TRACE=ALL command to display information about a running trace,

including its trace ID.

TRACE ALTER=

trace-id

specifies the trace ID of a running trace. The trace ID is a number returned by a

previous TRACE START command. You can specify a trace ID from 1 through

65535.

Considerations

The default authority level of this command is 3. If the trace ID represents a trace

started by another user, your authority level must be greater than that of the other

user.

You can enter this command from any NCL procedure, except the INIT NCL

procedure, by using the CMD core statement or the INTCMD verb.

When this command is executed, the values of the parameter settings in the TPL

are sent to the trace collector.

For related information, see the SHOW TRACE and other TRACE commands.

Example

The following command alters the trace parameter settings for the trace with the trace

ID of 5:

TRACE ALTER=5