1 08/02/84  gcos_extract_module, gcem
 2 
 3 Syntax as a command:  gcem control_path input_path output_path
 4    {-control_arg}
 5 
 6 
 7 Function:  This command extracts one or more modules from a (tape
 8 format) GCOS system-loadable file, or a simulator-format software
 9 library, placing them in an output file.  The names of the modules to
10 be extracted are given in a control file.
11 
12 
13 Arguments:
14 control_path
15    is the pathname of a segment containing the names of the modules to
16    be extracted (in lowercase ASCII), each on a separate line.  This
17    segment can be created by the gcos_library_summary command, using
18    the -brief control argument and preceding it by the file_output
19    command, and then editing the resulting segment to remove the names
20    of unwanted modules; or the segment can be created directly by any
21    of the Multics editors.
22 input_path
23    is the pathname of a file containing GCOS modules.  It can be a file
24    copied from a GCOS total system tape with gcos_pull_tapefile, or it
25    may be a simulator-format library produced by gcos_build_library.
26 
27 
28 output_path
29    is the pathname of the output file into which the extracted modules
30    are to be written.  If the file already exists, it is appended to,
31    enabling the construction of a single library from several smaller
32    ones.
33 control_arg
34    can be -brief which inhibits printing the name of each module
35    copied.
36 
37 
38 Notes:  The names of each module copied are printed on user_output,
39 unless the -brief control argument is given.  The names of any
40 requested modules that are not found in the input file are printed on
41 error_output.
42 
43 This command cannot be used to manipulate a random system-loadable file
44 (GCOS format **, Q* or H* file).