Specialized Administration > Working with Properties and Command Line Utilities > Life Cycle Command Line Utilities > Reassign Life Cycle Command Line Utility > Running the Reassign Life Cycle Utility
  
Running the Reassign Life Cycle Utility
Use the following procedure to run the Reassign Life Cycle command line utility:
1. Navigate to the following location:
<Windchill>/codebase/wt/lifecycle/utility/reassign
2. Copy LCReassignParams.properties to <Windchill>, where <Windchill> is the location where Windchill is installed.
3. Open LCReassignParams.properties using a standard text editing program.
4. Specify values for the following parameters:
mode
Required?
Yes
Values
reassign
report
Description
• Use reassign to reassign the objects of the specified type from the source life cycle template to the latest iteration of target life cycle template.
• Use report to generate a report of the number of objects using various templates.
For more information, see Reassign Life Cycle Command Line Utility.
containerOIDs
Required?
Yes
Values
Comma-separated list of contexts. For example:
containerOIDS = wt.pdmlink.PDMLinkProduct:1234, wt.pdmlink.PDMLinkProduct:5678
Description
This is the contexts for which you want to run the utility. The utility processes all of the specified contexts/containers in a single run.
* 
The comma-separated list cannot contain line breaks. Do not include spaces on either side of the colon character (:).
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 template information is reported on or reassigned. The internal name for an object is available from the Type and Attribute Management utility.
* 
Subtypes of the specified object type are not reassigned unless the includeSubType parameter is set to true.
includeSubType
Required?
No
Values
true
false
Description
Include subtypes of the object types specified in the objectType parameter. The default behavior is false.
sourceLC
Required?
Yes
Values
Name of source life cycle template.
Description
The source life cycle to be queried.
targetLC
Required?
Yes
Values
Name of target life cycle template.
Description
The target life cycle template to be queried.
For successful reassignment, the latest iteration of the target life cycle template should be available in the specified context.
runtime
Required?
Yes
Values
Utility run time in minutes.
Description
Specify the length of time to run the utility.
To run the utility for an unspecified amount of time (until all eligible objects are processed), set the runtime value as -1.
preserveState
Required?
Yes
Values
true
false
Description
Specify whether to preserve the current life cycle state after reassigning the objects to the target life cycle template.
• true—The life cycle state of the object is maintained after the object is reassigned, provided that the same state is available in the target life cycle template. If the life cycle state is not available, the object is not reassigned.
• false—The object is reassigned to the first life cycle state of the target life cycle template.
cleanup
Required?
Yes
Values
true
false
Description
Use this parameter to clean up data when reassigning an object from an advanced life cycle to a basic life cycle type.
• true—After reassigning an object from an advanced life cycle type to a basic life cycle type, references to the object are removed from the following tables:
RolePrincipalMap
WTAcIENTRY
Additionally, dangling team references from object iterations or workflow processes are removed and team instances themselves are deleted
• false—References to the object are not removed.
reassignObjectHavingProcessesStatus
Required?
Yes
Values
ALL
OPEN
CLOSED
Description
Determines whether to perform the reassign operation only when the associated process is in the specified status.
reassignObjectToTargetState
Required?
No
Values
Name of the target state. For example:
RELEASED
Description
Specify the target state for reassignment. The target state should be present at the target life cycle.
The default behavior is NULL.
* 
If this attribute is defined, the preserveState parameter is invalid.
reassignObjectWhenCurrentStateSameAsTarget
Required?
No
Values
true
false
Description
• true—The reassign operation is performed only if the object is currently in the same state as the target state specified by the reassignObjectToTargetState attribute.
This parameter is only valid if the reassignObjectToTargetState parameter is defined appropriately.
• false—The reassign operation is performed regardless of the current life cycle state of the object.
The default behavior is false.
reassignObjectWhenCurrentStateSameAsTarget
Required?
No
Values
true
false
Description
• true—Enable detailed logging.
• false—Log only essential events.
The default behavior is false.
intermediateReportInterval
Required?
No
Values
Interval in minutes.
Description
If a value is specified, this interval determines how often an intermediate progress report is logged. The value number specifies this interval in minutes. For example, a value of 10 indicates that every ten minutes, a progress report is logged.
The default value is 0, indicating that no intermediate reporting is logged.
5. Save your changes.
6. Run the following command in a Windchill shell:
java wt.lifecycle.utility.reassign.LCReassignUtility
* 
You are asked for authentication to run the utility.