SetGlobal (Subsystem subroutine): Difference between revisions

Revision as of 05:45, 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, SetGlobal momentarily turns off multi-processing, so should not be used heavily in an MP/204 environment. SetString does not suffer this limitation and should be used in these situations.

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 18: / Line 18: @@
 <li>It is not an error to set a global that is not set.
 <li>The <var>Subsystem</var> class <var>SetGlobal</var> sets the global for the current <var>subsystem</var> context (indicated by <var>[[Context_(Subsystem_property)|Context]]</var>).
-<li>Like <var>[[$Setg_Subsys]]</var>, the <var>SetGlobal</var> method momentarily turns off multi-processing, so should not be used heavily in an <var class="product">MP/204</var> environment.
+<li>Like <var>[[$Setg_Subsys]]</var>, <var>SetGlobal</var> momentarily turns off multi-processing, so should not be used heavily in an <var class="product">MP/204</var> environment.  <var>[[SetString_(Subsystem_function)|SetString]]</var> does not suffer this limitation and should be used in these situations.
 </ul>