7. PARAMETERS › 7.2 VTS Component Parameters › 7.2.3 VTS Component Unit Level Parameters › 7.2.3.3 VTS Peer-to-peer Libraries (VTSCMPID) › 7.2.3.3.1 Executing the VTSUTIL Utility Job

7.2.3.3.1 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:

o Determines the five-digit serial number (data element
  Library Sequence Number (VTSVLS)) of any composite
  peer-to-peer VTS libraries represented in the data

o Determines the most likely associated UI and secondary
  libraries

o Generates a //REPORT output listing that shows:
  - All VTSs encountered and the recording SMF SYSIDs
  - Composite/UI/secondary VTSVLS associations

o Updates temporary member prefix.MICS.PARMS(VTSTMPID) with
  the composite/UI/secondary VTSVLS associations

To execute the VTSUTIL utility job, do the following:

o Update the //INPUTSMF DD with SMF data files from at least
  one z/OS system that interacts with each IBM VTS library.

o 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.

** IMPORTANT NOTES **

o You must 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.

o 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.

o 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.