Object Tape Volume Status

For an object tape volume, the following information is displayed:

CBR1240I  OAM object tape volume status
VOLUME  STORAGE RD  WR  CM  IN   MED  FREE-SPACE        %  FULL LOST  REQ
        GROUP               USE  TYPE                  FULL     FLAG  CT

volser  sgname   a   b   c   d   ee   ffffffffff{K|M}   gg   h   i     jjj
Volume is WORM tape.
Volume is logical WORM.
XCF MEMBER NAME: member-name
BACKUP TYPE: {BACKUP1 | BACKUP2} 
CAPACITY:          capacity{K|M}  UNITNAME:          unitname
ERDS PHYSICAL ID:  epi
CREATION DATE:     createdate   EXPIRATION DATE:   expdate
LAST MOUNTED DATE: lmdate       LAST WRITTEN DATE: lwdate
DATACLASS:  dataclass           SUBLEVEL:          sublevel

The fields displayed in each data line are as follows:

volser

Volume serial number of the requested tape volume.

sgname

Name of the Object storage group or Object Backup storage group to which the tape volume belongs.

a

Tape volume readability status:

Y: Readable
N: Unreadable

b

Tape volume writability status:

Y: Writable
N: Unwritable

c

Compaction indicator for this tape volume:

Y: Tape volume written in compacted format.
N: Tape volume written in noncompacted format.

d

Tape volume in use indicator for this tape volume:

Y: Tape volume currently in use by an OAM drive task.
N: Tape volume not currently in use by an OAM drive task.

ee

Media type of the requested tape volume:

02: IBM Cartridge System Tape
04: IBM Enhanced Capacity Cartridge System Tape
05: IBM High Performance Cartridge System Tape
06: IBM Extended High Performance Cartridge System Tape
07: IBM Enterprise Tape Cartridge
08: IBM Enterprise WORM Tape Cartridge
09: IBM Enterprise Economy Tape Cartridge
10: IBM Enterprise Economy WORM Tape Cartridge
12: IBM Enterprise Extended Tape Cartridge
14: IBM Enterprise Extended WORM Tape Cartridge
16: IBM Enterprise Advanced Tape Cartridge
17: IBM Enterprise Advanced WORM Tape Cartridge
18: IBM Enterprise Advanced Economy Tape Cartridge

ffffffffff{K|M}

Remaining space on the requested tape volume in kilobytes (KB). If ffffffffff is followed by a 'K' then ffffffffff is in KB and the amount of KB is less than 2GB. If ffffffffff is followed by an 'M' then the freespace shown is in MB because the amount of KB is equal to or greater than 2GB.

gg

Percentage that the requested tape volume is full (percentage of the tape that has been used).

h

Volume full indicator:

Y: Volume is marked full.
N: Volume is not marked full.
P: Volume is marked permanently full.
When a volume is marked Y or N, OAM initialization will reevaluate this volume's full status based on the calculation of free space and percent valid. When a volume is marked P, it will remain P during the OAM initialization.

i

Volume lost indicator:

Y: Volume is marked lost.
N: Volume is not marked lost.

jjj

Number of read requests for this tape volume that are pending in OAM.

Volume is WORM tape

This text is displayed if the volume is physical WORM.

Volume is logical WORM

This text is displayed if the volume is logical WORM.

member-name

The XCF member name of the OAM which is controlling this tape volume, or -N/A-.

BACKUP1 | BACKUP2

The backup volume type for this volume. This volume contains first (BACKUP1) or second (BACKUP2) backup copies written to the Object Backup storage group to which this volume belongs.

capacity{K|M}

Approximate number of millimeters of tape or approximate number of kilobytes of data which can be written to the volume, allowing variance for different manufacturers. If capacity is followed by a 'K' then capacity is in KB and the amount of KB is less than 2GB. If capacity is followed by an 'M' the capacity shown is in MB because the amount of KB is equal to or greater than 2GB.

unitname

MVS unit name used when the tape volume is allocated. If the tape volume is in an IBM tape library, this value is ignored.

epi

The ERDS Physical Identifier which indicates the real underlying device type that is used to write OAM objects to this volume. You can use this value to diagnose problems in a mixed device environment where native and emulated devices coexist.

createdate

Date the tape volume was created, in the format YYYY-MM-DD.

expdate

Expiration date of the tape volume, in the format YYYY-MM-DD.

lmdate

Date the tape volume was last mounted, in the format YYYY-MM-DD.

lwdate

Date the tape volume was last written to, in the format YYYY-MM-DD.

dataclass

This field represents the data class associated with this object tape volume. If no DATACLASS is specified, this field contains hyphens.

sublevel

This field indicates which tape sublevel this volume is associated with. Valid values are 1 or 2 for volumes associated with object storage groups, and --N/A-- for volumes associated with OAM SCRATCH or object backup storage groups.

For an object tape volume belonging to an Object storage group, the command D SMS,VOLUME(J11981) displays the following information:

CBR1240I Object tape vol status: 135                                
 VOLUME STORAGE   RD WR CM IN  MED  FREE-SPACE  %   FULL LOST  REQ   
         GROUP             USE TYPE            FULL      FLAG  CT    
 J11981 GROUP01   Y  Y  N  N   07   292968448K   0   N    N      0   
---------------------------------------------------------------------- 
Extended    LRG                                                        
Attributes: BLK                                                        
             N                                                         
----------------------------------------------------------------------
XCF MEMBER NAME: -N/A-                                              
 CAPACITY:           292968448K   UNITNAME: 3590-1                   
 ERDS PHYSICAL ID:        0013                                       
 CREATION DATE:     2008-03-20    EXPIRATION DATE:    0001-01-01     
 LAST MOUNTED DATE: 2008-03-20    LAST WRITTEN DATE:  2008-03-20     
 DATACLASS:         ATL51         SUBLEVEL:           1              
 CBR1180I OAM tape volume status: 136                                
 VOLUME  MEDIA     STORAGE   LIBRARY   USE  W  C  SOFTWARE  LIBRARY  
         TYPE      GROUP     NAME      ATR  P  P  ERR STAT  CATEGORY 
 J11981  MEDIA5    SGATLOBJ  MTL13590  P    N  N  NOERROR   NONE     
 ------------------------------------------------------------------- 
 RECORDING TECH:     EFMT1            COMPACTION:         NO         
 SPECIAL ATTRIBUTE:  RDCOMPAT         ENTER/EJECT DATE:   2008-03-20 
 CREATION DATE:      2007-11-30       EXPIRATION DATE:    2020-07-18 
 LAST MOUNTED DATE:  2008-03-20       LAST WRITTEN DATE:  2008-03-20
 SHELF LOCATION:                                                     
 OWNER:                                                              
 -------------------------------------------------------------------

For an object tape volume belonging to an Object Backup storage group, the command D SMS,VOLUME(E28212) displays the following information:

CBR1240I Object tape vol status: 097                                  
VOLUME STORAGE   RD WR CM IN  MED  FREE-SPACE  %   FULL LOST  REQ     
        GROUP             USE TYPE            FULL      FLAG  CT      
E28212 IMAFIRST  Y  Y  N  N   04      873940K   0   N    N      0     
---------------------------------------------------------------------- 
Extended    LRG                                                        
Attributes: BLK                                                        
             N                                                         
----------------------------------------------------------------------
XCF MEMBER NAME: -N/A-                                                
BACKUP TYPE: BACKUP1                                                  
CAPACITY:              874218K   UNITNAME: 3490                       
ERDS PHYSICAL ID:        0002                                         
CREATION DATE:     2008-01-12    EXPIRATION DATE:    2008-02-16       
LAST MOUNTED DATE: 2008-01-16    LAST WRITTEN DATE:  2008-01-16       
DATACLASS:         VTSM2CU       SUBLEVEL:           N/A              
----------------------------------------------------------------------
CBR1180I OAM tape volume status: 098                                  
VOLUME  MEDIA     STORAGE   LIBRARY   USE  W  C  SOFTWARE  LIBRARY    
        TYPE      GROUP     NAME      ATR  P  P  ERR STAT  CATEGORY   
E28212  MEDIA2    SGVTSOBJ  ATLBA999  P    N     NOERROR   PRIVATE    
-------------------------------------------------------------------   
RECORDING TECH:     36 TRACK         COMPACTION:         NO           
SPECIAL ATTRIBUTE:  NONE             ENTER/EJECT DATE:   2006-06-26   
CREATION DATE:      2006-06-26       EXPIRATION DATE:                 
LAST MOUNTED DATE:  2008-01-16       LAST WRITTEN DATE:  2008-01-16   
SHELF LOCATION:                                                       
OWNER:                                                                
LM SG: SGVTSOBJ  LM SC: SCVTSOBJ  LM MC:           LM DC: VTSM2CU     
-------------------------------------------------------------------   
Logical volume.

If the object tape volume resides in an IBM automated tape library, you receive both the CBR1240I display for object tape volumes and the CBR1180I display for tape library volumes. The command D SMS,VOLUME(XCF011) displays the following information for an OAM scratch tape volume that resides in an automated tape library:

CBR1180I OAM tape volume status:  
VOLUME  MEDIA  STORAGE  LIBRARY  USE  W  C  SOFTWARE  LIBRARY 
        TYPE   GROUP    NAME     ATR  P  P  ERR STAT  CATEGORY
XCF011  MEDIA2 *SCRTCH* ATLBA999 S    N  N  MEDIAMNT  NOTAVAIL
--------------------------------------------------------------
RECORDING TECH:    36 TRACK     COMPACTION:       UNKNOWN 
SPECIAL ATTRIBUTE: NONE         ENTER/EJECT DATE: 2001-02-14
CREATION DATE: 2001-02-14       EXPIRATION DATE: 
LAST MOUNTED DATE:              LAST WRITTEN DATE: 
SHELF LOCATION:
OWNER:

Related reading: For more examples of CBR1180I, see the z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Tape Libraries.