# Auftrag QUEUE-READ

Funktion

Mit einem QUEUE-READ-Auftrag werden Nachrichten aus der Nachrichtenqueue des RRIs vom RegAcc abgeholt bzw. ausgelesen.

Voraussetzung

Nachrichten können nur dann ausgegeben werden, wenn die Gesamtanzahl (MsgCnt) der Nachrichten in der Nachrichtenqueue nicht 0 ist.

Besonderheiten

- Mit einem Auftrag wird immer nur eine Nachricht abgefragt, unabhängig von der Gesamtanzahl, der in der Nachrichtenqueue vorhandenen Nachrichten.
- Mit der Angabe eines Nachrichtentyps lässt sich eine spezifische Nachricht abfragen.

Nachricht auslesen

Allgemein

Beispiel: Ein RegAcc sendet einen QUEUE-READ Auftrag an das RRI.

- In der Nachrichtenqueue sind 3 Nachrichten vorhanden,
  - 2 vom Typ „expireWarning“,
  - 1 vom Typ „authInfoExpire“.
- Die „authinfoExpire“-Nachricht ist die Nachricht mit dem ältesten Datum.

Ergebnis: Ausgegeben wird die Nachricht mit dem ältesten Datum, also „authinfoExpire“.

Spezifisch

Einen spezifischen Nachrichtentyp kann ausgegeben werden durch die Angabe des Schlüsselworts "MsgType", gefolgt vom Nachrichtentyp, z. B. "expireWarning". Existieren mehrere Nachrichten eines Typs in der Nachrichtenqueue wir die Nachricht mit dem ältesten Datum ausgegeben.

Automatischer Reminder bei älteren Nachrichten

- Sind Nachrichten in der Nachrichtenqueue älter als 3 Tage, wird der RegAcc automatisch darüber informiert. Dies geschieht mit einer E-Mail an die "EMailTo"-Adresse aus dem RegAcc-Profil.
- Die Benachrichtigungs-E-Mail wird einmal täglich versendet, wenn die Nachrichten weiterhin in der Nachrichtenqueue verbleiben (und älter als drei Tage sind).

K/V-Schlüsselwort | XML-Namensraum und Element | Vork. min - max | Typ / Länge | Wertebereich | Beschreibung
--- | --- | --- | --- | --- | ---
Action | queue-read | 1 | enumeration | queueread-erule | Auftragstyp
Version | - | 1 | enumeration | version-erule | Version, nur für Aufträge im Key/Value-Format relevant
MsgType | msgtype | 0-1 | enumeration | msgtype-erule | Typ der Nachricht; falls kein MsgType angegeben ist, so wird die älteste Nachricht (sortiert nach MsgTime) ausgegeben