SIRAPSYF parameter

From m204wiki
Revision as of 19:24, 22 June 2012 by Goff (talk | contribs) (Link to SIRFACT parameter)
Jump to navigation Jump to search

Summary

Default value
X'00'
Parameter type
System
Where set
System manager resettable
Related products
SirFact
Introduced
Before Sirius Mods 6.7

Description

This parameter controls a number of APSY subsystem maintenance features. The bits defined for the features are described below.

note

No SIRAPSYF features are enabled unless you also set the X'80' bit on the SIRFACT parameter.

X'01'
Allows procedure compilations to be saved (pre-compiled) for unlocked procedure group members. If an outer or an inner procedure in an unlocked file in a procedure group is changed, or if an outer procedure is added to an unlocked file in a procedure group, the procedure is recompiled and that compilation is saved. Also allows the pre-compiling of a procedure with a pre-compile prefix that was not present in the procedure group when the subsystem was started. In version 7.1 or higher of the Sirius Mods, if a pre-compiled procedure has multiple Begin/End brackets, the first bracket will be saved as the pre-compilation and subsequent brackets will be re-compiled every time the procedure is run. If this bit is not set, using unlocked files to facilitate the updating of procedures in a running subsystem has an efficiency cost because procedure compilations are not saved. This setting has no effect on procedures in subsystems that use a procedure file instead of a procedure group, and it has no effect on subsystems that use a procedure group but not unlocked files.
X'02'
Detects changes to included procedures that reside in a pre-compiled procedure in a subsystem procedure group. If such an included procedure is changed, the pre-compiled procedure is recompiled. This setting has no effect on procedures in subsystems that use a procedure file instead of a procedure group, and it has no effect on subsystems that use a procedure group but not unlocked files.
X'04'
Tracks in a bitmap the CCATEMP pages allocated to pre-compiled procedures in a subsystem. When the subsystem is stopped, this bitmap is used to free the pages rather than chaining through them, which requires considerable CCATEMP I/O. Although the bitmap method has more (but probably not measurable) overhead while saving compilations, it can make the STOP SUBSYSTEM process significantly faster. The bitmap is subsystem-wide and not procedure-specific. It does not reduce the time required for discarding the CCATEMP pages that are associated with a compilation that is being replaced.
X'08'
Allows the FACTDEB parameter to be set inside the subsystem. If this bit is not set, that parameter is not allowed to be reset.


Usage notes:

  • These SIRAPSYF features along with the SIRFACT parameter X'40' and X'80' bits are designed to simplify the updating of procedures and the pre-compiling of these updated procedures while their subsystem is in use.
    Note: These settings do not eliminate the lock on outer procedures in locked procedure files. They are designed to suit a procedure group and the placement of updated procedures in unlocked file(s).
    The SIRFACT QUIESCE and RESUME subcommands supplement these features by preventing subsystem users from interfering with procedure update operations. For more information, see the SirFact Reference Manual.
  • For both the X'01' and X'02' bits, an inner or outer procedure is considered changed if the actual procedure is modified or if a new version of the procedure is added to an earlier file in the procedure group.
  • When using temporary procedure groups, a request compilation is not saved if any of the outer or inner procedures came from a file not in the subsystem's permanent group. Furthermore, if the outer procedure is found in a file not in the subsystem's permanent group, it will always be recompiled. If an inner procedure (but not the outer) is found in a file not in the subsystem's permanent group, whether the procedure is recompiled depends on the X'02' bit setting:
    • If the bit is off, the procedure might or might not be recompiled.
    • If the bit is on, the procedure is always recompiled.

    Hence, it is recommended that where temporary procedure groups are to be used, the X'02' bit is to be set.

  • The SIRAPSYF features you specify apply on a system-wide basis. To specify an override for an individual subsystem, you can specify in CCASYS a special deferred update DD name for a procedure group that defines its particular SIRAPSYF option. For example, as shown for group SALESGRP (see figure), you must:
    SIRAPSYF override
    • In SUBSYSMGMT, specify the special deferred update DD name under “Deferred Name” on the Subsystem File Use screen.
      Or, if you use an ad hoc procedure, specify this special name for the APSFDN field in the SCLS records for the subsystem.
    • Begin the deferred update DD name with the characters TAPE*, and append the two hexadecimal digits that indicate the subsystem-specific bit settings you want for the SirFact APSY enhancements. TAPE*07 would set the SIRAPSYF X'07' features for the group.

    Setting a deferred index update file name is completely harmless in systems that do not have the SirFact APSY facility or do not have the facility enabled (by specifying the SIRFACT X'80' bit).