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.

CMDBImportData function

The CMDBImportData function imports the specified instance data.


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

int CMDBImportData(
      ARControlStruct *control,
      unsigned int importOption,
      char *importBuf,
      CMDBImportDataSummaryStruct *impSummary,
      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 value that indicates how to manage duplicates found during the importing of instance data. These options are mutually exclusive.

  • 1: Error--Generate an error ( CMDB_DATA_IMPORT_OPT_ERROR_FOR_DUP ).
  • 2: New ID for duplicates--Create an instance with a new instance ID if the instance ID already exists ( CMDB_DATA_IMPORT_OPT_NEWID_FOR_DUP ).
  • 3: Merge--Update the existing instance if the instance ID specified already exists ( CMDB_DATA_IMPORT_OPT_MERGE_FOR_DUP ).
  • 4: New ID for all--Create a new instance ID for all the imported instances, including those instances that are not duplicates ( CMDB_DATA_IMPORT_OPT_NEWID_FOR_ALL ).


The import buffer, which contains the class data in XML format to import.

Return value

Return value



The CMDBImportDataSummaryStruct structure, which contains the summary of the data import, such as total number of items that were set to be imported, total number of items that were imported successfully, and the total number of items for which the import failed.


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