$T SPOOLDEF - Set the JES2 spooling environment
Function
To specify the JES2 spooling environment characteristics.
Syntax
>>-$T--SPOOLDEF-------------------------------------------------> >--+-----------------------------------------------+------------> | .-,----------------------. | | V | | '-,--FENCE--=--(----+-Active--=--+-Yes-+-+-+--)-' | '-No--' | '-VOLUMES--=--nnn----' >--+------------+--+--------------------------------+-----------> '-,--DSNMASK-' | .-FAIL----. | '-,--CYL_MANAGED--=--+-ALLOWED-+-' >--+----------------------------+-------------------------------> '-,--LARGEDS--=--+-ALLOWED-+-' +-ALWAYS--+ '-FAIL----' >--+--------------------------+--+---------------------+--------> | .-NORMAL-. | '-,--SPOOLNUM--=--nnn-' '-,--GCRATE--=--+-FAST---+-' >--+--------------------+---------------------------------------> '-,--TGSIZE--=--nnnn-' >--+-----------------------------------------------+------------> | .-,--------------------. | | V | | '-,--TGSPACE--=--(----+-MAX--=--nnnnnnnn-+-+--)-' '-WARN--=--nnn-----' >--+--------------------------------+-------------------------->< '-,--VOLUME--=--(--+-volume-+--)-' '-*------'
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:
- All MAS members must be at JES2 z/OS v1R12.
- 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:
- Changing this parameter does not affect those volumes previously defined.
- 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
-
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.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
-
Allows each job to use up to three SPOOL volumes and then fence the job to those three volumes.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
-
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 $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.