SetGlobal (Subsystem subroutine): Difference between revisions

Revision as of 05:08, 25 March 2011

Set a subsystem global (Subsystem class)

The SetGlobal shared subroutine sets a Subsystem global.

%(Subsystem):SetGlobal( name, value)

%(Subsystem)	The class name in parentheses denotes a shared method. `SetGlobal` can also be invoked via a `Subsystem` object variable, which may be null.
name	A string that identifies the global to be set.
value	A string that identifies the new value for the global.

All errors result in request cancellation.
It is not an error to set a global that is not set.
The Subsystem class SetGlobal sets the global for the current subsystem context (indicated by Context).
Like $Setg_Subsys, the SetGlobal method momentarily turns off multi-processing, so should not be used heavily in an MP/204 environment.

The setGlobal method, in the Subsystem class, performs a function identical to the $setg_subsys function. That is, the following two statements are identical:
%(subsystem):setGlobal('PHLEGMATIC', 'STOLID') %setg_subsys('PHLEGMATIC', 'STOLID')
For more information about subsystem globals, see “Subsystem globals and strings”.

Subsystem class	List of Subsystem methods	Subsystem methods syntax
Notation conventions for methods

@@ Line 22: / Line 22: @@
 ==See also==
-<ul><li>The <var>setGlobal</var> method, in the <var>Subsystem</var> class, performs a function identical to the <var>$setg_subsys</var> function.  That is, the following two statements are identical:
+<ul><li>The <var>setGlobal</var> method, in the <var>Subsystem</var> class, performs a function identical to the <var>[[$Setg_Subsys|$setg_subsys]]</var> function.  That is, the following two statements are identical:
 <p class="code">%(subsystem):setGlobal('PHLEGMATIC', 'STOLID')
 %setg_subsys('PHLEGMATIC', 'STOLID')</p>
 <li>For more information about subsystem  globals, see [[Subsystem_class#System_and_subsystem_globals_and_strings|“Subsystem globals and strings”]].</ul>
 {{Template:Subsystem:SetGlobal footer}}