Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-190
PROCESS_SPAWN_ Procedure
Z^TPCError
indicates the outcome of the Guardian process creation. This parameter is the
same as the
error parameter reported by PROCESS_LAUNCH_. See Table 12-3,
Summary of Process Creation Errors and Table 12-4, error-detail Codes for
PROCESS_LAUNCH_ and PROCESS_SPAWN_ Errors 2 and 3, for details. See
also “Nowait Considerations.”
Z^TPCDetail
returns additional information about some classes of Guardian errors. This
parameter is the same as the
error-detail parameter reported by
PROCESS_LAUNCH_. See Table 12-3, Summary of Process Creation Errors and
Table 12-4, error-detail Codes for PROCESS_LAUNCH_ and
PROCESS_SPAWN_ Errors 2 and 3, for details.
Nowait Considerations
If you call this procedure in a nowait manner, the results are returned in the nowait
PROCESS_SPAWN_ completion message (-141), not the output parameters of the
procedure. The format of this completion message is described in the
Kernel-
Managed Swap Facility (KMSF) Manual. If Z^TPCError is not 0, no completion
message is sent to $RECEIVE. Errors can be reported either on return from the
procedure, in which case the error output parameters might be meaningful, or
through the completion message sent to $RECEIVE.
4014 A specified parameter has an invalid address. The corresponding
OSS errno value is EFAULT.
4020 A prefix within a pathname refers to a file other than a directory.
The corresponding OSS errno value is ENOTDIR.
4022 Either a parameter in the parameter list is invalid or a required
parameter is omitted. The corresponding OSS errno value is
EINVAL.
4126 Operation timed out. The timeout value was reached before a
binary semaphore could be locked. The corresponding OSS errno
value is ETIMEDOUT.
4131
The pathname or a component of the pathname is longer than
PATH_MAX characters. (PATH_MAX is a symbolic constant that is
defined in the OSS limits.h header file.) See
Appendix D, File Names
and Process Identifiers, for pathname syntax. The corresponding
OSS errno value is ENAMETOOLONG.
4203 OSS is not running or is not installed. The corresponding OSS
errno value is EOSSNOTRUNNING.
4212 An error occurred during the invocation of a Guardian DEFINE.
The corresponding OSS errno value is EDEFINEERR.
Z^ERRNO Description