generate_tc_ps_path

Runs an ITK program that accepts the changed part list and generates the paths up to the top assembly for each item revision. Syntax generate_tc_ps_path [-u=user-id -p=password | -pf=password-file -g=group] [-revision_rule=rule-name] -item_rev_list=rev-file-name [-item_type=item-type] [-out_file=output-file-name] -output_format= new | old [-configure_top_level_revs= yes | no] -rev_full_file=rule-file-name [-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. -item_rev_list Defines the file containing the list of item revisions. Typically, this file is the output from the find_released_item_rev utility or the find_recently_saved_item_rev utility. This file can also be custom made. -revision_rule Defines the revision rule on the basis of which the configured parent is returned. These revision rules are used to determine whether they configure the item revisions specified in the item_rev_list file. This argument may be repeated for various revisions rules. This argument is not allowed if the rev_rule_file argument is defined, specifying the name of a file containing the list of revision rules. Otherwise, this argument is mandatory. -out_file Specifies the file to be used to write the utility output. If not defined, the output is written in the standard output. -output_format Specifies whether the utility output is in new format or old format. This argument is optional. If it is not defined, the new format is used. Possible values for this option are new and old. The old format is as follows: Copy @DB/VEH0001/004,@DB/VPPS0002/001,@DB/VPPS0006/ 001,@DBIA0009/002:Precise;Aplp2 Best w/PDI The new format is as follows: Copy PathPartRev@DBseparatorItem IDseparatorRevID/PartRev [PartRev@DBseparatorItemIDseparatorRevID]/PartRev] RevisionRuleRevisionrulename/RevisionRule/Path -item_type Specifies the item type of the top-level assembly. The utility lists only those paths with top-level assemblies of this type. In cases where such assemblies have parents, the defined path begins at the item with the given type. This argument is optional. -rev_rule_file Lists all the revisions rules to be used for the found item revisions. This argument is optional only if the revision rule arguments are defined; otherwise, this argument is required. If both the revision_rule argument and the rev_rule_file argument are defined, the rev_rule_file argument takes precedence. -configure_top_level_revs Specifies whether to configure the top-level revision. This argument is optional. If Yes is specified, the top-level item of the changed item revision is configured and the changed item revision is checked to determine if it uses the top-level item revision. If No is specified, or the argument is not specified, the top levels are not configured. -h Displays help for this utility. Environment This utility should be run from a shell where the Teamcenter environment is set. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples To generate a path for the item revisions specified in a text file: Copy generate_tc_ps_path -item_rev_list=released_items.txt -revision_rule=revision-rule-name -output_file=path_list.txt -output_format=new -configure_top_level_revs=no Related Topics Structure Management on Rich Client ─ Usage