mqsirestoreconfigmgr command

Supported platforms

Purpose

This command restores a previously backed up Configuration Manager Archive.
Note:
  1. It must be run on the same machine as the Configuration Manager and the Configuration Manager must not be running.
  2. The command tries to stop the Configuration Manager if it is running before it attempts a backup restore.
  3. If you are recovering the Configuration Manager because the configuration repository is damaged, restore the repository from a previously successful backup version using the mqsirestoreconfigmgr command.
  4. If you plan to restore the Configuration Manager data repository onz/OS and the platform from which it was originally backed up was not z/OS, or the other way round, you need to copy the saved service.properties file to:
    <Configuration
    Manager directory>/components/<component name>/<directory name>/service.properties
    after running the mqsirestoreconfigmgr command.

Syntax

Windows platforms, Linux, and UNIX systems

z/OS

Parameters

configMgrName
(Required) The name of the Configuration Manager.
-d archiveDirectory
(Required) The directory where the archive is placed.
-a archiveName
(Required) Specifies the backup archive name.
-w workPath
(Optional) Specifies the path for the Configuration Manager repository.

Authorization

This command changes security privileges for the ServiceUserID; the user ID used to invoke this command must be a member of the Windows Administrators group on this local system.

Responses

This command returns the following responses:
  • BIP8056 Unknown queue manager

Examples

Related concepts
Configuration Manager