ml_qa_getpriority

メッセージの優先度レベルを返します。

パラメータ

項目	説明	備考
1	メッセージ ID	VARCHAR(128)。メッセージ ID は、ml_qa_createmessage または ml_qa_getmessage から取得できます。

戻り値

INTEGER 型の優先度レベル。

備考

QAnywhere API では、10 レベルの優先度が定義されています。0 が最低の優先度、9 が最高の優先度を表します。クライアントは、優先度 0 ～ 4 を通常のメッセージ、優先度 5 ～ 9 を緊急度の高いメッセージとみなす必要があります。

このヘッダは、メッセージの受信後からロールバックまたはコミットが行われるまでの間に読み込むことができます。ロールバックまたはコミットが行われた後で読み込むことはできません。

参照

例

次の例では、メッセージを受信して、その優先度をデータベース・サーバ・メッセージ・ウィンドウに出力します。

begin
    declare @msgid varchar(128);
    declare @priority integer;
    set @msgid = ml_qa_getmessage( 'myaddress' );
    set @priority = ml_qa_getpriority( @msgid );
    message 'a message with priority ' || @priority || ' has been received';
    commit;
end