Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-40
PROCESS_CREATE_ Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the operation. Table 12-3
on page 12-118 summarizes
possible values for
error.
program-file:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
length is not 0, specifies the name of the program file to be run.
If used, the value of
program-file must be a valid file name and must be exactly
length bytes long. The file must reside in the Guardian name space and must
contain a program for execution in the Guardian environment.
The new process is created on the node where the program file resides. If the
program file name is partially qualified, it is resolved using the =_DEFAULTS
DEFINE. If you specify a file on the subvolume $SYSTEM.SYSTEM and the file is
not found, PROCESS_CREATE_ then searches on the subvolume
$SYSTEM.SYS
nn.
Refer to Appendix D, File Names and Process Identifiers
, for a description of file
name syntax.
This parameter must be supplied unless the caller is creating its backup process.
error := PROCESS_CREATE_ ( [ program-file: length ] ! i,i 1 !
,[ library-file: length ] ! i:i 2 !
,[ swap-file: length ] ! i:i 3 !
,[ ext-swap-file: length ! i:i 4 !
,[ priority ] ! i 5 !
,[ processor ] ! i 6 !
,[ processhandle ] ! o 7 !
,[ error-detail ] ! o 8 !
,[ name-option ] ! I 9 !
,[ name: length ] ! i:i10 !
,[ process-descr: maxlen ]!o:i 11 !
,[ process-descr-len ] ! o 12 !
,[ nowait-tag ] ! i 13 !
,[ hometerm: length ] !i:i 14 !
,[ memory-pages ] ! i 15 !
,[ jobid ] ! i 16 !
,[ create-options ] ! i 17 !
,[ defines: length ] !i:i 18 !
,[ debug-options ] ! i 19 !
,[ pfs-size ] ); ! i 20 !