NAME

       pvm_getmwid, pvm_setmwid - Get or set wait ID of a message.
       [In Version 3.4: Relaced by pvm_getminfo and pvm_setminfo]

SYNOPSIS

       C    int info = pvm_getmwid( int bufid )
            int info = pvm_setmwid( int bufid, int waitid )

       Fortran   Not Available

PARAMETERS

       bufid   Message buffer identifier.

       waitid  Wait identifier number.

DESCRIPTION

       A  wait  identifier is part of a message (like the source, destination, tag and body).  It
       is used to match a reply to the corresponding request.

       The default wait ID for a message is zero (none).

       pvm_getmwid returns the wait ID associated with a message  buffer,  or  a  negative  error
       code.

       pvm_setmwid  assigns  a new wait ID to a message buffer.  It returns PvmOk unless an error
       occurs.

EXAMPLES

            int src, tag;

            pvm_recv(-1, -1);
            /* ... process, compose reply message */
            pvm_setmwid(pvm_getsbuf(), pvm_getmwid(pvm_getrbuf()));
            pvm_bufinfo(pvm_getrbuf(), (int *)0, &tag, &src);
            pvm_send(src, tag);

ERRORS

       The following error conditions can be returned by pvm_getmwid or pvm_setmwid:

       PvmBadParam
              Invalid value for bufid argument.

       PvmNoSuchBuf
              Message buffer bufid doesn't exist.

SEE ALSO

       pvm_bufinfo(3PVM)

                                           18 May, 1994                             SETMWID(3PVM)