ps_traverse

Traverses a product structure and reports BOM line attributes and workspace attribute values in a file in delimited format. It also sets an assembly to precise and releases/transfers ownership of the item revisions that constitute the structure. The inputs for these are taken from a configuration file and the input for product structure configuration are taken from the command line options. A configuration file for input is mandatory. If the te.cfg file exists in the current directory, it is considered. If not, a configuration file must be specified by the -cfg options. A sample configuration file is provide in the $TC_ROOT directory. Syntax ps_traverse [-u=user-id -p=password | -pf=password-file -g=group] -itemid=item-to-traverse -rev=revision-for-item-to-traverse [-revrule=revision-rule-to-configure-BOM-window] [-viewtype=type-of-item-revision-BVR-to-traverse] [-variant=saved-variant-object-to-configure-BOM-window] [-log=log-file-for-session-output] [-packlines= true | false] [-cfg=configuration-file-for-options] [-report=report-file-for-output] [-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. -itemid Specifies the ID of the item for which the associated BOM view revision (BVR) is traversed. (BOM view revisions are associated with revisions corresponding to the specified item.) -rev Specifies the revision of the item specified by the -itemid argument. The revision must have an associated BVR. -viewtype Specifies the type of the BVR to be traversed. -revrule Specifies the revision rule used to configure the BOM window. The default revision rule is Latest Working. -variant Specifies the saved variant used to configure the BOM window. If more than one saved variant exists, the first one found is considered. -log Specifies the log file to which the output is directed. The default file is te.log. -report Specifies the file to which the report is written. The default file is tereport.txt. -packlines Indicates whether to pack or unpack BOM lines. -cfg Specifies the input configuration file. The default file is te.cfg. -h Displays help for this utility. Configuration File Entries The configuration file is a text file in which entries must be made under the following separate headings: bomreport= Valid values for this attribute are the display names of columns in Structure Manager, for example, Rule configured by and Sequence No., and are case sensitive. Values listed in the columns are reported for each node in the BOM. woreport= The values of these object attributes in workspace listed under this entry are reported. formattributes= The form attributes to be reported are listed under this string. These should be in the format Form Type Name:attribute. The form values are truncated to 200 characters. action= The actions to be performed while traversing product structure are listed under this heading. The following actions are supported: fastrelease changeowner setprecise Note When the setprecise action is specified, other actions and reporting inputs are ignored and the utility makes only the specified assembly precise. relstat= Specifies the release status to be applied if the specified action is fastrelease. newowner= Lists the new owner to whom the object ownership is transferred if the changeowner action is specified. alternate= Specifies whether alternates are processed. Valid values are Yes and No. substitute= Specifies whether substitutes are processed. Valid values are Yes and No. delimiter= Specifies the delimiter used to separate attribute values in report generation. The default delimiter is a semicolon (;). columnwidth= Specifies the attribute values used In report generation. The default column width is 20 characters. Examples Following is the content of the ps_traverse.cfg sample configuration file, which is located in the $TC_ROOT\sample\examples directory. Sample configuration file Copy alternate= yes bomreport= BOM Line Name woreport= object_name item_revision_id owning_user formattributes= delimiter=

columnwidth= 25 action= #fastrelease #changeowner #setprecise relstat= X newowner= tcdba group= dba Related Topics Structure Management on Rich Client ─ Usage