mqsideleteconfigmgr command

Supported platforms

Purpose

This command:
  • On the Windows platform, stops the service that runs the Configuration Manager.
  • Stops and deletes the WebSphere MQ queue manager for the Configuration Manager, if requested.
  • Removes the tables from the configuration repository, if requested.
  • Removes the record for the component in the broker registry.

Syntax

Windows

Linux and UNIX systems

z/OS

Parameters

configmgrName
(Optional - Windows. Required - Linux, UNIX systems, and z/OS) The name of the Configuration Manager that you want to delete.

On Linux, UNIX systems and z/OS, this must be the first parameter specified. It is case-sensitive on Linux, UNIX systems and z/OS.

The default name on Windows, if this parameter is not specified, is 'ConfigMgr'.

-q
(Optional - Windows platforms, Linux, and UNIX systems) Deletes the Configuration Manager's queue manager. (If this option is not specified, only the WebSphere Event Broker queues are deleted.)

If the queue manager hosts another component (a broker, or the User Name Server, or both) that still exists, this command fails.

-w
(Optional - Windows platforms, Linux, and UNIX systems) Deletes all files related to the Configuration Manager from the workpath.
-n
(Optional) Deletes the configuration repository.

Be very careful using this option. The configuration repository contains the configuration data for the whole broker domain, not just data internal to the Configuration Manager. Deleting this repository destroys all information pertinent to the broker domain, and requires you to recreate every resource within it to recover the broker domain.

If the configuration repository is not deleted as part of deleting the Configuration Manager, and the Configuration Manager is later recreated with the same name, it will continue to use the existing configuration repository.

If you do not specify –n to delete the configuration repository data, you can delete it manually later by locating the directory in which the configuration repository is stored and deleting the entire directory. This should be done with extreme caution as all domain information for the Configuration Manager is deleted. To delete the configuration repository manually:
  1. Locate the Configuration Manager’s working directory. The default location is:
    • For Windows, C:\Documents and Settings\All Users\Application Data\IBM\MQSI
    • For UNIX, /var/mqsi
    • For z/OS, ++COMPONENTDIRECTORY++
  2. Locate the components directory. Delete the directory with the same name as the Configuration Manager.
1
(Optional - z/OS only) The registry pass that deletes only the Configuration Manager registry.
2
(Optional - z/OS only) The WebSphere MQ pass that deletes only the Configuration Manager WebSphere MQ queues.
Note: This can be performed only if the Configuration Manager registry exists.

Responses

  • BIP8012 Unable to connect to system components
  • BIP8013 Component does not exist
  • BIP8017 Component cannot be deleted
  • BIP8018 Component running
  • BIP8038 Unsupported command option
  • BIP8048 Unable to start queue manager
  • BIP8049 Unable to stop queue manager
  • BIP8052 Unable to delete queue
  • BIP8055 Unable to load Java class
  • BIP8074 Unable to create JVM
  • BIP8075 Java exception
  • BIP8076 Unable to set current directory
  • BIP8077 Error initializing configuration data
  • BIP8078 Error initializing configuration data
  • BIP8082 Unable to delete queue manager
  • BIP8093 Queue manager being created
  • BIP8094 Queue manager stopping
  • BIP8095 Queue manager reserved
  • BIP8097 Unable to create Java object

Examples

mqsideleteconfigmgr CMGR01 -q
Related concepts
Configuration Manager