SIRFACT parameter: Difference between revisions
Jump to navigation
Jump to search
m (→Description) |
m (mixed case for For Record Number) |
||
| (13 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:SIRFACT parameter subtitle}} | |||
==Summary== | ==Summary== | ||
<dl> | <dl> | ||
| Line 10: | Line 11: | ||
<dd>[[SirFact]] | <dd>[[SirFact]] | ||
<dt>Introduced | <dt>Introduced | ||
<dd>Before | <dd>Before <var class="product">Sirius Mods</var> 6.7 | ||
</dl> | </dl> | ||
==Description== | ==Description== | ||
This parameter consists of several bits that can control | This parameter consists of several bits that can control | ||
the collection of compilation data and the trapping of certain | the collection of compilation data and the trapping of certain [[SOUL]] | ||
coding errors. | coding errors. | ||
The bits defined for the | The bits defined for the <var>SIRFACT</var> parameter are: | ||
<dl> | <dl> | ||
<dt>X'01' | <dt>X'01' | ||
<dd>Collect quad offset to procedure line number mapping information to CCATEMP. | <dd>Collect quad offset to [[Procedures|procedure]] line number mapping information to [[CCATEMP|CCATEMP]]. | ||
This makes it possible for request cancelling errors to indicate the procedure | This makes it possible for request cancelling errors to indicate the procedure | ||
and line number where the error occurred. | and line number where the error occurred. | ||
It provides identical functionality as the DEBUGUL parameter, but without | It provides identical functionality as the <var>[[DEBUGUL parameter|DEBUGUL]]</var> parameter, but without | ||
the QTBL space overhead. | the <var>[[LQTBL parameter|QTBL]]</var> space overhead. | ||
<dt>X'02' | <dt>X'02' | ||
<dd>Collect quad offset to procedure line number mapping information | <dd>Collect quad offset to procedure line number mapping information | ||
to server tables even if it is also being collected to CCATEMP. | to server tables even if it is also being collected to CCATEMP. | ||
There's probably no real good reason to set this bit. | There's probably no real good reason to set this bit. | ||
<dt>X'04' | <dt>X'04' | ||
<dd>Don't do comment initialized global dummy string substitution. | <dd>Don't do comment-initialized global [[Procedures#Dummy strings|dummy string]] substitution. | ||
See the [[SirFact | See the [[SirFact]] pages for more information on comment-initialized globals. | ||
<dt>X'08' | <dt>X'08' | ||
<dd>Cancel | <dd>Cancel <var>[[For Record Number statement#For Record Number processing|For Record Number]]</var> or <var>FRN</var> statements where the record number | ||
is a null string. | is a null string. | ||
<dt>X'10' | <dt>X'10' | ||
<dd>Cancel | <dd>Cancel <var>For Record Number</var> or <var>FRN</var> statements where the record number | ||
is not a valid number. | is not a valid number. | ||
<dt>X'20' | <dt>X'20' | ||
<dd>Cancel | <dd>Cancel <var>For Record Number</var> or <var>FRN</var> statements where the record number | ||
is not found. | is not found. | ||
<dt>X'40' | <dt>X'40' | ||
<dd>When a procedure is included | <dd>When a procedure is included | ||
(whether as part of an APSY subsystem or directly from | (whether as part of an [[Application_Subsystem_development|APSY subsystem]] or directly from Model 204 command mode), | ||
copy it to CCATEMP. | copy it to CCATEMP. | ||
After the copy, release the share enqueue on the procedure. | After the copy, release the share enqueue on the procedure. | ||
As a result, a user who includes a procedure does not prevent | As a result, a user who includes a procedure does not prevent | ||
others from updating the procedure. | others from updating the procedure. | ||
See the | See the [[SirFact]] pages for more information on subsystem procedure enqueues. | ||
The copy of the procedure to CCATEMP incurs some extra | The copy of the procedure to CCATEMP incurs some extra | ||
(barely measurable) overhead. | (barely measurable) overhead. | ||
<dt>X'80' | <dt>X'80' | ||
<dd>Enable the | <dd>Enable the SirFact APSY maintenance enhancements you specify with the | ||
[[SIRAPSYF parameter]]. | <var>[[SIRAPSYF parameter|SIRAPSYF]]</var> parameter. | ||
Also, regardless of the SIRAPSYF settings, | Also, regardless of the <var>SIRAPSYF</var> settings, | ||
release the share enqueue on a procedure | release the share enqueue on a procedure | ||
when the last line of the procedure is read, not when the line after the | when the last line of the procedure is read, not when the line after the | ||
last line is attempted to be read. | last line is attempted to be read. | ||
See the SirFact | See the [[SirFact]] pages for more information on subsystem procedure enqueues. | ||
</dl> | </dl> | ||
[[Category:System parameters]] | [[Category:System parameters]] | ||
[[Category:Parameters]] | [[Category:Parameters]] | ||
Latest revision as of 16:38, 27 April 2018
SirFact flags
Summary
- Default value
- X'00'
- Parameter type
- System
- Where set
- User 0 CCAIN parameters
- Related products
- SirFact
- Introduced
- Before Sirius Mods 6.7
Description
This parameter consists of several bits that can control the collection of compilation data and the trapping of certain SOUL coding errors. The bits defined for the SIRFACT parameter are:
- X'01'
- Collect quad offset to procedure line number mapping information to CCATEMP. This makes it possible for request cancelling errors to indicate the procedure and line number where the error occurred. It provides identical functionality as the DEBUGUL parameter, but without the QTBL space overhead.
- X'02'
- Collect quad offset to procedure line number mapping information to server tables even if it is also being collected to CCATEMP. There's probably no real good reason to set this bit.
- X'04'
- Don't do comment-initialized global dummy string substitution. See the SirFact pages for more information on comment-initialized globals.
- X'08'
- Cancel For Record Number or FRN statements where the record number is a null string.
- X'10'
- Cancel For Record Number or FRN statements where the record number is not a valid number.
- X'20'
- Cancel For Record Number or FRN statements where the record number is not found.
- X'40'
- When a procedure is included (whether as part of an APSY subsystem or directly from Model 204 command mode), copy it to CCATEMP. After the copy, release the share enqueue on the procedure. As a result, a user who includes a procedure does not prevent others from updating the procedure. See the SirFact pages for more information on subsystem procedure enqueues. The copy of the procedure to CCATEMP incurs some extra (barely measurable) overhead.
- X'80'
- Enable the SirFact APSY maintenance enhancements you specify with the SIRAPSYF parameter. Also, regardless of the SIRAPSYF settings, release the share enqueue on a procedure when the last line of the procedure is read, not when the line after the last line is attempted to be read. See the SirFact pages for more information on subsystem procedure enqueues.