DEFCNTX and APDFCNTX parameters - Revision history

ELowell: /* See also */

2017-07-13T16:53:51Z

ELowell: /* See also */

2017-07-13T16:39:24Z

Dme: /* Description */

2017-07-13T13:11:22Z

Description

← Older revision		Revision as of 13:11, 13 July 2017
Line 41:		Line 41:
	<li><var>CURFILE</var> returns a null string if the default context is a group. </li>		<li><var>CURFILE</var> returns a null string if the default context is a group. </li>

	<li><var>CURFILE</var> is affected by the <var>IN</var> clause prior to a <var>~~BEGIN~~</var> command and can be affected by the <var>In</var> clause prior to many SOUL statements. <var>DEFCNTX</var> and <var>APDFCNTX</var> are not affected by (either form of) the <var>IN</var> clause. </li>		<li><var>CURFILE</var> is affected by the <var>IN</var> clause prior to a <var>Begin</var> command and can be affected by the <var>In</var> clause prior to many SOUL statements. <var>DEFCNTX</var> and <var>APDFCNTX</var> are not affected by (either form of) the <var>IN</var> clause. </li>
	</ul>		</ul>
	===Usage===		===Usage===

Dme at 12:48, 13 July 2017

2017-07-13T12:48:30Z

← Older revision		Revision as of 12:48, 13 July 2017
Line 18:		Line 18:

	==Description==		==Description==
	These parameters provide information about the default file or group context; that is, which file or group is used when a file-based operation is performed without the qualification provided by the <var>[[Basic SOUL statements and commands#IN clauses\|IN]] clause.		These parameters provide information about the default file or group context, that is, which file or group is used when a file-based operation is performed without the qualification provided by the <var>[[Basic SOUL statements and commands#IN clauses\|IN]] clause.

	<ul>		<ul>
	<li><var>DEFCNTX</var> ~~shows~~ the default context ~~when~~ the ~~request was compiled~~: <br />		<li><var>DEFCNTX</var> returns the current default context of the thread: <br />
	the most recent successful OPEN statement, OPEN command, or DEFAULT command~~, if the file or group is open~~.		the most recent successful OPEN statement, OPEN command, or DEFAULT command.
	<p>For a [[~~New (~~Daemon ~~constructor)~~\|~~daemon~~]] ~~object~~, ~~DEFCNTX returns~~ the initial value of ~~the file or group open on~~ the master thread if OpenAll is ~~True~~.</p>		<p>For a <var>[[Daemon class\|Daemon]]</var> thread, the initial value of <var>DEFCNTX</var> is copied from the master thread if <code>OpenAll=True</code> was specified on the [[New (Daemon constructor)\|New]] constructor, otherwise the initial value is the null string.</p>
	<p>The first word or two returned by <var>DEFCNTX</var> is the type of context: <code>FILE</code>, <code>TEMP GROUP</code>, or <code>PERM GROUP</code>. The last word returned by <var>DEFCNTX</var> is the name of the file or group.</p>		<p>The first word or two returned by <var>DEFCNTX</var> is the type of context: <code>FILE</code>, <code>TEMP GROUP</code>, or <code>PERM GROUP</code>. The last word returned by <var>DEFCNTX</var> is the name of the file or group.</p>
	If there is no default context, the value of <var>DEFCNTX</var> is the null string.		If there is no default context, the value of <var>DEFCNTX</var> is the null string.

ELowell: /* Description */

2017-07-13T00:00:44Z

Description

← Older revision		Revision as of 00:00, 13 July 2017
Line 20:		Line 20:
	These parameters provide information about the default file or group context; that is, which file or group is used when a file-based operation is performed without the qualification provided by the <var>[[Basic SOUL statements and commands#IN clauses\|IN]] clause.		These parameters provide information about the default file or group context; that is, which file or group is used when a file-based operation is performed without the qualification provided by the <var>[[Basic SOUL statements and commands#IN clauses\|IN]] clause.

	<var>DEFCNTX</var> shows the default context when the request was compiled.		<ul>
			<li><var>DEFCNTX</var> shows the default context when the request was compiled: <br />
			the most recent successful OPEN statement, OPEN command, or DEFAULT command, if the file or group is open.
			<p>For a [[New (Daemon constructor)\|daemon]] object, DEFCNTX returns the initial value of the file or group open on the master thread if OpenAll is True.</p>
			<p>The first word or two returned by <var>DEFCNTX</var> is the type of context: <code>FILE</code>, <code>TEMP GROUP</code>, or <code>PERM GROUP</code>. The last word returned by <var>DEFCNTX</var> is the name of the file or group.</p>
			If there is no default context, the value of <var>DEFCNTX</var> is the null string.
			</li>

			<li>
	<var>APDFCNTX</var> shows the default context when the Apsy command was issued.		<var>APDFCNTX</var> shows the default context when the Apsy command was issued.
	<p class="note"><b>Note:</b> If the default context when an Apsy command was issued is the same as one of the files or groups in the Apsy's definition, <var>APDFCNTX</var> returns the null string.		<p class="note"><b>Note:</b> If the default context when an Apsy command was issued is the same as one of the files or groups in the Apsy's definition, <var>APDFCNTX</var> returns the null string.
	</p>		</p>
			The first word or two returned by <var>APDFCNTX</var> is the type of context: <code>FILE</code>, <code>TEMP GROUP</code>, or <code>PERM GROUP</code>. The last word returned by <var>APDFCNTX</var> is the name of the file or group.
	~~If there is no default context, the value of the parameters is the null string.~~		<p>If there is no default context, the value of <var>APDFCNTX</var> is the null string.</p></li>
	~~<ul>~~
	~~<li>~~The first word or two returned by ~~<var>DEFCNTX</var> and~~ <var>APDFCNTX</var>
	is the type of context: <code>FILE</code>,
	<code>TEMP GROUP</code>, or <code>PERM GROUP</code>.~~</li>~~

	~~<li>~~The last word returned by <var>~~DEFCNTX~~</var> or <var>APDFCNTX</var>
	is the ~~name of the file or group~~.</li>
	</ul>		</ul>

ELowell: /* Description */

2017-07-12T23:24:24Z

Description

← Older revision		Revision as of 23:24, 12 July 2017
Line 18:		Line 18:

	==Description==		==Description==
	These parameters provide information about the default file or group context, that is, which file or group is used when a file-based operation is performed without the qualification provided by the <var>[[Basic SOUL statements and commands#IN clauses\|IN]] clause.		These parameters provide information about the default file or group context; that is, which file or group is used when a file-based operation is performed without the qualification provided by the <var>[[Basic SOUL statements and commands#IN clauses\|IN]] clause.

	~~They are very similar to~~ the <var>~~[[CURFILE parameter\|CURFILE]]~~</var> ~~parameter~~, ~~with these differences:~~		<var>DEFCNTX</var> shows the default context when the request was compiled.

			<var>APDFCNTX</var> shows the default context when the Apsy command was issued.
			<p class="note"><b>Note:</b> If the default context when an Apsy command was issued is the same as one of the files or groups in the Apsy's definition, <var>APDFCNTX</var> returns the null string.
			</p>

			If there is no default context, the value of the parameters is the null string.
	<ul>		<ul>
	~~<li><var>CURFILE</var> returns a null string if the default context is a group. </li>~~

	<li>The first word or two returned by <var>DEFCNTX</var> and <var>APDFCNTX</var>		<li>The first word or two returned by <var>DEFCNTX</var> and <var>APDFCNTX</var>
	is the type of context: <code>FILE</code>,		is the type of context: <code>FILE</code>,
	<code>TEMP GROUP</code>, or <code>PERM GROUP</code>. </li>		<code>TEMP GROUP</code>, or <code>PERM GROUP</code>.</li>

	<li>The last word returned by <var>DEFCNTX</var> or <var>APDFCNTX</var>		<li>The last word returned by <var>DEFCNTX</var> or <var>APDFCNTX</var>
	is the name of the file or group. </li>		is the name of the file or group.</li>
			</ul>

			<var>DEFCNTX</var> and <var>APDFCNTX</var> are very similar to the <var>[[CURFILE parameter\|CURFILE]]</var> parameter, with these differences:

			<ul>
			<li><var>CURFILE</var> returns a null string if the default context is a group. </li>

	<li><var>CURFILE</var> is affected by the <var>IN</var> clause prior to a <var>BEGIN</var> command and can be affected by the <var>In</var> clause prior to many SOUL statements. <var>DEFCNTX</var> and <var>APDFCNTX</var> are not affected by (either form of) the <var>IN</var> clause. </li>		<li><var>CURFILE</var> is affected by the <var>IN</var> clause prior to a <var>BEGIN</var> command and can be affected by the <var>In</var> clause prior to many SOUL statements. <var>DEFCNTX</var> and <var>APDFCNTX</var> are not affected by (either form of) the <var>IN</var> clause. </li>

	~~<li><var>DEFCNTX</var> provides information about the default context when the request was compiled. </li>~~

	~~<li><var>APDFCNTX</var> provides information not about the default context when the request was compiled, but the context when the Apsy command was issued.~~
	~~<p class="note"><b>Note:</b> If the default context when an Apsy command was issued is the~~
	~~same as one of the files or groups in the Apsy's definition, <var>APDFCNTX</var> returns the null string.~~
	~~</p> </li>~~
	</ul>		</ul>
			===Usage===
	~~If there is no default context, the value of the parameters is the null string.~~		In versions 7.4 and 7.5 of Model 204, <var>DEFCNTX</var> and <var>APDFCNTX</var> are only available using the <var>$View</var> function. For example:

	~~<blockquote class="note"><b>Notes:</b>~~ In versions 7.4 and 7.5 of Model 204, ~~these parameters~~ are only available using the <var>$View</var> function~~, for~~ example:
	<p class="code">print $view('DEFCNTX')</p>		<p class="code">print $view('DEFCNTX')</p>
	<ul>		<ul>
	<li>~~Prior to~~ version 7.6, they are ~~not~~ available with the <var>VIEW</var> command.</li>		<li>As of version 7.6, they are available with the <var>VIEW</var> command.</li>

	<li>In version 7.4, they were implemented as part of maintenance: Early Warning 740EW159.</li>		<li>In version 7.4, they were implemented as part of maintenance: Early Warning 740EW159.</li>
Line 53:		Line 53:
	<li>In version 7.5, they were implemented as part of maintenance: zap 75Z054.</li>		<li>In version 7.5, they were implemented as part of maintenance: zap 75Z054.</li>
	</ul>		</ul>
	~~</blockquote>~~

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

JAL: /* Description */ typo

2016-05-02T22:12:13Z

Description: typo

← Older revision		Revision as of 22:12, 2 May 2016
Line 44:		Line 44:
	If there is no default context, the value of the parameters is the null string.		If there is no default context, the value of the parameters is the null string.

	<blockquote class="note"><b>Notes:</b> In versions 7.4 and 7.5 of Model , these parameters are only available using the <var>$View</var> function, for example:		<blockquote class="note"><b>Notes:</b> In versions 7.4 and 7.5 of Model 204, these parameters are only available using the <var>$View</var> function, for example:
	<p class="code">print $view('DEFCNTX')</p>		<p class="code">print $view('DEFCNTX')</p>
	<ul>		<ul>
	<li>Prior to version 7.6, they are not available with the <var>VIEW</var> command.		<li>Prior to version 7.6, they are not available with the <var>VIEW</var> command.</li>
	<li>In version 7.4, they were implemented as part of maintenance: Early Warning 740EW159.
	<li>In version 7.5, they were implemented as part of maintenance: zap 75Z054.		<li>In version 7.4, they were implemented as part of maintenance: Early Warning 740EW159.</li>

			<li>In version 7.5, they were implemented as part of maintenance: zap 75Z054.</li>
	</ul>		</ul>
	</blockquote>		</blockquote>

JAL: link repair

2015-06-26T15:54:26Z

link repair

← Older revision		Revision as of 15:54, 26 June 2015
Line 57:		Line 57:
	<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter. </li>		<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter. </li>
	<li>The <var>[[$Curfile]]</var> function. </li>		<li>The <var>[[$Curfile]]</var> function. </li>
	<li>The <var>[[DEFAULT command\|DEFAULT]]</var> and <var>[[OPEN ~~file~~ command\|OPEN]]</var> commands, which reset the file/group context. </li>		<li>The <var>[[DEFAULT command\|DEFAULT]]</var> and <var>[[OPEN FILE command\|OPEN]]</var> commands, which reset the file/group context. </li>
	<li>The <var>[[OPENC command\|OPENC</var>]] command does <b>not</b> reset the file/group context. </li>		<li>The <var>[[OPENC command\|OPENC</var>]] command does <b>not</b> reset the file/group context. </li>
	<li>The <var>[[CLOSE command\|CLOSE</var>]] command, which might reset the file/group context. </li>		<li>The <var>[[CLOSE command\|CLOSE</var>]] command, which might reset the file/group context. </li>

JAL: link repair

2015-05-27T16:51:45Z

link repair

← Older revision		Revision as of 16:51, 27 May 2015
Line 18:		Line 18:

	==Description==		==Description==
	These parameters provide information about the default file or group context, that is, which file or group is used when a file-based operation is performed without the qualification provided by the <var>[[IN ~~clause~~\|IN]] clause.		These parameters provide information about the default file or group context, that is, which file or group is used when a file-based operation is performed without the qualification provided by the <var>[[Basic SOUL statements and commands#IN clauses\|IN]] clause.

	They are very similar to the <var>[[CURFILE parameter\|CURFILE]]</var> parameter, with these differences:		They are very similar to the <var>[[CURFILE parameter\|CURFILE]]</var> parameter, with these differences:

JAL: misc formatting

2015-05-13T21:28:25Z

misc formatting

← Older revision		Revision as of 21:28, 13 May 2015
Line 1:		Line 1:
	~~<var>DEFCNTX</var>~~ {{Template:DEFCNTX parameter subtitle}}		{{Template:DEFCNTX parameter subtitle}}
			<p><b>and</b> </p>
	<~~var~~>~~APDFCNTX~~</~~var~~> {{Template:APDFCNTX parameter subtitle}}		{{Template:APDFCNTX parameter subtitle}}

	==Summary==		==Summary==
Line 23:		Line 23:

	<ul>		<ul>
	<li><var>CURFILE</var> returns a null string if the default context is a group.		<li><var>CURFILE</var> returns a null string if the default context is a group. </li>

	<li>The first word or two returned by <var>DEFCNTX</var> and <var>APDFCNTX</var>		<li>The first word or two returned by <var>DEFCNTX</var> and <var>APDFCNTX</var>
	is the type of context: <code>FILE</code>,		is the type of context: <code>FILE</code>,
	<code>TEMP GROUP</code>, or <code>PERM GROUP</code>.		<code>TEMP GROUP</code>, or <code>PERM GROUP</code>. </li>
	<li>The last word returned by <var>DEFCNTX</var> ~~and~~ <var>APDFCNTX</var>
	is the name of the file or group.		<li>The last word returned by <var>DEFCNTX</var> or <var>APDFCNTX</var>
	<li><var>CURFILE</var> is affected by the <var>IN</var> clause prior to a <var>~~Begin~~</var> command and		is the name of the file or group. </li>
	can be affected by the <var>In</var> clause prior to many SOUL statements; <var>DEFCNTX</var> and
	<var>APDFCNTX</var> are not affected by (either form of) the <var>IN</var> clause.		<li><var>CURFILE</var> is affected by the <var>IN</var> clause prior to a <var>BEGIN</var> command and can be affected by the <var>In</var> clause prior to many SOUL statements. <var>DEFCNTX</var> and <var>APDFCNTX</var> are not affected by (either form of) the <var>IN</var> clause. </li>
	<li><var>DEFCNTX</var> provides information about the default context when the request was compiled.
	<li><var>APDFCNTX</var> provides information not about the default context when the request was compiled, but		<li><var>DEFCNTX</var> provides information about the default context when the request was compiled. </li>
	the context when the Apsy command was issued.
			<li><var>APDFCNTX</var> provides information not about the default context when the request was compiled, but the context when the Apsy command was issued.
	<p class="note"><b>Note:</b> If the default context when an Apsy command was issued is the		<p class="note"><b>Note:</b> If the default context when an Apsy command was issued is the
	same as one of the files or groups in the Apsy's definition, <var>APDFCNTX</var> returns the null string.		same as one of the files or groups in the Apsy's definition, <var>APDFCNTX</var> returns the null string.
	</p>		</p> </li>
	</ul>		</ul>

	If there is no default context, the value of the parameters is the null string.		If there is no default context, the value of the parameters is the null string.

	<blockquote class="note"><b>Notes:</b> In versions 7.4 and 7.5, these parameters are only available using the <var>$View</var> function, for example:		<blockquote class="note"><b>Notes:</b> In versions 7.4 and 7.5 of Model , these parameters are only available using the <var>$View</var> function, for example:
	<p class="code">print $view('DEFCNTX')</p>		<p class="code">print $view('DEFCNTX')</p>
	<ul>		<ul>
	<li>Prior to version 7.6, they are not available with the <var>VIEW</var> command.		<li>Prior to version 7.6, they are not available with the <var>VIEW</var> command.
	<li>In version 7.4, they were implemented as part of maintenance - Early Warning 740EW159.		<li>In version 7.4, they were implemented as part of maintenance: Early Warning 740EW159.
	<li>In version 7.5, they were implemented as part of maintenance - zap 75Z054.		<li>In version 7.5, they were implemented as part of maintenance: zap 75Z054.
	</ul>		</ul>
	</blockquote>		</blockquote>
Line 53:		Line 55:
	==See also==		==See also==
	<ul>		<ul>
	<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter.		<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter. </li>
	<li>The <var>[[$Curfile]]</var> function.		<li>The <var>[[$Curfile]]</var> function. </li>
	<li>The <var>[[DEFAULT command\|DEFAULT]]</var> and <var>[[OPEN file command\|OPEN]]</var> commands, which reset the file/group context.		<li>The <var>[[DEFAULT command\|DEFAULT]]</var> and <var>[[OPEN file command\|OPEN]]</var> commands, which reset the file/group context. </li>
	<li>The <var>[[OPENC command\|OPENC</var>]] command does <b>not</b> reset the file/group context.		<li>The <var>[[OPENC command\|OPENC</var>]] command does <b>not</b> reset the file/group context. </li>
	<li>The <var>[[CLOSE command\|CLOSE</var>]] command, which might reset the file/group context.		<li>The <var>[[CLOSE command\|CLOSE</var>]] command, which might reset the file/group context. </li>
	</ul>		</ul>

	[[Category:User parameters]]		[[Category:User parameters]]
	[[Category:Parameters]]		[[Category:Parameters]]

← Older revision		Revision as of 16:53, 13 July 2017
Line 58:		Line 58:
	<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter. </li>		<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter. </li>
	<li>The <var>[[$Curfile]]</var> function. </li>		<li>The <var>[[$Curfile]]</var> function. </li>
	<li>The <var>[[Files,_groups,_and_reference_context#openAndOpenC\|Open ~~and OpenC~~]]</var> ~~statements~~.		<li>The <var>[[Files,_groups,_and_reference_context#openAndOpenC\|Open]]</var> statement.
	<li>The <var>[[DEFAULT command\|~~DEFAULT~~]]</var> and <var>[[OPEN FILE command\|~~OPEN~~]]</var> commands, which reset the file/group context. </li>		<li>The <var>[[DEFAULT command\|Default]]</var> and <var>[[OPEN FILE command\|Open [File]]]</var> commands, which reset the file/group context. </li>
	<li>The <var>[[OPENC command\|~~OPENC~~</var>]] command does <b>not</b> reset the file/group context. </li>		<li>The <var>[[OPENC command\|OpenC</var>]] command does <b>not</b> reset the file/group context. </li>
	<li>The <var>[[CLOSE command\|~~CLOSE~~</var>]] command, which might reset the file/group context. </li>		<li>The <var>[[CLOSE command\|Close</var>]] command, which might reset the file/group context. </li>
	</ul>		</ul>

	[[Category:User parameters]]		[[Category:User parameters]]
	[[Category:Parameters]]		[[Category:Parameters]]

← Older revision		Revision as of 16:39, 13 July 2017
Line 58:		Line 58:
	<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter. </li>		<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter. </li>
	<li>The <var>[[$Curfile]]</var> function. </li>		<li>The <var>[[$Curfile]]</var> function. </li>
			<li>The <var>[[Files,_groups,_and_reference_context#openAndOpenC\|Open and OpenC]]</var> statements.
	<li>The <var>[[DEFAULT command\|DEFAULT]]</var> and <var>[[OPEN FILE command\|OPEN]]</var> commands, which reset the file/group context. </li>		<li>The <var>[[DEFAULT command\|DEFAULT]]</var> and <var>[[OPEN FILE command\|OPEN]]</var> commands, which reset the file/group context. </li>
	<li>The <var>[[OPENC command\|OPENC</var>]] command does <b>not</b> reset the file/group context. </li>		<li>The <var>[[OPENC command\|OPENC</var>]] command does <b>not</b> reset the file/group context. </li>

← Older revision		Revision as of 15:54, 26 June 2015
Line 57:		Line 57:
	<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter. </li>		<li>The <var>[[CURFILE parameter\|CURFILE]]</var> parameter. </li>
	<li>The <var>[[$Curfile]]</var> function. </li>		<li>The <var>[[$Curfile]]</var> function. </li>
	<li>The <var>[[DEFAULT command\|DEFAULT]]</var> and <var>[[OPEN ~~file~~ command\|OPEN]]</var> commands, which reset the file/group context. </li>		<li>The <var>[[DEFAULT command\|DEFAULT]]</var> and <var>[[OPEN FILE command\|OPEN]]</var> commands, which reset the file/group context. </li>
	<li>The <var>[[OPENC command\|OPENC</var>]] command does <b>not</b> reset the file/group context. </li>		<li>The <var>[[OPENC command\|OPENC</var>]] command does <b>not</b> reset the file/group context. </li>
	<li>The <var>[[CLOSE command\|CLOSE</var>]] command, which might reset the file/group context. </li>		<li>The <var>[[CLOSE command\|CLOSE</var>]] command, which might reset the file/group context. </li>