Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-39
PROCESS_CREATE_ Procedure
(Superseded by PROCESS_LAUNCH_ 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.
•
The parameter maxlen specifies the maximum length in bytes of the character
string pointed to by
process-descr, the actual length of which is returned by
process-descr-len. All three of these parameters must either be supplied or
be absent.
•
Some character-string parameters to PROCESS_CREATE_ are followed by a
parameter
length that specifies the length in bytes of the character string. Where
the parameters are optional, the character-string parameter and the corresponding
length parameter must either both be supplied or both be absent.
#include <cextdecs(PROCESS_CREATE_)>
short PROCESS_CREATE_ ( [ const char *program-file ]/* i,i1*/
,[ short length ] /* i,i1*/
,[ const char *library-file ] /*i,i 2*/
,[ short length ] /* i,i2*/
,[ const char *swap-file ] /* i,i3*/
,[ short length ] /* i,i3*/
,[ const char *ext-swap-file ] /* i,i4*/
,[ short length ] /* i,i4*/
,[ short priority ] /* i 5*/
,[ short processor ] /* i 6*/
,[ short *processhandle ] /* o 7*/
,[ short *error-detail ] /* o 8*/
,[ short name-option ] /* i 9*/
,[ const char *name ] /*i,i10*/
,[ short length ] /*i,i10*/
,[ char *process-descr ] /*o,i11*/
,[ short maxlen ] /* o,i11*/
,[ short *process-descr-len ] /* o 12*/
,[ __int32_t nowait-tag ] /* i 13*/
,[ const char *hometerm ] /*i,i 14*/
,[ short length ] /* i,i14*/
,[ short memory-pages ] /* i 15*/
,[ short jobid ] /* i 16*/
,[ short create-options ] /* i 17*/
,[ const char *defines ] /*i,i 18*/
,[ short length ] /*i,i 18*/
,[ short debug-options ] /* i 19*/
,[ __int32_t pfs-size ] ); /* i 20 */;