IVTVCU - VTS Cache Usage File
The VTS Cache Usage file contains detailed VTS DASD cache utilization and activity information for distributed VTSs (standalone, UI, and secondary). The IVTVCU file is created from the VTS Cache Usage Information Array sections in SMF type 94 subtype 1 records.
micsrm140
The VTS Cache Usage file contains detailed VTS DASD cache utilization and activity information for distributed VTSs (standalone, UI, and secondary). The IVTVCU file is created from the VTS Cache Usage Information Array sections in SMF type 94 subtype 1 records.
At the DETAIL and DAYS timespans, the file provides hourly cache statistics for each Cache Usage Preference Level Identifier (IVTCUPL) level.
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.IVTVCU Sort Sequence and Data Granularity
+---------+-------------------------------------------------+ |Timespan | Level of Data Granularity | +---------+-------------------------------------------------+ | | | | DETAIL | N/A | | | | | DAYS |SYSID IVTCMPID IVTTYPE IVTVLS IVTCUPL | | |YEAR MONTH DAY HOUR | | | | | WEEKS |SYSID IVTCMPID IVTTYPE IVTVLS IVTCUPL | | |YEAR WEEK ZONE HOUR | | | | | MONTHS |SYSID IVTCMPID IVTTYPE IVTVLS IVTCUPL | | |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.
IVTVCU 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 IVTCUPL - Cache Usage Preference Level ID .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 .D....E VCUPMC - Preference Management Control .DWM..E VCUVA35 - 35 Day Rolling Avg Virt Vol Age .DWM..E VCUVA4 - 4 HR Rolling Avg Virt Vol Age .DWM..E VCUVA48 - 48 HR Rolling Avg Virt Vol Age .DWM..E VCUVM35 - Virtual Vols Migrated Last 35 Days .DWM..E VCUVM4 - Virtual Vols Migrated Last 4 Hours .DWM..E VCUVM48 - Virtual Vols Migrated Last 48 Hours Accumulated Data Elements .DWM..E VCUCSIZ - Sum of VTS Cache Size (GB) .DWM..E VCUDRIC - Sum of Data Resident in Cache (GB) .DWM..E VCUTVM - Total Virtual Mounts .DWM..E VCUVCHM - Virtual Cache-Hit Mounts .DWM..E VCUVFMTM - Total Virtual Fast-Ready Mount Time .DWM..E VCUVFRM - Virtual Fast-Ready Mounts .DWM..E VCUVHMTM - Total Virtual Cache-Hit Mount Time .DWM..E VCUVMTM - Total Virtual Mount Time .DWM..E VCUVRM - Virtual Recall Mounts .DWM..E VCUVRMTM - Total Virtual Recall Mount Time .DWM..E VCUVVIC - Sum of Virtual Volumes in Cache Derived Data Elements .DWM..E VCUAVCSZ - Avg VTS Cache Size (GB) .DWM..E VCUAVDRC - Avg Data Resident in Cache (GB) .DWM..E VCUAVFMT - Avg Virtual Fast-Ready Mount Time .DWM..E VCUAVHMT - Avg Virtual Cache-Hit Mount Time .DWM..E VCUAVRMT - Avg Virtual Recall Mount Time .DWM..E VCUAVVIC - Avg Virtual Volumes in Cache .DWM..E VCUAVVMT - Avg Virtual Mount Time .DWM..E VCUAVVSZ - Avg Virtual Volume Size (MB)
For a detailed description of individual data dictionary elements, see VTS Cache Usage File (IVTVCU).
Usage Considerations
This section identifies any special considerations or techniques related to using the IVTVCU file.
The overall DASD cache utilization for distributed VTSs (STANDALONE, UI, and SECONDARY) is contained in the VTS Distributed Library Activity file.
The IVTVCU file contains a further breakdown of DASD cache activity by Cache Usage Preference Level Identifier (IVTCUPL). This file is only created for VTS's that are operating at the IBM function code F/C 4001 level.
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 IVTVCU file, generate cache utilization statistics for each distributed VTS (UI, secondary, and standalone). Display the number of virtual volumes, total cache utilization, average virtual volume size, and the 4 hour, 48 hour, and 35 day rolling virtual volume ages by cache preference level for each hour of the DAY.DATA; SET &pIVTd..IVTVCU01; DATE=DATEPART(ENDTS) ; FORMAT DATE DATE8. ; * ; PROC PRINT LABEL ; PAGEBY IVTCUPL ; BY IVTCMPID IVTTYPE IVTVLS DATE IVTCUPL ; ID HOUR ; VAR VCUVVIC VCUDRIC VCUAVVSZ VCUVA4 VCUVA48 VCUVA35 VCUVM4 VCUVM48 VCUVM35 ; TITLE1 'Daily Cache Report by Preference Level and HOUR'; RUN ; SET &pIVTd..IVTMDE01;