7 Getting Expected Replies

Once a command is in progress between two tasks, they can receive replies specific to that command (as identified by path,messid) by using ams_getreply().

ams_getreply() ignores all messages not associated with the specified (path,messid) except those generated by the ams_extint() function.

For ADAM tasks, expected values of message_status are:

MESSYS__PARAMREQ
Request a parameter value.
MESSYS__PARAMREP
Reply to a PARAMREQ.
MESSYS__INFORM
Message to be displayed
MESSYS__SYNC
Synchronisation request
MESSYS__SYNCREP
Synchronisation reply
MESSYS__TRIGGER
Trigger an action in the master task
DTASK__ACTSTART
2 Acknowledge a GSOC command.

Completion of the command transaction and freeing of the associated messid occurs automatically if the task returns a message_status which is not one of the above. Apart from that, the other arguments returned by ams_getreply are of no significance to AMS.

2This reference to DTASK, the main part of the ADAM task fixed part, is for historical reasons.