Names of the items to delete.Names of the items to delete.The -f option with the name of a file that contains the names of the items you want to delete. In this file, specify each name on a separate line.Neither of the above. In this case, the engine_delete tool reads names from stdin until you type an end-of-file signal, (CTRL+D on UNIX and CTRL+Z on Windows). If you want, you can specify a hyphen (-) in the command line to indicate that input will come from stdin.When you delete a monitor, the correlator tries to terminate all of that monitor's instances. If they are responsive (not in some deadlocked state), each one executes its ondie() action, and when the last one exits the correlator calls the monitor's onunload() action. This assumes that the monitor you are deleting defines ondie() and onunload() actions.When you kill a monitor, the correlator immediately terminates all of the monitor's instances, without invoking ondie() or onunload() actions.Option | Description |
-h | --help | Displays usage information. Optional. |
-n host | --hostname host | Name of the host on which the event correlator is running. The default is localhost. Optional. Non-ASCII characters are not allowed in host names. |
-p port | --port port | Port on which the event correlator is listening. Optional. The default is 15903. |
-f filename | --file filename | Indicates that you want the engine_delete tool to read names of items to delete from the specified file. In this file, each line contains one name. Optional. The default is that input comes from stdin. |
-F | --force | Forces deletion of named event types even if they are still in use. That is, they are referenced by active monitors or applications. A forced delete also removes all objects that refer to the event type you are deleting. For example, if monitor A has listeners for B events and C events and you forcibly delete C events, the operation deletes monitor A, which of course means that the listener for B events is deleted. Optional. The default is that event types that are in use are not deleted. |
-k | --kill | Kills all instances of the named monitor regardless of whether an instance is in use. For example, you can specify this option to remove a monitor that is stuck in an infinite loop. Any ondie() and onunload() actions defined in killed monitors are not executed. |
-a | --all | Forces deletion of all applications, monitors, and event types. The correlator finishes processing any events on input queues and then does the deletions. Any events sent after invoking engine_delete -a are not recognized. Specifying this option does not stop a monitor that is in an infinite loop. You must explicitly kill such monitors. Specifying the -a option is equivalent to specifying the -F option and naming every object in the correlator. If you want to kill every object in the correlator, shut down and restart the correlator. See Shutting down and managing components. |
-y | --yes | Removes the "are you sure?" prompt when using the -a option. |
-v | --verbose | Requests verbose output. |
-u | --utf8 | Indicates that input files are in UTF-8 encoding. This specifies that the engine_delete tool should not convert the input to any other encoding. |
-V | --version | Displays version information for the engine_delete tool. |
Operand | Description |
[ name1 [ name2 ... ] ] | The names of zero or more EPL or JMon applications, monitors and/or event types to delete from the event correlator. If you do not specify at least one item name, and you do not specify the -f option, the engine_delete tool expects input from stdin. |
Value | Description |
0 | The items were deleted from the event correlator successfully. |
1 | No connection to the event correlator was possible or the connection failed. |
2 | Other error(s) occurred while deleting the named items. |
