Creating RA JMS Agent Connection Objects

You will need to create an RA JMS Agent Connection object by selecting an Agent and provider type. Next you define the JNDI properties. JNDI properties create the initial context of the JMS messages.

To create an RA JMS Agent Connection object:

  1. Add a Connection object of type JMS > JMSCONNECTION.
  2. Select the JMS Connection page.
  3. Respond to the following fields in the Agent Settings and General JNDI Properties sections.
    • Agent

      • Select an RA JMS Agent solution Agent object. This field is only used to populate the provider information in the Job.

    • Provider Type

      • Select a provider type defined for the Agent as documented in topic Specifying General RA JMS Agent Solution Agent Object Settings.

    • JMS Version

      • A read-only field that displays the JMS version.

    • Context Factory

      • Select the context factory from the selected provider type.

    • Provider URL

      • Enter the endpoint to the JMS provider in the format the vendor accepts.

    • Connection Factory

      • Enter the registration name defined with JNDI (default ConnectionFactory).

    • Principal

      • The login name to the provider for the JNDI connection.
      To pass a user name at the implementation level, you use the User field in the Security section of this page.

    • Credentials

      • The password to the provider for the JNDI connection.
      To pass a user name at the implementation level, you use the Password field in the Security section of this page.

  4. Optionally add other properties to the Custom JNDI Properties table.

    5. These fields can include object variables in the format &<variable name>. The values of these object variables will be replaced at runtime.

  5. If your RA JMS Agent connection requires a user name and password to be passed at the implementation level, you can optionally add them in the User and Password fields in the Security section.
  6. Optionally set headers and add properties using the Headers & Properties page. For more information, see Defining Headers and Properties for RA JMS Agent Connection Objects.
  7. Optionally add queues, topics and/or subscribers using the Queues, Topics, Subscribers page. For more information, see Defining Queues, Topics, and Subscribers for RA JMS Agent Connection Objects.
  8. Click Save to save the Connection object.

The Login field on the Attributes page is not used for Automation Engine Jobs of the JMS Agent.