VARCHAR(128) 型のメッセージ ID。

このアドレスを持つ、キューに登録されたメッセージがない場合は、NULL を返します。

指定された QAnywhere メッセージアドレス宛ての待機中のメッセージがあるかどうかを同期的にチェックするには、このストアドプロシージャーを使用します。指定された QAnywhere アドレス宛てのメッセージが発生した場合に、非同期で SQL プロシージャーを呼び出すには、Mobile Link Listener を使用します。

このストアドプロシージャーは、メッセージがキューに登録されるまで処理をブロックします。

ブロックを回避する方法の詳細については、ml_qa_getmessagenowaitまたはml_qa_getmessagetimeoutを参照してください。

返されるメッセージ ID に対応するメッセージが受信されたとみなされるのは、現在のトランザクションがコミットされた後です。受信がコミットされたメッセージは、このストアドプロシージャーやいかなる QAnywhere API でも受信することができません。同様に、現在のトランザクションがロールバックされると、メッセージが受信されていないことを意味します。このため、以降の ml_qa_getmessage の呼び出しで同じメッセージ ID が返される可能性があります。

受信されたメッセージのプロパティと内容は、現在のトランザクションに対してコミットまたはロールバックが実行されるまでの間、各種の ml_qa_get ストアドプロシージャーを使用して読み込むことができます。現在のトランザクションに対してコミットまたはロールバックが実行された時点で、そのメッセージデータは読み込めなくなります。コミットを実行する前に、メッセージ内の必要なデータを表形式のデータとして、または SQL 変数に保存してください。

• SQL アプリケーションの設定
• ml_qa_getmessagenowait
• ml_qa_getmessagetimeout
• メッセージヘッダー
• メッセージプロパティ
• メッセージの内容

次の例では、アドレス myaddress に送信されたすべてのメッセージの内容を表示します。

begin
    declare @msgid varchar(128);
    loop
        set @msgid = ml_qa_getmessage( 'myaddress' );
        message 'a message with content ' || ml_qa_gettextcontent( @msgid ) || ' has been received';
        commit;
    end loop;
end