pvm_lookup(3) retrieve data from pvmd database

SYNOPSIS


C int cc = pvm_lookup( 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
Returns the data stored in the <name, index> entry.

DESCRIPTION

See pvm_insert(3PVM) for a description of this database.

pvm_lookup retrieves data stored in the location given by <name, index>. If index is -1, the data stored at the first existing index in the named class is returned.

ERRORS

If successful, pvm_lookup returns the index at which the data was stored (>= 0), otherwise it returns a negative error code:
PvmBadParam
giving an invalid argument value.
PvmNoEntry
the requested <name, index> pair does not exist.