HP 3000 Manuals HP 3000 Manuals
EXTRACTRL
This command extracts selected relocatable object modules from a
relocatable library and places them into a new relocatable object file.
You can extract specific modules by their entry point, module and block
data name (HP FORTRAN 77) or by their locality set name.
This command does not delete the extracted modules from the relocatable
library.
Syntax
EXTRACTRL [ENTRY= entry_name [ ,entry_name]...]
[;MODULE= module_name [ ,module_name]...]
[;BLOCKDATA= blockdata_name [, blockdata_name]...]
[;LSET= lset_name [ ,lset_name]...]
[;FROM= source_file]
[;TO= object_file]
Parameters
The first four parameters (ENTRY, MODULE, BLOCKDATA, and LSET) identify
specific modules to extract. You can use any one by itself, or you can
use them in combination. If you omit these parameters, the entire
relocatable library is extracted.
entry_name Extracts 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 Extracts 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 Extracts 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 Extracts 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 extract. The file must have the filecode NMRL.
Default: the current relocatable library established
by the last BUILDRL or RL command.
object_file Names the relocatable object file to be created (it
is created with the filecode NMOBJ). The name must
conform to the conventions established for MPE XL
file names. The file must not already exist in the
specified group. If it does, an error message is
printed. Default: the system file, $NEWPASS.
Examples
LinkEd> EXTRACTRL LSET=CLIP;TO=WINDOWS
This command extracts all relocatable object modules which are associated
with the CLIP locality set from the current relocatable library and
places them into the new relocatable object file, WINDOWS.
LinkEd> EXTRACTRL
This command extracts all the relocatable object modules from the current
relocatable library and places them into the relocatable object file
$NEWPASS.