harvest_mmv_index

Creates or updates the spatial cell index for a particular product specified by an item revision. The spatial cell index describes the spatial structure of the massive product data and is used by viewer clients to quickly load and render the product geometry. The utility traverses the product structure and locates all unconfigured occurrences that contain a JT dataset. Each occurrence is identified by the revision independent path from the root to this occurrence. The bounding box information is computed for each occurrence, and the bounding box is rolled up to the root coordinate system by applying the accumulated transform. The rolled-up bounding boxes are used to create a spatial tree, which is saved as an .mmv file. This .mmv file is uploaded as a named reference of a Fnd0SpatialHierarchy dataset. Syntax harvest_mmv_index [-u=user-id {-p=password | -pf=password-file} -g=group] [-item=item-id | -key=item-key | -itemuid=root-item][-rev=revision] [-rev_rule=revisionRuleList][-log=file-name][-purge][-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. The file must be a single-line ASCII file containing the password in clear text. Teamcenter Environment Manager prompts you for a password and creates the password file during installation. 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. -item Specifies the item ID for the root of the BOM structure. -key Specifies a string used to identify an item instead of specifying an item using the -item and -rev arguments. To find the key of an object, use the get_key_string utility. For more information, see BMIDE for Data Model Design. -itemuid Specifies the UID to identify the item of the product to be harvested. If this option is specified, the -item and -key options cannot be specified. -rev Specifies the item revision for the root of the BOM structure. -rev_rule Specifies the revision rules that are supplied for the product that is to be harvested. Each specified revision rule is delimited by a comma. If no revision rule is supplied, the product is harvested as unconfigured. -log Specifies the name for the log file. By default, the log file is harvest_spatial_index_time.log. -purge Purges the MMV indexes for all products. Purging indexes periodically keeps database tables from becoming too large, which can degrade harvesting and system performance. Note Once this option is used, the MMV indexes for products must be rebuilt by running the utility again. -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 harvest a specific revision of a product (item_id=000004), configured with revision rules Latest Working and Latest Released, type the following command on a single line: Copy harvest_mmv_index -u=adminjones -p=passjones -g=admin -item=000004 -rev=001 -rev_rule="Latest Working,Latest Released" To harvest spatial cell indexes for a specific revision of an unconfigured product (item_id=000004) using the multifield key, type the following command on a single line: Copy harvest_mmv_index -u=adminjones -p=passjones -g=admin -key=000004-key -rev=001