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 virtual machine.  This is useful when building an application such as the
       group server, 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.

ERRORS

       If successful, pvm_insert returns the index at which the data was stored, otherwise it returns a negative
       result.  The following error conditions 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)