distributed_execute

Executes the item_report utility, both locally and remotely, and generates reports. You can specify any command line parameters required for the item_report utility on the distributed_execute command line, and those arguments are passed to the item_report utility. Note This utility does not support individual item ID input. You must use the -itemidsfile=file argument. Siemens Digital Industries Software recommends you first perform the -distributed_func=traverse_items step. This accumulates all traversed items from all specified sites and collects them in an output file (BOM traversal). You can use this file as input argument in subsequent steps, for example, report. This utility does not collect logs at remote sites and return them to the local machine. Siemens Digital Industries Software also recommends you test this utility with emphasis on: Verifying the utility performs the same way locally and remotely. Receiving required report files and test miscellaneous combinations of command line parameters; any additional parameters specified are passed to the calling program. Syntax distributed_execute [-u=user-id {-p=password | -pf=password-file} -g=group] -distributed_func=function -itemidsfile=datafile -distributed_sites=site1,site2,site3 -outfile=file-name [-delimiter=delimiter-character] [-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. -distributed_func Specifies one of the following functions: traverse_items Traverse BOM on all specified sites and produce union of all traversed IDs, argument maps to the item_report utility argument -traverseditemfile. report Generates a distributed IDSM-based report based on list of items input from an ID file, argument maps to item_report utility, generate the reports, and merger reports. -itemidsfile Specifies a data file containing comma-separated values (CSVs) or carriage return/line feed separated item IDs. This argument is required. -outfile Specifies the output file. This argument is required. -distributed_sites Specifies a list of sites, both local and remote, on which this command is executed. This argument is required. -delimiter Specifies a delimiter character for the output file. The default value is the vertical bar (|). Ensure the delimiter in the site-based file and merge file input match. -h Displays help for this utility. Restrictions None. Examples To execute item_report to generate a list of traversed objects for three sites (user, password, and group arguments are not shown in the example): Copy distributed_execute -distributed_sites=Site1,Site2,Site3 -outfile=trav.out -distributed_func=traverse_items -itemidsfile=item_id.txt To execute item_report to generate report files and merge file (user, password, and group arguments are not shown in the example): Copy distributed_execute -distributed_sites=Site1,Site2,Site3 -outfile=merge.out -distributed_func=report -itemidsfile=item_id.txt Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration