Trace - Revision history

Barb at 17:25, 14 April 2015

2015-04-14T17:25:00Z

← Older revision		Revision as of 17:25, 14 April 2015
Line 34:		Line 34:
	Trace Partition on/off		Trace Partition on/off
	Controls whether the partition name is displayed on the trace line. This is off by default.		Controls whether the partition name is displayed on the trace line. This is off by default.
		+
		+	Trace Gosubs on/off
		+	Turns on/off tracing inside of subroutines. This is on by default.

	Trace Print string-expression		Trace Print string-expression
Line 40:		Line 43:
	Trace File filename DIR=dirname		Trace File filename DIR=dirname
	Sends trace output to the specified text file.		Sends trace output to the specified text file.
		+
		+	Trace Pause
		+	This will cause trace to pause as if the user clicked on the trace window “pause” button. It will also display a message to let the user know it has paused. Clicking “Next” or “Resume” will continue program execution as expected.

	\|-valign="top"		\|-valign="top"

Barb at 18:57, 31 March 2015

2015-03-31T18:57:11Z

← Older revision		Revision as of 18:57, 31 March 2015
Line 37:		Line 37:
	Trace Print string-expression		Trace Print string-expression
	Displays the string expression in the trace window.		Displays the string expression in the trace window.
		+
		+	Trace File filename DIR=dirname
		+	Sends trace output to the specified text file.

	\|-valign="top"		\|-valign="top"

Jim: added trace partition

2011-07-17T19:39:52Z

added trace partition

← Older revision		Revision as of 19:39, 17 July 2011
Line 31:		Line 31:
	Trace Exceptions on/off		Trace Exceptions on/off
	Each time an exception is encountered in the program, the exception is displayed.		Each time an exception is encountered in the program, the exception is displayed.
		+
		+	Trace Partition on/off
		+	Controls whether the partition name is displayed on the trace line. This is off by default.

	Trace Print string-expression		Trace Print string-expression

Jim: minor

2011-07-01T19:54:41Z

minor

← Older revision		Revision as of 19:54, 1 July 2011
Line 44:		Line 44:
	Tracing continues into entered programs.		Tracing continues into entered programs.

-	Trace information is compiled into the Comet32 object. Comet programs compiled under ~~comet16~~, or ~~comet32~~ programs compiled with builds earlier than 444 will not have that information and therefore it will not be displayed.	+	Trace information is compiled into the Comet32 object file. Comet programs compiled under Comet16, or Comet32 programs compiled with builds earlier than 444 will not have that information and therefore it will not be displayed.

	<!--		<!--

Jim: minor

2011-07-01T19:53:54Z

minor

← Older revision		Revision as of 19:53, 1 July 2011
Line 41:		Line 41:

	If the source file is not available in the same directory from which it was compiled, at execution time, the line number information will be displayed, but not the text of the source.		If the source file is not available in the same directory from which it was compiled, at execution time, the line number information will be displayed, but not the text of the source.
		+
		+	Tracing continues into entered programs.
		+
		+	Trace information is compiled into the Comet32 object. Comet programs compiled under comet16, or comet32 programs compiled with builds earlier than 444 will not have that information and therefore it will not be displayed.

	<!--		<!--

Jim: minor

2011-07-01T19:27:17Z

minor

← Older revision		Revision as of 19:27, 1 July 2011
Line 19:		Line 19:
	Trace Labels on/off		Trace Labels on/off
	Displays whenever a program label is hit during execution		Displays whenever a program label is hit during execution
		+
	Trace Source on/off		Trace Source on/off
	If the source files are available when executing the program, the source line is displayed.		If the source files are available when executing the program, the source line is displayed.
		+
	Trace Time on/off		Trace Time on/off
	A time stamp is displayed on each trace line. This is turned off by default.		A time stamp is displayed on each trace line. This is turned off by default.
		+
	Trace Events on/off		Trace Events on/off
	Each time an event is fired in the program, the event information is displayed.		Each time an event is fired in the program, the event information is displayed.
		+
	Trace Exceptions on/off		Trace Exceptions on/off
	Each time an exception is encountered in the program, the exception is displayed.		Each time an exception is encountered in the program, the exception is displayed.
		+
	Trace Print string-expression		Trace Print string-expression
	Displays the string expression in the trace window.		Displays the string expression in the trace window.
Line 33:		Line 38:
	\| '''Discussion:'''		\| '''Discussion:'''
	\|		\|
-	The trace window is a single window owned by Comet32. All trace output is displayed in this window from all programs actively tracing whether these are ~~background~~ or Foreground, ~~xap~~ or CometAnywhere. This can be useful to see interaction among programs, but can be disconcerting at times.	+	The trace window is a single window owned by Comet32. All trace output is displayed in this window from all programs actively tracing whether these are Background or Foreground, Xap or CometAnywhere. This can be useful to see interaction among programs, but can be disconcerting at times.

	If the source file is not available in the same directory from which it was compiled, at execution time, the line number information will be displayed, but not the text of the source.		If the source file is not available in the same directory from which it was compiled, at execution time, the line number information will be displayed, but not the text of the source.

Jim: minor

2011-07-01T19:22:59Z

minor

← Older revision		Revision as of 19:22, 1 July 2011
Line 16:		Line 16:
	Trace on		Trace on
	This is an executable statement than can be placed anywhere in your program. When Comet encounters this command it will pop up the trace window and tracing will continue until the program ends or the Trace off command is executed.		This is an executable statement than can be placed anywhere in your program. When Comet encounters this command it will pop up the trace window and tracing will continue until the program ends or the Trace off command is executed.
-	The following commands control the information displayed in the trace window. By default most of these items are enabled when tracing. In addition to these, whenever a Comet32 Proc is entered and whenever a comet32 ProcReturn is executed, this ~~info~~ is displayed.	+	The following commands control the information displayed in the trace window. By default most of these items are enabled when tracing. In addition to these, whenever a Comet32 Proc is entered and whenever a comet32 ProcReturn is executed, information about this is displayed.
	Trace Labels on/off		Trace Labels on/off
	Displays whenever a program label is hit during execution		Displays whenever a program label is hit during execution

Jim: minor

2011-07-01T19:20:42Z

minor

← Older revision		Revision as of 19:20, 1 July 2011
Line 33:		Line 33:
	\| '''Discussion:'''		\| '''Discussion:'''
	\|		\|
-	The trace window is a single window owned by Comet32. All trace output is displayed in this window from all programs actively tracing whether these are background or Foreground, xap or CometAnywhere. This can be useful to see interaction among programs, but can be disconcerting ~~if sometimes.~~	+	The trace window is a single window owned by Comet32. All trace output is displayed in this window from all programs actively tracing whether these are background or Foreground, xap or CometAnywhere. This can be useful to see interaction among programs, but can be disconcerting at times.
-		+
-	~~If the source file is not available in the same directory from which it was compiled,~~ at ~~execution time, the line number information will be displayed, but not the source~~.	+
-		+

		+	If the source file is not available in the same directory from which it was compiled, at execution time, the line number information will be displayed, but not the text of the source.

		+	<!--
	\|-valign="top"		\|-valign="top"
	\|'''Example:'''		\|'''Example:'''
Line 46:		Line 45:

	\|}		\|}
-		+	-->
	The Trace statement was introduced in Comet 2011 build 444. These commands are available in Comet32 only.		The Trace statement was introduced in Comet 2011 build 444. These commands are available in Comet32 only.

Jim: minor

2011-07-01T19:16:42Z

minor

← Older revision		Revision as of 19:16, 1 July 2011
Line 8:		Line 8:
	\|<b>Introduction:</b>		\|<b>Introduction:</b>
	\|		\|
-	The trace statements allow you to easily debug your IB programs whether they run in foreground or background. When Tracing, a "Trace window" pops up on the console of the Comet machine that displays much of what you would want to see to follow the progress of the program.	+	The trace statements allow you to easily debug your IB programs whether they run in foreground or background. When Tracing, a "Trace window" pops up on the console of the Comet machine that displays much of what you would want to see to follow the progress of the program. Trace statements are executable statements.
	\|-valign="top"		\|-valign="top"
	\| '''Syntax:'''		\| '''Syntax:'''
Line 16:		Line 16:
	Trace on		Trace on
	This is an executable statement than can be placed anywhere in your program. When Comet encounters this command it will pop up the trace window and tracing will continue until the program ends or the Trace off command is executed.		This is an executable statement than can be placed anywhere in your program. When Comet encounters this command it will pop up the trace window and tracing will continue until the program ends or the Trace off command is executed.
-	The following commands control the information displayed in the trace window. By default most of these items are enabled when tracing.	+	The following commands control the information displayed in the trace window. By default most of these items are enabled when tracing. In addition to these, whenever a Comet32 Proc is entered and whenever a comet32 ProcReturn is executed, this info is displayed.
	Trace Labels on/off		Trace Labels on/off
-	Displays whenever a program ~~lable~~ is hit during execution	+	Displays whenever a program label is hit during execution
	Trace Source on/off		Trace Source on/off
	If the source files are available when executing the program, the source line is displayed.		If the source files are available when executing the program, the source line is displayed.
Line 27:		Line 27:
	Trace Exceptions on/off		Trace Exceptions on/off
	Each time an exception is encountered in the program, the exception is displayed.		Each time an exception is encountered in the program, the exception is displayed.
-		+	Trace Print string-expression
		+	Displays the string expression in the trace window.

	\|-valign="top"		\|-valign="top"
	\| '''Discussion:'''		\| '''Discussion:'''
	\|		\|
		+	The trace window is a single window owned by Comet32. All trace output is displayed in this window from all programs actively tracing whether these are background or Foreground, xap or CometAnywhere. This can be useful to see interaction among programs, but can be disconcerting if sometimes.
		+
		+	If the source file is not available in the same directory from which it was compiled, at execution time, the line number information will be displayed, but not the source.
		+


	\|-valign="top"		\|-valign="top"
-	\|'''Example 2:'''	+	\|'''Example:'''
-	~~Reading a CSV record~~	+

	\|		\|

Jim: Initial Construction of page

2011-07-01T18:43:39Z

Initial Construction of page

New page

<h1>

Debugging your IB programs using the Trace Commands

</h1>
{| cellpadding=5 cellspacing=2
|-valign="top"
|<b>Introduction:</b>
|
The trace statements allow you to easily debug your IB programs whether they run in foreground or background. When Tracing, a "Trace window" pops up on the console of the Comet machine that displays much of what you would want to see to follow the progress of the program.
|-valign="top"
| '''Syntax:'''
|
<b>Trace on / Trace off</b>
There are several trace commands that control the detail of the information displayed in the trace window, but the only statement you need to use to see tracing is:
Trace on
This is an executable statement than can be placed anywhere in your program. When Comet encounters this command it will pop up the trace window and tracing will continue until the program ends or the Trace off command is executed.
The following commands control the information displayed in the trace window. By default most of these items are enabled when tracing.
Trace Labels on/off
Displays whenever a program lable is hit during execution
Trace Source on/off
If the source files are available when executing the program, the source line is displayed.
Trace Time on/off
A time stamp is displayed on each trace line. This is turned off by default.
Trace Events on/off
Each time an event is fired in the program, the event information is displayed.
Trace Exceptions on/off
Each time an exception is encountered in the program, the exception is displayed.

|-valign="top"
| '''Discussion:'''
|

|-valign="top"
|'''Example 2:'''
Reading a CSV record

|

|}

The Trace statement was introduced in Comet 2011 build 444. These commands are available in Comet32 only.