APSYPAGE parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 16: Line 16:
==Description==
==Description==
<p>
<p>
Activates the APSY Precompiled Procedures in Storage feature by specifying a number of 4K operating system pages.</p>
While the feature was available, the <var>APSYPAGE</var> parameter activated the [[System requirements for Application Subsystems#Activating the APSY Precompiled Procedures in Storage feature|APSY Precompiled Procedures in Storage feature]] by specifying a number of 4K-byte operating system pages.</p>
<p>
<p>
For IBM z/OS systems only.</p>
For IBM z/OS systems only.</p>
<p>
<p>
<var>APSYPAGE</var> was implemented to take advantage of the <code>MVPG</code> machine language instruction which moved an entire hardware page (4K) with a single instruction and which, at the time, had significantly better performance than the stream-oriented moves used by standard APSY load. However, recent hardware models actually seem to have better performance for the stream-oriented moves.</p>
<var>APSYPAGE</var> was implemented to take advantage of the <code>MVPG</code> machine language instruction which moved an entire hardware page (4K bytes) with a single instruction and which, at the time, had significantly better performance than the stream-oriented moves used by standard APSY load. However, recent hardware models actually seem to have better performance for the stream-oriented moves.</p>
<p>Therefore, it is now recommended that customers who have been using the <var>APSYPAGE</var> parameter <var class="term">disable the APSYPAGE feature</var> by setting <var>APSYPAGE</var> to 0. Then set the <var>[[RESPAGE parameter|RESPAGE]]</var> parameter to the former value of APSYPAGE.</p>
<p class="warn"><b>Note:</b> As of Model&nbsp;204 7.5, it is recommended that customers who have been using the <var>APSYPAGE</var> parameter <var class="term">disable the APSYPAGE feature</var> by setting <var>APSYPAGE</var> to 0. <br />As of Model&nbsp;204 7.7, setting <var>APSYPAGE</var> to a non-zero value results in an error and <var class="term">prevents the Online from coming up</var>. </p>
<p>
Instead of <var>APSYPAGE</var>, you can use the following:</p>
<ul>
<li>The <var>[[RESPAGE parameter|RESPAGE]]</var> parameter (recommended for performance).
<p>
Set <var>RESPAGE</var> to the former value of <var>APSYPAGE</var>. Both <var>RESPAGE</var> and <var>APSYPAGE</var> specify the number of 4096-byte pages allocated for the respective feature. </p></li>


The units for both <var>RESPAGE</var> and <var>APSYPAGE</var> are 4096 (hardware page size) bytes.
<li>The <var>[[TEMPPAGE parameter|TEMPPAGE]]</var> parameter.
 
<p>
Alternatively, you can use <var>[[TEMPPAGE parameter|TEMPPAGE]]</var> instead of APSYPAGE. TEMPPAGE units are 6184 bytes, so you would use the APSYPAGE value, divided by 1.5.
<var>TEMPPAGE</var> pages are larger so fewer are needed. <var>TEMPPAGE</var> pages are 6184 bytes, with 6144 used to hold data and 40 bytes as page trailers. Divide the former <var>APSYPAGE</var> value by 1.5 before adding to <var>TEMPPAGE</var>. </p></li>
</ul>


[[Category:System parameters]]
[[Category:System parameters]]
[[Category:Parameters]]
[[Category:Parameters]]

Latest revision as of 00:17, 28 September 2016

APSYPAGE is obsolete as of 7.6

Summary

Default value
0
Parameter type
System
Where set
On User 0's parameter line
Related products
All
Introduced
Model 204 V5.1

Description

While the feature was available, the APSYPAGE parameter activated the APSY Precompiled Procedures in Storage feature by specifying a number of 4K-byte operating system pages.

For IBM z/OS systems only.

APSYPAGE was implemented to take advantage of the MVPG machine language instruction which moved an entire hardware page (4K bytes) with a single instruction and which, at the time, had significantly better performance than the stream-oriented moves used by standard APSY load. However, recent hardware models actually seem to have better performance for the stream-oriented moves.

Note: As of Model 204 7.5, it is recommended that customers who have been using the APSYPAGE parameter disable the APSYPAGE feature by setting APSYPAGE to 0.
As of Model 204 7.7, setting APSYPAGE to a non-zero value results in an error and prevents the Online from coming up.

Instead of APSYPAGE, you can use the following:

  • The RESPAGE parameter (recommended for performance).

    Set RESPAGE to the former value of APSYPAGE. Both RESPAGE and APSYPAGE specify the number of 4096-byte pages allocated for the respective feature.

  • The TEMPPAGE parameter.

    TEMPPAGE pages are larger so fewer are needed. TEMPPAGE pages are 6184 bytes, with 6144 used to hold data and 40 bytes as page trailers. Divide the former APSYPAGE value by 1.5 before adding to TEMPPAGE.