Previous Topic: Control Statement SpecificationNext Topic: Data Set Name Control Statement


Vault Name Control Statement

The Vault Name control statement defines an unlimited number of location IDs (vaults) for use by VMS. It must be the first control statement specified in the VPD and is required. Each location ID is from one to four characters inclusive. If the number of locations you want to define exceeds 72 positions, use multiple statements; a statement should not be split across two lines. If the number of slots in the vault needs to be defined, the vault name should be followed by the MAX= keyword. If the number of tapes assigned to a vault exceeds the value in the MAX= statement, a warning message is issued by TMSVMVLT. If a vault contains both reels and cartridges, the value specified for MAX= should be the larger value and not the total number of slots required. MAX= is not allowed for the LIB and LIBR vaults. The format for the Vault Name control statement is:

1      8
VAULTS=vlt1[,vlt2,MAX=nnnnnn,vlt3,...vltnn]

Example

VAULTS=SAFE,DRA1,MAX=1000,DRA2,PERM,MAX=500

In this example four vault names are assigned: SAFE, DRA1, DRA2 and PERM. Vault DRA1 has a slot capacity of 1,000 and PERM contains 500 volumes. The statement must begin on position 1, as shown.

VMS supports an unlimited number of user-defined locations. VMS automatically accommodates the locations (blank)LIB and LIBR, so these locations do not need to be defined on the VAULTS= statement.

The (blank)LIB and LIBR locations are commonly used for prestaging or delaying movement of a tape from the library while keeping the tape under VMS protection. The (blank)LIB and LIBR locations are listed on the reports. Locations (blank)LIB and LIBR are in-house, and the volumes are placed in their normal slot in the tape library. Tapes vaulted to LIBR may not be recreated, but tapes vaulted to (blank)LIB are eligible for recreation. Tapes marked to either location are considered protected by VMS until VMS relinquishes control. The MAX= statement cannot be specified for LIB and LIBR.

Each location defined on the VAULTS= statement supports an unlimited number of slots for tape reel media and the same number for cartridge media. VMS recognizes the media type and moves it to the appropriate sub-vault for the location ID. Reports generated reflect reel and cartridge sub-vaults. Slots may be limited by specifying the MAX= statement after the vault name definition.

Note: The first tape to initially enter a vault always begins with SLOT 1. VMS automatically vaults to the first empty slot for subsequent executions.