This documentation applies to the 8.1 version of Remedy IT Service Management Suite, which is in "End of Version Support." You will not be able to leave comments.

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

Rebuilding customizations before deleting BMC Remedy ITSM attributes from the BMC Atrium CMDB

You must rebuild your customizations before you can delete all of the BMC Remedy ITSM attributes from the BMC Atrium CMDB, while performing an upgrade. This topic provides information about the customizations that are affected by the upgrade, and instructions for rebuilding them.

Integrations or customizations that are affected

Integrations that are using the BMC Atrium CMDB class forms (for example, BMC:CORE:ComputerSystem) that need to pull, update, or create data into the attributes owned by BMC Remedy ITSM must be modified to query that data in the BMC Remedy ITSM form or join form. The types of integration mechanisms that might be affected include:

  • BMC Atrium CMDB API
  • BMC Remedy AR System workflow
  • BMC custom join forms
  • AIE Mappings
  • Distributed Server Option (DSO) mappings
  • ARODBC communication directly to the database


Update the customization after the BMC Remedy IT Service Management Suite structural upgrade, but before the BMC Remedy IT Service Management Suite attribute deletion. To detect workflow and join forms see Finding whether and where fields are used in the system.

To rebuild your self join form customizations using the CI Data Migration utility

The CI Data Migration utility rebuilds the join form structure of all custom self join forms in the BMC Atrium CMDB by replacing the secondary form of the join forms with the AST:Attributes form. All former BMC Remedy ITSM attributes on the custom self join forms are updated so that these fields point to the AST:Attributes form.


You must first repair all of the invalid field mappings on the custom self join forms before running the utility. For more information, see Invalid field mappings in join forms.

  1. Create a text file with any file name, that contains a list of custom self join forms that must be rebuilt. The name of each join form should be on a separate line.
  2. Copy the text file to the %TEMP% directory of the computer on which you want to run the utility.
  3. Follow the instructions provided in Using the CI Data Migration scan functions to execute the cimig.jarapplication.


    For the exposeForPreChecking command line parameter, you must specify a value of 4, which indicates that you want to fix the custom self join form structure.

  4. When prompted to, enter the name of the text file that you created in step 1.

The utility first checks for invalid field mappings before starting to rebuild the join form structure.


Custom self join forms refers to forms that were created earlier, using the Sync Asset UI with CMDB configuration option in BMC Asset Management with custom CMDB forms.

Related topics

Completing the planning spreadsheet

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.