com.bigdata.concurrent

Class TestLockManager.TestOptions

java.lang.Object

com.bigdata.concurrent.TestLockManager.TestOptions

Enclosing class:

TestLockManager

public static class TestLockManager.TestOptions
extends Object

Options for TestLockManager.doComparisonTest(Properties).

Version:

$Id$

Author:

Bryan Thompson

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_LOCK_TIMEOUT The default is no timeout for locks.
static String	DEFAULT_MAX_LOCK_TRIES The default is 1 try for locks.
static String	DEFAULT_PERCENT_TASK_DEATHS By default we do not force any tasks to die.
static String	DEFAULT_PREDECLARE_LOCKS By default the operations will predeclare their locks.
static String	DEFAULT_SORT_LOCK_REQUESTS By default lock requests will be sorted.
static String	DEFAULT_TIMEOUT The default is no timeout for the test.
static String	LOCK_TIMEOUT The timeout when attempting to acquire a lock (milliseconds) -or- 0 iff no timeout will be used.
static String	MAX_LOCK_TRIES The maximum #of times that a task will attempt to acquire its locks before failing.
static String	MAX_LOCKS The maximum #of locks that a task will seek to acquire.
static String	MIN_LOCKS The minimum #of locks that a task will seek to acquire.
static String	NRESOURCES The #of declared resources.
static String	NTASKS Total #of tasks to execute.
static String	NTHREADS The #of concurrent threads (multi-programming level).
static String	PERCENT_TASK_DEATH The percentage of tasks that will die a HorridTaskDeath in [0.0:1.0] (default is 0.0).
static String	PREDECLARE_LOCKS When true, operations MUST pre-declare their locks (default true).
static String	SORT_LOCK_REQUESTS When true, the resources in a lock request are sorted before the lock requests are issued (default true).
static String	TIMEOUT Maximum amount of time that the test will run (seconds).

Constructor Summary

Constructors

Constructor and Description
TestLockManager.TestOptions()

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TIMEOUT

public static final String TIMEOUT

Maximum amount of time that the test will run (seconds).

See Also:

Constant Field Values

NTHREADS

public static final String NTHREADS

The #of concurrent threads (multi-programming level).

See Also:

Constant Field Values

NTASKS

public static final String NTASKS

Total #of tasks to execute.

See Also:

Constant Field Values

PERCENT_TASK_DEATH

public static final String PERCENT_TASK_DEATH

The percentage of tasks that will die a HorridTaskDeath in [0.0:1.0] (default is 0.0). This is used to stress the error handling mechanisms.

See Also:

Constant Field Values

NRESOURCES

public static final String NRESOURCES

The #of declared resources.

See Also:

Constant Field Values

MIN_LOCKS

public static final String MIN_LOCKS

The minimum #of locks that a task will seek to acquire.

See Also:

Constant Field Values

MAX_LOCKS

public static final String MAX_LOCKS

The maximum #of locks that a task will seek to acquire.

See Also:

Constant Field Values

LOCK_TIMEOUT

public static final String LOCK_TIMEOUT

The timeout when attempting to acquire a lock (milliseconds) -or- 0 iff no timeout will be used.

See Also:

Constant Field Values

MAX_LOCK_TRIES

public static final String MAX_LOCK_TRIES

The maximum #of times that a task will attempt to acquire its locks before failing. Temporary failures may occur due to deadlock or timeout during lock acquisition. Such failures may be retried. The minimum value is ONE (1) since that means that we make only one attempt to obtain the necessary locks for the task.

See Also:

Constant Field Values

PREDECLARE_LOCKS

public static final String PREDECLARE_LOCKS

When true, operations MUST pre-declare their locks (default true).

Note: The LockManager uses this information to avoid deadlocks by the simple expediency of sorting the resources in each lock request into a common order. With this option deadlocks are NOT possible but all locks MUST be pre-declared by the operation before it begins to execute.

See Also:

Constant Field Values

SORT_LOCK_REQUESTS

public static final String SORT_LOCK_REQUESTS

When true, the resources in a lock request are sorted before the lock requests are issued (default true). This option is ONLY turned off for testing purposes. Since predeclaration plus sorting makes deadlocks impossible, this option MAY be turned off in order to exercise the deadlock detection logic in TxDag and the handling of deadlocks when they are detected.

See Also:

Constant Field Values

DEFAULT_TIMEOUT

public static final String DEFAULT_TIMEOUT

The default is no timeout for the test.

See Also:

Constant Field Values

DEFAULT_MAX_LOCK_TRIES

public static final String DEFAULT_MAX_LOCK_TRIES

The default is 1 try for locks.

See Also:

Constant Field Values

DEFAULT_LOCK_TIMEOUT

public static final String DEFAULT_LOCK_TIMEOUT

The default is no timeout for locks.

See Also:

Constant Field Values

DEFAULT_PERCENT_TASK_DEATHS

public static final String DEFAULT_PERCENT_TASK_DEATHS

By default we do not force any tasks to die.

See Also:

Constant Field Values

DEFAULT_PREDECLARE_LOCKS

public static final String DEFAULT_PREDECLARE_LOCKS

By default the operations will predeclare their locks.

See Also:

Constant Field Values

DEFAULT_SORT_LOCK_REQUESTS

public static final String DEFAULT_SORT_LOCK_REQUESTS

By default lock requests will be sorted.

See Also:

Constant Field Values

Constructor Detail

TestLockManager.TestOptions

public TestLockManager.TestOptions()