FUNCOPTS parameter

From m204wiki
Revision as of 21:05, 23 January 2015 by Dme (talk | contribs) (→‎Description)
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 if none is specified. The current file at a $procopn is usually the last file referenced in the request, whether via a Find statement, or a For Each Record statement, or 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 the LISTFC $sirparm were set to 1, 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. Since it is not likely that much, if any, &UL. code is prepared to deal with a CCATEMP full condition, it is probably far better for a request to be cancelled in a CCATEMP full situation than to hand it an unexpected return 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.