Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-168
PROCESS_SPAWN_ Procedure
Syntax for C Programmers
•
CEXTDECS (through the included file TNSINTH) defines 32-bit values as the
typedef __int32_t which for TNS and TNS/R compiles is defined as long and for
TNS/E compiles is defined as
int.
Syntax for TAL Programmers
Parameters
oss-pid returned value
INT(32) .EXT:ref:1
returns 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.
#include <cextdecs(PROCESS_SPAWN_)>
__int32_t PROCESS_SPAWN_ ( [ char *oss-program-file ]
,[ void *fdinfo ]
,[ char *argv ]
,[ char *envp ]
,[ void *inheritance ]
,[ __int32_t inheritance-length ]
,[ void *process-extension ]
,[ void *process-results ]
,[ __int32_t nowait-tag ]
,[ char *path ] );
oss-pid:= PROCESS_SPAWN_ ( oss-program-file ! i
,[ fdinfo ] ! i
,[ argv ] ! i
,[ envp ] ! i
,[ inheritance ] ! i
,[ inheritance-length ] ! i
,[ process-extension ] ! i
,[ process-results ] ! i:o
,[ nowait-tag ] ! i
,[ path ] ); ! i