Cleanup tasks

Before you remove the Error Handler sample from the broker, you must complete the following tasks:

  1. Delete the ErrorHandler execution group:
  2. Stop the broker.
    1. On Windows: Start the command console that can run broker commands.

      On Linux: Run the mqsiprofile command in a terminal window.

    2. Enter the following command on the command line to stop your broker, where MB8BROKER is the name of your broker:

      mqsistop MB8BROKER
  3. Clear the STAFF_IN queue and stop the queue manager.
    1. Start WebSphere MQ Explorer:
      • On Windows: Click Start > Programs > IBM WebSphere MQ > WebSphere MQ Explorer.
      • On Linux: On the command line, type: strmqcfg
    2. In the Navigator view of WebSphere MQ Explorer, expand the tree to display the queue manager of the broker, MB8QMGR.
    3. Expand the queue manager tree to display the queues.
    4. Right-click the STAFF_IN queue, select Clear messages.
    5. In the Clear Queue window, select Queue will be cleared using MQGET API calls, click Clear.
    6. Right-click MB8QMGR, click Stop.
    7. In the End Queue Manager window, select Controlled, click OK.
  4. Remove the XA resource from the queue manager.
    1. Remove the database switch file from the WebSphere MQ installation:
      • On Windows:
        • If you are using DB2: Delete the DB2 file db2swit.dll
        • If you are using Oracle: Delete the file UKor8dtc23.dll, from mq_install_dir\exits where mq_install_dir is the path to where WebSphere MQ is installed.
      • On Linux:
        • If you are using DB2, delete the DB2 file db2swit
        • If you are using Oracle, delete the file UKor8dtc23, from the /var/mqm/exits directory.
    2. Remove the resource manager, STAFFDB, from the queue manager of the broker, MB8QMGR:
      1. Start WebSphere MQ Explorer:
        • On Windows: Click Start > Programs > IBM WebSphere MQ > WebSphere MQ Explorer.
        • On Linux: On the command line, type: strmqcfg
      2. In the Navigator view of WebSphere MQ Explorer, expand the tree to display the queue manager of the broker, MB8QMGR.
      3. Right-click MB8QMGR, click Stop.
      4. In the End Queue Manager window, select Controlled, click OK.
      5. Right-click MB8QMGR, click Properties. The Properties window of the queue manager opens.
      6. On the "XA resource managers" page, select the database Error Handler resource that you created during the setup instructions (see Setting up the Error Handler sample), select Remove.
      7. Start the queue manager for the broker, in WebSphere MQ Explorer, right-click MB8QMGR, click Start. Ensure that the queue manager started without errors.
    3. If you are not using the Remove wizard to remove the sample, you must restart your broker. To start your broker:
      1. On Windows: Start the command console that can run broker commands.

        On Linux: Run the mqsiprofile command in a terminal window.

      2. Enter the following command on the command line to start your broker, where MB8BROKER is the name of your broker:

        mqsistart MB8BROKER
  5. Run the Remove wizard.

Back to sample home