Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-27
NEWPROCESSNOWAIT Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
Z^MAINSTACK^MAX, Z^HEAP^MAX, and Z^SPACE^GUARANTEE fields of the
param-list parameter. Alternatively, use the nld utility to set the process
attributes.
processor input
INT:value
is a value specifying the processor where the new process runs. If omitted, the
new process runs in the same processor as the caller.
process-id unused
INT:ref:4
outcome output
INT:ref:1
returns two numbers indicating the outcome of the process creation attempt. The
numbers each occupy one byte in a 16-bit word as follows:
outcome.<0:7> error
outcome.<8:15> error-detail (provides additional information about the
error)
If the
error value exceeds 255 (will not fit in 8 bits), it is reported as 119. If the
detail value exceeds 255, both 8-bit fields contain 119. Because of the limited
capacity of this parameter, it has been superseded by the
errinfo parameter,
which returns the full 16-bit value of each number.
Table 10-2
on page 10-7 summarizes the error values and relates them to
process creation errors (as issued by PROCESS_LAUNCH_) described in
Table 12-4
on page 12-127.
name input
INT:ref:3
if present, is a name to be given to the new process. It is entered into the
destination control table (DCT).
name is of the form:
name[0:2] = $process-name
process-name must be preceded by a dollar sign (“$”) and consists of a
maximum of five alphanumeric characters; the first character must be alphabetic.
(If the process is created in a remote system and it is necessary to be able to
access the process, its name should consist of, at most, four characters and the
“$”; this leaves a byte for the system to insert the node number into the six bytes
above.) Note that
$process-name is the first 3 words of the 4-word process ID.
If
name is not supplied, the process ID of the new process is of the unnamed form,
containing a timestamp in words [0:2] instead of
$process-name, with the