HP 3000 Manuals

PURGEXL [ HP Link Editor/XL Reference Manual ] MPE/iX 5.0 Documentation


HP Link Editor/XL Reference Manual

PURGEXL 

This command purges selected modules from an executable library.  You can
purge individual modules by their entry point, module, and block data
name (HP FORTRAN 77) or by locality set name.

Syntax 

        {ENTRY= entry_name [,entry_name]...              }
PURGEXL {;MODULE= module_name [,module_name]...          }
        {;BLOCKDATA= blockdata_name [, blockdata_name]...}
        {;LSET= lset_name [,lset_name]...                }
             [;XL= xl_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 modules 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.

xl_file             Names the executable library containing the modules
                    to purge.  This file must have an NMXL filecode.
                    Default:  the current executable library established
                    by the last BUILDXL or XL command.

Examples 

       LinkEd> PURGEXL LSET=FILEINTRINS;XL=FILEIO

This command deletes every executable module that belongs to the
FILEINTRINS locality set in the FILEIO executable library.

       LinkEd> PURGEXL MODULE=SEEK

This command deletes the executable module named SEEK from the current
executable library.



MPE/iX 5.0 Documentation