FUNCOPTS parameter: Difference between revisions
Jump to navigation
Jump to search
| Line 20: | Line 20: | ||
<dl> | <dl> | ||
<dt>X'80' | <dt>X'80' | ||
<dd>Causes <var>[[$ProcOpn]]</var> to use the current file as its default file context | <dd>Causes <var>[[$ProcOpn]]</var> to use the <b>current file</b> as its default file context. | ||
The <b>current file</b> when <var>$ProcOpn</var> is invoked is usually the last file which was referenced in the | |||
The current file | request, whether by a <var>Find</var> or <var>For Each Record</var> statement or by | ||
request, whether | |||
some other $function. | some other $function. | ||
The behavior indicated by setting FUNCOPTS X'80' is inconsistent with all | The behavior indicated by setting FUNCOPTS X'80' is inconsistent with all | ||
| Line 31: | Line 30: | ||
Any site running without this bit set, should not set it. | Any site running without this bit set, should not set it. | ||
<dt>X'40' | <dt>X'40' | ||
<dd>Allows any user to issue the $ | <dd>Allows any user to issue the <var>[[$Priorty]]</var> function | ||
to change another user's priority. | to change another user's priority. | ||
If neither this nor the X'20' bit is set, | If neither this nor the X'20' bit is set, | ||
only a System Manager or System Administrator can use the $ | only a System Manager or System Administrator can use the <var>$Priorty</var> function. | ||
This setting is available as of <var class="product">Sirius Mods</var> version 7.3. | This setting is available as of <var class="product">Sirius Mods</var> version 7.3. | ||
<dt>X'20' | <dt>X'20' | ||
<dd>Allows a procedure invoked via the | <dd>Allows a procedure invoked via the | ||
NEWSESCMD facility to use the $ | <var>[[NEWSESCMD (JANUS DEFINE parameter)|NEWSESCMD]]</var> facility to use the <var>[[$Priorty]]</var> function to change a user's priority. | ||
If neither this nor the X'40' bit is set, | If neither this nor the X'40' bit is set, | ||
only a System Manager or System Administrator can use the $ | only a System Manager or System Administrator can use the <var>$Priorty</var> function. | ||
This setting is available as of <var class="product">Sirius Mods</var> version 7.3. | This setting is available as of <var class="product">Sirius Mods</var> version 7.3. | ||
<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 | 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 | The default behavior of most $list functions is to return a -3 on a CCATEMP full | ||
condition. | condition. | ||
Since it is not likely that much, if any, | Since it is not likely that much, if any, SOUL code is prepared to deal with a | ||
CCATEMP full condition, it is probably far better for a request to be cancelled | 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 | in a CCATEMP full situation than to hand it an unexpected return code and carry | ||
| Line 62: | Line 61: | ||
effect on system methods. | effect on system methods. | ||
<dt>X'01' | <dt>X'01' | ||
<dd>Allows $ | <dd>Allows <var>[[$Bump]]</var> to bump a user with the same userid as the issuing user, even if the | ||
user is not a system manager. | user is not a system manager. | ||
If this bit is not set, only system managers are allowed to bump other threads. | If this bit is not set, only system managers are allowed to bump other threads. | ||
Revision as of 19:43, 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. Since it is not likely that much, if any, SOUL 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.