New features on all supported platforms

IBM MQ Version 9.0.4 delivers a number of new features for the REST API on all platforms that are supported by this release, that is on AIX , Linux , Windows, and z/OS®.

• Enhancements for the administrative REST API
• New commands for configuring the mqweb server
• The messaging REST API

Enhancements for the administrative REST API

From Version 9.0.4, the following enhancements are available for the administrative REST API:

• We can run any MQSC command by using the HTTP POST method with the /admin/action/qmgr/{qmgrName}/mqsc resource. For more information, see /admin/action/qmgr/{qmgrName}/mqsc.
• We can request information about the attributes of a subscription by using the HTTP GET method with the /admin/qmgr/{qmgrName}/subscription resource. For more information, see /admin/qmgr/{qmgrName}/subscription.
• We can request information about the attributes, and status, of a channel by using the HTTP GET method with the /admin/qmgr/{qmgrName}/channel resource. For more information, see /admin/qmgr/{qmgrName}/channel.
• The attribute enableMediaImageOperations has been added to the queue REST API. This attribute is in the extended object. For more information, see Request body attributes for queues.
• We can use the administrative REST API to administer queue managers that are not in the same installation as the mqweb server. That is, we can administer remote queue managers and the IBM MQ objects that are associated with the remote queue manager. Therefore, we can use the REST API to administer your entire IBM MQ network with only one installation that runs the mqweb server. For more information, see Remote administration using the REST API.
• CSRF synchronizer tokens for the administrative REST API are periodically regenerated. We can modify configuration of the CSRF protection for the administrative REST API by using the setmqweb properties command. For more information, see Configure CSRF token protection.

New commands for configuring the mqweb server

From Version 9.0.4, we can use the setmqweb properties command to configure properties of the mqweb server that is used to support the IBM MQ Console and administrative REST API. For example, we can set the HTTPS host port, and the log file size. We can use the dspmqweb properties command to display the properties. For more information about the commands and the properties that we can set, see dspmqweb, and setmqweb.

The messaging REST API

From Version 9.0.4, we can use the messaging REST API to send and receive IBM MQ messages. This feature is intended as a replacement for the IBM MQ bridge for HTTP:

• We can send an IBM MQ text message to a specified queue by using the HTTP POST method with the /messaging/qmgr/{qmgrName}/queue/{queueName}/message resource. For more information, see POST.
• We can receive an IBM MQ text message from a specified queue by using the HTTP DELETE method with the /messaging/qmgr/{qmgrName}/queue/{queueName}/message resource. For more information, see DELETE.

Note: The messaging REST API is not supported on the IBM MQ Appliance in Version 9.0.4.

For more information about the messaging REST API, see Messaging using the REST API.