$FreeOpt - Revision history

JALWiccan: Automatically generated page update

2018-09-20T22:51:27Z

Automatically generated page update

← Older revision		Revision as of 22:51, 20 September 2018
Line 2:		Line 2:
	<span class="pageSubtitle">Free optional file or group from subsystem</span>		<span class="pageSubtitle">Free optional file or group from subsystem</span>

	<p class="warn"><b>Note: </b>~~Most Sirius~~ $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $FreeOpt function.</p>		<p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $FreeOpt function.</p>

	The $FreeOpt function allows a user to free an optional file or group from a subsystem. It is intended as a workaround to the problem that once an optional file or group is opened in a subsystem, the subsystem holds an enqueue on the file until either the subsystem or the file is STOP'ped.		The $FreeOpt function allows a user to free an optional file or group from a subsystem. It is intended as a workaround to the problem that once an optional file or group is opened in a subsystem, the subsystem holds an enqueue on the file until either the subsystem or the file is STOP'ped.

JALWiccan: Automatically generated page update

2013-07-18T20:36:15Z

Automatically generated page update

← Older revision		Revision as of 20:36, 18 July 2013
Line 2:		Line 2:
	<span class="pageSubtitle">Free optional file or group from subsystem</span>		<span class="pageSubtitle">Free optional file or group from subsystem</span>

	<p class="~~warning~~">Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $FreeOpt function.</p>		<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $FreeOpt function.</p>

	The $FreeOpt function allows a user to free an optional file or group from a subsystem. It is intended as a workaround to the problem that once an optional file or group is opened in a subsystem, the subsystem holds an enqueue on the file until either the subsystem or the file is STOP'ped.		The $FreeOpt function allows a user to free an optional file or group from a subsystem. It is intended as a workaround to the problem that once an optional file or group is opened in a subsystem, the subsystem holds an enqueue on the file until either the subsystem or the file is STOP'ped.

JAL: /* Syntax */

2013-04-10T22:25:07Z

Syntax

← Older revision		Revision as of 22:25, 10 April 2013
Line 15:		Line 15:
	Note that the last example is not fully qualified so $FreeOpt will first look for a temp group and then a perm group if passed this string. Note also that $FreeOpt will not free a temporary group.		Note that the last example is not fully qualified so $FreeOpt will first look for a temp group and then a perm group if passed this string. Note also that $FreeOpt will not free a temporary group.
	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%result</span> = <span class="literal">$FreeOpt</span>(<span class="term">fgname)		<p class="syntax"><span class="term">%result</span> = <span class="literal">$FreeOpt</span>(<span class="term">fgname</span>)
	</p>		</p>

	<p>		<p>
	</p>		<var class="term">%result</var> is set to indicate the success of the function.</p>
	<p>~~%result~~ is set to indicate the success of the function.</p>
	<p class="code">		<p class="code">
	0 - File/group freed		0 - File/group freed
Line 38:		Line 38:
	<var>$FreeOpt</var> is mainly intended to be used with procedure files or groups. Any saved compiled requests that reference a file will prevent $FreeOpt from freeing that file. In addition, because of the difficulties in determining whether any compiled request references a group, $FreeOpt will not free any group that might have saved requests compiled against it. This is determined by testing the group's privilege bits in each subsystem SCLASS for bits that would allow compiled request access (such as FIND statements, STORE RECORD statements, etc..). The X'2DC6' bit must be off in all SCLASSes for $FreeOpt to be able to free a group.		<var>$FreeOpt</var> is mainly intended to be used with procedure files or groups. Any saved compiled requests that reference a file will prevent $FreeOpt from freeing that file. In addition, because of the difficulties in determining whether any compiled request references a group, $FreeOpt will not free any group that might have saved requests compiled against it. This is determined by testing the group's privilege bits in each subsystem SCLASS for bits that would allow compiled request access (such as FIND statements, STORE RECORD statements, etc..). The X'2DC6' bit must be off in all SCLASSes for $FreeOpt to be able to free a group.

			==Example==
	The following program frees optional file <tt>BURNS</tt> from a subsystem:		The following program frees optional file <tt>BURNS</tt> from a subsystem:
	<p class="code"> B		<p class="code"> B

JALWiccan: Automatically generated page update

2013-04-10T21:52:13Z

Automatically generated page update

← Older revision		Revision as of 21:52, 10 April 2013
Line 15:		Line 15:
	Note that the last example is not fully qualified so $FreeOpt will first look for a temp group and then a perm group if passed this string. Note also that $FreeOpt will not free a temporary group.		Note that the last example is not fully qualified so $FreeOpt will first look for a temp group and then a perm group if passed this string. Note also that $FreeOpt will not free a temporary group.
	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%result</span> = $FreeOpt(fgname)		<p class="syntax"><span class="term">%result</span> = <span class="literal">$FreeOpt</span>(<span class="term">fgname)
	</p>		</p>
	<p>		<p>

JALWiccan: Automatically generated page update

2013-04-10T21:28:32Z

Automatically generated page update

← Older revision		Revision as of 21:28, 10 April 2013
Line 15:		Line 15:
	Note that the last example is not fully qualified so $FreeOpt will first look for a temp group and then a perm group if passed this string. Note also that $FreeOpt will not free a temporary group.		Note that the last example is not fully qualified so $FreeOpt will first look for a temp group and then a perm group if passed this string. Note also that $FreeOpt will not free a temporary group.
	==Syntax==		==Syntax==
	<p class="syntax">%result = $FreeOpt(fgname)		<p class="syntax"><span class="term">%result</span> = $FreeOpt(fgname)
	</p>		</p>
	<p>		<p>

JALWiccan: Automatically generated page update

2013-04-10T18:16:51Z

Automatically generated page update

← Older revision		Revision as of 18:16, 10 April 2013
Line 15:		Line 15:
	Note that the last example is not fully qualified so $FreeOpt will first look for a temp group and then a perm group if passed this string. Note also that $FreeOpt will not free a temporary group.		Note that the last example is not fully qualified so $FreeOpt will first look for a temp group and then a perm group if passed this string. Note also that $FreeOpt will not free a temporary group.
	==Syntax==		==Syntax==
	<p class="syntax"~~><section begin="syntax" /~~>%result = $FreeOpt(fgname)		<p class="syntax">%result = $FreeOpt(fgname)
	~~<section end="syntax" />~~</p>		</p>
	<p>		<p>
	</p>		</p>

JALWiccan: 1 revision

2012-10-29T18:57:26Z

1 revision

← Older revision	Revision as of 18:57, 29 October 2012
(No difference)

JALWiccan: 1 revision

2012-10-29T18:57:24Z

1 revision

← Older revision		Revision as of 18:57, 29 October 2012
Line 6:		Line 6:
	The $FreeOpt function allows a user to free an optional file or group from a subsystem. It is intended as a workaround to the problem that once an optional file or group is opened in a subsystem, the subsystem holds an enqueue on the file until either the subsystem or the file is STOP'ped.		The $FreeOpt function allows a user to free an optional file or group from a subsystem. It is intended as a workaround to the problem that once an optional file or group is opened in a subsystem, the subsystem holds an enqueue on the file until either the subsystem or the file is STOP'ped.

	<var>$FreeOpt</var> accepts one argument and returns a numeric code. It is also callable .		<var>$FreeOpt</var> accepts one argument and returns a numeric code. It is also [[Calling Sirius Mods $functions\|callable]].

	The only argument is the name of the file or group to be freed. This name can be either an unqualified name, in which case the standard 204 search order (TEMP GROUP, PERM GROUP, FILE) will be used to try to identify the file or group; or it can be a qualified name that explicitly indicates whether $FreeOpt is to act on a file or group. Some examples of qualified names are		The only argument is the name of the file or group to be freed. This name can be either an unqualified name, in which case the standard 204 search order (TEMP GROUP, PERM GROUP, FILE) will be used to try to identify the file or group; or it can be a qualified name that explicitly indicates whether $FreeOpt is to act on a file or group. Some examples of qualified names are

JALWiccan: 1 revision

2012-10-26T00:37:20Z

1 revision

← Older revision	Revision as of 00:37, 26 October 2012
(No difference)

JALWiccan: 1 revision

2012-10-26T00:37:14Z

1 revision

← Older revision		Revision as of 00:37, 26 October 2012
Line 19:		Line 19:
	<p>		<p>
	</p>		</p>
	<p ~~class="caption"~~>%result is set to indicate the success of the function.</p>		<p>%result is set to indicate the success of the function.</p>
	<p class="code">		<p class="code">
	0 - File/group freed		0 - File/group freed