Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-44
PROCESS_CREATE_ Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
For other values of name-option, this parameter should be omitted (or length
should be set to 0), since the system will either generate a name or, in the case of
backup creation, use the name of the caller.
process-descr:maxlen output:input
STRING .EXT:ref:*, INT:value
if present and
maxlen is not 0, returns a process descriptor suitable for passing to
FILE_OPEN_.
maxlen specifies the length of the string variable process-descr
in bytes. If it is not 0, the value of
maxlen must be at least 33.
If you created the process in a nowait manner, the process descriptor is returned in
the completion message sent to $RECEIVE rather than in
process-descr.
process-descr-len output
INT .EXT:ref:1
if
process-descr is returned, contains its actual length in bytes.
nowait-tag input
INT(32):value
if present and not -1D, indicates that the process is to be created in a nowait
manner; the procedure returns as soon as process creation is initiated. See
“Nowait Considerations” for details.
If
nowait-tag is -1D or omitted, the process is created in a waited manner.
hometerm:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
length is not 0, is a file name that designates the home terminal
for the new process. If used, the value of
hometerm must be exactly length
bytes long. If
hometerm is partially qualified, it is resolved using the =_DEFAULTS
DEFINE.
hometerm can be a named or unnamed process. The default value is the home
terminal of the caller.
memory-pages input
INT:value
For TNS processes, specifies the minimum number of 2048-byte memory pages
allocated to the new process for user data. The actual amount of memory
allocated is processor-dependent. If
memory-pages is either omitted or less than
the value previously assigned either by a compiler directive at compile time or by a
Binder command at bind time, the previously assigned value is used. In any case,
the maximum number of pages permitted is 64.