tcxml_ownership_recovery

Description Changes ownership for a list of replica objects at the local site. The utility can also be used to report the current site ownership of objects related to an item. You can use this report to determine when objects imported from an unmanaged site briefcase file have incorrect owning sites. The report contains the UIDs of the items and can be used to create the input file used to change (flip) the ownership of the file to the target site. Syntax tcxml_ownership_recovery -u=user-name {-p=password | -pf=password-file} [-g=group] -action={report | flip} {-inputfile=file-with-item-IDs | -inputuidfile=file-with-uids} {-targetsite=site-ID | -optionset=option-set-name} [-h] Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. Note When 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 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's password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. The file must be a single-line ASCII file containing the password in clear text. Teamcenter Environment Manager prompts you for a password and creates the password file during installation. 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. -action Specifies whether to create a report file showing the site ownership of the input file items and their related objects or to perform site ownership change on the input file items. report Generates a file that displays the owning site for the input file objects and the objects related to them. The report file is in the same directory as the input objects file defined by the -inputfile argument. The file name follows the format: input-file-name_report.log. When you specify a report action: The -inputfile argument is required. The -optionset argument is optional. The -inputuidfile and -targetsite arguments are ignored. flip Transfers the ownership of the objects in the input file to the target site. The input file is defined by the -inputuid argument. When you specify a flip action: The -inputuidfile and -targetsite arguments are required. The -inputfile and -optionset arguments are ignored. -inputfile Specifies the file containing a list of item IDs for which you want to determine the owning site. The file must contain item IDs on separate lines. This argument is ignored for flip actions. -inputuidfile Specifies the file containing a list of object UIDs for which you want to change the owning site to the target site. The target site is identified by the -targetsite argument. The file must contain object UIDs on separate lines. This argument is ignored for report actions. -targetsite Specifies the new owning site of the objects defined in the input file. The input file is identified by the -inputuidfile argument. This argument is ignored for report actions. -optionset Specifies the name of the transfer option set (TOS) used to determine the objects related to the item IDs that are included in the report file. This argument is ignored for flip actions. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in the Log files produced by TeamcenterLog files produced by Teamcenter. Restrictions None. Examples To generate a report file containing the items and their related objects listed in the check_itemids.txt file: Copy tcxml_ownership_recovery -u=Tc-admin-user -p=password -g=group -action=report -inputfile=check_itemids.txt To generate a report file containing the items and their related objects as determined by the default site consolidation TOS: Copy tcxml_ownership_recovery -u=Tc-admin-user -p=password -g=group -action=report -inputfile=itemids.txt -optionset=SiteConsolidationDefault To transfer the ownership of the objects listed by UIDs in the object_uids.txt file to site -100004379: Copy tcxml_ownership_recovery -u=Tc-admin-user -p=password -g=group -action=flip -inputuidfile=object_uids.txt -targetsite=-100004379 Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration