ULTRACE parameter: Difference between revisions
Jump to navigation
Jump to search
m (→Description) |
|||
| (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 $ | <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 | <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 | (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.