7.3 Migration Between Associations

Dxcmd has been updated to provide new actions to enable easier and seamless migration of association from one format to the other. Additionally, maintenance actions are available to handle the associations.

The association actions are available at two levels in the dxcmd menu. The association actions are available in the main dxcmd menu and also in the driver menu. You need to shut down the driver before performing these actions.

7.3.1 Association actions in the main menu

You can select an association operation from the following list:

  • 1: Migrate to no-ref association.

    This action modifies the driver and sets the value of DirXML-UseNoRefAssoc to True. Additionally, it also converts the existing object associations for this driver to use the DirXML-AssociationsLite attribute (new no-ref association).

  • 2: Migrate to ref association.

    This action modifies the driver and sets the value of DirXML-UseNoRefAssoc to False. Additionally, it also converts the existing object associations for this driver to use the DirXML-Associations attribute (legacy association).

  • 3: Get to no-ref associated entries.

    Only applicable if using no-reference association for the driver. This action lists the objects associations.

  • 4: Delete no-ref associated entries.

    Only applicable if using no-reference association for the driver. This action deletes the objects associations.

  • 5: Rename no-ref association.

    Only applicable if using no-reference association for the driver. This action renames the objects associations. As the dn is stored as string, any renames to the driver or rename/move of the object (if using dn as association value) may break the association. The rename action can be used to correct this behavior.

  • 99: Exit.

7.3.2 Association actions in the driver menu

You can select an association operation from the following list:

  • 1: Migrate to no-ref association.

    This action modifies the driver and sets the value of DirXML-UseNoRefAssoc to True. Additionally, it also converts the existing object associations for this driver to use the DirXML-AssociationsLite attribute (new no-ref association).

  • 2: Migrate to ref association.

    This action modifies the driver and sets the value of DirXML-UseNoRefAssoc to False. Additionally, it also converts the existing object associations for this driver to use the DirXML-Associations attribute (legacy association).

  • 3: Get to no-ref associated entries.

    Only applicable if using no-reference association for the driver. This action lists the objects associations.

  • 4: Delete no-ref associated entries.

    Only applicable if using no-reference association for the driver. This action deletes the objects associations.

  • 99: Exit.