StorageTek Host Software Component 6 User Manual

1st ed., 6/30/04 - 312579601

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.