Guardian Procedure Calls Reference Manual

process-extension
input
The process-extension parameter may be either:
STRING .EXT:ref:(ZSYS^DDL^PROCESSEXTENSION^DEF)
or
STRING .EXT:ref:(ZSYS^DDL^PROCESSEXTENSION64^DEF)
which specifies the Guardian attributes of the new process. For information on how to set the
field values of the structure, see Structure Definitions for process-extension (page 1105).
Either data type may be passed as the process-extension parameter.
NOTE: For C/C++ callers that use struct process_extension or process_extension_def from
tdmext.h (rather than zsysc) there is only one version of this structure. 32-bit C/C++ callers
can compile using the #define _PROCEX32_64BIT 1 feature test macro, or an equivalent
compiler command option, to use the 64-bit version of this structure in order to specify larger
values for some process attributes.
process-results
input:output
STRING .EXT:ref:(ZSYS^DDL^PROCESSRESULTS)
provides Guardian information on the outcome of the procedure call. For information on the
field values of the structure, see Structure Definitions for process-results (page 1113).
The tdmext.h header file is not kept current when new error codes are defined for process
creation functions. The list of _TPC_ macros described in this reference page are not complete;
for a current description of error macros and error codes, see the Guardian header file
$SYSTEM.ZSPIDEF.ZGRDC or Table 35 (page 1061).
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. For details,
see the PROCESS_LAUNCH_ Nowait Considerations (page 1075). 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.
NOTE: This parameter will remain as an INT(32) /__int32_t data type. 64-bit callers
who specify an address for this parameter need to specify 32-bit addresses rather than 64-bit
addresses.
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 this string syntax in the
first line of the file:
#! interpreter-name optional-arguments
PROCESS_SPAWN_ Procedure 1099