Real Time Information Director User Documentation

RTID Subscriptions
Hewlett-Packard Company 6 529618 - 002
The Subscription Store
The Subscription module maintains all registered subscriptions in a Subscription Store,
which is created during the Install process. The Subscription Store supports the
following operations:
• Inserting new subscriptions
• Browsing existing subscriptions
• Deleting existing subscriptions
Subscriptions are described using XML that conforms to the schema
$RTID_HOME/bin/SubServ.xsd. You use the RegSubs.sh program (located in
$RTID_HOME/bin) to load, browse, and delete subscriptions. A unique Subscription ID
identifies each registered subscription.
The Subscription Store is persistent. Once a subscription has been registered, it persists
across system failures and application restarts.
The Subscription Store is a NonStop SQL table in which each row corresponds to a
Subscription that has been registered with SubServ. This table is used to maintain the
information about the subscriptions registered with SubServ. Every time a new
subscription is registered, a row is added to this table, with a unique Subscription ID. For
every active subscription, an instance of SubServ subscribes to the Data Store and
generates messages that are then sent to the configured JMS Queue or Topic.
Table 2 describes the columns in the Subscription Store.
Column Name Description
SUBSCRIPTION_ID Unique numeric identifier for a subscription.
KEYVALUE Internal data used by SubServ.
DOCNAME Name of document that is being subscribed to. It must be
document for which there is a document definition, i.e.,
metadata, defined in your solution.
DESTINATION_NAME Name of the JMS Entity (Queue or Topic) that is the
destination of the subscription’s document.
DESTINATION_TYPE Type of the JMS Entity that is the destination of the
subscription’s document. This indicates whether the
destination is a Queue or a Topic.
SQLSTATEMENT The SQL statement that will be used to subscribe to the Data
Store.
STATUS_FLAG Internal data used by SubServ.
SYSTEM_UPDATE_DT Internal data used by SubServ.
Table 2. Subscription Store Description