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.
|
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