ULTRACEP parameter: Difference between revisions
m (→Description) |
|||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:ULTRACEP parameter subtitle}} | |||
==Summary== | ==Summary== | ||
<dl> | <dl> | ||
| Line 14: | Line 15: | ||
==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 | ||
| Line 20: | Line 21: | ||
<var>ULTRACEP</var> user parameter. | <var>ULTRACEP</var> user parameter. | ||
If <var>ULTRACEP</var> pages are already in use when a <var>Trace</var> 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 (<code>ULTRACE X'04'</code> set — | and output is being routed to the trace table (<code>ULTRACE X'04'</code> set — | ||
see <var>[[ULTRACE parameter|ULTRACE]]</var>), 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 reused for the new trace data | |||
The wrap-around trace table is dumped in <var class="product">SirFact</var> 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 | |||
<p class="code">D[ISPLAY] T[RACE][.{* | N}] | <p class="code">D[ISPLAY] T[RACE][.{* | N}] | ||
</p> | </p> | ||
| Line 35: | Line 33: | ||
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 <var>$Trace2List</var> function or the <var>Stringlist</var> class <var>[[AppendTrace (Stringlist function)|AppendTrace]]</var> method. | 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.