Examples: Different Ways To Use Backcopy; Completion Information; Completion Codes Returned By Backcopy And The Operating System - HP BACKCOPY Reference Manual

Examples: Different Ways to Use BACKCOPY

To read an unlabeled backup tape on the device $TAPE1 and duplicate it on
\REMOTE.$TAPE2:
1> BACKCOPY $TAPE1, \REMOTE.$TAPE2, *.*.*, LISTALL
To read a labeled BACKUP tape and create an unlabeled duplicate of it on $TAPE2:
2> ADD DEFINE =Input, CLASS TAPE, LABELS BACKUP, &
2> &VOLUME (FOX082,FOX004)
3> BACKCOPY =Input, $TAPE2, *.*.*
To read an unlabeled BACKUP tape on $TAPE1 and create a labeled duplicate of it:
4> ADD DEFINE =Output, CLASS TAPE, LABELS BACKUP, &
4> &VOLUME SCRATCH
5> BACKCOPY $TAPE1, =Output, *.*.*
To read an unlabeled BACKUP tape on $TAPE1 and create two identical copies of it using
tape format 3 (the default format when two copies are made):
6> BACKCOPY $TAPE1,($TAPE2, $TAPE3), *.*.*
To copy a tape from an appendable pool to a nonappendable pool:
7> add define =DEF1, class tapecatalog, pool weekly, volcat
\CAUNI3.SILO1_VOLCAT, gen 1, version 0, device $tape0,
filecat
\CAUNI3.SILO1_FILECAT,FILEID W00032,USE IN
8> add define =DEF2, class tapecatalog, pool
weekly_appendable, volcat
\CAUNI3.SILO1_VOLCAT, device $tape2, filecat
\CAUNI3.SILO1_FILECAT,FILEID W00007,USE OUT
9> backcopy =DEF1, =DEF2, *.*.*, LISTALL, NOREWINDOUT
NOTE: You can also use the process in this example for importing or exporting to an appendable
pool.

Completion Information

BACKCOPY returns a completion code to the process that started it. The completion code indicates
how successfully BACKCOPY ran. Its primary purpose is to support batch processing by allowing
conditional execution of subsequent processes based on the success of the BACKCOPY operation.
If TACL started BACKCOPY, the completion code is stored in a TACL variable (:_COMPLETION),
where you can examine it by using TACL functions. TACL also displays the completion codes at
the home terminal unless BACKCOPY completes without any warnings or errors. For more
information about completion codes and batch processing, see the TACL Programming Guide.
BACKCOPY also returns a subsystem identifier (TANDEM.76.version), where version is the
release number (for example, D46). The subsystem identifier is also stored in the TACL variable
(:_COMPLETION).
Table 6 Completion Codes Returned by BACKCOPY and the Operating System
Code
0
1
2
Description
A normal, voluntary termination. The process finished normally with no errors or warnings.
A normal, voluntary termination with warnings. All files were copied, but warnings were
issued for one or more files. (Only file-specific warnings cause this code.)
An abnormal, voluntary termination with errors. BACKCOPY could not copy one or more
files because of errors on the files. BACKCOPY terminates without finishing the copy.
Completion Information 37