[z/OS]

Using the operations and control panels on z/OS

You use these panels for defining, displaying, altering, or deleting IBM® MQ objects. Use the panels for day-to-day administration and for making small changes to objects.

Before you begin

The IBM MQ for z/OS® operations and controls panels (CSQOREXX) might not support all new function and parameters added from version 7 onwards. For example, there are no panels for the direct manipulation of topic objects or subscriptions. Use one of the following supported mechanisms to administer publish/subscribe definitions and other system controls that are not directly available from other panels:
  1. IBM MQ Explorer
  2. z/OS console
  3. Programmable Command Format (PCF) messages
  4. COMMAND function of CSQUTIL
  5. IBM MQ Console
Note that the generic Command action in the CSQOREXX panels allows you to issue any valid MQSC command, including SMDS related commands. You can use all the commands that the COMMAND function of CSQUTIL issues.

You cannot issue the IBM MQ commands directly from the command line in the panels.

To use the operations and control panels, you must have the correct security authorization; this is described in the User IDs for command security and command resource security.

You cannot provide a user ID and password using CSQUTIL, or the CSQOREXX panels. Instead, if you user ID has UPDATE authority to the BATCH profile in MQCONN, you can bypass the CHCKLOCL(REQUIRED setting. See Using CHCKLOCL on locally bound applications for more information.

If you are setting up or changing many objects, use the COMMAND function of the CSQUTIL utility program. See Using the CSQUTIL utility for IBM MQ for z/OS.

About this task

The operations and control panels support the controls for the channel initiator (for example, to start a channel or a TCP/IP listener), for clustering, and for security. They also enable you to display information about threads and page set usage.

The panels work by sending MQSC type IBM MQ commands to a queue manager, through the system command input queue.

Example

This is the panel that displays when you start a panel session:
                     IBM MQ for z/OS - Main Menu                     
                                                                                
 Complete fields. Then press Enter.                                             
                                                                                
 Action  . . . . . . . . . . 1     0. List with filter   4. Manage             
                                   1. List or Display    5. Perform            
                                   2. Define like        6. Start              
                                   3. Alter              7. Stop               
                                   8. Command                                  
 Object type . . . . . . . . CHANNEL       +                                    
 Name  . . . . . . . . . . . *                                                  
 Disposition . . . . . . . . A  Q=Qmgr, C=Copy, P=Private, G=Group,             
                                S=Shared, A=All                                 
                                                                                
 Connect name  . . . . . . . MQ1C  - local queue manager or group               
 Target queue manager  . . . MQ1C                                               
            - connected or remote queue manager for command input               
 Action queue manager  . . . MQ1C  - command scope in group                     
 Response wait time  . . . . 30    5 - 999 seconds                              
                                                                                
 (C) Copyright IBM Corporation 1993, 2025. All rights reserved. 

 Command ===>                                                                 
  F1=Help      F2=Split     F3=Exit      F4=Prompt    F9=SwapNext F10=Messages 
 F12=Cancel   
From this panel you can perform actions such as these:
  • Choose the local queue manager you want and whether you want the commands issued on that queue manager, on a remote queue manager, or on another queue manager in the same queue sharing group as the local queue manager. Over type the queue manager name if you need to change it.
  • Select the action you want to perform by typing in the appropriate number in the Action field.
  • Specify the object type that you want to work with. Press function key F1 for help about the object types if you are not sure what they are.
  • Specify the disposition of the object type that you want to work with.
  • Display a list of objects of the type specified. Type in an asterisk (*) in the Name field and press Enter to display a list of objects (of the type specified) that have already been defined on the action queue manager. You can then select one or more objects to work with in sequence. All the actions are available from the list.
Note: You are recommended to make choices that result in a list of objects being displayed, and then work from that list. Use the Display action, because that is allowed for all object types.