Managing Locks
Use
The Locking Adapter service establishes the interface between the AS Java and the Enqueue Server.
You can display and manage locks, carry out tests, and display statistics.
You can also use the Locking Adapter service to create and release locks. This function should only be used for test purposes.
Procedure
Managing Locks
The following describes how the Locking Adapter service is managed using the Visual Administrator.
Choose the Runtime tab to see a list of the functions offered in the Locking Adapter service:
● To display existing locks, choose Display Locks.
● To set and release locks, choose Create/Release Lock. The functions available here are described below.
● To delete existing locks, select the locks and choose Delete Selected Locks.
● To run test programs, choose Run Tests. To run functional or load tests, choose Execute Functional Tests, or Execute Load Tests, respectively).
You have to wait a while before the results of the test appear. During this time you receive no explicit indication that the test is running.
● To display files, choose View Files. You can view the profile data or the trace file of the lowest layer of the enqueue service. This is useful for debugging purposes. For more information, see Troubleshooting.
● To display statistics, choose Time Statistics.
Creating and Releasing Locks
...
1. In the Visual Administrator, open the Runtime tab of the Locking Adapter service.
2. Choose the Create / Release Lock tab.
3. Execute any of the following functions that are available:
Function |
Steps |
Lock |
... 1. Enter an owner, name of the lock, and the lock argument. 2. Choose the type of the lock from the Mode dropdown list box. 3. Choose Execute to set the lock. |
Unlock |
... 1. Enter an owner, name of the lock, and the lock argument. 2. Choose Execute to release the lock.
You can use Unlock function to decrease the cumulation counter of the lock by one. If the lock was not cumulated (cumulation counter is equal to 1), it will be released. |
Unlock all |
... 1. Enter the lock owner. 2. Choose Execute, to decrease the cumulation counter by one for all locks belonging to this owner. |
Unlock all counts |
Works like Unlock all, but here the cumulation counter is set to zero. The lock is released even if it has been cumulated several times. |
Unlock all with wildcards |
Works like Unlock all, but here you can use wildcards to specify the lock owner. One asterisk represents one letter only.
For example, there are locks for owner, owner1 and owner2. If you enter **ner* and choose Execute, all the locks for owner1 and owner2 are reset. |
To see the results of your operations, choose the Display Locks tab and then Refresh.
More Information
Owner
Concept