WebSphere Message Broker, Version 8.0.0.7
Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS
See information about the latest product version
See information about the latest product version
mqsireadbar command
Use the mqsireadbar command to read a deployable BAR file and identify its defined keywords.
Supported platforms
- Windows
- Linux and UNIX systems
- z/OS®. Run this command by customizing and submitting BIPRBAR.
Purpose
The mqsireadbar command returns the keywords that are defined for each deployable file in a deployable broker archive file.
Syntax
Parameters
- -b BarName
- (Required) The name of the BAR archive file to be read. The BAR file is in compressed format.
- -r
- (Optional) Run the command recursively. The contents of all applications and libraries are displayed, recursing into libraries inside applications.
- -v traceFileName
- (Optional) The name of the file to which the command trace is sent. This option activates an internal debug trace; specify this option only at the request of an IBM® service representative.
Authorization
On Windows 7 and Windows Server 2008 systems, the
user ID used to run this command must be running with elevated privileges
on the local system:
- The user ID must be a member of the group Administrators.
- The command must be started from an environment that has Run as Administrator authority.
If you do not run the command from a privileged environment, you are asked to confirm that you want to continue. When you click OK, a new privileged command console is created and the command completed, but all responses are written to the privileged environment and are lost when that console closes when the command completes.
On all platforms, the user ID that is used to start this command must have the authority to read the BAR file on the local system.
Responses
This command returns the following responses:
- 0
- The command completed successfully.
- 99
- One or more of the parameters that you specified is invalid.
The command displays the version of the command
that is being run (either WebSphere® Message Broker Toolkit or
runtime environment), before all other response data:
BIP1052I: Reading BAR File using runtime mqsireadbar
The command then displays a list of the deployable files,
together with their keywords. For example:
C:\test.bar
BAR Entry: simpleflow.cmf (07/10/07 10:43:44)
Author = Matt
VERSION = v1.1
Information = This flow simply removes messages from IN.Q
It also displays deployment descriptors
and the list of any properties in the BAR file that can be overridden,
together with the new values of any overrides that are currently applied.
For example:
Deployment descriptor:
simpleflow#additionalInstances
simpleflow#commitCount
simpleflow#commitInterval
simpleflow#coordinatedTransaction
simpleflow#consumerPolicySet
simpleflow#providerPolicySet
simpleflow#consumerPolicySetBindings
simpleflow#providerPolicySetBindings
simpleflow#securityProfileName
simpleflow#monitoringProfile
simpleflow#startMode
simpleflow#startInstancesWhenFlowStarts
simpleflow#MQ Input.queueName = IN1
simpleflow#MQ Input.serializationToken
simpleflow#MQ Input.topicProperty
simpleflow#MQ Input.resetBrowseTimeout
simpleflow#MQ Input.validateMaster
simpleflow#MQ Input.securityProfileName
simpleflow#MQ Input.componentLevel
simpleflow#MQ Input.additionalInstances
simpleflow#MQ Output.queueManagerName
simpleflow#MQ Output.queueName = OUT1
simpleflow#MQ Output.replyToQMgr
simpleflow#MQ Output.replyToQ
simpleflow#MQ Output.validateMaster
simpleflow#MQ Output.securityProfileName

...
CALL mqsireadbar
...
Examples
The following example reads the file my_bar_file.bar and
returns defined keywords from within the file:
mqsireadbar -b my_bar_file.bar
The following example reads
the file my_bar_file.bar and returns defined keywords
for all applications and libraries in the file, including libraries
inside applications:
mqsireadbar -b my_bar_file.bar -r