$D SPOOL - Display the status of spool volumes

Function

To display the status and percent utilization of a specified spool volume or all spool volumes.

Syntax

Read syntax diagramSkip visual syntax diagram$D SPLSPOOL nn-mm*'volume'(,nn*-mm*volume'volume'*-volume-'volume'-*) Selection limiting keywordsDisplay limiting keywords
Display limiting keywords
Read syntax diagramSkip visual syntax diagram,ABSTR,ALL,COMMAND,LONG,MAPTARGET,MIGDATA,MIGRATOR,MPERCENT,PERCENT,PHASE,RESERVED,STATUS,Sysaff,TARGET,TGINUSE,TGNUM,TRKPERTGB,UNITDATA=( ,BASETRAKEXTentMRecmaxTRKPERCYLTRKrangeTTrange),Volume
Selection limiting keywords
Read syntax diagramSkip visual syntax diagram,/MAPTARGET=¬=YesNo,MIGDATA=(LARGEST_FREE=¬=><spaceSPACE_USED=¬=><space),/MPERCENT=¬=><percent,/PERCENT=¬=><percent,PHASE=¬=PENDINGINITIALIZINGSETUPCOPYCATCHUPCANCELBACKOUTCLEANUP,/RESERVED=¬=YesNo,/STATUS=¬=ACTIVEDRAININGEXTENDINGMIGRATEDMAPPEDMIGRATINGINACTIVESTARTING,/Sysaff=¬=sysaff,TARGET=¬=target,/TGINUSE=¬=><tginuse,/TGNUM=¬=><tgnum,/TRKPERTGB=¬=><trkpertgb,/UNITDATA=( ,/EXTent/M=¬=><extent/Recmax=¬=><recmax/TRKPERCYL=¬=><trkpercyl),/Volume=¬=><volume

Parameters

ABSTR
Displays the size and starting track for each SPOOL data set on this volume. In the event that a SPOOL data set has to be reallocated on another volume, this parameter provides the SPACE(ABSTR,size,start) values for the submitted JCL.
ALL
The $HASP893 message displays the status and percent utilization for each spool volume defined to JES2. The $HASP646 message then displays the total percent spool utilization for the complex of all active spool volumes.
Note: Because ALL automatically triggers a "long" display, you cannot add additional display-limiting parameters on this command; however, you can add selection-limiting parameters.
AWAITING
Lists any spool volumes whose unavailability is preventing this spool volume from draining, most likely because jobs which have space on that volume cannot purge.
COMMAND
Displays any commands which are outstanding on this spool volume (START, DRAIN, HALT, FORMAT).
LONG
Displays additional information on the $HASP893 message.
Note: Because LONG automatically triggers a "long" display, you cannot add additional display-limiting parameters on this command; however, you can add selection-limiting parameters.
MAPTARGET=Yes | No
Indicates if the volume is the target of a MAPPED spool volume. Yes indicates the volume is the target of a MAPPED volume. No indicates the volume is not the target of a MAPPED volume.
MIGDATA=([LARGEST_FREE | SPACE_USED])
On a per spool volume basis, displays the largest contiguous free space or the highest used location. The unit of measurement is tracks.
Note: To track the progress of a spool migration, JES2 stores internal structures on the target spool volume. To determine the total free space that is required on the target spool volume for the migration, the size of these internal structures (approximately four tracks) must be added to the value displayed by the MIGDATA=SPACE_USED parameter on the source volume.
MIGRATOR
Displays the name of the JES2 MAS member that is performing the migration of a MIGRATING spool volume.
MPERCENT
Displays the percentage of the migration that has completed.
PERCENT=percent
Displays the percentage of this spool volume that is utilized.
PHASE
Filters the migrating volumes by current phase:
PENDING
The spool volume has been scheduled for migration and is awaiting the start of migration.
INITIALIZING
The migration environment is initializing.
SETUP
Setup for a migration is processing.
COPY
The dataset on the source spool volume is being migrated to the target spool volume.
CATCHUP
Tracks that were changed by runtime operations during the COPY phase are being recopied.
CANCEL
Migrator subtasks are being cleaned up due to an operator canceling an active migration or the migration process detecting an error.
BACKOUT
Updates are being backed out due to an operator canceling an active migration or the migration process detecting an error.
CLEANUP
General cleanup at the end of migration is processing.
RESERVED
Indicates if the spool volume is selectable and not allocatable. Yes indicates the spool volume is reserved. No indicates the spool volume is not reserved.
STATUS=[ACTIVE | DRAINING | EXTENDING | HALTING | INACTIVE | MAPPED | MIGRATING | STARTING]
Displays the status of the spool volume.
ACTIVE
The spool volume is in use. Allocation and deallocation of spool space are permitted.
DRAINING
The spool volume is transitioning to a DRAINED state.
EXTENDING
The spool volume is currently being extended in size.
HALTING
The spool volume is transitioning to an INACTIVE state.
INACTIVE
The spool volume has been started and can contain allocated tracks. You cannot further allocate or process the allocated tracks.
MAPPED
The spool volume has been migrated and the corresponding data set is eligible for deletion.
Note: The spool volume extent number will persist until all jobs and SYSOUT that have space on the volume have been purged.
MIGRATING
The spool volume is a source of an active migration. The associated target volume is also displayed.
STARTING
The spool volume has been started but has not fully initialized yet.
SYSAFF=sysaff
Displays the spool volume(s) associated with the specified member(s).
TGINUSE=tginuse
Displays the number of track groups in use on this spool volume.
TGNUM=tgnum
Displays the total number of track groups (either in use or free) on this spool volume.
TRKPERTGB=trkpertgb
Displays the number of tracks in each track group on this spool volume.
UNITDATA=[BASETRAK|EXTent|M|Recmax|TRKPERCYL]
Displays extended information about the spool volume.
BASETRAK=
Displays the base rack address if relative addressing is in use for this volume.
EXTent|M
The extent number (in hex) that JES2 has assigned this volume.
TRKrange|TTrange
The range of tracks on this volume that the spool data set occupies.
Recmax
The maximum record number within a track that JES2 will use.
TRKPERCYL
The number of tracks per cylinder on the spool device.
Volume=volser
Only volumes matching the specified volser will be displayed.

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 $MSPL, $T SPOOL, $S SPOOL, $T SPOOLDEF commands.

Authority Required

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

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

Processing Considerations

The $D SPOOL command displays active migrations and provides filtering capability.

Scope

MAS-wide. This command displays information about the entire MAS.

Context

HASCSCAN, HASPSTAB, HASPSXIT, and HASPSPOL.

Messages

The $HASP893 message displays information about individual spool volumes.

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

Examples

  1. $d spl
    
    $HASP893 VOLUME(SPOOL1)  STATUS=ACTIVE,PERCENT=84
    $HASP893 VOLUME(SPOOL2)  STATUS=ACTIVE,PERCENT=92
    $HASP646 88.1904 PERCENT SPOOL UTILIZATION

    The total utilization of all spool volumes is displayed, as well as the status and total utilization of each individual spool volume.

  2. $dspl(spool1)
    
    $HASP893 VOLUME(SPOOL1)  STATUS=ACTIVE,PERCENT=84
    $HASP646 88.1904 PERCENT SPOOL UTILIZATION

    The total utilization of all spool volumes is displayed, as well as the status and total utilization of spool volume SPOOL1.

  3. $dspl(spool1),long
    
    $HASP893 VOLUME(SPOOL1)
    $HASP893 VOLUME(SPOOL1)  STATUS=ACTIVE,SYSAFF=(ANY),TGNUM=525
    $HASP893 TGINUSE=141,TRKPERTGB=1,PERCENT=26,RESERVED=Yes,MAPTARGET=Yes
    $HASP646 88.1904 PERCENT SPOOL UTILIZATION

    The total utilization of all spool volumes is displayed, as well as the status, the list of member(s) the spool volume is associated with, total utilization, and track group information about spool volume SPOOL1.

  4. $dspl(*),unitdata
    
    $HASP893 VOLUME(SPOOL1)                            
    $HASP893 VOLUME(SPOOL1)  UNITDATA=(EXTENT=00,TRKRANGE=(0087, 
    $HASP893                 0293),RECMAX=12,TRKPERCYL=15)       
    $HASP893 VOLUME(SPOOL2)                            
    $HASP893 VOLUME(SPOOL2)  UNITDATA=(EXTENT=01,TRKRANGE=(0001, 
    $HASP893                 001E),BASETRAK=00000E,RECMAX=10,    
    $HASP893                 TRKPERCYL=15)                       
    $HASP646 2.5225 PERCENT SPOOL UTILIZATION

    Unit-specific information about spool volumes SPOOL1 and SPOOL2 is displayed. Note that SPOOL1 is using absolute addressing and SPOOL2 is using relative addressing.

  5. $dspl,sysaff
    
    $HASP893 VOLUME(SPOOL1) SYSAFF=(ANY)
    $HASP893 VOLUME(SPOOL2) SYSAFF=(PSU1)
    $HASP893 VOLUME(SPOOL3) SYSAFF=(ANY)
    $HASP893 VOLUME(SPOOL4) SYSAFF=()
    $HASP893 VOLUME(SPOOL5) SYSAFF=(PSU1,IBM1,NIH1)
    $HASP646 43.2679 PERCENT SPOOL UTILIZATION

    The member(s) with which all spool volumes are associated is displayed.

  6. $D SPOOL,MIGDATA
    
    $HASP893 VOLUME (SPOL1) 
    $HASP893 VOLUME (SPOL1) MIGDATA=(SPACE_USED=40000,LARGEST_FREE=10000)  
    $HASP893 VOLUME (SPOL2) 
    $HASP893 VOLUME (SPOL2) MIGDATA=(SPACE_USED=20000,LARGEST_FREE=10000)
    $HASP646 43.2679 PERCENT SPOOL UTILIZATION

    The largest contiguous free space for each spool volume, with highest location used in tracks, is displayed.

  7. $D SPOOL,MIGDATA=LARGEST_FREE
    
    $HASP893 VOLUME (SPOL1)
    $HASP893 VOLUME (SPOL1) MIGDATA=(LARGEST_FREE=10000)  
    $HASP893 VOLUME (SPOL2) 
    $HASP893 VOLUME (SPOL2) MIGDATA=(LARGEST_FREE=20000) 
    $HASP646 43.2679 PERCENT SPOOL UTILIZATION

    The largest contiguous free space for all spool volumes is displayed.

  8. $D SPOOL(SPOL2),MIGDATA=LARGEST_FREE
    
    $HASP893 VOLUME (SPOL2) 
    $HASP893 VOLUME (SPOL2) MIGDATA=(LARGEST_FREE=10000) 
    $HASP646 43.2679 PERCENT SPOOL UTILIZATION

    The largest contiguous free space for spool SPOL2 is displayed.

  9. $D SPOOL,MIGDATA=LARGEST_FREE>3000,MIGDATA 
    
    $HASP893 VOLUME (SPOL2) 
    $HASP893 VOLUME (SPOL2) MIGDATA=(LARGEST_FREE=4000)  
    $HASP893 VOLUME (SPOL5) 
    $HASP893 VOLUME (SPOL5) MIGDATA=(LARGEST_FREE=7000)
    $HASP646 43.2679 PERCENT SPOOL UTILIZATION

    All volumes having contiguous free space greater than 3000 tracks are displayed.

  10. $D SPOOL,TARGET=SPOL10,TARGET
    
    $HASP893 VOLUME(SPOL1) TARGET=SPOL10
    $HASP893 VOLUME(SPOL3) TARGET=SPOL10 
    $HASP646 80.0000 PERCENT SPOOL UTILIZATION
    All spool volumes that have spool SPOL10 as a target are displayed. This includes both migrating and mapped source spool volumes.
    Note: The $HASP646 message displays the percentage of total spool space in use within the MAS.
  11. $D SPOOL, TARGET^=' ‘,TARGET
    
    $HASP893 VOLUME(SPOL1) TARGET=SPOL10 
    $HASP893 VOLUME(SPOL3) TARGET=SPOL10
    $HASP893 VOLUME(SPOL4) TARGET=SPOL11 
    $HASP893 VOLUME(SPOL5) TARGET=SPOL12
    $HASP646 80.0000 PERCENT SPOOL UTILIZATION

    All spool volumes that have target spool volumes are displayed.

  12. $D SPOOL(SPOL1,SPOL2,SPOL3),TARGET=SPOL10,TARGET 
    
    $HASP893 VOLUME(SPOL1) TARGET=SPOL10 
    $HASP893 VOLUME(SPOL3) TARGET=SPOL10   
    $HASP646 80.0000 PERCENT SPOOL UTILIZATION

    Any of the specified spool volumes that have spool volume SPOL10 as a target are displayed.

  13. $DSPL,RESERVED=YES
    
    $HASP893 VOLUME(SPOOL2) STATUS=ACTIVE,PERCENT=20,RESERVED=YES
    $HASP893 VOLUME(SPOOL3) STATUS=ACTIVE,PERCENT=40,RESERVED=YES
    $HASP646 30.0000 PERCENT SPOOL UTILIZATION 
    All spool volumes that are currently RESERVED are displayed.
    Note: The percentage value shown in $HASP646 is spool utilization.
  14. $DSPL,STATUS=EXTENDING,STATUS
    
    $HASP893 VOLUME(SPOOL2) STATUS=EXTENDING,AWAITING(IBM1)
    $HASP893 VOLUME(SPOOL3) STATUS=EXTENDING,AWAITING(IBM1)
    $HASP893 VOLUME(SPOOL5) STATUS=EXTENDING,AWAITING(IBM1)
    $HASP646 70.0000 PERCENT SPOOL UTILIZATION

    All volumes currently being extended are displayed.

  15. $DSPL
    
    $HASP893 VOLUME(SPOOL1) STATUS=ACTIVE,PERCENT=4
    $HASP893 VOLUME(SPOOL2) STATUS=MIGRATING-MOVE,AWAITING(IBM1),
    $HASP893 PERCENT=0,RESERVED=YES 
    $HASP893 VOLUME(SPOOL3) STATUS=MIGRATING-MERGE,AWAITING(MIGRATION),PERCENT=0
    $HASP893 VOLUME(SPOOL4) STATUS=MIGRATING-MERGE,AWAITING(MIGRATION),PERCENT=0
    $HASP646 50 PERCENT SPOOL UTILIZATION

    All spool volumes and states are displayed.

  16. $DSPL,STATUS=MIGRATING,MPERCENT<50,STATUS,PHASE,MPERCENT
    
    $HASP893 VOLUME(SPOOL2) STATUS=MIGRATING-MOVE,AWAITING(IBM1),
    $HASP893 PHASE=SETUP,MPERCENT=0
    $HASP893 VOLUME(SPOOL3) STATUS=MIGRATING-MERGE,AWAITING(MIGRATION),
    $HASP893 PHASE=PENDING,MPERCENT=0
    $HASP893 VOLUME(SPOOL4) STATUS=MIGRATING-MERGE,AWAITING(MIGRATION),
    $HASP893 PHASE=PENDING,MPERCENT=0
    $HASP646 30 PERCENT SPOOL UTILIZATION

    All migrating spool volumes that are less than 50% complete, and their current execution phases, are displayed.

  17. $D SPOOL,STATUS=MIGRATING,STATUS,PHASE=CLEANUP,PHASE 
    
    $HASP893 VOLUME(SPOL8)  STATUS=MIGRATING-MERGE,TARGET=SPOL2,PHASE=CLEANUP 
    $HASP893 VOLUME(SPOL7)  STATUS=MIGRATING-MERGE,TARGET=SPOL4,PHASE=CLEANUP 
    $HASP646 75.0000 PERCENT SPOOL UTILIZATION 

    All migrating spool volumes that are currently in the cleanup phase are displayed.

  18. $D SPOOL(SPOL1,SPOL2,SPOL7,SPOL8),STATUS=MIGRATING
    
    $HASP893 VOLUME(SPOL7)  STATUS=MIGRATING-MOVE,TARGET=SPOL2
    $HASP893 VOLUME(SPOL8)  STATUS=MIGRATING-MOVE,TARGET=SPOL2
    $HASP646 75.0000 PERCENT SPOOL UTILIZATION

    Any of the specified spool volumes that are currently migrating are displayed.

  19. $DSPL,MIGRATOR,PHASE,STATUS 
    $HASP893 VOLUME(J2WRK1)  STATUS=ACTIVE
    $HASP893 VOLUME(J2WRK3)
    $HASP893 VOLUME(J2WRK3)  PHASE=PENDING,
    $HASP893                 STATUS=MIGRATING-MERGE,AWAITING(MIGRATION)
    $HASP893 VOLUME(J2WRK2)
    $HASP893 VOLUME(J2WRK2)  PHASE=PENDING,
    $HASP893                 STATUS=MIGRATING-MERGE,AWAITING(MIGRATION)
    $HASP893 VOLUME(J2WRKD)
    $HASP893 VOLUME(J2WRKD)  MIGRATOR=N2M1,PHASE=COPY,
    $HASP893                 STATUS=MIGRATING-MERGE,AWAITING(N2M2)
    $HASP893 VOLUME(J2WRKF)  STATUS=ACTIVE
    $HASP646 42.4749 PERCENT SPOOL UTILIZATION              

    Shows the Migrator, Phase of spool migration, and status of all spool volumes. Note that Migrator and Phase are only displayed for SPOOL volumes that are the Source spool volume of a spool migration. The display for J2WRKD indicates that MAS member N2M1 is the Migrator responsible for the spool migration, using J2WRKD as a Source spool volume. The display also indicates that the migrator N2M1 is waiting on MAS member N2M2 to finish its portion of the migration process before the migration can be completed. Run the $D MEMBER command on any member that a spool migration is waiting on to determine the state of that member. If that member is hot-startable, the spool migration will not complete until that member is started.

    For more information on spool migration, refer to Migrating spool volumes and $MSPL - Migrate spool volumes.