-COPY [ MPE Segmenter Reference Manual ] MPE/iX 5.0 Documentation
MPE Segmenter Reference Manual
-COPY
Copies one or more Relocatable Binary Modules (RBMs) from the auxiliary
User Subprogram Library (USL) file to the currently-managed USL file.
SYNTAX
-COPY [UNIT, ] name[(index)]
[SEGMENT,]
PARAMETERS
UNIT Transfers the RBM identified by name [(index)]" from the
source USL file. (Default.)
SEGMENT Transfers all RBMs associated with the segment name from
the source USL file. (The source USL file is the one
specified by an AUXUSL command.)
name Identifies the RBM to be transferred if UNIT is
specified. If SEGMENT is specified, name identifies the
segment from which all RBMs are transferred.
index An integer further specifying the RBM name. The index
may be used when more than one RBM of this name exists
in the USL file. If index is omitted, a default value
of 0 (the most recent active occurrence) is assigned.
The index parameter is ignored if SEGMENT is specified.
CAUTION The Segmenter will not deactivate already existing active RBMs
of the same name, and such a duplication will cause a -PREPARE
failure. Therefore, check your USLs and deactivate RBMs as
necessary before you use -COPY.
EXAMPLE
-COPY SEGMENT,SEGNAME Copies all RBMs associated with the segment
name SEGNAME.
MPE/iX 5.0 Documentation