12.2 - Task Messages

Instances of DtTaskMessage (taskMsg.h) are derived from DtVrfObjectMessage (radioMsg.h) and are used to convey information about a task.

Entities receive tasks on their radio in the form of DtTaskMessages. These messages may be sent to an entity as a result of:

• The planning engine executing a task statement in the entity's plan
• A directive from a superior entity
• A task command in the GUI.

DtTaskMessage is one of three types of DtVrfObjectMessage. The DtTaskMessage class overrides the member function radioMessageType() to return the string type DtTaskMessageType. The radio message types are defined in radioMsgTypes.h.

In all cases, the task (a DtSimTask object) is packaged inside of a DtTaskMessage and sent to the appropriate entity by radio. (For details, please see vrfOverview.) The DtTaskMessage class maintains its own copy of the DtSimTask it is carrying. You set the task in the message by calling its setTask() member function, giving it a pointer to a DtSimTask. The DtTaskMessage class makes its own copy of the message, so the memory pointed to by the DtSimTask that you passed into the DtTaskMessage class should be deleted in the calling application code.

[<< Tasks and Set Data Requests] [Home] [Top of Page] [Adding a New Task for an Entity >>]