mfk_update

Updates multifield key definitions in the key table in the database. Normally, during upgrade the system runs this utility so that business object instances on the server are migrated to the new multifield key definitions. As an administrator, you can also use this utility to: Evaluate proposed multifield key definitions in a template before installing the template to the production server. Specifically, you can determine whether a multifield key is deployable or not (that is, unique across business object instances in the particular domain, all properties found and of the right type, and so on). The utility reports potential collisions (duplicate multifield key values) and the quantity of collision instances. Analyze the multifield key definitions on the server, and if there are corrupt or inconsistent key definitions, rebuild the key table on the database. Rebuild all multifield key values in the system, thereby guaranteeing correctness. Note There are other utilities that you can use to work with keys. Use the get_key_definition utility to get the multifield key definition for a business object type, and use the get_key_string utility to get the multifield key value of an item instance as a string containing property names and values. For more information, see Analyzing multifield keys in BMIDE for Data Model Design. Syntax mfk_update -u=user-id {-p=password | -pf=password-file} [-g=group] -check -file=template-file-path -rebuild [-log=log-file-path] [-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 full path and filename of the password file. For 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. -check Runs the utility in analysis mode. When analyzing proposed multifield key definitions, the -file option must specify the file name. -file Specifies the path of the XML file that contains multifield key definitions to be analyzed. If -file option is not specified, the utility analyzes the multifield key definitions in the system. -rebuild Rebuilds all multifield key entries. This argument is mutually exclusive with the -check argument. -log Specifies the path of the log file that contains results of the multifield key update. The default is the TC_TMP_DIR/mfk_updater_date-and-time.log file. If the TC _TMP_DIR environment variable is not set, the log file is created in the system temporary directory (C:\TEMP on Windows or /tmp on Linux). -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples To perform an analysis of proposed keys in a custom Business Modeler IDE template: Copy mfk_update -u=admin-user -p=admin-password -g=dba -check -file=C:\delta.xml -log=C:\mfk_check_template.log To perform an analysis of the keys in the database: Copy mfk_update -u=admin-user -p=admin-password -g=dba -check -log=C:\mfk_check_database.log To rebuild the key table for all multifield key definitions in the database: Copy mfk_update -u=admin-user -p=admin-password -g=dba -rebuild -log=C:\mfk_rebuild.log Related Topics BMIDE for Data Model Design