MPE/iX Commands Reference Manual (32650-90877)

Chapter 10 375
Command List VIII
Commands PASCAL thru PURGEUSER
Related Information
Commands PREPRUN, RUN
Manuals MPE Segmenter Reference Manual
PREPRUN
Prepares and executes a compiled compatibility mode program.
Syntax
PREPRUN uslfile[,entrypoint ]
[;NOPRIV] [;PMAP] [;NOCB] [;DEBUG] [;INFO= quotedstring ]
[;LMAP[;STDIN [{*formaldesig =fileref $NULL}]]]
[;MAXDATA= segsize ] [;PARM= parameternum ] [;STDLIST=[ { *formaldesig fileref [
,NEW] $NULL }]]
[;STACK= stacksize ][ ;DL= dlsize ] [;PATCH= patchsize ]
[ ;LIB={ G | P | S}]
[;NOSYM] [{;FPMAP | ;NOFPMAP}] [;CAP= capabilitylist ]
Parameters
uslfile Actual file designator of the USL file to which the program has been
compiled.
entrypoint Contains a character string, terminated by a blank, specifying the entry
point (label) in the program where execution is to begin when the program
is executed. The
entrypoint parameter may be the primary entry point or
any secondary entry point in the program's outer block. Default is primary
entry point.
NOPRIV Declaration that the program segments are to be placed in nonprivileged
(user) mode. This parameter is for programs prepared with privileged
mode (PM) capability and makes them accessible to nonprivileged users.
Normally, program segments containing privileged instructions are
executed in privileged mode only if the program was prepared with
privileged mode capability class. (A program containing legally compiled
privileged code, placed in nonprivileged mode, may abort when an attempt
is made to execute it.) If NOPRIV is specified, all segments are placed in
nonprivileged mode. (Library segments are not affected because their
mode is determined independently.) Default is that segments of a
privileged mode program remain in privileged mode.
PMAP Request to produce a descriptive listing of the prepared program to a file
whose formal file designator is $SEGLIST. If $SEGLIST is not found in a
FILE command, the listing is produced on the current list device. Default is
no listing.
DEBUG Request to issue a DEBUG call before the first executable instruction of the
program. Unless the user has READ and EXECUTE access to the program