Virtual TapeServer 6.04.04 for NonStop Servers Operations and Administration Guide

Migrating Data to Physical Tape | 89
If the return code indicates a failure, VTS does not mark the virtual tape as migrated and
notes this in the log file.
If the NonStop server requests a virtual tape that was migrated, VTS checks the size of the
requested virtual tape. If the size is 0, the virtual tape was erased and VTS attempts to
retrieve the data and recreate the virtual tape from physical tape. To accomplish this, VTS
references the metadata within the virtual tape and generates a request to the backup
management application to restore the data. After the data is restored, the virtual tape is
mounted. The NonStop server can then recognize the virtual tape online and begin to restore
it.
You can automate migration by issuing the VTSPolicy command using the FUP utility or by
adding the command to a TACL script.
The VTSPolicy command for IBM Tivoli Storage Manager
Here is the syntax of the VTSPolicy command for use with IBM Tivoli Storage Manager. Note
that all parameters specified for the command are case-sensitive.
VTSPolicy TSM 'backup_type /VAULTxx/pool/cartridge [keyword=value ...]'
where
backup_type
Specifies the type of backup. You can specify one of the following values: archive or
selective. The most commonly used type is archive, though you may want to contact
your Tivoli administrator for more information.
/VAULTxx/pool/cartridge
Specifies the pool and cartridge on which to operate. If you want to migrate an entire
pool, specify /VAULTxx/pool only.
keyword=value
Specifies a valid combination of keywords and their values. Supported keywords
include the following:
source or s
Specifies the fully-qualified hostname of the VTS system on which the
specified pool resides. In a VTS cluster, this keyword specifies the VTS server
that will execute the command. This keyword is required in a VTS cluster.
optfile or o
Specifies a UNIX absolute path to the TSM optfile file, which is required for
archive operations. This keyword is required.
erase Enables VTS to erase the virtual tape after migration is completed
successfully. Set this keyword to YES or NO. This keyword is not required
and defaults to NO.
delete Enables VTS to delete the virtual tape after migration is completed
successfully. Set this keyword to YES or NO. This keyword is not required
and defaults to NO.
empty Enables VTS to migrate empty cartridges. Set this keyword to YES or NO.
This keyword is not required and defaults to NO.
locked
Enables VTS to lock all specified virtual tapes. Set this keyword to YES or
LOCK. This keyword is not required and defaults to LOCK.