Universal Agent timing problem

Flash (Alert)


Abstract

CLARIFICATION OF SUMMARY AND FORCE IN THE UNIVERSAL AGENT USERS GUIDE 6.23



The use of the FORCE can impact the Universal Agents defined interval.



The existing Universal Agent Users Guide did not account for the possibility that the Force option could suppress the Summary feature's default behavior.



Content

This has been identified as a documentation defect under APAR IV39373


Description:
The existing Universal Agent Users Guide did not account for the
possibility that the Force option could suppress the Summary
feature's default behavior.

The following documentation changes are recommended to clarify
this behavior.

******************************************************
Here is the BEFORE/AFTER text to be used for Doc APAR.

UA User Guide 6.23 - on page 169

BEFORE changes:
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
SUMMARY statement

Description

The //SUMMARY statement defines the requirements for gathering
the frequency of data input during monitoring. At a minimum, the
requirements include a defined interval and if appropriate, defined sort keys.

The resulting output for a summary attribute group consists of any sort key attributes that have been defined along with six reserved
summary attributes:
_LocalTimeStamp, _Date_Time, _Interval_Unit,
_Interval, _Interval_Unit_Name, and _Occurrences.

Other attributes defined in the summary attribute group without the sort key designation are not part of the output workspace.
. . .
~ ~ ~ ~ ~ ~ ~ ~ ~ ~


AFTER changes:
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
SUMMARY statement

Description

The //SUMMARY statement defines the requirements for gathering
the frequency of data input during monitoring. At a minimum, the
requirements include a defined interval and if appropriate, defined sort keys.

Summary feature's default behavior is: if no new input data is
collected during a summary interval, a row is not added to the summary attribute group for that interval. This default behavior is due to Summary feature being data driven rather than interval driven.

The resulting output for a summary attribute group consists of
any sort key attributes that have been defined along with six reserved summary attributes:
_LocalTimeStamp, _Date_Time, _Interval_Unit, _Interval,
_Interval_Unit_Name, and _Occurrences.

Other attributes defined in the summary attribute group without the sort key designation are not part of the output workspace.
. . .
~ ~ ~ ~ ~ ~ ~ ~ ~ ~


UA User Guide 6.23 - on very end of page 169, over to page 170

BEFORE changes:
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
Force (optional) Enables you to always see a summary row at
every interval, regardless of whether new data was collected during
that interval. The interval value specified in the //SUMMARY
statement is used to determine when to output a new data row to the summary attribute group. However, if no new input data is collected during a summary interval, a row is not added to the
summary attribute group for that interval. The default behavior of
the Summary feature is that it is data driven rather than interval driven. The following is an example of using the Force parameter:
. . .
~ ~ ~ ~ ~ ~ ~ ~ ~ ~


AFTER changes:
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
Force (optional) Enables you to always see a summary row at
every interval, regardless of whether new data was collected during
that interval; the Force option suppresses the Summary feature's default behavior.

The interval value specified in the //SUMMARY statement is used
to determine when to output a new data row to the summary attribute group.

Typically, there will be a variance (up to +/- 30 seconds of
the declared Summary interval) in actual time lapse between
Summary data rows, due to processing load on Universal Agent and/or the host machine.

For example, given a Summary interval of 600 seconds (10 minutes) and the first Summary data row being created at 10:00:00, the second Summary data row may be generated at 10:09:34, third row at 10:18:45 and nth data row is at 10:58:09. At this point, in order to synchronize the interval back to top of the hour, 11:00:00 in this case, the Universal Agent generates next Summary data row at 11:00:00.

This adjustment is to compensate for any variance that may have
occurred in last hour's actual time lapses between Summary data
rows. The adjustment is only made if the declared Summary interval is greater than 60 seconds and less than or equal to 3600 seconds.

The following is an example of using the Force parameter:
. . .

Product Alias/Synonym

UA
UM
Universal Agent

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Monitoring

Software version:

6.2.1, 6.2.2

Operating system(s):

AIX, Linux, Windows

Reference #:

1633597

Modified date:

2013-04-17

Translate my page

Machine Translation

Content navigation