Requesting a report of the volume statistics for all functions

You specify REPORT VOLUMES to get a report of the volume statistics for all volumes managed by DFSMShsm. You specify VOLUMES with a volume serial number to get a statistics report for a specific volume.

Note: REPORT VOLUMES shows only the last full-volume dump and full-volume restore of each source volume for each day. It will not show multiple dumps or restores of a given source volume on a given day. To find out the total number of full-volume dumps and full-volume restores on a given day, issue the REPORT DAILY command.

Table 1 contains the volume statistics report for all the functions.

Table 1. Headings of Output When You Request a Volume Statistics Report
Line Number Volume Statistics Output Heading Description
1

VOLUME STATISTICS REPORT
FOR VOLUME volser
FOR YY/MM/DD

 When you specify REPORT VOLUMES, this line contains today's date. When you specify REPORT VOLUMES FROMDATE(yyyy/mm,/dd) TODATE(yyyy/mm/dd), this line contains the first date you specify. DFSMShsm reports all volume statistics for the first date, then reports the volume statistics for the second day, and so forth. This line also shows the volume serial number of the volume whose statistics are being reported.
2 UNIT TYPE= unittype This field shows the type of unit where the volume is mounted.
Note: These fields will have ‘U’ to represent an L0 non-DFSMShsm volume.
2 HSM VOLUME TYPE= voltype This field shows the type of volume whose statistics are being reported. The types of volumes are: PRIMARY, ML1, ML2, DAILY, SPILL and BACKUP.
3 MIGRATED DATA SETS BY VOLUME REQUEST= xxxx This field shows how many data sets were processed during automatic and command volume migration.
3 DATA SET MIGRATIONS BY DATA SET REQUEST= xxxx This field shows how many data sets were processed by the DATASETNAME PARAMETER of the MIGRATE command.
3 DATA SETS ON VOLUME= xxxxx This field contains the number of non-VSAM data sets that DFSMShsm has processed. When DFSMShsm generates a report for primary volumes, this field contains N/A. This field also contains N/A for the summary reports.
4 MINIMUM AGE= xxx This field contains the age of the youngest data set that migrated from the volume the last time DFSMShsm did volume migration.
4 TOTAL TRACKS= xxxxxxxx This field shows the total number of allocated tracks on the volume as of the last free space check prior to the creation of this VSR.
4 FREE TRACKS= xxxxxxxx This field shows the total number of free tracks available for allocation for new data sets other than suballocated VSAM data sets. This value is accurate as of the last free space check prior to the creation of this VSR.
4 FRAGMENT INDEX= xxx This field shows the fragmentation index for the volume.
5 VOLUME DUMP= xxxxxxxx; This field shows the status of the volume dump. The status xxxxxxxx may be one of the following:
  • DONE
  • NOT DONE
  • FAILED
5 DUMP COPIES=xxx REQUESTED This field shows the number of dump copies requested.
5 FAILED=xxx This field shows the number of dump copies that failed.
Note: You get this version of line 3 only when you issue the command REPORT VOLUMES FUNCTION BACKUP.
6 VOLUME RESTORE= xxxxxxxx; This field shows the status of the volume restore. The status xxxxxxxxx may be one of the following:
  • DONE
  • NOT DONE
  • FAILED
6

DATASET RESTORES =
xxxxxx REQUESTED

 This field shows the number of data sets requested to be restored.
6 FAILED=xxxxxx This field shows the number of data sets that failed restoration.
Note: You get this version of line 6 only when you issue the command REPORT VOLUMES FUNCTION RECOVER.
7 DATA SET MIGRATIONS BY RECONNECTION=xxxxx This field shows the number of data sets reconnected.
7 NUMBER OF TRACKS RECONNECTED TO TAPE=xxxxx This field shows the number of tracks on level 0 volumes that were freed by reconnection.
8 FAST REPLICATION BACKUP=xxxxx REQUESTED, xxxxx FAILED This field shows the number of times that a fast replication backup was attempted for the volume and the number of failed attempts for that volume.
9 FAST REPLICATION RECOVER=xxxxx REQUESTED, xxxxx FAILED This field shows the number of times that a fast replication recovery was attempted for the volume and the number of failed attempts for that volume.
10 DATA SET CLASS TRANSITION=xxxxx REQUESTED, xxxxx FAILED This field shows the number of class transitions that were requested and how many of the class transitions failed.
11 and 12 HSM FUNCTION This field contains the names of the functions DFSMShsm processed. When you specify REPORT VOLUMES FUNCTION, DFSMShsm reports the volume statistics in the following order:
  1. MIGRATION

    The category SUBSEQUENT MIGS reflects all movement of data sets from ML1 to ML1, ML1 to ML2, and ML2 to ML2. This includes FREEVOL moves but does not include RECYCLE moves. The PRIMARY to LEVEL2 category includes data set migrations by reconnection.

  2. RECALL
  3. DELETE

    Deletion of migrated data sets include only those deleted by the DELETEBYAGE (DBA) or DELETEBACKEDUP (DBU) functions from migration volumes, generation data sets that have been rolled-off from migration volumes, and migrated data sets that have expired by date or MCLASS attributes.

    Deletion of primary data sets include only those deleted by the DELETEBYAGE (DBA) or DELETEBACKEDUP (DBU) functions, generation data sets that have been rolled-off from primary volumes, and primary data sets that have expired by date or MCLASS attributes.

    The DBA and DBU functions apply only to non-SMS data sets.

  4. BACKUP
    SUBSEQUENT BACKUP results from command backup, daily backup, FREEVOL processing and is the combined total of the following:
    • Data sets moved from backup volumes to spill volumes
    • Data sets moved from ML1 volumes to backup volumes
    DELETE BACKUP results from command backup, daily backup, BDELETE and EXPIREBV processing and is the combined total of the following:
    • Backup volumes deleted after DFSMShsm processes the EXPIREBV command
    • Deletion of excessive incremental backups
    • Data sets deleted after DFSMShsm processes the BDELETE command
  5. RECOVER
  6. RECYCLE
  7. CLASS TRANSITION

You can also choose to ask DFSMShsm to report statistics for specific DFSMShsm functions. For example, when you specify REPORT VOLUME FUNCTION RECOVER, DFSMShsm prints a volume statistics report of the number of data sets DFSMShsm recovered during the time period you specified.

Note: MIGRATION and RECALL statistics do not include amounts for extent reductions.
11 and 12 NUMBER DATASETS This field shows how many data sets DFSMShsm processed for each function.
11 and 12

-----READ-----
TRK/BLK   K-BYTES

 This field is not applicable.
11 and 12

----WRITTEN----
TRK/BLK   K-BYTES

 This field is not applicable.
11 and 12

----REQUESTS----
SYSTEM  USER  FAILED

 This field shows how many requests came from DFSMShsm during its automatic processing, how many came from the user, and how many of the total requests failed.
11 and 12 AVERAGE AGE This field contains the average age of the data sets that each function processed. For the MIGRATION and DELETE functions, this is the age of the average data set since it was last referred to. It is calculated by subtracting the date last referred to from the age of migration and dividing the result by the total amount of data sets processed. For the RECALL function, this age is how long the average data set has been migrated. For the BACKUP, SPILL, and RECOVER functions, this age is the last time DFSMShsm made a backup version of the data set. The average age does not apply to the RECYCLE function.
11 and 12

AVERAGE TIME
QUEUED  WAIT  PROCESS  TOTAL

 This field shows the average time in seconds that the request for each data set was waiting to be processed, the time spent allocating and opening each data set, and the time spent processing each data set. TOTAL shows the average time it took DFSMShsm to process each data set request.

If you specify the FROMDATE and TODATE parameters, DFSMShsm prints a summary of all the volume statistics after it prints the volume statistics for each day you specified. If you have requested statistics for specified functions, the report contains statistics for only those functions.

Figure 1 is a sample of a volume statistics report you get when you specify REPORT VOLUMES FUNCTION FROMDATE(2002/08/16) TODATE(2002/08/175). Therefore, you have the volume statistics for all volumes for each day and then you have a summary report for two days.

Figure 1. Sample Report of Volume Statistics by Function
--DFSMSHSM STATISTICS REPORT ------- AT 15:10:12 ON 2002/08/20 FOR SYSTEM=MVS4

VOLUME STATISTICS REPORT FOR VOLUME MIG410 FOR 02/08/16

UNIT TYPE = 3390    , HSM VOLUME TYPE = LEVEL 1
MIGRATED DATA SETS BY VOLUME REQUEST=000000, DATA SET MIGRATIONS BY DATA SET REQUEST=000045, DATA SETS PROCESSED=0000216
         MINIMUM AGE = 000, TOTAL TRACKS = 00056381, FREE TRACKS = 00057619, FRAGMENT INDEX = .021
VOLUME DUMP=  NOT DONE;  DUMP COPIES=000000  REQUESTED, FAILED=000000
VOLUME RESTORE=  NOT DONE;  DATASET RESTORES=000000  REQUESTED, FAILED=000000
DATA SET MIGRATIONS BY RECONNECTION = 000000 , NUMBER OF TRACKS RECONNECTED TO TAPE =00000000
FAST REPLICATION BACKUP = 00001 REQUESTED, 00000 FAILED
FAST REPLICATION RECOVER = 00000 REQUESTED, 00000 FAILED
DATA SET CLASS TRANSITION = 00000 REQUESTED, 00000 FAILED

                    NUMBER  ------READ--------  -----WRITTEN------  ------REQUESTS---- AVERAGE ------AVERAGE TIME-------
   HSM FUNCTION    DATASETS TRK/BLK    K-BYTES  TRK/BLK    K-BYTES  SYSTEM USER FAILED   AGE   QUEUED WAIT PROCESS TOTAL

MIGRATION
 PRIMARY - LEVEL 1 0000045  00000000 000000000  00006687 000279848  000000 00045 00000  00000  0005  00001  00001  00007
 SUBSEQUENT MIGS   0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
 PRIMARY - LEVEL 2 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
RECALL
 LEVEL 1 - PRIMARY 0000125  00018700 000782550  00000000 000000000  000000 00125 00000  00000  0000  00000  00002  00002
 LEVEL 2 - PRIMARY 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
DELETE
 MIGRATE DATA SETS 0000046  00006746 000279848  00000000 000000000  000000 00046 00000  00000  0000  00000  00000  00000
 PRIMARY DATA SETS 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
BACKUP
 DAILY BACKUP      0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
 SUBSEQUENT BACKUP 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
 DELETE BACKUPS    0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
RECOVER
 BACKUP - PRIMARY  0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
RECYCLE
 BACKUP - SPILL    0000000  00000000            00000000            000000 00000 00000  00000  0000  00000  00000  00000
 MIG L2 - MIG L2   0000000  00000000            00000000            000000 00000 00000  00000  0000  00000  00000  00000
CLASS TRANSITION                                                                                              
 PRIMARY - PRIMARY 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000


VOLUME STATISTICS REPORT FOR VOLUME MIG410 FOR 02/08/17

UNIT TYPE = 3390    , HSM VOLUME TYPE = LEVEL 1
MIGRATED DATA SETS BY VOLUME REQUEST=000000, DATA SET MIGRATIONS BY DATA SET REQUEST=000035, DATA SETS PROCESSED=0000155
         MINIMUM AGE = 000, TOTAL TRACKS = 00056749, FREE TRACKS = 00057251, FRAGMENT INDEX = .021
VOLUME DUMP=  NOT DONE;  DUMP COPIES=000000  REQUESTED, FAILED=000000
VOLUME RESTORE=  NOT DONE;  DATASET RESTORES=000000  REQUESTED, FAILED=000000
DATA SET MIGRATIONS BY RECONNECTION = 000000 , NUMBER OF TRACKS RECONNECTED TO TAPE =00000000
FAST REPLICATION BACKUP = 00001 REQUESTED, 00000 FAILED
FAST REPLICATION RECOVER = 00001 REQUESTED, 00000 FAILED
DATA SET CLASS TRANSITION = 00000 REQUESTED, 00000 FAILED

                    NUMBER  ------READ--------  -----WRITTEN------  ------REQUESTS---- AVERAGE ------AVERAGE TIME-------
   HSM FUNCTION    DATASETS TRK/BLK    K-BYTES  TRK/BLK    K-BYTES  SYSTEM USER FAILED   AGE   QUEUED WAIT PROCESS TOTAL

MIGRATION
 PRIMARY - LEVEL 1 0000035  00000000 000000000  00004959 000207462  000000 00035 00000  00000  0001  00001  00002  00004
 SUBSEQUENT MIGS   0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
 PRIMARY - LEVEL 2 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
RECALL
 LEVEL 1 - PRIMARY 0000085  00012716 000532134  00000000 000000000  000000 00085 00000  00000  0000  00000  00002  00002
 LEVEL 2 - PRIMARY 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
DELETE
 MIGRATE DATA SETS 0000035  00004959 000207462  00000000 000000000  000000 00035 00000  00000  0000  00000  00000  00000
 PRIMARY DATA SETS 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
BACKUP
 DAILY BACKUP      0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
 SUBSEQUENT BACKUP 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
 DELETE BACKUPS    0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
RECOVER
 BACKUP - PRIMARY  0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
RECYCLE
 BACKUP - SPILL    0000000  00000000            00000000            000000 00000 00000  00000  0000  00000  00000  00000
 MIG L2 - MIG L2   0000000  00000000            00000000            000000 00000 00000  00000  0000  00000  00000  00000
CLASS TRANSITION                                                                                              
 PRIMARY - PRIMARY 0000000  00000000 000000000  00000000 000000000  000000 00000 00000  00000  0000  00000  00000  00000
Parent topic: Using the REPORT command