Space banner

   

This space provides the same content as before, but the organization of the home page has changed. To help you quickly find the content that you need, topics are now organized based on logical branches instead of legacy book titles

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.

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.

    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.

      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.

    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:

Was this page helpful? Yes No Submitting... Thank you

Comments