324 VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 - 312579601
Volume Report Utility
The function of the Volume Report utility is to produce a listing of the physical location
for volumes residing in an LSM. This utility is used primarily for informational purposes
and provides history and usage statistics on specific library volumes.
The Volume Report utility program functions as a stand-alone process in batch mode and
does not require that the HSC be operational in order to execute. If the HSC is operational,
Volume Report can extract CDS and VOLATTR information from the active HSC.
In addition to the reporting capability, the utility can produce a ‘‘flat file’’ which may be
used as a data source for manipulating the data for user-defined reports with other
software products.
Note: It is recommended that a 2 megabyte region size be used when running the Volume
Report utility.
A report may be sorted or unsorted. When the SORT option is specified, volume data can
be sorted by:
• volume serial numbers
• location of volumes
• select count (usage) of volumes
• date volumes were inserted into the library control data set
• last date volumes were selected.
Sorting may be done in ascending or descending order.
• The report sorted by volume serial number is useful when a listing of library
information is needed in ascending VOLSER sequence.
• The report sorted by location can be utilized for either the mass transfer of volumes
or assessing the potential impact of a component failure. With this information, the
installation can avoid jobs which access volumes within failed components.
• The report sorted by usage lists volumes by selection count. This report is useful for
either ejecting low use volumes or replicating information on high use volumes.
The utility output may include a variety of information, depending upon the user-specified
parameters. For example, volume information can be specifically included or excluded
from a report based on:
• scratch status
• errant status
• external label status
• selected status.
Specifying of report parameters can range from the ACS or LSM level to as specific as a
single volume serial number or list of volume serial numbers. Whenever a report is
generated using library element parameters (i.e., LSM and/or ACS), the Volume Report
utility may also output messages identifying empty but allocated cells.
Volume Report