|
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--=--nnnnnnnn-'
>--+--------------------------------------------------------+--><
'-,--VOLUME--=--(--+-volume-+--+--------------------+--)-'
'-*------' '-,--VOLUME--=--nnnn-'
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.
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 | FAIL
- 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.
- FAIL
- Fails any attempt to start a SPOOL data set with more than 65,535
tracks. The FAIL operand can only be specified
if there are no large spool data sets defined in JES2. This setting
is not valid in z11 mode. The FAIL operand cannot be specified if CYL_MANAGED=ALLOWED is specified.
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, SA32-0992 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=nn)
- 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 threshold of track group usage that
triggers message $HASP050 JES2 RESOURCE SHORTAGE. The WARN= percentage
is calculated only from spool volumes that are active and can have
space allocated (ACTIVE and RESERVED=NO).
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.
- VOLUME=nnnn
- Specifies the 4–character prefix assigned to JES2 spool volumes.
It must be the first four characters of the existing prefix.
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, SA32-0991.
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, SA38-0666 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 $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 $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 $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.
|