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 BAR 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 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:
The command displays the version of the command
that is being run (either IBM Integration 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#notificationThresholdMsgsPerSec
simpleflow#maximumRateMsgsPerSec
simpleflow#wlmPolicy
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
This command is supplied as a batch
file. If you run the command in an automation system or from a script,
use the Windows CALL command
to ensure that the correct ERRORLEVEL is returned:
...
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