Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-5
NEWPROCESS Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
processor input
INT:value
specifies the processor where the new process runs. If omitted, the new process
runs in the same processor as the caller.
process-id output
INT:ref:4
is a four-word array where NEWPROCESS returns the process ID of the new
process. If the new process was created in:
•
The local system, then the local form of the process ID is returned.
•
The remote system, then the network form of the process ID is returned. (A
new process is created on the same node where its program file resides.)
If no process was created, zero is returned in
process-id.
Use a 12-word array if the process ID is to be passed to any of the appropriate file-
system procedures that accept file names, such as OPEN, provided if the larger
array is blank-filled on the right.
error 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:
error.<0:7> error
error.<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