| Sun ONE Message Queue 3.5 Administrator's Guide |
Appendix E
The MQ Resource AdapterMessage Queue includes a JMS resource adapter.
A resource adapter is a standardized way for plugging additional functionality into a J2EE 1.4 compliant application server, in compliance with the J2EE Connector Architecture (J2EECA) 1.5 specification. This architecture allows any J2EE 1.4 compliant application server to interact with external systems in a standardized way. These external systems include various enterprise information systems (EIS), as well as various messaging systems, for example, a JMS provider.
The standardized interactions facilitated by J2EECA 1.5 include connection pooling, thread pooling, transaction and security context propagation, as well as support for message driven bean containers of various kinds. The specification also includes a standardized way to create connection factories and other administered objects.
By plugging a JMS resource adapter into an application server, J2EE components deployed and running in the application server environment can exchange JMS messages. The JMS connection factory and destination administered objects needed by these components can be created and configured using J2EE application server administration tools.
Other administrative operations, however, such as managing a message server and physical destinations, are not included in the J2EECA specification, and can only be performed through provider specific tools.
The MQ resource adapter is embedded in the Sun J2EE 1.4 Application Server. The MQ resource adapter, however has not yet been certified with any other J2EE 1.4 application server.
The MQ resource adapter is a single file (imqjmsra.rar) and is located in a directory that depends on operating system, as shown in Appendix A, "Location of MQ Data." The imqjmsra.rar file contains the resource adapter deployment descriptor (ra.xml) as well as the jar files that must be used by the application server in order to use the adapter.
You can use the MQ resource adapter in any J2EE 1.4 compliant application server by following the resource adapter deployment and configuration instructions that come with that application server. As commercial J2EE 1.4 application servers become available, and the MQ resource adapter becomes certified for those application servers, this appendix will provide specific information on the relevant deployment and configuration procedures.
