Parameters

NAME=

Specifies the 1-8 character name of the spool partition. You cannot specify DRAINED, UNAVAIL, DELETED, YES, NO or a partition name where the first character is a numeric.

DEF=

Specifies whether this is the default spool partition.

YES: Specifies that this is the default spool partition.
NO: Specifies that this is not the default spool partition.

If you do not specify the DEF parameter on any SPART statements, the partition defined on the first SPART statement in the initialization stream becomes the default partition.

If you have defined only one partition, that partition becomes the default, even if you have specified DEF=NO on the SPART statement.

If you specify DEF=YES on more than one SPART statement, the partition defined on the first statement that specifies DEF=YES becomes the default partition.

If you omit this parameter, JES3 uses DEF=NO for all partitions except the first; DEF=YES for the first or only partition.

If you specify an invalid subparameter, JES3 uses the parameter default.

INIT=

Specifies whether JES3 is to use this partition to write the initialization data needed for hot starts or local starts.

YES: Specifies that JES3 is to use this partition.
NO: Specifies that JES3 is not to use this partition.

If you omit INIT=YES from all SPART statements, JES3 writes the initialization data to the default spool partition.

If you specify INIT=YES on more than one SPART statement, JES3 writes the initialization data to the partition defined on the first SPART statement that specifies INIT=YES.

If you specify an invalid subparameter, JES3 uses the parameter default.

SPLIM=

Specifies the minimum and marginal percentages of spool space still available in active spool partitions. An active spool partition is one containing at least one spool data set. If the minimal or marginal percentages of spool space are reached, indicating that a spool partition is nearly full, JES3 issues action messages to the operator.

min

Specifies the percentage of total spool space in an active spool partition which, when that percentage is all that is still available, defines a minimum spool space condition. For example, if min specifies 10, a minimum spool space condition exists when 10% or less of the spool space in an active spool partition is still available.

The percentage of spool space defining this condition may be between 0 and 99. It must, however, be smaller than or equal to the percentage defining a marginal spool space condition (see the next subparameter).

When a spool partition reaches a minimum spool space condition, JES3 issues a message stating that this condition has occurred. The message alerts the operator to inquire whether the spool partition automatically overflows into another partition. If the spool partition does overflow, no operator action is required. If the spool partition is not defined to overflow into another partition, the operator can use operator commands to take appropriate actions. For information on actions to take, see “Balancing the Workload Across Partitions” in z/OS JES3 Initialization and Tuning Guide.

If a minimum spool space condition arises on the default spool partition, JES3 suspends all SYSOUT buffer processing. JES3 does not resume SYSOUT buffer processing until enough spool space is freed to reach a marginal spool space condition.

Always specify a minimum spool space percentage for the default spool partition so that enough spool space remains to perform a warm start. Otherwise, if JES3 requires a warm start and not enough spool space is available, you must perform a cold start.

marg

Specifies the percentage of total spool space in an active spool partition which, when that percentage is all that is still available, defines a marginal spool space condition. For example, if marg specifies 20, a marginal spool space condition exists when 20% or less of the spool space in an active spool partition is still available.

The percentage of spool space defining this condition may be between 0 and 99.

When a spool partition reaches a marginal spool space condition, JES3 issues a message stating that this condition has occurred. The message alerts the operator to inquire whether the spool partition automatically overflows into another partition. If the spool partition does overflow, no operator action is required. If the spool partition is not defined to overflow into another partition, the operator can use operator commands to take appropriate actions. For information on actions to take, see “Balancing the Workload Across Partitions” in z/OS JES3 Initialization and Tuning Guide.

If you specify an invalid subparameter, JES3 uses the parameter default.

OVRFL=

Indicates where, if anywhere, data for this spool partition may be put when this partition becomes full. If the spool partition defined by this SPART statement is the default partition, this parameter is ignored. For guidelines on choosing overflow partitions, see “Defining Spool Partition Overflow” in z/OS JES3 Initialization and Tuning Guide.

YES: Specifies that this spool partition may overflow only into the default spool partition.
NO: Specifies that this spool partition may not overflow into any other spool partition. Jobs requesting spool space in this partition when it is full will wait until space becomes available.
partitionname: Specifies the name of the spool partition into which this spool partition overflows.

If you specify an invalid subparameter, JES3 uses the parameter default.

GRPSZ=

Specifies the number of spool records in each track group. (The BUFSIZE parameter determines the size of each spool record.) The number must not be greater than 999. JES3 rounds the specified value up to the number of records in the nearest whole physical track for the selected spool device type. For guidelines to help you select a value for this parameter, see “Determining the Size of a Track Group” in z/OS JES3 Initialization and Tuning Guide.

If you change the group size parameter, you must perform a warm start. See z/OS JES3 Commands for information about how to replace a spool data set (WR).

If you omit this parameter, the default value is taken from the GRPSZ parameter of the BUFFER statement. If omitted from both statements, the default is 30.

If you specify an invalid subparameter, JES3 uses the parameter default.