MONITOR_EVENT_EXPIRATION - UEC configuration option

Description

The MONITOR_EVENT_EXPIRATION option specifies the length of time that state data is retained in the UEC database.

State data refers to data collected and generated by UEC that is used to represent the work and working state of Universal Agent at a point in time. Collected data includes monitor-routed UES events and Universal Agent component state data.

Each state data record is associated with a particular Universal Agent workflow. While the workflow is active, some component of the workflow is generating state data. State data is aged and expired at the workflow level.

All records associated with a workflow are considered to be as old as the last update performed for the workflow. Therefore, when a clean-up cycle occurs, and no state data activity has occurred on a workflow for at least the length of time specified by MONITOR_EVENT_EXPIRATION, all records associated with the workflow are removed from the database.

State data clean-up cycles occur once every hour. Therefore, the minimum length of time that state data is retained is one hour.

Usage

Method

Syntax

IBM i

HP NonStop

UNIX

Windows

z/OS

Command Line, Short Form

n/a

Command Line, Long Form

n/a

Configuration File Keyword

monitor_event_expiration time

(tick)

(tick)

Values

time is the length of time that event records are retained before being deleted.

Valid values for time are a number followed by (optionally) one of the following suffixes:

  • s (seconds)
  • m (minutes)
  • h (hours)
  • d (days)

If a suffix is not specified, the number is assumed to indicate seconds.

(For example, if 3d is specified, the records are retained for three days before UEC deletes them.)

Default is 24h.