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

mqsirestorebroker command

Use the mqsirestorebroker command to restore the broker configuration from a backup file.

Supported platforms

Windows
Linux and UNIX systems
z/OS®. Run this command by customizing and submitting BIPRSBK; see Contents of the broker PDSE.

Purpose

The mqsirestorebroker command restores the broker configuration from a backup file that you have created by using the mqsibackupbroker command. You can restore a broker only on a computer that has an identical configuration; the operating system must be at the same level, and the broker and queue manager names must be identical.

Usage notes

The command restores the following persistent configuration data associated with the broker that is contained in the backup file:

Deployed resources; message flows, dictionaries, JAR files, and other runtime resources that you have previously deployed in a BAR file.
Integration servers.
Broker configuration; for example, configurable services.

Always stop the broker before you run this command. If you specify -c to restore common configuration data that is shared with other brokers, you must also stop all brokers with which this broker shares that data. If you run this command when a relevant broker is active, the results are unpredictable.

If the mqsibackupbroker command that created the backup file includes information about files that were locked when the backup was taken, and therefore cannot be backed up, the mqsirestorebroker command returns the names of the files affected.

Authorization

For information about platform-specific authorizations, see the following topics:

If you have enabled broker administration security, you must also set up the authority detailed in Tasks and authorizations for administration security.

Syntax


>>-mqsirestorebroker--brokerName-- -d -- directory ------------->

>-- -a -- archiveName --+------+--+-----------------------+----><
                        '- -c -'  '- -v -- traceFileName -'

Parameters

brokerName: (Required) The name of the broker that you want to restore. You must specify the name as the first parameter. If the name that you specify does not match the name of the broker associated with the backup file, the command fails.
-d directory: (Required) The directory in which the backup file is stored. The file must be stored in a file system that can be accessed by the computer on which you run this command.
-a archiveName: (Required) The name of the backup (archive) file.
-c: (Optional) Specify this parameter to restore all configuration data that is shared with other brokers on the same computer; for example, profiles.
-v traceFileName: (Optional) The location of a trace file that records details of the actions taken by the command.

Examples

The following example restores broker IB9NODE on Windows:

mqsirestorebroker IB9NODE -d C:\MQSI\BACKUP -a 20090101.zip

bn43010_.htm |

Last updated Friday, 21 July 2017