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.

CMDBGetCopyAuditData function

If the attribute data for the instance is modified, the CMDBGetCopyAuditData function retrieves a copy of the specified CI instance. The Audit Option must be set for the attribute's characteristic to get the audit data.


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

int CMDBGetCopyAuditData(
      ARControlStruct *control,
      CMDBClassNameId *classNameId,
      ARNameType instanceId,
      ARTimestamp auditTimestamp,
      CMDBQualifierStruct *qualifier,
      ARNameList *attributeGetList,
      CMDBSortList *sortList,
      unsigned int firstRetrieve,
      unsigned int maxRetrieve,
      CMDBAuditValueListList *auditValueListList,
      unsigned int *numMatches,
      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.


The class name of the CI instance for which to retrieve the audit data. The classNameID argument contains the namespace name and the unique class name.


The instance ID of the specified CI instance for which a copy of the audit data is to be retrieved.


The date and time information for the instance. The CI instances with the date and time greater than or equal to the auditTimestamp value are retrieved. If auditTimestamp is 0, all the audit data is retrieved.


A query that determines the set of CI instances to retrieve. The qualification can include one or more attributes and any combination of conditional, relational, and arithmetic (numeric data types only) operations. For more information about how to construct a qualifier, see "Building qualifications and expressions," in the BMC Remedy Action Request System Workflow Objects Guide.


A list of attribute names for which the audit data is to be retrieved.


A list of zero or more fields that identifies the sort order for the attributes. Specify a NULL value for this parameter to use no specific sort order.


The first instance to retrieve for the qualification. If you do not specify a value for this parameter, the default value of CMDB_START_WITH_FIRST_ENTRY is used and the function retrieves the first entry.


The maximum number of entries to retrieve for the qualification. Use this parameter to limit the amount of data returned if qualifier does not narrow the list. Specify CMDB_NO_MAX_LIST_RETRIEVE to assign no maximum.

Return values

Return value



The list of values for the specified attributes. If the audit option at the CI class-level is disabled, an error is returned.


The number of CI instance entries that matched the specified qualification.


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