You work in session mode and fetch the messages of the Database Manager about the occurrence of the event and the corresponding data. These are then deleted.
This first time you execute one of the DBM commands event_wait, event_receive or event_available an event task is generated for this Database Manager session. Events that are triggered from this time on are collected and can be dealt with within this session.
The events are fetched in the chronological order in which they were triggered, the oldest events are fetched first.
If the data about the event that occurred has been fetched, you evaluate it, enter the command again and wait for the next notification from the Database Manager about the occurrence of an event.
You do not receive a reply to this DBM command until an event occurs.
Use this DBM command preferably via a programming interface of the Database Manager .
· You have the DBInfoRead server authorization.
· The database parameter _MAXEVENTTASK has been configured sufficiently large (see: Concepts of the Database System, Support Database Parameter).
event_wait
OK
NAME=<event_category>
PRIORITY=<priority>
VALUE1=<value1>
VALUE2=<value2>
DATE=<yyyymmdd>
TIME=<HHmmss>
COUNT=<count>
TEXT=[<text>]
Values for the Reply Fields
Value |
Description |
<event_category> |
Event category |
<priority> |
Priority of the event; possible values are: LOW: low priority MEDIUM: medium priority HIGH: high priority |
<value1> |
Numerical value 1, the meaning of which depends on the event |
<value2> |
Numerical value 2, the meaning of which depends on the event |
<date> |
Day on which event was triggered Time format: <yyyymmdd> (year month day) |
<time> |
Time at which event was triggered Time format: <HHMMSS> (hours minutes seconds) |
<count> |
Current number of the event The system starts numbering with transferring database instance into the operational state ONLINE. |
<text> |
Text, the meaning of which depends on the event |
In the event of errors, see Reply Format
1. Logging on to the Database Manager CLI in session mode as operator OLEG with the password MONDAY, connecting to the database instance DEMODB,
>dbmcli -u OLEG,MONDAY -d DEMODB
dbmcli on DEMODB>
2. Entering the DBM command for waiting for an event:
dbmcli on DEMODB>event_wait
OK
NAME=DBFILLINGABOVELIMIT
PRIORITY=LOW
DATE=20050615
TIME=150344
VALUE1=6998
VALUE2=70
COUNT=8
TEXT=