Stores Grid
The Stores grid presents persistence store definitions and their details. In edit mode, you can add and delete store definitions, and modify existing store definitions.
For consequences of modifying a store definition, see Persistence Modifications: Store and Durable.
Store Level
Column | JSON Attribute | Description |
---|---|---|
Store Name | name | Required.
Name of the store. Store names must be unique across all the clusters in the realm. All names are limited to maximum length of 256 characters. |
Persistence Cluster | Required.
Each store is a data structure, which must reside within a cluster of persistence servers. If you do not assign a persistence cluster, a validation error prevents deploying the realm definition. Select a persistence cluster from the drop-down menu. |
|
Publisher Mode | publisher_settings | This parameter governs communication among publisher send calls, the store, and the endpoint’s regular transports to produce different qualities of service. For complete details, see Publisher Mode. |
Replicated | replicated | When enabled, the cluster replicates the store across its persistence servers.
When disabled, the cluster does not replicate the store. Only one persistence server holds the store’s data. |
Store Size Limit | bytelimit | This parameter limits the volume of message data in the store. If publishing another message would exceed this limit, the store rejects that message.
Zero is a special value, indicating no limit. The store may grow until it exhausts available memory on any one of its servers. See Size Units Reference. |
Last Modified | This timestamp indicates the date and time of the most recent change to this store definition. |
Durable Level
The durable level presents the definitions of static durables and dynamic durable templates in the store.
Column | JSON Attribute | Description |
---|---|---|
Durable Name | name | Required.
Name of the static durable or dynamic durable template. (The name of an individual dynamic durable comes from subscriber create call, and not from administrative configuration.) Names must be unique within each persistence store. All names are limited to maximum length of 256 characters. |
Durable Type | type | Select the type of durable definition from the drop-down menu.
You may define either a static durable or a dynamic durable template of the following types:
For background information, see Durable Behavior. |
Acknowledgment | ack_settings | Select an acknowledgement mode from the drop-down menu.
This parameter applies only to standard and shared durables. When a subscriber finishes processing a message, the client library sends an acknowledgment to the durable. This interaction can be either Synchronous or Asynchronous. For complete details, see Acknowledgment Mode. |
Interest | interest | Message interest determines a stream of messages:
|
Key Field | key_field_name | Required. Applies only to static last-value durables.
Supply the name of the key field. The durable stores only the most recent message for each distinct value of that key field. Developers and administrators coordinate to determine the appropriate behavior (see TIBCO FTL Durable Coordination Form). When you set the durable type to static last-value, the GUI automatically sets this parameter value to the placeholder value default-key. You must explicitly change this placeholder to the actual key field name. |
Content Matcher Level
This level applies only to static durables, and only when the Interest column is Store Matching Messages.
Developers and administrators coordinate to determine the appropriate behavior (see TIBCO FTL Durable Coordination Form).
Adminstrators configure a content matcher at this level to implement that behavior. A content matcher can match one or more fields.
For background information, see Message Interest.