[AIX][Windows][z/OS][Linux][V9.0.4 Oct 2017]

New features on all supported platforms

IBM® MQ 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

From IBM MQ 9.0.4, the following enhancements are available for the administrative REST API:
  • You 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.
  • You 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.
  • You 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.
  • You can use the administrative REST API to administer queue managers that are not in the same installation as the mqweb server. That is, you can administer remote queue managers and the IBM MQ objects that are associated with the remote queue manager. Therefore, you 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. You can modify configuration of the CSRF protection for the administrative REST API by using the setmqweb properties command. For more information, see Configuring CSRF token protection.

New commands for configuring the mqweb server

From IBM MQ 9.0.4, you 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, you can set the HTTPS host port, and the log file size. You can use the dspmqweb properties command to display the properties. For more information about the commands and the properties that you can set, see dspmqweb, and setmqweb.

The messaging REST API

From IBM MQ 9.0.4, you 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:
  • You 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.
  • You 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.
[MQ Appliance]Note: The messaging REST API is not supported on the IBM MQ Appliance in IBM MQ 9.0.4.

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