mpiSequenceEventNotifySet

Declaration
long mpiSequenceEventNotifySet(MPISequence   sequence,
                               MPIEventMask  eventMask,
                               void          *external) 
Required Header stdmpi.h
Description

SequenceEventNotifySet requests host notification of the event(s) specified by eventMask and generated by a Sequence (sequence), and also using data from the implementation-specific structure pointed to by external (if external is not NULL).

The event mask information in external is in addition to the event mask information in eventMask, i.e, the event mask information in eventMask and in external is not the same information. Note that eventMask or external can be NULL (but not both NULL).

The mask of event types generated by a Sequence object consists of MPIEventMaskEXTERNAL. When a Sequence issues a Command of type MPICommandTypeEVENT, an event of type MPIEventTypeEXTERNAL is generated. The only event generated by a Sequence is MPIEventTypeEXTERNAL, which is generated when a Sequence issues a Command of type MPICommandTypeEVENT.

To Use "eventMask"
Disable host notification of all Sequence events MPIEventTypeNONE
Enable host notification of all Sequence events MPIEventMaskALL
XMP Only

external either points to a structure of type MEIEventMask{} or is NULL.

Return Values
MPIMessageOK if SequenceEventNotifySet successfully requests host notification of the events in the event mask(s)
See Also MPIEventMaskEXTERNAL | MEIEventMask | mpiSequenceEventNotifyGet