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.

Installing BMC Software Extensions for IBM MQ

To enable collection of queue statistics on z/OS, BMC Software Extensions for MQ (MQE) must be installed for each queue manager.

When you install MQE within the Installation System, the extensions are enabled by default. To complete the customization of MQE, you must perform the steps described in this section.

Warning

Note

MQE uses the Next Generation Logger (NGL) for trace record offloading. NGL is installed and configured as part of MainView for MQ installation. For additional information about NGL, see the BMC Global Infrastructure Administration Guide.

To complete the customization of MQE

You can install MQE in a queue manager by adding a step to execute the program MMAHINIT prior to the execution of the CSQYASCP step in the master JCL procedure. MMAHINIT calls routines that perform the following functions:

  • build control blocks
  • read the EXITOPT file, and then process the command or save it for later
  • set up for initialization in the QMGR step
  • call product preinitialization

For each queue manager for which you need to gather MQITRACE (MQ API) or queue performance statistics, update the queue manager Started Task JCL.

To update the queue manager started task JCL

  1. Add the following step before the CSQYASCP(QMGR) step:

    //*****************************************************************
    //qmgr    PROC H=MMAHINIT,PID=MQT,MQE=hlq.BBLINK
    //BMCINIT EXEC PGM=&H,ACCT=(5714),PARM='&PID'
    //STEPLIB  DD DSN=&MQE,DISP=SHR                                     
    //EXITOPT  DD DSN=runtimehlq.UBBPARM(EXITOPxx),DISP=SHR    
    //****************************************************************

    In the above code xx is the value of the system symbol &SYSCLONE.

    Warning

    Note

    PARM is a list of product IDs. The Queue Performance Statistics product ID is MQT. Do not repeat this step because other BMC products that use other MQ Extensions add their additional PARMs to the EXEC statement.

    The MMAHINIT program is called with the product ID parameter. The product ID for statistics and trace is MQT. When you use this parameter, statistics and trace functions are installed. If additional products (or subproducts) are installed, the parameter should also include the additional products. For example, the PARM='MQT, xxx ' statement would include both MQT and product xxx. Currently, MQT is the only valid parameter.

  2. In the CSQYASCP(QMGR) step, make the following changes:

    1. Add the following statement:

      TIME=NOLIMIT

      Ensure the STEPLIB concatenation points to the BBLINK library.

      Warning

      Note

      You must add the TIME=NOLIMIT statement when two steps run in a started task because MVS issues the following message when the second step starts: ' IEF188I PROBLEM PROGRAM ATTRIBUTES ASSIGNED.' In other words, if the program to be run is not a Started Task that runs only a single step, the system nullifies the NODSI or SYST parameters. All other program properties remain in effect.

    2. Add the BBLINK library to the STEPLIB concatenation.

  3. Issue the following command to start the QMGR with MQE inactive:

    /cpfx start qmgr envparm('H=IEFBR14')

  4. To change the MQE default settings for a queue manager, add the appropriate API trace control to EXITOPT DD. For more information see, Setting-up-EXITOPT-DD-parameters.

    Warning

    Note

    Except for the TREXCEPTION keyword, if you enter the same keyword more than once, the last value is used.

This section contains the following topics:

 

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

MainView for MQ 5.5