SetGlobal (Subsystem subroutine)

From m204wiki
Revision as of 23:18, 22 October 2015 by Tbullock (talk | contribs) (Needs an output variable too.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Set a subsystem global (Subsystem class)

The SetGlobal shared subroutine sets a subsystem global.


%(Subsystem):SetGlobal( name, value)

Syntax terms

%(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.

Usage notes

  • 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.

See also

  • 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') %rc = $Setg_Subsys('PHLEGMATIC', 'STOLID')

  • For more information about subsystem globals, see System and Subsystem globals and strings.