The dxcmd menu is 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.
NOTE:The Association actions in dxcmd utility are hidden by default. You must invoke this utility by using the -u option to see the Association actions.
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.
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. It also converts the existing object associations for this driver to use the DirXMLAssociationsLite attribute (new no-ref association).
2: Migrate to ref association
This action modifies the driver and sets the value of DirXML-UseNoRefAssoc to False. It also converts the existing object associations for this driver to use the DirXMLAssociations attribute (legacy association).
3: Get no-ref associated entries
Applicable only if using no-reference association for the driver. This action lists the object’s associations.
4: Delete no-ref associated entries
Applicable only if using no-reference association for the driver. This action deletes the object’s associations.
5: Rename no-ref association
Applicable only if using no-reference association for the driver. This action renames the object’s associations. As the DN is stored as a string, renaming the driver or renaming, or moving the object (if using DN as association value) may break the association. You can use the rename action to correct this behavior.
99: Exit
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. It also converts the existing object associations for this driver to use the DirXMLAssociationsLite attribute (new no-ref association).
2: Migrate to ref association
This action modifies the driver and sets the value of DirXML-UseNoRefAssoc to False. It also converts the existing object associations for this driver to use the DirXMLAssociations attribute (legacy association).
3: Get to no-ref associated entries
Applicable only if using no-reference association for the driver. This action lists the object’s associations.
4: Delete no-ref associated entries
Applicable only if using no-reference association for the driver. This action deletes the object’s associations.
99: Exit