1 08/02/84  gcos_tss_build_library, gtbl
 2 
 3 Syntax as a command:  gtbl input_libs {-control_args}
 4 
 5 
 6 Function:  This command builds or updates the GCOS software library,
 7 gtss_fast_library_, used by gcos_tss, and updates the program
 8 descriptors required to access the added software.
 9 
10 
11 Arguments:
12 input_libs
13    are the pathnames of one or more GCOS software libraries.  The input
14    libraries are either in native GCOS format (as copied from a GCOS
15    total system tape) or in GCOS environment simulator format (as
16    output from gcos_build_library).
17 
18 
19 Control arguments:
20 -brief, -bf
21    suppresses printing of information concerning updated modules and
22    program descriptors and the catalog, even if requested by the
23    -print_catalog control argument.
24 -module_file path, -mf path
25    path specifies the segment containing a list of modules to be moved
26    from the input libraries to the output library.  These names are
27    added to those specified by the -module control argument.
28 -modules STR1 {...STRn}, -mods STR1 {...STRn}
29    STRi specifies the name of the module to be moved from an input
30    library to the output library.  These names are added to those
31    specified by the -module_file control argument.
32 
33 
34 -output_library path, -olb path
35    specifies the path of the gtss_fast_library_ output library.  If the
36    library already exists, it is appended to.
37 -print_catalog, -prcat
38    prints the catalog (modules and offsets) of an input library if the
39    library is in simulator format.
40 -program_descriptors path, -prgdes path
41    path specifies the gtss program descriptors (a copy of
42    gtss_prgdes_alm_.incl.alm) to be updated.
43 
44 
45 Notes:  If no output library path is specified, then only a list of the
46 modules found on the input libraries is printed.
47 
48 To use the added modules in gtss, the -prgdes control argument must be
49 used.  Then gts_prgdes_ext_.alm must be reassembled with the
50 gtss_prgdes_alm_.incl.alm specified by -prgdes.  Following this, gtss
51 must be rebound with the new gtss_prgdes_ext_, and the updated output
52 library must be copied to gtss_fast_library_ in the directory
53 containing gtss (or a link established).
54 
55 This is the only procedure required to add PSP or user software to the
56 gcos_tss library for which there are program descriptors.
57 
58 
59 If the -modules and -module_ file control arguments are not specified,
60 then all modules found on the input libraries are copied to the output
61 library.  The only exception is when the -prgdes control argument is
62 specified.  In this case, only modules on the input libraries, which
63 are actually needed by the program descriptor file, are copied.