MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 4 77
Command Definitions (ABORTSESS - FCLOSE)
CREATE
CREATE
NM and CM callable (differences noted below).
Creates a process as a child of the calling process. Process handling (PH) capability is
required.
Syntax
CA CA I16 I16V U16V
CREATE(
formaldesig,entryname,pin,parm,loadflags,
I16V I16V I16V U16V I16V
stacksize,dlsize,maxdata,priorityclass,rank );
Parameters
formaldesig character array (required)
The name of the program to be created, specified either in MPE or HFS
syntax. If you are using MPE syntax,
formaldesig passes the name, group
(optional), and account (optional) of the file containing the program to be
run, and, if applicable, a lockword. If you are using HFS syntax,
formaldesig passes the relative pathname or the absolute pathname of
the file containing the program to be run. The last element of the array
must be a blank. This parameter is equivalent to the
progfile parameter
of the RUN command.
entryname character array (optional)
Passes the declared entry point (label) in the program where execution is
to begin when the process is activated. The last element of the array must
be a blank. Specify the program's primary entry point with an array
consisting of one blank character. (Equivalent to the
entrypoint
parameter of the RUN command.)
Default: The program's primary entry point is used.
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.
parm 16-bit signed integer by value (optional)
Passes information to the new process. The new process can access this
information by using the GETINFO intrinsic. (Equivalent to the
parm=
parameter of the RUN command.)
Default:
parm =0.