DitsMsgWait - Wait until a message arrives and return before processing
Wait until a message arrives and return before processing it.
This routine will block until a DRAMA message is available
for the task. If will then return prior to processing that
message such that DitsMsgReceive() can then process the message.
This is not required as DitsMsgReceive() will block to wait for
the message, but can be useful if you need to do something
(take a semaphore) between reception and processing of a message.
This makes use the message peeking facility, so the first message
to arrive will be considered peeked at and therefore not accessible
to the DitsPeek(3) routine.
(void) = DitsMsgWait (status)
(">" input, "!" modified, "W"
workspace, "<" output)
!||status||StatusType *||Modified status.
External functions used
Wait for a message.
Indication completion of read.
External values used
DitsTask - Details of the current task
DitsAppInit should have been called.
The Dits Specification Document, DitsMsgReceive(3),
DitsMainLoop(3), DitsMsgAvail(3), DitsPeek(3).
Tony Farrell, AAO
Click here for the DRAMA home page and
here for the AAO home page.
For more information, contact firstname.lastname@example.org