Skip to Content
Information
Limited support BMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops Monitor for MQ 5.6.

Dynamically replacing BMC Extensions for IBM MQ (MQE)

This section explains how to dynamically replace the BMC Extensions for IBM MQ (MQE) data collector without recycling the queue manager.

Warning

Note

To minimize the risk of losing statistical data, BMC recommends that you perform this procedure only when the system is quiesced or experiencing a low level of activity.

To replace MQE dynamically without recycling the queue manager

  1. On the COMMAND line, enter MQE.The MQE Status View/Change MPD (Multi Platform Dialog - MVE and 3270) is displayed.

     

     --------------------------- MQE Status View/Change --------------------------
     | COMMAND ===>                                              SCROLL ===> PAGE |
     |                                                                            |
     | Queue Manager                GRT4                                          |
     | Current Status               ENABLED                                       |
     | Requested Action             STATUS                                        |
     |                                                                            |
     |                                                                            |
     | Install and Replace Options                                                |
     | If MQELIB is not specified,                                                |
     | the data will be loaded from                                               |
     | the Queue Manager Steplib.                                                 |
     | MQE Load Library              ________________________________________     |
     | If EXITOPT is not specified                                                |
     | MVMQS defaults are used.                                                   |
     | MQE EXITOPT DSN               ________________________________________     |
     | EXITOPT MEMBER                __________                                   |
     |                                                                            |
     | EXECute to process the request                                             |
     | SAVE to save DSN variables for this session                                |
     | CANcel to exit without processing                                          |
     | END to exit without processing                                             |
     | Help to view related help                                                  |
     -----------------------------------------------------------------------------
  2. In the Requested Action field, enter REPLACE.

  3. In the MQE Load Library field, enter the name of the BBLINK library where MQE executables are stored.

    Warning

    Note

    If you leave this field blank, MQE loads from the STEPLIB specification in the CSQYASCP step of the queue manager.

    When you install or replace a different load library than the one specified in the queue manager, STEPLIB might not be used. However, when the queue manager is restarted, it reverts to using the value specified by the STEPLIB statement.

  4. In the MQE EXITOPT DSN field, enter the name of the library (or data set name) that MQE uses to read EXIT options (EXITOPT).

    Warning

    Note

    If you leave this field blank, MQE uses the built-in MainView for MQ default value. When the queue manager restarts, MQE reverts to using the EXITOPT value specified in the MMAHINIT program.

  5. In the EXITOPT MEMBER field, enter the name of the data set member to use in the EXITOPT library.

    Warning

    Note

    If you leave this field blank but specified a new value in the MQE EXITOPT DSN field, MQE writes output to a sequential data set.

  6. On the COMMAND line, enter EXEC to process the request.MQE completes the following actions:

    1. deletes all storage areas, programs, and data
    2. reloads programs, reallocates storage, and restarts data collection
    3. redisplays the MPD with a message shown below the Requested Action field, summarizing the results (for example, MMASTATUS_MQE_REFRESHED)

    Thus, issuing the Replace command has the same effect as issuing both the Remove command and the Install command.

  7. (optional ) On the COMMAND line, enter SAVE if you want to save your changes for use next time you access this panel during this session.These saved values will persist until you exit MainView for MQ or recycle the PAS.



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

MainView for MQ 5.5