Entering content frame

Procedure documentation event_wait Locate the document in the library structure

Use

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.

Recommendation

Use this DBM command preferably via a programming interface of the Database Manager .

Prerequisites

·        You have the DBInfoRead server authorization.

·        The database parameter _MAXEVENTTASK has been configured sufficiently large (see: Concepts of the Database System, Support Database Parameter).

Syntax

event_wait

Reply

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

Example

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=

 

Leaving content frame