0 | Indicates the end of the option list. No value is required in the
corresponding item.
|
1 | The address must be a byte address (type-coerced) containing the entry
point name in the program where the new process is to begin execution
(equivalent to the entrypoint parameter of the RUN command.)
The name consists of a string of characters terminated by a blank.
|
2 | A value passed to the new process (equivalent to
the PARM= parameter of the RUN command.)
|
3 |
The load options for loading the program file of the new process, designated as:
(NM)
Bits (0:16) Zeros
Bits (16:16) Load options
(CM)
Bits (0:16) Load options
Item 3 has the same definition as the loadflag parameter of the CREATE intrinsic. If both itemnums 3 and 19 are specified, the LIBSEARCH option is ignored or if LIBSEARCH is set to a value other than its default (00), a warning is returned indicating the LIBSEARCH option was ignored.
|
4,5,6 | (CM Only) Ignored if formaldesig specifies an NM program
file; created using MPE V/E maximum default values
(equivalent to the STACK=, DL=, and MAXDATA= parameters
of the RUN command).
|
7 |
The priority class where the new process is scheduled (AS, BS, CS, DS, ES); is computed as (equivalent to the PRI= parameter of the RUN command.):
(ASCII of first character 256) + (ASCII of second character)
The integer equivalents are:
AS = 16,723
BS = 16,979
CS = 17,235
DS = 17,491
ES = 17,747
If in user mode (nonprivileged), any priority class can be specified
except AS; this is limited by the maximum priority assigned to the
account by the system manager. If PM capability has been assigned,
processes can be scheduled into all subqueues. A process in the linear queue AS or BS does not give up the CPU voluntarily, it could loop infinitely and prevent other processes from accessing the CPU.
Default: The calling process priority class.
|
8 | The address must be a byte address (type-coerced) containing a
definition of
the file to be used as $STDIN for the new process (equivalent
to the STDIN= parameter of the RUN command). Must contain
an ASCII string (terminated by a carriage return) specifying the file
to be used as $STDIN (that is, everything after
the FILEformaldesig=; portion of the file equation).
If itemnum=8 is not specified, the
default $STDIN and $STDLIST (current for the creating (parent)
process) are used for the new process creation.
|
9 | The address must be a byte address (type-coerced) containing a definition of
the file to be used as $STDLIST for the new process (equivalent
to the STDLIST= parameter of the RUN command).
If itemnum=9 is not specified, the
default $STDIN and $STDLIST (current for the creating (parent)
process) are used for the new process creation.
|
10 | Specifying this item is equivalent to calling
the ACTIVATE intrinsic with the newly created process. The
value passed is equivalent to the allow parameter of ACTIVATE,
except bit (31:1) is the parent activation bit and bit (30:1) is the
child activation bit.
|
11 | The address must be a byte address (type-coerced) containing
information to be
passed to the new process. The length of the string must be specified
in itemnum=12 (equivalent to the INFO= parameter of
the RUN command), accessible through the GETINFO intrinsic.
|
12 | The length (in bytes) of the string referenced by itemnum=11.
The maximum allowable value of the INFO string length is 1024
bytes.
Accessible through the GETINFO intrinsic.
|
13 | Not used.
|
14 |
The address must be a byte address (type-coerced) containing a definition of the file to be used as $STDERR for the new process. If itemnum=14 is not specified, the
$STDERR (current for the creating (parent)
process) is used for the new process creation.
Redirecting output to $STDERR permits the user to write errors to a user-specified disc file. |
15-18 | (NM Only) Reserved for the system.
|
19 |
(NM Only) The address (type-coerced) containing a list of unresolved
external references found in formaldesig (equivalent to the XL= parameter of the RUN command). When formaldesig contains a name in MPE syntax, the file names must follow file naming conventions and be separated by commas.
When formaldesig contains a name in HFS syntax, you must use an absolute pathname and the file names specified in this item must be fully qualified.
If itemnums 3 and 19 are specified, the LIBSEARCH option in itemnum=3 is ignored or if LIBSEARCH is set to a value other than its default (00), a warning is returned indicating the LIBSEARCH option was ignored. The length of the string must be specified in itemnum=24.
|
20-22 | (NM Only) Reserved for operating system.
|
23 | (NM Only) The address (type-coerced) containing the name of a procedure
to link unsatisfied references to. The name consists of a string of
characters terminated by an ASCII carriage return character or a blank
(equivalent to the UNSAT= parameter of the RUN command). |
24 | (NM Only) The length of the string referenced by itemnum=19.
|
25 | (NM Only) Reserved for operating system.
|
26 | The address must be a byte address containing the maximum size (in bytes) that the NM stack can grow
(equivalent to the NMSTACK= parameter of the RUN command).
|
27 | The address must be a byte address containing the maximum size (in bytes) that the NM heap can grow
(equivalent to the NMHEAP= parameter of the RUN command).
|