1RPGO(2)                       LAM REMOTE LIBRARY                       RPGO(2)
2
3
4

NAME

6       rpgo - Create a LAM process on a remote node from tagged storage.
7

SYNOPSIS

9       #include <kio.h>
10
11       int  rpgo(int  node, int loadtag, int flags, int argvtag, int *pid, int
12              *idx);
13

ARGUMENTS

15       node        where new process will be created
16
17       loadtag     storage tag for program file
18
19       flags       runtime flags passed to new process
20
21       argvtag     storage tag for null-terminated  array  of  strings  to  be
22                   passed as command-line arguments to the new process
23
24       pid         new process identifier (output)
25
26       idx         new process index (output)
27

DESCRIPTION

29       The  executable  program  and  the  argument  structure must already be
30       loaded on the target node via the "flat storage" service.  The  program
31       is  typically loaded from a file with rload(2).  The argument structure
32       is assumed to be packed contiguously:  the  null  terminated  array  of
33       string  pointers followed immediately by the strings themselves.  It is
34       typically loaded to the target node with rflat(2).  The  storage  tags,
35       loadtag  and argvtag, are erased from the target node after the call to
36       rpgo().
37
38       See rploadgo(2) for valid process runtime flags.
39

ERRORS

41       EBADTAG             Either or both of loadtag and argvtag are invalid.
42
43       ENOPDESCRIPTORS     The remote process descriptor table is full.
44
45       ENOFLDESCRIPTORS    The table of strorage blocks (kept by the flat dae‐
46                           mon) is full.
47

SEE ALSO

49       rflat(2), rload(2), rploadgo(2), rpwait(2)
50
51
52
53LAM 7.1.2                         March, 2006                          RPGO(2)