mqsibar command

• Windows
• Linux®
• AIX®
• IBM® z/OS® Container Extensions (zCX). Run this command by modifying and submitting the supplied JCL or by using an IBM z/OS console command.

You can use the mqsibar command to deploy a BAR file to an integration server, prior to starting it, by unpacking the contents directly into the integration server's run directory. You can also choose to compile the resources that the BAR file contains (including DFDL schema, XML schema, and graphical data maps), which reduces the time that it takes for the deployed application to start processing messages.

The run directory is created by the mqsicreateworkdir command, which you run when you are configuring the integration server. For more information, see Configuring an integration server by modifying the server.conf.yaml file and mqsicreateworkdir command.

You can use the mqsibar command in a script, as part of an automated process that might include commands to test, tune, deploy, and run the application, as an alternative to deploying through the toolkit or web user interface. This method can be particularly useful if you are running IBM App Connect Enterprise in a cloud container.

For more information about how to use the mqsibar command, see Deploying integration solutions to a production environment.

• You must specify the name of the input BAR file to be processed, by using the -a parameter.
• In addition to specifying the name of the input BAR file, you must specify one or more of the following output options:
  • The compile flag (-c parameter)
  • The integration server work directory (-w parameter). If you specify the -w parameter, you cannot also specify the -t parameter.
  • The path to the output BAR file, containing the updated content (-o parameter)
  • The directory path to be used for temporary files (-t parameter). If you specify the -t parameter, you cannot also specify the -w parameter.
• The BAR file that is processed by the mqsibar command must contain all referenced resources; for example, if an application in the BAR file references a library that is contained by a different BAR file, an error occurs. To avoid this situation, create a BAR file that contains all required shared libraries, before using it as input to the mqsibar command.
• You must start (or restart) the integration server after running the mqsibar command.

-a inputBar

(Required) This parameter specifies the name of the BAR file to be processed.

-c

(Optional) This parameter specifies that the runtime resources for XMLNSC/DFDL schema and graphical data maps will be compiled into binaries, ready to run when the application is deployed.

-w workpath

(Optional) This parameter specifies the integration server work directory, into which the contents of the integration BAR file will be unpacked; as a result of this step, the application is ready to run when the integration server starts (or restarts, if it has already started).

-o outputBar

(Optional) This parameter specifies the file path to the output BAR file, into which the updated content will be written.

-t tempDir

(Optional) This parameter specifies the directory path to be used for temporary files.

Always enter the command on a single line; in some examples, line breaks have been added to enhance readability.