1INSERT(3PVM)                    PVM Version 3.4                   INSERT(3PVM)
2
3
4

NAME

6       pvm_insert - store data in pvmd database
7       [In Version 3.4: Relaced by pvm_putinfo]
8
9

SYNOPSIS

11       C    int cc = pvm_insert( char *name, int index, int data )
12
13       Fortran   Not available
14
15

PARAMETERS

17       name    The class name, a null-terminated string.
18
19       index   The class index, >= 0 or -1 for first available.
20
21       data    Data to store in the <name, index> entry.
22
23

DESCRIPTION

25       The master pvmd maintains a simple database, which can be used to store
26       values such as tids and make them accessible anywhere within a  virtual
27       machine.  This is useful when building an application such as the group
28       server, which must advertise its task id so clients can  register  send
29       messages to register.
30
31       The  database stores integer data, indexed by <name, index> pairs.  The
32       name may be any null-terminated string and the index  any  non-negative
33       integer.   Database entries are grouped by name into classes; index may
34       be specified as -1 to store or retrieve the first available instance in
35       a class.
36
37       These functions are not part of the group library, but are the underly‐
38       ing mechanism used to implement it.
39
40       pvm_insert stores data at the given index.  If index is -1, the data is
41       stored at the first available index in the named class, starting at 0.
42
43
44

ERRORS

46       If  successful,  pvm_insert  returns  the  index  at which the data was
47       stored, otherwise it returns a negative result.   The  following  error
48       conditions can be returned:
49
50       PvmBadParam
51              giving an invalid argument value.
52
53       PvmDupEntry
54              the requested <name, index> pair is already in use.
55

SEE ALSO

57       pvm_delete(3PVM), pvm_lookup(3PVM)
58
59
60
61                                 27 June, 1994                    INSERT(3PVM)
Impressum