Section: PVM Version 3.4 (3PVM)
Updated: 27 June, 1994
Return to Main Contents
pvm_insert - store data in pvmd database
[In Version 3.4: Relaced by pvm_putinfo]
C int cc = pvm_insert( char *name, int index, int data )
Fortran Not available
The class name, a null-terminated string.
The class index, >= 0 or -1 for first available.
Data to store in the <name, index> entry.
The master pvmd maintains a simple database,
which can be used to store values such as tids and make them
accessible anywhere within a virtual
This is useful when building an application such as the group
which must advertise its task id
so clients can register send messages to register.
The database stores integer data,
indexed by <name, index> pairs.
The name may be any null-terminated string
and the index any non-negative integer.
Database entries are grouped by name into classes;
index may be specified as -1 to store or retrieve the first available
instance in a class.
These functions are not part of the group library,
but are the underlying mechanism used to implement it.
pvm_insert stores data at the given index.
If index is -1,
the data is stored at the first available index in the named class,
starting at 0.
pvm_insert returns the index at which the data was stored,
otherwise it returns a negative result.
The following error conditions can be returned:
giving an invalid argument value.
the requested <name, index> pair is already in use.
- SEE ALSO
linux.jgfs.net manual pages