SIRAPSYF parameter - Revision history

DCameron: /* Usage notes */

2017-05-31T14:22:14Z

Usage notes

← Older revision		Revision as of 14:22, 31 May 2017
Line 86:		Line 86:

	<li>The <var>SIRAPSYF</var> features you specify apply on a system-wide basis. To specify an override for an individual subsystem,		<li>The <var>SIRAPSYF</var> features you specify apply on a system-wide basis. To specify an override for an individual subsystem,
	you can specify a special deferred update DD name for the subsystem's procedure group. This [[Deferred_update_feature\|deferred update]] DD name specifies the subsystem-specific <var>SIRAPSYF</var> flags. Because <var>SUBSYSMGMT</var> insists that deferred update DD names begin with <code>TAPE</code>, the <var>SIRAPSYF</var> overide is specified as <code>TAPE*</code> (the asterisk is invalid in real DD names) followed by the hex value of the override.		you can specify a special deferred update DD name for the subsystem's procedure group. This [[Deferred_update_feature\|deferred update]] DD name specifies the subsystem-specific <var>SIRAPSYF</var> flags. Because <var>[[SUBSYSMGMT#Overview_of_the_Subsystem_Management_facility\|SUBSYSMGMT]]</var> insists that deferred update DD names begin with <code>TAPE</code>, the <var>SIRAPSYF</var> overide is specified as <code>TAPE*</code> (the asterisk is invalid in real DD names) followed by the hex value of the override.
	<p>		<p>
	For example, to use a <var>SIRAPSYF</var> override for subsystem <code>DEVPRO</code> with procedure group <code>SIRIUS</code> (as shown below): </p>		For example, to use a <var>SIRAPSYF</var> override for subsystem <code>DEVPRO</code> with procedure group <code>SIRIUS</code> (as shown below): </p>

DCameron: /* Usage notes */

2017-05-31T14:20:38Z

Usage notes

← Older revision		Revision as of 14:20, 31 May 2017
Line 86:		Line 86:

	<li>The <var>SIRAPSYF</var> features you specify apply on a system-wide basis. To specify an override for an individual subsystem,		<li>The <var>SIRAPSYF</var> features you specify apply on a system-wide basis. To specify an override for an individual subsystem,
	you can specify a special deferred update DD name for the subsystem's procedure group. This deferred update DD name specifies the subsystem-specific <var>SIRAPSYF</var> flags. Because <var>SUBSYSMGMT</var> insists that deferred update DD names begin with <code>TAPE</code>, the <var>SIRAPSYF</var> overide is specified as <code>TAPE*</code> (the asterisk is invalid in real DD names) followed by the hex value of the override.		you can specify a special deferred update DD name for the subsystem's procedure group. This [[Deferred_update_feature\|deferred update]] DD name specifies the subsystem-specific <var>SIRAPSYF</var> flags. Because <var>SUBSYSMGMT</var> insists that deferred update DD names begin with <code>TAPE</code>, the <var>SIRAPSYF</var> overide is specified as <code>TAPE*</code> (the asterisk is invalid in real DD names) followed by the hex value of the override.
	<p>		<p>
	For example, to use a <var>SIRAPSYF</var> override for subsystem <code>DEVPRO</code> with procedure group <code>SIRIUS</code> (as shown below): </p>		For example, to use a <var>SIRAPSYF</var> override for subsystem <code>DEVPRO</code> with procedure group <code>SIRIUS</code> (as shown below): </p>

DCameron: /* Description */

2017-05-31T14:15:49Z

Description

← Older revision		Revision as of 14:15, 31 May 2017
Line 40:		Line 40:
	<tr>		<tr>
	<th>X'04'</th>		<th>X'04'</th>
	<td>Tracks in a bitmap the [[CCATEMP\|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 <var>STOP SUBSYSTEM</var> process significantly faster.		<td>Tracks in a bitmap the [[CCATEMP\|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 <var>[[STOP_command:_Stopping_an_application_subsystem\|STOP SUBSYSTEM]]</var> 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.</td>		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.</td>

DCameron: /* Description */

2017-05-31T14:13:07Z

Description

← Older revision		Revision as of 14:13, 31 May 2017
Line 40:		Line 40:
	<tr>		<tr>
	<th>X'04'</th>		<th>X'04'</th>
	<td>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 <var>STOP SUBSYSTEM</var> process significantly faster.		<td>Tracks in a bitmap the [[CCATEMP\|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 <var>STOP SUBSYSTEM</var> 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.</td>		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.</td>

DCameron: /* Description */

2017-05-31T14:03:46Z

Description

← Older revision		Revision as of 14:03, 31 May 2017
Line 20:		Line 20:
	<tr>		<tr>
	<th>X'01'</th>		<th>X'01'</th>
	<td>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.		<td>Allows [[Procedures\|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.		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.

DCameron: /* Description */

2017-05-31T13:53:54Z

Description

← Older revision		Revision as of 13:53, 31 May 2017
Line 14:		Line 14:
	</dl>		</dl>
	==Description==		==Description==
	This parameter controls a number of APSY subsystem maintenance features. The bits defined for the features are described below.		This parameter controls a number of [[Application_Subsystem_development\|APSY]] subsystem maintenance features. The bits defined for the features are described below.

	No <var>SIRAPSYF</var> features are enabled unless you also set the X'80' bit on the <var>[[SIRFACT parameter\|SIRFACT]]</var> parameter.		No <var>SIRAPSYF</var> features are enabled unless you also set the X'80' bit on the <var>[[SIRFACT parameter\|SIRFACT]]</var> parameter.

JAL: /* Usage notes */ tweak graphic

2016-04-25T18:40:55Z

Usage notes: tweak graphic

← Older revision		Revision as of 18:40, 25 April 2016
Line 83:		Line 83:
	</ul>		</ul>

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

	<li>The <var>SIRAPSYF</var> features you specify apply on a system-wide basis. To specify an override for an individual subsystem,		<li>The <var>SIRAPSYF</var> features you specify apply on a system-wide basis. To specify an override for an individual subsystem,
Line 90:		Line 89:
	<p>		<p>
	For example, to use a <var>SIRAPSYF</var> override for subsystem <code>DEVPRO</code> with procedure group <code>SIRIUS</code> (as shown below): </p>		For example, to use a <var>SIRAPSYF</var> override for subsystem <code>DEVPRO</code> with procedure group <code>SIRIUS</code> (as shown below): </p>
	<p>		<p class="caption" style="width:450px">SIRAPSYF override </p>
	[[File:sirapsyf3.png\|~~frame\|SIRAPSYF override~~]] </p>		<p class="figure">[[File:sirapsyf3.png\|450px]] </p>

	~~<br clear=all>~~
	You must do one of the following:		You must do one of the following:
	<ul>		<ul>
	<li>As ~~illustrated here~~, specify the special deferred update DD name under "Deferred Name"		<li>As shown above, specify the special deferred update DD name under <b>Deferred Name</b>
	on the Subsystem File Use screen in SUBSYSMGMT. </li>		in the <b>Subsystem File Use</b> screen in SUBSYSMGMT. </li>

	<li>If you use an ad hoc procedure, specify this special name for the APSFDN field in the SCLS records for the subsystem.		<li>If you use an ad hoc procedure, specify this special name for the <code>APSFDN</code> field in the SCLS records for the subsystem.
	</ul>		</ul>

	<code>TAPE*04</code> indicates that the eqivalent of <var>SIRAPSYF</var> X'04' should be used for subsystem <code>DEVPRO</code>. One might want to do this if one wants to be able to force recompilation of <code>DEVPRO</code> procs every time simply by placing a copy of the outer procedure in an unlocked file. One might wish to do this if procedures frequently require recompilation for changes to dummy string globals (<code>?&</code> values), something that <var class="product">SirFact</var> ~~doesn't~~ track.		<code>TAPE*04</code> indicates that the eqivalent of <var>SIRAPSYF</var> X'04' should be used for subsystem <code>DEVPRO</code>. One might want to do this if one wants to be able to force recompilation of <code>DEVPRO</code> procs every time simply by placing a copy of the outer procedure in an unlocked file. One might wish to do this if procedures frequently require recompilation for changes to dummy string globals (<code>?&</code> values), something that <var class="product">SirFact</var> does not track.

	Setting a deferred index update file name for a procedure group is certain to be completely harmless as procedure groups are never opened for deferred update when running a subsystem.		Setting a deferred index update file name for a procedure group is certain to be completely harmless as procedure groups are never opened for deferred update when running a subsystem.

JAL: link repair

2016-03-02T01:43:39Z

link repair

← Older revision		Revision as of 01:43, 2 March 2016
Line 62:		Line 62:
	updated procedures in unlocked file(s).</p>		updated procedures in unlocked file(s).</p>
	<p>		<p>
	The <var>SIRFACT QUIESCE</var> and <var>RESUME</var> ~~subcommands~~ supplement these features		The <var>[[SIRFACT command#SIRFACT QUIESCE\|SIRFACT QUIESCE]]</var> and <var>[[SIRFACT command#SIRFACT RESUME\|SIRFACT RESUME]]</var> commands supplement these features
	by preventing subsystem users from interfering with procedure update operations.		by preventing subsystem users from interfering with procedure update operations. </p></li>
	~~For more information, see the <var class="book">[http://m204wiki.rocketsoftware.com/images/f/fb/FactrNew.pdf SirFact Reference Manual]</var>~~. </p></li>

	<li>For both the X'01' and X'02' bits, an inner or		<li>For both the X'01' and X'02' bits, an inner or

JAL: /* Description */

2014-07-02T19:58:25Z

Description

Show changes

DmeWiccan: Automatically generated page update

2013-08-27T16:14:53Z

Automatically generated page update

← Older revision		Revision as of 16:14, 27 August 2013
Line 1:		Line 1:
			{{Template:SIRAPSYF parameter subtitle}}
	==Summary==		==Summary==
	<dl>		<dl>