CallStack (System function) - Revision history

JAL: /* Usage Notes */

2014-07-02T19:45:08Z

Usage Notes

← Older revision		Revision as of 19:45, 2 July 2014
Line 13:		Line 13:
	<ul>		<ul>
	<li><var>CallStack</var> returns the name of the procedure and the line within the procedure that made the calls of the current method or subroutine. Generally, each returned <var>Stringlist</var> item has the name of the file containing the calling procedure at positions one through eight, followed by a blank, followed by the name of the calling procedure, followed by a blank, followed by the line number within the calling procedure.		<li><var>CallStack</var> returns the name of the procedure and the line within the procedure that made the calls of the current method or subroutine. Generally, each returned <var>Stringlist</var> item has the name of the file containing the calling procedure at positions one through eight, followed by a blank, followed by the name of the calling procedure, followed by a blank, followed by the line number within the calling procedure.
	<p><b>Note:</b> The call stack information returned by <var>CallStack</var> refers to the (names of and line numbers in) procedures that contain the calls to the current method or subroutine, ''not'' to (names of and line numbers in) the current subroutine or method.</p>		<p class="note"><b>Note:</b> The call stack information returned by <var>CallStack</var> refers to the (names of and line numbers in) procedures that contain the calls to the current method or subroutine, ''not'' to (names of and line numbers in) the current subroutine or method.</p></li>

	<li>For method or subroutine calls that were entered at command level (not inside a procedure), the <var class="term">%sl</var> item will contain a single asterisk character (<tt>*</tt>).		<li>For method or subroutine calls that were entered at command level (not inside a procedure), the <var class="term">%sl</var> item will contain a single asterisk character (<tt>*</tt>).
	If <var>CallStack</var> cannot determine the location of the call, the <var class="term">%sl</var> item associated with a call will be null (zero-length). If not issued from within a method or subroutine, <var>CallStack</var> will return an empty (zero-item) Stringlist.		If <var>CallStack</var> cannot determine the location of the call, the <var class="term">%sl</var> item associated with a call will be null (zero-length). If not issued from within a method or subroutine, <var>CallStack</var> will return an empty (zero-item) Stringlist.</li>

	<li>For <var>CallStack</var> to determine the location of a method or subroutine call, source line information must be collected at compile time. Either you must set the <var>[[SIRFACT_parameter\|SIRFACT]]</var> system parameter's X'01' bit, or the request must be compiled with the <var class="product">Model 204</var> <var>DEBUGUL</var> user parameter set to a non-zero value.		<li>For <var>CallStack</var> to determine the location of a method or subroutine call, source line information must be collected at compile time. Either you must set the <var>[[SIRFACT_parameter\|SIRFACT]]</var> system parameter's X'01' bit, or the request must be compiled with the <var class="product">Model 204</var> <var>DEBUGUL</var> user parameter set to a non-zero value.
	<p>To use the <var>SIRFACT</var> system parameter, your site must be authorized for <var class="product">[[SirFact]]</var>. Using the <var>DEBUGUL</var> user parameter increases the <var>QTBL</var> and (to a lesser degree) <var>VTBL</var> requirements for a compiled request.</p>		<p>
			To use the <var>SIRFACT</var> system parameter, your site must be authorized for <var class="product">[[SirFact]]</var>. Using the <var>DEBUGUL</var> user parameter increases the <var>QTBL</var> and (to a lesser degree) <var>VTBL</var> requirements for a compiled request.</p></li>

	<li>The <var>CallStack</var> method is intended to be used for problem diagnosis and, perhaps, for logging and auditing. Using it to affect method or subroutine behavior by causing a method or subroutine to behave differently depending on its caller is <b><i>extremely</i></b> poor technique, and it cannot be discouraged strongly enough.		<li>The <var>CallStack</var> method is intended to be used for problem diagnosis and, perhaps, for logging and auditing. Using it to affect method or subroutine behavior by causing a method or subroutine to behave differently depending on its caller is <b><i>extremely</i></b> poor technique, and it cannot be discouraged strongly enough. </li>

	<li>~~The <var>CallStack</var> method is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.2 and later.~~
	</ul>		</ul>

JALWiccan: Automatically generated page update

2014-02-16T00:19:26Z

Automatically generated page update

← Older revision		Revision as of 00:19, 16 February 2014
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%sl</th><td>A <var>Stringlist</var> object to be set to reference the object that contains information about the current call stack. The first item in the <var>Stringlist</var> refers to the immediate caller of the current method or subroutine; a second item refers to the caller of that caller, if any; and so on.</td></tr>		<tr><th>%sl</th><td>A <var>Stringlist</var> object to be set to reference the object that contains information about the current call stack. The first item in the <var>Stringlist</var> refers to the immediate caller of the current method or subroutine; a second item refers to the caller of that caller, if any; and so on.</td></tr>
	<tr><th><var>%(System)</var></th><td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods\|shared]] method.</td></tr>		<tr><th><var class="nobr">%(System)</var></th><td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods\|shared]] method.</td></tr>
	</table>		</table>

Dme: Undo revision 67388 by Dme (talk)

2014-02-09T14:15:54Z

Undo revision 67388 by Dme (talk)

← Older revision		Revision as of 14:15, 9 February 2014
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%sl</th><td>A <var>Stringlist</var> object to be set to reference the object that contains information about the current call stack. The first item in the <var>Stringlist</var> refers to the immediate caller of the current method or subroutine; a second item refers to the caller of that caller, if any; and so on.</td></tr>		<tr><th>%sl</th><td>A <var>Stringlist</var> object to be set to reference the object that contains information about the current call stack. The first item in the <var>Stringlist</var> refers to the immediate caller of the current method or subroutine; a second item refers to the caller of that caller, if any; and so on.</td></tr>
	<tr><th><var ~~style="white-space:pre"~~>%(System)</var></th><td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods\|shared]] method.</td></tr>		<tr><th><var>%(System)</var></th><td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods\|shared]] method.</td></tr>
	</table>		</table>

Dme: /* Syntax terms */

2014-02-09T14:15:01Z

Syntax terms

← Older revision		Revision as of 14:15, 9 February 2014
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%sl</th><td>A <var>Stringlist</var> object to be set to reference the object that contains information about the current call stack. The first item in the <var>Stringlist</var> refers to the immediate caller of the current method or subroutine; a second item refers to the caller of that caller, if any; and so on.</td></tr>		<tr><th>%sl</th><td>A <var>Stringlist</var> object to be set to reference the object that contains information about the current call stack. The first item in the <var>Stringlist</var> refers to the immediate caller of the current method or subroutine; a second item refers to the caller of that caller, if any; and so on.</td></tr>
	<tr><th><var>%(System)</var></th><td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods\|shared]] method.</td></tr>		<tr><th><var style="white-space:pre">%(System)</var></th><td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods\|shared]] method.</td></tr>
	</table>		</table>

JAL: /* Usage Notes */

2014-02-08T21:04:57Z

Usage Notes

← Older revision		Revision as of 21:04, 8 February 2014
Line 23:		Line 23:
	<li>The <var>CallStack</var> method is intended to be used for problem diagnosis and, perhaps, for logging and auditing. Using it to affect method or subroutine behavior by causing a method or subroutine to behave differently depending on its caller is <b><i>extremely</i></b> poor technique, and it cannot be discouraged strongly enough.		<li>The <var>CallStack</var> method is intended to be used for problem diagnosis and, perhaps, for logging and auditing. Using it to affect method or subroutine behavior by causing a method or subroutine to behave differently depending on its caller is <b><i>extremely</i></b> poor technique, and it cannot be discouraged strongly enough.

	<li><var>CallStack</var> method is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.2 and later.		<li>The <var>CallStack</var> method is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.2 and later.
	</ul>		</ul>

JAL: /* Usage Notes */

2014-02-08T21:04:00Z

Usage Notes

← Older revision		Revision as of 21:04, 8 February 2014
Line 13:		Line 13:
	<ul>		<ul>
	<li><var>CallStack</var> returns the name of the procedure and the line within the procedure that made the calls of the current method or subroutine. Generally, each returned <var>Stringlist</var> item has the name of the file containing the calling procedure at positions one through eight, followed by a blank, followed by the name of the calling procedure, followed by a blank, followed by the line number within the calling procedure.		<li><var>CallStack</var> returns the name of the procedure and the line within the procedure that made the calls of the current method or subroutine. Generally, each returned <var>Stringlist</var> item has the name of the file containing the calling procedure at positions one through eight, followed by a blank, followed by the name of the calling procedure, followed by a blank, followed by the line number within the calling procedure.
	<p><b>Note:</b>The call stack information returned by <var>CallStack</var> refers to the (names of and line numbers in) procedures that contain the calls to the current method or subroutine, ''not'' to (names of and line numbers in) the current subroutine or method.</p>		<p><b>Note:</b> The call stack information returned by <var>CallStack</var> refers to the (names of and line numbers in) procedures that contain the calls to the current method or subroutine, ''not'' to (names of and line numbers in) the current subroutine or method.</p>

	<li>For method or subroutine calls that were entered at command level (not inside a procedure), the <var class="term">%sl</var> item will contain a single asterisk character (<tt>*</tt>).		<li>For method or subroutine calls that were entered at command level (not inside a procedure), the <var class="term">%sl</var> item will contain a single asterisk character (<tt>*</tt>).

JAL: /* Usage Notes */

2012-11-16T17:45:57Z

Usage Notes

← Older revision		Revision as of 17:45, 16 November 2012
Line 14:		Line 14:
	<li><var>CallStack</var> returns the name of the procedure and the line within the procedure that made the calls of the current method or subroutine. Generally, each returned <var>Stringlist</var> item has the name of the file containing the calling procedure at positions one through eight, followed by a blank, followed by the name of the calling procedure, followed by a blank, followed by the line number within the calling procedure.		<li><var>CallStack</var> returns the name of the procedure and the line within the procedure that made the calls of the current method or subroutine. Generally, each returned <var>Stringlist</var> item has the name of the file containing the calling procedure at positions one through eight, followed by a blank, followed by the name of the calling procedure, followed by a blank, followed by the line number within the calling procedure.
	<p><b>Note:</b>The call stack information returned by <var>CallStack</var> refers to the (names of and line numbers in) procedures that contain the calls to the current method or subroutine, ''not'' to (names of and line numbers in) the current subroutine or method.</p>		<p><b>Note:</b>The call stack information returned by <var>CallStack</var> refers to the (names of and line numbers in) procedures that contain the calls to the current method or subroutine, ''not'' to (names of and line numbers in) the current subroutine or method.</p>
	<li>For method or subroutine calls that were entered at command level (not inside a procedure), the <var class="term">%sl</var> item will contain a single asterisk character (<~~code~~>*</~~code~~>).
			<li>For method or subroutine calls that were entered at command level (not inside a procedure), the <var class="term">%sl</var> item will contain a single asterisk character (<tt>*</tt>).
	If <var>CallStack</var> cannot determine the location of the call, the <var class="term">%sl</var> item associated with a call will be null (zero-length). If not issued from within a method or subroutine, <var>CallStack</var> will return an empty (zero-item) Stringlist.		If <var>CallStack</var> cannot determine the location of the call, the <var class="term">%sl</var> item associated with a call will be null (zero-length). If not issued from within a method or subroutine, <var>CallStack</var> will return an empty (zero-item) Stringlist.

	<li>For <var>CallStack</var> to determine the location of a method or subroutine call, source line information must be collected at compile time. Either you must set the <var>[[SIRFACT_parameter\|SIRFACT]]</var> system parameter's X'01' bit, or the request must be compiled with the <var class="product">Model 204</var> <var>DEBUGUL</var> user parameter set to a non-zero value.		<li>For <var>CallStack</var> to determine the location of a method or subroutine call, source line information must be collected at compile time. Either you must set the <var>[[SIRFACT_parameter\|SIRFACT]]</var> system parameter's X'01' bit, or the request must be compiled with the <var class="product">Model 204</var> <var>DEBUGUL</var> user parameter set to a non-zero value.
	<p>To use the <var>SIRFACT</var> system parameter, your site must be authorized for <var class="product">[[SirFact]]</var>. Using the <var>DEBUGUL</var> user parameter increases the <var>QTBL</var> and (to a lesser degree) <var>VTBL</var> requirements for a compiled request.</p>		<p>To use the <var>SIRFACT</var> system parameter, your site must be authorized for <var class="product">[[SirFact]]</var>. Using the <var>DEBUGUL</var> user parameter increases the <var>QTBL</var> and (to a lesser degree) <var>VTBL</var> requirements for a compiled request.</p>

	<li>The <var>CallStack</var> method is intended to be used for problem diagnosis and, perhaps, for logging and auditing. Using it to affect method or subroutine behavior by causing a method or subroutine to behave differently depending on its caller is <b><i>extremely</i></b> poor technique, and it cannot be discouraged strongly enough.		<li>The <var>CallStack</var> method is intended to be used for problem diagnosis and, perhaps, for logging and auditing. Using it to affect method or subroutine behavior by causing a method or subroutine to behave differently depending on its caller is <b><i>extremely</i></b> poor technique, and it cannot be discouraged strongly enough.

	<li><var>CallStack</var> method is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.2 and later.		<li><var>CallStack</var> method is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.2 and later.
	</ul>		</ul>

JAL: /* Examples */

2012-11-16T17:45:03Z

Examples

← Older revision		Revision as of 17:45, 16 November 2012
Line 23:		Line 23:

	==Examples==		==Examples==
	~~<ol><li>~~In the MYTAX.UL procedure, the computeTax1 subroutine is called by the computeTax2 subroutine at line 146. If you issue the following statements from within computeTax1:		In the MYTAX.UL procedure, the computeTax1 subroutine is called by the computeTax2 subroutine at line 146. If you issue the following statements from within computeTax1:
	<p class="code">%callList is object stringlist		<p class="code">%callList is object stringlist
	%callList = %(system):callStack		%callList = %(system):callStack
Line 31:		Line 31:
	<p class="output">MYPROC MYTAX.UL 193		<p class="output">MYPROC MYTAX.UL 193
	MYPROC MYTAX.UL 146		MYPROC MYTAX.UL 146
	</p~~></ol~~>		</p>

	==See Also==		==See Also==
	{{Template:System:CallStack footer}}		{{Template:System:CallStack footer}}

JALWiccan: 1 revision

2011-11-30T18:28:17Z

1 revision

← Older revision	Revision as of 18:28, 30 November 2011
(No difference)

JALWiccan: 1 revision

2011-11-30T18:28:16Z

1 revision

← Older revision		Revision as of 18:28, 30 November 2011
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%sl</th><td>A <var>Stringlist</var> object to be set to reference the object that contains information about the current call stack. The first item in the <var>Stringlist</var> refers to the immediate caller of the current method or subroutine; a second item refers to the caller of that caller, if any; and so on.</td></tr>		<tr><th>%sl</th><td>A <var>Stringlist</var> object to be set to reference the object that contains information about the current call stack. The first item in the <var>Stringlist</var> refers to the immediate caller of the current method or subroutine; a second item refers to the caller of that caller, if any; and so on.</td></tr>
	<tr><th><var>%(System)</var></th><td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods ~~and constructors~~\|shared]] method.</td></tr>		<tr><th><var>%(System)</var></th><td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods\|shared]] method.</td></tr>
	</table>		</table>