AbstractStressTestNonBlockingLockManager.TestOptions (Blazegraph Database Platform 2.1.5 API)

java.lang.Object
- com.bigdata.concurrent.AbstractStressTestNonBlockingLockManager.TestOptions

Enclosing class:

AbstractStressTestNonBlockingLockManager
```
public static class AbstractStressTestNonBlockingLockManager.TestOptions
extends Object
```
Options for AbstractStressTestNonBlockingLockManager.doComparisonTest(Properties).

Version:

$Id$

Author:

Bryan Thompson

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`CORE_POOL_SIZE` The core thread pool size.
`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_PRESTART_CORE_THREADS`
`static String`	`DEFAULT_SORT_LOCK_REQUESTS` By default lock requests will be sorted.
`static String`	`DEFAULT_SYNCHRONOUS_QUEUE`
`static String`	`DEFAULT_SYNCHRONOUS_QUEUE_FAIR`
`static String`	`DEFAULT_TASK_TIMEOUT` The default is no timeout for tasks.
`static String`	`DEFAULT_TIMEOUT` The default is no timeout for the test.
`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`	`MAX_POOL_SIZE` The #of concurrent threads (multi-programming level).
`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`	`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`	`PRESTART_CORE_THREADS` When `true` the core thread pool will be prestarted when the `ThreadPoolExecutor` is created.
`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`	`SYNCHRONOUS_QUEUE` Boolean option determines whether a `SynchronousQueue` or an unbounded queue will be used for the work queue of the `ThreadPoolExecutor` consuming the ready tasks (default is "false").
`static String`	`SYNCHRONOUS_QUEUE_FAIR` When using a `SynchronousQueue` for the `ThreadPoolExecutor`'s work queue, this boolean property specifies whether or not the `SynchronousQueue` will be fair, which is a ctor property for `SynchronousQueue`.
`static String`	`TASK_TIMEOUT` The timeout for the task in (milliseconds) -or- `0` iff no timeout will be used.
`static String`	`TIMEOUT` Maximum amount of time that the test will run (seconds) or ZERO (0) if there is no timeout.

Constructor Summary

Constructors
Constructor and Description

AbstractStressTestNonBlockingLockManager.TestOptions()

Constructors
Constructor and Description
`AbstractStressTestNonBlockingLockManager.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) or ZERO (0) if there is no timeout.
    
    See Also:
    Constant Field Values
  - SYNCHRONOUS_QUEUE
```
public static final String SYNCHRONOUS_QUEUE
```
    Boolean option determines whether a SynchronousQueue or an unbounded queue will be used for the work queue of the ThreadPoolExecutor consuming the ready tasks (default is "false").
    Note: The ThreadPoolExecutor must not block when we submit a Runnable to it from NonBlockingLockManagerWithNewDesign.ready(Runnable). This goal can be achieved either by having a SynchronousQueue and an unbounded MAX_POOL_SIZE -or- by using an unbounded work queue. In the former case new Threads will be created on demand. In the latter can tasks will be queued until the CORE_POOL_SIZE threads can process them.
    
    See Also:
    ThreadPoolExecutor, Constant Field Values
  - SYNCHRONOUS_QUEUE_FAIR
```
public static final String SYNCHRONOUS_QUEUE_FAIR
```
    When using a SynchronousQueue for the ThreadPoolExecutor's work queue, this boolean property specifies whether or not the SynchronousQueue will be fair, which is a ctor property for SynchronousQueue.
    
    See Also:
    Constant Field Values
  - CORE_POOL_SIZE
```
public static final String CORE_POOL_SIZE
```
    The core thread pool size.
    
    See Also:
    Constant Field Values
  - MAX_POOL_SIZE
```
public static final String MAX_POOL_SIZE
```
    The #of concurrent threads (multi-programming level). This must be GTE to CORE_POOL_SIZE. The default value is whatever was specified for CORE_POOL_SIZE. The value is ignored if you specify SYNCHRONOUS_QUEUE as true and an unbounded thread pool is used instead.
    
    See Also:
    Constant Field Values
  - PRESTART_CORE_THREADS
```
public static final String PRESTART_CORE_THREADS
```
    When true the core thread pool will be prestarted when the ThreadPoolExecutor is created.
    
    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
  - TASK_TIMEOUT
```
public static final String TASK_TIMEOUT
```
    The timeout for the task in (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 NonBlockingLockManager 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_SYNCHRONOUS_QUEUE
```
public static final String DEFAULT_SYNCHRONOUS_QUEUE
```
    See Also:
    Constant Field Values
  - DEFAULT_SYNCHRONOUS_QUEUE_FAIR
```
public static final String DEFAULT_SYNCHRONOUS_QUEUE_FAIR
```
    See Also:
    Constant Field Values
  - DEFAULT_PRESTART_CORE_THREADS
```
public static final String DEFAULT_PRESTART_CORE_THREADS
```
    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_TASK_TIMEOUT
```
public static final String DEFAULT_TASK_TIMEOUT
```
    The default is no timeout for tasks.
    
    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
  - AbstractStressTestNonBlockingLockManager.TestOptions
```
public AbstractStressTestNonBlockingLockManager.TestOptions()
```

Class AbstractStressTestNonBlockingLockManager.TestOptions

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TIMEOUT

SYNCHRONOUS_QUEUE

SYNCHRONOUS_QUEUE_FAIR

CORE_POOL_SIZE

MAX_POOL_SIZE

PRESTART_CORE_THREADS

NTASKS

PERCENT_TASK_DEATH

NRESOURCES

MIN_LOCKS

MAX_LOCKS

TASK_TIMEOUT

MAX_LOCK_TRIES

PREDECLARE_LOCKS

SORT_LOCK_REQUESTS

DEFAULT_TIMEOUT

DEFAULT_SYNCHRONOUS_QUEUE

DEFAULT_SYNCHRONOUS_QUEUE_FAIR

DEFAULT_PRESTART_CORE_THREADS

DEFAULT_MAX_LOCK_TRIES

DEFAULT_TASK_TIMEOUT

DEFAULT_PERCENT_TASK_DEATHS

DEFAULT_PREDECLARE_LOCKS

DEFAULT_SORT_LOCK_REQUESTS

Constructor Detail

AbstractStressTestNonBlockingLockManager.TestOptions