IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

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


>>-mqsireadbar-- -b --BarName--+---------------------+---------->
                               '- -v --traceFileName-'   

>--+------+----------------------------------------------------><
   '- -r -'

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

an26160_.htm |

Last updated Friday, 21 July 2017