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
- Open the Applications Manager and select
the application that you want.
- 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.
- Select the + icon to create a new initial
context factory code. The Initial Context Factory window is displayed.
- 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
.
- 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.
- In the Long Description field, enter a more
detailed description for the initial context factory, up to 100 characters.
- 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.