Configuring the JNDILookup Web Service

If you are using the administered JMS objects provided by WebSphere Process Server with Message Service Clients for C/C++ and .NET, you must configure the JNDILookup Web Service that WebSphere Process Server provides to enable non-Java clients to access administered JMS objects from a non-Java environment.

Before you begin

Before starting this task, make sure that the JNDILookup Web Service application has been installed.

Web Services Client for C++ is a prerequisite for using the JNDILookup Web Service with Message Service Client for C/C++. If you are using administered objects with Message Service Client for C/C++ applications, ensure that a compatible version of Web Services Client for C++ has been installed before starting this task. The versions of Message Service Client for C/C++ and Web Services Client for C++ that are packaged within WebSphere Process Server are compatible.

Why and when to perform this task

Administratively defined ConnectionFactory and Destination objects provide a separation between a JMS implementation and the JMS interfaces, which makes JMS client applications more portable since they are sheltered from the implementation details of a JMS provider. Administered objects enable an administrator to manage the connection settings for client applications from a central repository. For example, the specific queue that an application uses can be altered by changing the administered Destination object that the application obtains via JNDI.

Non-Java clients such as Message Service Clients for C/C++ and .NET can also use administered objects. However, since the administered JMS objects provided by WebSphere Process Server are serialized Java objects accessed via JNDI, non-Java clients are not able to interpret them properly without the use of the JNDILookup Web Service. This web service provides a lookup operation that allows Message Service Clients for C/C++ and .NET to request the retrieval of a JNDI object by specifying the name of the object. The properties of the administered object are returned to the application using a Map of name/value pairs.

Steps for this task

  1. Install and configure Web Services Client for C++ for use within Message Service Client for C/C++ applications. For information about configuring Web Services Client for C++ after installation, see Configuring after installation.
    Note: This step applies to Message Service Client for C/C++ only. Message Service Client for .NET invokes the web service directly through the Microsoft .NET framework.
  2. Define the JNDILookup Web Service URL within the Message Service Client for C/C++ or Message Service Client for .NET application. To define the web service URL within an application, set the XMSC_IC_URL property of the InitialContext object to the web service endpoint URL. This property can alternatively be specified as an argument on constructing the InitialContext object. For further information, see JNDILookup Web Service.

Terms of use |

Last updated: Tue Feb 21 17:19:19 2006

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)