DitsMainLoop - Dits main loop

Function

Dits main loop

Description

This is the main message loop routine. It blocks waiting for messages and processes them when they are received. It does this until an application routine requests that the task exit using DitsPutRequest.

Assuming there is no internal error in Dits, the status value returned by this function is the completion status of the user action routine with requested the exit.

Note, this function is implemented as a macro.

Language

C

Call

(Void) = DitsMainLoop (status)

Parameters

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

!statusStatusType *Modified status.

Include files

DitsSys.h

External functions used

DitsMsgReceiveDits Receive a message.

External values used

DitsTask

Prior requirements

DitsAppInit should have been called. This routine is NOT to be called from user action routines, but instead from the user main program.

See Also

The Dits Specification Document, DitsMsgReceive(3), DitsMsgAvail(3), DtclAppMainLoop(3), DtclAppTkMainLoop(3), DitsAltInLoop(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