IVTVTC - VTC Statistics Detail File
The VTC Statistics Detail file provides detailed virtual tape controller activity and usage statistics for peer-to-peer VTSs. The IVTVTC 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 virtual tape controller.
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.IVTVTC Sort Sequence and Data Granularity
+---------+-------------------------------------------------+ |Timespan | Level of Data Granularity | +---------+-------------------------------------------------+ | | | | DETAIL | N/A | | | | | DAYS |SYSID IVTCMPID IVTTYPE IVTVLS IVTVTCNO | | |YEAR MONTH DAY HOUR | | | | | WEEKS |SYSID IVTCMPID IVTTYPE IVTVLS IVTVTCNO | | |YEAR WEEK ZONE HOUR | | | | | MONTHS |SYSID IVTCMPID IVTTYPE IVTVLS IVTVTCNO | | |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 .DWM..E IVTVTCNO - VTS VTC 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 .D....E VTCCLCS - Configured Settings .D....E VTCCLPF - IO VTS and Mast VTS Pref. for VTS .D....E VTCDFCPY - Default Copy Mode .D....E VTCFSCR - Force Scratch to Preferred VTS Indicator .DWM..E VTCLVVTC - VTC Code Modification and Fix Level .D....E VTCOPCPY - Operation Copy Mode .D....E VTCPIO - Preferred I/O VTS .D....E VTCPMST - Preferred Master VTS .D....E VTCPRIM - Primary I/O Indicator .DWM..E VTCSPD0 - VTC to VTS0 Link Speed .DWM..E VTCSPD1 - VTC to VTS1 Link Speed .D....E VTCWPM - Write Protect Mode Indicator Accumulated Data Elements .DWM..E VTCCLCR - Sum of Compression Ratio Write to Cache .DWM..E VTCDCPY - Virtual Volume Data Copied .DWM..E VTCDRVV - Data Read from Virtual Volumes (MB) .DWM..E VTCDTVV - Total Data R/W Virtual Volumes (MB) .DWM..E VTCDWVV - Data Written to Virtual Volumes (MB) .DWM..E VTCTVM - Total Virtual Mounts .DWM..E VTCVCHM - Virtual Cache-Hit Mounts .DWM..E VTCVCPY - Virtual Volumes Copied .DWM..E VTCVFRM - Virtual Fast-Ready Mounts .DWM..E VTCVRM - Virtual Recall Mounts .DWM..E VTCVSPM - Total Virtual Specific Mounts Derived Data Elements .DWM..E VTCAVCLC - Avg Compression Ratio Write to Cache .DWM..E VTCAVDRV - Avg Data Read from Virtual Volumes (MB) .DWM..E VTCAVDTV - Avg Total Data R/W Virtual Volumes (MB) .DWM..E VTCAVDWV - Avg Data Written to Virtual Volumes (MB) .DWM..E VTCPSCH - Avg Channel Data per Second (MB)
For a detailed description of individual data dictionary elements, see VTC Statistics Detail File (IVTVTC).
Usage Considerations
This section identifies any special considerations or techniques related to using the IVTVTC file.
The IVTVTC file contains an observation for each virtual tape controller associated with a peer-to-peer VTS configuration.
In a peer-to-peer VTS configuration, the virtual controllers (up to eight) handle the virtual tape I/O reads and writes between workloads on z/OS and the DASD cache of the participating UI and Secondary VTSs.
An important function of a peer-to-peer VTS is making copies of each virtual volume. If a virtual volume is created in the DASD cache of the UI VTS, a copy is made in the DASD cache of the secondary VTS and the other way around.
In addition to managing the z/OS I/O, the virtual controllers also manage the I/O associated with making copies of virtual volumes in the DASD cache of the UI or secondary VTSs.
Data element Composite Library Association (IVTCMPID) identifies the peer-to-peer composite VTS served by the virtual tape controllers. VTS Composite Library Activity (IVTVCL) file observations with the same IVTCMPID value contain data elements summarizing the virtual tape controller activity captured in the individual IVTVTC file observations.
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 IVTVTC file, show the virtual tape mounts (total, fast ready, cache-hit, and recall) data transferred (total, read and write), write compression ratio and average channel MB/sec rate for each VTC controller.
Summarize the data by VTC Controller (IVTVTCNO) to show the totals for each controller over all 24 hours of the day.
%LET BY=%VTCSEQ(TS=DAYS) ; %LET SUMBY=IVTVTCNO ; %LET BREAK=IVTVTCNO ; * ; DATA; SET &pIVTd..IVTVCL01; DATE=DATEPART(ENDTS) ; FORMAT DATE DATE8. ; %VTCSUM ; * ; PROC PRINT LABEL ; PAGEBY IVTVLS ; BY IVTCMPID IVTTYPE IVTVLS DATE ; ID IVTVTCNO ; VAR VTCTVM VTCVFRM VTCVCHM VTCVRM VTCDTVV VTCDRVV VTCDWVV VTCAVCLC VTCPSCH ; TITLE1 'Overall Daily Composite VTC Controller Statistics' ;