Guardian Procedure Calls Reference Manual

Specifically, if the path parameter is not specified or is null (0D), and a shell script does not
have the syntax shown above, PROCESS_SPAWN_ returns OSS errno value 4008 (ENOEXEC)
in the ZSYS-DDL-PROCESSRESULTS.Z-ERRNO field of the process-results parameter.
NOTE: Use only the files specified in these pages to obtain the definitions for the structures and
literals. The definitions in other files may produce undesired results.
Returned Value
INT(32) .EXT:ref:1
The OSS process ID of the new process. If you created the process in a nowait manner, then the
returned value is 0D, and the OSS process ID is returned in the completion message sent to
$RECEIVE. If an error occurs, the returned value is -1D.
Structure Definitions for fdinfo
The fdinfo parameter specifies the file descriptors to be opened or duplicated by the new process.
The structure for the fdinfo parameter can contain multiple occurrences of the Z^FDENTRY
substructure (fdentry for C programs).
In the TAL ZSYSTAL file, the structure for the fdinfo parameter is defined as:
STRUCT ZSYS^DDL^FDINFO^DEF (*);
BEGIN
INT(32) Z^LEN;
INT(32) Z^TIMEOUT;
INT(32) Z^UMASK;
INT(32) Z^CWD;
INT(32) Z^FDCOUNT;
STRUCT Z^FDENTRY;
BEGIN
INT(32) Z^FD;
INT(32) Z^DUPFD;
INT(32) Z^NAME;
INT(32) Z^OFLAG;
INT(32) Z^MODE;
END;
END;
For TAL programs, these default values must be specified when an option is not wanted:
Default ValueField Name
$OFFSET(ZSYS^DDL^FDINFO.FDENTRY.Z^MODE) +
$LEN(ZSYS^DDL^FDINFO.FDENTRY.Z^MODE)
Z^LEN
-1DZ^TIMEOUT
-1DZ^UMASK
0DZ^CWD
0DZ^FDCOUNT
0DZ^FDENTRY.Z^FD
0DZ^FDENTRY.Z^DUPFD
0DZ^FDENTRY.Z^NAME
0DZ^FDENTRY.Z^OFLAG
0DZ^FDENTRY.Z^MODE
1100 Guardian Procedure Calls (P)