mpiNotifyEventMaskSet

Declaration

	long mpiNotifyEventMaskSet(MPINotify notify, MPIEventMask mask)
	Required Header: stdmpi.h

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.

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);
}