ConstellationProperties (constellation 2.0.0 API)

java.lang.Object
- java.util.Dictionary<K,V>
- - java.util.Hashtable<java.lang.Object,java.lang.Object>
  - - java.util.Properties
    - - ibis.constellation.ConstellationProperties

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.util.Map<java.lang.Object,java.lang.Object>
```
public class ConstellationProperties
extends java.util.Properties
```
This class defines the properties that affect the behavior of constellation.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`boolean`	`CLOSED` Value of the "closed" property.
`boolean`	`DISTRIBUTED`
`static org.slf4j.Logger`	`logger`
`boolean`	`MASTER` Value of the "master" property.
`int`	`POOLSIZE` Value of the "closed" property.
`boolean`	`PROFILE`
`boolean`	`PROFILE_ACTIVITY`
`boolean`	`PROFILE_COMMUNICATION`
`java.lang.String`	`PROFILE_OUTPUT`
`boolean`	`PROFILE_STEAL`
`int`	`QUEUED_JOB_LIMIT` Value of the "queue.limit" property.
`int`	`REMOTESTEAL_SIZE` Value of the "steal.size" property.
`boolean`	`REMOTESTEAL_THROTTLE`
`int`	`REMOTESTEAL_TIMEOUT`
`static java.lang.String`	`S_CLOSED` The "closed" property is a boolean property indicating whether the current run is a closed run, that is, whether the total number of nodes involved is fixed.
`static java.lang.String`	`S_DISTRIBUTED` The "distributed" property is a boolean property instructing the `ConstellationFactory` whether to create a distributed constellation or not.
`static java.lang.String`	`S_MASTER` The "master" property is a boolean property indicating whether the current constellation instance is a candidate to be the master.
`static java.lang.String`	`S_POOLSIZE` The "poolSize" property is an integer property indicating the pool size if the current run is a closed run, that is, when the total number of nodes involved is fixed.
`static java.lang.String`	`S_PREFIX` All properties start with the prefix "ibis.constellation.".
`static java.lang.String`	`S_PROFILE` The "profile" property is a boolean property indicating whether constellation should provide some timing information.
`static java.lang.String`	`S_PROFILE_ACTIVITY` The "profile.activity" property is a boolean property indicating whether constellation should provide some timing information on the activity methods `Activity.cleanup(Constellation)`, `Activity.process(Constellation, Event)`, and `Activity.initialize(Constellation)`.
`static java.lang.String`	`S_PROFILE_COMMUNICATION` The "profile.communication" property is a boolean property indicating whether constellation should provide some timing information on steal or event messages.
`static java.lang.String`	`S_PROFILE_OUTPUT` The "profile.output" property is a string property indicating an output file to write profile info to.
`static java.lang.String`	`S_PROFILE_STEAL` The "profile.steal" property is a boolean property indicating whether constellation should provide some timing information on steals.
`static java.lang.String`	`S_QUEUED_JOB_LIMIT` When an executor spawns new activities, these new activities are initially added to queues that are local to this executor.
`static java.lang.String`	`S_REMOTESTEAL_SIZE` The "remotesteal.size" property is an integer property, specifying how many activities to try and steal on each steal attempt, for remote steals.
`static java.lang.String`	`S_REMOTESTEAL_THROTTLE` The "remotesteal.throttle" property is a boolean property indicating whether only one outstanding remote steal request per UnitExecutorContext is allowed.
`static java.lang.String`	`S_REMOTESTEAL_TIMEOUT` The "remotesteal.timeout" property is an integer property indicating the timeout for remote steal requests, in milliseconds.
`static java.lang.String`	`S_STATISTICS` The "printStatistics" property is a boolean property indicating whether some constellation statistics should be printed or not.
`static java.lang.String`	`S_STATISTICS_OUTPUT` The "statistics.output" property is a string property indicating an output file to write statistics to.
`static java.lang.String`	`S_STEAL_DELAY` The "steal.delay" property is an integer property, specifying the minimum time interval between failed steal attempts, in milliseconds.
`static java.lang.String`	`S_STEAL_IGNORE_EMPTY_REPLIES` The "steal.ignoreEmptyReplies" property is a boolean property determining whether empty steal replies should be given or not.
`static java.lang.String`	`S_STEAL_SIZE` The "steal.size" property is an integer property, specifying how many activities to try and steal on each steal attempt, for local steals.
`static java.lang.String`	`S_STEALSTRATEGY` The "stealing" property is a string property defining the steal strategy to use.
`boolean`	`STATISTICS`
`java.lang.String`	`STATISTICS_OUTPUT`
`int`	`STEAL_DELAY`
`boolean`	`STEAL_IGNORE_EMPTY_REPLIES` Value of the "steal.ignoreEmptyReplies" property.
`int`	`STEAL_SIZE` Value of the "steal.size" property.
`java.lang.String`	`STEALSTRATEGY`

Fields inherited from class java.util.Properties
defaults

Constructor Summary

Constructors
Constructor and Description
`ConstellationProperties()` Convenience constructor, using the system properties.
`ConstellationProperties(java.util.Properties p)` Creates a `ConstellationProperties` object using the specified properties.

Method Summary
- Methods inherited from class java.util.Properties
  getProperty, getProperty, list, list, load, load, loadFromXML, propertyNames, save, setProperty, store, store, storeToXML, storeToXML, stringPropertyNames
- Methods inherited from class java.util.Hashtable
  clear, clone, compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keys, keySet, merge, put, putAll, putIfAbsent, rehash, remove, remove, replace, replace, replaceAll, size, toString, values
- Methods inherited from class java.lang.Object
  finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - logger
```
public static final org.slf4j.Logger logger
```
  - S_PREFIX
```
public static final java.lang.String S_PREFIX
```
    All properties start with the prefix "ibis.constellation.".
    
    See Also:
    
    Constant Field Values
  - S_DISTRIBUTED
```
public static final java.lang.String S_DISTRIBUTED
```
    The "distributed" property is a boolean property instructing the ConstellationFactory whether to create a distributed constellation or not. The default is "true".
    
    See Also:
    
    Constant Field Values
  - DISTRIBUTED
```
public final boolean DISTRIBUTED
```
  - S_STEALSTRATEGY
```
public static final java.lang.String S_STEALSTRATEGY
```
    The "stealing" property is a string property defining the steal strategy to use. There are three:
    "pool" indicates: steal from anyone
    "mw" indicates: master-worker, so only steal from master
    "none" indicates: don't steal at all.
    The default value is: "pool".
    
    See Also:
    
    Constant Field Values
  - STEALSTRATEGY
```
public final java.lang.String STEALSTRATEGY
```
  - S_REMOTESTEAL_THROTTLE
```
public static final java.lang.String S_REMOTESTEAL_THROTTLE
```
    The "remotesteal.throttle" property is a boolean property indicating whether only one outstanding remote steal request per UnitExecutorContext is allowed. The default value is "false".
    
    See Also:
    
    Constant Field Values
  - REMOTESTEAL_THROTTLE
```
public final boolean REMOTESTEAL_THROTTLE
```
  - S_REMOTESTEAL_TIMEOUT
```
public static final java.lang.String S_REMOTESTEAL_TIMEOUT
```
    The "remotesteal.timeout" property is an integer property indicating the timeout for remote steal requests, in milliseconds. The default is "5000".
    
    See Also:
    
    Constant Field Values
  - REMOTESTEAL_TIMEOUT
```
public final int REMOTESTEAL_TIMEOUT
```
  - S_PROFILE
```
public static final java.lang.String S_PROFILE
```
    The "profile" property is a boolean property indicating whether constellation should provide some timing information. The default is "false".
    
    See Also:
    
    Constant Field Values
  - PROFILE
```
public final boolean PROFILE
```
  - S_PROFILE_COMMUNICATION
```
public static final java.lang.String S_PROFILE_COMMUNICATION
```
    The "profile.communication" property is a boolean property indicating whether constellation should provide some timing information on steal or event messages. The default is "false". Note: the overhead for this profiler can be large.
    
    See Also:
    
    Constant Field Values
  - PROFILE_COMMUNICATION
```
public final boolean PROFILE_COMMUNICATION
```
  - S_PROFILE_ACTIVITY
```
public static final java.lang.String S_PROFILE_ACTIVITY
```
    The "profile.activity" property is a boolean property indicating whether constellation should provide some timing information on the activity methods Activity.cleanup(Constellation), Activity.process(Constellation, Event), and Activity.initialize(Constellation). The default is "false".
    
    See Also:
    
    Constant Field Values
  - PROFILE_ACTIVITY
```
public final boolean PROFILE_ACTIVITY
```
  - S_PROFILE_STEAL
```
public static final java.lang.String S_PROFILE_STEAL
```
    The "profile.steal" property is a boolean property indicating whether constellation should provide some timing information on steals. The default is "false". Note: the overhead for this profiler can be large.
    
    See Also:
    
    Constant Field Values
  - PROFILE_STEAL
```
public final boolean PROFILE_STEAL
```
  - S_PROFILE_OUTPUT
```
public static final java.lang.String S_PROFILE_OUTPUT
```
    The "profile.output" property is a string property indicating an output file to write profile info to. If not specified (default), System.out is used.
    
    See Also:
    
    Constant Field Values
  - PROFILE_OUTPUT
```
public final java.lang.String PROFILE_OUTPUT
```
  - S_STATISTICS
```
public static final java.lang.String S_STATISTICS
```
    The "printStatistics" property is a boolean property indicating whether some constellation statistics should be printed or not. Default is "false". See also S_STATISTICS_OUTPUT.
    
    See Also:
    
    Constant Field Values
  - STATISTICS
```
public final boolean STATISTICS
```
  - S_STATISTICS_OUTPUT
```
public static final java.lang.String S_STATISTICS_OUTPUT
```
    The "statistics.output" property is a string property indicating an output file to write statistics to. If not specified (default), System.out is used.
    
    See Also:
    
    Constant Field Values
  - STATISTICS_OUTPUT
```
public final java.lang.String STATISTICS_OUTPUT
```
  - S_STEAL_DELAY
```
public static final java.lang.String S_STEAL_DELAY
```
    The "steal.delay" property is an integer property, specifying the minimum time interval between failed steal attempts, in milliseconds. The default is "20".
    
    See Also:
    
    Constant Field Values
  - STEAL_DELAY
```
public final int STEAL_DELAY
```
  - S_STEAL_SIZE
```
public static final java.lang.String S_STEAL_SIZE
```
    The "steal.size" property is an integer property, specifying how many activities to try and steal on each steal attempt, for local steals. The default is "1".
    
    See Also:
    
    Constant Field Values
  - S_REMOTESTEAL_SIZE
```
public static final java.lang.String S_REMOTESTEAL_SIZE
```
    The "remotesteal.size" property is an integer property, specifying how many activities to try and steal on each steal attempt, for remote steals. The default is "1".
    
    See Also:
    
    Constant Field Values
  - STEAL_SIZE
```
public final int STEAL_SIZE
```
    Value of the "steal.size" property.
  - REMOTESTEAL_SIZE
```
public final int REMOTESTEAL_SIZE
```
    Value of the "steal.size" property.
  - S_STEAL_IGNORE_EMPTY_REPLIES
```
public static final java.lang.String S_STEAL_IGNORE_EMPTY_REPLIES
```
    The "steal.ignoreEmptyReplies" property is a boolean property determining whether empty steal replies should be given or not. The default is "false".
    
    See Also:
    
    Constant Field Values
  - STEAL_IGNORE_EMPTY_REPLIES
```
public final boolean STEAL_IGNORE_EMPTY_REPLIES
```
    Value of the "steal.ignoreEmptyReplies" property.
  - S_CLOSED
```
public static final java.lang.String S_CLOSED
```
    The "closed" property is a boolean property indicating whether the current run is a closed run, that is, whether the total number of nodes involved is fixed. If true, the property "poolSize" should be set to the number of nodes.
    
    See Also:
    
    Constant Field Values
  - CLOSED
```
public final boolean CLOSED
```
    Value of the "closed" property.
  - S_POOLSIZE
```
public static final java.lang.String S_POOLSIZE
```
    The "poolSize" property is an integer property indicating the pool size if the current run is a closed run, that is, when the total number of nodes involved is fixed.
    
    See Also:
    
    Constant Field Values
  - POOLSIZE
```
public final int POOLSIZE
```
    Value of the "closed" property.
  - S_MASTER
```
public static final java.lang.String S_MASTER
```
    The "master" property is a boolean property indicating whether the current constellation instance is a candidate to be the master. At least one of the constellation instances should be. See Constellation.isMaster(). The default is "true". Note that only one constellation instance will actually become the master. For that instance, Constellation.isMaster() will return true, for the other instances it will return false.
    
    See Also:
    
    Constant Field Values
  - MASTER
```
public final boolean MASTER
```
    Value of the "master" property.
  - S_QUEUED_JOB_LIMIT
```
public static final java.lang.String S_QUEUED_JOB_LIMIT
```
    When an executor spawns new activities, these new activities are initially added to queues that are local to this executor. This makes them easily accessible for this executor, but not so easily accessible for other executors. The "queue.limit" property defines the maximum length of these local queues. When this limit is reached, new activities are pushed onto queues higher up in the system, making them more easily accessible for other executors. The default value is "100".
    
    See Also:
    
    Constant Field Values
  - QUEUED_JOB_LIMIT
```
public final int QUEUED_JOB_LIMIT
```
    Value of the "queue.limit" property.
- Constructor Detail
  - ConstellationProperties
```
public ConstellationProperties(java.util.Properties p)
```
    Creates a ConstellationProperties object using the specified properties.
    
    Parameters:
    
    p - the properties
  - ConstellationProperties
```
public ConstellationProperties()
```
    Convenience constructor, using the system properties.

Class ConstellationProperties

Field Summary

Fields inherited from class java.util.Properties

Constructor Summary

Method Summary

Methods inherited from class java.util.Properties

Methods inherited from class java.util.Hashtable

Methods inherited from class java.lang.Object

Field Detail

logger

S_PREFIX

S_DISTRIBUTED

DISTRIBUTED

S_STEALSTRATEGY

STEALSTRATEGY

S_REMOTESTEAL_THROTTLE

REMOTESTEAL_THROTTLE

S_REMOTESTEAL_TIMEOUT

REMOTESTEAL_TIMEOUT

S_PROFILE

PROFILE

S_PROFILE_COMMUNICATION

PROFILE_COMMUNICATION

S_PROFILE_ACTIVITY

PROFILE_ACTIVITY

S_PROFILE_STEAL

PROFILE_STEAL

S_PROFILE_OUTPUT

PROFILE_OUTPUT

S_STATISTICS

STATISTICS

S_STATISTICS_OUTPUT

STATISTICS_OUTPUT

S_STEAL_DELAY

STEAL_DELAY

S_STEAL_SIZE

S_REMOTESTEAL_SIZE

STEAL_SIZE

REMOTESTEAL_SIZE

S_STEAL_IGNORE_EMPTY_REPLIES

STEAL_IGNORE_EMPTY_REPLIES

S_CLOSED

CLOSED

S_POOLSIZE

POOLSIZE

S_MASTER

MASTER

S_QUEUED_JOB_LIMIT

QUEUED_JOB_LIMIT

Constructor Detail

ConstellationProperties

ConstellationProperties