Guardian Procedure Calls Reference Manual

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 36 (page 1069).
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:
Process is unnamed (unless the RUNNAMED object file attribute is set for the program file).0
Process is named; name is supplied in name.1
Process is named; system must generate a name. (The generated name is four characters long, not
including the $.)
2
Process is caller's backup; use caller's name.3
Process is named; system must generate a name. (The generated name is five characters long, not including
the $.
4
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:name-length
input:input
STRING .EXT:ref:*, INT:value
if name-option is 1 and name-length is not 0, specifies a name to be assigned to the new
process. If used, the value of name must be exactly name-length bytes long. The name can
include a node name, but the node must match that of the program file. See General
Considerations (page 992) and Appendix B: Reserved Process Names for information about
reserved process names.
For other values of name-option, this parameter must be omitted (or name-length must
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.
PROCESS_CREATE_ Procedure (Superseded by PROCESS_LAUNCH_ Procedure) 989