BackBox H4.00 VTC Scripting Option

Detailed description
4 BackBox H4.00 VTC Scripting Option
For this purpose, the name of all paths configured in the Data Store is passed in two
Windows variables %BBOX_CONF_PATH_NUMBER% and
%BBOX_CONF_PATH<n>%. See the table of named variables. This maximum
cleanup might consume several minutes depending on the startup time of the backup
software and the number of paths to clean.
Script variables and control
The BackBox software does not monitor the outcome of the script execution, except
reporting the return code of each script execution to the Guardian EMS sub-system.
However, when running the restore script, the restored files are used only if the
script completes with a zero return-code.
Note that some enterprise backup software, including TSM, returns a non-zero
completion code even when the backup or restore completed successfully. In these
cases, the script might end by SET ERRORLEVEL=0 but the user should set ways to
ensure the proper backup execution.
The Guardian tape application will consider the execution successful if the virtual
volume was written to the Data Store. If a backup script fail to archive a virtual
volume it is critical that script report the error. The EMS message #3171 is issued in
addition to other messages reporting an error in a script execution.
The output of the script execution is located in the Windows ProgramData directory,
in a distinct sub-directory per Data Store. The name of the output file is build with:
• The name of initiator script (Windows service)
VTC – Emulator service
ADMIN – Administrative service
SCRIPTCTLR – Script controller service
• The file name of the script
• A sequence number assigned up to 1000 in a round-robin fashion
• The .log suffix
The round robin assignment of the sequence number provides an automatic purge in
each script Log directory.
File name syntax in script parameters
The fully qualified names of files to process are passed to the scripts.
In positional parameters (%1, %2 etc..), the file name is enclosed by double-quotes
when it contains a space; no double-quotes when no space.
In named parameters (%BBOX_DEST_FILE_DAT%...), the file name is never
enclosed by double-quotes.