INSERT(3PVM) PVM Version 3.4 INSERT(3PVM)
NAME
pvm_insert - store data in pvmd database
[In Version 3.4: Relaced by pvm_putinfo]
SYNOPSIS
C int cc = pvm_insert( char *name, int index, int data )
Fortran Not available
PARAMETERS
name The class name, a null-terminated string.
index The class index, >= 0 or -1 for first available.
data Data to store in the <name, index> entry.
DESCRIPTION
The master pvmd maintains a simple database, which can be used to store values such as tids and make them accessible anywhere within a vir-
tual machine. This is useful when building an application such as the group server, which must advertise its task id so clients can regis-
ter 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-nega-
tive 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.
ERRORS
If successful, pvm_insert returns the index at which the data was stored, otherwise it returns a negative result. The following error con-
ditions can be returned:
PvmBadParam
giving an invalid argument value.
PvmDupEntry
the requested <name, index> pair is already in use.
SEE ALSO
pvm_delete(3PVM), pvm_lookup(3PVM)
27 June, 1994 INSERT(3PVM)
