BPMProcessInstancesResumption command
Use this command to resume business process definition (BPD) instances that are in a suspended state on IBM® Process Center and IBM Process Server.
Using this command resumes a BPD instance and its associated
tasks based on the information specified by the command parameters.
Progress and other information is logged in a standard SystemOut.log
file.
Restriction: You cannot use this command to resume
BPD instances that belong to a Tip.
The BPMProcessInstancesResumption command
is run using the AdminTask object of the wsadmin scripting client.
Note: In
an environment with multiple security domains configured, use the
PALService MBean instead of this wsadmin command. See The Process Application LifeCycle (PAL) MBean.
Prerequisites
The following
conditions must be met:
- Run the command in the connected mode; that is, do not use the wsadmin -conntype none option.
- You can run the command from any cluster member in a network deployment environment. However, you must first establish the wsadmin session to the SOAP port of the cluster member from where you are running the command.
- To access the wsadmin command, the ID being used must have a WebSphere® Application Server role with more privileges than the monitor role. See Administrative roles for information about roles.
- To access the IBM BPM API used
by this command, the ID being used must belong to either the bpmAdminGroup
or bpmAuthorGroup. The default name for the bpmAdminGroup is tw_admins
and the default name for the bpmAuthorGroup is tw_authors. See IBM Business Process Manager default group types for information about groups.Tip: By default, only the DeAdmin user has both the WebSphere Application Server administrator role and membership in the bpmAdminGroup.
Location
Start the wsadmin scripting client from the install_root/bin directory.
Syntax
BPMProcessInstancesResumption
-containerAcronym process_application__or_toolkit_acronym
-containerSnapshotAcronym snapshot_acronym
[-maxNumberOfInstances n]
[-getNumberOfInstances]
Parameters
- -containerAcronym String
- A required parameter that identifies the process application (Process Server and Process Center) or toolkit acronym (Process Center only). For example, the BillingDispute process application might have an acronym of BILLDISP.
- -containerSnapshotAcronym String
- A required parameter that identifies the process application (Process
Server and Process Center) or toolkit snapshot acronym (Process Center
only).Tip: You can find the process application acronym on the snapshot page in Process Center or by using the BPMShowProcessApplication command.
- -maxNumberOfInstances Integer
- An optional parameter that limits the maximum number of instances to resume. If this parameter is not used, all suspended BPD instances of the specified context are resumed by default.
- -getNumberOfInstances
- This is an optional parameter that returns the suspended instances associated with the given context. This parameter and the -maxNumberOfInstances parameter are mutually exclusive.
Examples
In the following example, you first establish a SOAP connection to the server and then use the BPMProcessInstancesResumption command to resume a maximum of 500 suspended BPD instances in a snapshot of the BillingDispute process application. The snapshot is part of the Main track.
Important: In
a network deployment environment, use the port configured for the
application cluster member that runs the Process Server or Process Center applications.
To determine the correct port number, see the WebSphere administrative
console Ports collection page (click and find the value for SOAP_CONNECTOR_ADDRESS).
wsadmin -conntype SOAP -port 8880 -host ProcessCenterServer01.mycompany.com -user admin -password admin -lang jython
wsadmin>AdminTask.BPMProcessInstancesResumption('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -maxNumberOfInstances 500]')
This
example returns the number of suspended instances that are in the
specified snapshot of the process application or toolkit.
wsadmin>AdminTask.BPMProcessInstancesResumption('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -getNumberOfInstances]')