PURGERL [ HP Link Editor/XL Reference Manual ] MPE/iX 5.0 Documentation
HP Link Editor/XL Reference Manual
PURGERL
This command deletes selected modules from a relocatable library. You
can purge specific modules by their entry point, module, and block data
name (HP FORTRAN 77) or by their locality set name.
Syntax
{ENTRY= entry_name [,entry_name]... }
PURGERL {;MODULE= module_name [,module_name]... }
{;BLOCKDATA= blockdata_name [, blockdata_name]...}
{;LSET= lset_name [,lset_name]... }
[;RL= rl_file]
Parameters
The first four parameters (ENTRY, MODULE, BLOCKDATA, and LSET) identify
specific modules to purge. You can use any one by itself, or you can use
them in combination. Modules matching any of the criteria that you enter
are purged.
entry_name Purges 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 Purges 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 Purges 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 Purges 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.
rl_file Names the relocatable library containing the modules
to purge. The file must have an NMRL filecode.
Default: the current relocatable library established
by the last BUILDRL or RL command.
Examples
LinkEd> PURGERL LSET=CLIP;RL=WINDOWS
This command deletes all relocatable object modules that belong to the
CLIP locality set from the WINDOWS relocatable library.
LinkEd> PURGERL MODULE=GRAPH
This command deletes the relocatable object module named GRAPH from the
current relocatable library.
MPE/iX 5.0 Documentation