SEGMENTER



SEGMENTER

     Calls the MPE segmenter.  (CM)

SYNTAX

     SEGMENTER [listfile]


PARAMETERS

listfile            Actual file designator of an ASCII output file that
                    is to receive listed output from the MPE segmenter.
                    Formal file designator is SEGLIST.  Default is
                    $STDLIST.  Usually this file is a line printer and
                    must be defined in a FILE command, backreferenced
                    as follows:

                    FILE LISTFL;DEV=LP
                    SEGMENTER *LISTFL

NOTE

The formal file designator used in this command, SEGLIST, cannot be
backreferenced as actual file designator in the command parameter list.
For further information, refer to IMPLICIT subentry of the FILE entry
in the Help Facility.


OPERATION


This command runs the segmenter subsystem from MPE/iX.
The segmenter subsystem performs the intermediate functions
between source code compilation and program execution.

This command may be issued from a session or a job. It may
not be issued in BREAK or from a program, unless the user or
the MPE segmenter has Process Handling (PH) capability.
Pressing [Break] suspends the execution of this command.
Entering RESUME continues the execution.

Segmenter Commands

Information is available on the following classes of commands:

Managing USL files
Managing RL files
Managing SL files
Showing information about the Segmenter Session
Terminating Segmenter
Redo commands

For more information, enter a KEYWORD. You can also enter any command
name as a keyword. Enter 'HELP' for information on help. Enter 'EXIT'
to leave help.

   Managing USL files

Following are the commands used:

USL
AUXUSL
BUILDUSL
LISTAUX
LISTUSL
NEWSEG
CEASE / USE
HIDE / REVEAL
PURGERBM
PREPARE
ADDRL
ADDSL
COPY
COPYUSL
CLEANUSL

You can use any command name as a keyword.

   Managing RL files

 Following are the commands used:

RL
BUILDRL
ADDRL
LISTRL
PURGERL

You can use any command name as a keyword.

   Managing SL files

     Following are the commands used:

SETFPMAP
SL
BUILDSL
ADDSL
LISTPMAP
LISTSL
PURGESL
CLEANSL
COPYSL

You can use any command name as a keyword.

   Showing information about the Segmenter Session

    -SHOW

Displays the open files and Segmenter parameters.

   Terminating Segmenter

To terminate  Segmenter, enter  the

 -EXIT command.

This command can be abbreviated to -E.

   ADDRL

Adds a procedure to the currently-managed Relocatable Library (RL) file.
You must have READ and WRITE access to the specified RL file.

SYNTAX

-ADDRL name[(index)]

PARAMETERS

name The name (primary entry point) of the Relocatable Binary Module
(RBM) containing the procedure to be added to the RL file.

index An integer further identifying the RBM. The index may be used
when the currently managed USL file contains more than one
active RBM of this name. If index is omitted, a value of
(the most recent active occurrence) is assigned by default.

EXAMPLE

To add an RBM containing one procedure named XBM to an RL file, enter:

-ADDRL XBM

   ADDSL

Adds procedures to a Segmented Library (SL) file.

SYNTAX

-ADDSL name[;PMAP][;FPMAP][;NOSYM]

PARAMETERS

name The name of the segment to be added to the SL file.

PMAP An indication that a listing describing the prepared segment
will be produced on the file specified in the MPE :SEGMENTER
command parameter listfile, which defaults to $STDLIST. If
this parameter is omitted, the prepared segment is not listed.

FPMAP Request to have internal PMAP information included in the SL segment.

NOSYM Suppresses the symbolic debug option. Refer to the HP Toolset
Reference Manual (32350-90001).

EXAMPLE

To add segment SL1 to the currently managed SL file and produce a
listing of the segment, enter:

-ADDSL SL1;PMAP

   AUXUSL

Opens an auxiliary USL file for management.

SYNTAX

-AUXUSL filereference

PARAMETERS

filereference The name (and optional group and account name) of
the auxiliary USL file from which RBMs may be
transferred to the current USL file.

EXAMPLE

-AUXUSL FILE1 Opens the auxiliary USL file FILE1 for management.

   BUILDRL

Creates a permanent, formatted Relocatable Library (RL) file.

SYNTAX

-BUILDRL filereference,records,extents

PARAMETERS

filereference The name, and optional group and account name, of the
RL file.

records The total maximum file capacity, specified in terms
of 128 word binary logical records.

extents The total number of disc extents that can be
dynamically allocated to the file as logical records
are written to it. The extents value must be an
integer from 1 to 32.

EXAMPLE

-BUILDRL R1.G1.A1,500,1 Creates an RL file named R1.G1.A1. The RL
file can contain 500 records, and is
allocated one disc extent.

   BUILDSL

Creates a permanent, formatted Segmented Library (SL) file.

SYNTAX

-BUILDSL filereference,records,extents

PARAMETERS

filereference Any file whose local name is SL. You can create an
SL file with a local name other than SL, but such
a file cannot be searched by the MPE :RUN command or
the CREATE or LOADPROC intrinsics unless it is
renamed SL.

records The total maximum file capacity, specified in terms
of 128 word binary logical records.

extents The total number of disc extents that can be
dynamically allocated to the file as logical records
are written to it. The size of each extent is
determined by the records parameter value divided
by the extents parameter value. The extents value
must be an integer from 1 to 32.

EXAMPLE

-BUILDSL SEARCH,300,1 Creates an SL file named SEARCH with
records and one disc extent.

   BUILDUSL

Creates a new (job/session temporary) User Subprogram Library (USL) file.

SYNTAX

-BUILDUSL filereference,records,extents

PARAMETERS

filereference The name (file designator) assigned to the new USL
file. This is a fully qualified file reference that
may include file name, group name, and account name,
plus a lockword.

records The length of this file, specified in terms of
word binary logical records.

extents The total number of disc extents that can be
dynamically allocated to the file as logical records
are written to it. The size of each extent is
determined by the records parameter value divided
by the extents parameter value. The extents value
must be an integer from 1 to 32.

EXAMPLE

-BUILDUSL FILE2,200,1 Creates a new temporary USL file, FILE2,
with 200 records and one disc extent.

   CEASE

Deactivates  one or  more  entry  points  in the  currently managed User
Subprogram Library (USL) file.

SYNTAX

[ENTRY, ]
-CEASE [UNIT, ] name[(index)]
[SEGMENT,]

PARAMETERS

ENTRY Deactivates the entry point indicated by name [(index)].
(Default)

UNIT Deactivates all entry points in the Relocatable Binary Module
(RBM) indicated by name [(index)].

SEGMENT Deactivates all entry points in all RBMs associated with
segment name.

name The name of the entry point, RBM, or segment.

index An integer further identifying the entry point name. The
index may be used when the USL file contains more than
one entry point of the same name. If SEGMENT is specified,
the index parameter is ignored.

If index is omitted, a default value of 0 (the most recent
active occurrence) is assigned. An index n means the nth
occurrence, whether active or inactive. However, there is no
point in using this command with an entry point you know to
be inactive, since its purpose is to deactivate active entry
points.

EXAMPLE

-CEASE ENTRY,BEGIN2 Deactivates entry point BEGIN2.

   CLEANSL

Copies  the  contents of  the currently  managed  Segmented Library (SL)
file to a new SL file, eliminating any fragments of free space in
each of the segments. The new SL file will be of the same size as the
old one; that is, it may hold up to the same maximum number of records.

SYNTAX

-CLEANSL [filename]

PARAMETERS

filename The name of the new SL file. If you omit this
parameter, the Segmenter will purge the old SL file,
giving its name to the new file. In either case,
the new SL file is a permanent file.

EXAMPLE

-SL MYSL Opens the SL file MYSL as the currently managed SL
file.

-CLEANSL NEWSL Copies the contents of the SL file MYSL into the new
SL file NEWSL, eliminating any fragments of free
space in each of the segments. NEWSL is now the
currently managed SL file.

   CLEANUSL

Copies  only  the  active  Relocatable  Binary  Modules  (RBMs)  of  the
currently managed User Subprogram Library (USL) file to a new USL file.
The new USL file will be the same size as the old one; that is, it will
hold up to the same maximum number of records.

SYNTAX

-CLEANUSL [filename]

PARAMETERS

filename The name of the new USL file. If you omit this
parameter, the Segmenter will purge the old USL file,
giving its name to the new USL file. In either case,
the new USL file is a permanent file.

EXAMPLE

-USL SEARUSL Opens SEARUSL as the currently managed USL
file.

-CLEANUSL SEARUSL7 Copies only the active contents of the USL
file SEARUSL into the new USL file
SEARUSL7. SEARUSL7 is now the currently
managed USL file.

   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
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.

EXAMPLE

-COPY SEGMENT,SEGNAME Copies all RBMs associated with the segment
named SEGNAME.

   COPYSL

Copies  the  contents of the  currently managed  Segmented  Library (SL)
file to a new SL file, eliminating any fragments of free space while
allowing you to control the size of the new file. This command is
different from -CLEANSL in that you may change the amount of file
space used by the file.

SYNTAX

-COPYSL percent[,filename][;USERFORMAT]

PARAMETERS

percent The amount of extra file space you want the new file
to have, expressed as a percentage of the minimum
amount of space needed to hold the segments. This
parameter must be an integer, not less than 0 or
greater than 9900.

filename The name of the new SL file. If you omit this
parameter, the Segmenter will purge the old SL file,
giving its name to the new file. In either case, the
new SL file is a permanent file.

USERFORMAT The resulting SL will be converted to a group or an
account SL structure provided all active segment
numbers are less than %377. If the currently managed
SL is already a group or account SL structure, this
parameter is ignored. If this parameter is omitted,
the new SL structure will be the same as the old SL
structure.

EXAMPLE ONE

-SL MYSL Opens the SL file MYSL as the currently managed SL
file.

-COPYSL 40,NEWSL Copies the contents of the SL file MYSL into the new
SL file NEWSL, building NEWSL with 40% more free
space than the minimum presently needed to hold the
segments.

EXAMPLE TWO

-SL SL.PUB.SYS Opens the system SL as the currently managed SL file.

-COPYSL 1,MYSYSSL;USERFORMAT Copies the contents of the system
SL into the new SL file MYSYSSL,
building MYSYSSL with 1% more
free space than the minimum needed
to hold the segments. If the system
SL has no segment numbers greater
than %376, MYSYSSL will have the
group / account SL structure,
otherwise it will retain the system
SL structure.

   COPYUSL

Copies the entire currently managed User Segmented Library (USL) file to
a new USL file, while allowing you to control the size of the new USL
file. Unlike the -COPYSL command, the -COPYUSL command does no
"cleaning." This command will copy inactive RBMs to the new file as
well as active RBMs.

SYNTAX

-COPYUSL percent[,filename]

PARAMETERS

percent The amount of extra file space you wish the new USL
file to have, expressed as a percentage of the
minimum space needed to hold the file. This
parameter must be an integer not less than 0 or
greater than 9900.

filename The name of the new USL file. If you omit this
parameter, the Segmenter will purge the current USL
file, giving its name to the new USL file.

EXAMPLE

-USL SEARUSL Opens the USL file SEARUSL as the currently
managed USL file.

-COPYUSL 100,SEARUSL5 Segmenter copies all of SEARUSL to new file
SEARUSL5, giving SEARUSL5 100% more free
space than the minimum presently needed to
hold the contents of SEARUSL.

   HELP

Accesses the Help subsystem.

SYNTAX

-HELP [HELP ]
[tablecontents ]
[command[,keyword] ]
[ALL ]
[EXIT ]

PARAMETERS

HELP Displays information for the HELP command. Treated the
same as entering -HELP with any other command (because
HELP is a command).

tablecontents Any of several items for which information may be
obtained. These items are:

HELPMENU
USLS
RLS
SLS
SHOW
TERMINATE

Thus, if you want information on managing USL files, you
would enter:

-HELP USLS

command Any Segmenter command. Segmenter displays the command
name and syntax. In addition, a list of keywords for
that command is displayed. Keywords for all commands
are:

PARMS
EXAMPLE

where

PARMS lists all parameters of the specified
command.

EXAMPLE displays an example showing usage of the
specified command.

Entering -HELP command,ALL causes MPE to display all
information for that command (syntax, parameters, and
example).

keyword One of the keywords described under the command
parameter. The keyword parameter can be entered with
a command, as in -HELP LISTSL,PARMS. In this case,
PARMS is a keyword and must be separated from the
command with a comma. The keyword parameter also can
be entered alone if you are running the Help subsystem
in "subsystem" mode and have accessed a command, then
received the prompt (>) from Help.

For example,

-HELP AUXUSL

-AUXUSL

Opens an auxiliary USL file for management.

SYNTAX

-AUXUSL filereference

KEYWORDS: PARMS,EXAMPLE

>PARMS (keyword entered by itself in response to
prompt)


ALL Displays entire table of contents for -HELP command.
If entered with a command, as in

-HELP LISTSL,ALL

displays all information for that command.

EXIT Exits Help subsystem.

OPERATION

The -HELP command accesses the Help subsystem. If entered with no
parameters, as in

-HELP

Help enters the "subsystem" mode, displays a table of contents, a
"greater than" (>) prompt, and awaits your input. Entering any table
of contents item such as SESSIONS produces a listing of all the commands
used in running sessions. Entering any command name produces the syntax
for that command and a list of keywords. Entering a keyword, such as
PARMS produces a listing of all items for that keyword (all parameters
in this case). Entering EXIT terminates the Help subsystem. Entering
Control Y stops the display. Entering Control S stops the display and
entering Control Q resumes the display (useful if the screen is full if
using a CRT terminal).

Entering carriage return in "subsystem" mode causes HELP to display
information up to the next keyword or command. For example, after
entering AUXUSL, HELP displays AUXUSL syntax, the keyword list (PARMS,
EXAMPLE) and prompts (>). Entering carriage return again causes HELP to
display all PARMS information for the -AUXUSL command. Entering
carriage return once more (after the prompt) causes HELP to display all
EXAMPLE information for the -AUXUSL command, and so on. (This is
similar to page turning through a manual.)

Entering -HELP with a parameter causes Help to enter the "immediate"
mode. Information pertaining to that parameter is displayed
immediately. For example,

-HELP AUXUSL

causes Help to display:

-AUXUSL

Opens an auxiliary USL file for management.

SYNTAX

-AUXUSL filereference

KEYWORDS: PARMS,EXAMPLE

EXAMPLE

To obtain information concerning the managing of SL files, enter:

-HELP SLS

   HIDE

Hides the named  entry point.  This entry  point will not  appear in the
list of known entry points when the RBM containing it is moved to an
SL file. References to this procedure from any procedures except those
in the same segment will not be resolved. Cannot use on a secondary
entry point or for material which will be placed in an RL file. Can be
used on a primary entry point, RBM, or segment.

SYNTAX

[ENTRY, ]
-HIDE [UNIT, ] name[(index)]
[SEGMENT,]

PARAMETERS

ENTRY Hides the entry point indicated by 'name [(index)]'.
(Default.)

UNIT Hides all entry points in the Relocatable Binary
Module (RBM) indicated by 'name [(index)]'.

SEGMENT Hides all entry points in all RBMs associated with
segment 'name'.

name The name of the entry point in the currently managed
USL file which is to be hidden.

index An integer further specifying the entry point 'name'.
The index may be used when there is more than one
entry point of this name. If 'index' is omitted,
(the most recent active occurrence) is assigned by
default.

EXAMPLE

-HIDE XBM Hides the RBM entry point named XBM.

   LISTAUX

Lists the procedures in the currently  managed auxiliary User Subprogram
Library (USL) file. The format for the -LISTAUX listing is the same as
that generated by the -LISTUSL command.

SYNTAX

-LISTAUX [segmentname]

PARAMETERS

segmentname The name of the segment you would like to see listed.
Default is all. If omitted, all segments are listed.

EXAMPLE

-AUXUSL MYAUX Specifies the USL file MYAUX as the currently managed
auxiliary USL file.

-LISTAUX MYSEG Lists the procedures in the segment MYSEG, which is
in the auxiliary USL file MYAUX.

-LISTAUX Lists all segments in the auxiliary USL file.

   LISTPMAP

Interactively accesses FPMAP information.

SYNTAX

[;segname]
-LISTPMAP progname[;procedurename]

PARAMETERS

progname The name of the program whose PMAP is to be listed.

segname The name of the segment whose PMAP is to be listed.
(Default is all segments are listed.)

procedurename The name of the procedure whose PMAP is to be listed.

EXAMPLE

-LISTPMAP MYPROG Lists PMAP information on all segments of MYPROG.

   LISTRL

Lists the specified procedure entry points and external references in
the currently managed Relocatable Library (RL) file.

SYNTAX

-LISTRL

PARAMETERS

None.

EXAMPLE

-RL SMALLRL Opens the RL file SMALLRL for management.

-LISTRL Lists all procedure entry points and external
references in the RL SMALLRL.

   LISTSL

Lists  all  procedure  entry  points  and  external  references  in  the
currently managed Segmented Library (SL) file.

SYNTAX

[segmentnumber]
-LISTSL [[SEGMENT,]segmentname]
[ENTRY,procedurename]

PARAMETERS

segmentnumber The number of the segment you would like to see
listed. 'Segmentnumber' is interpreted as an octal
number.

segmentname The name of the segment you would like to see listed.
If all parameters are omitted, all segments are
listed.

SEGMENT If specified, Segmenter will only list the segment
that is identified by 'segmentname'.

ENTRY If specified, Segmenter will list the segment that
contains the procedure identified by 'procedurename'.

procedurename The name of the procedure you would like to see what
segment it resides in.

EXAMPLE

-SL YOURSL Opens the SL file YOURSL for management.

-LISTSL Lists all procedure entry points and
external references in the SL file YOURSL.

-LISTSL MYSEG Lists all procedure entry points and
external references in the segment MYSEG,
which is in the SL file YOURSL.

-LISTSL SEGMENT,MYSEG Same as -LISTSL MYSEG

-LISTSL 57 Lists all procedure entry points and
external references in segment number
octal or 47 decimal.

-LISTSL ENTRY,BINARY Lists the procedure entry point BINARY and
the segment name that contains the BINARY
procedure.

   LISTUSL

Lists the specified  segments in the  currently managed  User Subprogram
Library (USL) file.

SYNTAX

-LISTUSL [segmentname]

PARAMETERS

segmentname The name of the segment you would like to see listed.
If omitted, all segments in the USL are listed.

EXAMPLE

-USL SEARCHUSL Opens the USL file SEARCHUSL for management.

-LISTUSL LOCKSEG Lists the segment LOCKSEG, which is in the USL
SEARCHUSL.

   NEWSEG

Changes the  segment  name  associated with a  Relocatable Binary Module
(RBM) in the currently managed USL file.

SYNTAX

-NEWSEG newsegname,rbmname[(index)]

PARAMETERS

newsegname The new segment name to be associated with the RBM.
If it does not already exist, a new segment is
created.

rbmname The name of the RBM whose segment name is to be
changed.

index An integer further specifying the RBM name. The
index may be used when more than one RBM of the same
name exists in the User Subprogram Library (USL)
file. If 'index' is omitted, a default value of
(the most recent active occurrence) is assigned.

EXAMPLE

-NEWSEG NEWNAME,RB3 Changes the segment name associated with
RBM RB3 to NEWNAME.

   PREPARE

Prepares the active  Relocatable  Binary Modules (RBMs) in the currently
managed User Subprogram Library (USL) file into a program file.

SYNTAX

-PREPARE progfile
[;ZERODB]
[;PMAP]
[;MAXDATA=segsize]
[;STACK=stacksize]
[;DL=dlsize]
[;CAP=caplist]
[;RL=filename]
[;FPMAP]
[;NOSYM]

PARAMETERS

progfile Actual designator of program file on which prepared
program segments are written. Can be any binary
output file. This program file must be created in
one of two ways:

1. By creating a new file with the MPE :BUILD
command with a <filecode> of PROG or 1029, and
a numextents parameter value of 1.

2. By specifying a non-existent file in the
<progfile> parameter, in which case a file of
the correct size and type is created. This file
is a job temporary file. (REQUIRED PARAMETER)

ZERODB Request to initialize to zero the initially
defined, user-managed (DL-DB) area, and
uninitialized portions of the DB-Q (initial).
Default is these areas are not affected.

PMAP Request to produce a descriptive listing of the
prepared program on file whose formal designator is
SEGLIST. If no :FILE command is found referencing
SEGLIST, listing is produced on $STDLIST. Default
is no listing.

segsize Maximum stack area (Z-DL) size permitted, in words.
This parameter is included when it is expected that
the size of DL-DB or Z-DB areas will be changed
during program execution. Default is that MPE
assumes that these areas will not change.

stacksize Size of initial local data area (Z-Q initial) in
stack, in words. (This value, if specified, must
exceed 511 words.) This parameter over rides
<stacksize> estimated by Segmenter. Default is
estimated by MPE Segmenter.

dlsize DL-DB area to be initially assigned to stack. This
area is of interest mainly in programmatic
applications. In all cases, the DL-DB area is
rounded upward so that the distance from the
beginning of the stack data segment to the DB-
address is a multiple of 128 words. Default is
estimated by the MPE Segmenter.

caplist Capability-class attributes associated with
program, specified as two-character mnemonics. If
more than one mnemonic is specified, each must be
separated from its neighbor by a comma.

The mnemonics are:

IA Interactive access
BA Local batch access
PH Process handling
DS Data segment management
MR Multiple resource management
PM Privileged mode

Note that you can specify only those capabilities
that you possess (through assignment by the System
Manager or Account Manager). Default is IA, BA (if
you possess these capabilities).

filename Actual designator of RL file to be searched to
satisfy external references during preparation.
This can be any permanent binary file of type RL.
It need not belong to logon group, nor have a
reserved, local name. This file yields a single
segment that is incorporated into the segments of
the program file. See the MPE Segmenter Reference
Manual for a discussion of RL files. Default is no
library is searched.

NOSYM Request to suppress Symbolic Item header
information and PMAP information from the resulting
program file. This option is used in conjunction
with the HPTOOLSET Symbolic Item debugging option
Specifying this option can save file space but you
will not be able to do symbolic item debugging of
the program file created by the PREP.

FPMAP Request PMAP information be generated in the
program file created by the PREP.

OPERATION

Prepares a compiled program onto a program file. Unless this file is
explicitly created before issuing the :PREP command, a program file will
be created by the command as a job/session temporary file.

This command permits searching of a relocatable library (RL) to satisfy
references to external procedures required by the program. When the
program is prepared, such procedures are linked to the program in the
resulting program file.

EXAMPLE

To prepare a program from the USL file named USEFILE and store it in a
program file named PROGFILE, enter:

:PREP USEFILE,PROGFILE

To prepare a program from the USL file named USEFILE and store it in a
program file named PROGFILE, list the prepared program, assign a
stacksize of 500 words, and assign batch-access capability only for the
program, enter:

:PREP USEFILE,PROGFILE;PMAP;STACK=500;CAP=BA

   PURGERBM

Deletes one or more Relocatable Binary Modules (RBMs) from the currently
managed User Subprogram Library (USL) file.

SYNTAX

-PURGERBM [UNIT, ] name[(index)]
[SEGMENT,]

PARAMETERS

UNIT Deletes the RBM identified by 'name [(index)]'.

SEGMENT Deleted all RBMs associated with the segment 'name'.
The default parameter is UNIT.

name The name of the RBM to be deleted if UNIT is
specified, this is the name of the segment in which
all RBMs are to be deleted.

index An integer further specifying the RBM name. The
index may be used when more than one RBM of this
same name exists in the USL file. If 'index' is
omitted, a default value of 0 (the most recent active
occurrence) is assigned. If SEGMENT is specified,
this parameter is ignored.

EXAMPLE

-PURGERBM UNIT,XPOINT Deletes the RBM named XPOINT.

   PURGERL

Deletes an entry point of a procedure, or the entire procedure, from the
currently managed Relocatable Library (RL) file.

SYNTAX

-PURGERL [UNIT, ] name
[ENTRY,]

PARAMETERS

UNIT Deletes the entire procedure identified by 'name'.

ENTRY Deletes the entry point identified by 'name'.
(Default.)

name The name of the procedure to be deleted if UNIT is
specified, or the entry point to be deleted if ENTRY
is specified.

EXAMPLE

-PURGERL UNIT,PROC1 Deletes the entire procedure name PROC1.

   PURGESL

Deletes a segment entry point, or the entire segment, from the currently
managed Segmented Library (SL) file.

SYNTAX

-PURGESL [ENTRY, ] name
[SEGMENT,]

PARAMETERS

ENTRY Deletes the entry point identified by 'name'.
(Default.)

SEGMENT Deletes the entire segment identified by 'name'.

name The name of the entry point to be deleted if ENTRY is
specified or the name of the segment to be deleted if
SEGMENT is specified.

EXAMPLE

-PURGESL ENTRY,ENT1 Deletes the entry point named ENT1.

   REDO

Allows you to edit a command entry.

SYNTAX

-REDO [edit request]

PARAMETERS

edit request Any valid edit request string as described under
operation of the -REDO command. The edit request is
applied to the last command that was entered and the
resultant command is then executed. If an edit
request is entered as parameter to the -REDO command,
then the user is not prompted for any more changes.

OPERATION

The -REDO command allows you to correct certain kinds of errors in an
incorrect command entry or to change a correct command entry. The -REDO
command only applies to the last command entered. When the -REDO
command is entered, Segmenter enters a mode similar to the Editor and
displays the command to be modified.

To modify the command output by Segmenter, position the cursor (using
the space bar on the terminal) under the character(s) to be modified,
then enter one of the following sub-commands:

D - Delete. Deletes the character above the cursor. If D is
repeated, each character above each D is deleted.

I - Insert. Inserts one or more characters immediately preceding the
character above the cursor. The D and I sub-commands can be used
in conjunction to delete characters, then insert new characters.

R - Replace. Replaces the characters above the cursor with new
characters. If one character is entered, the character above the
cursor is replaced; if two characters are entered, two characters,
(the character above the cursor and the character to the right)
are replaced; and so forth for additional characters. R is the
default sub-command.

U - Undo. Cancels the effect of the previous D, I, or R sub-command.
Entering a U, carriage return, then another U cancels all previous
sub-commands for this -REDO command and restores the line being
corrected to its original form.

EXAMPLE

-BUILDS MYSL,2000,1
*** ERROR ***
ILLEGAL COMMAND NAME
-REDO (Request to enter command string)
BUILDS MYSL,2000,1 (Segmenter displays command)
IL (Insert L)
BUILDSL MYSL,2000,1 (Corrected command displayed)

Note that the letter S can be entered without the sub-command R, because
R is the default sub-command. For example,

-BUILDXL MYSL,2000,1
S (Replace X with S)
-BUILDSL MYSL,2000,1 (Corrected command displayed)

   REVEAL

Reveals  entry  point.  Cannot  use on  a  secondary  entry point  or on
material which will be placed in an RL file. Can be used on a primary
entry point, RBM, or segment.

SYNTAX

[ENTRY, ]
-REVEAL [UNIT, ] name[(index)]
[SEGMENT,]

PARAMETERS

ENTRY Reveals the entry point indicated by 'name
[(index)]'. (Default.)

UNIT Reveals all entry points in the Relocatable Binary
Module (RBM) indicated by 'name [(index)]'.

SEGMENT Reveals all entry points in all RBMs associated with
segment 'name'.

name The name of the entry point in the User Subprogram
Library (USL) file which is to be revealed.

index An integer further specifying the entry point name.
The index may be used when there is more than one
entry point of this name. If 'index' is omitted, a
value of 0 (the most recent active occurrence) is
assigned by default.

EXAMPLE

-REVEAL RBM1 Reveals the RBM entry point named RBM1.

   RL

Opens a Relocatable Library (RL) file for management.

SYNTAX

-RL filereference

PARAMETERS

filereference The name, and optional group and account name, of the
RL file.

EXAMPLE

-RL R2.G1.A1 Opens the RL file R2.G1.A1 for management.

   SETFPMAP

Sets the system or job/session FPMAP flag.

SYNTAX
[SYSTEM] [;CONDITION] [;ON]
-SETFPMAP [SESSION][;UNCONDITION][;OFF]

PARAMETERS

SYSTEM/SESSION Specifies which flag is to be set/reset.
Default is SESSION. Requires SM capability
to set/reset System FPMAP flag.

CONDITION/UNCONDITION Specifies that the System FPMAP flag is set
to conditional or unconditional. Valid only
when SYSTEM is specified.
(Default is CONDITION.)

ON/OFF Set/Reset flag. Default is ON.

EXAMPLE

-SETFPMAP SESSION;ON Turns the session FPMAP flag on.

-SETFPMAP SESSION;OFF Turns the session FPMAP flag off.

   SL

Opens Segmented Library (SL) file for management.

SYNTAX

-SL filereference

PARAMETERS

filereference The name of the SL file.

EXAMPLE

-SL SL1 Opens the SL file named SL1 for management.

   USE

Activates one or  more program unit (Relocatable  Binary  Module)  entry
points in the User Subprogram Library currently designated for
management. Note that, in the order the parameters are listed below
(ENTRY, UNIT, SEGMENT), the control given you by the USE parameters
becomes less specific. If you want control over a single entry point,
use the most specific and limited parameter, ENTRY. (You will probably
also use the optional 'index' whenever you use this specific parameter.)
Either of the other two parameters would activate all entry points
within an RBM or a segment, including some you might want to leave
inactive.

SYNTAX

[ENTRY, ]
-USE [UNIT, ] name[(index)]
[SEGMENT,]

PARAMETERS

ENTRY Activates the entry point indicated by 'name
[(index)]'. (This is the default parameter.)

UNIT Activates all entry points in the RBM indicated by
'name [(index)]'.

SEGMENT Activates all entry points in all RBMs associated
with the segment 'name'.

name The name of the entry point if ENTRY is specified, or
the name of the RBM if UNIT is specified, or the name
of the segment if SEGMENT is specified.

index An integer further identifying the entry point name.
The 'index' may be used when the USL file contains
more than one entry point of the same name. If
SEGMENT is specified, the 'index' parameter is
ignored.

If 'index' is omitted, a default value of 0 (the most
recent inactive occurrence) is assigned. An 'index
n' means the 'n'th occurrence, whether active or
inactive. However, there is no point in using this
command with an entry point you know to be active,
since its purpose is to activate inactive entry
points.

EXAMPLE

-USE UNIT,RB20 Activates all entry points in the RBM named RB20.

   USL

Opens a User Subprogram Library (USL) file for management.

SYNTAX

-USL filereference

PARAMETERS

filereference The name, and optional group and account name, of the
USL file.

EXAMPLE

-USL FILE1 Opens the USL file FILE1 (in the user's logon group
and account) for management. 

NOTE

The segmenter employs temporary files named T999SYM, SEGTMP01, and
SEGTMP00.  If you have created temporary files having these names, the
segmenter will attempt to purge them.


EXAMPLE(S)

     To call the MPE segmenter from a session and transmit the
     output to a line printer instead of the standard list
     device, enter

     FILE LISTFL;DEV=LP
     SEGMENTER *LISTFL

NOTE

You must have READ and LOCK access to use a relocatable library
with the SEGMENTER command.

ADDITIONAL INFORMATION

Commands:   FILE

Manuals :   MPE Segmenter Reference Manual (32650-60026)