ULTRACEP parameter: Difference between revisions
m (1 revision) |
mNo edit summary |
||
| Line 8: | Line 8: | ||
<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 CCATEMP pages that | ||
| Line 17: | Line 18: | ||
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</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 | and the oldest page is reused for the new trace data. | ||
For more information on the Trace statement, see the [ | For more information on the <var>Trace</var> statement, see the [http://sirius-software.com/maint/download/factr.pdf SirFact_Reference_Manual]. | ||
The wrap-around trace table is dumped in | 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 FACT subsystem to examine a dump: | with the following command when using the <var>FACT</var> subsystem to examine a dump: | ||
<p class="code"> | <p class="code">D[ISPLAY] T[RACE][.{* | N}] | ||
</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>$Trace2List</var> function or the <var>StringList</var> class <var>[[AppendTrace (Stringlist function)|AppendTrace]]</var> method. | ||
For more information about | For more information about <var class="product">SirFact</var> dumps, the <var>$Trace2List</var> function, and | ||
the AppendTrace method, see the | the <var>AppendTrace</var> method, see the <var class="product">SirFact</var> manual. | ||
<!-- VTPRNAME - BELONGS TO CCA --> | <!-- VTPRNAME - BELONGS TO CCA --> | ||
[[Category:User parameters]] | [[Category:User parameters]] | ||
[[Category:Parameters]] | [[Category:Parameters]] | ||
Revision as of 21:05, 13 March 2012
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.
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 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. For more information about SirFact dumps, the $Trace2List function, and the AppendTrace method, see the SirFact manual.