Create an initial context factory code

About this task

Using an Initial Context Factory (ICF) class enables remote Java™ clients to connect to your application. This class is provided by the application vendor. The application uses ICF codes to identify these when setting up agents. Initial context factory codes are predefined in the application for the following JMS vendors:

  • IBM® WebSphere® MQ (for MQSeries® accessed through a IBM WebSphere Internet Inter-ORB Protocol URL)
  • File (for MQSeries accessed through a file URL, as with Oracle WebLogic)
  • Oracle WebLogic (for WebLogic JMS)

If you are using a JMS server that is not in the preceding list (for example, ActiveMQ), you must create an initial context factory code for it in the application:

Procedure

  1. Open the Applications Manager and select the application that you want.
  2. Open the Applications Manager. From the tree in the application rules side panel, choose System Administration > Initial Context Factory Codes. The Initial Context Factory Codes window displays in the work area.
  3. Select the + icon to create a new initial context factory code. The Initial Context Factory window is displayed.
  4. In the Initial Context Factory field, enter the name of the class provided by your JMS vendor. For example, for ActiveMQ, the class name is org.apache.activemq.jndi.ActiveMQInitialContextFactory.
  5. In the Short Description field, enter a descriptive name, up to 40 characters. Make note of this name, because you will use it in the next procedure (see Define the transaction information). For ActiveMQ, enter ActiveMQ.
  6. In the Long Description field, enter a more detailed description for the initial context factory, up to 100 characters.
  7. Save the new initial context factory code and close the window.
    Note: If you get the error Timer already cancelled when using ActiveMQ JMS then restart the ActiveMQ server.

Results

For more information about ICFs, see Creating an Initial Context Factory Code.