Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-43
PROCESS_CREATE_ Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
processhandle output
INT .EXT:ref:10
returns the process handle of the new process. If you created the process in a
nowait manner, the process handle is returned in the completion message sent to
$RECEIVE rather than through this parameter.
error-detail output
INT .EXT:ref:1
returns additional information about some classes of errors. The sets of values for
error-detail vary according to the error value, as described in Table 12-4 on
page 12-127.
name-option input
INT:value
specifies whether the process is to be named and, if so, whether the caller is
supplying the name or the system must generate it. Valid values are:
0 Process is unnamed (unless the RUNNAMED object file attribute is set for the
program file).
1 Process is named; name is supplied in
name.
2 Process is named; system must generate a name. (The generated name is
four characters long, not including the $.)
3 Process is caller’s backup; use caller’s name.
4 Process is named; system must generate a name. (The generated name is
five characters long, not including the $.
If this parameter is omitted, 0 is used.
If either the program file or the library file (if any) has the RUNNAMED program-file
flag set, the system overrides
name-option of 0 and generates a name. The
system also generates a name if RUNNAMED is set and
name-option is 2, 4, or
omitted. The generated name is four characters long, not including the $, unless
name-option is 4. In the latter case, the name is five characters long, not
including the $.
name:length input:input
STRING .EXT:ref:*, INT:value
if
name-option is 1 and length is not 0, specifies a name to be assigned to the
new process. If used, the value of
name must be exactly length bytes long. The
name can include a node name, but the node must match that of the program file.
See “General Considerations,” later in this subsection, and Appendix B, Reserved
Process Names for information about reserved process names.