Parameters

BUFSIZE=

Specifies the length, in bytes, of the data portion of each JES3 buffer and of each record in the spool data sets. The value must be a multiple of four in the range from 1952 to 4084. If virtual storage in the JES3 global address space is not constrained, the recommended value is 4084. Otherwise, the recommended value is 2036. Buffers do not span page boundaries; therefore, specifying 2036 or less provides two buffers per page. Specifying a larger value provides one buffer per page. These recommended values optimize virtual storage usage but do not optimize spool usage. For further guidelines in helping you define the BUFFER parameter, see z/OS JES3 Initialization and Tuning Guide.

The number of buffers is computed at initialization and is based on the number of pages and buffer size specified on the PAGES and BUFSIZE parameters of this statement.

If you change the BUFSIZE parameter, you must cold start JES3 and reformat all of the spool data sets. For a discussion about how to format the spool data sets, see “Formatting Spool Data Sets” in z/OS JES3 Initialization and Tuning Guide .

Note: The maximum record size that can be written to SYSOUT in LINE mode is 60 bytes less than the defined buffer size. JES3 used approximately 60 bytes for spool control information.

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

PAGES=

Specifies the size of the primary allocation of JES3 buffers in the JES3 global address space, all JES3 local address spaces, and all C/I functional subsystem (FSS) address spaces, respectively. The maximum number of pages that you can define is 16,383 or 32,767, depending on the buffer size that you specify on the BUFSIZE parameter.

The total number of pages that you can specify must be between 16 and 32,767 inclusive, depending on the number of buffers per page.

If you specify a buffer size greater than 2036 bytes, the maximum number of pages that you can specify is 32,767.
If you specify a buffer size of 2036 or less, the maximum number of pages that you can specify is 16,383.

You specify the size of buffers on the BUFSIZE parameter. For guidelines to help you select a value for this parameter, see “Determining the Size of the JES3 Buffer Pool” in z/OS JES3 Initialization and Tuning Guide.

JES3 automatically expands the size of the JSAM buffer pool when it detects a buffer shortage. For each expansion, JES3 increases the size of the buffer pool by twice the value that you specify on this parameter, up to a maximum of 16 times or 32,767 JSAM buffer units, whichever occurs first. For additional information about determining the size of the JSAM buffer pool, see z/OS JES3 Initialization and Tuning Guide.

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 nearest number of records in a 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 to replace a spool data set (WR) and reformat all of the spool data sets. For a discussion about how to format the spool data sets, see “Formatting Spool Data Sets” in z/OS JES3 Initialization and Tuning Guide.

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

MINBUF=

Specifies the value that JES3 uses to calculate the acceptable minimum number of free JSAM buffers. The value you specify can be any decimal integer between 8 and 64, inclusive.

To calculate the acceptable minimum number of free JSAM buffers, JES3 divides the specified value into the total number of JSAM buffers. The total number of buffers includes the primary allocation of buffers as defined on the PAGES parameter plus all secondary buffer allocations. The quotient defines the acceptable minimum number. JES3 ignores the remainder. All secondary allocations of buffers must be exhausted before a minimal buffer condition exists.

When the number of free JSAM buffers is equal to or less than the acceptable minimum number, JES3 issues an action message. If the operator does not take corrective action, stop some converter interpreters, for example, JES3 may go into the wait state.

If JES3 encounters a minimum buffer condition frequently, increase the number of JSAM buffers during the next warm start or cold start. To increase the number of buffers, increase the value of the PAGES parameter on the BUFFER statement.

If the minimum buffer condition occurs for a C/I FSS address space, JES3 issues a warning message.

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 you specify a value of 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 marg 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. Otherwise, the operator can use JES3 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 you specify a value of 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, the operator need not take any action. Otherwise, the operator can use JES3 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. When a marginal spool space condition arises, job selection is suspended.

If you specify an integer greater than the maximum allowable, JES3 uses the parameter default. If you specify a negative integer or a non-numeric character, JES3 issues a message and terminates initialization.

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

TRUNC=

Specifies whether you want JES3 to truncate trailing blanks from all SYSOUT data that is produced in the complex.

YES: Indicates that you want JES3 to truncate trailing blanks from all SYSOUT.
NO: Indicates that you do not want JES3 to truncate trailing blanks from all SYSOUT.