Entering content frame

Procedure documentation start Locate the document in the library structure

Use

You start an event dispatcher that monitors a database instance.

Prerequisites

·        You must have added entries to an event dispatcher configuration file using the add command.

·        To enable the event dispatcher to log on to the database instance, you need the name and password of a DBM operator who has the DBInfoRead server authorization and at least one of the server authorizations EvtDispAdmin | EvtDispUse.

Procedure

dbmevtdisp start [-remoteaccess] <configuration_file> -l <log_file> <database_authentication>

 

-remoteaccess

If you do not specify this option, you can only stop the event dispatcher from the database computer you used to start it.

If you specify this option, you can stop the event dispatcher from any computer.

<configuration_file>

Configuration file for use by event dispatcher

Recommendation

We recommend you create the configuration file on the computer you used to start the event dispatcher.

-l <log_file>

Log file of event dispatcher

Caution

You have to specify a log file.

<database_authentication>

Authentication data used by the event dispatcher to log on to the database instance to be monitored

Syntax:

-d <database_name> (-u <dbm_user_name,dbm_user_password>)|(-U <user_key>) [-n <database_computer>] [-e SSL]

See Database Manager CLI, Logging on to the Database Manager

Result

Event Dispatcher instance <instance_ID> running
using configuration file <configuration_file>

The database system assigns a numerical <instance_ID> to the event dispatcher.  This ID is unique for the database instance monitored by the event dispatcher. You need the ID to stop the event dispatcher.

Example

You start an event dispatcher that uses the configuration file C:\test\testconfig.cfg and the log file C:\test\mylog.log and logs on to the DEMODB database instance with the authentication data of the DBM operator OLEG using the password MONDAY on the database computer PARMA.

dbmevtdisp start C:\test\testconfig.cfg –l C:\test\mylog.log –d DEMODB -u OLEG,MONDAY –n PARMA

See also:

Overview of Event Dispatcher Commands

 

Leaving content frame