identify_non_structure_edges

Marks parent and child items that are ignored when adding, listing, or removing entries in spatial indexes. There are four ways to use this utility. Adding and specifying what to add using parallel lists of item IDs or UIDs. For example, in a parallel list of parents and children, the first parent goes with the first child, the second parent goes with the second child, and so on. Adding and specifying what to add by a parent item type and child item type. Listing all elements or optionally specifying that only elements relevant to a particular product or particular parent or child objects be listed. Removing and specifying what to remove by giving parallel lists of item IDs or UIDs. For example, in a parallel list of parents and children, the first parent goes with the first child, the second parent goes with the second child, and so on. Syntax identify_non_structure_edges [-u=user-ID [-p=password | -pf=password-file] [-g=group] ] [-add {-parent_item_id={parent-object1, parent-object2, ... | @filename} -child_item_id={child-object1, child-object2, ... | @filename} | -parent_uid={parent-uid1, parent-uid2, ... | @filename} -child_uid={child-uid1, child-uid2, ... | @filename} | -parent_item_type=parent-type -child_item_type=child-type} ] [-remove {-parent_item_id={parent-object1, parent-object2, ... | @filename -child_item_id={child-object1, child-object2, ... | @filename} | -parent_uid={parent-uid1, parent-uid2, ... | @filename -child_uid={child-uid1, child-uid2, ... | @filename} } ] [-list {-all [parent1, parent2, ... | @ filename] | [child1, child2, ... | @ filename] } {product={product1, product2, …} [-parent_item_id={parent1, parent2, … | @filename} [-child_item_id={child1, child2, … | @filename} ] | [-parent_uid={parent1, parent2, … | @filename} [-child_uid={child1, child2, …| @filename} ] } [-h] Arguments -u Specifies the user ID. The user must have administrative privileges. Note If your Teamcenter server uses Security Services single sign-on, see Before you begin for additional information. -p Specifies the user's 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. -add Adds entries for parent and child pairs. You can specify a parent and child object pair using item IDs or UIDs. You enter the identifiers as parallel, comma-separated lists for the parent and child flags. For long lists of values, you can create parent and child object files that contain a separate identifier on each line. Use the @file-name values to supply the file names on the command line in place of the comma-separated lists. Alternatively, you can use the -parent_item_type=parent-type and -child_item_type=child-type flags to specify a parent item and child item type pair. -remove Removes entries for parent and child pairs. You can specify a parent and child object pair using item IDs or UIDs. You enter the identifiers as parallel comma-separated lists for the parent and child flags. For long lists of values, you can create parent and child object files that contain a separate identifier on each line. Use the @file-name values to supply the file names on the command line in place of the comma-separated lists. -list Lists all entries when used with the -all argument without the optional parent or child object specifications. You can filter the listed entries by specifying parent or child objects using item IDs or UIDs. You can narrow the filter by specifying both parent and child objects to get a list of entries containing the parent objects that have at least one of the specified child objects. You enter the identifiers as comma-separated lists for the parent and child arguments. Optionally, you can list only those entries associated with one or more specified products using the –product=product-name argument. You can filter the product entries by specifying parent or child objects or both parent and child objects in the same way as the -all argument. For long lists of values, you can create parent and child object files that contain a separate identifier on each line. Use @file-name values to supply the file names on the command line in place of the comma-separated lists. -h Displays help for this utility. Examples To add parent-item and child-item pairs pitem1, pitem2 and citem1, citem2, enter the following command on a single line: Copy identify_non_structure_edges -u=Tc-admin-user -p=password -g=group -add -parent_item_id=pitem1,pitem2,pitem3 -child_item_id=citem1,citem2,citem3 To add parent-item and child-item pairs puid1, puid2 and cuid1, cuid2, enter the following command on a single line: Copy identify_non_structure_edges -u=Tc-admin-user -p=password -g=group -add -parent_uid=puid1,puid2,puid3,puid4 -child_uid=cuid1,cuid2,cuid3,cuid4 To add parent-item and child-item pairs where the parent item is of type ItemType1 and the child item is of type ItemType2, enter the following command on a single line: Copy identify_non_structure_edges -u=Tc-admin-user -p=password -g=group -add -parent_item_type=pitemtype -child_item_type=citemtype Note This example uses the parent and child item type, rather than the parent and child item ID. To list all parent-item and child-item pairs, enter the following command on a single line: Copy identify_non_structure_edges -u=Tc-admin-user -p=password -g=group -list -all To list parent-item and child-item pairs by product, enter the following command on a single line: Copy identify_non_structure_edges -u=Tc-admin-user -p=password -g=group-list -product=product1 To remove parent-item and child-item pairs using item IDs, enter the following command on a single line: Copy identify_non_structure_edges -u=Tc-admin-user -p=password -g=group -remove -parent_item_id=pitem1,pitem2,pitem3 -child_item_id=citem1,citem2,citem3 To remove parent-item and child-item pairs using UIDs, enter the following command on a single line: Copy identify_non_structure_edges -u=Tc-admin-user -p=password -g=group -remove -parent_uid=puid1,puid2,puid3,puid4 -child_uid=cuid1,cuid2,cuid3,cuid4 To remove parent-item and child-item pairs using a file containing the item IDs, create a parent and child file containing a single ID on each line. The pairs are determined by the order of the values in the file, for example: Create a parentList.txt file with the following contents: Copy pitem1 pitem2 : pitemN Create the childList.txt file with the following contents: Copy citem1 citem2 : citemN Enter the following command on a single line: Copy identify_non_structure_edges -u=Tc-admin-user -p=password -g=group-remove -parent_item_id=@parentList.txt -child_item_id=@childList.txt Related Topics Structure Management on Rich Client ─ Usage