# IBM® MQ Plug-in for Zowe CLI

The IBM MQ Plug-in for Zowe CLI lets you issue MQSC commands to a queue manager. MQSC commands let you to perform administration tasks. For example, you can define, alter, or delete a local queue object.

Note: For more information about MQSC commands and the corresponding syntax, see MQSC commands (opens new window) on the IBM Knowledge Center.

# Use cases

You can use the plug-in to excecute MQSC Commands. With MQSC commands you can manage queue manager objects (including the queue manager itself), queues, process definitions, channels, client connection channels, listeners, services, namelists, clusters, and authentication information objects.

# Using IBM MQ plug-in commands

For detailed documentation on commands, actions, and options available in this plug-in, see our Web Help. It is available for download in three formats: a PDF document, an interactive online version, and a ZIP file containing the HTML for the online version.

# Software requirements

Before you install the plug-in, meet the software requirements in Software requirements for Zowe CLI plug-ins.

# Installing

Use one of the following methods to install or update the plug-in:

# Creating a user profile

You can create an mq user profile to avoid typing your connection details on every command. An mq profile contains the host, port, username, and password for the MQ Rest API server of your choice. You can create multiple profiles and switch between them as needed.

Follow these steps:

  1. Create an mq profile:

    zowe profiles create mq-profile <profileName> --host <hostname> --port <portnumber> --user <username> --password <password>

    The result of the command displays as a success or failure message. You can use your profile when you issue commands in the mq command group.

Tip: For more information about the syntax, actions, and options, for a profiles create command, open Zowe CLI and issue the following command:

zowe profiles create mq-profile -h