FUNCOPTS parameter: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| Line 27: | Line 27: | ||
other file-related $functions, which use their compile-time file/group context | other file-related $functions, which use their compile-time file/group context | ||
as their run-time file/group context. | as their run-time file/group context. | ||
This setting is made available to allow backward-compatibility with versions of the <var class="product">Sirius Mods</var> prior to 4.0. | This setting is made available to allow backward-compatibility with versions of the <var class="product">Sirius Mods</var> prior to 4.0. <br /> | ||
Any site running without this bit set | Any site running without this bit set should not set it. | ||
<dt>X'40' | <dt>X'40' | ||
<dd>Allows any user to issue the <var>[[$Priorty]]</var> function | <dd>Allows any user to issue the <var>[[$Priorty]]</var> function | ||
| Line 45: | Line 45: | ||
<dt>X'02' | <dt>X'02' | ||
<dd>Causes all $list functions that encounter CCATEMP full conditions to | <dd>Causes all $list functions that encounter CCATEMP full conditions to | ||
act as if <var>[[$SirParm]]</var>('LISTFC', 1) had been called | act as if <var>[[$SirParm]]</var>('LISTFC', 1) had been called; that is, to cancel the request | ||
with a CCATEMP full condition. | with a CCATEMP full condition. | ||
The default behavior of most $list functions is to return a -3 on a CCATEMP full | <p>The default behavior of most $list functions is to return a -3 on a CCATEMP full | ||
condition. | 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. | |||
CCATEMP full condition, it is probably far better | |||
on. | |||
This is especially true if the request that hits such an error is, itself, the | This is especially true if the request that hits such an error is, itself, the | ||
cause of the CCATEMP full situation. | cause of the CCATEMP full situation.</p> | ||
This bit setting has no effect before <var class="product">Sirius Mods</var> version 6.8. | This bit setting has no effect before <var class="product">Sirius Mods</var> version 6.8. | ||
Revision as of 21:13, 23 February 2017
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.