SIRFACT parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
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 [[Sirius Mods]] 6.7
<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 User Language
the collection of compilation data and the trapping of certain [[SOUL]]
coding errors.
coding errors.
The bits defined for the [[SirFact]] parameter are:
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 Reference Manual]] for more information on comment initialized globals.
See the [[SirFact]] pages for more information on comment-initialized globals.
 
<dt>X'08'
<dt>X'08'
<dd>Cancel FOR RECORD NUMBER or FRN statements where the record number
<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 FOR RECORD NUMBER or FRN statements where the record number
<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 FOR RECORD NUMBER or FRN statements where the record number
<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 [[Model 204]] command mode),
(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 Sirfact Reference Manual for more information on subsystem procedure enqueues.
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 [[SirFact]] APSY maintenance enhancements you specify with 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 Reference Manual for more information on subsystem procedure enqueues.
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.