ULTRACEP parameter: Difference between revisions
m (1 revision) |
|||
| (6 intermediate revisions by 3 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 | <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 — | and output is being routed to the trace table (<code>ULTRACE X'04'</code> set — | ||
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 | |||
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> | </p> | ||
where | where <code>N</code> specifies that the last <var class="term">n</var> entries are to be displayed. | ||
Specifying | Specifying <code>D T</code> will display all trace entries, | ||
and specifying | and specifying <code>D T.20</code> 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 $ | with the <var>[[SirFact $functions#tr2list|$Trace2List]]</var> function or the <var>Stringlist</var> class <var>[[AppendTrace (Stringlist function)|AppendTrace]]</var> method. | ||
<!-- 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.