522 Chapter 6
Command Definitions P-R
RUN
RUN
Executes a prepared or linked program. (Native Mode)
Syntax
The only required parameter is progfile. If you specify any other parameters, they will
override the default parameters that the creator of the program established, but only for
that particular execution of the program. If run is implied, see operation note below.
RUN progfile[,["]entrypoint["]]
[;NOPRIV] [ ;LMAP] [ ;DEBUG] [ ;MAXDATA=maxstack] [ ;PARM=parameternum]
[;STACK=stacksize] [ ;DL=dlsize] [ ;NMSTACK=nmstacksize] [ ;NMHEAP=nmheapsize]
[;LIB= { G P S}][;XL="library[ , ...] "] [ ;NOCB]
[;INFO="quotedstring"] [ ;UNSAT=[ "] unsatproc["]]
[;STDIN=[ { *formaldesig fileref $NULL}]]
[;STDLIST=[ { *formaldesig fileref[ ,NEW] [ $NULL]}]]
[;PRI={ BS CS DS ES}{#}]
Parameters
progfile The name of the program file to be executed. If the name is not fully
qualified, it is given a full qualification consistent with the current job
domain. The file may be redirected with a file equation.
entrypoint Program entry point where execution is to begin. It contains a character
string specifying the entry point (label) in the program where execution is
to begin when the program is executed. This point may be the primary
entry point of the program, or any secondary entry point in the program's
outer block. Default is the primary entry point.
By default, MPE/iX shifts all alphabetic characters in entrypoint to
uppercase; surrounding the parameter with quotation marks (" or ')
prevents MPE/iX from performing the upshift and permits you to enter
strings for case-sensitive applications.
NOPRIV Specifies that the pages of the code space of the program are to be assigned
execution level 3 (the least-privileged execution level), regardless of the
declared execution level. The execution level of pages in a library are not
affected by the NOPRIV parameter. The default is that code in the program
executes at its declared execution level.
LMAP Indicates that the user wants a listing of the process describing the spaces
occupied by the process and by the links created to bind the external
references of the process. The load map is written to the loader list device.
The default is not to print a load map. Load maps for compatibility mode
and native mode are significantly different from each other.
Native Mode
