test

Java CAPS JMS Reference

Message Destination (Topic) Examples

Example 1–8 Displaying an Active Topic List

Command:


stcmsctrlutil -host localhost -port 24055 -topiclist

Response:


Topic List:
    SeeBeyond.MS.Control
    Broadcast
    STCTemporaryTopic.2.1
Example 1–9 Displaying a Journaled Topic List

Command:


stcmsctrlutil -j -tl

Response:


Number Of Topic(s): 1
Topic List:
        T0
Example 1–10 Displaying an Archived Topic List

This example displays the topic list for the archive file that has been extracted to the specified directory.

Command:


stcmsctrlutil -ar archive-file-extract-directory -tl

Response:


Number Of Topic(s): 1
Topic List:
        T0
Example 1–11 Displaying Active Topic Status

This example displays the current status of the topic Broadcast.

Command:


stcmsctrlutil -host localhost -port 18007 -topicstat Broadcast

Response:


Topic Name: Broadcast
First enqueue time: 05172001:16:30:30
Last enqueue time: 05172001:16:30:42
Number of current subscribers: 0
Number of total subscribers: 2
Message count: 6
Min Sequence Number: 0
Max Sequence Number: 3
Suspended: No

The Suspended entry shows whether topic is suspended and all subscribers stop receiving messages. The status usually is No. After the JMS IQ Manager restarts, all topics show Suspended: No status.

The enqueue times and sequence numbers are described in Enqueued Message Properties.

Example 1–12 Displaying Archived Topic Status

This example displays information about topic T0, in the archive file that has been extracted to the specified directory.

Command:


stcmsctrlutil -ar archive-file-extract-directory -ts T0

Response:


Topic Name: T0
First sequence number: 0
Last sequence number: 1000
First enqueue time: 09122003:00:14:17
Last enqueue time: 09122003:00:14:00
Number of current subscribers: 0
Number of total subscribers: 0
Message count: 1001
Lowest subscriber sequence: 0
Highest subscriber sequence: 0
Example 1–13 Displaying Properties of All Subscribers to All Topics

Command:


stcmsctrlutil -host localhost -port 24055 -sublistall

Response:


Number Of Subscriber(s): 4
Subscriber name: NonDurable1
        Client ID:
        Topic name: SeeBeyond.MS.Control
        Committed sequence: 0
        High sequence: 0
Subscriber name: subscriber1
        Client ID: Client
        Topic name: Broadcast
        Committed sequence: 0
        High sequence: 3
Subscriber name: subscriber2
        Client ID: Client
        Topic name: Broadcast
        Committed sequence: 3
        High sequence: 6
Subscriber name: NonDurable2
        Client ID:
        Topic name: STCTemporaryTopic.2.1
        Committed sequence: 0
        High sequence: 0
Example 1–14 Displaying Properties of All Subscribers to a Specific Topic

Command:


stcmsctrlutil -host localhost -port 24055 -sublistfortopic STC

Response:


Number Of Subscriber(s): 2
Subscriber name: subscriber1
        Client ID: Client
        Topic name: STC
        Committed sequence: 0
        High sequence: 3
Subscriber name: subscriber2
        Client ID: Client
        Topic name: STC
        Committed sequence: 3
        High sequence: 6