MPE/iX Intrinsics Reference Manual (32650-90875)

84 Chapter4
Command Definitions (ABORTSESS - FCLOSE)
CREATEPROCESS
17 Process not created; illegal value specified for itemnum=7
18 Process not created; specified $STDIN could not be opened
19 Process not created; specified $STDLIST could not be opened
20 Process not created; string to be passed to new process invalid (pointer
without length, length without pointer, or length exceeds stack size of
calling process)
pin 16-bit signed integer by reference (required)
Returns the process identification number (PIN) of the newly created
process. This PIN is used by other intrinsics to reference the new process.
If an error is detected, a value of zero is returned.
formaldesig character array (required)
Passes the name of the program file to be run. Terminate the string with
any nonalphanumeric character other than a period (.) or a backslash (/).
This paramenter is equivalent to the
progfile parameter of the RUN
command.)
itemnums (NM) 32-bit signed integer array (optional)
(CM) 16-bit signed integer array (optional)
Specifies which
item value is to be passed.
Values passed may be passed by value.
items (NM) 32-bit signed integer array (optional)
(CM) 16-bit signed integer array (optional)
Specifies if the
formaldesig parameter contains a program name that is
unrecognizable using MPE syntax, LIBSEARCH will result in a failed
load.
Itemnum Item Description
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.)