## event_receive

### Verwendung

Wenn ein Event ausgelöst wurde, können Sie es mit diesem DBM-Kommando abholen.

Um weitere Events abzuholen, wiederholen Sie dieses DBM-Kommando. Die Events werden in der zeitlichen Reihenfolge ihres Auslösens abgeholt, die älteren Events zuerst.

Bei der ersten Ausführung eines der DBM-Kommandos event_wait, event_receive oder event_available wird eine Event-Sitzung innerhalb der Database Manager-Sitzung erzeugt. Events, die von diesem Zeitpunkt an ausgelöst werden, werden gesammelt und können innerhalb der Event-Sitzung behandelt werden.

Wenn kein Event ausgelöst wurde, erhalten Sie auf das DBM-Kommando event_receive eine Fehlermeldung.

Siehe auch:

Utilities, Event-Dispatcher

### Voraussetzungen

● Sie haben die Serverberechtigung DBInfoRead.

● Der Datenbankparameter _MAXEVENTTASK ist ausreichend groß konfiguriert (Siehe: Konzepte des Datenbanksystems, Support-Datenbankparameter).

### Syntax

event_receive

### Antwort

OK

NAME=<event_category>

PRIORITY=<priority>

VALUE1=<value1>

VALUE2=<value2>

DATE=<yyyymmdd>

TIME=<HHmmss>

COUNT=<count>

TEXT=[<text>]

Werte für die Felder der Antwort

Wert | Beschreibung
<event_category> | Event-Kategorie
<priority> | auswertbare Eigenschaft des Events, mögliche Werte sind: LOW | MEDIUM | HIGH
<value1> | numerischer Wert 1, dessen Bedeutung vom Event abhängt, bei den Events der Kategorien DBFILLINGABOVELIMIT, DBFILLINGBELOWLIMIT und LOGABOVELIMIT: Anzahl der belegten Seiten
<value2> | numerischer Wert 2, dessen Bedeutung vom Event abhängt, bei den Events der Kategorien DBFILLINGABOVELIMIT, DBFILLINGBELOWLIMIT und LOGABOVELIMIT: Prozentsatz der belegten Seiten
<date> | Tag, an dem das Event ausgelöst wurde Zeitformat: <yyyymmdd> (Jahr Monat Tag)
<time> | Zeit, zu der das Event ausgelöst wurde Zeitformat: <HHMMSS> (Stunden Minuten Sekunden)
<count> | laufende Nummer des Events Das System beginnt die Nummerierung mit dem Überführen der Datenbankinstanz in den Betriebszustand ONLINE.
<text> | Text, dessen Bedeutung vom Event abhängt

Im Fehlerfall siehe Antwortformat.