$T SPOOLDEF - Set the JES2 spooling environment

Function

To specify the JES2 spooling environment characteristics.

Parameters

FENCE=

The FENCE parameter displays how track groups for jobs will be assigned across spool volumes.

ACTIVE=YES|NO

Determines whether (YES) or not (NO) any fencing is active at the time.

VOLUMES=nnn

Is the number of volumes a job will be fenced to.

Scope: MAS-Wide.

CYL_MANAGED

Specifies whether MAS members can handle spool and checkpoint data set allocation on EAV cylinder managed storage. This allocation covers both new and old disposition. The default value is FAIL.

FAIL

By specifying CYL_MANAGED=FAIL, neither spool nor checkpoint data sets will be allocated in EAV cylinder managed space. FAIL will not be allowed if either:

• A spool or checkpoint data set currently resides in EAV storage, or
• A start spool command is pending.

ALLOWED

Specifying CYL_MANAGED=ALLOWED enables both spool and checkpoint data sets to be allocated in EAV cylinder managed space. Two preconditions must be met for ALLOWED:

1. All MAS members must be at JES2 z/OS v1R12.
2. LARGEDS must be set to allowed or always, not fail.

Note: Once CYL_MANAGED=ALLOWED is set, any MAS members at a release prior to JES2 z/OS V1R12 are not allowed to join the MAS. Even if CYL_MANAGED=FAIL is later set, members prior to JES2 z/OS v1R12 are not allowed. CYL_MANAGED=ALLOWED triggers additional exploitation of MQTRs, which are only compatible with JES2 z/OS V1R12.

Note: CYL_MANAGED keyword is removed when in z22 activation level. CYL_MANAGED=FAIL is not allowed when activating to z22 level (it must be CYL_MANAGED=ALLOWED).

Scope: MAS-Wide.

DSNMASK

Displays the 1-44 characters data set mask name, including generic characters. If the DSNAME parameter is specified with the $S SPOOL command, the DSNAME value must match either the $T SPOOLDEF DSNAME value or the $T SPOOLDEF DSNMASK value. If the $T SPOOLDEF DSNMASK value is null, the DSNAME value must match the $T SPOOL DSNAME value.

Scope: MAS-Wide.

LARGEDS=ALLOWED | ALWAYS

Specifies whether large SPOOL data sets (greater than 65,535 tracks) can be started or not. Also indicates when to use the new format SPOOL record addresses (MTTRs).

ALLOWED

Allows SPOOL data sets up to the current size limit (1,048,575 tracks). New format SPOOL addresses are used when starting a new volume that contains a large (greater than 65,535 tracks) SPOOL data set.

ALWAYS

Specifies the same processing is the same as the ALLOWED operand, except that new format SPOOL addresses are used when stating any volume, regardless of data set size. This setting is intended for testing applications that use SPOOL addresses to access records on SPOOL when an actual large data set is not available.

Note:

• Once LARGEDS is set to ALLOWED or ALWAYS, pre-z/OS release 7 JES2 members can never join the MAS until a COLD start is performed. IBM® recommends not setting LARGEDS to ALLOWED or ALWAYS until all MAS members have stabilized on a z/OS® release 7 level of JES2 or later.
• Even if LARGEDS is set to ALLOWED or ALWAYS, SPOOL volumes with more than 15 records per track (for example, when using buffer sizes less than 2943 on a 3390) cannot use the new format for SPOOL record addresses, thus do not support data sets larger than 65,535 tracks.

Scope: MAS-Wide.

GCRATE=NORMAL | FAST

Specifies the rate for a JES2 spool garbage collection cycle. During a cycle, JES2 examines the signature records for every allocated track group on non-inactive spool volumes. JES2 recovers track groups for jobs no longer in the system and writes a symptom record.

You can only set this parameter using a $T command.

Note: Using GCRATE=FAST will not ease most SPOOL-full situations when the SPOOL space is legitimately owned by existing jobs.

NORMAL

Specifies to pace the examination of track group so that JES2 completes a spool garbage collection cycle in about seven days

FAST

Specifies an accelerated cycle. JES2 does not perform pacing and does not wait between examining track groups. and NORMAL pace processing resumes after a FAST cycle completes.

Scope: MAS-Wide.

SPOOLNUM=nnn|32

Specifies the maximum number (1-253, rounded up to a multiple of 32 or 253) of spool volumes which can be defined at any one time to a multi-access spool complex. Spool volumes are defined by either use of the VOLUME= parameter on the initialization statement during a JES2 cold start, or they can be defined by using the $S SPL (start spool) operator command.

See z/OS JES2 Initialization and Tuning Reference for further information.

TGSIZE=nnnn

The default number (1-255) of JES2 buffers to be contained in a track group. JES2 uses this parameter to determine the size of a track group on a new spool volume being added to the complex.

Note:

1. Changing this parameter does not affect those volumes previously defined.
2. If TGSIZE is not the same on all members of the complex, the TGSIZE value that is used when starting a spool volume cannot be predicted.

Scope: Single Member.

TGSPACE=(MAX=nnnnnnnn)|(WARN=nnn)

MAX= specifies the maximum number (1-16,581,184) of track groups allowed. This number can only be increased by operator command. WARN= specifies the percentage (0-100) of track group usage. If the track group used is at or above this percentage, the operator is alerted by message $HASP050 JES2 RESOURCE SHORTAGE.

Scope: MAS-wide.

VOLUME=(volume | *)

If no generic characters are specified, volume specifies a 4 or 5-character prefix to be assigned to JES2 spool volumes; volume must be the first 4 or 5 characters of the existing prefix. If generic characters are specified, then all new spool volumes must match this 1-6 character pattern. The asterisk character (*) prefix permits any volume to be used for SPOOL.

Scope: MAS-Wide.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.

Processing Considerations

The $T SPOOLDEF command supports generic JES2 spool volume prefixes. Once altered from the current prefix format, a down-level member will not be able to start new SPOOL volumes. Volumes that are started on a z/OS 1.13 JES2 member are usable on the down-level member.

Scope

The scope of this command varies by parameter. See the description of each parameter for its scope.

The values supplied for some parameters on this command will be in effect across the entire MAS, while the values supplied for other parameters will be in effect for this member only.

Depending on your installation's setup, you might want the parameters for this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands for more information on using the ROUTE *ALL command.

Related Commands

$S SPOOL

Context

HASCSCAN, HASPSTAB, HASPSXIT, and HASPSPOL.

Messages

The $HASP844 message displays the current values of all the parameters on the SPOOLDEF initialization statement.

Examples

1.  1   $T SPOOLDEF,TGSPACE=(WARN=70),TGSIZE=20
   
   $HASP844 SPOOLDEF 
   $HASP844 SPOOLDEF BUFSIZE=3992,DSNAME=SYS1.HASPACE, 
   $HASP844 FENCE=(ACTIVE=NO,VOLUMES=1),GCRATE=NORMAL,
   $HASP844 LASTSVAL=(2005.082,03:57:33),LARGEDS=FAIL,
   $HASP844 SPOOLNUM=32,TGSIZE=20,TGSPACE=(MAX=16288, 
   $HASP844 DEFINED=1125,ACTIVE=1125,PERCENT=1.5111, 
   $HASP844 FREE=1108,WARN=70),TRKCELL=3,VOLUME=SPOOL

   Twenty JES2 buffers are used to determine the default size of a track group on a new spool volume. When 70 percent of the allocated track groups are in use, the $HASP050 message alerts the operator of a possible track group shortage.

2.  2   $tspooldef,fence=(active=yes,volumes=3)
   
   $HASP844 SPOOLDEF 
   $HASP844 SPOOLDEF BUFSIZE=3992,DSNAME=SYS1.HASPACE, 
   $HASP844 FENCE=(ACTIVE=YES,VOLUMES=3),GCRATE=NORMAL, 
   $HASP844 LASTSVAL=(2005.082,03:57:33),LARGEDS=FAIL, 
   $HASP844 SPOOLNUM=32,TGSIZE=20,TGSPACE=(MAX=16288, 
   $HASP844 DEFINED=1125,ACTIVE=1125,PERCENT=1.5111, 
   $HASP844 FREE=1108,WARN=70),TRKCELL=3,VOLUME=SPOOL

   Allows each job to use up to three SPOOL volumes and then fence the job to those three volumes.

3.  3   $t spooldef,cyl_managed=allowed 
   
   $HASP844 SPOOLDEF                                     
   $HASP844 SPOOLDEF  BUFSIZE=3768,DSNAME=SYS1.HASPACE,            
   $HASP844 FENCE=(ACTIVE=NO,VOLUMES=1),GCRATE=NORMAL,   
   $HASP844 LASTSVAL=(2009.024,18:58:49),LARGEDS=ALWAYS, 
   $HASP844 SPOOLNUM=128,TGSIZE=6,TGSPACE=(MAX=16288,    
   $HASP844 DEFINED=525,ACTIVE=525,PERCENT=2.8571,       
   $HASP844 FREE=510,WARN=80),CYL_MANAGED=ALLOWED

   Allows both JES2 spool and checkpoint data sets to be allocated in EAV cylinder managed space.

4.  4   $T SPOOLDEF,VOLUME=SP*
   
   $HASP844 SPOOLDEF 
   $HASP844 SPOOLDEF BUFSIZE=3992,DSNAME=SYS1.HASPACE, 
   $HASP844 FENCE=(ACTIVE=NO,VOLUMES=1),GCRATE=NORMAL, 
   $HASP844 LASTSVAL=(2005.082,03:57:33),LARGEDS=FAIL, 
   $HASP844 SPOOLNUM=32,TGSIZE=20,TGSPACE=(MAX=16288, 
   $HASP844 DEFINED=1125,ACTIVE=1125,PERCENT=1.5111, 
   $HASP844 FREE=1108,WARN=70),TRKCELL=3,VOLUME=SP*

   Sets SP* as the spool volume prefix.