Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-171
PROCESS_SPAWN_ Procedure
functions. The list of _TPC_ macros described in this reference page is not
complete; for a current description of error macros and error codes, see the
Guardian header
file $SYSTEM.ZSPIDEF.ZGRDC or Table 12-3, Summary of
Process Creation Errors .
nowait-tag input
INT(32):value
if present and not equal to -1D, indicates that the process is to be created in a
nowait manner; the PROCESS_SPAWN_ procedure returns as soon as process
creation is initiated. See “Nowait Considerations” for details. The Z^TIMEOUT
field of the
fdinfo structure also contains nowait considerations.
If
nowait-tag is equal to -1D, the process is created in a waited manner.
path input
STRING .EXT:ref:*
if present and not null (0D), and if the
oss-program-file parameter does not
contain a slash character, specifies a null-terminated string of path prefixes
separated by colons to further identify the
oss-program-file parameter. If the
resolved name is not the name of a program file, then the
oss-program-file
parameter is treated as a shell script for the command interpreter. The path
parameter is equivalent to the OSS path environment variable.
If the path parameter is not specified, then a shell script must contain the following
string syntax in the first line of the file:
#! interpreter-name optional-arguments
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 the following pages to obtain the definitions for the
structures and literals. The definitions in other files may produce undesired results.