FUNCOPTS parameter

From m204wiki
Revision as of 22:07, 23 February 2017 by ELowell (talk | contribs) (→‎Description)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Sirius function flags

Summary

Default value
X'00'
Parameter type
System
Where set
System manager resettable
Related products
All
Introduced
Before Sirius Mods 6.7

Description

This parameter can be used to customize the behavior of certain $functions in a particular Online. This is a bitmask parameter where the bits have the following meanings:

X'80'
Causes $ProcOpn to use the current file as its default file context. The current file when $ProcOpn is invoked is usually the last file which was referenced in the request, whether by a Find or For Each Record statement or by some other $function. The behavior indicated by setting FUNCOPTS X'80' is inconsistent with all other file-related $functions, which use their compile-time file/group context as their run-time file/group context. This setting is made available to allow backward-compatibility with versions of the Sirius Mods prior to 4.0.
Any site running without this bit set should not set it.
X'40'
Allows any user to issue the $Priorty function to change another user's priority. If neither this nor the X'20' bit is set, only a System Manager or System Administrator can use the $Priorty function. This setting is available as of Sirius Mods version 7.3.
X'20'
Allows a procedure invoked via the NEWSESCMD facility to use the $Priorty function to change a user's priority. If neither this nor the X'40' bit is set, only a System Manager or System Administrator can use the $Priorty function. This setting is available as of Sirius Mods version 7.3.
X'02'
Causes all $list functions that encounter CCATEMP full conditions to act as if $SirParm('LISTFC', 1) had been called; that is, to cancel the request with a CCATEMP full condition.

The default behavior of most $list functions is to return a -3 on a CCATEMP full condition. But since most SOUL code likely could not deal with a CCATEMP full condition, it is probably far better to cancel the request than to return an unexpected code and carry on. This is especially true if the request that hits such an error is, itself, the cause of the CCATEMP full situation.

This bit setting has no effect before Sirius Mods version 6.8.

Most system methods (as opposed to $functions) that encounter a CCATEMP full situation already cause a request cancellation, so this parameter has no effect on system methods.

X'01'
Allows $Bump to bump a user with the same userid as the issuing user, even if the user is not a system manager. If this bit is not set, only system managers are allowed to bump other threads.