cleanup_orphan_arrangements

cleanup_orphan_arrangements is a tool to find and destroy orphan arrangements. Arrangements in Teamcenter are typically managed and published by NX. Arrangements are published to Teamcenter by creating a GRM relationship with the assembly BVR (BOM view revision) and creating referential relationships from higher level assemblies to lower level assembly arrangements. An arrangement is configured by the arrangement selection at the parent level and then at the next level, all the way to the top of the assembly. Note Only privileged users may run this utility. Recommended steps for using this utility: Run the utility in report mode only. Check the report to see if the BVR has more than one arrangement. Back up the database. Run the utility in destroy mode for one UID or selected UIDs. Run the utility for the entire database. Syntax cleanup_orphan_arrangements -u=user-ID {-p=password | -pf=password-file} [-g=group] [-report] [-searchForArrs][-searchForQuals][-destroyAll][-destroySelected] [-output=output_file] [-inputUIDs=input_uids_file] [-arr=input_uid] [-h] Arguments -u Specifies the user ID. The user must have administrative privileges. Note If your Teamcenter server uses Security Services single sign-on, see Before you begin for additional information. -p or -pf Specifies the user's password or a password file. These arguments are mutually exclusive. For more information about managing password files, see Manage password files. -g Specifies the group associated with the user. -report Searches the entire database to find orphan arrangements and puts the results in the –output file. -searchForArrs Search for orphan arrangements. -searchForQuals Search for qualifiers that point to arrangements from other BVRs. -destroyAll Destroy all orphan arrangements. -destroySelected Destroy selected arrangements provided using one UID (-arr) or a file (-inputUIDs) containing UIDs. -output Contains information about bad arrangements or arrangement qualifiers in report mode. If not specified, the utility uses the default cleanup_orphan_arrangements.txt file. In destroy modes, the report indicates whether the destroy action is successful. The following information is dumped in the output file: Arrangement name. UID of arrangement. Last saved date of arrangement. Arrangement’s BVR name. -inputUIDs The file containing all UIDs of the arrangements to destroy. Each line of the text file contains one arrangement UID. -arr The arrangement UID to destroy. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples Discover phase cleanup_orphan_arrangements -report -output=output.txt –searchForQuals Output: Copy === Begin to look for Qualifiers that point to arrangement from wrong BVR ===

Performing query on DB to find Qualifiers that point to arrangements from wrong BVR

End of Performing Query Found 24 bad qualifiers

UID of arrangement SDStrF8KLQIfvB , Qualifier is not destroyed COWtrRRSLQIfvB , Qualifier is not destroyed CiTtLrkcLQIfvB , Qualifier is not destroyed QqRt7eFgLQIfvB , Qualifier is not destroyed QqftrF8KLQIfvB , Qualifier is not destroyed QuStrF8KLQIfvB , Qualifier is not destroyed S9ctLrkcLQIfvB , Qualifier is not destroyed SlbtrF8KLQIfvB , Qualifier is not destroyed S6atrF8KLQIfvB , Qualifier is not destroyed wCbtrF8KLQIfvB , Qualifier is not destroyed g2Wt7eFgLQIfvB , Qualifier is not destroyed iYftrRRSLQIfvB , Qualifier is not destroyed iXdtrRRSLQIfvB , Qualifier is not destroyed ieVtrRRSLQIfvB , Qualifier is not destroyed ihetrF8KLQIfvB , Qualifier is not destroyed weat7eFgLQIfvB , Qualifier is not destroyed AHet7eFgLQIfvB , Qualifier is not destroyed yiYtrF8KLQIfvB , Qualifier is not destroyed ysdt57wlLQIfvB , Qualifier is not destroyed y0atL1SSLQIfvB , Qualifier is not destroyed y3dtrRRSLQIfvB , Qualifier is not destroyed y_QtrRRSLQIfvB , Qualifier is not destroyed zIatrRRSLQIfvB , Qualifier is not destroyed zZatrRRSLQIfvB , Qualifier is not destroyed Fix Phase cleanup_orphan_arrangements -output=ouput.txt -destroySelected -inputUIDs=bad_quals.txt –searchForQuals The input file bad_quals.txt is used to collect a list of arrangements to destroy: Copy === Begin to look for Qualifiers that point to arrangement from wrong BVR ===

Performing query on DB to find Qualifiers that point to arrangements
from wrong BVR

End of Performing Query Found 24 bad qualifiers

UID of arrangement SDStrF8KLQIfvB , Qualifier is destroyed successfully COWtrRRSLQIfvB , Qualifier is destroyed successfully CiTtLrkcLQIfvB , Qualifier is destroyed successfully QqRt7eFgLQIfvB , Qualifier is destroyed successfully QqftrF8KLQIfvB , Qualifier is destroyed successfully QuStrF8KLQIfvB , Qualifier is destroyed successfully S9ctLrkcLQIfvB , Qualifier is destroyed successfully SlbtrF8KLQIfvB , Qualifier is destroyed successfully S6atrF8KLQIfvB , Qualifier is destroyed successfully wCbtrF8KLQIfvB , Qualifier is destroyed successfully g2Wt7eFgLQIfvB , Qualifier is destroyed successfully iYftrRRSLQIfvB , Qualifier is destroyed successfully iXdtrRRSLQIfvB , Qualifier is destroyed successfully ieVtrRRSLQIfvB , Qualifier is destroyed successfully ihetrF8KLQIfvB , Qualifier is destroyed successfully weat7eFgLQIfvB , Qualifier is destroyed successfully AHet7eFgLQIfvB , Qualifier is destroyed successfully yiYtrF8KLQIfvB , Qualifier is destroyed successfully ysdt57wlLQIfvB , Qualifier is destroyed successfully y0atL1SSLQIfvB , Qualifier is destroyed successfully y3dtrRRSLQIfvB , Qualifier is destroyed successfully y_QtrRRSLQIfvB , Qualifier is destroyed successfully zIatrRRSLQIfvB , Qualifier is destroyed successfully zZatrRRSLQIfvB , Qualifier is destroyed successfully

=== End of search and cleanup for Orphan Arrangements === Related Topics Structure Management on Rich Client ─ Usage