esAdmin command

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

Purpose

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

Read syntax diagramSkip visual syntax diagram
                                                                        (1)   
>>-esAdmin----+-------------------------------------------------------+-----><
              | .-localhost---. .-8880----------.                     |       
              +-+--h hostName-+-+--p portNumber-+-method -| Methods |-+       
              +-------------------------------------------------------+       
              '- -help------------------------------------------------'       

Methods

|--+-listAll-------------------------------------------------------------------+--|
   +-listLocks -+-moduleName--------------------------+-deleteLocks moduleName-+   
   |            +-moduleName componentName------------+                        |   
   |            '-moduleName componentName methodName-'                        |   
   '-unlock lockId-------------------------------------------------------------'   

Notes:
  1. If security is enabled, you will be prompted to supply a user ID with sufficient authority to perform the changes.

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.
moduleName
Specifies the name of the module that contains the component using event sequencing.
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.

Examples

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 security is enabled and that the port number is 9060 (instead of the default 8880).
esAdmin -u administrator1 -p adminpassword -p 9060 unlock 754830988 

Last updated: Tue 24 Oct 2006 09:37:07

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)