Guardian Procedure Calls Reference Manual

C programs must initialize the process_extension_results structure by using the #define
DEFAULT_PROCESS_EXTENSION_RESULTS in the tdmext.h header file.
Z^LEN
is the length of the ZSYS^DDL^PROCESSRESULTS structure. Because the structure is subject to
change, Z^LEN is used by PROCESS_SPAWN_ to identify the version of the structure.
Z^PHANDLE
returns the process handle of the new process. If you created the process in a nowait manner,
the process handle is returned in the completion message sent to $RECEIVE rather than in this
parameter.
Z^PID
returns the process ID of the new process. If you created the process in a nowait manner, then
the returned value is 0D and the process ID is returned in the completion message sent to
$RECEIVE. If an error occurs (Z^ERRNO or Z^TPCERROR are not 0), then the returned value
is -1D.
Z^ERRNO
indicates the outcome of the process creation.
The more common OSS errno values returned in Z^ERRNO are:
DescriptionZ^ERRNO
No error. The corresponding OSS errno value is ENOERR.0
No such pathname exists. The corresponding OSS errno value is ENOENT.4002
A physical input or output error occurred. The corresponding OSS errno value is EIO.4005
The argument list, specified by the argv parameter, is too long. The corresponding OSS errno
value is E2BIG.
4007
The oss-program-file parameter has the appropriate permissions, but is not in the format for
executable files. The corresponding OSS errno value is ENOEXEC.
4008
A file descriptor specified in the fdinfo parameter is either out of range or does not exist. The
corresponding OSS errno value is EBADF.
4009
System resources are inadequate. The corresponding OSS errno value is EAGAIN.4011
There is insufficient user memory to create the process. The corresponding OSS errno value is
ENOMEM.
4012
Search permission is denied on a component of the pathname prefix. The corresponding OSS
errno value is EACCES.
4013
A specified parameter has an invalid address. The corresponding OSS errno value is EFAULT.4014
A prefix within a pathname refers to a file other than a directory. The corresponding OSS errno
value is ENOTDIR.
4020
Either a parameter in the parameter list is invalid or a required parameter is omitted. The
corresponding OSS errno value is EINVAL.
4022
Operation timed out. The timeout value was reached before a binary semaphore could be locked.
The corresponding OSS errno value is ETIMEDOUT.
4126
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
4131
and Process Identifiers, for pathname syntax. The corresponding OSS errno value is
ENAMETOOLONG.
OSS is not running or is not installed. The corresponding OSS errno value is EOSSNOTRUNNING.4203
An error occurred during the invocation of a Guardian DEFINE. The corresponding OSS errno
value is EDEFINEERR.
4212
1114 Guardian Procedure Calls (P)