ums_mapping

As of version 2406, Teamcenter employs an updated unit management system (UMS). Following an upgrade of a Teamcenter installation from a version prior to 2406, use this utility to map legacy BMIDE units of measure to definitions in the UMS. Syntax ums_mapping [-u=user-id {-p=password | -pf=password-file} -g=group] [-analyze {-report_file= | -input_file=}config_file] | [-map -input_file=config_file -report_file=map_report_file] | [-unmap {-input_file=config_file | -all} -report_file=unmap_report_file] [-create_uom -report_file=create_uom_report_file] [-h] Arguments -u Specifies the user ID. To use the -map, -unmap, and -create_uom arguments, 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 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. To use the -map, -unmap, and -create_uom arguments, this is a user who is a member of a group with DBA privileges. If used without a value, the user's default group is assumed. -analyze Evaluates the legacy existing units of measurement system. Use -analyze with -report_file to examine the Teamcenter database for existing units of measure and their definitions. The utility attempts to map legacy units of measure to units of measure in the UMS. This mapping is performed based on unit names and symbols. The utility generates the .csv file specified by -report_file=config_file showing these mappings along with units that could not be mapped between the systems. Confirm and update the mappings in this file as described in Migrate legacy units of measure. The .csv file contains the following mapping information: Column Definition Is Approved Remove the # character in this column to process this unit when using -map, -unMap, or -createMap. UOM Name The name of the unit in the legacy system. UOM Symbol The symbol of the unit in the legacy system. In Use A value of Yes indicates that this unit is used by an object in the legacy system. Action The utility action performed to create the file. Status The unit's mapping state at the time the file was created. Details A description of the unit's state and any recommended actions. Unit Definition ID The ID of the unit in the UMS. Unit Definition Name The name of the unit in the UMS. Unit Definition Symbol The symbol of the unit in the UMS. After confirming and completing the mappings in the .csv file, use -analyze with -input_file to generate a dry-run report showing what the results will be if you use the .csv file to map the approved mappings. -map Updates the Teamcenter database references between the legacy unit of measure line items with the UMS line items defined in the configuration file specified with -input_file. Approved units in the file (units with no "#" symbol in the first column) are updated in the Teamcenter database. The utility generates the report specified with -report_file listing the updates and their completion status. -unmap Removes Teamcenter database relationships between legacy units of measure and the UMS. Using -input_file with -unmap removes specific unit of measure relationships. Relationships for approved units in the file (units with no "#" symbol in the first column) are removed from the Teamcenter database. Using -all with -unmap removes all existing units of measure relationships from the Teamcenter database. You could then restart migrating legacy units of measure as described in Migrate legacy units of measure to the unit management system. The results of either removal is detailed in the file specified by -report_file. -create_uom Analyzes the UMS and creates new units for definitions without related units. Results are listed in the report specified by -report_file. -h Displays help for this utility. Environment As specified in Manually configure the Teamcenter environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples Analyze the Teamcenter database for existing UMS unit definitions. Create a mapping configuration file containing mappings between the legacy units of measure to existing unit of measure definitions in the UMS. Copy ums_mapping -u=username -p=password -analyze -report_file=c:\temp\mapping_config.csv Perform a dry run of linking approved units of measure to unit definitions in the UMS. Copy ums_mapping -u=username -p=password -analyze -report_file=c:\temp\mapping_config.csv Add unit of measure relationships to the Teamcenter database. Copy ums_mapping -u=admin-username -p=admin-password -g=dba -map -input_file=c:\temp\mapping_config.csv -report_file=c:\temp\mapping_report.csv The utility generates the report mapping_report.csv listing the updates and their completion status. Remove unit of measure relationships from the Teamcenter database Copy ums_mapping -u=admin-username -p=admin-password -g=dba -unmap -input_file=c:\temp\mapping_config.csv -report_file=c:\temp\mapping_report.csv The utility generates the report mapping_report.csv listing the removed unit relationships. Create new units of measure and add the new units to the Teamcenter database. Copy ums_mapping -u=admin-username -p=admin-password -g=dba -create_uom -report_file=c:\temp\unit_report.csv The utility generates the report unit_report.csv listing the created units.