Guardian Procedure Calls Reference Manual

Syntax for C Programmers
#include <cextdecs(PROCESS_CREATE_)>
short PROCESS_CREATE_ ( [ const char *program-file ]
,[ short program-file-length ]
,[ const char *library-file ]
,[ short library-file-length ]
,[ const char *swap-file ]
,[ short swap-file-length ]
,[ const char *ext-swap-file ]
,[ short ext-swap-file-length ]
,[ short priority ]
,[ short processor ]
,[ short *processhandle ]
,[ short *error-detail ]
,[ short name-option ]
,[ const char *name ]
,[ short name-length ]
,[ char *process-descr ]
,[ short maxlen ]
,[ short *process-descr-len ]
,[ __int32_t nowait-tag ]
,[ const char *hometerm ]
,[ short hometerm-length ]
,[ short jobid ]
,[ short create-options ]
,[ const char *defines ]
,[ short debug-options ]
,[ __int32_t pfs-size ] );
• 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
n-length that specifies the length in bytes of the character string. Where the parameters
are optional, the character-string parameter and the corresponding n-length parameter
must either both be supplied or both be absent.
986 Guardian Procedure Calls (P)