Advanced Queuing - Oracle

Creating a Remote Subscriber for Topics of JMS Messages
Purpose
Create a remote subscriber for topics of jms messages without selector.
Usage Notes
AQ allows topics to have remote subscribers, for example, subscribers at other
topics in the same or different database. In order to use remote subscribers, you
must set up propagation between the local and remote topic.
Remote subscribers may be a specific consumer at the remote topic or all
subscribers at the remote topic. A remote subscriber is defined using the
AQjmsAgent structure. An AQjmsAgent consists of a name and address. The name
refers to the consumer_name at the remote topic. The address refers to the remote
topic - the syntax is (schema).(topic_name)[@dblink].
a) To publish messages to a particular consumer at the remote topic, the
subscription_name of the recipient at the remote topic must be specified in the
name field of AQjmsAgent. The remote topic must be specified in the address field
of AQjmsAgent
b) To publish messages to all subscribers of the remote topic, the name field of
AQjmsAgent must be set to null. The remote topic must be specified in the address
field of AQjmsAgent
A message selector can also be specified. Only messages that satisfy the selector are
delivered to the remote subscriber. The message selector can be null. The syntax for
the selector is the same as that for createDurableSubscriber. The selector can be null.
Syntax
Java (JDBC): Oracle9i Supplied Java Packages Reference oracle.jms,
AQjmsSession.createRemoteSubscriber
Example
TopicConnectionFactory tc_fact = null;
TopicConnection t_conn = null;
TopicSession t_sess = null;
TopicSession jms_sess;
TopicSubscriber subscriber1;
Topic shipped_orders;
int my[port = 5521;
AQjmsAgent remoteAgent;
/* create connection and session */
JMS Operational Interface: Basic Operations (Publish-Subscribe) 15-35