DitsInterested - Indicates the current action is interested in certain messages.

Function

Indicates the current action is interested in certain messages.

Description

An action may be caused to reenter when external messages are received from subsidiary actions. This routine indicates additional message types the action is interested in.

By default, the action will be interested in trigger, transaction failure and transaction completion messages

Note, this function is implemented as a macro.

Language

Call

(Void) = DitsInterested(mask, status)

Parameters

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

>	mask	DitsMsgMaskType	A bit mask indicating which additional messages the action is interested in. Any of the following bits may be set

`DITS_MSG_M_ERROR`	Error reports, those messages sent by a call to ErrOut or ErrFlush.
`DITS_MSG_M_MESSAGE`	Messages to the user interface, those messages sent by MsgOut.
`DITS_MSG_M_TRIGGER`	Trigger messages, those messages sent by DitsTrigger.
`DITS_MSG_M_TRANSFAIL`	Transaction failure messages
`DITS_MSG_M_COMPLETION`	Transaction completion messages

`!`	status	StatusType `*`	Modified status.

Include files

DitsInteraction.h

External functions used

None

External values used

TheTask - Details of the current task

Prior requirements

Can only be called from a Dits application routine

Support

Tony Farrell, AAO

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

For more information, contact tony.farrell@mq.edu.au