ps_rename_bvrs

Renames BOM views and BOM view revisions using the current naming scheme. The new name can differ from the old name because the naming scheme has changed or because the name of the view type has changed. By default, the utility runs on all BOM views and BOM view revisions in the database, but it can accept an item ID argument (including wildcards) or a key argument, defining a set of objects to rename. Syntax ps_rename_bvrs[-u=user-id -p=password | -pf=password-file -g=group] [-item=item_pattern] | -key=[keyAttr1=keyVal1] [,keyAttr2=keyVal2]…[,keyAttrN=keyValN]] [-view=view-type] [-h] Arguments -u Specifies the user ID. This is a required argument unless the TC_auto_login site preference is set. 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 is a required argument unless the TC_auto_login site preference is set. 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. This is a required argument unless the TC_auto_login site preference is set. If used without a value, the user's default group is assumed. -item Specifies which BOM views or BOM view revisions to rename by a pattern match on the parent item ID. -key Specifies which BOM views or BOM view revisions to rename by key. Use the following format: Copy [keyAttr1=keyVal1] [,keyAttr2=keyVal2]…[,keyAttrN=keyValN] To find the key of an object, use the get_key_string utility. For more information, see Introduction to multifield keys in BMIDE for Data Model Design. -view Specifies which BOM views or BOM view revisions to rename by BOM view type. The default is to rename BOM views or BOM view revisions of all types. -v Verbose mode. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment and the following preferences: TC_ignore_case_on_search TC_pattern_match_style For more information about these preferences, see Teamcenter Preferences. Files As specified in Log files produced by Teamcenter. Restrictions Wildcard characters used in the -item argument may require enclosure in double quotation marks to prevent the shell from expanding them. Examples To update names of all BOM views and BOM view revisions (BVRs) in the database, enter the following command: Copy $TC_ROOT/bin/ps_rename_bvrs Consider a site where the Manufacturing BOM view type is renamed to M Site 1. To rename all BOM views and BOM view revisions with parent item IDs beginning pbx to agree with the new name, enter the following command on a single line: Copy $TC_ROOT/bin/ps_rename_bvrs -view="M Site 1" -item="pbx*" Related Topics Structure Management on Rich Client ─ Usage