Issuing MQSC commands


The MQSC global command enables you to issue IBM MQ script commands (MQSC) from within BMC AMI Ops Monitor for MQ. This function makes using MQSC more convenient than issuing those commands from the SDSF console.

You can access the MQSC command function from the:

  • IBM MQ Performance and Control menu
  • COMMAND line of any BMC AMI Ops Monitor for MQ view

Related topic

To review the connections for a quiescing queue manager

This scenario assumes that you issued a STOP command for a queue manager from the QM view. The status changes to QUIESCE, but the queue manager does not shut down as expected. There might be active connections that are preventing the shutdown.

  1. On the COMMAND line, enter CONNZ.The CONNZ Connections Summary view is displayed. However, the view returns error messages rather than connection data because the queue manager is quiescing.

    2020/08/31 --------- BMC AMI Ops WINDOW INTERFACE (V7.1.00) -------------------
    COMMAND  ===>                                                  SCROLL ===> PAGE
    CURR WIN ===> 1        ALT WIN ===>                                            
    >M1 =CONNZ=============BCL4=======*========ddmmyyy==hh:mm:ss====MVMQS====D====0
    CMD APPLICATION OPEN    ASID  APPLICATION CICS CICS   IMS     OPENOBJECT NAME
    --- NAME        HANDLES       TYPE        TRAN TASKNO PSBNAME
    BBMXB614E Error detected in selector during RefreshBegin
    -Related:BBSAF903W QueueManager Connect Failure    Context: BCL4
    --Related:BBSAAA10E QueueManagerMqi Connect Failure  Target:BCL4
    ---Related:BBSAAC04E Queue Manager quiescing Queue Manager: BCL4
    BBMXBD15I There is no data that satisfies your request
    -Related:BBMXBD23I   0 records presented by the product
  2. To review the connections for the queue manager, enter MQSC on the COMMAND line.The MQSC Operator Commands dialog is displayed.
  3. In the Command field, type the MQSC command string that you want to execute.In this case, you want to display connection information, so enter:

    display conn(*) type(conn)

  4. (optional) In the Max Wait Time field, enter the maximum number of seconds that you want BMC AMI Ops Monitor for MQ to wait for a response.The default is 120 seconds.

    The completed dialog looks like this:

     ---------------------------- MQSC Operator Commands --------------------------
     | COMMAND ===>                                              SCROLL ===> PAGE |
     |                                                                            |
     | CMD String (MCM3                                                           |
     | Command    display conn(*) type (conn)                                     |
     |                                                                            |
     |                                                                            |
     |                                                                            |
     |       Max Wait Time                                                        |
     |       (seconds)            120                                             |
     |                                                                            |
     | EXECute to process the request                                             |
     | SAVE to save command string for this session                               |
     | CANcel to exit without processing                                          |
     | END to exit without processing                                             |
     | Help to view related help                                                  |
     ------------------------------------------------------------------------------
  5. On the COMMAND line, enter EXECute to process the request.The Command.Response list is displayed in ISPF VIEW mode.

     |VIEW  Command.Response                                                    |
     |Command ===>                                                                |
     |****** *********************************************************************|
     |000001 Timeout before all messages returned                                 |
     |000002 CSQM201I (MCM3 CSQMDRTC DISPLAY CONN DETAILS                         |
     |000003 CONN(CD88ECA8CCE60001)                                               |
     |000004 EXTCONN(C3E2D8C3D4C3D4F34040404040404040)                            |
     |000005 TYPE(CONN)                                                           |
     |000006  END CONN DETAILS                                                    |
     |000007 CSQM201I (MCM3 CSQMDRTC DISPLAY CONN DETAILS                         |
     |000008 CONN(CD88ECA9B4B30001)                                               |
     |000009 EXTCONN(C3E2D8C3D4C3D4F34040404040404040)                            |
     |000010 TYPE(CONN)                                                           |
     |000011  END CONN DETAILS                                                    |
     |  .                                                                         |
     |  .                                                                         |
     |  .                                                                         |
     ------------------------------------------------------------------------------
  6. To return to the MQSC Operator Commands dialog, press PF3.
  7. In the Command field, type the following command string to break the connections and stop the queue manager:stop qmgr mode(force)

Important

You might see the following messages from MQ:

CSQM298I .XVM1 CSQMDRTC TOTAL MESSAGE LENGTH ALLOWED ON CONSOLE EXCEEDED

CSQ9023E .XVM1 CSQMDRTC ' DIS QUEUE' ABNORMAL COMPLETION

This is a limitation within IBM MQ. So, limit the data you want to see by choosing generic values in the MQSC commands where possible.

 

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