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:

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 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