Function

To modify a spool volume.

Parameters

volser

The volume serial number of the spool volume. The first 4 or 5 characters must be identical to the 4-5 character prefix specified by the VOLUME= parameter on the SPOOLDEF initialization statement.

RESERVED=Yes | No

RESERVED=Yes marks the spool volume as reserved for special processing; no new allocations will be allowed. RESERVED=No clears the reserved attribute.

SPACE= (MAX | CYL,nnnn | TRK,nnnn)

Extends the existing spool volume data set on the specified volser. Free space must exist adjacent to the spool extent that is being extended. If you specify the SPACE parameter, one of the following operands must be specified:

MAX

Extends the spool volume data set to the largest size permitted by the free space adjacent to the current spool extent and by JES2 architecture limits.

CYL,nnnn

Extends the spool data set to the specified nnnn number of cylinders. Note that nnnn is the new, total size that is being requested for the SPOOL data set extent.

TRK,nnnn

Extends the spool data set to the specified nnnn number of tracks. Note that nnnn is the new, total size that is being requested for the SPOOL data set extent.

Note: Use a VTOC reporting utility, such as IEHLIST, to determine the layout and size of data sets on the volume in relation to the JES2 SPOOL data set extent.

Sysaff

JES2 associates the spool volume with the specified member(s). A member list can be a combination of the following keywords separated by commas.

ANY

This volume is associated with all members in the JES2 multi-access spool configuration.

+|-memname|*

The memnames (1 to 4 characters) to be added to (+) or deleted from (-) the current list of members that this volume is associated with. If neither + nor - is specified, the affinities of the volume is explicitly to the specified members. '*' specifies the member the command was issued on.

If affinity is not a criterion for job selection, you may specify a null parameter of (Sysaff=()). You must specify the empty parentheses.

Related Commands

To display jobs with more than a specified amount of spool space or space on specific spool volumes, use the $D JOBQ,SPOOL= command.

See also the $DSPL, $MSPL, $T SPOOL, $S SPOOL and $T SPOOLDEF commands.

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.

Scope

MAS-wide. This command has an effect across the entire MAS.

Context

HASCSCAN, HASPSTAB, HASPSXIT, and HASPSPOL.

Messages

The $HASP003 message indicates a syntax error.

The $HASP443 message indicates that specified spool volume has not been allocated.

The $HASP646 message displays the percentage of total spool space in the MAS that is in use.

The $HASP740 message indicates successful completion of the extension.

The $HASP741 message indicates an unsuccessful extend, and returns an error code.

The $HASP742 message indicates the data set could not be extended because the SPOOL volume is inactive.

The $HASP743 message indicates the data set could not be extended because the SPOOL volume is a MAPPED volume.

The $HASP744 message indicates the data set could not be extended because the SPOOL volume is in the wrong format.

The $HASP745 message indicates the data set could not be extended due to an internal error, and indicates a diagnostic code.

The $HASP893 message indicates that the command was accepted.

Examples

1.  1 
   $tspl(spool1),sysaff=-psu1
   
   $HASP893 VOLUME(SPOOL1) $HASP893 VOLUME(SPOOL1)
   STATUS=ACTIVE,SYSAFF=(),TGNUM=525, $HASP893
   TGINUSE=142,TRKPERTGB=1,PERCENT=27 
   $HASP646 43.3986 PERCENT SPOOL UTILIZATION 

   PSU1 will be removed from the list of members that this spool volume is associated with (if PSU1 was in the list).

2.  2  
   $tspl(spool3),sysaff=(ibm1,nih1)
   
   $HASP893 VOLUME(SPOOL3) $HASP893 VOLUME(SPOOL3)
   STATUS=ACTIVE,SYSAFF=(IBM1,NIH1), $HASP893
   TGNUM=60,TGINUSE=50,TRKPERTGB=1, $HASP893 PERCENT=83 
   $HASP646 43.3986 PERCENT SPOOL UTILIZATION 

   IBM1 and NIH1 will be added to the list of members that this spool volume is associated with.

3. $tspl(spool6),space=max
   
   $HASP893 VOLUME(SPOOL6)
   $HASP893 VOLUME(SPOOL6) STATUS=ACTIVE,AWAITING(EXTEND),
   $HASP893 COMMAND=(EXTEND),PERCENT=0
   $HASP646 30 PERCENT SPOOL UTILIZATION
   $HASP630 VOLUME SPOOL6 ACTIVE 0 PERCENT UTILIZATION
   $HASP740 Volume SPOOL6 Extend successful.    

   The spool volume SPOOL6 data set is expanded to the largest size permitted by the available disk space and JES2 architecture limits.

4. $tspl(spool6),space=(cyl,30)
   $HASP893 VOLUME(SPOOL6)
   $HASP893 VOLUME(SPOOL6) STATUS=ACTIVE,AWAITING(EXTEND),
   $HASP893 COMMAND=(EXTEND),PERCENT=57
   $HASP646 25 PERCENT SPOOL UTILIZATION
   $HASP630 VOLUME SPOOL6 ACTIVE 94 PERCENT UTILIZATION
   $HASP740 Volume SPOOL6 Extend successful.                  

   The spool volume SPOOL6 data set is expanded to 30 cylinders.