Attribute
|
Description
|
Range of Values
|
Default
|
Bytes Maximum
|
Maximum number of bytes that may be stored in the destination. A value of -1 specifies that there is no limit on the number of bytes that can be stored in the destination.
This attribute is dynamically configurable, but only incoming messages are impacted; stored messages are not impacted.
|
-1, 0 through 263 - 1, Greater than or equal to Bytes Threshold High
|
-1
|
Bytes Threshold High
|
Upper threshold value based on the number of bytes stored in the destination.
If the number of bytes exceeds this threshold—and if bytes paging is enabled and a paging store has been configured for the JMS Server—then destination-level bytes paging is started, and a message is logged on the server indicating a high threshold condition. A value of -1 specifies that destination bytes paging and threshold log messages are disabled for the destination.
This attribute is dynamically configurable, but only incoming messages are impacted; stored messages are not impacted.
Note: Bytes paging cannot be dynamically disabled by resetting the Bytes High Threshold to -1. To disable paging, you could set the Bytes High Threshold to a very large number (max is 263-1), so that paging would not be triggered.
|
-1, 0 through 263 - 1, Less than or equal to Bytes Maximum, >Bytes Threshold Low
|
-1
|
Bytes Threshold Low
|
Lower threshold value based on the number of bytes stored in the destination.
If the number of bytes falls below this threshold, then destination-level bytes paging is stopped (if paging is occurring), and a message is logged on the server indicating that the threshold condition has cleared. A value of -1 specifies that destination bytes paging and threshold log messages are disabled for the destination.
This attribute is dynamically configurable, but only incoming messages are impacted; stored messages are not impacted.
|
-1, 0 through 263 - 1, <Bytes Threshold High
|
-1
|
Bytes Paging Enabled
|
Flag for specifying whether or not bytes paging is enabled on the destination.
- If this attribute is set to False, then destination-level byte paging is explicitly disabled for this destination.
- If this attribute is set to True, a paging store has been configured for the JMS Server, and both the Bytes Threshold Low and Bytes Threshold High attribute values are greater than -1, then destination-level bytes paging is enabled for this destination.
- If this attribute is set to Default, then this value inherits the JMS template's value—if a JMS template is specified. If no template is configured for the destination, then the Default value is equivalent to False.
Note: If server-level bytes paging is enabled, and destination-level paging is disabled for a given destination, than messages on the destination can still be paged if server-level paging is started. However, when destination-level paging is disabled for a given destination, then the destination-level high thresholds will not force the destination to page out messages when they are exceeded.
|
String True False Default
|
Default
|
Messages Maximum
|
Maximum number of messages that may be stored in the destination. A value of -1 specifies that there is no limit on the number of messages that can be stored in the destination.
This attribute is dynamically configurable, but only incoming messages are impacted; stored messages are not impacted.
|
-1, 0 through 263 - 1, Greater than or equal to Bytes Threshold High
|
-1
|
Messages Threshold High
|
Upper threshold value based on the number of messages stored in the destination.
If the number of messages exceeds this threshold—and if messages paging is enabled and a paging store has been configured for the JMS Server—then destination-level paging is started, and a message is logged on the server indicating a high threshold condition. A value of -1 specifies that destination messages paging and threshold log messages are disabled for the destination.
This attribute is dynamically configurable, but only incoming messages are impacted; stored messages are not impacted.
Note: Messages paging cannot be dynamically disabled by resetting the Messages High Threshold to -1. To disable paging, you could set the Messages High Threshold to a very large number (max is 263-1), so that paging would not be triggered.
|
-1, 0 through 263 - 1, Less than or equal to Messages Maximum, >Messages Threshold Low
|
-1
|
Messages Threshold Low
|
Lower threshold value based on the number of messages stored in the destination.
If the number of messages falls below this threshold, then destination-level messages paging is stopped (if paging is occurring) and a message is logged on server, indicating that the threshold condition has cleared. A value of -1 specifies that destination messaes paging and threshold log messages are disabled for the destination.
This attribute is dynamically configurable, but only incoming messages are impacted; stored messages are not impacted.
|
-1, 0 through 263 - 1, <Messages Threshold High
|
-1
|
Messages Paging Enabled
|
Flag for specifying whether or not messages paging is enabled on the destination.
- If this attribute is set to False, then destination-level message paging is explicitly disabled for this destination.
- If this attribute is set to True, a paging store has been configured for the JMS Server, and both the Message Threshold Low and Message Threshold High attribute values are greater than -1, then destination-level messages paging is enabled for this destination.
- If this attribute is set to Default, then this value inherits the JMS template's value—if a JMS template is specified. If no template is configured for the destination, then the Default value is equivalent to False.
Note: If server-level messages paging is enabled, and destination-level paging is disabled for a given destination, than messages on the destination can still be paged if server-level paging is started. However, when destination-level paging is disabled for a given destination, then the destination-level high thresholds will not force the destination to page out messages when they are exceeded.
|
String True False Default
|
Default
|