Virtual TapeServer 6.03.42 Operations and Administration Guide

Migrating Data to Physical Tape | 111
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 BMA 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.
Note VTSPolicy performs incremental migrations; VTS migrates data that has changed
since the last migration.
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,
selective, backup, or incr (for incremental). 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.
For example, to migrate the pool named PoolA on the VTS1 server to the /tape/opt1 file and
erase the selected files from VTS, issue the following command:
VTSPolicy TSM 'archive /VAULT01/PoolA s=VTS1 o=/tape/opt1 ERASE=YES'