Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-7
NEWPROCESS Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
jobid input
INT:value
is an integer identifying a new job to be created with the new process as the first
process of the job and the caller as the GMOM of the new process. This integer is
used by the NetBatch Scheduler. (See “Batch Processing Considerations.”)
errinfo output
INT .EXT:ref:2
returns two numbers indicating the outcome of the process creation attempt, as
follows:
errinfo[0] error
errinfo[1] error-detail (
provides additional information about the error)
Table 10-2
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.
pfs-size input
INT(32):value
meaningful only if the process is being created on a pre-G06 RVU. On G06 and
later RVUs, this value is range checked, but is otherwise ignored.
If present and nonzero, this parameter specifies the size in bytes of the process file
segment (PFS) of the new process. In G-series releases, maximum PFS size is 8
MB. In H-series releases, maximum PFS size is 32 MB. A value in this range
overrides the
nld or Binder value stored in the program file. If you omit pfs-size
or specify 0:
•
the nld or Binder value is used if it is nonzero
•
a default value is used otherwise
Table 10-2. Summary of NEWPROCESS Error Codes (page 1 of 12)
error
<0 : 7>
Corresponding Process Creation Error (see Table 12-4
on
page 12-127)
<8:15>
0 No error, process created
1 Process had undefined externals, but was started
2 No process control block available
* Refer to the Guardian Procedure Errors and Messages Manual for a list of all file-system and DEFINE
errors.
**When error.<8:15> indicates the number of a shared run-time library (SRL), the number represents
either the public SRL relative number, or 00 for a native user library. For more information on shared run-time
libraries (SRLs) refer to the nld and noft Manual