Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
! input/output error detail
error := PROCESS_CREATE_ ( [ program-file:progam-file-length ] ! i,i 1
,[ library-file:library-file-length ] ! i:i 2
,[ swap-file:swap-file-length ] ! i:i 3
,[ ext-swap-file: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:name-length ] ! i:i 10
,[ process-descr:maxlen ] ! o:i 11
,[ process-descr-len ] ! o 12
,[ nowait-tag ] ! i 13
,[ hometerm:home-term-length ] ! i:i 14
,[ memory-pages ] ! i 15
,[ jobid ] ! i 16
,[ create-options ] ! i 17
,[ defines:defines-length ] ! i:i 18
,[ debug-options ] ! i 19
,[ pfs-size ] ); ! i 20
• The number in the comment after each parameter shows the value assigned to error-detail
when identifying an error on that parameter.
Parameters
program-file:program-file-length
input:input
STRING .EXT:ref:*, INT:value
if supplied and if program-file-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
program-file-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.SYSnn.
For a description of file name syntax, see Appendix D: File Names and Process Identifiers.
This parameter must be supplied unless the caller is creating its backup process.
library-file:library-file-length
input:input
STRING .EXT:ref:*, INT:value
if supplied and if library-file-length is not 0 or -1, specifies the name of the user library
file to be used by the process. If used, the value of library-file must be exactly
library-file-length bytes long. If the library file name is partially qualified, it is resolved
using the =_DEFAULTS DEFINE. The user library file must be on the same node as the process
being created and must reside in the Guardian name space.
If library-file is specified and library-file-length is -1, the new process is to run
with no user library file.
If library-file is not specified or library-file-length is 0, then the program runs
with the library file specified in the program file, if any.
PROCESS_CREATE_ Procedure (Superseded by PROCESS_LAUNCH_ Procedure) 987