Virtual TapeServer 6.02.00 Installation Guide

HP Virtual TapeServer Installation Guide 50 HP Part Number 528654-006 Sept 2006
VTS Policy Commands
Overview
The VTSPolicy command is a powerful tool designed to allow Virtual TapeServer users to
control many of the data movement functions of Virtual TapeServer from the NonStop server
connected to appliance. By including a TACL macro in user obey scripts, NonStop server
administrators can automate the functions of initiating Backup Management Applications, and
moving data to and from tape storage which may be shared among all of the systems in an
enterprise environment. Facilities are available to manage separate retention periods for data
stored on tape and on SAN arrays. Data resident on Virtual TapeServer storage may also be
moved to and from Virtual TapeServer systems at different sites, using multiple protocols, over
Fibre Channel or TCP/IP connections. The VTSPolicy command, and its parameters, are sent
to Virtual TapeServer by the NonStop system’s EMS messaging facility.
Using the TACL Macro
Including the TACL macro in a NonStop obey script, generates an EMS message containing the
VTSPolicy command. A sample might look like (the bolded statement is the talc macro):
#PUSH evt_x evt_error req_error req_read req_prompt
#PUSH action_id collector LOAD /LOADED evt_x/ $system.zspidef.zemstacl
#LOAD /LOADED evt_x/ $system.zspidef.zspitacl
#LOAD /LOADED evt_x/ $system.zspidef.ztactacl
#LOAD /LOADED evt_x/ $system.zspidef.ztaptacl
#DEF evt_buf STRUCT BEGIN BYTE b(1:3000); END;
#SET collector $0
#SET action_id 0
#SET evt_error [REQUESTER /WAIT/ READ [collector] req_error req_read req_prompt]
#PUSH evt_num action emphasis evt_text text_len
#SET evt_num 1234
#SET action -1
#SET emphasis -1
#SET evt_text VTSPolicy FTX “/VAULT01/Pool s=VTS1 st=VTS1 o=opt1 r=14,d”
#SET text_len SET evt_error [EMSINIT evt_buf [ZEMS^VAL^EXTERNAL^SSID] [evt_num]
#ZEMS^TKN^TEXT [charcount evt_text] [evt_text]]
#SET evt_error [SSPUT evt_buf ZEMS^TKN^EMPHASIS [ZSPI^VAL^TRUE]]
#SET evt_error [SSPUT evt_buf ZEMS^TKN^ACTION^NEEDED [ZSPI^VAL^TRUE]] #APPENDV
req_prompt evt_buf
The EMS message generated by this TACL macro and command structure is sent to Virtual
TapeServer. The operand and parameters are parsed and interpreted, and the appropriate
functions are executed without operator interaction.