ULTRACE parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
 
(6 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Template:ULTRACE parameter subtitle}}
==Summary==
==Summary==
<dl>
<dl>
Line 6: Line 7:
<dd>User
<dd>User
<dt>Where set
<dt>Where set
<dd>User and $RESETN resettable
<dd>User and <var>[[$Resetn]]</var> resettable
<dt>Related products
<dt>Related products
<dd>[[SirFact]]
<dd><var class="product">[[SirFact]]</var>
<dt>Introduced
<dt>Introduced
<dd>Before [[Sirius Mods]] 6.7
<dd>Before <var class="product">Sirius Mods</var> 6.7
</dl>
</dl>
==Description==
==Description==
This bitmask parameter controls the behavior of the User Language <var>[[Trace statement|Trace]]</var> statement.
This bitmask parameter controls the behavior of the User Language <var>[[Trace statement|Trace]]</var> statement
The bits mean:
(as well as [[Text and Html statements]] with the <var>Trace</var> option,
the <var>[[TraceText statement|TraceText]]</var> statement, and
<var>Trace</var> methods in several classes, for example the <var>XmlDoc</var> <var>[[Trace (XmlDoc/XmlNode subroutine)|Trace]]</var> subroutine and the <var>Arraylist</var> <var>[[Trace (Arraylist subroutine)|Trace]]</var> subroutine).
 
The <var>ULTRACE</var> bit settings are:
<dl>
<dl>
<dt>X'01'
<dt>X'01'
<dd>Send TRACE output to terminal.
<dd>Send <var>TRACE</var> output to terminal.
This is the default.
This is the default.
<dt>X'02'
<dt>X'02'
<dd>Send TRACE output to audit trail.
<dd>Send <var>TRACE</var> output to [[Tracking_system_activity_(CCAJRNL,_CCAAUDIT,_CCAJLOG)#CCAAUDIT_and_CCAJLOG|audit trail]].
<dt>X'04'
<dt>X'04'
<dd>Send TRACE output to a CCATEMP wrap-around trace table.
<dd>Send <var>TRACE</var> output to a [[Using_the_system_scratch_file_(CCATEMP)|CCATEMP]] wrap-around trace table.
See the [[ULTRACEP parameter|ULTRACEP]] parameter.
See the <var>[[ULTRACEP parameter|ULTRACEP]]</var> parameter.
</dl>
</dl>
The default setting for ULTRACE (X'01') means that the <var>Trace</var> statement
The default setting for <var>ULTRACE</var> (X'01') means that the <var>Trace</var> statement
acts much like a <var>Print</var> statement.
acts much like a <var>Print</var> statement.
The bits can be combined so that output can be sent to both the terminal
The bits can be combined so that output can be sent to both the terminal
Line 31: Line 36:
terminal and to the audit trail.
terminal and to the audit trail.


If a <var>Trace</var> statement is executed when ULTRACE is set to 0, the request is
If a <var>Trace</var> statement is executed when <var>ULTRACE</var> is set to 0, the request is cancelled.
cancelled.


[[Category:User parameters]]
[[Category:User parameters]]
[[Category:Parameters]]
[[Category:Parameters]]

Latest revision as of 14:48, 16 October 2017

UL Trace statement flags

Summary

Default value
X'01'
Parameter type
User
Where set
User and $Resetn resettable
Related products
SirFact
Introduced
Before Sirius Mods 6.7

Description

This bitmask parameter controls the behavior of the User Language Trace statement (as well as Text and Html statements with the Trace option, the TraceText statement, and Trace methods in several classes, for example the XmlDoc Trace subroutine and the Arraylist Trace subroutine).

The ULTRACE bit settings are:

X'01'
Send TRACE output to terminal. This is the default.
X'02'
Send TRACE output to audit trail.
X'04'
Send TRACE output to a CCATEMP wrap-around trace table. See the ULTRACEP parameter.

The default setting for ULTRACE (X'01') means that the Trace statement acts much like a Print statement. The bits can be combined so that output can 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.