(void)ams_getreply( timeout, path, messid, message_name_s,
message_value_s, message_status, message_context, message_name,
message_length, message_value, status )

timeout = int (given)

path = int (given)

messid = int (given)

message_name_s = int (given)

message_value_s = int (given)

message_status = int * (returned)

message_context = int * (returned)

message_name = char * (returned)

message_length = int * (returned)

message_value = char * (returned)

status = int * (given and returned)

The application has sent a message on path ’path’ as part of transaction ’messid’ and wishes to obtain the reply within ’timeout’ milliseconds. A timeout value of MESSYS__INFINITE indicates no time limit.

Any received message is unpacked appropriately and the contents returned to the calling routine. Only those arguments relevant to the particular message type will be returned.

Note that the received message may be a TIMEOUT message as a result of the timer being set.

The function first checks the transaction (messid) is legally identified and that there exists an acknowledge queue for that transaction.

If ’timeout’ is not MESSYS__INFINITE, it then sets the timer clock going so that we get a timeout if there is no response within timeout milliseconds. The ATIMER package is used to handle timers.

The function then looks for a message on either the external interrupt queue, the transaction acknowledge queue or the timeout queue.