MPE/iX Commands Reference Manual (32650-90864)

532 Chapter 6
Command Definitions P-R
RUN
$NULL The actual file designator of a system-defined file that is always treated as
an empty file. When referenced by another program, a program receives
only an end-of-file indication when accessed. When referenced by a
program as $STDLIST, the associated write request is accepted by
MPE/iX, but no physical output is actually performed. Thus, $NULL can be
used to discard unneeded output from an executing program.
PRI The execution priority that the command interpreter uses for your
program. BS has the highest priority; ES has the lowest priority.
DS and ES are intended for batch jobs and are not well-suited for
interactive applications. Specifying a positive integer (#) permits you to set
priority at points that lie between the preset priority levels BS, CS, DS,
and ES. Accepted values for # are in the range 100 to 255, inclusive. Refer
to the CREATEPROCESS intrinsic in the MPE/iX Intrinsics Reference
Manual.
If you are in user mode (that is, nonprivileged) you may specify BS, CS,
DS, or ES.
If you attempt to specify a priority higher than the priority permitted for
your account or user name, MPE/iX sets the highest priority below BS. The
default is CS. If you do not specify a value the default (the parent process's
dispatching subqueue priority) is used.
CAUTION Use care in assigning the BS queue. Processes at the BS priority can lock out
other processes.
STDLIST Allows the user to specify the file to be used as $STDLIST by the program
being executed. If this parameter is omitted, or if nothing is specified after
the equal sign, as in ;STDLIST=
Return, then STDLIST defaults to the
standard list device for the job or session. This parameter has the same
subparameters as STDIN, but you may also specify the keyword NEW (for
instance, ";STDLIST=filename``,NEW").
NEW The name to be assigned to a job/session temporary disk file consisting of
132-byte fixed ASCII records.
Operation Notes
This command executes a program prepared in a program file. It permits searching
libraries (SLs for compatibility mode, XLs for native mode) to satisfy external references.
Relocatable libraries (RL) are not searched.
If the volume set containing the file to be run is not mounted, this command implicitly
causes that volume set to be mounted. The volume set has to be opened with a VSOPEN
command.
If the program file is a temporary CM file, the logon group and account libraries for the
current session along with SL.PUB.SYS are searched. If a program file is a temporary NM
file XL.PUB.SYS and NL.PUB.SYS are also searched. Refer to the Accessing Files
Programmer's Guide (32650-60010) for more information on file domains.