Filter
Top Products
Chapter 6 437
Command Definitions P-R
PREPRUN
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
file, this parameter is ignored. If privileged mode (PM) capability has been
assigned, the user is put into privileged mode debug. If not, the user is put
into user mode debug. Default is that the DEBUG call is not issued.