4. FILES › 5.1 TLM Component Files › 5.1.2 TMC Information Area Files › 5.1.2.2 Tape Volume File (TMCTMV)

5.1.2.2 Tape Volume File (TMCTMV)

 The Tape Volume File contains information about each
 in-service tape volume in the tape library catalog.
 In-service tape volumes are defined as follows:
 
 o For CA 1 (r) Tape Management, any volume that is not in
   DELETE status.
 
 o For CA TLMS (r) Tape Management, any volume that is not in
   Out-of-Service status.
 
 o For DFSMS/MVS Removable Media Manager (RMM), all volumes in
   the catalog are considered in-service.
 
 Scratch volumes are considered in-service in the TMC. Data
 element SCRATCH (Scratch Status) indicates whether the tape
 is scratch or not.
 
 For CA 1 and CA TLMS, volumes in the DELETE and
 Out-of-Service status, respectively either do not exist, are
 physically damaged, or are otherwise inaccessible.  These
 volume records are discarded by the TLM component DAY091
 step.  A MICSLOG message displays how many out-of-service
 volumes were discarded during the DAY091 daily update step.

 
 While the Tape Management Catalog Collector (TMCC) is running
 to read and extract the tape data from your tape management
 catalog, tape volumes and tape datasets continue to be
 created.  As a result, the extracted TMCC records might
 include the tape volumes created after the TMCC starts.
 These are deemed 'future' records.  When the TMCC starts, it
 first sets the End Timestamp (ENDTS) value for all extracted
 records, on which all duration calculations are based.  These
 records will have a create datetime after the End Timestamp,
 which would result in negative durations and invalid
 calculations based off of timestamp durations.  To preserve
 data integrity, these 'future' volumes are written to the
 Tape Volume (TMCTMV) file as a scratch volume, and the count
 displayed in a MICSLOG message.  These 'future' volumes and
 datasets will be picked up on the next TMCC run and the
 appropriate durations will be applied.
 
 At the DETAIL timespan, the TMCTMV file contains one record
 for each in-service tape volume managed by the tape library.
 
 At summarized timespans, the Volume Serial Number (VOLSER) is
 dropped.  Tape Library Identifier (TAPELIB), TMS Product Name
 Volume Group (VOLGROUP) and DFSMS Management Class Name
 (STORMGTC) serve as summarization keys.  This significantly
 reduces the volume of summarized TMCTMV timespans files.  It
 is important that due consideration is given in setting the
 VOLGROUP summarization key values so that the summarized
 timespans meet organizational reporting and analysis
 requirements.
 
 The following sections describe the file's organization, list
 the data elements maintained, and provide usage hints.
 
     1 - TMCTMV File Organization
     2 - TMCTMV Data Elements List
     3 - TMCTMV Usage Considerations
     4 - TMCTMV Retrieval Examples