1 02/12/81  carry_load
 2 
 3 Syntax:  carry_load tape_number {-control_args}
 4 
 5 
 6 Function: Loads a carry tape at its target site.
 7 
 8 
 9 Arguments:
10 tape_number
11    is the identifier of the tape to be read.
12 
13 
14 Control arguments:
15 -comment STR, -com STR
16    prints a message STR at the operator's console when asking for the
17    tape specified by the tape_number argument or by the previous
18    -next_vol control argument. This comment can be used to specify a
19    tape identifier at the loading site when it is different from the
20    identifier of the same tape at the sending site.
21    (See "Examples" below.)
22 -copy_dir PATH, -cpd PATH
23    specifies a directory PATH under which to retrieve copies of any
24    files or subtrees that cannot be loaded in place due to lack of
25    access or quota. The default directory for copies is:
26           >ddd>carry_dir>copies
27 
28 
29 -force, -fc
30    causes the tape to be loaded even if it is more than five days old.
31    By default, an old tape is not loaded and an error message is printed.
32 -next_vol STR, -nxv STR
33    specifies the identifier STR of a continuation tape when more than
34    one tape was written by an invocation of carry_dump. Multiple
35    occurrences of this control argument are allowed. Note that it
36    should only be used for continuation tapes. If the tape identifier
37    of a continuation tape is different at the loading site than at
38    the sending site, the -comment control argument should be used
39    after this argument.
40 -queue_dir PATH, -qd PATH
41    specifies the pathname PATH of the carry queue's parent directory
42    at the sending site, if different from >ddd>carry_dir.
43 
44 
45 Notes:
46 When a request cannot be loaded in place due to access or quota, a
47 copy is loaded in the directory >ddd>carry_dir>copies. This directory
48 name replaces the first two levels of the entry's pathname. For example,
49 if the entry:
50      >udd>Demo>JRSmith>tx.archive
51 cannot be reloaded, the retrieved copy is named:
52      >ddd>carry_dir>copies>JRSmith>tx.archive
53 
54 
55 Examples:
56      carry_load 50204 -nxv 50011 -nxv 50012
57 
58 loads 3 tapes (written by one invocation of carry_dump) in the order
59 50204, 50011, 50012.
60 
61      carry_load 50207 -com TX653 -nxv 50201 -com TX647
62 
63 loads two tapes written by "carry_dump 50204" at the sending site but
64 for which the tapes are registered at the loading site as TX653 and
65 TX647.