IBM Support

Universal Agents and historical graph legends.

Technical Blog Post


Abstract

Universal Agents and historical graph legends.

Body

image

Universal Agents and historical graph legends.

Universal agents are a bit long in the tooth now, and Agent builder is the way to go, but I bet there is still a number of you out there with UA agents running.

Came across this the other day, a multiple point line graph after it was running for a number of hours; the colours and sometimes the legends of a graph switch.

so say graph was
lineA  - red
lineb - green
linec - blue


suddenly lineA would be green and the legend would read lineb - but it was lineA data

Here is an example of a change:

image

After being left to run for a number of hours the graph then showed;

image



After a number of issues where looked at checking that the data in warehouse was correct etc, a little known APAR IV06637 was found that states;

"The way the tep client handles legend labels for a UA agent is different than standard agents.

The UA meta file which defines the UA application attributes must use the following parameter in the attribute definition.

 OPTION{PRIMARYKEY=0}


The above keyword added to the attribute definition in the UA's MDL file will generate the following keyword in the ODI file
generated by the UA application.

*OPTION:   PRIMARYKEY=0


The ODi *OPTION PRIMARYKEY=0 definition will allow the TEP client to properly keep track of legend labels for UA and specifically when there is a filter being used on the attribute in the filters page of the TEP workspace properties dialog."

Once the UA was reconfigured to use this parameter  OPTION{PRIMARYKEY=0}

the legend labels were consistent all the time.

It should be noted that there have been other issues in this area but they were solved in 6.22 FP09 or 6.23 FP05

This issue was in an environment at one of these levels and similar graphs from other agents (for example the MQ agents) were displaying correctly.

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"","label":""},"Component":"","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSTFXA","label":"Tivoli Monitoring"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

UID

ibm11084215