Changing the default value for short-term history

This topic explains how to retrieve more than 24 hours of data from short-term history in the Tivoli Enterprise Portal.

By default, in the Tivoli Enterprise Portal, historical data from the previous 24 hours is retrieved from the persistent data store, and historical data from earlier time periods is retrieved from Tivoli Data Warehouse. With PDS V2, depending on your configuration, OMEGAMON can keep more than 24 hours of history that you can display as short-term history in the Tivoli Enterprise Portal.

To retrieve more than 24 hours from short-term history in the Tivoli Enterprise Portal, you can modify the value of the Tivoli Enterprise Portal Server environment variable KFW_REPORT_TERM_BREAK_POINT. The value of this variable is specified in seconds. The default value is 86400 (the number of seconds in a 24-hour period). For example, to retrieve seven days of data from the persistent data store, use the following setting:

KFW_REPORT_TERM_BREAK_POINT=604800

This change needs to be made in the Tivoli Enterprise Portal Server cq.config and cq.ini files.

Important: To avoid excessive response times and exceeding limits on the numbers of rows returned, it is recommended that you follow these guidelines when using the time span feature in the Tivoli Enterprise Portal:
  • Request a time range that is specific and small (for example a two-hour period), even when querying data older than 24 hours.
  • Avoid requesting a large time frame of data to be returned on the Tivoli Enterprise Portal workspace.