convert_replica_files_to_stubs

Converts existing replica Teamcenter file (ImanFile objects) to pom_stub objects at the specified remote site, all remote sites, or specified objects at all remote sites; it purges the corresponding operating system volume files to conserve space. It can also populate the file server cache (FSC) with replica files. Syntax convert_replica_files_to_stubs [-u=admin-id {-p=password | -pf=password-file} -g=dba] {[-by_site_name=remote-site-id | ALL] | [-by_plmxml=file-name]} [-verbose] [-populate_cache] [-query ] [-batch_size=size-value] [-h] Arguments -u Specifies the user ID. The user must have administrative privileges. -p Specifies the user's password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. 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. The group value must be dba to run this utility. -by_site_name Specifies the name of the remote site where replica files are replaced with stubs. If ALL is specified, replica files at all remote sites are replaced. This argument cannot be combined with the -by_plmxml argument. -by_plmxml Specifies the name of a PLM XML file that contains replica objects to be replaced by stubs. Only the objects listed in the file are replaced. You must generate the PLM XML file specified in this argument using the ConfiguredDataExportDefault or justDatasetsOut transfer modes. Other transfer modes are not supported. This argument cannot be combined with the -by_sitename argument. -verbose Includes additional information about the process in the utility's output. -populate_cache Populates the FSC with replica files at the sites where replica objects are replaced with stub objects. -query Returns the number of objects that will be converted to stubs. -batch_size Specifies the number of objects in each batch that is processed. If this argument is omitted, all objects are processed in a single batch. -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 Teamcenter. Restrictions The IDSM server must be running when you use this utility. Examples Replace all replica objects at all sites with stub objects: Copy convert_replica_files_to_stubs -u=Tc-admin-user -p=password -g=group -by_site_name=ALL Replace replica objects at the cologne site and populate the site's FSC: Copy convert_replica_files_to_stubs -u=Tc-admin-user -p=password -g=group -by_site_name=cologne -populate Determine the number or replica objects that will be replaced at a site: Copy convert_replica_files_to_stubs -u=Tc-admin-user -p=password -g=group -by_site_name=cologne -query Replace all replica objects at all sites with stub objects processed in batches of 200 objects: Copy convert_replica_files_to_stubs -u=Tc-admin-user -p=password -g=group -by_site_name=ALL -batch_size=200 Replace replica objects in the stub_replicas.xml file at all sites with stub objects processed in batches of 200 objects: Copy convert_replica_files_to_stubs -u=Tc-admin-user -p=password -g=group -by_plmxml=stub_replicas.xml -batch_size=200 Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration