## list

### Use

You display the contents of an event dispatcher configuration file.

### Prerequisites

You have created a <configuration_file> for an event dispatcher and stored event definitions in this configuration file with the add command.

### Procedure

dbmevtdisp list <configuration_file>

<configuration_file> | Name and path of the configuration file of the even dispatcher

### Result

OK
ID <entry_ID_1>
condition: <condition_1>
command: <command_1>
.
.
.
ID <entry_ID_n>
condition: <condition_n>
command: <command_n>

Field | Description
<entry_ID_n> | Numerical ID identifying the event definition in the configuration file
<condition_n> | Condition that must be fulfilled in order for the event dispatcher to execute the <command_n> command.
<command_n> | Command that is to be executed when <condition_n> is fulfilled

### Example

You display the contents of the configuration file C:\test\testconfig.cfg.

dbmevtdisp list C:\test\testconfig.cfg

OK
ID 0
condition: ((Name == "DBFILL*") && (Value1 < 10))
command: alarmapp $DBNAME$
ID 1
condition: ((Name == "UPDSTATWANTED"))
command: dbmcli -d $DBNAME$ -u $DBMUSERPW$ sql_updatestat_per_systemtable

The configuration file contains the following entries:

● Entry with ID 0

If the event dispatcher receives an event with a name that begins with the character string DBFILL and a Value1 field containing a value less than 10, it starts the alarmapp program, then transfers the name of the database instance that triggered the event to the program as a parameter.

● Entry with ID 1

If the event dispatcher receives an event with the name UPDSTATWANTED, it logs on to the database instance that triggered the event using the database tool Database Manager CLI. In doing so, it uses the name and password of the DBM user that started the event dispatcher. It then executes the DBM command sql_updatestat_per_systemtable.

See also:

Overview of Event Dispatcher Commands