This command is used when running the SVTSUTIL program to determine whether or not any DASD buffer LDSs have become unchained or lost. LDSs should be chained to one of the following locations:
The report generated by this command details where the LDSs are chained and whether or not they are unchained, along with whether or not a Virtual Volume associated with an LDS needs to be Externalized.
LIST=CACHE [,NOCATALOG|NOCATALOG,WTOD]
The optional NOCATALOG,WTOD parameter is used by the GRRJCL utility to suppress the catalog locates for the DASD buffer LDSs and to access the Write Time Of Day (WTOD) field in the Virtual Volume Entry in the Global VCAT. Eliminating the catalog locate reduces the GRRJCL utility runtime. The WTOD output consists of the date in Julian format and the time of day printed side-by-side in 16-byte fields.
Sample JCL can be found in HLQ.CCUUJCL(LISTCACH).
Note: If this diagnostic tool is run during periods of high virtual tape activity, it can impact virtual tape response times.
The LDS chains are dynamic. During mount or Backstore activity, these chains are being continuously updated. To determine if an LDS is correctly chained, this diagnostic tool must serialize the Global VCAT to prevent updates. The serialization is maintained for a short period and then released to allow other processes to update the Global VCAT. After a short wait, the Global VCAT is again serialized. This pattern is repeated until all LDSs have been evaluated.
If the report indicates that an LDS has become unchained or lost, you can recover it by using the SVTSUTIL RECLAIM command. Sample JCL can be found in HLQ.CCUUJCL(RECLAIM).
Sample output created from using the LIST=CACHE parameter
CA Vtape r11.5 S V T S U T I L - CA11.SVT2 - Thu JUN 28, 2007 19:02:07 ---------------------------------- Utility Control Statement(s) & Report Log ------------------------------- SVTSU0171I LIST=CACHE SVTSU1661I Accessing SVTS to identify GLOBAL VCAT and Local VCAT datasets Reason: GLOBAL DDName statement not defined VCAT DDName statement not defined List Cache Log 2007.179 19:02:07 *Inelig* - Allocation of the LDS failed Queued - Queued for externalization *MustReq - Must be manually requeued n/a - in Virtual field indicates LDS Cellpool status is UNUSED Lost1 - The LDS Cellpool status is allocated, but the LDS VVE vol does not exist Lost2 - The LDS Cellpool status is allocated, but the VVE vol has been scratched Lost3 - The LDS Cellpool status is allocated, but the LDS is not in the associated VVE vol LDSTABLE Lost types above - Generally the Reclaim utility will make these LDS usable again Dynamically Allocated Cache Data Sets ------------------------------------------------------------------------------------------------------------------------ Cache Linear Virtual Externalized Volser Dataset Volser Status #mb.InUse #mb.Alloc CacheExpDt CacheExpTm ------------------------------------------------------------------------------------------------------------------------ VTP11H SVTS120.VT3.VVE.V108006.MM.CACHE 108006 12 13 07/19/07 20:22 LOANV1 SVTS120.VT3.VVE.V108008.MM.CACHE 108008 16 17 07/18/07 19:51 LOANV3 SVTS120.VT3.VVE.V108009.MM.CACHE 108009 16 17 07/18/07 19:51 LOANV6 SVTS120.VT3.VVE.V108010.MM.CACHE 108010 16 17 07/18/07 19:51 LOANV3 SVTS120.VT3.VVE.V108090.MM.CACHE 108090 8 9 07/18/07 19:51 VTP11A SVTS120.VT3.VVE.V108091.MM.CACHE 108091 8 9 07/18/07 19:51 VTP11D SVTS120.VT3.VVE.V108092.MM.CACHE 108092 8 9 07/18/07 19:51 LOANV5 SVTS120.VT3.VVE.V109100.MM.CACHE 109100 432 433 07/18/07 18:56 Pre-allocated Cache Data Sets ------------------------------------------------------------------------------------------------------------ Cache Linear Virtual Externalized Volser Dataset Volser Status ------------------------------------------------------------------------------------------------------------ SMD062 QAPROD.VVE.LDS00000 100708 SMD062 QAPROD.VVE.LDS00002 100751 SMD043 QAPROD.VVE.LDS00003 100722 SMD066 QAPROD.VVE.LDS00004 n/a SMD056 QAPROD.VVE.LDS00005 100724 SMD065 QAPROD.VVE.LDS00006 100724 SMD065 QAPROD.VVE.LDS00007 100721 CA11,3 SMD031 QAPROD.VVE.LDS00008 100721 CA11,3 SMD004 QAPROD.VVE.LDS00009 100726 SMD045 QAPROD.VVE.LDS00010 100725
SMD046 QAPROD.VVE.LDS00011 100692 SMD061 QAPROD.VVE.LDS00012 100692 SMD054 QAPROD.VVE.LDS00013 100692 SMD052 QAPROD.VVE.LDS00014 100724 SMD065 QAPROD.VVE.LDS00015 100721 SMD043 QAPROD.VVE.LDS00016 100767 Queued SMD058 QAPROD.VVE.LDS00017 100725 SMD051 QAPROD.VVE.LDS00018 100732 SMD060 QAPROD.VVE.LDS00019 100767 Queued SMD052 QAPROD.VVE.LDS00020 100767 Queued SVTSU0172I LIST=CACHE SVTSUT60, RC= 0 SVTSU0173I Number of commands processed: 1 SVTSU0174I Highest condition code: 0
The Cache Volser on the far left is the DASD volume the LDS resides on. LDS00000 resides on DASD volume SMD054 and currently contains part or all of Virtual Volume 102619.
The following is a list of Externalized Statuses, which indicate the current Externalization status of the Virtual Volume:
Indicates that the Virtual Volume has been Externalized.
CrashProt
VVE does not have a write time of day. The ending tape mark may be missing. Check the tape management system to determine if the Virtual Volume is active with data blocks written to it or in scratch status. If the Virtual Volume is in scratch status, the next run of the Scratch Synchronization Job should scratch the Virtual Volume with the Global VCAT.
Indicates the LDS has been marked ineligible. Verify that the LDS has been properly defined and then execute the SVTSUTIL batch command LDS_ADD.
Indicates that the Virtual Volume is still in the DASD buffer. The volume is not queued and should be manually requeued by using the SVTSUTIL batch command VVE_WRITE or the batch job GRRJCL.
Indicates that the Virtual Volume is still in the DASD buffer. The volume is queued and waiting to be Externalized.
Indicates the Virtual Volume has been reserved on the displayed system by subsystem n. If the Virtual Volume is not in use execute the SVTSUTIL batch command VVE_FREE.
If n/a appears in the Virtual Volser column, then the associated LDS does not contain a Virtual Volume. This is an LDS that was never allocated to any Virtual Volume or never freed for reuse by running RECLAIM.
|
Copyright © 2013 CA Technologies.
All rights reserved.
|
|