This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

CMDBQueryByPath function

The CMDBQueryByPath function retrieves a list of instances for the specified qualifications. To improve the performance of the queries, add indexes on attributes that are frequently used in the qualification.


#include "ar.h"
#include "arextern.h"
#include "cmdb.h"

int CMDBQueryByPath(
      ARControlStruct *control,
      CMDBQueryStruct *query,
      CMDBQueryResult *result,
      ARStatusList *status)

Input arguments

Input argument



The control record for the operation, which contains information about the user requesting the operation and the server on which the operation is to be performed.


A query that determines the list of instances to return. The qualification can include one or more subqueries and any combination of conditional, relational, and arithmetic operations.

Return values

Return value



The list of instances returned for the specified qualifications.


A list of zero or more notes, warnings, or errors generated from a call of this function.

Was this page helpful? Yes No Submitting... Thank you