mpiSqNodeEventNotifySet
Declaration
MPI_RESULT mpiSqNodeEventNotifySet(MPISqNode node, const MPIEventMask eventMask, const MPIEventNotifyData *eventNotifyData);
Required Header: stdmpi.h
Change History: Modified in 04.00.
Description
mpiSqNodeEventNotifySet requests host notification of the event(s) that are generated by SqNode and specified by eventMask, and also specified the event notification structure (that specifies the event message controller addresses) to the location pointed to by eventNotifyData.
Use the event mask macros mpiEventMaskSQNODE(...), mpiEventMaskSET(...), mpiEventMaskBitSET(...), mpiEventMaskCLEAR(...), etc. to create the eventMask.
| node | a handle to a SynqNet node object |
|---|---|
| eventMask | pointer to an event mask, whose bits are defined by the MPIEventType enumerations. |
| *eventNotifyData | pointer to an event notification data structure, which contains a list of controller addresses. The event data specified by the addresses is copied into the event message by the controller |
| Return Values |
|---|
| MPIMessageOK |
| MPIMessageARG_INVALID |
Sample Code
/* Request notification of all events from SqNode */ mpiEventMaskCLEAR(eventMask); returnValue = mpiSqNodeEventNotifyGet(node, &eventMask, NULL); mpiEventMaskSQNODE(eventMask); if (returnValue == MPIMessageOK) { returnValue = mpiSqNodeEventNotifySet(node, eventMask, NULL); }