WebSphere Message Brokers
File: af03900_
Writer: John Morris-Smith

Task topic

This build: July 31, 2007 21:29:19

Editing configurable properties

You can edit the configurable properties of your broker archive (bar) file deployment descriptor.

Before you start:

If you have not already created a bar file, create it now.

You can edit configurable properties in two ways:

Using the Message Broker Toolkit

Follow these steps to edit properties using the Message Broker Toolkit:

  1. Switch to the Broker Administration perspective.
  2. Select the Configure tab at the bottom of the Content editor pane. The properties that you can configure are listed.
  3. Click the property for which you want to edit the value. The values that can be edited are displayed.
  4. Replace the current value with the new value.
  5. Save your bar file.

Using the mqsiapplybaroverride command

Follow these steps to edit properties using the mqsiapplybaroverride command:

  1. Open a command window that is configured for your environment.
  2. Create a text file (with a .properties file extension) following the format in the Example that follows.
  3. Enter the command, typed on a single line, specifying the location of your bar deployment descriptor (typically broker.xml) and the file that contains the properties to be changed:
    mqsiapplybaroverride -b barname -p propertiesnames
    A file with a .bar extension is created.

Example

In this example, the bar deployment descriptor file contains the following information, with elements that are to be changed are highlighted:

<?xml version="1.0" encoding="UTF-8"?>
<Broker>
   <CompiledMessageFlow name="sampleFlow">
      <ConfigurableProperty uri="sampleFlow#additionalInstances" />
      <ConfigurableProperty uri="sampleFlow#commitCount" />
      <ConfigurableProperty uri="sampleFlow#commitInterval" />
      <ConfigurableProperty uri="sampleFlow#coordinatedTransaction" />
      <ConfigurableProperty override="LOCAL_QUEUE_MGR"
         uri="sampleFlow#MQOutput.queueManagerName" />
      <ConfigurableProperty override="INPUT_QUEUE"
         uri="sampleFlow#MQInput.queueName" />
      <ConfigurableProperty override="REPLY_TO_QUEUE1"
         uri="sampleFlow#MQOutput.replyToQ" />
      <ConfigurableProperty uri="sampleFlow#MQInput.topicProperty" />
      <ConfigurableProperty uri="sampleFlow#MQOutput.replyToQMgr" />
      <ConfigurableProperty uri="sampleFlow#MQInput.validateMaster" />
      <ConfigurableProperty
         uri="sampleFlow#MQInput.serializationToken" />
      <ConfigurableProperty uri="sampleFlow#MQOutput.validateMaster" />
      <ConfigurableProperty override="OUTPUT_QUEUE"
         uri="sampleFlow#MQOutput.queueName" />
   </CompiledMessageFlow>
</Broker>

Run the mqsiapplybaroverride command, specifying a property file that contains this information. This is the file that you created in step 2 (the first line is a comment):

#Old Value in broker.xml = New Value in broker.xml
LOCAL_QUEUE_MGR = UnitTestQmgr
INPUT_QUEUE = UnitTestInQueue1
REPLY_TO_QUEUE1 =
OUTPUT_QUEUE = unitTestOutQueue1

When the command completes, the bar deployment descriptor is modified to:

<?xml version="1.0" encoding="UTF-8"?>
<Broker>
   <CompiledMessageFlow name="sampleFlow">
      <ConfigurableProperty uri="sampleFlow#additionalInstances" />
      <ConfigurableProperty uri="sampleFlow#commitCount" />
      <ConfigurableProperty uri="sampleFlow#commitInterval" />
      <ConfigurableProperty uri="sampleFlow#coordinatedTransaction" />
      <ConfigurableProperty override="UnitTestQmgr"
         uri="sampleFlow#MQOutput.queueManagerName" />
      <ConfigurableProperty override="UnitTestInQueue1"
         uri="sampleFlow#MQInput.queueName" />
			<ConfigurableProperty uri="sampleFlow#MQOutput.replyToQ" />
      <ConfigurableProperty uri="sampleFlow#MQInput.topicProperty" />
      <ConfigurableProperty uri="sampleFlow#MQOutput.replyToQMgr" />
      <ConfigurableProperty uri="sampleFlow#MQInput.validateMaster" />
      <ConfigurableProperty
         uri="sampleFlow#MQInput.serializationToken" />
      <ConfigurableProperty uri="sampleFlow#MQOutput.validateMaster" />
      <ConfigurableProperty override="UnitTestOutQueue1"
         uri="sampleFlow#MQOutput.queueName" />
   </CompiledMessageFlow>
</Broker>

In this example, REPLY_TO_QUEUE1 is not set, because no replacement value was set in the properties file.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:29:19

af03900_ This topic's URL is: