SetGlobal (System subroutine): Difference between revisions

From m204wiki
Jump to navigation Jump to search
Line 17: Line 17:
<ul><li>All errors result in request cancellation.
<ul><li>All errors result in request cancellation.
<li>It is not an error to set a global that is not set.
<li>It is not an error to set a global that is not set.
<li>Like <var>[[$Setg_Sys]]</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.  <var>[[SetString_(System_function)|SetString]]</var> does not suffer this limitation and should be used in this situations.
<li>Like <var>[[$Setg_Sys]]</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.  <var>[[SetString_(System_function)|SetString]]</var> does not suffer this limitation and should be used in these situations.
</ul>
</ul>



Revision as of 05:46, 25 March 2011

Set a system-wide global (System class)

The SetGlobal shared subroutine sets a System global.

Syntax

%(System):SetGlobal( name, value)

Syntax terms

%(System) The class name in parentheses denotes a shared method. SetGlobal can also be invoked via a System 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.
  • Like $Setg_Sys, the SetGlobal method 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.

Examples

  1. The following statement sets the system global called CHOLERIC:

    %(system):setGlobal('CHOLERIC', 'ANGRY')

See also

  • The setGlobal method, in the System class, performs a function identical to the $setg_sys function. That is, the following two statements are identical:

    %(system):setGlobal('PHLEGMATIC', 'STOLID') %setg_sys('PHLEGMATIC', 'STOLID')

  • For more information about system globals, see “System globals and strings”.