Trace statement: Difference between revisions
m (Created page with "TRACE Statement The TRACE statement acts very much like a PRINT or AUDIT statement with the exception that the target for the TRACE statement can be dynamically changed by RESET'...") |
mNo edit summary |
||
| Line 1: | Line 1: | ||
The <var>Trace</var> statement acts very much like | |||
The | a <var>Print</var> or <var>Audit</var> statement with the exception that the target for the <var>Trace</var> | ||
exception that the target for the | statement can be dynamically changed by RESET'ing the [[ULTRACE parameter]]. | ||
RESET'ing the ULTRACE parameter. The ULTRACE parameter is a standard | The ULTRACE parameter is a standard bit-oriented user parameter where the | ||
user parameter where the bits mean: | bits mean: | ||
X'01' Send | <dl> | ||
X'02' Send | <dt>X'01' | ||
X'04' Send | <dd>Send <var>Trace</var> output to terminal. | ||
The default setting for ULTRACE is X'01' which means that the | <dt>X'02' | ||
act pretty much like a | <dd>Send <var>Trace</var> output to audit trail. | ||
be sent to both the terminal and the audit trail or to the CCATEMP wrap-around trace | <dt>X'04' | ||
table and to the terminal and to the audit trail. If a | <dd>Send <var>Trace</var> output to a CCATEMP wrap-around trace table. | ||
ULTRACE is set to 0, the request is cancelled. | </dl> | ||
The CCATEMP wrap-around trace table is a user-specific trace table that consists of a | The default setting for ULTRACE is X'01' which means that the <var>Trace</var> statement | ||
set of CCATEMP pages up to a maximum specified by the ULTRACEP user parameter. | will act pretty much like a <var>Print</var> statement. | ||
If ULTRACEP pages are already in use when a | The bits can be combined so that output could be sent to both the terminal | ||
is being routed to the trace table (ULTRACE X'04' set), the trace data on the oldest page | and the audit trail or to the CCATEMP wrap-around trace table and to the | ||
is discarded and the oldest page is re-used for the new trace data. The default value for | terminal and to the audit trail. | ||
ULTRACEP is 2. | If a <var>Trace</var> statement is executed when ULTRACE is set to 0, the request is | ||
The wrap-around trace table is dumped in SirFact dumps, and it can be viewed with the | cancelled. | ||
following command when using the FACT subsystem to examine a dump: | |||
D[ISPLAY] T[RACE][.{* | N}] | The CCATEMP wrap-around trace table is a user-specific trace table that | ||
where N specifies that the last n entries are to be displayed. Specifying D T will display | consists of a set of CCATEMP pages up to a maximum specified by the | ||
all trace entries, and specifying D T.20 will display the last 20. | ULTRACEP user parameter. | ||
The wrap-around trace table can also be examined with the $TRACE2LIST function | If ULTRACEP pages are already in use when a <var>Trace</var> statement is issued | ||
( | and output is being routed to the trace table (ULTRACE X'04' set), the | ||
trace data on the oldest page is discarded and the oldest page is re-used | |||
for the new trace data. | |||
The default value for ULTRACEP is 2. | |||
The wrap-around trace table is dumped in [[SirFact]] dumps, and it can be viewed | |||
with the following command when using the FACT subsystem to examine a dump: | |||
<p class="code"> D[ISPLAY] T[RACE][.{* | N}] | |||
</p> | |||
where <code>N</code> specifies that the last ''n'' entries are to be displayed. | |||
Specifying <code>D T</code> will display all trace entries, | |||
and specifying <code>D T.20</code> will display the last 20. | |||
The wrap-around trace table can also be examined with the $TRACE2LIST | |||
function ([[??]] refid=tr2lst.). | |||
ULTRACE and ULTRACEP can both be RESET via the $RESETN function. | ULTRACE and ULTRACEP can both be RESET via the $RESETN function. | ||
[[Category:User Language statements]] | [[Category:User Language statements]] | ||
Revision as of 19:59, 17 February 2011
The Trace statement acts very much like a Print or Audit statement with the exception that the target for the Trace statement can be dynamically changed by RESET'ing the ULTRACE parameter. The ULTRACE parameter is a standard bit-oriented user parameter where the bits mean:
- X'01'
- Send Trace output to terminal.
- X'02'
- Send Trace output to audit trail.
- X'04'
- Send Trace output to a CCATEMP wrap-around trace table.
The default setting for ULTRACE is X'01' which means that the Trace statement will act pretty much like a Print statement. The bits can be combined so that output could be sent to both the terminal and the audit trail or to the CCATEMP wrap-around trace table and to the terminal and to the audit trail. If a Trace statement is executed when ULTRACE is set to 0, the request is cancelled.
The CCATEMP wrap-around trace table is a user-specific trace table that consists of a set of CCATEMP pages up to a maximum specified by the ULTRACEP user parameter. If ULTRACEP pages are already in use when a Trace statement is issued and output is being routed to the trace table (ULTRACE X'04' set), the trace data on the oldest page is discarded and the oldest page is re-used for the new trace data. The default value for ULTRACEP is 2.
The wrap-around trace table is dumped in SirFact dumps, and it can be viewed with the following command when using the FACT subsystem to examine a dump:
D[ISPLAY] T[RACE][.{* | N}]
where N specifies that the last n entries are to be displayed.
Specifying D T will display all trace entries,
and specifying D T.20 will display the last 20.
The wrap-around trace table can also be examined with the $TRACE2LIST function (?? refid=tr2lst.).
ULTRACE and ULTRACEP can both be RESET via the $RESETN function.