ULTRACEP parameter

From m204wiki
Revision as of 19:03, 13 March 2012 by JALWiccan (talk | contribs) (1 revision)
Jump to navigation Jump to search

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.