$Setg Subsys - Revision history

JALWiccan: Automatically generated page update

2018-09-20T22:52:17Z

Automatically generated page update

← Older revision		Revision as of 22:52, 20 September 2018
Line 2:		Line 2:
	<span class="pageSubtitle">Set subsystem-wide global</span>		<span class="pageSubtitle">Set subsystem-wide global</span>

	<p class="warn"><b>Note: </b>~~Most Sirius~~ $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Setg_Subsys function is the <var>[[SetGlobal (System subroutine)\|SetGlobal]]</var> subroutine.</p>		<p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Setg_Subsys function is the <var>[[SetGlobal (System subroutine)\|SetGlobal]]</var> subroutine.</p>

	This function allows a user to set the value of a <var class="product">Model 204</var> "global variable" which has a subsystem-wide scope. These are used for the value of the $GetG function or dummy string ("?&") substitution. The order in which the different scopes of global variables are searched can be controlled using <var>$SirParm</var> parameters: for $GetG, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.		This function allows a user to set the value of a <var class="product">Model 204</var> "global variable" which has a subsystem-wide scope. These are used for the value of the $GetG function or dummy string ("?&") substitution. The order in which the different scopes of global variables are searched can be controlled using <var>$SirParm</var> parameters: for $GetG, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.

JAL at 17:20, 26 August 2014

2014-08-26T17:20:26Z

← Older revision		Revision as of 17:20, 26 August 2014
Line 4:		Line 4:
	<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Setg_Subsys function is the <var>[[SetGlobal (System subroutine)\|SetGlobal]]</var> subroutine.</p>		<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Setg_Subsys function is the <var>[[SetGlobal (System subroutine)\|SetGlobal]]</var> subroutine.</p>

	This function allows a user to set the value of a <var class="product">Model 204</var> "global variable" which has a subsystem-wide scope. These are used for the value of the $GetG function or dummy string ("?&~~amp.~~") substitution. The order in which the different scopes of global variables are searched can be controlled using <var>$SirParm</var> parameters: for $GetG, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.		This function allows a user to set the value of a <var class="product">Model 204</var> "global variable" which has a subsystem-wide scope. These are used for the value of the $GetG function or dummy string ("?&") substitution. The order in which the different scopes of global variables are searched can be controlled using <var>$SirParm</var> parameters: for $GetG, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.

	The $Setg_Subsys function accepts three arguments and returns zero, indicating success, or a number indicating the cause of error, if there is one.		The $Setg_Subsys function accepts three arguments and returns zero, indicating success, or a number indicating the cause of error, if there is one.
Line 47:		Line 47:
	</p>		</p>

	Then, during execution of the TIMESHEET subsystem, the global variable DAYS can be used to obtain the days of the week.		Then, during execution of the <code>TIMESHEET</code> subsystem, the global variable <code>DAYS</code> can be used to obtain the days of the week.

	Also, since there is one shared subsystem global table for the entire system, a smaller GTBL value for each user can be achieved than if the global values are set with user global variables.		Also, since there is one shared subsystem global table for the entire system, a smaller GTBL value for each user can be achieved than if the global values are set with user global variables. </li>

	The order in which the different scopes of global variables are searched can be controlled using <var>[[$SirParm]]</var> parameters: for $~~GETG~~, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.		<li>The order in which the different scopes of global variables are searched can be controlled using <var>[[$SirParm]]</var> parameters: for <var>$Getg</var>, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.
	Here is an example to show the effects of DUMMYSYS and GETGSYS; assume the following procedure is executed in the CCAIN input stream:		Here is an example to show the effects of DUMMYSYS and GETGSYS; assume the following procedure is executed in the CCAIN input stream:

Line 59:		Line 59:
	</p>		</p>

	~~and~~ the login procedure of MY_SUBSYS contains the following requests:		And assume the login procedure of <code>MY_SUBSYS</code> contains the following requests:

	<p class="code">BEGIN		<p class="code">BEGIN
Line 71:		Line 71:

	Then here are various command streams, and their results:		Then here are various command streams, and their results:
			<ol>
	1. DUMMYSYS=0, GETGSYS=0:		<li>DUMMYSYS=0, GETGSYS=0:

	<p class="code">BEGIN		<p class="code">BEGIN
Line 79:		Line 79:
	%X = $SirParm('GETGSYS', 0)		%X = $SirParm('GETGSYS', 0)
	END		END
	MY_SUBSYS		MY_SUBSYS </p>

	~~'''produces~~ the following print lines:~~'''~~		Produces the following print lines:

			<p class="output">GOODBYE
	GOODBYE		GOODBYE
	~~GOODBYE~~		</p></li>
	</p>


	1. DUMMYSYS=0, GETGSYS=1:		<li>DUMMYSYS=0, GETGSYS=1:
	<p class="code">BEGIN		<p class="code">BEGIN
	%X FLOAT		%X FLOAT
Line 94:		Line 94:
	%X = $SirParm('GETGSYS', 1)		%X = $SirParm('GETGSYS', 1)
	END		END
	MY_SUBSYS		MY_SUBSYS </p>

	~~'''produces the following print lines:'''~~

	GOODBYE		Produces the following print lines:
			<p class="output">GOODBYE
	HELLO		HELLO
	</p>		</p></li>


	1. DUMMYSYS=1, GETGSYS=0:		<li>DUMMYSYS=1, GETGSYS=0:
	<p class="code">BEGIN		<p class="code">BEGIN
	%X FLOAT		%X FLOAT
Line 109:		Line 108:
	%X = $SirParm('GETGSYS', 0)		%X = $SirParm('GETGSYS', 0)
	END		END
	MY_SUBSYS		MY_SUBSYS </p>

	~~'''produces~~ the following print lines:~~'''~~		Produces the following print lines:

	HELLO		<p class="output">HELLO
	GOODBYE		GOODBYE
	</p>		</p></li>



	1. DUMMYSYS=1, GETGSYS=1:		<li>DUMMYSYS=1, GETGSYS=1:
	<p class="code">BEGIN		<p class="code">BEGIN
	%X FLOAT		%X FLOAT
Line 125:		Line 123:
	%X = $SirParm('GETGSYS', 1)		%X = $SirParm('GETGSYS', 1)
	END		END
	MY_SUBSYS		MY_SUBSYS </p>

	~~'''produces the following print lines:'''~~

			Produces the following print lines:
			<p class="output">HELLO
	HELLO		HELLO
	~~HELLO~~		</p></li>
	</p>		</ol></li>

	The current values of subsystem globals can be retrieved using <var>[[$Setg_Subsys_List]]</var>.		<li>The current values of subsystem globals can be retrieved using <var>[[$Setg_Subsys_List]]</var>. </li>

	Retrieval of subsystem global variables is highly efficient; updates, however, are not, so use this $function appropriately.		<li>Retrieval of subsystem global variables is highly efficient; updates, however, are not, so use this $function appropriately. </li>
	</ul>		</ul>

	==Products authorizing {{PAGENAMEE}}==		==Products authorizing {{PAGENAMEE}}==
	<ul class="smallAndTightList">		<ul class="smallAndTightList"></li>
	<li>[[List of $functions\|Sirius functions]]		<li>[[List of $functions\|Sirius functions]]</li>
	<li>[[Janus Web ~~Servert~~]]		<li>[[Janus Web Server]]</li>
	</ul>		</ul>

	[[Category:$Functions\|$Setg_Subsys]]		[[Category:$Functions\|$Setg_Subsys]]

JALWiccan: Automatically generated page update

2014-08-01T22:08:22Z

Automatically generated page update

← Older revision		Revision as of 22:08, 1 August 2014
Line 140:		Line 140:
	==Products authorizing {{PAGENAMEE}}==		==Products authorizing {{PAGENAMEE}}==
	<ul class="smallAndTightList">		<ul class="smallAndTightList">
	<li>[[Sirius functions]]		<li>[[List of $functions\|Sirius functions]]
	<li>[[Janus Web Servert]]		<li>[[Janus Web Servert]]
	</ul>		</ul>

	[[Category:$Functions\|$Setg_Subsys]]		[[Category:$Functions\|$Setg_Subsys]]

JALWiccan: Automatically generated page update

2013-07-19T18:59:11Z

Automatically generated page update

← Older revision		Revision as of 18:59, 19 July 2013
Line 2:		Line 2:
	<span class="pageSubtitle">Set subsystem-wide global</span>		<span class="pageSubtitle">Set subsystem-wide global</span>

	<p class="~~warning~~">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Setg_Subsys function is the <var>[[SetGlobal (System subroutine)\|SetGlobal]]</var> subroutine.</p>		<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Setg_Subsys function is the <var>[[SetGlobal (System subroutine)\|SetGlobal]]</var> subroutine.</p>

	This function allows a user to set the value of a <var class="product">Model 204</var> "global variable" which has a subsystem-wide scope. These are used for the value of the $GetG function or dummy string ("?&amp.") substitution. The order in which the different scopes of global variables are searched can be controlled using <var>$SirParm</var> parameters: for $GetG, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.		This function allows a user to set the value of a <var class="product">Model 204</var> "global variable" which has a subsystem-wide scope. These are used for the value of the $GetG function or dummy string ("?&amp.") substitution. The order in which the different scopes of global variables are searched can be controlled using <var>$SirParm</var> parameters: for $GetG, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.

JAL at 22:16, 12 April 2013

2013-04-12T22:16:32Z

← Older revision		Revision as of 22:16, 12 April 2013
Line 2:		Line 2:
	<span class="pageSubtitle">Set subsystem-wide global</span>		<span class="pageSubtitle">Set subsystem-wide global</span>

	<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Setg_Subsys function is the [[SetGlobal (System~~/Subsystem~~ subroutine)]].</p>		<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Setg_Subsys function is the <var>[[SetGlobal (System subroutine)\|SetGlobal]]</var> subroutine.</p>

	This function allows a user to set the value of a <var class="product">Model 204</var> "global variable" which has a subsystem-wide scope. These are used for the value of the $GetG function or dummy string ("?&amp.") substitution. The order in which the different scopes of global variables are searched can be controlled using <var>$SirParm</var> parameters: for $GetG, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.		This function allows a user to set the value of a <var class="product">Model 204</var> "global variable" which has a subsystem-wide scope. These are used for the value of the $GetG function or dummy string ("?&amp.") substitution. The order in which the different scopes of global variables are searched can be controlled using <var>$SirParm</var> parameters: for $GetG, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.
Line 17:		Line 17:

	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Setg_Subsys</span>(<span class="term">glob_name</span>, <span class="term">value</span>, <span class="term">subsys_name</span>)		<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Setg_Subsys</span>([<span class="term">glob_name</span>], [<span class="term">value</span>], <span class="term">subsys_name</span>)
	</p>		</p>

	<p>		<p>
			<var class="term">%rc</var> is set to 0 or to an error indicator.</p>

			===Return codes===
			<p class="code">0 - No errors
			1 - Not system administrator
			2 - Insufficient storage
			3 - Subsystem name missing
	</p>		</p>
	~~<p>%RC is set to 0 or to an error indicator.</p>~~

	~~<p class="code">~~
	~~0 - No errors~~
	~~1 - Not system administrator~~
	~~2 - Insufficient storage~~
	~~3 - Subsystem name missing~~
	~~</p>~~
	~~<p class="caption">$Setg_Subsys return codes~~
	~~</p>~~

	==Usage notes==		==Usage notes==
Line 36:		Line 35:
	<li>This function can be used to set a global variable which is used for all users of a subsystem. The value can be set during <var class="product">Model 204</var> initialization (that is, in the CCAIN stream), so values can be calculated once, rather than every time a user enters the subsystem. For example, the following request can be run from CCAIN:		<li>This function can be used to set a global variable which is used for all users of a subsystem. The value can be set during <var class="product">Model 204</var> initialization (that is, in the CCAIN stream), so values can be calculated once, rather than every time a user enters the subsystem. For example, the following request can be run from CCAIN:

	<p class="code"> OPEN CALENDAR		<p class="code">OPEN CALENDAR
	BEGIN		BEGIN
	%DAYS STRING LEN 100		%DAYS STRING LEN 100
	%X FLOAT		%X FLOAT
	%DAYS = ''		%DAYS = ''
	D: FOR EACH VALUE OF DAY		D: FOR EACH VALUE OF DAY
	%DAYS = %DAYS WITH ' ' WITH VALUE IN D		%DAYS = %DAYS WITH ' ' WITH VALUE IN D
	END FOR		END FOR
	%X = $Setg_Subsys('DAYS', %DAYS, 'TIMESHEET')		%X = $Setg_Subsys('DAYS', %DAYS, 'TIMESHEET')
	END		END
	</p>		</p>

Line 144:		Line 143:
	<li>[[Janus Web Servert]]		<li>[[Janus Web Servert]]
	</ul>		</ul>
	~~<p>~~
	~~</p>~~

	[[Category:$Functions\|$Setg_Subsys]]		[[Category:$Functions\|$Setg_Subsys]]

JALWiccan: Automatically generated page update

2013-04-12T21:48:23Z

Automatically generated page update

← Older revision		Revision as of 21:48, 12 April 2013
Line 17:		Line 17:

	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Setg_Subsys</span>(<span class="term">glob_name</span>, <span class="term">value</span>, subsys_name)		<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Setg_Subsys</span>(<span class="term">glob_name</span>, <span class="term">value</span>, <span class="term">subsys_name</span>)
	</p>		</p>
	<p>		<p>

JALWiccan: Automatically generated page update

2013-04-12T20:54:50Z

Automatically generated page update

← Older revision		Revision as of 20:54, 12 April 2013
Line 17:		Line 17:

	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Setg_Subsys</span>(<span class="term">glob_name, value, subsys_name)		<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Setg_Subsys</span>(<span class="term">glob_name</span>, <span class="term">value</span>, subsys_name)
	</p>		</p>
	<p>		<p>

JALWiccan: Automatically generated page update

2013-04-12T19:56:22Z

Automatically generated page update

← Older revision		Revision as of 19:56, 12 April 2013
Line 17:		Line 17:

	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%rc</span> = $Setg_Subsys(glob_name, value, subsys_name)		<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Setg_Subsys</span>(<span class="term">glob_name, value, subsys_name)
	</p>		</p>
	<p>		<p>

JALWiccan: Automatically generated page update

2013-04-12T15:11:31Z

Automatically generated page update

← Older revision		Revision as of 15:11, 12 April 2013
Line 17:		Line 17:

	==Syntax==		==Syntax==
	<p class="syntax">%rc = $Setg_Subsys(glob_name, value, subsys_name)		<p class="syntax"><span class="term">%rc</span> = $Setg_Subsys(glob_name, value, subsys_name)
	</p>		</p>
	<p>		<p>

JALWiccan: Automatically generated page update

2013-04-10T18:17:33Z

Automatically generated page update

← Older revision		Revision as of 18:17, 10 April 2013
Line 17:		Line 17:

	==Syntax==		==Syntax==
	<p class="syntax"~~><section begin="syntax" /~~>%rc = $Setg_Subsys(glob_name, value, subsys_name)		<p class="syntax">%rc = $Setg_Subsys(glob_name, value, subsys_name)
	~~<section end="syntax" />~~</p>		</p>
	<p>		<p>
	</p>		</p>