IBM Support

IBM Tivoli Monitoring Agent for i5/OS job may not end normally

Troubleshooting


Problem

The Tivoli Monitoring Agent for i5/OS job may not end normally when RAS1 trace is enabled.

Symptom

When RAS1 logging is enabled, the Tivoli Monitoring Agent for i5/OS (referred to as the Agent hear after) may not end gracefully when it is stopped. When this condition happens, the Agent job CT_AGENT ends abnormally after 10 minutes with the automatic execution of ENDJOBABN system command by the i5/OS or IBM i system. In some cases, it is required to execute ENDJOBABN system command to manually end the CT_AGENT job after waiting for 10 minutes.

Cause

This can happen with the basic trace setting of KBB_RAS1=ERROR. The problem is more severe if extended trace similar to KBB_RAS1=ERROR (UNIT:KA4 ALL) (UNIT:KRA ALL) enabled and data collection for many attributes is enabled. The data collection can be because of the situations and historical data collection that has been configured and distributed to the agent.

Diagnosing The Problem

1. Update the trace parameter KBB_RAS1 to KBB_RAS1=NONE in QAUTOTMP/KMSPARM (KBBENV) file. Comment any other KBB_RAS1 lines by adding * at the beginning of the line.
2. Stop and start the Agent.
3. End the Agent using option 3 of GO OMA menu. QAUTOMON/ENDOMA command can also be used to end the Agent.
4. Verify if the Agent job ended normally or abnormally.
5. If the Agent ended normally, the problem documented in this technote is applicable.

Resolving The Problem

This is a known issue with permanent restrictions in the current Tivoli Enterprise Monitoring Agent(TEMA) code. This is documented using the Doc APAR IV15081(TEBS: UNIT AND FILTER LIMITS TO RAS1 TRACE).

The APAR documentation http://www-01.ibm.com/support/docview.wss?uid=swg1IV15081 provides more details on this issue. Two work arounds documented in this APAR.

Related Information

[{"Product":{"code":"SSTFXA","label":"Tivoli Monitoring"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ITM Agent iSeries V6","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"6.1;6.1.2;6.2;6.2.1;6.2.2;6.2.2.2;6.2.2.3;6.2.2.4;6.2.2.5;6.2.2.6;6.2.2.7;6.2.3;6.2.3.1","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21592593