1 08/02/84  gcos_pull_tapefile, gcpt
 2 
 3 Syntax as a command:  gcpt {reel_number} {-control_args}
 4 
 5 
 6 Function:  This command copies files from a GCOS tape into the Multics
 7 storage system.  Since it was designed to read files from a total
 8 system tape, from which the gcos simulator libraries are built, it
 9 accepts records longer than 320 words.  It reads the header label
10 preceding each file, prints the name and file sequence number, and asks
11 the user if the file is to be copied.  If the answer is yes, it asks
12 for a pathname, and copies the file into it.  Then it continues with
13 the next file.  This process is terminated either by a reply of "quit"
14 to the copy question, or an end-of-reel label or partial label on the
15 tape.
16 
17 
18 Arguments:
19 reel_number
20    is the number of the tape reel to be read.  It need not match any
21    field in the tape labels.  (See -attached control argument.)
22 
23 
24 Control arguments:  can be selected from the following, and can be in
25    any order:
26       NOTE:  The following list identifies all control arguments
27       grouped by function.
28       ATTACHING TAPE
29          -attached
30          -block
31          -density
32          -detach
33          -gsr
34          -retain
35 
36 
37       PROGRAM CONTROL
38          -brief
39          -long
40          -long_brief
41          -skip
42    -attached, -att
43       may be given in place of reel_number to indicate that the tape
44       has been retained from a previous use of this command and is
45       already mounted.  (See -retain control argument)
46    -block N
47       N specifies the tape buffer size (any value up to 4096) needed to
48       read a GCOS total system tape.  This argument is not required in
49       order to read a total system tape, but is needed for tapes with
50       records larger than 3842 words.  (Default is 3842)
51 
52 
53    -brief, -bf
54       specifies that certain warning and informative messages NOT be
55       displayed.
56    -density N, -den N
57       N specifies tape density.  (Default is 1600)
58    -detach, -det
59       specifies detaching and dismounting of the tape before any
60       attempt is made to attach the currently specified tape.  If this
61       is the only argument given, the tape is detached and no other
62       processing takes place.
63 
64 
65    -gsr
66       specifies standard size records (320 words or less) to be copied
67       into the Multics storage system in a format readable by other
68       Multics tools that manipulate GCOS files.  Records shorter than
69       320 words are padded out to 320 words, allowing a read of 320
70       words to obtain exactly one record.  This argument should not be
71       used when reading a total system tape.
72    -long, -lg
73       specifies that hardware status, labels, and length and first word
74       of all data records be displayed.
75    -long_brief, -lb
76       specifies that hardware status and labels be displayed, but
77       length and first word of data records NOT be displayed.
78 
79 
80    -retain, -ret
81       specifies that the tape remain mounted when processing by this
82       command is completed.  This saves work for the Multics operator
83       if several attempts to read the tape are to be made.
84    -skip N
85       N specifies the files to be skipped over before the user is asked
86       if files are to be copied.  (Questioning starts with N+1st file.)