Specialized Administration > Working with Properties and Command Line Utilities > Life Cycle Command Line Utilities > Remove Life Cycle History Command Line Utility > Running the Remove Life Cycle History Utility
  
Running the Remove Life Cycle History Utility
Use the following procedure to run the Remove Life Cycle History command line utility:
1. Navigate to the following location:
<Windchill>/codebase/wt/lifecycle/utility
2. Copy removeLCHistory.properties to <Windchill>, where <Windchill> is the location where Windchill is installed.
3. Open removeLCHistory.properties using a standard text editing program.
4. Specify values for the following parameters:
mode
Required?
Yes
Values
remove
report
Description
Use remove to remove the life cycle history of the objects of the specified type.
Use report to generate a report file that displays the number of objects of the specified type.
objectType
Required?
Yes
Values
Internal name of the objects type. For example:
wt.doc.WTDocument
Description
This parameter specifies the object type for which the life cycle history is reported or removed.
* 
This utility supports the following object types only: wt.doc.WTDocument, wt.change2.WTChangeOrder2, wt.change2.WTChangeActivity2.
state
Required?
Yes
Values
Life cycle state name of the object. For example:
state=RELEASED
Description
The current life cycle state of objects for which the life cycle history is reported or removed.
objectNumber
Required?
No
Values
Comma-separated list of object numbers. For example:
objectNumber=00021,00001,00018
Description
The object numbers of the objects for which the life cycle history is reported or removed.
versionOrRevision
Required?
No
Values
Comma-separated list of versions or revisions. For example:
versionOrRevision=A,B,C
Description
The version or revision of the objects for which the life cycle history is reported or removed.
organizationName
Required?
No
Values
Name of the organization. For example:
organizationName=Demo Organization
Description
Objects that exist in this organization are included in the report or has their life cycle history removed..
promotedBy
Required?
No
Values
Name of the participant. For example:
promotedBy=Administrator
Description
Objects promoted by this participant are included in the report or has their life cycle history removed.
promotedOnDate
Required?
No
Values
Date in the following format: MM-DD-YYYY
For example:
promotedOnDate=07-12-2015
Description
Objects promote on this date are included in the report or has their life cycle history removed.
chunkSize
Required?
No
Values
Integer value. For example:
chunkSize=10
Description
The number of objects the utility removes at a time. The default behavior is 100.
5. Save your changes.
6. Run the following command in a Windchill shell:
java wt.lifecycle.utility.RemoveLifeCycleHistory <AdminUserName> <AdminPassword>
Logs are generated in the <Windchill>\logs folder, using the following log name format:
-removeLCHistory-YYYY-MM-DD-HH-mm-ss.log