SPCORE parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
 
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Template:SPCORE parameter subtitle}}
==Summary==
==Summary==
<dl>
<dl>
Line 10: Line 11:
<dd>All
<dd>All
<dt>Introduced
<dt>Introduced
<dd><var class="product">Model 204 V6.1</var> or earlier
<dd><var class="product">Model 204 V2.1</var> or earlier
</dl>
</dl>
==Description==
==Description==
<p>The minimum amount of storage to leave unallocated at the end of <var class="product">Model&nbsp;204</var> initialization</p>
<p>
<p>After initialization, <var class="product">Model&nbsp;204</var> uses for this spare core include: </p>
<var>SPCORE</var> specifies the minimum amount of storage to leave unallocated at the end of <var class="product">Model&nbsp;204</var> initialization. </p>
<p>
After initialization, <var class="product">Model&nbsp;204</var> uses for this spare core include: </p>
<ul>
<ul>
<li>
<li>Small control blocks when files are opened</li>
Small control blocks when files are opened</li>
<li>Output buffers for directed output ([[USE_command:_Directing_output|USE]]) data sets, [[Deferred_update_feature|deferred update]] data sets, or [[Storing_diagnostic_information_(CCASNAP)|CCASNAP]]</li>
<li>
<li>Host Language Interface IFAM1 or IFAM4 application program storage</li>
Output buffers for directed output (USE) data sets, deferred update data sets, or CCASNAP</li>
<li>[[Application_Subsystem_development|Application Subsystem]] control blocks</li>
<li>
<li>[[Allocating_and_directing_files_dynamically|Dynamically allocated]] files and printer control blocks</li>
Host Language Interface IFAM1 or IFAM4 application program storage</li>
<li>
Application Subsystem control blocks</li>
<li>
Dynamically allocated files and printer control blocks</li>
</ul>
</ul>
<p>SPCORE sets the minimum amount of reserved virtual storage. The actual amount of reserved storage available to you during the run is SPCORE bytes plus the number of region size bytes that are unallocated after <var class="product">Model&nbsp;204</var> initialization. This actual amount, which you can check with the VIEW command, is often considerably greater than the CCAIN SPCORE value you specified. </p>
<p>
<p>In z/OS, a number of bytes of virtual storage equal to your SPCORE setting is reserved above the line, and the same number is reserved below the line. </p>
<var>SPCORE</var> sets the minimum amount of reserved virtual storage. The actual amount of reserved storage available to you during the run is <var>SPCORE</var> bytes plus the number of [[Defining the runtime environment (CCAIN)#Calculating region size|region size]] bytes that are unallocated after <var class="product">Model&nbsp;204</var> initialization has completed. This actual amount, which you can check with the <var>[[VIEW command|VIEW]]</var> command, is often considerably greater than the CCAIN <var>SPCORE</var> value you specified. </p>
<p>You can use the STORCUR, STORINIT, and STORMAX <var class="product">Model&nbsp;204</var> parameters to help you determine your site's storage requirements. For more information about dynamic storage allocation tracking, see the <var>Model&nbsp;204 System Manager's Guide.</var></p>
<p>
<p><b>SPCORE for Application Subsystem control blocks</b></p>
In z/OS, a number of bytes of virtual storage equal to your <var>SPCORE</var> setting is reserved above the line, and the same number is reserved below the line. The BTB amount is ignored in Model 204 7.7 and higher if the <var>[[NUMBUFG parameter|NUMBUFG]]</var> parameter setting is greater than 0.</p>
<p>Control blocks are allocated from spare core for use by active subsystems. Use the following calculation to determine the number of bytes required for one subsystem, which can include Parallel Query Option/204 remote file subsystem members: </p>
<p>
<p class="code">228 + NRMTFILE + NFILES + (40 * SCLASSes) + NRMTLOCS
You can use the <var>[[STORCUR parameter|STORCUR]]</var>, <var>[[STORINIT parameter|STORINIT]]</var>, and <var>[[STORMAX parameter|STORMAX]]</var> <var class="product">Model&nbsp;204</var> parameters to help you determine your site's storage requirements. For more information about storage allocation, see [[Performance monitoring and tuning#Dynamic storage allocation tracking|Dynamic storage allocation tracking]].</p>
     + (93 * filemembers)
 
     + ((36 + (7 + SCLASSes) / 8) * (procedures + 1))
====SPCORE for Application Subsystem control blocks====
<p>
Control blocks are allocated from spare core for use by active [[Application Subsystem development|subsystems]]. Use the following calculation to determine the number of bytes required for one subsystem, which can include [[PQO: Overview of Parallel Query Option/204|Parallel Query Option/204]] remote file subsystem members: </p>
<p class="code">228 + NRMTFILE + NFILES + (40 * <i>SCLASSes</i>) + NRMTLOCS
     + (93 * <i>filemembers</i>)
     + ((36 + (7 + <i>SCLASSes</i>) / 8) * (<i>procedures</i> + 1))
     + 40 bytes for each stopped file or group
     + 40 bytes for each stopped file or group
</p>
</p>
<p>where: </p>
<p>
where: </p>
<ul>
<ul>
<li>
<li><var>[[NRMTFILE_parameter|NRMTFILE]]</var> and <var>[[NRMTLOCS_parameter|NRMTLOCS]]</var> are <var class="product">Model&nbsp;204</var> parameters.</li>
<var>NRMTFILE</var> and <var>NRMTLOCS</var> are <var class="product">Model&nbsp;204</var> parameters.</li>
 
<li>
<li><var class="term">filemembers</var> are the files that belong to the subsystem. </li>
filemembers are the files that belong to the subsystem. </li>
 
<li>
<li><var class="term">SCLASSes</var> is the number of subsystem user privilege classes.</li>
<var>SCLASSes</var> is the number of subsystem user privilege classes.</li>
 
<li>
<li>40 bytes for each stopped file or group is the number of bytes returned to spare core if the subsystem is stopped or the file or group is started. </li>
40 bytes for each stopped file or group is the number of bytes returned to spare core if the subsystem is stopped or the file or group is started. </li>
</ul>
</ul>
====SPCORE for VSAM clusters====
====SPCORE for VSAM clusters====
<p>External access to VSAM clusters increases the requirements for dynamically allocated storage available at execution time. The amount of such storage is controlled by SPCORE in the z/OS version of <var class="product">Model&nbsp;204</var>. z/VSE users can refer to the discussion of the SPCORE parameter in the Rocket <var class="product">Model&nbsp;204</var> System Manager's Guide for further information.</p>
<p>
<p>SPCORE size requirements for VSAM clusters depend on the following factors: </p>
External access to VSAM clusters increases the requirements for dynamically allocated storage available at execution time. The amount of such storage is controlled by <var>SPCORE</var> in the z/OS version of <var class="product">Model&nbsp;204</var>. z/VSE users can refer to the discussion of the <var>SPCORE</var> parameter in [[Accessing BSAM and VSAM files#VSAM I/O processing|VSAM I/O processing]] for further information.</p>
<p>
<var>SPCORE</var> size requirements for VSAM clusters depend on the following factors: </p>
<ul>
<ul>
<li>
<li>Where the VSAM access method modules are to be loaded. If they are not loaded in the public system area (LPA for z/OS, SVA for z/VSE), approximately 280K bytes are required to load the VSAM modules.</li>
Where the VSAM access method modules are to be loaded. If they are not loaded in the public system area (LPA for z/OS, SVA for z/VSE), approximately 280K bytes are required to load the VSAM modules.</li>
 
<li>
<li>The number of strings (<var>STRNO</var>) for each VSAM file and the <code>BUFFER SPACE</code> parameter defined in the VSAM cluster definition. The product of these parameters determines the amount of storage required for each open VSAM file. </li>
The number of strings (STRNO) for each VSAM file and the BUFFER SPACE parameter defined in the VSAM cluster definition. The product of these parameters determines the amount of storage required for each open VSAM file. </li>
</ul>
</ul>
<p>For information on external access to VSAM clusters, see "External file identification" in [[DEFINE DATASET command|DEFINE DATASET]]. </p>
<p>
For information on external access to VSAM clusters, see [[DEFINE DATASET command##External file identification|External file identification]]. </p>
 
====SPCORE for FLOD exits====
====SPCORE for FLOD exits====
<p>You must allocate additional working storage space to use the FLOD exit feature. Set the SPCORE parameter to allow 100 bytes per FLOD exit program. </p>
<p>
You must allocate additional working storage space to use the [[FLOD exits|FLOD exit]] feature. Set the <var>SPCORE</var> parameter to allow 100 bytes per FLOD exit program. </p>
 
====Calculating increase to SPCORE for MQ/204 statistics====
====Calculating increase to SPCORE for MQ/204 statistics====
<p>To calculate the additional bytes of SPCORE required to accommodate the MQ/204 statistics, use the following formula:</p>
<p>
To calculate the additional bytes of <var>SPCORE</var> required to accommodate the [[MQ/204 overview|MQ/204]] statistics, use the following formula:</p>
<p class="code">60 + (NUSERS * 120) = bytes of additional SPCORE required
<p class="code">60 + (NUSERS * 120) = bytes of additional SPCORE required
</p>
</p>
<p>The initial 60 bytes are required for the system statistics block (60 bytes for MQ/204 statistics). The 120 bytes for each user includes 60 bytes for the user statistics block and 60 bytes for the since-last statistics block for MQ/204 statistics.</p>
<p>
The initial 60 bytes are required for the system statistics block (60 bytes for MQ/204 statistics). The 120 bytes for each user includes 60 bytes for the user statistics block and 60 bytes for the since-last statistics block for MQ/204 statistics.</p>
 
[[Category:System parameters]]
[[Category:System parameters]]
[[Category:Parameters]]
[[Category:Parameters]]

Latest revision as of 14:37, 6 September 2017

Spare core reserved

Summary

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

Description

SPCORE specifies the minimum amount of storage to leave unallocated at the end of Model 204 initialization.

After initialization, Model 204 uses for this spare core include:

SPCORE sets the minimum amount of reserved virtual storage. The actual amount of reserved storage available to you during the run is SPCORE bytes plus the number of region size bytes that are unallocated after Model 204 initialization has completed. This actual amount, which you can check with the VIEW command, is often considerably greater than the CCAIN SPCORE value you specified.

In z/OS, a number of bytes of virtual storage equal to your SPCORE setting is reserved above the line, and the same number is reserved below the line. The BTB amount is ignored in Model 204 7.7 and higher if the NUMBUFG parameter setting is greater than 0.

You can use the STORCUR, STORINIT, and STORMAX Model 204 parameters to help you determine your site's storage requirements. For more information about storage allocation, see Dynamic storage allocation tracking.

SPCORE for Application Subsystem control blocks

Control blocks are allocated from spare core for use by active subsystems. Use the following calculation to determine the number of bytes required for one subsystem, which can include Parallel Query Option/204 remote file subsystem members:

228 + NRMTFILE + NFILES + (40 * SCLASSes) + NRMTLOCS + (93 * filemembers) + ((36 + (7 + SCLASSes) / 8) * (procedures + 1)) + 40 bytes for each stopped file or group

where:

  • NRMTFILE and NRMTLOCS are Model 204 parameters.
  • filemembers are the files that belong to the subsystem.
  • SCLASSes is the number of subsystem user privilege classes.
  • 40 bytes for each stopped file or group is the number of bytes returned to spare core if the subsystem is stopped or the file or group is started.

SPCORE for VSAM clusters

External access to VSAM clusters increases the requirements for dynamically allocated storage available at execution time. The amount of such storage is controlled by SPCORE in the z/OS version of Model 204. z/VSE users can refer to the discussion of the SPCORE parameter in VSAM I/O processing for further information.

SPCORE size requirements for VSAM clusters depend on the following factors:

  • Where the VSAM access method modules are to be loaded. If they are not loaded in the public system area (LPA for z/OS, SVA for z/VSE), approximately 280K bytes are required to load the VSAM modules.
  • The number of strings (STRNO) for each VSAM file and the BUFFER SPACE parameter defined in the VSAM cluster definition. The product of these parameters determines the amount of storage required for each open VSAM file.

For information on external access to VSAM clusters, see External file identification.

SPCORE for FLOD exits

You must allocate additional working storage space to use the FLOD exit feature. Set the SPCORE parameter to allow 100 bytes per FLOD exit program.

Calculating increase to SPCORE for MQ/204 statistics

To calculate the additional bytes of SPCORE required to accommodate the MQ/204 statistics, use the following formula:

60 + (NUSERS * 120) = bytes of additional SPCORE required

The initial 60 bytes are required for the system statistics block (60 bytes for MQ/204 statistics). The 120 bytes for each user includes 60 bytes for the user statistics block and 60 bytes for the since-last statistics block for MQ/204 statistics.