Web Service API - executeTopologyQueryWithParameters

The executeTopologyQueryWithParameters method retrieves a topologyMap element that matches the parameterized query.

The query is passed in the queryXML argument. The values for the query parameters are passed in the parameterizedNodeList argument. The TQL must have unique labels defined for each CINode and each relationNode.

The executeTopologyQueryWithParameters method is used to pass ad hoc queries, rather than accessing a query defined in the CMDB. You can use this method when you do not have access to the UCMDB user interface to define a query, or when you do not want to save the query to the database.

To use an exported TQL as the input of this method, do the following:

1. Launch the Web browser and enter the following address:
   http://localhost:8443/jmx-console.

You may have to log in with a user name and password.

2. Click UCMDB:service=TQL Services.

3. Locate the exportTql operation.

   • In the customerId parameter box, enter 1 (the default).

   • In the patternName parameter box, enter a valid TQL name.

4. Click Invoke.