MQ

MQ

Join this online group to communicate across IBM product users and experts by sharing advice and best practices with peers and staying up to date regarding product enhancements.

 View Only
Expand all | Collapse all

Command to get the STATUS of Channels under Queue Manager

  • 1.  Command to get the STATUS of Channels under Queue Manager

    Posted Wed December 11, 2024 12:53 AM

    Hi Team,

      I need help to get the status of Channels under a  Queue Manager. I am currently using the below commands-

    https://www.ibm.com/docs/en/ibm-mq/9.3?topic=zos-displaying-channel-status

    runmqsc QUEUE Manager

    DISPLAY CHSTATUS(*) STATUS

    The above command gets only the Channels which are "ACTIVE" in the Queue Manager. Is there any command or any filter to get all the Channel's irrespective of their Status (Active/Inactive) from the Queue Manager

    I am running this command locally on the IBM MQ Server

    Thanks



    ------------------------------
    Naveen P
    ------------------------------


  • 2.  RE: Command to get the STATUS of Channels under Queue Manager

    Posted Wed December 11, 2024 01:13 AM

    Hi Naveen,

    When thinking about IBM MQ Channels, you have two different items to display. You can display the channel definitions using

    DISPLAY CHANNEL(*)

    and you can display their status using

    DISPLAY CHSTATUS(*)

    The first thing to understand is that just because a channel definition exists, does not mean that there is any runtime state associated with a channel. DISPLAY CHSTATUS is showing you the run time state of a channel.

    If you try to view status of a channel name that is defined, but has no state, you will see one of the following two messages reported back to you (distributed and z/OS).

    AMQ8420I: Channel Status not found.

    CSQM297I !MQG1 CSQMDRTS NO CHSTATUS FOUND MATCHING REQUEST CRITERIA

    Your question links to the z/OS Operations and Control panel page where it describes how the ISPF panel interface will show "INACTIVE"

                                List Channels - MQAA                   Row 1 of 13

    Type action codes, then press Enter.  Press F11 to display connection status.
     1=Display   2=Define like   3=Alter   4=Manage   5=Perform
     6=Start     7=Stop

        Name                  Type          Disposition   Status
    <>  *                     CHANNEL       PRIVATE MQAA
    _   CLIENT_TO_MQAA        SVRCONN       QMGR    MQAA  INACTIVE
    _   MQAA.MQAB             SENDER        QMGR    MQAA  INACTIVE
    _   MQAB.MQAA             RECEIVER      QMGR    MQAA  INACTIVE
    _   SYSTEM.ADMIN.SVRCONN  SVRCONN       QMGR    MQAA  RUN
    _   SYSTEM.DEF.CLNTCONN   CLNTCONN      QMGR    MQAA
    _   SYSTEM.DEF.CLUSRCVR   CLUSRCVR      QMGR    MQAA  INACTIVE
    _   SYSTEM.DEF.CLUSSDR    CLUSSDR       QMGR    MQAA  INACTIVE
    _   SYSTEM.DEF.RECEIVER   RECEIVER      QMGR    MQAA  INACTIVE
    _   SYSTEM.DEF.REQUESTER  REQUESTER     QMGR    MQAA  INACTIVE
    _   SYSTEM.DEF.SENDER     SENDER        QMGR    MQAA  INACTIVE
    _   SYSTEM.DEF.SERVER     SERVER        QMGR    MQAA  INACTIVE

    Command ===> ________________________________________________________________
     F1=Help      F2=Split     F3=Exit      F4=Filter    F5=Refresh   F7=Bkwd
     F8=Fwd       F9=SwapNext F10=Messages F11=Status   F12=Cancel

    You'll note that this is a list of channels (the page title) not a list of channel status. The panels issue both commands, DISPLAY CHANNEL and DISPLAY CHSTATUS and put the results together on the one panel for you. When there is no status returned from the DISPLAY CHSTATUS command, the panel puts "INACTIVE" into that column to show that it got nothing back from the command.

    If you use the F11 key to switch to a list of channel status then you will only see channels that have some state, i.e. those that are not "INACTIVE".

    You ask, "Is there any command or any filter to get all the Channel's irrespective of their Status (Active/Inactive) from the Queue Manager". The answer is to use DISPLAY CHANNEL to see all channels, and to use DISPLAY CHSTATUS to see all channels that have some state.

    Hope this helps. Don't hesitate to ask follow-up question if I haven't explained it clearly enough.

    Cheers,
    Morag



    ------------------------------
    Morag Hughson
    MQ Technical Education Specialist
    MQGem Software Limited
    Website: https://www.mqgem.com
    ------------------------------