Configuring a locking strategy in the ObjectGrid descriptor XML file

You can define an optimistic, a pessimistic, or no locking strategy on each BackingMap in the WebSphere® eXtreme Scale configuration. [Version 8.6 and later] [.net programming language only] For the backing maps that you are accessing from WebSphere eXtreme Scale Client for .NET, you must define a pessimistic locking strategy.

Before you begin

Decide which locking strategy you want to use. For more information, see Locking strategies.

About this task

You can configure each BackingMap instance to use one of the following locking strategies:

Optimistic locking mode (default)
Pessimistic locking mode (required for .NET applications)
None

Procedure

Configure a pessimistic locking strategy

With the lockStrategy attribute in the ObjectGrid descriptor XML file:

<?xml version="1.0" encoding="UTF-8"?>
<objectGridConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ibm.com/ws/objectgrid/config ../objectGrid.xsd"
    xmlns="http://ibm.com/ws/objectgrid/config">

    <objectGrids>
        <objectGrid name="test">
            <backingMap name="pessimisticMap"
                lockStrategy="PESSIMISTIC"/>
        </objectGrid>
    </objectGrids>
</objectGridConfig>

Configure an optimistic locking strategy

With the lockStrategy attribute in the ObjectGrid descriptor XML file:

<?xml version="1.0" encoding="UTF-8"?>
<objectGridConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ibm.com/ws/objectgrid/config ../objectGrid.xsd"
    xmlns="http://ibm.com/ws/objectgrid/config">
    <objectGrids>
        <objectGrid name="test">
            <backingMap name="optimisticMap"
                lockStrategy="OPTIMISTIC"/>
        </objectGrid>
    </objectGrids>
</objectGridConfig>

Configure a no locking strategy

With the lockStrategy attribute in the ObjectGrid descriptor XML file:

Note: BackingMaps that are configured to use a no locking strategy cannot participate in a multi-partition transaction.

<?xml version="1.0" encoding="UTF-8"?>
<objectGridConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ibm.com/ws/objectgrid/config ../objectGrid.xsd"
    xmlns="http://ibm.com/ws/objectgrid/config">

    <objectGrids>
        <objectGrid name="test">
            <backingMap name="noLockingMap"
                lockStrategy="NONE"/>
        </objectGrid>
    </objectGrids>
</objectGridConfig>