Guardian Procedure Calls Reference Manual

PROCESS_LAUNCH_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Structure Definitions for param-list
Structure Definitions for output-list
Process Creation Error Codes
General Considerations
Nowait Considerations
DEFINE Considerations
Batch Processing Considerations
Safeguard Considerations
OSS Considerations
File Privileges 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, a 32-bit OSS process, or a 64-bit 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
#include <cextdecs(PROCESS_LAUNCH_)>
short PROCESS_LAUNCH_ ( void *param-list
,[ short *error-detail ]
,[ void *output-list ]
,[ short maxlen ]
,[ short *output-list-len ] );
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.
1050 Guardian Procedure Calls (P)