+

Search Tips | Advanced Search

Administer IBM MQ

To administer your IBM MQ queue managers and associated resources, choose your preferred method from a set of tasks that we can use to activate and manage those resources.

We can administer IBM MQ objects locally or remotely, see Local and remote administration.

There are a number of different methods that we can use to create and administer your queue managers and their related resources in IBM MQ. These methods include command-line interfaces, graphical user interfaces, and an administration API.

There are different sets of commands that we can use to administer IBM MQ depending on your platform:

There are also the other following options for creating and managing IBM MQ objects:

For information about the administration interfaces and options on IBM MQ for z/OSĀ®, see Administer IBM MQ for z/OS.

We can automate some administration and monitoring tasks for both local and remote queue managers by using PCF commands. These commands can also be simplified by using the IBM MQ Administration Interface (MQAI) on some platforms. For more information about automating administration tasks, see Automate IBM MQ administration using PCF commands.

IBM MQ control commands

We can perform administrative tasks on queue managers themselves by using the control commands.

IBM MQ for Windows, UNIX and Linux systems provide the control commands that you issue at the system command line.

The control commands are described in Create and manage queue managers on Multiplatforms. For the command reference for the control commands, see IBM MQ Control commands.


IBM MQ Script (MQSC) commands

Use MQSC commands to manage queue manager objects, including the queue manager itself, queues, process definitions, namelists, channels, client connection channels, listeners, services, and authentication information objects.

You issue MQSC commands to a queue manager by using the runmqsc command. We can do this interactively, issuing commands from a keyboard, or we can redirect the standard input device (stdin) to run a sequence of commands from an ASCII text file. In both cases, the format of the commands is the same.

We can run the runmqsc command in three modes, depending on the flags set on the command:

MQSC commands are available on all platforms, including IBM i, and z/OS . MQSC commands are summarized in Comparing command sets.

On UNIX, Linux, and Windows, we can use the MQSC as single commands issued at the system command line. To issue more complicated, or multiple commands, the MQSC can be built into a file that you run from the command line. MQSC commands can be sent to a remote queue manager. For full details, see Building command scripts.

To issue the commands on an IBM i server, create a list of commands in a Script file, then run the file by using the STRMQMMQSC command. Notes:
  1. Do not use the QTEMP library as the input library to STRMQMMQSC, as the usage of the QTEMP library is limited. You must use another library as an input file to the command.
  2. On IBM i, MQSC responses to commands that are issued from a script file are returned in a spool file.

Script (MQSC) commands contains a description of each MQSC command and its syntax.

For more information about using MQSC commands, see Administer MQ by using MQSC commands.


Programmable Command Formats (PCFs)

Programmable Command Formats (PCFs) define command and reply messages that can be exchanged between a program and any queue manager (that supports PCFs) in a network. We can use PCF commands in a systems management application program for administration of IBM MQ objects: authentication information objects, channels, channel listeners, namelists, process definitions, queue managers, queues, services, and storage classes. The application can operate from a single point in the network to communicate command and reply information with any queue manager, local, or remote, using the local queue manager.

For more information about PCFs, see Introduction to IBM MQ Programmable Command Formats.

For definition of PCFs and structures for the commands and responses, see Programmable command formats reference.

The administrative REST API

The administrative REST API provides a RESTful interface that we can use to administer IBM MQ. When we use the administrative REST API, you invoke an HTTP method on a URL that represents an IBM MQ object. For example, we can request information about IBM MQ installations by using the HTTP method GET on the following URL:

Version 9.0.4 and later:
https://localhost:9443/ibmmq/rest/v1/admin/installation
Version 9.0.3 and earlier:
https://localhost:9443/ibmmq/rest/v1/installation

We can use the administrative REST API with the HTTP/REST implementation of a programming language, or by using tools such as cURL, or a REST client browser add-on.

For more information, see The administrative REST API

IBM i Control Language (CL)

This language can be used to issue administration commands to IBM MQ for IBM i. The commands can be issued either at the command line or by writing a CL program. These commands perform similar functions to PCF commands, but the format is different. CL commands are designed exclusively for servers and CL responses are human-readable, whereas PCF commands are platform independent and both command and response formats are intended for program use.

For full details of the IBM i Control Language (CL), see IBM MQ for IBM i CL commands.

The IBM MQ Explorer

Using the IBM MQ Explorer, we can perform the following actions:

On Windows and Linux systems, we can start IBM MQ Explorer by using the system menu, the MQExplorer executable file, or the strmqcfg command.

On Linux, to start the IBM MQ Explorer successfully, you must be able to write a file to your home directory, and the home directory must exist.

For more information, see Administration using the IBM MQ Explorer.

We can use IBM MQ Explorer to administer remote queue managers on other platforms including z/OS, for details and to download the SupportPac MS0T, see http://www.ibm.com/support/docview.wss?uid=swg24021041.

The IBM MQ Console

We can use the IBM MQ Console to administer IBM MQ from a web browser.

For more information, see Administration using the IBM MQ Console.

The Windows Default Configuration application

We can use the Windows Default Configuration program to create a starter (or default) set of IBM MQ objects. A summary of the default objects that are created is listed in Table 1: Objects created by the Windows default configuration application.

The Microsoft Cluster Service (MSCS)

Microsoft Cluster Service (MSCS) enables you to connect servers into a cluster, giving higher availability of data and applications, and making it easier to manage the system. MSCS can automatically detect and recover from server or application failures.

It is important not to confuse clusters in the MSCS sense with IBM MQ clusters. The distinction is as follows:

Supporting the Microsoft Cluster Service (MSCS) provides detailed information about how to configure your IBM MQ for Windows system to use MSCS.