Running an ITM DLA Template

Use the Discovery Library Adapter (DLA) program for scanning your monitored environment to identify the managed systems.

Using the Tivoli Management Services Discovery Library Adapter

Use the Discovery Library Adapter (DLA) program for scanning your monitored environment to identify the managed systems. You can then feed this information (an XML output file) into the Tivoli Application Dependency Discovery Manager’s (TADDM) Change and Configuration Management Database (CCMDB). The DLA identifies all distributed and z/OS managed systems registered to the Tivoli Management Services.

Before you begin

When the tmsdla script is launched, the DLA gathers information by querying the hub Tivoli Enterprise Monitoring Server for all managed systems and mapping them to Common Data Model resources based on the agent product code and managed system name format. The queries specified in the XML input file provided by each product are run and the results saved to a single output file. For example, “IMN1:SYS1:IMS” is the managed system name for an OMEGAMON XE for IMS™ agent. The DLA discovers the following information:

• A z/OS computer named “IMN1”
• An IMS subsystem named “SYS1”
• A relationship between the SYS1 z/OS computer and IMN1 IMS

For agents that use IP, IP.PIPE, or IP.SPIPE, the DLA can discover the IP address where the agent is running. As well, the DLA discovers the operating system for the computer where the agent is running, regardless of whether an OS monitoring agent is running on that computer. The monitoring servers and the Tivoli Enterprise Portal Server must be running for these queries. Also, any managed systems that are not online will be ignored.

Procedure

Run the following DLA script from the command line on the computer where the portal server is installed:

• To make a create-type IDML book, enter the following command:

Install_dir\CNPS\tmsdla.bat

• Alternatively, to make a refresh-type IDML book, enter the following command. After you import into TADDM, any systems that are offline (such as for maintenance operations) are removed from TADDM. The same is true for Tivoli Business Service Manager (TBSM).

Install_dir\CNPS\tmsdla.bat -r

• To make a create-type IDML book, enter the following command:

Install_dir/bin/itmcmd execute cq "tmsdla.sh"

• Alternatively, to make a refresh-type IDML book, enter the following command. After you import into TADDM, any systems that are offline (such as for maintenance operations) are removed from TADDM. The same is true for TBSM.

Install_dir/bin/itmcmd execute cq "tmsdla.sh -r"

Results

The DLA generates the XML output file to the same directory on the portal server. The name of this file follows the standard Discovery Library file name format. To use this information in the CCMDB, you must transfer the XML file to the Discovery Library File Store and then use the Discovery Library Bulk Loader.

References: http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/index.jsp?topic=/com.ibm.itm.doc_6.2.2fp2/discoverylibraryadapter_tms.htm