FUNCOPTS parameter: Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
|||
| (7 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:FUNCOPTS parameter subtitle}} | |||
==Summary== | ==Summary== | ||
<dl> | <dl> | ||
| Line 19: | Line 20: | ||
<dl> | <dl> | ||
<dt>X'80' | <dt>X'80' | ||
<dd>Causes $ | <dd>Causes <var>[[$ProcOpn]]</var> to use the <i>current file</i> as its default file context. | ||
The <i>current file</i> 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 | ||
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 $ | <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 | <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. | ||
| Line 61: | Line 58: | ||
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. | ||
Latest revision as of 22:07, 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.