Event Definition Database File
Overview
Event definitions are stored in the database file ueme.db.
This page describes the parameters that comprise a record in the event definition file.
Event Definition Parameters
For UEM, an event definition represents a system event.
The parameters in an event definition record:
- Describe a system event.
- Establish the criteria that UEM uses to test for the completion of an event occurrence.
An event definition record also can contain the ID of a record in the event handler database, which dictates how an event or an event occurrence is handled (that is, responded to) when certain conditions are met.
Event Definition Parameters - Categories
Event definition parameters fall into two categories:
- Parameters that are present in all event definition records. The value of one of these general parameters, Event Type, dictates the parameters that fall under the second category.
- Parameters that are specific to an Event Type. Currently, UEM supports a single event type, FILE, which detects the creation of a file.
Event Definition Parameters - General
The following table describes the general event definition parameters.
The parameters that make up the record's key are underlined.
Parameter | Description | Remarks |
|---|---|---|
Event ID | Unique identifier for the event definition. | Length of the handler ID cannot be greater than 32 characters. |
Assigned UEM Component | Name of an event-driven Universal Event Monitor Server component responsible for monitoring the event. | |
Enabled Flag | A true / false value that determines whether an event-driven UEM Server processes the event definition. | If true, the event is checked periodically by its assigned event-driven UEM Server to see if it should be made active or inactive. |
Active Flag | A yes / no value that indicates whether UEM Server is monitoring the event. | If yes, the current date/time is greater than the defined Activation Date/Time, but less than the defined Inactivation Date/Time. |
Event Type | System event represented by the event definition. | Value corresponds to one of the supported event types. |
Activation Date | Date on which UEM will begin checking for the occurrence of the system event represented by the event definition. | Specified using the format YYYY.MM.DD. |
Activation Time | Time on the Activation Date at which UEM will begin checking for the occurrence of the system event represented by the event definition. | Specified using the format HH:MM. |
Inactivation Date | Date on which UEM will stop checking for the occurrence of the system event represented by the event definition. | Specified using the format YYYY.MM.DD. |
Inactivation Time | Time on the Inactivation Date at which UEM will stop checking for the occurrence of the system event represented by the event definition. | Specified using the format HH:MM. |
Tracking Interval | Frequency with which UEM tests for the completion of an occurrence of the system event represented by the event definition. | Value is expressed in seconds. |
Triggered Event Handler ID | ID of an event handler database record whose specified actions should be taken when an event occurrence satisfies its defined completion criteria. | Value is case sensitive. |
Rejected Event Handler ID | ID of an event handler database record whose specified actions should be taken if one or more tracked event occurrences fail to complete before the event is made inactive by UEM. | Value is case sensitive. |
Expired Event Handler ID | ID of an event handler database record whose specified actions should be taken if an event is made inactive with no occurrence of the system event represented by the event definition being detected by UEM. | Value is case sensitive. |
Handler Options | String that contains one or more parameters that UEM adds to the command line it constructs to execute an event handler's specified command or script. | Added to the command line for every process executed for the event handlers referenced by this event definition. This includes those event handlers referenced by the Triggered Event Handler ID, Rejected Event Handler ID, and Expired Event Handler ID fields. |
Last Update Date/Time | Date and time the event definition was created or last modified. | |
Last Update User | ID of the user account that created or most recently updated the event definition. |
Event Definition Parameters - Event Type FILE
The following table describes the parameters that are available in event definitions for an Event Type of FILE.
Parameter | Description | Remarks |
|---|---|---|
File Specification | Complete path of the file to watch. | File specification can contain wildcards:
|
Minimum File Size | Smallest size that a file can be in order to be considered complete. | Value of 0 indicates that a file of any size is acceptable.
If a storage unit is not specified, UEM assumes the file size is given in bytes. |
Rename File | Indicates whether or not UEM Server will rename the file prior to executing the triggered event handler. This will prevent multiple detections of the same file. | Acceptable values are yes or no. |
Rename File Specification | Format used by UEM to rename a file. | Complete file name or a file mask that accepts specific well-known variables that will be substituted by UEM Server at run time. When specified, variables must be in the format $(var).
If no path is specified, the file is simply renamed. Otherwise, the file can be renamed, moved from its original location, and placed in the path specified by this parameter. |