Skip Navigation Links | |
Exit Print View | |
Oracle Java CAPS JMS Reference Java CAPS Documentation |
Implementing JMS in Java CAPS Projects
To Implement JMS Following the Java CAPS Model
Creating and Configuring Message Destinations
Creating OTDs and Collaborations
Using the JMS OTD in Collaboration Definitions
Using JMS Messages in Collaboration Definitions
Database Configuration and Operation
Protected Concurrent Processing
Serial Processing Across a Destination Group
Message Redelivery and Redirection
Specifying Redelivery Options in the JMS IQ Manager
Specifying Redelivery Options in a JMS Client
Example of Producer Throttling and Unthrottling
Additional JMS Message Properties
requestReply(timeout, message)
requestReplyTo(message, destName)
requestReplyTo(timeout, message, destName)
send(message, deliveryMode, priority, timeToLive)
sendBytes(payload, deliveryMode, priority, timeToLive)
sendBytesTo(payload, destination)
sendBytesTo(payload, destination, deliveryMode, priority, timeToLive)
sendText(payload, deliveryMode, priority, timeToLive)
sendTextTo(payload, destination)
sendTextTo(payload, destination, deliveryMode, priority, timeToLive)
sendTo(message, destination, deliveryMode, priority, timeToLive)
retrieveBytesFromMessage(arg0)
retrieveStringFromMessage(arg0)
JMS IQ Manager Runtime Configuration
Accessing the Configuration Properties
Configuration Properties Interface
Journaling and Expiration Properties
Per-Destination Throttling Threshold
Overview of MS Control Utility Features
Message Destination (Queue) Examples
This topic contains procedures for performing selected tasks using the MS Control utility.
Note - If you are using a Logical Host/Domain with a name other than localhost, you must also specify the host name by including the -host flag with the host name. Likewise, if you are using a non-default port for the JMS IQ Manager, you must also specify the port by including the -port flag with the port number.
To change the contents (payload) of a message for a specified message destination, use the -changeqmsg (-cqm) or -changetmsg (-ctm) flag. You must specify whether the original message type is bytes or text. The example illustrates the procedure for a topic.
Note - The message cannot be processed while you are changing the contents.
stcmsctrlutil.exe -ctm topicname seqnumber -msgtype type
where topicname is the name of the topic that contains the message, seqnumber is the sequence number of the message, and type is either bytes or text indicating the message type of the original message.
This example creates an archive file containing all messages up to the date 09/11/2003 in the root backup path.
Before You Begin
Ensure that Journaling is enabled. For information, see Enable Journal.
stcmsctrlutil -backup journal-database-directory\backup\backup.zip "09/11/2003"
If successful, you will receive the following response:
Backup finished. Archived messages: 2003
By default, the root backup directory is:
journal-database-directory\backup
For example:
c:\JavaCAPS\backup\extract1
Example 1 Displaying a Topic List
As an example, use the following command syntax to display the topic list for the archive file:
stcmsctrlutil -ar c:\JavaCAPS\backup\extract1 -tl
You can then examine the individual topics further, as desired.
The MS Control Utility uses a default timeout period of five seconds for retrieving requested information, after which the utility exits and you see the message “Timeout to receive message from the server, exiting stcmsctrlutil API.” If this behavior should become a problem, you can include the -timeout flag with any command to set the MS Control utility's timeout period to a different value for that command only. Any command not including the -timeout flag uses the default value.
The example below sets the timeout period to 15 seconds, while obtaining a topic list from the journaler.
stcmsctrlutil -j -tl -timeout 15
stcmsctrlutil -shutdown