BPMCheckOrphanTokens command
Use the BPMCheckOrphanTokens command to detect the possibility of orphaned tokens before installing a new snapshot and identify whether to delete or move each token.
Purpose
The BPMCheckOrphanTokens command checks activities only. These include user tasks, system tasks, decision tasks, subprocesses, event subprocesses, linked processes, and nodes.
- Delete the token if it is no longer required in the new snapshot. (Default action)
- Move the token to another step in the process.
- Suspend the process so process instance data can be manipulated using Process Inspector.
In a network deployment environment, you must run this command on the node containing the application cluster member that handles Process Server applications. Do not run this command from the deployment manager profile.
Parameters
- -processAppAcronym processApp acronym
- A required parameter that identifies the process application that
is to be installed. For example, the BillingDispute process application
might have an acronym of BILLDISP.Tip: If you do not know the acronym for a required parameter, use the BPMShowProcessApplication command to list the details of a process application, including acronyms.
- -sourceSnapshotName snapshot name
- A required parameter that provides the snapshot name from which instances will be migrated (the old version).
- -targetSnapshotName snapshot name
- A required parameter that provides the snapshot name to which instances will be migrated (the new version).
- -outputFile file path
- A required parameter that provides the file path to the directory where the orphan token policy file will be generated and a name for that file.
- -overwrite
- An optional parameter that forces a replacement of an existing policy file with the new generated file.
Examples
The following examples illustrate how to establish a SOAP connection to the Process Center server and then generate an orphaned token policy file for a process application with acronym OTA.
Jython example
wsadmin -conntype SOAP -port 8880 -host ProcessCenterServer01.mycompany.com -user admin ID -password administrator password -lang jython AdminTask.BPMCheckOrphanTokens('[-processAppAcronym OTA -sourceSnapshotName "Version A" -targetSnapshotName "Version B" -outputFile C:\TokenPolicyFile_OTA.xml]')
JACL example
wsadmin -conntype SOAP -port 8880 -host ProcessCenterServer01.mycompany.com -user admin ID -password administrator password $AdminTask BPMCheckOrphanTokens {-processAppAcronym OTA -sourceSnapshotName "Version A" -targetSnapshotName "Version B" -outputFile C:\TokenPolicyFile_OTA.xml}