Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-118
PROCESS_LAUNCH_ Procedure
output-list-len output
INT .EXT:ref:*
returns the length, in bytes, of the structure returned in output
-list.
Table 12-3. Summary of Process Creation Errors (page 1 of 10)
error Description
0 No error; process created, or creation initiated if you are creating the process in a
nowait manner.
1 File-system error on program file; error-detail contains a file-system error
number*.
2 Parameter error; from PROCESS_LAUNCH_ and PROCESS_SPAWN_, error-
detail contains the literal for the first parameter to be found in error. See
Table 12-4
for possible values. From PROCESS_CREATE_, error-detail
contains the number of first parameter found to be in error, where 1 designates
the leftmost parameter.
Note: The PROCESS_CREATE_ parameters are counted as in TAL (see Syntax for TAL
Programmers on page 12-40) rather than C. Thus, program-file:length is parameter 1,
library-file:length is parameter 2, and so on; priority is reported as parameter 5
although it is the 9th parameter in the C calling sequence.
3 Bounds error; from PROCESS_LAUNCH_ and PROCESS_SPAWN_,error-
detail contains the literal for the first parameter to be found in error. See
Table 12-4 for possible values. From PROCESS_CREATE_,error-detail
contains the number of first parameter found to be in error, where 1 designates
the leftmost parameter.
Note: The PROCESS_CREATE_ parameters are counted as in TAL (see Syntax for TAL
Programmers on page 12-40) rather than C. Thus, program-file:length is parameter 1,
library-file:length is parameter 2, and so on; priority is reported as parameter 5
although it is the 9th parameter in the C calling sequence.
4 File-system error occurred on user library file; error-detail contains a file-
system error number*.
5 File-system error occurred on swap file; error-detail contains a file-system
error number*.
6 File-system error occurred on extended swap file; error-detail contains a file-
system error number*.
7 File-system error occurred while creating the process file segment (PFS); error-
detail contains a file-system error number*.
8 Invalid home terminal (device either does not exist or is wrong device type);
error-detail contains a file-system error number*.
9 I/O error to home terminal; error-detail contains a file-system error number*.
* Refer to the Guardian Procedure Errors and Messages Manual for a list of all file-system and DEFINE errors.
**When error-detail 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.
Note: Refer to Guardian Procedure Errors and Messages Manual for Cause, Effect, and Recovery of all the
Process Creation Errors.