Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

MQ Queue List (5.6.1)

Related Tpoics

Quick-Reference

Customizing-after-installation

The MQ Queue List screen is used to view a list of active CICS MQ queues. In addition to the MQ queue names, Code Debug CICS also displays:

  • Type of queue
  • Current depth

Access this screen by typing the number 1 on the MQ-Menu-5-6, typing 6.1 on the File-Utility-Menu-5, or as described in Transferring Between Screens.

MQ Queue List Screen (5.6.1)

------------------------------ MQ QUEUE LIST (5.6.1) ----------------------C024
COMMAND ===>                                                   SCROLL ===> CSR
MODULE:          CSECT:                                                        
QUEUE TYPE: *           QUEUE LIMIT:                   QUEUE MANAGER NAME: M530
QUEUE NAME PREFIX: *                                                           
                                                                               
LINE COMMAND:  B (Browse)  S (Select)                                          
                                                                               
CMD   QUEUE NAME                                         TYPE       CUR DEPTH  
---   ----+---10----+---20----+---30----+---40----+---   -------   ----------  
 _    csq1                                               QLOCAL             0  
 _    efhrja0.test.chin.traffic                          QLOCAL             0  
 _    kevinsqueue                                        QLOCAL            12  
 _    pnlkkh0.testQueue                                  QLOCAL             0  
 _    pnlkkh0.testTopic                                  QLOCAL             0  
 _    vp.csq4samp.batch.forward.queue                    QLOCAL             1  
 _    ASASASASPLANNING.SITE.REPORTS.RESPONSE.QUEUE01     QLOCAL             0  
 _    CF.TEST.QALIAS                                     QALIAS                
 _    CF.TEST.QLOCAL                                     QLOCAL             0  
-------------------------------  P F   K E Y S  -------------------------------
F1 =HELP     F2 =RUNTO    F3 =END       F4 =EXIT     F5 =RFIND    F6 =LOCATE *
F7 =UP       F8 =DOWN     F9 =GO 1      F10=LEFT     F11=RIGHT    F12=GO       
F13=MENU     F14=MEMORY   F15=SELECT    F16=WS       F17=TRACE    F18=LAST3270
F19=UP MAX   F20=DOWN MAX F21=FILE      F22=DLEFT    F23=DRIGHT   F24=RETRIEVE

Input Fields

QUEUE TYPE

The queue list may be limited to a specified type of queue. Valid values are QALIAS, QLOCAL, QMODEL, QREMOTE, or an asterisk (*). Enter an asterisk to include all queue types in the list. The default value is an asterisk.

QUEUE LIMIT

The queue list may also be limited by the contents of the QUEUE LIMIT field. If the MQ LIST LIMIT field is set to zero or spaces there is no maximum number of queues used to limit the list. All qualifying queues will be displayed.

QUEUE NAME PREFIX

The queue list may be limited to queue names beginning with a specified prefix. The entered prefix must end with an asterisk (*). Enter an asterisk to include all queue names in the list. The default value is an asterisk.

CMD

Enter B in the field to display a single message from a queue on the Browse-MQ-Queue-Message-5-6-2 screen.

Important

Browsing a message from an initiation queue may cause a trigger event to occur, which may result in a trigger message being generated in the initiation queue. For details about trigger events and trigger messages, see section entitled “Starting IBM MQ applications using triggers” in the IBM documentation site.

Enter S in the field to display the Update-MQ-Queue-Message-5-6-3 screen.

Output Fields

QUEUE MANAGER NAME

Name of the MQ queue manager that is connected to the CICS system.

QUEUE NAME

Name of the queue that can be accessed from the CICS system. Queues can be aliases, that is, point to another queue. If the opened MQ queue is indirect to another queue, Code Debug CICS displays the indirect TO queue name. When you access the Browse-MQ-Queue-Message-5-6-2 screen, Code Debug CICS follows the indirect chain to obtain the correct attributes of the target queue.

TYPE

Type of MQ queue. Valid entries are:

  • QALIAS: The queue name is an alias for another queue defined to the local queue manager. When an alias queue is selected, the alias is resolved and messages from the associated base queue will be displayed on the Browse-MQ-Queue-Message-5-6-2 screen.
  • QLOCAL: The queue belongs to the local queue manager. The local queue manager is the MQ queue manager connected to the CICS system.
  • QMODEL: The queue is model for use when creating a dynamic queue. Model queues are not selectable.
  • QREMOTE: The queue belongs to an MQ queue manager other than the local queue manager. Remote queues are not selectable.

CUR DEPTH

The current depth (number of messages) of the local queue.

 

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