ULTRACEP parameter
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 parameter), the trace data on the oldest page is discarded, 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 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 Reference Manual.