Home

 

Uninstalling a WebSphere MQ client

This section describes how to uninstall (remove) a WebSphere MQ client if you installed it using the WebSphere MQ Client CD.

We can uninstall (remove) WebSphere MQ client in attended mode or unattended (silent) mode.

Before you uninstall WebSphere MQ client, ensure that there are no WebSphere MQ client programs running.

 

Uninstalling WebSphere MQ client from Windows

There are three ways to uninstall WebSphere MQ from your machine:

• Start the installation process, then select the appropriate option.

• Use the Add/Remove Programs facility in the Windows Control Panel.

• Perform a removal from the command line.

We can use these methods to uninstall the WebSphere MQ client, as long as the original installation used the WebSphere MQ Client CD.

We can also uninstall WebSphere MQ client by using the appropriate parameters with advanced installation methods, or by using Microsoft System Management Server (SMS). See Advanced installation methods.

Uninstalling WebSphere MQ client using the installation process

This procedure uninstalls WebSphere MQ from your machine in attended mode. It removes all the currently installed features.

1. Insert WebSphere MQ Client CD 5 into the CD drive.

2. If autorun is installed, the installation process starts.

   Otherwise, double-click the Setup icon in the root folder of the CD to start the installation process.

   The Program Maintenance panel is displayed.

   If this panel is not displayed, WebSphere MQ for Windows, V6.0 is not installed on this machine.

3. Select Remove, then click Next.

4. The Remove WebSphere MQ panel is displayed, with a summary of the installation to be removed.

   Click Remove to continue.

5. The Removing WebSphere MQ panel is displayed.

   Wait for the progress bar to complete.

   If there are any messages that state that locked files are found, ensure that there are no WebSphere MQ client programs running.

   Uninstallation should then continue.

6. The WebSphere MQ Setup window displays the following message:

   Uninstallation Completed Successfully

   Click Finish.

Uninstalling WebSphere MQ client using Add/Remove Programs

1. From the Windows task bar, select Start-> Settings-> Control Panel.

2. Select Add/Remove Programs.

3. Select IBM WebSphere MQ.

4. Do one of the following:

   • Select Remove. When a confirmation prompt is displayed, select Yes.

     The uninstall program begins. All the WebSphere MQ files are removed.

   • Select Change. The WebSphere MQ Setup window with the Program Maintenance panel is displayed. Follow the procedure for uninstalling WebSphere MQ using the process from step 3 to the end.

Uninstalling WebSphere MQ client using the command line

This procedure can be used for removing the WebSphere MQ files in unattended (silent) mode.

To invoke an uninstallation, you use the

Msiexec command.

To uninstall all WebSphere MQ client features, enter one of the following commands:

• Msiexec /i "path\MSI\IBM WebSphere MQ.msi" REMOVE="All"

  This command gives you an interactive uninstallation of all features.

• Msiexec /i "path\MSI\IBM WebSphere MQ.msi" /q REMOVE="All"

  This command invokes a silent uninstall of all features.

• Msiexec /x "path\MSI\IBM WebSphere MQ.msi"

  This command displays only a progress dialog whilst uninstalling all features.

• Msiexec /x "path\MSI\IBM WebSphere MQ.msi" /q

  This command invokes a silent uninstall of all features.

Alternatively, we can the

Msiexec command with a parameter that calls a response file. A response file is an ASCII text file that contains the parameter values you want to set for the uninstallation. The response file has a format similar to a Windows .ini file, and contains the stanza [Response]. This stanza contains parameters that the

Msiexec command can use, in the form of PROPERTY=value pairs. The Msiexec command ignores any other stanzas in the file.

We can set which features to uninstall.

Note:

The response file you use to uninstall WebSphere MQ for Windows when it was installed using WebSphere MQ Client CD is not the same as the one used with earlier non-MSI versions of WebSphere MQ. For details about the response file you use with WebSphere MQ Client CD, see Unattended (silent) installation.

To uninstall WebSphere MQ using a response file, enter the following command:

Msiexec /i "path\MSI\IBM WebSphere MQ.msi" /q USEINI="response_file"

where response_file is the file that contains the [Response] stanza and the required PROPERTY=value pairs.

An example of a typical uninstallation response file is:

[Response]
REMOVE="Client,Toolkit"

 

Uninstalling the extended transactional function

This section describes how to uninstall, or remove, the extended transactional function, leaving the WebSphere MQ base client on your system. For information about how to uninstall the WebSphere MQ base client after you have uninstalled the extended transactional function, see Uninstalling WebSphere MQ client from Windows.

We can uninstall the extended transactional function in the following ways:

• Start the installation process from the WebSphere MQ Extended Transactional Clients CD-ROM. This gives you the option to uninstall the extended transactional client.

• Use Add/Remove Programs in the Control Panel.

• Uninstall from a command prompt.

We can also uninstall the extended transactional function by using SMS.

Before you uninstall the extended transactional function, ensure that there are no WebSphere MQ client applications running.

Uninstalling the extended transactional function using the installation process

This procedure uninstalls the extended transactional function from your system.

1. Insert the WebSphere MQ Extended Transactional Clients CD-ROM into the CD-ROM drive.

   If autorun is enabled, the installation process starts. If it is not enabled, double-click the Setup icon in the root folder on the CD-ROM to start the installation process.

   The Welcome window opens. If this window does not open, the extended transactional client is not installed on your system.

2. Click Next to continue. The Remove the WebSphere MQ Extended Transactional Client window opens.

3. Click Remove. The Removing the WebSphere MQ Extended Transactional Client window opens.

4. Wait for the progress bar to complete.

   If there are any messages that state that locked files are found, make sure that no WebSphere MQ client applications are running. After you have stopped any client applications, uninstallation should then continue.

   When the uninstallation completes successfully, the WebSphere MQ Extended Transactional Client Setup window displays the following message:

   Uninstallation Completed Successfully

5. Click Finish to close the WebSphere MQ Extended Transactional Client Setup window.

Uninstalling the extended transactional function using Add/Remove Programs

Use the following procedure:

1. From the Windows task bar, click Start --> Settings --> Control Panel. The Control Panel window opens.

2. Double-click Add/Remove Programs. The Add/Remove Programs window opens.

3. Click IBM WebSphere MQ Extended Transactional Client to select it.

4. For Windows 2000 or Windows XP:

   1. Click Remove. A window containing a confirmation prompt opens.

   2. Click Yes. The uninstall program begins and runs to completion.

   For Windows NT:

   1. Click Add/Remove. The Welcome window opens.

   2. Follow the procedure in Uninstalling the extended transactional function using the installation process from step 2 to the end.

Uninstalling the extended transactional function from a command prompt

This method can be used for uninstalling the extended transactional function in unattended mode. The method uses the msiexec command.

To uninstall the extended transactional function, insert the WebSphere MQ Extended Transactional Clients CD-ROM into the CD-ROM drive and enter one of the following commands at a command prompt:

• msiexec /i"X:\Windows\MSI\IBM WebSphere MQ Extended Transactional Client.msi"REMOVE="All"

  This command allows you to uninstall interactively.

• msiexec /i"X:\Windows\MSI\IBM WebSphere MQ Extended Transactional Client.msi" /qREMOVE="All"

  This command uninstalls in unattended mode.

• msiexec /x"X:\Windows\MSI\IBM WebSphere MQ Extended Transactional Client.msi"

  This command provides a confirmation prompt, and displays only a progress bar while uninstalling.

• msiexec /x"X:\Windows\MSI\IBM WebSphere MQ Extended Transactional Client.msi" /q

  This command uninstalls in unattended mode.

In these commands, X is the drive letter of your CD-ROM drive.

 

Home