delete_item_data

Deletes unused item revisions from the database. The item revisions to be removed are contained in an input file created by the user. Syntax delete_item_data [-u=user-id {-p=password | -pf=password-file} -g=group] [-inputFile=input-file | -inputKeyFile=input-file] -configFile=configuration-file [-outputDir=output-file-directory] {-mode=report | delete} [-delimiter=delimiter] [-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. -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. -inputFile Specifies the absolute path of the input file. The input file has the following format (the forward slash, /, is the delimiter): Copy item id/Item Revision1 item id/Item Revision2 item id/Item Revision3 -inputKeyFile Specifies the absolute path of the input file. The input file has the following format: Copy [keyAttr1=keyVal1] [,keyAttr2=keyVal2]…[,keyAttrN=keyValN], rev_id=A item_id=000100,rev_id=B -configFile Specifies the absolute path of the configuration file. The configuration file has the following field names and format: EXCLUDE = Relationship@C=Class; Relationship@T=Type; ...; INCLUDE = Relationship@T=Type; Relationship@C=Class; ...; The EXCLUDE and INCLUDE expressions contain three values as shown in the following examples: Copy Relationship@C=Class Relationship@T=Type The first value of the expression contains the relation value followed by the @ separator. The second value of the expression contains the type name (T) or the class name (C) followed by the = separator. The third value of the expression contains the value of the type or class followed by the ; delimiter. Note If there is only one relation specified in the expression, it must be terminated with the ; delimiter. For example: Copy IMAN_reference; If there is more than one expression, the expressions must be separated by the ; separator. For example: Copy IMAN_specification@T=MSWord;IMAN_reference@C= PSBOMViewRevision; To exclude the based-on item revisions to be deleted, add the IMAN_based_on@C=ItemRevision; expression to the EXCLUDE section. For example, assume item revision B was revised from A. When item revision B is deleted, revision A will also be deleted unless the IMAN_based_on@C=ItemRevision; expression is in the EXCLUDE section. This argument is required. -outputDir Specifies the path where report and log files are to be written. The default value is the current directory. -mode Specifies one of the following the modes: report Generates a summary report containing the following information: Target item revision ID Reference status Usage status Site ownership Exported replica status Deletion status delete Deletes the item revision and its associated objects except those specifically excluded by entries in the configuration file. To be deleted, the associated objects must only be related to the item revision. If the item revision is the only revision of an item, the item is also deleted. If the object is a dataset, all versions of the target dataset are deleted as well as all forms and named references associated with the dataset. This argument is required. -delimiter Specifies the delimiter character separator between the item ID and the item revision ID. The default is the forward slash (/). -h Displays help for this utility. Restrictions None. Examples The following is an example of an input file: Copy ABC000075/A ABC000074/A ABC000092/A ABN000002/A ABN000011/A ABN000058/A The following is an example of a configuration file: Copy EXCLUDE = IMAN_specification@T=UGMASTER; INCLUDE = IMAN_specification@T=MSWord;IMAN_reference@C= Copy PSBOMViewRevision; If there are no configuration entries in the configuration file, the EXCLUDE and INCLUDE values must be assigned with the ; delimiter as shown below: Copy EXCLUDE=; INCLUDE=; Any statements not conforming to the format above are not processed for evaluation This example indicates that the attached objects are not processed for evaluation and but they are only dereferenced from their parent item revision. The following is an example of the delete_item_data command line entry: Copy delete_item_data -u=admin-user -p=admin-password -g=dba -inputFile=c:\temp\input.txt -configFile=c:\temp\config.txt -mode=report The following is an example of using the delimiter=@ argument: Copy 000001@A 000002@B Related Topics Introduction to administering volumes