Perform a Trace

Initiation

Enter the command trace -display to check if there are free trace individuals.
Initiate the trace by using one of the commands below:
- Trace started on a specific program unit. trace -lim -unit
- Trace started on a specific signal number. trace -lim -unit -signo [-byte]
- Trace started on a specific signal name. trace -lim -unit -signam [-byte]
- Trace started on a directory number. trace -dir
- Trace started in a equipment position. trace -equ
- Trace started on a backplane 32 group. trace -hwpos [-mask]
- Trace started on the switch specific functions (LSU/DSU or Media Gateway internal functions). trace -hwpos -switch [-mask]

Modification

It is possible to modify the behavior of the trace individual.

Note:

The change command can be used any number of times as long as the trace has not started.

The following can be changed:

The trace individual
The trace individual can stop when maximum copies are received or overwrite the oldest
The size of the trace buffer
The signals to include or omit in the trace
The kind of text trace copies to include in the trace
A stop signal that will stop the trace if included in the trace
Stop conditions if an error signal is received
An information text to the trace individual (reminder or message to other users)

Note:

Several trace individuals can use the same stop condition.

Start Trace

Enter the command trace -start to start the trace or traces.

Note:

Several traces can be started with the same command.

Stop Trace

Enter the command trace -stop to stop the traces.

Note:

Several traces can be stopped with the same command.

Display Trace Status

You can check the status of the traces at any time. Status information can be printed without stating a trace individual. This will give a print of all 16 trace individuals statuses. If only one trace individual is given, only that trace individual will be printed.

If there is no LIM parameter, all buffer counters of the MX-ONE Service Nodes are added and printed. If there is a LIM parameter, the counter from that MX-ONE Service Node is printed. Depending on what type of trace that is initiated, different layouts will be used. All parameters entered are presented. Some additional information like pointers and program units, where a directory number resides, are also printed to help the administrator to identify the right data in the trace printout.

Related command and parameters are. trace -display [-lim]

Print Trace Result

When a trace is stopped it is possible to print the trace result. In a multi Server system, the trace copies will be printed in chronological order. It is possible to print from a specific MX-ONE Service Node with the LIM parameter. It is also possible to print copies containing a certain signal number, or to print a range of copies. To change the printout format a show parameter can be given to omit the parts of the signal that are regarded as irrelevant in the printout format.

Related command and parameters are: trace -print [-lim] [-from] [-to] [-signo] [-show]

Note:

The trace information and status are always printed in the header before the actual trace information, so that the trace setup can be examined when analyzing the result.

Clear the Trace Buffer

Enter the command trace -clear to clear the content of the trace buffer.

Note:

Several traces can be cleared with the same command.

Remove a Trace Individual

If a trace individual is not needed any more, free the trace individual by removing the trace configuration and placing the trace individual in idle state. The related command and parameter is: trace -remove