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.

See the "Query Example".

Input

Parameter	Comment
cmdbContext	For details, see CmdbContext and the schema documentation for CmdbContext.
queryXML	An XML string representing a TQL without resource tags.
parameterizedNodeList	The conditions each node must meet to be included in the query results. For details, see ParameterizedNodes.

Output

Parameter	Comment
topologyMap	For details, see TopologyMap and the schema documentation for TopologyMap.
chunkInfo	For details, see ChunkInfo and Processing Large Responses, and the schema documentation for ChunkInfo.