$Delg Sys: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "{{DISPLAYTITLE:$Delg_Sys}} <span class="pageSubtitle"><section begin="desc" />Delete system-wide global<section end="desc" /></span> <p class="warning">Most Sirius $functions ha...")
 
m (1 revision)
(No difference)

Revision as of 15:44, 31 January 2011

<section begin="desc" />Delete system-wide global<section end="desc" />

Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Delg_Sys function is to be entered.

This function allows a user to delete a Model 204 "global variable" which has a system-wide scope. Doing this will let the value of the $GETG function or dummy string ("?&amp.") substitution for the variable default to the current user global variable with the same name, or it may not affect their results, depending on the scope search order. The order in which the different scopes of global variables are searched can be controlled using $SirParm parameters: for $GETG, with 'GETGSYS', and for dummy strings, with 'DUMMYSYS'.

The $Delg_Sys function accepts one argument and returns zero, indicating success, or a number indicating the cause of error, if there is one.

The first argument is the name of the global variable to be deleted. This is an optional argument; it defaults to the null string.

System administrator privileges are required to invoke this $function.

Syntax

<section begin="syntax" /> %RC = $Delg_Sys( glob_name ) <section end="syntax" />

$Delg_Sys Function

%RC is set to 0 or to an error indicator.

0 - No errors 1 - Not system administrator

$Delg_Sys return codes


Retrieval of system global variables is highly efficient; updates, however, are not, so use this $function appropriately.

For an explanation of the use of system global variables, see $Setg_Sys. For an explanation of $SIRPARM, see $SirParm.

This $function is new in Version 5.5 of the Sirius Mods.

  • &SFUNC
  • &JWEBS

Products authorizing $Delg_Sys