IBM Support

MA93: WebSphere MQ - Service Definition

Downloadable files


This SupportPac contains the WebSphere MQ Service Definition specification which defines how to represent WebSphere MQ applications as web services using IRIs and WSDL.

Download Description

The WMQ Service Definition specification document and the related WMQ IRI specification document specify how WebSphere MQ (WMQ) applications should be described as services.

The documents cover five major areas:

  1. The IRI specification which defines the addresses of WMQ resources to be used by WMQ services (and other applications where a WMQ IRI is required).
  2. The properties that can be used to describe a WMQ application as a service.
  3. The MQI options that must be used to construct and interpret the SOAP and non-SOAP WMQ messages that communicate with a service.
  4. A set of examples illustrating the combinations of IRIs and service invocation messages.
  5. The WSDL binding that can be used to describe WMQ services.

The main audience for these specifications is:
  1. The architects, authors, and administrators of WMQ applications who wish to catalogue their MQ assets in a standard way.
  2. The implementers of web services stacks - who wish to extend a web services stack with a WMQ message transport. These specifications let you write a WMQ service implementation that interoperates with other WMQ service implementations.
  3. Providers of web services intermediary services such as routing gateways; or SOAP/HTTP to WMQ gateways. This specification does not discuss details of how such gateways should be designed and configured, but adherence to the standard helps the gateway ensure proper interoperation with WMQ clients and services.

The specifications define SOAP and non-SOAP WMQ bindings, and so can describe both traditional WMQ applications as services, and SOAP services that use WMQ as a transport.

Possible Uses
The main purposes are:
  • To allow MQ applications to be catalogued in a services registry such as the IBM WebSphere Service Registry and Repository.
  • To ensure interoperability between different implementations of web services tools that allow WMQ to be used as a web services transport.
  • To enable developers to implement their own WMQ services, and to have these interoperate with vendor-provided web services.

You can download a RedPaper for more information about using the WMQ Service Definition specifications . The RedPaper uses a scenario to show how the WMQ specifications can be used in conjunction with the WebSphere Message Broker (WMB), and WebSphere Service Registry and Repository (WSRR). It demonstrates how to describe two WMQ applications using WSDL, store those WSDL descriptions in WSRR, then invoke the applications as HTTP services, through WMB with a dynamic endpoint lookup.
The RedPaper can be downloaded from here:

Author: Mark Phillips, WebSphere MQ Strategy, Hursley
Category: 2
Released: 30Nov07
Current SupportPac Version: 1.0
»Please note that the version number shown in the right-hand pane is the version of the MQ or WBI product that this SupportPac applies to. The date is the last webpage refresh.

To view the complete portfolio of WebSphere MQ SupportPacs please visit the WebSphere MQ SupportPacs homepage.



Installation Instructions

Not applicable.

Download package

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
IRI Specification 30/11/2007 US English 255963 FTP
Service Definition 30/11/2007 US English 1198032 FTP

Technical support

Category 2 SupportPacs are provided in good faith and AS-IS. There is no warranty or further service implied or committed and any supplied sample code is not supported via IBM product service channels.

You may submit a question or offer feedback on the SupportPac but please be aware that a response is NOT guaranteed.

Document information

More support for: WebSphere MQ

Software version: 6.0, 6.0.1, 6.0.2,

Operating system(s): AIX, HP-UX, IBM i, Linux, OpenVMS, Platform Independent, Solaris, Windows, z/OS, z/VSE

Reference #: 4017518

Modified date: 30 November 2007