This topic applies only to the IBM Business Process Manager Advanced configuration.

esAdmin command-line utility

Use the esAdmin command to list, unlock, or delete active and queued locks.

The esAdmin command can list and delete all locks currently managed by the lock manager. When listing locks, you can list all locks or a small subset that is filtered based on the module, component, or method. This command can also be used to release an active lock in a deadlock situation; after the lock is released, it is granted to the next queued request.

Syntax

esAdmin
-h hostName
-p soapPortNumber
-username username
-password password
method

Methods:
listAll
listLocks [moduleName] [componentName] [methodName]
deleteLocks [moduleName] 
unlock lockID

Parameters

hostName
Specifies the name of the server where the lock manager is running. The value must be a string. If no value is given, the default value localhost is used.
soapPortNumber
Specifies the port used for the connection to the server. The value must be an integer. If no value is given, the default value 8880 is used.
username
Specifies the user ID of a user with sufficient authority to process the changes. If no value is given, you are prompted to provide a user ID and password.
password
Specifies the password associated with the user ID specified in the -username variable. If no value is given, you are prompted to provide a user ID and password.
moduleName
Specifies the name of the module that contains the component using event sequencing.
Note: The esAdmin command searches for the module under "Application_Name" + "App". This naming convention is a restriction imposed by SCA.
componentName
Specifies the name of the component that is using event sequencing.
methodName
Specifies the name of the method on which event sequencing qualifiers have been set.
lockId
Specifies the numeric ID of the lock you want to release. The value for this parameter must be an integer.

Example

The following command returns a list of active and queued locks for the Order module:
esAdmin listLocks Order
The output is similar to the following:
Table 1. Sample output from esAdmin listLocks command
Lock Id Sequence Id Owner Id Module Component Method System Message Id
7564504 2 695376 Order OrderComp createOrder A09- 427BE_5002
7564504 3 232757 Order OrderComp createOrder ADF- 053RT_5004
The following command releases lock 754830988. This command assumes that the port number is 9060 (instead of the default 8880).
esAdmin -username administrator1 -password adminpassword -p 9060 unlock 754830988