tcxml_xfer_ownership

Description Transfers the ownership of a set of Teamcenter objects. You can use this utility to change ownership of all objects owned by a site during site consolidation, change ownership of related objects during transition from Teamcenter Enterprise to Teamcenter (flip-the-switch ownership transfer), or change object ownership when importing objects into Teamcenter from another data management system. For performance reasons during site consolidation, this utility changes ownership of objects using SQL calls, not the POM API. Rich client refresh works only when POM calls are used to change an attribute, including ownership changes. Therefore, ownership changes that the utility enacts during an active rich client session are not reflected in the interface. You must restart all active rich clients to get the changes. This is normally not an issue because user access must be prohibited during the time critical period when this utility is used. A valid license key is required to use this utility for site consolidation ownership changes. The perform_highlevel argument enables the flip-the-switch ownership transfer feature of this utility. By default, during flip-the-switch ownership transfer, this utility uses the POM API to change object ownership. Therefore, ownership changes that the utility enacts during an active rich client session are reflected in the interface. You are not required to restart the active rich clients to get the changes. For better performance, you can set the TIE_flip_using_SQL preference to true to use SQL calls during flip-the-switch ownership transfers. If you use this preference setting, you must restart all active rich clients to get the changes. A valid license key is not required to use this utility when you enable the flip-the-switch feature. Syntax tcxml_xfer_ownership -u=user-name {-p=password | -pf=password-file} [-g=group] -action={extract | perform | update_status | perform_highlevel | perform_highlevel_dryrun} [-inputfile=file-with-object-list] [-change_ownership_to=site-ID] [-dryrun [-startDate=MM/DD/YYYY -endDate=MM/DD/YYYY ] [-source_extinct] ] [-file=status-output-file] [-report=report-file-name] [-h] Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. 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 extract, perform, or update status. To use the extract, perform, or update_status values, the SITCONS_AUTH_KEY environment variable must be set to a valid key value. Open a support case on Support Center to get this license key. extract Generates the file for ownership transfer. The -change_ownership_to, -report, or -dryrun arguments are supported for this action. perform Transfers the ownership at target site. The -inputfile, -file, -source_extinct, or -dryrun arguments are supported for this action. update_status Updates the status at source site. The -inputfile, -change_ownership_to, -source_extinct, -report, or -dryrun arguments are supported for this action. perform_highlevel Performs a high-level (flip-the-switch) ownership transfer at the target site The -inputfile and -change_ownership_to arguments are supported for this action. Any other arguments are ignored. This action generates two outputs files, the input-file-name_flip_objects.log file lists all objects transferred and the input-file-name_results.xml file contains the flip status of objects given in input file. perform_highlevel_dryrun Generates a report to preview the ownership change of objects transferred by a high-level (flip-the-switch) ownership transfer at the target site. The -inputfile and -change_ownership_to arguments are supported for this action. Any other arguments are ignored. -inputfile Specifies the name of the file containing the objects for ownership change. -change_ownership_to Specifies the site ID of the target site. This argument is required when the utility is run at the source site. If this argument is omitted, the utility uses the local site as the target site. If either the -dryrun or the perform_highlevel_dryrun argument is specified, the ownership transfer is not performed. -dryrun Generates a report to preview the ownership change of objects transferred by the site consolidation tools, and identifies inconsistencies. To preview the objects at the target site that are owned by the source site and are inconsistent with the source site due to modifications made to them at the target site post-replication, set the TIE_DRYRUN_VALIDATION=TRUE preference at the target site. The -startDate and -endDate arguments are valid only with the -dryrun argument. The utility generates a dry run report for objects transferred within the date range specified by the -startDate and -endDate values. To use the dry run mode to check objects of an island owned by the source site that are not covered in the accountability table for ownership transfer, set the TIE_DRYRUN_VALIDATION preference to TRUE at the target site. For debug information, set the following environment variables: TC_SLOW_SQL=1 TC_SQL_DEBUG=BJPT -startDate Specifies the starting date for replicas and inconsistencies reported by the -dryrun argument. This argument is used in conjunction with the -endDate argument and is ignored if the -dryrun argument is not specified. The date supplied must be in supplied in a MM/DD/YYYY format. -endDate Specifies the ending date for replicas and inconsistencies reported by the -dryrun argument. This argument is used in conjunction with the -startDate argument and is ignored if the -dryrun argument is not specified. The date supplied must be in supplied in a MM/DD/YYYY format. -source_extinct Generates the list of replica items at the target site which are owned by the source site and which were not transferred by site consolidation tools. This argument can be used only when the -dryrun argument is used and is ignored otherwise. -file Specifies the name of the output file (with an absolute path) that contains the status of ownership transfer of the objects at the target site. This argument is valid only for the site consolidation –action=perform argument. -report Specifies the name of the report file or extract file. This argument is valid only for site consolidation actions. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples To run at the source site and extract to a file the objects for ownership transfer: Copy tcxml_xfer_ownership -u=Tc-admin-user -p=password -g=group -action=extract -report=D:\Temp\ownership_transfer_extract.txt -change_ownership_to=target_site_id [-dryrun] To transfer the ownership or validate the inconsistencies for ownership transfer at the target site: Copy tcxml_xfer_ownership -u=Tc-admin-user -p=password -g=group -action=perfrom -inputfile=ownership_transfer_extract.txt -file=ownership_transfer_status.txt [-dryrun] [-source_extinct] To update the ownership transfer status or to generate report for a dry run at the source site: Copy tcxml_xfer_ownership -u=Tc-admin-user -p=password -g=group -action=update_status -inputfile=ownership_transfer_status.txt -report=ownership_transfer_update_status.txt -change_ownership_to=target_site_id [-dryrun] To use flip-the-switch ownership transfer to change ownership at the target site: Copy tcxml_xfer_ownership -u=Tc-admin-user -p=password -g=group-action=perform_highlevel -inputfile=flip_the_swich_input.txt -change_ownership_to=target_site_id To use flip-the-switch ownership transfer to determine ownership change at the target site without actually changing ownership: Copy tcxml_xfer_ownership -u=Tc-admin-user -p=password -g=group -action=perform_highlevel_dryrun -inputfile=flip_the_swich_input.txt -change_ownership_to=target_site_id The following example shows the contents of a sample file used as the input for an ownership transfer (-inputfile=flip_the_switch_input.txt): Copy

You can construct the input file manually by copying the GSIdentity elements from the TC XML files used for importing the objects. Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration