HP Integrity NonStop H-Series - Manual (Page 46)

5 Integration
This chapter describes how NSMQ can be integrated with NSASJ and JTA-TMF applications.
Integrating NSMQ with NSASJ
NSMQ integrates with NSASJ using resource adapters specified as RAR (Resource Adapter Archive
file). This RAR file is located in the <NSMQ-PAX-extracted-folder>/lib directory. The
integration includes inbound messages to be handled by Message Driven Beans (MDB) and
outbound messages published by state less or state full Enterprise Java Beans (EJB). The resource
adapter participates in the following contracts of Java Connector Architecture (JCA):
•
Connection Management Contract: Allows applications to connect to NSMQ through the
resource adapter. It also allows the application server to pool connection requests.
•
Transaction Management Contract: Allows an application to manage and perform transactional
access for sending and receiving messages.
•
Security Contract: Provides support for secure access to NSMQ.
This requires NSASJ to be configured to interact with NSMQ, and NSMQ to be configured to
expose the required functionality. Only TCP protocol based integration is supported from NSMQ.
To integrate NSMQ and NSASJ, both the applications must be installed on the system.
For installation instructions of NSASJ, see the NonStop Application Server for Java (NSASJ) 1.0
User Guide.
For installing NSMQ, see “Installation and configuration” (page 14) .
After installation, perform the following steps to configure the NSASJ integration with NSMQ:
1.
Create a temporary directory .
2. Unzip the contents of the archive file
<NSMQ-PAX-extracted-folder>/nsmq-rar-1.0.rar
to the directory.
3. Open the /META-INF/ra.xml and change the following property in the
element.
•
Change the URL to point to the NSMQ listen URL tcp://:
where, is the IP address provided during cluster creation and
is the port provided to listen for connection.
ServerUrl
java.lang.String
tcp://localhost:61616
4. Open the /META-INF/ironjacamar.xml and change the following property in
the element.
•
Map the JNDI names with the physical names of destinations to be used in the
element. For example,
jndi-name="java:jboss/activemq/queue/outbound">
QUEUE.OUTBOUND
5. Re-create the archive after making changes
$ cd
$ jar –cvf nsmq-rar-1.0.rar *
6. Deploy this archive using standard NSASJ deployment mechanism.
46 Integration