| |
Store-and-Forward Agents: Configuration: Thresholds & Quotas
Configuration Options Related Tasks Related Topics
Use this page to define the maximum message/byte quotas, the upper and lower message/byte thresholds, and the maximum allowable message size for this Store-and-Forward Agent.
Configuration Options
Name Description Bytes Threshold High The upper threshold value that triggers events based on the number of bytes stored in the SAF agent.
The default value of
-1disables the events for this SAF agent.Applies only to agents with sending capability.
Updating
BytesThresholdHighaffects only new requests.If the number of bytes exceeds this threshold, the triggered events are:
Log Messages: A message is logged on the server indicating a high threshold condition.
Flow Control: The agent becomes armed and instructs producers to begin decreasing their message flow.
Range of Values: <= BytesMaximum; >= BytesThresholdLow
MBean Attribute:
SAFAgentMBean.BytesThresholdHighMinimum value:
-1Bytes Threshold Low The lower threshold that triggers events based on the number of bytes stored in the SAF agent.
The default value of
-1disables the events for this SAF agent.Applies only to agents with sending capability.
Updating
BytesThresholdLowaffects only new requests.If the number of bytes falls below this threshold, the triggered events are:
Log Messages: A message is logged on the server indicating that the threshold condition has cleared.
Flow Control: The agent becomes disarmed and instructs producers to begin increasing their message flow.
Range of Values: <= BytesThresholdHigh
MBean Attribute:
SAFAgentMBean.BytesThresholdLowMinimum value:
-1Messages Threshold High The upper threshold that triggers events based on the number of messages stored in the SAF agent.
The default value of
-1disables the events for this SAF agent.Applies only to agents with sending capability.
Updating
MessagesThresholdHighaffects only new requests.If the number of messages exceeds this threshold, the triggered events are:
Log Messages: A message is logged on the server indicating a high threshold condition.
Flow Control: The agent becomes armed and instructs producers to begin decreasing their message flow.
Range of Values: <= MessagesMaximum; >= MessagesThresholdLow
MBean Attribute:
SAFAgentMBean.MessagesThresholdHighMinimum value:
-1Messages Threshold Low The low threshold that triggers events based on the number of messages stored in the SAF agent.
The default value of
-1disables the events for this SAF agent.Applies only to agents with sending capability.
Updating
MessagesThresholdLowaffects only new requests.If the number of messages falls below this threshold, the triggered events are:
Log Messages: A message is logged on the server indicating that the threshold condition has cleared.
Flow Control: The agent becomes disarmed and instructs producers to begin increasing their message flow.
Range of Values: <= MessagesThresholdHigh.
MBean Attribute:
SAFAgentMBean.MessagesThresholdLowMinimum value:
-1Bytes Maximum The maximum bytes quota (total amount of bytes) that can be stored in this SAF agent.
The default value of
-1specifies that there is no WebLogic-imposed limit on the number of bytes that can be stored. However, excessive bytes volume can cause memory saturation, so this value should correspond to the total amount of available system memory relative to the rest of your application load.Applies only to agents with sending capability.
Updating
BytesMaximumaffects only new requests.Range of Values: >= BytesThresholdHigh
MBean Attribute:
SAFAgentMBean.BytesMaximumMinimum value:
-1Messages Maximum The maximum message quota (total amount of messages) that can be stored in this SAF agent.
The default value of
-1specifies that the server instance has no limit on the number of messages that can be stored. However, excessive message volume can cause memory saturation, so this value should correspond to the total amount of available system memory relative to the rest of your application load.Applies only to sending agents.
Updating the maximum message quota resets the message count so that only requests arriving after the update are charged against the new quota.
Range of Values: >= MessagesThresholdHigh
MBean Attribute:
SAFAgentMBean.MessagesMaximumMinimum value:
-1Maximum Message Size The maximum number of bytes allowed in individual messages on this SAF agent.
The message size includes the message body, any user-defined properties, and the user-defined JMS header fields:
JMSCorrelationIDandJMSType.Producers sending messages that exceed the configured maximum message size for the SAF agent will receive a
ResourceAllocationException.The maximum message size is only enforced for the initial production of a message. Messages that are redirected to an error destination or forwarded to a member of a distributed destination are not checked for size. For instance, if a destination and its corresponding error destination are configured with a maximum message size of 128K bytes and 64K bytes, respectively, a message of 96K bytes could be redirected to the error destination (even though it exceeds the 64K byte maximum), but a producer could not directly send the 96K byte message to the error destination.
Applies only to agents with sending capability.
Updating
MaximumMessageSizeaffects only incoming messages; stored messages are not affected.MBean Attribute:
SAFAgentMBean.MaximumMessageSizeMinimum value:
0
|
