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, before continuing.

There are two ways of editing configurable properties:

Using the Message Brokers Toolkit

Follow these steps to edit properties using the Message Brokers 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.
Start of change

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 below.
  3. Enter the command, typed on a single line, specifying the location of your bar deployment descriptor (typically broker.xml) and the file containing 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 (elements 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>

The mqsiapplybaroverride command is run, specifying a property file containing this information (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_QUEUE =
OUTPUT_QUEUE = unitTestOutQueue1

As a consequence, 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>

Note that in this example, REPLY_TO_QUEUE is unset as no replacement value was set in the properties file.

End of change