Virtual TapeServer 6.03.41 Operations and Administration Guide

84 | Migrating Data to Physical Tape
destination VTS, after the pool is copied there. This keyword is optional but
destination must be specified if this keyword is set.
optfile or o
Specifies a UNIX absolute path to the TSM optfile file, which is required for
archive operations. This keyword is optional but required if the sourceTSM or
destinationTSM keywords are specified.
VTSretain or r
Specifies the time period that must elapse after which VTS will erase the
virtual tapes in the specified pool. This time period commences when the
source system receives the EMS message specifying the VTSPolicy TSM
request and is applied to the source and destination systems.
Specify the time period in the following format: nn,U. nn is an integer value
between 1 and 99, and U is the units to apply to that integer and must be one
of following: m (minutes), h (hours), d (days), w (weeks), or y (years). The
comma separator is optional. Note that erasure may be postponed, as
necessary, if the pool copy or backup processing has not yet been completed.
For example, to migrate the pool named Pool1 on the VTS1 server to the /tape/opt1 file and
erase the selected files from VTS after seven days, issue the following command:
VTSPolicy TSM “/VAULT01/Pool1 s=VTS1 st=yes o=/tape/opt1 r=7,d”
To transfer files from /VAULT01/Pool1 on VTS1 to VTS3, create a TSM archive tape on
VTS1 in the /tape/opt1 file, and erase the selected files from VTS1 after seven days, specify
the following command:
VTSPolicy TSM “/VAULT01/Pool1 s=VTS1 d=VTS3, st=yes o=/tape/opt1 r=7,d”
Note that the retention keyword (r) refers to the VTS storage retention period. The selected
files are those that were added or changed since the last VTSPolicy command issued for
/VAULT01/Pool1.
FUP utility call
A simple FUP utility call can copy the contents of a text file to the $0 process.
1. Create a text file named TEXT1 on the NonStop server. Add the VTSPolicy command to
the file. Here is an example that uses Tivoli Storage Manager to migrate a virtual tape
named cartridge1. The virtual tape resides in the VAULT01 vault and the Pool1 pool:
VTSPolicy TSM “/VAULT01/Pool1/cartridge1 s=VTS1 st=yes o=/tape/opt1
r=7,d”
See The VTSPolicy command on page 83 for a description of the command syntax.
2. From Batchcom or in an existing backup script, run the following command:
FUP COPY TEXT1, $0
This sends the contents of the TEXT1 file to the EMS collector.
TACL macro in obey script
On the NonStop server, you can create an obey script that includes a TACL macro that
communicates with the VTS server through EMS. In the script file, add the commands
specified below. To initiate the script, run the script using the obey command, add the lines to
the end of an existing script, or schedule the script to run from Batchcom.