MESSAGE_HANDLE

The MESSAGE_HANDLE integer tag is returned from a successful call to the SEND_MESSAGE function, set with a value that uniquely identifies the message that was submitted. Handles for new messages do not need to be saved, as they can be retrieved later, along with the message that they identify, by calling the the GET_Q_ENTRIES_INFO function.

Type

Max Size

Multiple Allowed

Integer

4 bytes

Example:

function DeleteMessage( MessageHandle)
{
var Tl = CAS.New();
CAS.AddTag(Tl,"DELETE_MESSAGE","");
CAS.AddTag(Tl,"REGISTERED_NAME",UserName);
CAS.AddTag(Tl,"REGISTERED_PASSWORD",UserPassword);
CAS.AddTag(Tl,"MESSAGE_HANDLE",MessageHandle);
// Delete message on this already open session
Tl = CAS.Send(cInst,Tl);
LastErrorNum = CAS.GetTag(Tl,"STATUS_NUM",0);
LastErrorStr = CAS.GetTag(Tl,"STATUS",0);
CAS.Delete(Tl);
return( LastErrorNum);
}