DitsMsgWait - Wait until a message arrives and return before processing it.

Function

Wait until a message arrives and return before processing it.

Description

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.

Language

C

Call

(void) = DitsMsgWait (status)

Parameters

(">" input, "!" modified, "W" workspace, "<" output)

!statusStatusType *Modified status.

Include files

DitsSys.h

External functions used

ImpReadPtrImp Wait for a message.
ImpReadEndImp Indication completion of read.

External values used

DitsTask - Details of the current task

Prior requirements

DitsAppInit should have been called.

See Also

The Dits Specification Document, DitsMsgReceive(3), DitsMainLoop(3), DitsMsgAvail(3), DitsPeek(3).

Support

Tony Farrell, AAO

Click here for the DRAMA home page and here for the AAO home page.

 For more information, contact tjf@aao.gov.au