ics_connect

Associates classification objects (ICOs) with workspace objects, based on item ID. You can list multiple workspace objects, or you can create a text file containing a list of item IDs. For example, when you use the smlutility utility to import classification data into Teamcenter, the ICOs are created as specified in the input file, but they are not attached to the items defined in the input file via their workspace object uid. Use the ics_connect utility to associate all your ICOs (not already connected to any item) to the specified item of the same ID. Caution If you use multifield keys to define item IDs, you cannot use ics_connect to connect a standalone ICO to an existing item because multiple items with the same ID exist. Syntax ics_connect [-u= {-p= | -pf=} -g=] -names= | -file= -key=keyAttr1=keyVal1,keyAttr2=keyVal2,keyAttrN=keyValN | -keyFile=} [-h] Examples Copy ics_connect -u=Tc-admin-user -p=password -g=group -names=item1 Copy ics_connect -u=Tc-admin-user -p=password -g=group -names=item2,item3 Copy ics_connect -u=Tc-admin-user -p=password -g=group -names=item4/A,item5/C Copy ics_connect -u=Tc-admin-user -p=password -g=group -file=wso_names.txt 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 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. If used without a value, the user's default group is assumed. -names Specifies the item IDs of the items to be associated with the ICOs of the same ID. -file Specifies the name of the file containing the list of item IDs to be associated with the ICOs. Place one item or item revision ID per line. -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 associate the ICOs with IDs of item2 and item3 with the items with IDs of item2 and item3: Copy ics_connect -u=Tc-admin-user -p=password -g=group -names=item2,item3 The system searches for items with the ID item2 and item3, connecting them to ICOs with the same ID, as long as the ICOs are not attached to any other workspace object. To associate the ICOs with the item4/A and item5/C item revisions: Copy ics_connect -u=Tc-admin-user -p=password -g=group -names=item4/A,item5/C The system searches for item revisions with the ID item4/A and item5/C, connecting them to ICOs with the same ID, as long as the ICOs are not attached to any other workspace object. To associate the ICOs with the item IDs contained in the wso_names.txt file: Copy ics_connect -u=Tc-admin-user -p=password -g=group -file=wso_names.txt The file must contain item and item revision IDs, one per line. To connect Workspace objects with MFK IDs use the following: Note To find the key of an object, use the get_key_string utility. Copy ics_connect -u=Tc-admin-user -p=password -g=dba -key=item_id=000039,object_name=ABC To connect the revision use: Note The revision has to be last entry. Copy ics_connect -u=Tc-admin-user -p=password -g=dba -key=item_id=000039,object_name=ABC,rev_id=A When using the -keyFile option, use the following format: Copy item_id=export_001 Copy item_id=M2Item1_001,object_name=M2Item_name1,object_type=M2Item1 Copy item_id=M2Item1_002,object_name=M2Item_name2,object_type=M2Item2,rev_id=B