HP 3000 Manuals HP 3000 Manuals
COPYRL
This command copies relocatable object modules from one relocatable
library to another. You can copy specific modules by their entry point,
module, and block data name (HP FORTRAN 77) or by their locality set
name.
Syntax
COPYRL [ENTRY= entry_name [ ,entry_name]...]
[;MODULE= module_name [ ,module_name]...]
[;BLOCKDATA= blockdata_name [, blockdata_name]...]
[;LSET= lset_name [ ,lset_name]...]
[;FROM= source_file]
[;TO= dest_file]
[;REPLACE]
Parameters
The first four parameters (ENTRY, MODULE, BLOCKDATA, and LSET) identify
specific modules to copy. You can use any one by itself, or you can use
them in combination. If you omit these parameters, the entire
relocatable library is copied.
entry_name Copies the module(s) that define (export) the
symbolic
entry_name. You can enter an indirect file for this
parameter. Entry_name is case sensitive.
module_name Copies only those modules having the name,
module_name. If you do not use the RLFILE compiler
directive, this is the name of the source file from
which the relocatable object module was compiled. If
you use the RLFILE compiler directive, see the
appropriate language appendix (appendix B, C, D, or
E) for the definition of this name. You can enter an
indirect file for this parameter.
blockdata_name Copies only those modules having the name,
blockdata_name. Use this parameter only for HP
FORTRAN 77 block data subprograms. You can use an
indirect file name for blockdata_name.
lset_name Copies those modules that contain code belonging to
the locality set ( lset_name) that you enter. A
module can contain several locality sets, or there
can be several modules within a locality set. Each
compiler provides its own directives for placing
procedures into locality sets (check your language
manual to see if locality sets are available). You
can enter an indirect file for this parameter.
source_file Names the relocatable library containing the modules
to copy. The file must have an NMRL filecode.
Default: the current relocatable library established
by the last BUILDRL or RL command. (If you use the
default, you must enter the TO= dest_file parameter.)
dest_file Names the relocatable library where the modules are
placed. When dest_file is an existing file, it must
have the filecode NMRL. Default: the current
relocatable library established by the last BUILDRL
or RL command. (If you use the default, you must
enter the FROM= source_file parameter.)
REPLACE Specifies that when symbols in the module(s) being
copied are duplicates of symbols in any module in the
destination library, then the modules with duplicate
symbols residing in the destination library are
removed. The new module is added before any of the
modules in the library are removed.
Examples
LinkEd> COPYRL LSET=CLIP;TO=WINDOWS
This command copies all relocatable object modules which are associated
with the CLIP locality set from the current relocatable library and
places them into the WINDOWS relocatable library.
LinkEd> COPYRL FROM=LINEDRAW
This command copies all the relocatable object modules from the
relocatable library LINEDRAW and places them into the current relocatable
library.