System Monitor Guide and Reference

DROP EVENT MONITOR Command and SQL

Removes an event monitor definition from the Database catalogs. Whenever an object is deleted, its description is deleted from the catalog and any packages that reference the object are invalidated.

Scope

This statement can be embedded in an application program or issued interactively. It is an executable statement that can be dynamically prepared.

Authorization

The authorization ID of the DROP statement when dropping an event monitor must have SYSADM or DBADM authority

Command Syntax

>>-DROP------EVENT--MONITOR--event-monitor-name----------------><
 

Command Parameters

EVENT MONITOR event-monitor-name

Identifies the event monitor that is to be dropped. The event-monitor-name must identify an event monitor that is described in the catalog (SQLSTATE 42704).

If the identified event monitor is ON, an error (SQLSTATE 55034) is raised. Otherwise, the event monitor is deleted.

If there are event files in the target path of the event monitor when the event monitor is dropped, the event files are not deleted.

Sample Programs

An event monitor must be stopped or OFF before it can be deleted. Dropping an event monitor does not erase the target directory.

[ DB2 List of Books | Search the DB2 Books ]