IVTVCL - VTS Composite Library Activity File
The VTS Composite Library Activity file provides information for the composite, or logical view of a peer-to-peer VTS configuration.
micsrm140
Information included in the file represents overall VTS activity achieved by both the User Interface (UI) VTS and secondary VTS components of the peer-to-peer configuration. The IVTVCL file is created from statistics in SMF type 94 subtype 1 records.
At the DETAIL and DAYS timespans, the file provides hourly statistics for each VTS composite 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.IVTVCL 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, 2009Note: 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 VCLESCON - Number of ESCON Channels .DWM..E VCLLVVTC - VTC Code Modification and Fix Level .DWM..E VCLOPCPY - Operation Copy Mode .DWM..E VCLPIO - Composite VTC Preferred I/O VTS .DWM..E VCLPMST - Composite VTC Preferred Master VTS .DWM..E VCLSECID - SECONDARY IVTVLS ID .DWM..E VCLUIID - UI IVTVLS ID Accumulated Data Elements .DWM..E VCLCLCR - Sum of Compression Ratio Write to Cache .DWM..E VCLCVMT0 - Completed Mounts VTS-0 .DWM..E VCLCVMT1 - Completed Mounts VTS-1 .DWM..E VCLDCPY - Virtual Volume Data Copied (MB) .DWM..E VCLDRVV - Data Read from Virtual Volumes (MB) .DWM..E VCLDTCPY - Virtual Volume Data to be Copied (MB) .DWM..E VCLDTVV - Total Data R/W Virtual Volumes (MB) .DWM..E VCLDWVV - Data Written to Virtual Volumes (MB) .DWM..E VCLHARAT - Sum of Host Adapter Compression Ratio .DWM..E VCLNUMBS - Channel Blocks Written .DWM..E VCLSVCM - Sum of Avg Virtual Drives Concur Mounted .DWM..E VCLSVDC - Sum of Virtual Drives Configured .DWM..E VCLSVMD - Total Virtual Mount Duration .DWM..E VCLTVM - Total Virtual Mounts .DWM..E VCLVCHM - Virtual Cache-Hit Mounts .DWM..E VCLVCPY - Virtual Volumes Copied .DWM..E VCLVFMTM - Total Virtual Fast-Ready Mount Time .DWM..E VCLVFRM - Virtual Fast-Ready Mounts .DWM..E VCLVHMTM - Total Virtual Cache-Hit Mount Time .DWM..E VCLVMTM - Total Virtual Mount Time .DWM..E VCLVRM - Virtual Recall Mounts .DWM..E VCLVRMTM - Total Virtual Recall Mount Time .DWM..E VCLVSPM - Total Virtual Specific Mounts .DWM..E VCLVTCPY - Virtual Volumes to be Copied .DWM..E VCL00KB - 0 to 2K Channel Blocks Written .DWM..E VCL02KB - > 2K to 4K Channel Blocks Written .DWM..E VCL04KB - > 4K to 8K Channel Blocks Written .DWM..E VCL08KB - > 8K to 16K Channel Blocks Written .DWM..E VCL16KB - > 16K to 32K Channel Blocks Written .DWM..E VCL32KB - > 32K to 64K Channel Blocks Written .DWM..E VCL64KB - > 64K Channel Blocks Written Minimum Data Elements .DWM..E VCLMNCHT - Min Virtual Cache-Hit Mount Time .DWM..E VCLMNFRT - Min Virtual Fast-Ready Mount Time .DWM..E VCLMNPSC - Min Channel Data per Second (MB) .DWM..E VCLMNRMT - Min Virtual Recall Mount Time .DWM..E VCLMNVCM - Min Virtual Drives Concur Mounted .DWM..E VCLMNVDC - Min Virtual Drives Configured .DWM..E VCLMNVMD - Min Virtual Mount Duration .DWM..E VCLMNVMT - Min Virtual Mount Time Maximum Data Elements .DWM..E VCLMXCHT - Max Virtual Cache-Hit Mount Time .DWM..E VCLMXFRT - Max Virtual Fast-Ready Mount Time .DWM..E VCLMXPSC - Max Channel Data per Second (MB) .DWM..E VCLMXRMT - Max Virtual Recall Mount Time .DWM..E VCLMXVCM - Max Virtual Drives Concur Mounted .DWM..E VCLMXVDC - Max Virtual Drives Configured .DWM..E VCLMXVMD - Max Virtual Mount Duration .DWM..E VCLMXVMT - Max Virtual Mount Time Derived Data Elements .DWM..E VCLAVBSZ - Avg Channel Blocksize (Est) .DWM..E VCLAVCLC - Avg Compression Ratio Write to Cache .DWM..E VCLAVDRV - Avg Data Read from Virtual Volumes (MB) .DWM..E VCLAVDTV - Avg Total Data R/W Virtual Volumes (MB) .DWM..E VCLAVDWV - Avg Data Written to Virtual Volumes (MB) .DWM..E VCLAVFMT - Avg Virtual Fast-Ready Mount Time .DWM..E VCLAVHAR - Avg Host Adapter Compression Ratio .DWM..E VCLAVHMT - Avg Virtual Cache-Hit Mount Time .DWM..E VCLAVRMT - Avg Virtual Recall Mount Time .DWM..E VCLAVVCM - Avg Virtual Drives Concur Mounted .DWM..E VCLAVVDC - Avg Virtual Devices Configured .DWM..E VCLAVVM - Avg Virtual Mounts .DWM..E VCLAVVMD - Avg Virtual Mount Duration .DWM..E VCLAVVMT - Avg Virtual Mount Time .DWM..E VCLPCVMS - Pct Virtual Specific Mount Cache Misses .DWM..E VCLPC00K - Pct 0 to 2K Channel Blocks Written .DWM..E VCLPC02K - Pct > 2K to 4K Channel Blocks Written .DWM..E VCLPC04K - Pct > 4K to 8K Channel Blocks Written .DWM..E VCLPC08K - Pct > 8K to 16K Channel Blocks Written .DWM..E VCLPC16K - Pct > 16K to 32K Channel Blocks Written .DWM..E VCLPC32K - Pct > 32K to 64K Channel Blocks Written .DWM..E VCLPC64K - Pct > 64K Channel Blocks Written .DWM..E VCLPSCH - Avg Channel Data per Second (MB)
For a detailed description of individual data dictionary elements, see VTS Composite Library Activity File (IVTVCL).
Usage Considerations
This section identifies any special considerations or techniques related to using the IVTVCL file.
The IVTVCL observations contain statistics relating to the logical view of a peer-to-peer VTS. For IVTVCL observations, both the Composite Library Association (IVTCMPID) and Library Sequence Number (IVTVLS) will contain the same value. The User Interface (UI) and secondary VTSs that participate in the peer-to-peer configuration are identified with data elements UI IVTVLS ID (VCLUIID) and SECONDARY IVTVLS ID (VCLSECID).
Statistics for the UI and Secondary VTS activity are found in the VTS Distributed Library Activity (IVTVDL) file.
IVTVCL file observations primarily contain statistics related to overall virtual volume activity and are useful for determining z/OS throughput of a peer-to-peer VTS configuration. In addition, IVTVCL file observations are useful for monitoring the virtual volume copy function and overall virtual volume controller activity of each peer-to-peer VTS.
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 IVTVCL file, display the total number of virtual volumes accessed in the DASD cache of the UI and secondary VTSs.Break the total down by category: Fast ready, recall, and cache-hit. Show the average overall virtual mount time as well as the mount times for the various categories.DATA; SET &pIVTd..IVTVCL01; DATE=DATEPART(ENDTS) ; FORMAT DATE DATE8. ; * ; PROC PRINT LABEL ; PAGEBY IVTVLS ; BY IVTCMPID IVTTYPE IVTVLS DATE ; ID HOUR ; VAR VCLTVM VCLAVVMT VCLVFRM VCLAVFMT VCLVCHM VCLAVHMT VCLVRM VCLAVRMT ; TITLE1 'Daily Composite Virtual Mounts/Times by HOUR' ; RUN ;