MPI 04.00 Reference>>mpiNotify

mpiNotifyEventMaskSet

Declaration

long mpiNotifyEventMaskSet(MPINotify    notify,
                           MPIEventMask mask)

Description

mpiNotifyEventMaskSet sets the event type(s) for which notification will be accepted by a Notify object (notify), as specified by mask.

Event notification is accepted for event types specified in mask, a bit mask of MPIEventMask bits (associated with the desired MPIEventType values). The MPIEventMask bits must be set or cleared using the MPIEventMask macros. Event notification is denied for event types not specified in mask.

notify A handle to a notify object.
mask An event mask, whose bits are defined by the MPIEventType enumeration.
Return Values
MPIMessageOK

Sample Code 

/*
  Disables event notification and copies the previously used
  event mask to oldMask.  oldMask may then be used to re-enable
  event notification via another call to mpiNotifyEventMaskSet().
*/
  void NotifyDisable(MPINotify notify, MPIEventMask* oldMask)
{
    MPIEventMask newMask;
    long returnValue;

    returnValue = mpiNotifyEventMaskGet(notify, oldMask);
    msgCheck(returnValue);

    mpiEventMaskCLEAR(newMask);

    returnValue = mpiNotifyEventMaskSet(notify, newMask);
    msgCheck(returnValue);
}

See Also

MPIEventType | mpiNotifyEventMaskGet