Die Nachricht-ID als VARCHAR(128)

Gibt NULL zurück, wenn für diese Adresse keine Nachricht in der Warteschlange steht.

Verwenden Sie diese gespeicherte Prozedur, um zu prüfen, ob eine Nachricht auf die angegebene QAnywhere-Nachrichtenadresse wartet. Verwenden Sie den Listener, wenn eine SQL-Prozedur asynchron aufgerufen werden soll, sobald eine Nachricht für eine angegebene QAnywhere-Adresse verfügbar ist.

Diese gespeicherte Prozedur blockiert, bis eine Nachricht in die Warteschlange gestellt wird.

Weitere Informationen dazu, wie Sie das Blockieren vermeiden können, finden Sie unter ml_qa_getmessagenowait oder ml_qa_getmessagetimeout.

Die Nachricht, die der zurückgeschickten Nachricht-ID entspricht, wird als nicht empfangen eingestuft, bis die laufende Transaktion festgeschrieben ist. Nachdem der Empfang bestätigt wurde, kann die Nachricht von dieser oder einer anderen QAnywhere-API nicht nochmals empfangen werden. Ein Zurücksetzen der aktuellen Transaktion wiederum bedeutet, dass die Nachricht nicht empfangen wurde, daher können nachfolgende Aufrufe von ml_qa_getmessage dieselbe Nachricht-ID zurückgeben.

Die Eigenschaften und Inhalte der empfangenen Nachrichten können mit den gespeicherten Prozeduren der Serie ml_qa_get gelesen werden, bis ein Festschreiben oder ein Zurücksetzen der aktuellen Transaktion erfolgt. Wenn ein Festschreiben oder ein Zurücksetzen der aktuellen Transaktion erfolgt, sind die Daten der Nachricht nicht mehr verfügbar. Vor dem Festschreiben sollten Sie daher Daten, die Sie aus der Nachricht benötigen, als tabellarische Daten oder in SQL-Variablen speichern.

• SQL-Anwendungen initialisieren
• ml_qa_getmessagenowait
• ml_qa_getmessagetimeout
• Nachrichtenheader
• Nachrichteneigenschaften
• Nachrichteninhalt

Im folgenden Beispiel wird der Inhalt aller Nachrichten angezeigt, die an die Adresse myaddress gesendet werden:

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