|
|
|
|
|
The trace instruction works with the trace line instruction to monitor scripts.
Synopsis
trace(type.src [, type.src])
Description
The trace script instruction works with the trace line command to display a message from the script if the trace command is run on the channel on which the script is running. These trace messages allow application developers to monitor the progress of a script. This capability is useful in debugging and troubleshooting scripts, either during the initial application development or if problems rise while the application is running. The trace instruction allows TSM to print messages to the shared memory area for trace messages. These messages can include the default trace messages for TSM or for a specific channel.
Note:
If there are too many traces running simultaneously on a system, the buffer in which this information is stored may be filled and some data lost, with no notice of this in the trace output.
The first argument is evaluated as a number and is used as a step identifier. The optional argument can be used to print a specific data value of interest. The optional argument may be any integer type or a null terminated character string.
Examples
The instruction
trace(1000)
in a script running on channel 2 produces the following line in the output of the trace command if it is being run for that channel.
CH002: script: STEP: 1000.
where script is the name of the script running on channel 2.
The instruction
trace(1000, "Accessing Customer Database")
in a script running on channel 21 produces the following line in the output of the trace command if it is being run for that channel.
CH021: script STEP: 1000 VALUE: Accessing Customer Database
See also
