Web Services Methods › List/Query Methods › doQuery

doQuery

The following parameters apply to the doQuery method:

Description

Performs an SQL-like select for the specified object type. It also returns a list handle that points to a list of the rows returned from the query, where each row represents a CA SDM object that matched the supplied where clause. The caller can fetch values for the list rows using getListValues ().

Note: For more information about where clauses, see Where Clauses.

Important! The object list is stored on the CA SDM server and consumes system resources. The caller is responsible for freeing the list with freeListHandles(). Leaving a list in memory may increase memory for the process beyond the 2GB limit, resulting in memory leaks and can cause system failure.

Lists created with this function are homogenous, meaning the objects are all the same type, and they are static, meaning the list never changes even if a data change to an object excludes it from the initial where clause.

Returns

A list handle that must be freed with freeListHandle().