Requesting primary and migration volume information from the MCDS

Table 1 explains output labels when DFSMShsm lists information from the MCDS for primary and DASD migration volumes.

Table 1. Output labels when you request information from the MCDS for primary and DASD migration volumes
Printer Output Label (OUTDATASET or SYSOUT)	Terminal Label	Description
VOLSER	VOL	This field indicates the volume serial number of the primary or migration volume.
DEVICE TYPE	DEVTYP	This field indicates the name of the unit where this volume can be allocated.
VOLUME TYPE	VOLTYPE	Value Meaning PRIM The volume has been added as a primary volume. P SMS The volume is known as an SMS-managed volume. LEV 1 The volume has been added as a migration level 1 volume. L 1-OV The OVERFLOW subparameter has been specified on the ADDVOL command for the DASD migration level 1 volume. L2-AV The volume has been added as a DASD migration level 2 volume and is still available to be assigned a key range. L2-UN The volume has been added as a DASD migration level 2 volume and has already been assigned a key range. D The DRAIN attribute has been specified on the ADDVOL command for the DASD migration level 1 or level 2 volume. For example: LEV-1 D, L2-AV D, and L2-UN D.
THRESHOLD HI---LOW	HI-THRESH LO-THRESH	This field indicates the high and low threshold of occupancy defined for this volume. The low threshold of occupancy applies only to primary volumes. Values for SMS-managed volumes are from storage group attributes that DFSMShsm last retrieved from SMS and are not necessarily the most current values.
FRAG INDEX	FRAG	This field indicates the qualitative measure of the scattered free space on a volume. The values of the index can range from 0 to 1. The higher the value, the more fragmented the free space on the volume.
HOSTID AUTO- MIG	AUTO-HOST MIG	This field indicates the ID of the DFSMShsm host that assigned the primary volume attribute when making the volume eligible for automatic space management (ADDVOL command AUOTMIGRATION parameter). A value of NONE indicates that the primary volume attribute was not assigned by a DFSMShsm host. SMS-managed volumes and migration level 1 volumes are excluded and this field indicates "**" or "". This field applies to primary volumes only.
HOSTID AUTO- BACK	BACK	This field indicates the ID of the DFSMShsm host that assigned the primary volume attribute when making the volume eligible for automatic backup (ADDVOL command AUTOBACKUP parameter). A value of NONE indicates that the primary volume attribute was not added by a DFSMShsm host. SMS-managed volumes and migration level 1 volumes are excluded and this field indicates "**" or "". This field applies to primary volumes only.
HOSTID AUTO- DUMP	DUMP	This field indicates the ID of the DFSMShsm host that assigned the primary volume attribute when making the volume eligible for full-volume automatic dump (ADDVOL command AUTODUMP parameter). A value of NONE indicates that the primary volume attribute was not added by a DFSMShsm host. SMS-managed volumes are excluded and this field indicates "**" or "". This field applies to primary and migration level 1 volumes only.
AUTO RECL	AUTO-RECALL	A YES or Y indicates that the volume is eligible to receive data sets that have the primary volume attribute of automatic recall. This field applies only to DFSMShsm primary volumes. SMS-managed volumes are excluded with asterisks (*).
SDSP AVAIL	SDSP	YES or Y indicates the following: This volume contains a small-data-set-packing data set and This volume was ADDVOLed with the SDSP parameter and The SETSYS SMALLDATASETPACKING command was specified This field applies only to migration level 1 volumes.
MIN AGE	MIN-AGE	This field indicates the inactive age of the data set that most recently migrated from the volume during the last volume space management. SMS-managed volumes are excluded with asterisks (*).
MIGRATED DS--TRKS	MIGDS MIGTRKS	This is the number of data sets that has been migrated or deleted from the volume during the last volume space management. Tracks are not applicable for level 0 volumes and are excluded with asterisks (*). Both fields are only applicable for the last VOLUME request, not for a LEVEL request like secondary space management.
DATE---TIME LAST MIGRATED	MIGDATE-TIME	This is the date and time of the last migration from this volume if primary, or to this volume if Level 2 DASD. This field is invalid for Level 1 volumes.
SPACE-MGMT TYPE/AGE	SPACE-MGMT	This is the space management technique assigned to this volume. MIG indicates migration, DBA indicates data set deletion, and DBU indicates data set retirement. Values for SMS-managed volumes are from storage group attributes that DFSMShsm last retrieved from SMS and are not necessarily the most current values.
SPACE-MGMT TYPE/AGE	AGE	This field applies only to DFSMShsm primary volumes. SMS-managed volumes are excluded with asterisks (*). This is the number of days a data set on this volume must be inactive before it is eligible for the type of space management indicated under SPACE-MGMT. DEFAULT or DEF indicates that the age criteria is not specified for the volume in the ADDVOL command. In this case, the age criteria is the larger of SETSYS days value and integrity value, which is based on whether DFSMShsm is running in a single-DFSMShsm-host environment or in a multiple-DFSMShsm-host environment.
BUDEV CATGY	BACKUP-DEVICE- CATEGORY	This field indicates the backup device category, tape or DASD, assigned to this volume. If no category has been assigned, the field contains ANY. This field applies only to DFSMShsm primary volumes. SMS-managed volumes are excluded with asterisks (*).
DUMP CLASS	DUMPCLASS	This is the dump class of the primary or migration volume. Values for SMS-managed volumes are from storage group attributes that DFSMShsm last retrieved from SMS and are not necessarily the most current values.
A field containing only **** is not applicable to this volume (see individual field descriptions in the sample lists).

Figure 1 is a sample printer list of primary volumes when you specify the PRIMARYVOLUME and MIGRATIONCONTROLDATASET

Figure 1. Sample Printer List of Primary Volumes from the MCDS when You Specify PRIMARYVOLUME and MIGRATIONCONTROLDATASET

- DFSMSHSM CONTROL DATASET - PRIMARY VOLUME-MCDS--- LISTING ----- AT 12:40:59 ON 01/04/05 FOR SYSTEM=3090

VOLSER DEVICE VOLUME THRESHOLD FRAG  HOSTID AUTO     AUTO  SDSP  MIN  MIGRATED      DATE---TIME    SPACE-MGMT BUDEV DUMP
        TYPE   TYPE   HI--LOW  INDX  MIG--BACK-DUMP  RECL  ELIG  AGE  DS-----TRKS   LAST MIGRATED   TYPE/AGE  CATGY CLASS

PRIM01  3390  PRIM    100 ***  .000  1    NONE NONE   YES   ***  000  00001K ****** 01/04/02 00:00  MIG 001   ANY   ********
PRIM02  3390  PRIM    100 ***  .045  1    NONE NONE   YES   ***  000  00000K ****** 01/04/05 10:19  MIG 001   ANY   ********
SMS001  3390  P SMS   010 001  .000  **** **** ****   ***   ***  ***  00002K ****** 01/04/03 17:00  MIG ***   ****  ********
SMS002  3390  P SMS   010 001  .303  **** **** ****   ***   ***  ***  00001K ****** 01/04/03 17:05  MIG ***   ****  ********
SMS003  3390  P SMS   010 001  .114  **** **** ****   ***   ***  ***  00000K ****** 01/04/03 17:05  MIG ***   ****  ********
SMS004  3390  P SMS   010 001  .086  **** **** ****   ***   ***  ***  00000K ****** 01/04/03 17:06  MIG ***   ****  ********
----- END OF - PRIMARY VOLUME - LISTING -----

Figure 2 is a sample printer list of DASD migration level 1 volumes when you specify the MIGRATIONLEVEL1 and MIGRATIONCONTROLDATASET parameters. The format of the printer list for a specific primary or DASD migration volume, for all primary and DASD migration volumes, or for all primary volumes or all DASD migration volumes has the same format as that shown in Figure 1 and Figure 2. If you request information for more than one volume, the list has multiple entries.

Figure 2. Sample Printer List of Migration Volumes from the MCDS when You Specify MIGRATIONVOLUME and MIGRATIONCONTROLDATASET

1- DFSMSHSM CONTROL DATASET - MIGRATE VOLUME-MCDS--- LISTING ----- AT 14:09:45 ON 08/12/02 FOR SYSTEM=PCC                
                                                                                                                         
 VOLSER  DEVICE  VOLUME  THRESH  FRAG HOSTID AUTO-   AUTO SDSP MIN MIGRATED       DATE---TIME   SPACE-MGMT BUDEV DUMP    
          TYPE    TYPE  HI--LOW  INDX MIG--BACK-DUMP RECL ELIG AGE DS-----TRKS    LAST MIGRATED  TYPE/AGE  CATGY CLASS   
                                                                                                                         
 MIG101   3390   LEV 1   075 *** .018 **** **** 8     ***  YES *** 00115  009636  00/00/00 00:00  *** ***  ****  DUMPCLB 
 MIG102   3390   LEV 1   075 *** .012 **** **** 8     ***  NO  *** 00010  000125  00/00/00 00:00  *** ***  ****  DUMPCLC 
 MIG103   3390   LEV 1   075 *** .079 **** **** 8     ***  NO  *** 00005  000070  00/00/00 00:00  *** ***  ****  DUMPCLC  
 OVFML1   3390   L1-OV   080 *** .000 **** **** C     ***  NO  *** 00012  745930  00/00/00 00:00  *** ***  ****  DUMPCLB 

 ----- END OF - MIGRATE VOLUME - LISTING -----                                                                           
                                                                                                                         
1- DFSMSHSM CONTROL DATASET - MIGRATE VOLUME-MCDS--- LISTING ----- AT 14:09:54 ON 08/12/02 FOR SYSTEM=PCC

Figure 3 is a sample terminal list for a primary volume when you specify the VOLUME, MIGRATIONCONTROLDATASET, and TERMINAL parameters. The format of the terminal list for a specific primary volume or DASD migration volume or for all primary volumes or all DASD migration volumes has the same format as shown in Figure 3, except that the third line is not produced for migration level 1 volumes. If you request information for only one volume, the list has only one entry.

Figure 3. Sample Terminal List of a Volume from the MCDS when You Specify VOLUME, MIGRATIONCONTROLDATASET, and TERMINAL

  VOL=PRIM13  DEVTYP=3390     VOLTYPE=P SMS  MIGDS=0000  MIGTRKS=****

     MIGDATE-TIME=00/00/00 00:00  FRAG=.037  HI-THRESH=100  LO-THRESH=***
     MIN-AGE=***  BACKUP-DEVICE-CATEGORY=****  AUTO-RECALL=*
     SDSP=***  SPACE-MGMT=MIG  AGE=***  AUTO-HOST MIG=**  BACK=**  DUMP=**
     DUMPCLASS = DCLASS01 DCLASS02 DCLASS03 DCLASS04 DCLASS05

Table 2 explains the output labels when DFSMShsm lists information from the MCDS for tape migration level 2 volumes.

Table 2. Output labels when you request information from the MCDS for tape migration level 2 volumes
Printer Output Label (OUTDATASET or SYSOUT)	Terminal Label	Description
VOLSER	VOL	This field contains the volume serial number of the tape migration level 2 volume.
DEVICE TYPE	DEVTYP	This field contains the name of the unit where this volume can be allocated.
MIGRATE TYPE	MIGTYP	L2-TP: The tape volume has been added as a tape migration level 2 volume.
VOL FULL	VOL FULL	A YES or Y indicates that an end-of-tape marker is reached or a data-movement error occurs while DFSMShsm is writing on the tape volume.
DATE VOL LAST SP MANAGED	SP-MGT-DATE	This is the date that DBA/DBU was last performed on this volume.
VOL EMPTY	VOL EMPTY	A YES or Y indicates that the volume is empty.
DELETED DS	DELDS	This is the number of data sets that were deleted from the volume during the last volume space management.
PSWD	PSWD	A YES or Y indicates that the tape volume is password protected.
EXP	EXP	A YES or Y indicates that this tape volume is protected by an expiration date.
RACF	RACF	A YES or Y indicates that the tape volume is RACF® protected.
AVAILABLE	AVAIL	A YES or Y indicates that the tape volume is available. A NO or N normally results from a reply by an operator indicating that the tape will not be mounted.
IN USE	IN USE	Value Meaning NO The tape volume is not being used. MIGD Data set migration is using the tape volume. MIGV Volume migration is using the tape volume. RECL Recall is using the tape volume. RCYS The tape volume is a recycle source volume. RCYT The tape volume is a recycle target volume. DBAU Data set deletion or data set retirement is using the tape volume.
SELECTED	SELD	A YES or Y indicates that this volume is a target migration tape, is not marked full, and was the last tape selected for a migration function. Issue the QUERY MIGRATION command for each host to determine which DFSMShsm migration function has selected this volume.
IDRC	IDRC	Value Meaning Y Volume contains data in the Improved Data Recording Capability format. N Volume does not contain data in the Improved Data Recording Capability format. ** Volume is empty—not assigned the Improved Data Recording Capability format.
DUPLEX ALT	DUPLEX ALT	Value Meaning volser indicates the volume serial number of the duplexed alternate. PEND indicates that an exception condition occurred and an internal TAPECOPY is pending. NONE indicates that the volume was not created in a duplexing environment. Although an alternate copy may exist that was created by TAPECOPY, no duplex alternate exists. NA indicates that the original volumes are DASD rather than tape.
PCT FULL	PCT FULL	This field contains the percentage of the migration volume used for a tape written using 3590 architecture. A value of **** means the percentage is unknown.

Figure 4 is a sample printer list of tape migration level 2 volumes when you specify the MIGRATIONLEVEL2(TAPE) and MIGRATIONCONTROLDATASET parameters.

Figure 4. Sample Printer List of Tape Migration Level 2 Volumes when You Specify MIGRATIONLEVEL2(TAPE) and MIGRATIONCONTROLDATASET

 -- DFSMSHSM CONTROL DATASET - MIGRATE VOLUME-MCDS--- LISTING ----- AT 09:59:11 ON 01/04/05 FOR SYSTEM=3090

VOLSER DEVICE   VOLUME  THRESH FRAG HOSTID AUTO-   AUTO SDSP  MIN  MIGRATED       DATE---TIME   SPACE-MGMT BUDEV DUMP
        TYPE     TYPE  HI--LOW INDX MIG--BACK-DUMP RECL ELIG  AGE  DS-----TRKS    LAST MIGRATED  TYPE/AGE  CATGY CLASS

MIG101   3390   LEV 1  100 *** .000 **** **** NONE  ***  NO   ***  00000K 000012K 01/04/02 23:35  *** ***  ****  ********
MIG102   3390   LEV 1  100 *** .000 **** **** NONE  ***  NO   ***  00001K 000023K 01/04/02 23:47  *** ***  ****  ********
MIG103   3390   LEV 1  100 *** .000 **** **** NONE  ***  NO   ***  00001K 000004K 01/04/03 00:34  *** ***  ****  ********
----- END OF - MIGRATE VOLUME - LISTING -----

1- DFSMSHSM CONTROL DATASET - MIGRATE VOLUME-MCDS--- LISTING ----- AT 09:59:11 ON 01/04/05 FOR SYSTEM=3090

 VOLSER  DEVICE  MIGRATE  VOL   DATE VOL LAST VOL    DELETED  PSWD  EXP RACF AVAILABLE  IN USE SELECTED IDRC DUPLEX PCT
          TYPE    TYPE    FULL  SP MANAGED    EMPTY    DS                                                     ALT   FULL

 A00001   3480    L2-TP    NO     00/00/00     NO     0000    YES   NO   NO    YES       -NO-     NO     N   *NONE* ****
 A00005   3480    L2-TP    NO     00/00/00     NO     0000    YES   NO   NO    YES       -NO-     NO     N   *NONE* ****
 A00015   3480    L2-TP    NO     00/00/00     NO     0000    YES   NO   NO    YES       -NO-     NO     N   *NONE* ****

 A00016   3580    L2-TP    YES    00/00/00     NO     0000    YES   NO   NO    YES       -NO-     NO     N   *NONE* 34.8
 A00019   3580    L2-TP    NO     00/00/00     NO     0000    YES   NO   NO    YES       -NO-     NO     N   *NONE* ****
 A00021   3580    L2-TP    NO     00/00/00     NO     0000    YES   NO   NO    YES       -NO-     NO     N   *NONE*  100
 ----- END OF - MIGRATE VOLUME - LISTING -----