mqsirestorebroker command

Supported platforms

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

Purpose

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

Usage notes

The command restores the following persistent configuration data associated with the integration node 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.
Integration node configuration; for example, configurable services.

Always stop the integration node before you run this command. If you specify -c to restore common configuration data that is shared with other integration nodes, you must also stop all integration nodes with which this integration node shares that data. If you run this command when a relevant integration node 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 integration node administration security, you must also set up the authority that is detailed in Tasks and authorizations for administration security.

Syntax

Parameters

integrationNodeName: (Required) The name of the integration node 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 integration node 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 integration nodes 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 integration node IBNODE on Windows:

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