Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-54
MESSAGESTATUS Procedure
MESSAGESTATUS Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Related Programming Manual
Summary
MESSAGESTATUS determines if a particular message received through
READUPDATE has been canceled.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
status returned value
INT
is a value indicating the cancellation status of the indicated message:
1 Message has been canceled.
0 Message has not been canceled.
-1 No pending message is associated with the given tag (see “Considerations”).
message-tag input
INT:value
is the message tag returned from FILE_GETRECEIVEINFO_ or RECEIVEINFO
following receipt of the message. If omitted, the most recently received message
is indicated.
Considerations
•
If a message is canceled, any information supplied to REPLY (which must still be
called) is not passed back to the message originator. A message can be canceled
because the originator called CANCEL, CANCELREQ, FILE_CLOSE_ , CLOSE, or
#include <cextdecs(MESSAGESTATUS)>
short MESSAGESTATUS ( [ short message-tag ] );
status := MESSAGESTATUS ( [ message-tag ] ); ! i