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

Reference topic

This build: July 31, 2007 21:33:48

mqsiapplybaroverride command

Supported platforms

  • Windows
  • Start of changeLinux and UNIX systemsEnd of change
  • Start of changez/OS. Run this command by customizing and submitting BIPOBAR.End of change

Purpose

With the mqsiapplybaroverride command, you can replace configurable values in the broker archive (bar) deployment descriptor with new values that you specify in a properties file.

Write scripts to create broker archive files and apply different override values in the broker deployment descriptor archive file using the mqsiapplybaroverride command, together with the mqsicreatebar command.

Syntax

Parameters

-b BarFile
Start of change(Required) The path to the broker archive file (in compressed format) to which the override values apply. The path can be absolute or relative to the executable command.End of change
Start of change-p overridesFileEnd of change
Start of change(Optional) The path to one of the following:
  • A broker archive containing the deployment descriptor that will be used to apply overrides to the BAR file.
  • A properties file in which each line contains a property-name=override or current-property-value=new-property-value pair.
  • A deployment descriptor that is used to apply overrides to the BAR file.
End of change
Start of change-m manualOverridesEnd of change
Start of change(Optional) A list of the property-name=override pairs, current-property-value=override pairs, or a combination of them, to be applied to the BAR file. The pairs in the list are separated by colons (:). On Windows, the list must be enclosed by double quotes (" "). If used in conjunction with the overridesFile (-p) parameter, overrides specified by the manualOverrides (-m) parameter are performed after any overrides specified the -p parameter have been made. End of change
Start of change-o outputFileEnd of change
Start of change(Optional) The name of the output BAR file to which the BAR file changes are to be made. If an output file is not specified, the input file is overwritten.End of change
Start of change-vtraceFileNameEnd of change
Start of change(Optional) Specifies that the internal trace is to be sent to the named file.End of change

In all cases, any existing deployment descriptor in the BAR file is renamed to META-INF\broker.xml.old, replacing any existing file of that name.

Each override that is specified in a –p overrides file or a –m overrides list must conform to one of the following syntaxes:
  • FlowName#NodeName.PropertyName=NewPropertyValue (for message flow properties, FlowName#PropertyName=NewPropertyValue ) where:
    • FlowName is the name of the Flow without any cmf extension (for example, Flow1)
    • NodeName is the optional name of the node whose property is overridden (for example, InputNode)
    • PropertyName is the name of the property being overridden (for example, queueName)
    • NewPropertyValue is the value to assign to that property (for example, PRODUCTION_QUEUE_NAME).
  • OldPropertyValue=NewPropertyValue. This does a global search and replace on the property value OldPropertyValue. It overrides the value fields of OldPropertyValue in the deployment descriptor with NewPropertyValue.
  • FlowName#NodeName.PropertyName (for message flow properties, FlowName#PropertyName). This removes any override applied to the property of the supplied name.

Authorization

On Windows, the user ID used to invoke this command must have Administrator authority on the local system. On Linux, your user ID must have write access to the -data (workspace) and -b (bar file location) directories.

Examples

This example opens the bar file myflow.bar and replaces configurable values in its deployment descriptor (typically broker.xml) with those specified in the properties file mychanges.properties.
mqsiapplybaroverride  -b myflow.bar -p mychanges.properties 
For an example of the details that are contained in a properties file, see Editing configurable properties.
Notices | Trademarks | Downloads | Library | Support | Feedback

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

an19545_ This topic's URL is: