VTS Peer-to-peer Libraries - VTSCMPID
This section is applicable for sites that have IBM VTS peer-to-peer systems. It explains how to populate prefix.MICS.PARMS(VTSCMPID) and how to use the VTSUTIL utility job to assist in updating VTSCMPID.
micsrm140
This section is applicable for sites that have IBM VTS peer-to-peer systems. It explains how to populate prefix.MICS.PARMS(VTSCMPID) and how to use the VTSUTIL utility job to assist in updating VTSCMPID.
If you use any IBM composite peer-to-peer VTS libraries, you must explicitly define the relationship between each composite library and the corresponding UI and secondary distributed VTS libraries.
- A utility job, prefix.MICS.CNTL(VTSUTIL) is provided that processes SMF type 94 records, determines the composite/UI/secondary library relationships, and updates a temporary member: prefix.MICS.PARMS(VTSTMPID).
- TheMICSadministrator reviews VTSTMPID, and can copy the composite/UI/secondary library ID values to the working member: prefix.MICS.PARMS(VTSCMPID).
- After updating prefix.MICS.PARMS(VTSCMPID), the component generation job, prefix.MICS.PARMS(VTSPGEN) must be executed to create the SAS FORMATS used during daily update processing to update data elements related to peer-to-peer VTS associations.
By default, the VTS Component DAY096 daily update step will abend if an IBM composite, UI, or secondary library is encountered in the raw data that is not listed in the VTSCMPID member. Alternatively, if an UNKNOWNVTSID REJECT statement is specified in prefix.MICS.PARMS(VTSOPS), data from unknown IBM VTS composite/UI/secondary libraries will be rejected rather than forcing an abend.
Units that only process StorageTek data or only process data from IBM standalone distributed VTS libraries can execute without updating the sample VTSCMPID member found in prefix.MICS.PARMS. It is not necessary to execute the VTSUTIL utility job if IBM peer-to-peer composite VTS libraries are not used at your site.
Executing the VTSUTIL Utility Job
The VTSUTIL utility job processes raw SMF data containing SMF type 94 IBM Tape Library Dataserver Statistics records. From these records, the job does the following:
- Determines the five-digit serial number (data element Library Sequence Number (VTSVLS)) of any composite peer-to-peer VTS libraries represented in the data.
- Determines the most likely associated UI and secondary libraries.
- Generates a //REPORT output listing that shows:- All VTSs encountered and the recording SMF SYSIDs- Composite/UI/secondary VTSVLS associations
- Updates temporary member prefix.MICS.PARMS(VTSTMPID) with the composite/UI/secondary VTSVLS associations.
To execute the VTSUTIL utility job, do the following:
- Update the //INPUTSMF DD with SMF data files from at least one z/OS system that interacts with each IBM VTS library.
- Submit the job
Examine the //REPORT DD output. The final report shows the VTS composite/UI/secondary VTSVLS associations if any composite libraries are found in the raw data.
Examine prefix.MICS.PARMS(VTSTMPID). This member records the date and time that the VTSUTIL utility job executed. The VTSVLS composite library associations, if any, will be found at the bottom of the member.
Notes
:- Execute the VTSUTIL utility job prior to running the first daily update if IBM SMF type 94 records containing data from composite peer-to-peer VTS libraries are to be processed. Even if no composite peer-to-peer VTS libraries are encountered, the first report will show which z/OS systems are collecting data for each standalone library.
- When executed, the VTSUTIL utility job updates the temporary member prefix.MICS.PARMS(VTSTMPID). If the VTSUTIL job //INPUTSMF datasets do not contain SMF type 94 records from all IBM VTS libraries that will be present during actual DAY096 daily update processing, the composite/UI/secondary library associations in prefix.MICS.PARMS(VTSTMPID) will only represent a partial list.
- The VTSUTIL utility job should be executed whenever a new peer-to-peer composite library is added to a site, or in the event that a reconfiguration causes the VTS serial numbers of the composite, UI, or secondary libraries to change.
Customizing the VTSCMPID Member
Prefix.MICS.PARMS(VTSCMPID) is created when the VTS component is installed in a unit. The distributed member is shown below:
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * DISTRIBUTED SAMPLE VTSCMPID MEMBER * * * * TO GENERATE VTSTMPID MEMBER, EXECUTE prefix.MICS.CNTL(VTSUTIL). * * --- * * REVIEW VTSTMPID. UPDATE COMP/UI/SEC LIBRARY ID'S AT BOTTOM OF * * THIS VTSCMPID MEMBER. * * --- * * NOTE: ACTUAL LIBRARY ID'S MUST NOT BE COMMENTED * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Composite UI Secondary * Library Library Library * ID ID ID * ----- ----- ----- * CMP01 UI001 SEC01 * CMP02 UI002 SEC02 * CMP03 UI003 SEC03
The component generation job, prefix.MICS.CNTL(VTSPGEN) parses prefix.MICS.PARMS(VTSCMPID) and creates a SAS FORMAT used to populate data element composite Library Association (VTSCMPID) in the IVT Information Area data base files.
Notes:
- Use the VTSUTIL job to build temporary member prefix.MICS.PARMS(VTSTMPID). If any composite/UI/secondary relationships are found, copy the library ID lines from VTSTMPID to the bottom of VTSCMPID.
- All lines in prefix.MICS.PARMS(VTSCMPID) must start with an '*' except for the lines containing the five digit composite, UI, and secondary VTS library serial numbers.
- In the event that the VTSUTIL utility job fails to correctly associate composite libraries with their related UI and secondary libraries, the VTSCMPID member must be manually updated to show the correct association.
- Each run of the VTSUTIL utility job replaces prefix.MICS.PARMS(VTSTMPID). In the utility job is executed several times against partial sets of SMF data, copy the composite/UI/secondary entries to VTSCMPID after each run until VTSCMPID contains the entire list of composite/UI/secondary associations.