BackBox H4.00 VTC Scripting Option

Detailed description
2 BackBox H4.00 VTC Scripting Option
Restore script
When a virtual volume is loaded and either one or both the disk files representing
the volume are missing, the restore script is executed. When the two files are
missing, a single script execution can restore both files. The emulator waits for the
script completion to complete the volume load.
Positional parameters
In addition to the named parameters set in the Windows process context (see later
in this section), the Restore script receives either two or five positional parameters to
pass the original file name(s) and the new name(s) to restore.
If a single file must be restored, either the index file or the data file. The script
receives two parameters:
• %1 contains the fully qualified original file name that is missing.
• %2 contains the fully qualified target file name (might be equal to
%1).
•
If both index file (file type .IND) and data file (file type .DAT) are to be restored, the
script receives 5 parameters:
• %1 contains the fully qualified original index file name (type .IND).
• %2 contains the fully qualified target index file name (type .IND).
• %3 contains the fully qualified original data file name (type .DAT).
• %4 contains the fully qualified target data file name (type .DAT).
• %5 contains a fully qualified file name pattern for both file
If the script receives 5 parameters but processes only the parameters %1 and %2,
the script will be fetched again with 2 parameters to restore the 2
nd
file.
The content of the positional parameters is also available in these named
parameters:
%1 value is in %BBOX_ORIG_FILE_IND%
%2 value is in %BBOX_DEST_FILE_IND%
%3 value is in %BBOX_ORIG_FILE_DAT%
%4 value is in %BBOX_DEST_FILE_DAT%
%5 value is in %BBOX_ORIG_FILE_PATTERN%
Note: The Archive bit of files restored by the restore script for a NonStop restore
operation is reset by the VTC emulator.
Execution control
The emulator uses the restored files only if the return code of the restore script is 0.