Guardian Procedure Errors and Messages Manual

6 Process Creation Errors
The following error codes and error lists are produced by the PROCESS_LAUNCH_ and
PROCESS_CREATE_ procedures, which create a Guardian process. Most of the error codes are
also returned by the PROCESS_SPAWN_ procedure, which creates an Open System Services
(OSS) process. For more information on error codes and error lists produced by
PROCESS_SPAWN_, see “PROCESS_SPAWN_ Open System Services (OSS) Errors” (page 194).
You can create a process with a number of different procedures. On C-series releases, you typically
used the NEWPROCESS or NEWPROCESSNOWAIT procedure. On D-series and G-series releases,
you probably use the PROCESS_LAUNCH_ or PROCESS_CREATE_ procedure. With the
PROCESS_LAUNCH_ and PROCESS_CREATE_ procedures, you can create processes with process
identification numbers (PINs) in the low range (0 through 254) or in the high range (256 through
65535). In the event that you might want your processes to communicate with processes created
with the NEWPROCESS or NEWPROCESSNOWAIT procedure, you might want to specify low
PINs for processes that require such communication.
If PROCESS_LAUNCH_ or PROCESS_CREATE_ is called in a nowait manner, error information is
returned in system message -102 (nowait PROCESS_LAUNCH_ or PROCESS_CREATE_ completion).
For more details, see “System Messages” (page 248).
For further information about starting processes and about the PROCESS_LAUNCH_ and
PROCESS_CREATE_ procedures, see the Guardian Programmer’s Guide and the Guardian
Procedure Calls Reference Manual.
Error Codes
ThePROCESS_LAUNCH_ and PROCESS_CREATE_ error codes are the values returned to the calling
process in the error parameter of PROCESS_LAUNCH_ and PROCESS_CREATE_. For many classes
of errors, additional information is returned in the error-detail parameter.
ThePROCESS_SPAWN_ Guardian error codes are the values returned to the calling process in
the ZSYS-DDL-PROCESSRESULTS.Z-TPCERROR field of the process-results parameter of
PROCESS_SPAWN_. For many classes of errors, additional information is returned in the
ZSYS-DDL-PROCESSRESULTS.Z-TPCDETAIL field of the process-results parameter.
In descriptions of errors that can be returned by PROCESS_LAUNCH_, PROCESS_CREATE_, and
PROCESS_SPAWN_, the term error detail refers to the information returned in either the
error-detail parameter of PROCESS_LAUNCH_ and PROCESS_CREATE_ or the
ZSYS-DDL-PROCESSRESULTS.Z-TPCDETAIL field of the process-results parameter of
PROCESS_SPAWN_.
For PROCESS_SPAWN_ error lists and for OSS error codes returned in the
ZSYS-DDL-PROCESSRESULTS.Z-ERRNO field of the process-results parameter to PROCESS_SPAWN_,
see “PROCESS_SPAWN_ Open System Services (OSS) Errors” (page 194).
0 NO ERROR
Cause The call was completed successfully.
Effect The process was created, or creation was initiated if the procedure was called in a nowait
manner. In the latter case, creation results are returned in a user-level system message.
Recovery Informative message only; no corrective action is needed.
1 A FILE SYSTEM ERROR WAS ENCOUNTERED ON THE PROGRAM FILE
158 Process Creation Errors