StorageTek Host Software Component 6 User Manual

Page of 718
Chapter 4. Utility Functions   239
1st ed., 6/30/04 - 312579601
 
Eject Cartridge Utility 
The EJECt Cartridge utility permits you to remove one or more cartridges from an ACS in 
a batch mode. For the automated ejection of cartridges, the EJECt Cartridge utility takes 
advantage of the Cartridge Access Port (CAP) in an LSM. 
The control statement allows you to designate a single CAP, a specific CAP, or a list of 
specific CAPs. Specifying one or more CAPs limits cartridge ejection to those CAPs.  
Ejections in a multiple ACS configuration may specify CAPs in each ACS if volumes 
reside in each ACS. If a CAP list is not provided, the utility selects the highest priority 
CAP available for each ACS (refer to the ‘‘CAP Preference (CAPPref) Command and 
Control Statement’’ in the HSC Operator’s Guide). 
You may elect to submit multiple EJECt Cartridge utility requests, each of which may 
specify a particular CAP. If you elect to specify a CAP in a multi-ACS configuration, then 
the list of volumes must reside within the CAP ACS. 
Multiple CAPs within one ACS can be allocated to the EJECt utility. Specifying multiple 
CAPs in a single EJECt Cartridge utility typically improves performance by reducing 
pass-thrus. 
If two CAPs are specified in the same LSM, cartridges in that LSM are ejected in 
sequential order. This is helpful for vaulting. 
Syntax
EJECt
Eject Method 1
Eject Method 2
CAP( cap-list
)
,
Eject Method 1:
Eject Method 2:
VOLser(
vol-list
,
)
SCRTCH
SUBpool(subpool-name)
VOLCNT(count)
Eject Cartridge