|
Function To display the status and percent
utilization of a specified spool volume or all spool volumes.
Syntax
>>-$D----------------------------------------------------------->
>--+-SPL---+--+------------------------------------------------------+-->
'-SPOOL-' +-nn--+------------+-----------------------------------+
| '- ---+-mm-+-' |
| '-*--' |
+-'--volume--'-----------------------------------------+
| .-,------------------------------------------. |
| V | |
'-(----+-+-nn-+--+------------+-----------------+-+--)-'
| '-*--' '- ---+-mm-+-' |
| '-*--' |
'-+-volume-------+--+------------------+-'
+-'--volume--'-+ +- ---volume-------+
'-*------------' +- ---'--volume--'-+
'- -*--------------'
>--+---------------------------------+-------------------------->
'-| Selection limiting keywords |-'
>--+-------------------------------+---------------------------><
'-| Display limiting keywords |-'
Display limiting keywords
|--+----------+--+--------+--+------------+--+---------+-------->
'-,--ABSTR-' '-,--ALL-' '-,--COMMAND-' '-,--LONG-'
>--+--------------+--+------------+--+-------------+------------>
'-,--MAPTARGET-' '-,--MIGDATA-' '-,--MIGRATOR-'
>--+-------------+--+------------+--+----------+---------------->
'-,--MPERCENT-' '-,--PERCENT-' '-,--PHASE-'
>--+-------------+--+-----------+--+-----------+---------------->
'-,--RESERVED-' '-,--STATUS-' '-,--Sysaff-'
>--+-----------+--+------------+--+----------+------------------>
'-,--TARGET-' '-,--TGINUSE-' '-,--TGNUM-'
>--+--------------+--------------------------------------------->
'-,--TRKPERTGB-'
>--+------------------------------------------------+----------->
'-,--UNITDATA--+-------------------------------+-'
| .-,----------------. |
| V | |
'-=--( ---+-BASETRAK-----+-+--)-'
+-+-EXTent-+---+
| '-M------' |
+-Recmax-------+
+-TRKPERCYL----+
'-+-TRKrange-+-'
'-TTrange--'
>--+-----------+------------------------------------------------|
'-,--Volume-'
Selection limiting keywords
|--+--------------------------------------+--------------------->
'-,--+---+--MAPTARGET--+-=--+--+-Yes-+-'
'-/-' '-¬=-' '-No--'
>--+------------------------------------------------------+----->
'-,--MIGDATA--=--(--+-LARGEST_FREE--+-=--+--space-+--)-'
| +-¬=-+ |
| +->--+ |
| '-<--' |
'-SPACE_USED--+-=--+--space---'
+-¬=-+
+->--+
'-<--'
>--+-------------------------------------+---------------------->
'-,--+---+--MPERCENT--+-=--+--percent-'
'-/-' +-¬=-+
+->--+
'-<--'
>--+------------------------------------+----------------------->
'-,--+---+--PERCENT--+-=--+--percent-'
'-/-' +-¬=-+
+->--+
'-<--'
>--+------------------------------------+----------------------->
'-,--PHASE--+-=--+--+-PENDING------+-'
'-¬=-' +-INITIALIZING-+
+-SETUP--------+
+-COPY---------+
+-CATCHUP------+
+-CANCEL-------+
+-BACKOUT------+
'-CLEANUP------'
>--+-------------------------------------+---------------------->
'-,--+---+--RESERVED--+-=--+--+-Yes-+-'
'-/-' '-¬=-' '-No--'
>--+-----------------------------------------+------------------>
'-,--+---+--STATUS--+-=--+--+-ACTIVE----+-'
'-/-' '-¬=-' +-DRAINING--+
+-EXTENDING-+
+-MIGRATED--+
+-MAPPED----+
+-MIGRATING-+
+-INACTIVE--+
'-STARTING--'
>--+----------------------------------+------------------------->
'-,--+---+--Sysaff--+-=--+--sysaff-'
'-/-' '-¬=-'
>--+---------------------------+-------------------------------->
'-,--TARGET--+-=--+--target-'
'-¬=-'
>--+------------------------------------+----------------------->
'-,--+---+--TGINUSE--+-=--+--tginuse-'
'-/-' +-¬=-+
+->--+
'-<--'
>--+--------------------------------+--------------------------->
'-,--+---+--TGNUM--+-=--+--tgnum-'
'-/-' +-¬=-+
+->--+
'-<--'
>--+----------------------------------------+------------------->
'-,--+---+--TRKPERTGB--+-=--+--trkpertgb-'
'-/-' +-¬=-+
+->--+
'-<--'
>--+--------------------------------------------------------------------------+-->
| .-,---------------------------------------. |
| V | |
'-,--+---+--UNITDATA--=--( ---+-+-+---+--EXTent-+--+-=--+--extent---+-+--)-'
'-/-' | | '-/-' | +-¬=-+ |
| '-+---+--M------' +->--+ |
| '-/-' '-<--' |
+-+---+--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, SA32-0991.
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$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.
$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.
$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.
$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.
$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.
$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.
$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.
$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.
$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.
$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.
$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.
$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.
$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.
$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.
-
$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.
-
$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.
-
$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.
$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.
$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.
|