gmo_migrate_usage_nves

Migrates existing architecture breakdowns to the newer, simplified format of named variant expression (NVE) comprising usage, year, and production usage. You should only run this utility if you created NVEs in Teamcenter 2007.1 MP6 or earlier by running the rdv_import_usage utility. If you created NVEs in later releases, it is not necessary to run this utility. Otherwise, you should run this migration utility only once on each architecture breakdown. The utility outputs the usage NVEs in the architecture breakdown and the assembly structure in the new format of NVEs. It also generates a list of the older format NVEs that are replaced and you can use this list to identify unused NVEs for deletion. For example, it takes an older format NVE coded as D9_2009-09_AA5M_1PD69_PS and generate the following NVE code strings: Copy D9_AA5M_1PD69_000 Year_2009-09 ProductionUsage Syntax gmo_migrate_usage_nves [-u=user-id {-p=password | -pf=password-file} -g=group] -revision_rule=rev-rule-string -mode=migration-mode -top_level_AB_id=vehicle-architecture-id | -louholder_item_id=item-id -archId_list_file=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. -revision_rule Specifies a valid revision rule string to configure the structure window. -mode Specifies the running mode of the utility, either report to generate a report of NVEs to migrate or migrate to initiate migration of affected NVEs. -top_level_AB_id Specifies the item ID of a top level architecture. All LOUs under LOU holders in the specified architecture are processed. If you specify this argument, do not specify a -louholder_item_id argument. -louholder_item_id Specifies the item ID of a LOU holder. If you specify this argument, do not specify a -top_level_AB_id argument. -archId_list_file Specifies a flat file containing architecture IDs. The utility uses these architecture IDs to retrieve the NVEs of affected LOUs. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Restrictions None. Files As specified in Log files produced by Teamcenter. Examples To migrate all the NVEs for the Model_2009_AB architecture breakdown, enter the following command on a single line: Copy gmo_migrate_usage_nves -u=user-name -p=password -g=group -revision_rule=production -mode=migrate -top_level_AB_id=Model_2009_AB -archId_list_file=AB.txt Related Topics Teamcenter Automotive Edition