
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 OrderThe output is similar to the following:
| 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