Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-116
PROCESS_LAUNCH_ Procedure
PROCESS_LAUNCH_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Structure Definition for param-list
Structure Definition for output-list
General Considerations
Nowait Considerations
DEFINE Considerations
Batch Processing Considerations
Safeguard Considerations
OSS Considerations
Related Programming Manuals
Summary
The PROCESS_LAUNCH_ procedure creates a new process and, optionally, assigns
a number of process attributes.
You can use this procedure to create only Guardian processes, although you can call it
from a Guardian process or an OSS process. The program file must contain a
program for execution in the Guardian environment. The program file and any user
library file must reside in the Guardian name space; that is, they must not be OSS files.
You can specify that the new process be created in either a waited or nowait manner.
When it is created in a waited manner, identification for the new process is returned
directly to the caller. When it is created in a nowait manner, its identification is returned
in a system message sent to the caller’s $RECEIVE file.
DEFINEs can be propagated to a new process. The DEFINEs can come from the
caller’s context or from a buffer of DEFINEs saved by the DEFINESAVE procedure.
Any parameter that can specify a file name can contain a DEFINE.
Syntax for C Programmers
The parameter maxlen specifies the maximum length in bytes of the character string
pointed to by output
-list, the actual length of which is returned by output-list-
len. These three parameters must either all be supplied or all be absent.
#include <cextdecs(PROCESS_LAUNCH_)>
short PROCESS_LAUNCH_ ( void *param-list /* i 1*/
,[ short *error-detail ] /* o 2*/
,[ void *output-list ] /* o:i 3*/
,[ short maxlen ] /* o:i 3*/
,[ short *output-list-len ); /* o 4*/