ULTRACEP parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Template:ULTRACEP parameter subtitle}}
==Summary==
==Summary==
<dl>
<dl>
Line 8: Line 9:
<dd>User and <var>[[$Resetn]]</var> 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 numeric parameter indicates the maximum number of CCATEMP pages that
This numeric parameter indicates the maximum number of [[Using_the_system_scratch_file_(CCATEMP)|CCATEMP]] pages that
will be allocated for a user for holding trace data.
will be allocated for a user for holding trace data.
The CCATEMP wrap-around trace table is a user-specific trace table that
The CCATEMP wrap-around trace table is a user-specific trace table that
consists of a set of CCATEMP pages whose maximum size is specified by the
consists of a set of CCATEMP pages whose maximum size is specified by the
ULTRACEP user parameter.
<var>ULTRACEP</var> user parameter.


If ULTRACEP pages are already in use when a Trace statement is issued,
If <var>ULTRACEP</var> pages are already in use when a <var>[[Trace statement|Trace]]</var> statement is issued,
and output is being routed to the trace table (ULTRACE X'04' set &mdash;
and output is being routed to the trace table (<code>ULTRACE X'04'</code> set &mdash;
see [[ULTRACE parameter]]), the trace data on the oldest page is discarded,
see <var>[[ULTRACE parameter|ULTRACE]]</var>), the trace data on the oldest page is discarded, and the oldest page is reused for the new trace data.
and the oldest page is re-used for the new trace data.
For more information on the Trace statement, see the [[SirFact Reference Manual]].


The wrap-around trace table is dumped in [[SirFact]] dumps, and it can be viewed
The wrap-around trace table is dumped in <var class="product">[[SirFact]]</var> dumps, and it can be viewed with the following command when using the [[SirFact FACT subsystem|FACT]] subsystem to examine a dump:
with the following command when using the FACT subsystem to examine a dump:
<p class="code">D[ISPLAY] T[RACE][.{* | N}]
<p class="code">
</p>
    D[ISPLAY] T[RACE][.{* | N}]
where <code>N</code> specifies that the last <var class="term">n</var> entries are to be displayed.
</pre>
Specifying <code>D T</code> will display all trace entries,
where ''''N'''' specifies that the last ''n'' entries are to be displayed.
and specifying <code>D T.20</code> will display the last 20.
Specifying ''''D T'''' will display all trace entries,
and specifying ''''D T.20'''' will display the last 20.


The current contents of the wrap-around trace table can also be examined
The current contents of the wrap-around trace table can also be examined
with the $trace2list function or the StringList class AppendTrace method.
with the <var>[[SirFact $functions#tr2list|$Trace2List]]</var> function or the <var>Stringlist</var> class <var>[[AppendTrace (Stringlist function)|AppendTrace]]</var> method.
For more information about [[SirFact]] dumps, the $trace2list function, and
 
the AppendTrace method, see the [[SirFact Reference Manual]].
<!-- VTPRNAME - BELONGS TO CCA -->
<!-- VTPRNAME - BELONGS TO CCA -->


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

Latest revision as of 14:22, 17 October 2017

Max UL Trace statement pages

Summary

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

Description

This numeric parameter indicates the maximum number of CCATEMP pages that will be allocated for a user for holding trace data. The CCATEMP wrap-around trace table is a user-specific trace table that consists of a set of CCATEMP pages whose maximum size is 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 — see ULTRACE), the trace data on the oldest page is discarded, and the oldest page is reused for the new trace data.

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 current contents of the wrap-around trace table can also be examined with the $Trace2List function or the Stringlist class AppendTrace method.