Using JMSAdmin to create Java™ message service (JMS) resources
 Technote (troubleshooting)
 
Problem(Abstract)
IBM does not support the use of JMSAdmin to create JMS resources. Use the Administrative Console to create all JMS resources.
 
Cause
If your Enterprise JavaBean™ (EJB™) lookup uses a plain JMS resource bound by JMSAdmin, it is not wrapped and managed by WebSphere® Application Server. For example, there is no transaction enlistment, no connection pooling, no security credential mapping, and so forth.
 
Resolving the problem
IBM supports using JMSAdmin to create resources, as long as you wrapper them with entries under the Generic JMS Provider. To take advantage of connection pooling and enlistment in WebSphere Application Server transactions, you must use the Generic JMS Provider to create wrapped resources pointing to these JMSAdmin bound resources.
Long-term fix

IBM is aware of the importance of fixing this issue, and is committed to fixing this problem, with the goal of allowing you to create any JMS object using wsadmin.

Creating resources using the Generic JMS Provider from the administrative console
  1. Create a new Generic JMS Provider. Navigate to Resources > Generic JMS Providers.

    The fields to note are:
    • Classpath. Point this to mq install root\java\lib.
    • Native library path. Include mq root\java\lib and mq root\bin.
    • Name . Any name (for display purpose only).
    • External Initial Context factory. Match INITIAL_CONTEXT_FACTORY parameter in jmsadmin.config file.
    • External Provider URL. Match PROVIDER_URL parameter in jmsadmin.config.
  2. Create a QCF under the generic JMS provider, to wrap the QCF created in JMSAdmin.
  3. Create a new JMS Connection Factory under the generic provider.
    • External JNDI name. The name used when you use JMSAdmin to put it into the namespace.
    • JNDI name. The name to which your applications will refer.
  4. Create a JMS destination under the generic provider.
    • Name. For display only, use the external JNDI name.
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Java Message Service (JMS)
Operating system(s): Windows
Software version: 5.0.1
Software edition:
Reference #: 1137792
IBM Group: Software Group
Modified date: Feb 4, 2004