Trace statement - Revision history

JAL: link repair

2016-03-01T21:42:16Z

link repair

← Older revision		Revision as of 21:42, 1 March 2016
Line 42:		Line 42:
	and specifying <code>D T.20</code> will display the last 20.		and specifying <code>D T.20</code> will display the last 20.

	The wrap-around trace table can also be examined with the <var>$Trace2List</var>		The wrap-around trace table can also be examined with the <var>[[SirFact $functions#tr2list\|$Trace2List]]</var> function.
	function ~~(described in the <var class="book">[http://m204wiki.rocketsoftware.com/images/f/fb/FactrNew.pdf Rocket Model 204 SirFact Reference Manual]</var>)~~.

	<var>ULTRACE</var> and <var>ULTRACEP</var> can both be <var>RESET</var> via the <var>[[$Resetn]]</var> function.		<var>ULTRACE</var> and <var>ULTRACEP</var> can both be <var>RESET</var> via the <var>[[$Resetn]]</var> function.

Dme: /* Syntax */

2015-09-10T20:23:10Z

Syntax

← Older revision		Revision as of 20:23, 10 September 2015
Line 50:		Line 50:
	As described above, the <var>Trace</var> statement is a variant of the <var>Print</var> statement, and so the syntax is the same:		As described above, the <var>Trace</var> statement is a variant of the <var>Print</var> statement, and so the syntax is the same:

	{{Template:??}}		{{Template:Trace statement syntax}}

	==See also==		==See also==

Dme: /* Seealso */

2015-09-10T20:07:04Z

Seealso

← Older revision		Revision as of 20:07, 10 September 2015
Line 47:		Line 47:
	<var>ULTRACE</var> and <var>ULTRACEP</var> can both be <var>RESET</var> via the <var>[[$Resetn]]</var> function.		<var>ULTRACE</var> and <var>ULTRACEP</var> can both be <var>RESET</var> via the <var>[[$Resetn]]</var> function.

	==~~Seealso~~==		==Syntax==
			As described above, the <var>Trace</var> statement is a variant of the <var>Print</var> statement, and so the syntax is the same:

			{{Template:??}}

			==See also==
	The trace destination setting (as specified by the <var>ULTRACE</var> parameter) also controls:		The trace destination setting (as specified by the <var>ULTRACE</var> parameter) also controls:
	<ul>		<ul>

JAL at 20:57, 13 August 2014

2014-08-13T20:57:56Z

← Older revision		Revision as of 20:57, 13 August 2014
Line 42:		Line 42:
	and specifying <code>D T.20</code> will display the last 20.		and specifying <code>D T.20</code> will display the last 20.

	The wrap-around trace table can also be examined with the <var>[[$Trace2List]]</var>		The wrap-around trace table can also be examined with the <var>$Trace2List</var>
	function.		function (described in the <var class="book">[http://m204wiki.rocketsoftware.com/images/f/fb/FactrNew.pdf Rocket Model 204 SirFact Reference Manual]</var>).

	<var>ULTRACE</var> and <var>ULTRACEP</var> can both be <var>RESET</var> via the <var>[[$Resetn]]</var> function.		<var>ULTRACE</var> and <var>ULTRACEP</var> can both be <var>RESET</var> via the <var>[[$Resetn]]</var> function.

JAL at 18:23, 17 June 2014

2014-06-17T18:23:58Z

← Older revision		Revision as of 18:23, 17 June 2014
Line 2:		Line 2:
	The <var>Trace</var> statement acts very much like		The <var>Trace</var> statement acts very much like
	a <var>Print</var> or <var>Audit</var> statement with the exception that the target for the <var>Trace</var>		a <var>Print</var> or <var>Audit</var> statement with the exception that the target for the <var>Trace</var>
	statement can be dynamically changed by RESET'ing the [[ULTRACE parameter]].		statement can be dynamically changed by RESET'ing the <var>[[ULTRACE parameter\|ULTRACE]]</var> parameter.
	The ULTRACE parameter is a standard bit-oriented user parameter where the		The <var>ULTRACE</var> parameter is a standard bit-oriented user parameter where the
	bits mean:		bits mean:
	<table>		<table class="thJustBold">
	<tr><th>X'01'		<tr><th>X'01'
	</th><td>Send <var>Trace</var> output to terminal.		</th><td>Send <var>Trace</var> output to terminal.
	</td></tr>		</td></tr>

	<tr><th>X'02'		<tr><th>X'02'
	</th><td>Send <var>Trace</var> output to audit trail.		</th><td>Send <var>Trace</var> output to audit trail.
	</td></tr>		</td></tr>

	<tr><th>X'04'		<tr><th>X'04'
	</th><td>Send <var>Trace</var> output to a CCATEMP wrap-around trace table.		</th><td>Send <var>Trace</var> output to a CCATEMP wrap-around trace table.
	</td></tr></table>		</td></tr>
	The default setting for ULTRACE is X'01' which means that the <var>Trace</var> statement		</table>
	~~will act pretty~~ much like a <var>Print</var> statement.		The default setting for <var>ULTRACE</var> is X'01' which means that the <var>Trace</var> statement acts much like a <var>Print</var> statement.
	The bits can be combined so that output could be sent to both the terminal		The bits can be combined so that output could be sent to both the terminal
	and the audit trail or to the CCATEMP wrap-around trace table and to the		and the audit trail or to the CCATEMP wrap-around trace table and to the
	terminal and to the audit trail.		terminal and to the audit trail.
	If a <var>Trace</var> statement is executed when ULTRACE is set to 0, the request is		If a <var>Trace</var> statement is executed when <var>ULTRACE</var> is set to 0, the request is
	cancelled.		cancelled.

	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 up to a maximum specified by the		consists of a set of CCATEMP pages up to a maximum specified by the
	ULTRACEP user parameter.		<var>[[ULTRACEP parameter\|ULTRACEP]]</var> user parameter.
	If ULTRACEP 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</var> statement is issued
	and output is being routed to the trace table (ULTRACE X'04' set), the		and output is being routed to the trace table (<var>ULTRACE</var> X'04' set), the
	trace data on the oldest page is discarded and the oldest page is re-used		trace data on the oldest page is discarded and the oldest page is re-used
	for the new trace data.		for the new trace data.
	The default value for ULTRACEP is 2.		The default value for <var>ULTRACEP</var> is 2.

	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
Line 43:		Line 45:
	function.		function.

	ULTRACE and ULTRACEP can both be RESET via the $~~RESETN~~ function.		<var>ULTRACE</var> and <var>ULTRACEP</var> can both be <var>RESET</var> via the <var>[[$Resetn]]</var> function.

	==~~See also~~==		==Seealso==
	The trace destination setting (as specified by the ULTRACE parameter) also controls:		The trace destination setting (as specified by the <var>ULTRACE</var> parameter) also controls:
	<ul>		<ul>
	<li>[[Text and Html statements]] with the <var>Trace</var> option		<li>[[Text and Html statements]] with the <var>Trace</var> option
Line 52:		Line 54:
	<li>Trace methods in several classes, for example the <var>XmlDoc</var> <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var> subroutine and the <var>Arraylist</var> <var>[[Trace (Arraylist subroutine)\|Trace]]</var> subroutine		<li>Trace methods in several classes, for example the <var>XmlDoc</var> <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var> subroutine and the <var>Arraylist</var> <var>[[Trace (Arraylist subroutine)\|Trace]]</var> subroutine
	</ul>		</ul>

	[[Category:User Language statements]]		[[Category:User Language statements]]

JAL at 22:24, 17 February 2011

2011-02-17T22:24:28Z

← Older revision		Revision as of 22:24, 17 February 2011
Line 32:		Line 32:
	The default value for ULTRACEP is 2.		The default value for ULTRACEP is 2.

	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 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"> D[ISPLAY] T[RACE][.{* \| N}]
Line 40:		Line 40:
	and specifying <code>D T.20</code> will display the last 20.		and specifying <code>D T.20</code> will display the last 20.

	The wrap-around trace table can also be examined with the [[$Trace2List]]		The wrap-around trace table can also be examined with the <var>[[$Trace2List]]</var>
	function.		function.

JAL: /* See also */

2011-02-17T22:18:57Z

Dme: /* Usage */

2011-02-17T21:19:59Z

Usage

← Older revision		Revision as of 21:19, 17 February 2011
Line 5:		Line 5:
	The ULTRACE parameter is a standard bit-oriented user parameter where the		The ULTRACE parameter is a standard bit-oriented user parameter where the
	bits mean:		bits mean:
	<dl>		<table>
	<dt>X'01'		<tr><th>X'01'
	<dd>Send <var>Trace</var> output to terminal.		</th><td>Send <var>Trace</var> output to terminal.
	<dt>X'02'		</td></tr>
	<dd>Send <var>Trace</var> output to audit trail.		<tr><th>X'02'
	<dt>X'04'		</th><td>Send <var>Trace</var> output to audit trail.
	<dd>Send <var>Trace</var> output to a CCATEMP wrap-around trace table.		</td></tr>
	</dl>		<tr><th>X'04'
			</th><td>Send <var>Trace</var> output to a CCATEMP wrap-around trace table.
			</td></tr></table>
	The default setting for ULTRACE is X'01' which means that the <var>Trace</var> statement		The default setting for ULTRACE is X'01' which means that the <var>Trace</var> statement
	will act pretty much like a <var>Print</var> statement.		will act pretty much like a <var>Print</var> statement.
Line 42:		Line 44:

	ULTRACE and ULTRACEP can both be RESET via the $RESETN function.		ULTRACE and ULTRACEP can both be RESET via the $RESETN function.

	==See also==		==See also==
	The trace destination setting (as specified by the ULTRACE parameter) also controls:		The trace destination setting (as specified by the ULTRACE parameter) also controls:

Dme at 20:26, 17 February 2011

2011-02-17T20:26:04Z

← Older revision		Revision as of 20:26, 17 February 2011
Line 1:		Line 1:
			==Usage==
	The <var>Trace</var> statement acts very much like		The <var>Trace</var> statement acts very much like
	a <var>Print</var> or <var>Audit</var> statement with the exception that the target for the <var>Trace</var>		a <var>Print</var> or <var>Audit</var> statement with the exception that the target for the <var>Trace</var>
Line 37:		Line 38:
	and specifying <code>D T.20</code> will display the last 20.		and specifying <code>D T.20</code> will display the last 20.

	The wrap-around trace table can also be examined with the ~~$TRACE2LIST~~		The wrap-around trace table can also be examined with the [[$Trace2List]]
	~~function (~~[[??]] ~~refid=tr2lst.)~~.		function.

	ULTRACE and ULTRACEP can both be RESET via the $RESETN function.		ULTRACE and ULTRACEP can both be RESET via the $RESETN function.
			==See also==
			The trace destination setting (as specified by the ULTRACE parameter) also controls:
			<ul>
			<li>the [[Text and Html statements]] with the <var>Trace</var> option
			<li>the [[TraceText statement]]
			<li>methods in several classes, for example the <var>XmlDoc</var> <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var> subroutine and the <var>Arraylist</var> <var>[[Trace (Arraylist subroutine)\|Trace]]</var> subroutine
			</ul>
	[[Category:User Language statements]]		[[Category:User Language statements]]

Dme at 19:59, 17 February 2011

2011-02-17T19:59:07Z

← Older revision		Revision as of 19:59, 17 February 2011
Line 1:		Line 1:
	~~TRACE Statement~~		The <var>Trace</var> statement acts very much like
	The ~~TRACE~~ statement acts very much like a ~~PRINT~~ or ~~AUDIT~~ statement with the		a <var>Print</var> or <var>Audit</var> statement with the exception that the target for the <var>Trace</var>
	exception that the target for the ~~TRACE~~ statement can be dynamically changed by		statement can be dynamically changed by RESET'ing the [[ULTRACE parameter]].
	RESET'ing the ULTRACE parameter. The ULTRACE parameter is a standard ~~bitoriented~~		The ULTRACE parameter is a standard bit-oriented user parameter where the
	user parameter where the bits mean:		bits mean:
	X'01' Send ~~TRACE~~ output to terminal.		<dl>
	X'02' Send ~~TRACE~~ output to audit trail.		<dt>X'01'
	X'04' Send ~~TRACE~~ output to a CCATEMP wrap-around trace table.		<dd>Send <var>Trace</var> output to terminal.
	The default setting for ULTRACE is X'01' which means that the ~~TRACE~~ statement will		<dt>X'02'
	act pretty much like a ~~PRINT~~ statement. The bits can be combined so that output could		<dd>Send <var>Trace</var> output to audit trail.
	be sent to both the terminal and the audit trail or to the CCATEMP wrap-around trace		<dt>X'04'
	table and to the terminal and to the audit trail. If a ~~TRACE~~ statement is executed when		<dd>Send <var>Trace</var> output to a CCATEMP wrap-around trace table.
	ULTRACE is set to 0, the request is cancelled.		</dl>
	The CCATEMP wrap-around trace table is a user-specific trace table that consists of a		The default setting for ULTRACE is X'01' which means that the <var>Trace</var> statement
	set of CCATEMP pages up to a maximum specified by the ULTRACEP user parameter.		will act pretty much like a <var>Print</var> statement.
	If ULTRACEP pages are already in use when a ~~TRACE~~ statement is issued and output		The bits can be combined so that output could be sent to both the terminal
	is being routed to the trace table (ULTRACE X'04' set), the trace data on the oldest page		and the audit trail or to the CCATEMP wrap-around trace table and to the
	is discarded and the oldest page is re-used for the new trace data. The default value for		terminal and to the audit trail.
	ULTRACEP is 2.		If a <var>Trace</var> statement is executed when ULTRACE is set to 0, the request is
	The wrap-around trace table is dumped in SirFact dumps, and it can be viewed with the		cancelled.
	following command when using the FACT subsystem to examine a dump:
	D[ISPLAY] T[RACE][.{* \| N}]		The CCATEMP wrap-around trace table is a user-specific trace table that
	where N specifies that the last n entries are to be displayed. Specifying D T will display		consists of a set of CCATEMP pages up to a maximum specified by the
	all trace entries, and specifying D T.20 will display the last 20.		ULTRACEP user parameter.
	The wrap-around trace table can also be examined with the $TRACE2LIST function		If ULTRACEP pages are already in use when a <var>Trace</var> statement is issued
	(~~“$TRACE2LIST: Copy wrap-around trace table to $list” on page 52~~).		and output is being routed to the trace table (ULTRACE X'04' set), the
			trace data on the oldest page is discarded and the oldest page is re-used
			for the new trace data.
			The default value for ULTRACEP is 2.

			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:
			<p class="code"> D[ISPLAY] T[RACE][.{* \| N}]
			</p>
			where <code>N</code> specifies that the last ''n'' entries are to be displayed.
			Specifying <code>D T</code> will display all trace entries,
			and specifying <code>D T.20</code> will display the last 20.

			The wrap-around trace table can also be examined with the $TRACE2LIST
			function ([[??]] refid=tr2lst.).

	ULTRACE and ULTRACEP can both be RESET via the $RESETN function.		ULTRACE and ULTRACEP can both be RESET via the $RESETN function.

	[[Category:User Language statements]]		[[Category:User Language statements]]

← Older revision		Revision as of 22:18, 17 February 2011
Line 48:		Line 48:
	The trace destination setting (as specified by the ULTRACE parameter) also controls:		The trace destination setting (as specified by the ULTRACE parameter) also controls:
	<ul>		<ul>
	<li>~~the~~ [[Text and Html statements]] with the <var>Trace</var> option		<li>[[Text and Html statements]] with the <var>Trace</var> option
	<li>~~the~~ [[TraceText statement]]		<li>The <var>[[TraceText statement\|TraceText]]</var> statement
	<li>methods in several classes, for example the <var>XmlDoc</var> <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var> subroutine and the <var>Arraylist</var> <var>[[Trace (Arraylist subroutine)\|Trace]]</var> subroutine		<li>Trace methods in several classes, for example the <var>XmlDoc</var> <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var> subroutine and the <var>Arraylist</var> <var>[[Trace (Arraylist subroutine)\|Trace]]</var> subroutine
	</ul>		</ul>
	[[Category:User Language statements]]		[[Category:User Language statements]]