briefcase_ownership_recovery

Recovers ownership of objects transferred to another site associated with a briefcase or when transferred in other transactions. Object ownership is returned to the original (exporting) site and objects on the remote (importing) site are reverted to being replicas. Ownership can be recovered in cases where ownership was previously transferred using a release of Teamcenter that includes the briefcase_ownership_recovery utility. Caution To ensure data integrity, run this utility at both the exporting site and the importing site. The utility generates an output file listing details of all objects for which ownership is recovered successfully. Syntax briefcase_ownership_recovery -u=user-ID {-p=password | -pf=password-file} -g=group [-briefcase=file | -transactionid=transaction_id | -siteid=site_id] [-mode= import | export] [-startdate=start_date] [-enddate=end_date] [-report] [-outputDir=dir_path] [-delete] [-h] Arguments -u Specifies the user ID. If this argument is used without a value, the operating system user name is used. If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments are authenticated externally through SSO rather than being authenticated against the Teamcenter database. If you do not supply these arguments, the utility attempts to join an existing SSO session. If no session is found, you are prompted to enter a user ID and password. -p Specifies the user password. If used without a value, the system assumes a null value. If this argument is not used, the system assumes the user-ID value to be the password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. If used without a value, the system assumes a null value. If this argument is not used, the system assumes the user-ID value to be the password. For more information about managing password files, see Manage password files. This argument is mutually exclusive with the -p argument. -g Specifies the group associated with the user. If used without a value, the user’s default group is assumed. -briefcase Specifies the briefcase or TC XML file for which you want to recover ownership. Ownership of all associated objects with transferred ownership are recovered. Specify one briefcase or TC XML. Do not use -briefcase if either -transactionid or -siteid is specified. If -transactionid, -briefcase, or -siteid are not specified, -briefcase is used. -transactionid Specifies the ID of the transaction for which you want to recover ownership. Ownership of all associated objects with transferred ownership will be recovered. Specify one transaction id. Do not use -transactionid if either -briefcase or -siteid is specified. Locate the transaction ID in the transaction export log or in the header section of the TC XML in the briefcase. -siteid Use -siteid to review and select a briefcase from all briefcases exported or imported for a particular site. -siteid specifies the ID of the site for which all briefcases exported and imported by the current user are listed. If the current user is a member of the dba group, briefcases exported or imported by all users are listed. Results are listed by date Each briefcase in the list is preceded by an index number. When prompted, enter the index number of a briefcase to recover the ownerships transferred with that briefcase. Use -siteid with -mode, -startdate, and -enddate to filter the list of briefcases. Do not use -siteid if either -briefcase or -transactionid is specified. -mode Use with -siteid to limit the list of briefcases to only those exported or imported. Allowed values are export or import. -startdate Specifies the earliest date and time a transaction must have occurred to be included in the list generated with the -siteid option. The format of the date is “DD-MMM-YYYY HH:MM:SS”. Double quote marks are required. For example, "21-Jun-2019 22:15:00". -enddate Specifies the latest date and time a transaction must have occurred to be included in the list generated with the -siteid option. The format of the date is “DD-MMM-YYYY HH:MM:SS”. Double quote marks are required. For example, "22-Jun-2019 22:15:00". -report Displays a list of the objects for which ownership will change if you run the current command. For each object, the list includes its unique ID, type, owning site ID, and whether it is a principle object. When -report is specified, ownership changes do not occur. -outputDir Specifies the file path where the report file is stored. If -outputDir is not specified, the report file is stored in the directory where you ran the utility. -delete Deletes the ownership recovery record from the database for the specified transaction. Once deleted, briefcase_ownership_recovery cannot recover ownership for the specified transaction. -h Displays the help for this utility. Environment As specified in Manually configure the Teamcenter environment. Files As specified in Log files produced by Teamcenter. Restrictions briefcase_ownership_recovery recovers ownership transfers only for briefcases created using a release of Teamcenter that includes the briefcase_ownership_recovery utility. Examples Recover ownership of objects in a specific briefcase. Copy briefcase_ownership_recovery -u=username -p=password -g=dba -briefcase=BCZ_test1__IMC-10001_27-Jun-2019-12_10_42.bcz Report the objects for which ownership would be recovered in a briefcase without actually recovering ownership of the objects. Copy briefcase_ownership_recovery -u=username -p=password -g=dba -briefcase=BCZ_test1__IMC-10001_27-Jun-2019-12_10_42.bcz -report Recover ownership of objects in a TC XML file on a site that exported the briefcase. Copy briefcase_ownership_recovery -u=username -p=password -g=dba -briefcase=OffExp5bfce85700004c3000007bf5.xml Recover ownership of objects from a specific transaction. Copy briefcase_ownership_recovery -u=username -p=password -g=dba -transactionid=Prod34-1000158101227Nov2018 List exported briefcases from a particular month and recover ownerships from one of the listed briefcases. Copy briefcase_ownership_recovery -u=username -p=password -g=dba -siteid=12345 -mode=export -startdate=01-jun-2019 -enddate=30-jun-2019 Following is an example list: Copy

1. Model102_IMC-759_27-Jun-2019-12_10_42.bcz | jjohnson01 | 1030 | 27-Jun-2019
2. Model099_IMC-dkc_21-Jun-2019-08_43_15.bcz | jjohnson01 | 1030 | 21-Jun-2019
3. Model087_IMC-001_21-Jun-2019-08_35_32.bcz | jjohnson01 | 1030 | 21-Jun-2019 Entering 2 at the command prompt recovers ownership of the objects transferred to another site associated with briefcase Model099_IMC-dkc_21-Jun-2019-08_43_15.bcz. Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration