Sets the priority of a message.

Parameters

Remarks

The QAnywhere API defines ten levels of priority value, with 0 as the lowest priority and 9 as the highest. Clients should consider priorities 0-4 as gradations of normal priority and priorities 5-9 as gradations of expedited priority.

You cannot alter this header after the message has been sent.

See also

• Setting up SQL applications
• ml_qa_getpriority
• ml_qa_createmessage
• ml_qa_getmessage

Example

The following example sends a high priority message:

begin
    declare @msgid varchar(128);
    set @msgid = ml_qa_createmessage();
    call ml_qa_setpriority( @msgid, 9 );
    call ml_qa_settextcontent( @msgid, 'priority content' );
    call ml_qa_putmessage( @msgid, 'clientid\queuename' );
    commit;
end