IVTVDL - VTS Distributed Library Activity File
The VTS Distributed Library Activity file provides information for distributed VTSs (standalone, UI, and secondary). The IVTVDL file is created from statistics in SMF type 94 subtype 1 records.
micsrm140
At the DETAIL and DAYS timespans, the file provides hourly statistics for each VTS distributed library.
File Organization
The table below identifies data elements by which the file is sequenced and summarized in each timespan. N/A indicates that the file is not supported in a timespan. At the DETAIL level, data is sequenced but not summarized.
The timespans in which a file is supported are defined by each installation when
MICS
is installed. Therefore, this table has been generated as part of the installation process to accurately reflect the MICS
system at your installation.IVTVDL Sort Sequence and Data Granularity
+---------+-------------------------------------------------+ |Timespan | Level of Data Granularity | +---------+-------------------------------------------------+ | | | | DETAIL | N/A | | | | | DAYS |SYSID IVTCMPID IVTTYPE IVTVLS YEAR | | |MONTH DAY HOUR | | | | | WEEKS |SYSID IVTCMPID IVTTYPE IVTVLS YEAR | | |WEEK ZONE HOUR | | | | | MONTHS |SYSID IVTCMPID IVTTYPE IVTVLS YEAR | | |MONTH ZONE | | | | | YEARS | N/A | | | | +---------+-------------------------------------------------+ | TABLES | N/A | +---------+-------------------------------------------------+ Generation Date: Tue, May 12, 2009
This file was generated with ESSENTIAL=ALL option in effect. All data elements that are defined in the file are generated.
This file was generated with DERIVED=DEFault option in effect. The complex definition of the DERIVED option controls whether the data elements are kept on the file on auxiliary storage or not.
Data Elements List
The table below identifies data elements contained in this file.
GENERATION DATE: Tue, May 12, 2009 Note: Essential data elements are identified by an "E" under the Timespan asterisk (*) column. Time- Data Data Element Span * Element Description (LABEL) ------- -------- ---------------------------------------- Sequence/Summary Data Elements .D....E DAY - Day of Month .DW...E HOUR - Hour of Day .DWM..E IVTCMPID - Composite Library Association .DWM..E IVTTYPE - VTS Type .DWM..E IVTVLS - VTS Library Sequence Number .D.M..E MONTH - Month of Year .DWM..E SYSID - System Identifier .DW...E WEEK - Week of Year .DWM..E YEAR - Year of Century .DWM..E ZONE - Time Zone Common Data Elements .D....E DAYNAME - Name of Day of Week .DWM..E DURATION - Recording Interval Time .DWM..E ENDTS - End Time Stamp .DWM..E INTERVLS - Number of Recording Intervals .DWM..E IVTLMAN - System-Managed Tape Library Manufacturer .DWM..E IVTLMODL - System-Managed Tape Library Model .DWM..E IVTLPLNT - System-Managed Tape Library Plant .DWM..E IVTLTYPE - System-Managed Tape Library Type .DWM..E IVTPNM - Product Name .D....E IVTRVN - Version Number .D....E IVTSMFTM - Write to SMF Timestamp .DWM..E IVTSNO - System-Managed Tape Library Seq Number .DWM..E IVT4001 - F/C 4001 Indicator .D....E ORGSYSID - Originating System Identification .DWM..E STARTTS - Start Time Stamp .D....E SUBSYSID - JES Execution Subsystem ID Retained Data Elements .DWM..E VDLCVMPL - Copy Volume Mgmt Preference Level .DWM..E VDLESCON - Number of ESCON Channels .DWM..E VDLLVLM - Library Manager Version and Release .DWM..E VDLLVVTS - VTS Code Modification and Fix Level .DWM..E VDLPDI - Number of Installed Physical Tape Device .DWM..E VDLRVMPL - Recall Volume Mgmt Preference Level .DWM..E VDLSCSI - Number of SCSI Channels .DWM..E VDLVA35 - 35 Day Rolling Avg Virt Vol Age .DWM..E VDLVA4 - 4 HR Rolling Avg Virt Vol Age .DWM..E VDLVA48 - 48 HR Rolling Avg Virt Vol Age .DWM..E VDLVM35 - Virtual Vols Migrated Last 35 Days .DWM..E VDLVM4 - Virtual Vols Migrated Last 4 Hours .DWM..E VDLVM48 - Virtual Vols Migrated Last 48 Hours Accumulated Data Elements .DWM..E VDLACMA - Accessor A Mounts .DWM..E VDLACMB - Accessor B Mounts .DWM..E VDLBSRAT - Sum of Backstore Compression Ratio .DWM..E VDLCSIZ - Sum of VTS Cache Size (GB) .DWM..E VDLDRIC - Sum of Data Resident in Cache (GB) .DWM..E VDLDRVV - Data Read from Virtual Volumes (MB) .DWM..E VDLDTVV - Total Data R/W Virtual Volumes (MB) .DWM..E VDLDWVV - Data Written to Virtual Volumes (MB) .DWM..E VDLHARAT - Sum of Host Adapter Compression Ratio .DWM..E VDLLVD - Sum of Active Logical Volume Data (GB) .DWM..E VDLLVS - Sum of Active Logical Volumes .DWM..E VDLNUMBS - Channel Blocks Written .DWM..E VDLPCPY - Virtual Volumes Copied to Physical .DWM..E VDLPDR - Data Read from Physical Media (MB) .DWM..E VDLPDW - Data Written to Physical Media (MB) .DWM..E VDLPDWP - Data Written to Primary Pool (MB) .DWM..E VDLPDWS - Data Written to Secondary Pool (MB) .DWM..E VDLPHYSZ - Sum Est Available Physical Storage (GB) .DWM..E VDLPMIG - Physical Migrate (Copy) Mounts .DWM..E VDLPMTM - Total Physical Mount Time .DWM..E VDLPREC - Physical Reclaim Mounts .DWM..E VDLPSDE - Physical Secure Data Erase Mounts .DWM..E VDLPSTG - Physical Stage (Recall) Mounts .DWM..E VDLPSVC - Private Stacked Volume Count .DWM..E VDLRCPRT - Sum of Recall Predominate Throttle Pct .DWM..E VDLSARCT - Sum of Avg Recall Throttle Value .DWM..E VDLSAWOT - Sum of Avg Write Overrun Throttle Value .DWM..E VDLSDVTO - Sum Total Volumes With Active Data .DWM..E VDLSDV00 - Sum Vols With 0% to 5% Active Data .DWM..E VDLSDV05 - Sum Vols With > 5% to 10% Active Data .DWM..E VDLSDV10 - Sum Vols With > 10% to 15% Active Data .DWM..E VDLSDV15 - Sum Vols With > 15% to 20% Active Data .DWM..E VDLSDV20 - Sum Vols With > 20% to 25% Active Data .DWM..E VDLSDV25 - Sum Vols With > 25% to 30% Active Data .DWM..E VDLSDV30 - Sum Vols With > 30% to 35% Active Data .DWM..E VDLSDV35 - Sum Vols With > 35% to 40% Active Data .DWM..E VDLSDV40 - Sum Vols With > 40% to 45% Active Data .DWM..E VDLSDV45 - Sum Vols With > 45% to 50% Active Data .DWM..E VDLSDV50 - Sum Vols With > 50% to 55% Active Data .DWM..E VDLSDV55 - Sum Vols With > 55% to 60% Active Data .DWM..E VDLSDV60 - Sum Vols With > 60% to 65% Active Data .DWM..E VDLSDV65 - Sum Vols With > 65% to 70% Active Data .DWM..E VDLSDV70 - Sum Vols With > 70% to 75% Active Data .DWM..E VDLSDV75 - Sum Vols With > 75% to 80% Active Data .DWM..E VDLSDV80 - Sum Vols With > 80% to 85% Active Data .DWM..E VDLSDV85 - Sum Vols With > 85% to 90% Active Data .DWM..E VDLSDV90 - Sum Vols With > 90% to 95% Active Data .DWM..E VDLSDV95 - Sum Vols With > 95% to 100% Active Data .DWM..E VDLSPCM - Sum of Avg Phys Drives Concur Mounted .DWM..E VDLSPDA - Sum of Physical Drives Available .DWM..E VDLSSVC - Scratch Stacked Volume Count .DWM..E VDLSTOAT - Sum of Overall Average Throttle Value .DWM..E VDLSVCA - Sum of Avg Cache Last Reference Time .DWM..E VDLSVCM - Sum of Avg Virtual Drives Concur Mounted .DWM..E VDLSVDC - Sum of Virtual Drives Configured .DWM..E VDLSVMD - Total Virtual Mount Duration .DWM..E VDLTHRES - Sum of Reclaim Threshold Percentage .DWM..E VDLTPM - Total Physical Mounts .DWM..E VDLTVM - Total Virtual Mounts .DWM..E VDLVCHM - Virtual Cache-Hit Mounts .DWM..E VDLVFMTM - Total Virtual Fast-Ready Mount Time .DWM..E VDLVFRM - Virtual Fast-Ready Mounts .DWM..E VDLVHMTM - Total Virtual Cache-Hit Mount Time .DWM..E VDLVMTM - Total Virtual Mount Time .DWM..E VDLVRM - Virtual Recall Mounts .DWM..E VDLVRMTM - Total Virtual Recall Mount Time .DWM..E VDLVSPM - Total Virtual Specific Mounts .DWM..E VDLVVIC - Sum of Virtual Volumes in Cache .DWM..E VDLWROVT - Sum W/Overrun Predominate Throttle Pct .DWM..E VDL00KB - 0 to 2K Channel Blocks Written .DWM..E VDL02KB - > 2K to 4K Channel Blocks Written .DWM..E VDL04KB - > 4K to 8K Channel Blocks Written .DWM..E VDL08KB - > 8K to 16K Channel Blocks Written .DWM..E VDL16KB - > 16K to 32K Channel Blocks Written .DWM..E VDL32KB - > 32K to 64K Channel Blocks Written .DWM..E VDL64KB - > 64K Channel Blocks Written Minimum Data Elements .DWM..E VDLMNCHT - Min Virtual Cache-Hit Mount Time .DWM..E VDLMNFRT - Min Virtual Fast-Ready Mount Time .DWM..E VDLMNPCM - Min Physical Drives Concur Mounted .DWM..E VDLMNPDA - Min Physical Drives Available .DWM..E VDLMNPMT - Min Physical Mount Time .DWM..E VDLMNPSC - Min Channel Data per Second (MB) .DWM..E VDLMNRMT - Min Virtual Recall Mount Time .DWM..E VDLMNVCM - Min Virtual Drives Concur Mounted .DWM..E VDLMNVDC - Min Virtual Drives Configured .DWM..E VDLMNVMD - Min Virtual Mount Duration .DWM..E VDLMNVMT - Min Virtual Mount Time Maximum Data Elements .DWM..E VDLMXCHT - Max Virtual Cache-Hit Mount Time .DWM..E VDLMXFRT - Max Virtual Fast-Ready Mount Time .DWM..E VDLMXPCM - Max Physical Drives Concur Mounted .DWM..E VDLMXPDA - Max Physical Drives Available .DWM..E VDLMXPMT - Max Physical Mount Time .DWM..E VDLMXPSC - Max Channel Data per Second (MB) .DWM..E VDLMXRMT - Max Virtual Recall Mount Time .DWM..E VDLMXVCA - Max Virtual Volume Cache Age .DWM..E VDLMXVCM - Max Virtual Drives Concur Mounted .DWM..E VDLMXVDC - Max Virtual Drives Configured .DWM..E VDLMXVMD - Max Virtual Mount Duration .DWM..E VDLMXVMT - Max Virtual Mount Time Derived Data Elements .DWM..E VDLAVATO - Avg Total Volumes with Active Data .DWM..E VDLAVA00 - Avg Vols With 0% to 5% Active Data .DWM..E VDLAVA05 - Avg Vols With > 5% to 10% Active Data .DWM..E VDLAVA10 - Avg Vols With > 10% to 15% Active Data .DWM..E VDLAVA15 - Avg Vols With > 15% to 20% Active Data .DWM..E VDLAVA20 - Avg Vols With > 20% to 25% Active Data .DWM..E VDLAVA25 - Avg Vols With > 25% to 30% Active Data .DWM..E VDLAVA30 - Avg Vols With > 30% to 35% Active Data .DWM..E VDLAVA35 - Avg Vols With > 35% to 40% Active Data .DWM..E VDLAVA40 - Avg Vols With > 40% to 45% Active Data .DWM..E VDLAVA45 - Avg Vols With > 45% to 50% Active Data .DWM..E VDLAVA50 - Avg Vols With > 50% to 55% Active Data .DWM..E VDLAVA55 - Avg Vols With > 55% to 60% Active Data .DWM..E VDLAVA60 - Avg Vols With > 60% to 65% Active Data .DWM..E VDLAVA65 - Avg Vols With > 65% to 70% Active Data .DWM..E VDLAVA70 - Avg Vols With > 70% to 75% Active Data .DWM..E VDLAVA75 - Avg Vols With > 75% to 80% Active Data .DWM..E VDLAVA80 - Avg Vols With > 80% to 85% Active Data .DWM..E VDLAVA85 - Avg Vols With > 85% to 90% Active Data .DWM..E VDLAVA90 - Avg Vols With > 90% to 95% Active Data .DWM..E VDLAVA95 - Avg Vols With > 95% to 100% Active Data .DWM..E VDLAVBSR - Avg Backstore Compression Ratio .DWM..E VDLAVBSZ - Avg Channel Blocksize (Est) .DWM..E VDLAVCSZ - Avg VTS Cache Size (GB) .DWM..E VDLAVDRC - Avg Data Resident in Cache (GB) .DWM..E VDLAVDRV - Avg Data Read from Virtual Volumes (MB) .DWM..E VDLAVDTV - Avg Total Data R/W Virtual Volumes (MB) .DWM..E VDLAVDWV - Avg Data Written to Virtual Volumes (MB) .DWM..E VDLAVFMT - Avg Virtual Fast-Ready Mount Time .DWM..E VDLAVHAR - Avg Host Adapter Compression Ratio .DWM..E VDLAVHMT - Avg Virtual Cache-Hit Mount Time .DWM..E VDLAVLVD - Avg Active Logical Volume Data (GB) .DWM..E VDLAVLVS - Avg Active Logical Volumes .DWM..E VDLAVLVZ - Avg Active Logical Volume Size (MB) .DWM..E VDLAVPCM - Avg Physical Drives Concur Mounted .DWM..E VDLAVPDA - Avg Physical Drives Available .DWM..E VDLAVPM - Avg Physical Mounts .DWM..E VDLAVPMT - Avg Physical Mount Time .DWM..E VDLAVPSV - Avg Private Stacked Volume Count .DWM..E VDLAVPSZ - Avg Est Available Physical Storage (GB) .DWM..E VDLAVRCP - Avg Recall Predominate Throttle Pct .DWM..E VDLAVRCT - Avg Recall Throttle Value .DWM..E VDLAVRMT - Avg Virtual Recall Mount Time .DWM..E VDLAVSSV - Avg Scratch Stacked Volume Count .DWM..E VDLAVTOT - Overall Avg Throttle Value .DWM..E VDLAVTPC - Avg Reclaim Threshold Percentage .DWM..E VDLAVVCA - Avg Cache Last Reference Time .DWM..E VDLAVVCM - Avg Virtual Drives Concur Mounted .DWM..E VDLAVVDC - Avg Virtual Devices Configured .DWM..E VDLAVVIC - Avg Virtual Volumes in Cache .DWM..E VDLAVVM - Avg Virtual Mounts .DWM..E VDLAVVMD - Avg Virtual Mount Duration .DWM..E VDLAVVMT - Avg Virtual Mount Time .DWM..E VDLAVVSZ - Avg Virtual Volume Size (MB) .DWM..E VDLAVWOT - Avg Write Overrun Throttle Value .DWM..E VDLAVWRO - Avg W/Overrun Predominate Throttle Pct .DWM..E VDLPCCSU - Pct VTS Cache Capacity Used .DWM..E VDLPCD00 - Pct Vols With 0% to 5% Active Data .DWM..E VDLPCD05 - Pct Vols With > 5% to 10% Active Data .DWM..E VDLPCD10 - Pct Vols With > 10% to 15% Active Data .DWM..E VDLPCD15 - Pct Vols With > 15% to 20% Active Data .DWM..E VDLPCD20 - Pct Vols With > 20% to 25% Active Data .DWM..E VDLPCD25 - Pct Vols With > 25% to 30% Active Data .DWM..E VDLPCD30 - Pct Vols With > 30% to 35% Active Data .DWM..E VDLPCD35 - Pct Vols With > 35% to 40% Active Data .DWM..E VDLPCD40 - Pct Vols With > 40% to 45% Active Data .DWM..E VDLPCD45 - Pct Vols With > 45% to 50% Active Data .DWM..E VDLPCD50 - Pct Vols With > 50% to 55% Active Data .DWM..E VDLPCD55 - Pct Vols With > 55% to 60% Active Data .DWM..E VDLPCD60 - Pct Vols With > 60% to 65% Active Data .DWM..E VDLPCD65 - Pct Vols With > 65% to 70% Active Data .DWM..E VDLPCD70 - Pct Vols With > 70% to 75% Active Data .DWM..E VDLPCD75 - Pct Vols With > 75% to 80% Active Data .DWM..E VDLPCD80 - Pct Vols With > 80% to 85% Active Data .DWM..E VDLPCD85 - Pct Vols With > 85% to 90% Active Data .DWM..E VDLPCD90 - Pct Vols With > 90% to 95% Active Data .DWM..E VDLPCD95 - Pct Vols With > 95% to 100% Active Data .DWM..E VDLPCPSU - Pct Physical Storage Capacity Used .DWM..E VDLPCSTG - Pct Physical Stage (Recall) Mounts .DWM..E VDLPCVMS - Pct Virtual Specific Mount Cache Misses .DWM..E VDLPC00K - Pct 0 to 2K Channel Blocks Written .DWM..E VDLPC02K - Pct > 2K to 4K Channel Blocks Written .DWM..E VDLPC04K - Pct > 4K to 8K Channel Blocks Written .DWM..E VDLPC08K - Pct > 8K to 16K Channel Blocks Written .DWM..E VDLPC16K - Pct > 16K to 32K Channel Blocks Written .DWM..E VDLPC32K - Pct > 32K to 64K Channel Blocks Written .DWM..E VDLPC64K - Pct > 64K Channel Blocks Written .DWM..E VDLPSCH - Avg Channel Data per Second (MB)
For a detailed description of individual data dictionary elements, see VTS Distributed Library Activity File (IVTVDL).
Usage Considerations
For reporting purposes, it is important to examine data element VTS Type (IVTTYPE). IVTTYPE can take on up to three values in the IVTVDL file; 'STANDALONE', 'UI', and 'SECONDARY'.
For IVTVDL observations where the IVTTYPE='STANDALONE', the VTS is an autonomous virtual tape server.
For IVTVDL observations where the IVTTYPE='UI' or 'SECONDARY', however, the VTS is a participant in a peer-to-peer configuration. All peer-to-peer VTS configurations have two IVTVDL observations and one VTS Composite Library Activity (IVTVCL) file observation for each hour in the DETAIL and DAYS timespans.
Data element Composite Library Association (IVTCMPID) contains the same value for all three observations and is used to identify all participating VTSs in a peer-to-peer configuration.
In general, the two hourly IVTVDL observations ('UI' and 'SECONDARY') for a peer-to-peer configuration, contain the statistics related to the virtual volume, DASD cache, and physical cartridge activity related to their half of the configuration.
The hourly IVTVCL observation contains the composite, or logical view of the peer-to-peer VTS and provides overall z/OS throughput and virtual volume activity statistics.
Retrieval Examples
In the examples, a SAS macro variable is used to specify the DDname part of the
MICS
file name. These macro variables are a standard part of MICS
and are available for all files. The macro variable name has the form &diiit, where d is the database identifier, iii is the information area name, and t is the timespan. For the examples, a database identifier of P is used. The identifier is installation-dependent, so you should find out what the identifiers are at your installation.- Using the most recent DAYS timespan IVTVDL file, display the total blocks of data moved between DASD cache and z/OS for each VTS, per HOUR. Display the percent buckets for each blocksize range and the estimated average blocksize. Generate a separate page for each VTS.DATA; SET &pIVTd..IVTVDL01; DATE=DATEPART(ENDTS) ; FORMAT DATE DATE8. ; * ; PROC PRINT LABEL ; PAGEBY IVTVLS ; BY IVTCMPID IVTTYPE IVTVLS DATE ; ID HOUR ; VAR VDLNUMBS VDLPC00K VDLPC02K VDLPC04K VDLPC08K VDLPC16K VDLPC32K VDLPC64K VDLAVBSZ ; TITLE1 'Daily VTS System I/O Block Size Analysis by HOUR' ; RUN ;