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. See “PROCESS_SPAWN_ Open System Services (OSS) Errors” (page 192), for
more information on error codes and error lists produced by PROCESS_SPAWN_.
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 could 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).
See “System Messages” (page 246), for details.
For further information about starting processes and about the PROCESS_LAUNCH_ and
PROCESS_CREATE_ procedures, refer to 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_.
See “PROCESS_SPAWN_ Open System Services (OSS) Errors” (page 192), 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_.
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
Error Codes 157
To Next Page
Loading...
