Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# 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 `-1` disables the events for this SAF agent. Applies only to agents with sending capability. Updating `BytesThresholdHigh` affects 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.BytesThresholdHigh` Minimum value: `-1`
Bytes Threshold Low | The lower threshold that triggers events based on the number of bytes stored in the SAF agent. The default value of `-1` disables the events for this SAF agent. Applies only to agents with sending capability. Updating `BytesThresholdLow` affects 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 beging increasing their message flow. Range of Values: <= BytesThresholdHigh MBean Attribute: `SAFAgentMBean.BytesThresholdLow` Minimum value: `-1`
Messages Threshold High | The upper threshold that triggers events based on the number of messages stored in the SAF agent. The default value of `-1` disables the events for this SAF agent. Applies only to agents with sending capability. Updating `MessagesThresholdHigh` affects 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.MessagesThresholdHigh` Minimum value: `-1`
Messages Threshold Low | The low threshold that triggers events based on the number of messages stored in the SAF agent. The default value of `-1` disables the events for this SAF agent. Applies only to agents with sending capability. Updating `MessagesThresholdLow` affects 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.MessagesThresholdLow` Minimum value: `-1`
Bytes Maximum | The maximum bytes quota (total amount of bytes) that can be stored in this SAF agent. The default value of `-1` specifies 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 `BytesMaximum` affects only new requests. Range of Values: >= BytesThresholdHigh MBean Attribute: `SAFAgentMBean.BytesMaximum` Minimum value: `-1`
Messages Maximum | The maximum message quota (total amount of messages) that can be stored in this SAF agent. The default value of `-1` specifies 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.MessagesMaximum` Minimum value: `-1`
Maximum 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: `JMSCorrelationID` and `JMSType`. 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 `MaximumMessageSize` affects only incoming messages; stored messages are not affected. MBean Attribute: `SAFAgentMBean.MaximumMessageSize` Minimum value: `0`

Related Tasks

- Configure SAF agent thresholds and quotas

Related Topics

- Configuring and Managing WebLogic Store-and-Forward