IBM Support

Verifying that there is only one AMC in your ITM environment

Question & Answer


Question

What is the simplest way to determine that there is only one AMC agent in this ITM (IBM Tivoli Monitoring) environment?

Answer


Use the tacmd listSystems command to list all instances of the AMC (Application Management Console) agent in your ITM environment. The AMC agent is identified by the product code T3 and is often referred to as the T3 agent.

The listSystems command searches all of the managed systems connected directly to the hub TEMS and indirectly through remote TEMS servers.

Note: You must not have more than one AMC in a given ITM environment. If you have more than one active AMC in your environment, AMC profiles and profile changes are not distributed to agents, and robotic scripts do not run.

To determine if you have more than one T3 agent in your ITM environment:

  1. Logon to the hub TEMS host.

  2. Use the tacmd login command to log onto the hub TEMS service.

    ITM_HOME\BIN\tacmd login -u sysadmin -p <sysadmin-password> -s <full-hub-tems-server-name>

    You should observe an acknowledgment like the following:

    Validating user...
    KUIC00007I: User sysadmin logged into server on https://<hub-tems-server-name>:<port>.

  3. After you have established a connection to the hub TEMS service, enter the following tacmd listSystems command.

    Windows:
    ITM_HOME\BIN\tacmd listSystems | find ":T3"

    Unix/Linux:
    ITM_HOME/bin/tacmd listSystems | grep \:T3

    TIP: Filter the command output to list the occurrence of T3 agents. Use the find filter under Windows, and use the grep filter under Unix/Linux.

    Note: Be sure to use the filter :T3 (with the colon). The filter T3 (without the colon) lists all of the applications known to the AMC.

    Sample Command and Output

    C:\IBM\ITM\BIN\tacmd listSystems | find ":T3"
    NC9053120203:T3 T3 07.40.01.00 Y

    This example proves that there is only one AMC in this ITM environment.
  • The agent is online (indicated by the "Y" in last column).
  • The agent maintenance level is ITCAM for Transactions 7.4 FP01 without interim fixes.
  • The agent resides on server NC9053120203. Note that this is the short hostname.

Hub TEMS on z/OS


If your hub TEMS resides on z/OS, launch the tacmd login command from a supported distributed platform. Connect to the hub TEMS on z/OS. Then, launch the tacmd listSystems command from the distributed platform to return agent information.

[{"Product":{"code":"SS5MD2","label":"Tivoli Composite Application Manager for Transactions"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ITCAM TRANSACT AMC 5724S79EU v710","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.4","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

ITCAMfT

Document Information

Modified date:
17 June 2018

UID

swg21586074