start_sco_dispatcher

Starts the structure context object (SCO) dispatcher to initiate the transfer of SCOs created by the rdv_context_download utility to other sites. The validate_and_replicate_assembly utility subsequently consumes the PLM XML files created by the rdv_context_download utility and replicates them across sites. Syntax start_sco_dispatcher [-u=user-id {-p=password | -pf=password-file} -g=group] -saved_query_name=Teamcenter-saved-query-name | -sco_folder=Teamcenter-folder-name | -sco_list=list-of-scos | -sco_name=StructureContextObjectName -site_name=Destination-site-name | -site_url=Destination-site-url [-transfer_mode=transfer-mode-name] [-dataset_time_interval=time-interval] [-user_attrs=user-attributes] [-h] Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. Note 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 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. If used without a value, the user's default group is assumed. -sco_name Specifies the name of the SCO from which a PLM XML file is generated. You can specify more than one SCO in a comma-separated list, for example: SCO1,SCO2,SCO3 -sco_list Specifies a list of SCOs to process. You can specify more than one SCO in a hash-separated list, for example: SCO1#SCO2#SCO3 -saved_query_name Specifies the name of a Teamcenter saved query that retrieves a set of SCOs to process for given search criteria. -sco_folder Specifies the name of a Teamcenter folder that contains a set of SCOs to process. -transfer_mode Specifies the name of a transfer mode to generate the PLM XML file. If no mode is specified, the SCOs are evaluated with the default transfer mode. -site_name Specifies the names of the sites with databases to which Teamcenter sends the SCOs. You can specify more than one site in a hash-separated list, for example: Site1#Site2#Site3 -site_url Specifies the URLs of the sites to which Teamcenter sends the SCOs. Use URLs, rather than site names, if the target sites do not have databases. You can specify more than one URL in a hash-separated list, for example: Site1#Site2#Site3 -dataset_time_interval Specifies the interval in minutes at which the rdvcontextdownload translator generates PLM XML files. If no interval is specified, the default value of 60 minutes is used. -user_attribute Specify user attributes to include in the PLM XML file. The specified attributes must be BOM line properties. You can specify more than one user attribute as a hash-separated list, for example: Owningsitename#ItemID#RevisionID##last_mod_date -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 You must have the necessary create or modify data privileges to successfully run this utility. If you do not have the appropriate privileges, data is not imported and an error message is written to the log file. If the utility evaluates an SCO and identifies that the target BOM lines are not valid, it exits and displays an error message to the user. It does not process any further SCOs. Examples The following example runs a saved query called SCO_SQR to transfer SCOs to a single database site using Multi-Site Collaboration: Copy start_sco_dispatcher -saved_query_name=SCO_SQR -site_name=testsite -dataset_time_interval=120 The following example transfers all SCOs in the SCO_folder folder to a single site without a database. The transfer is achieved via FMS by specifying the target site URL: Copy start_sco_dispatcher -folder_name=SCO_folder -transfer_mode=PIEPLMXMLDEFAULT -site-url=http://testsite:7001 Related Topics Structure Management on Rich Client ─ Usage