Creating Software AG Universal Messaging connections

You must create at least one Universal Messaging connection resource to use each Software AG Universal Messaging Broker transport.

Before you begin

You must have at least one environment in your project.

Procedure

  1. Open the Logical View of the Architecture School perspective.
  2. On the toolbar of the Logical View, click Sofware AG > UM Connection.

    The New Software AG UM Connection window is displayed.

  3. In the Name field, enter a name for the connection.
  4. Click OK.

    The new logical connection is displayed in the Logical View.

  5. When a logical connection is created, a new physical resource is also created and bound to the logical connection. To view or edit this physical resource, right-click the new logical connection and click Physical Resource.

    The UM Connection window is displayed.

    Alternatively, right-click the logical Universal Messaging connection, and then click Open.

  6. To associate the new logical Universal Messaging connection to a physical Software AG Universal Messaging Broker, complete the following tasks:
    1. Double-click the new logical Universal Messaging connection.

      The UM Connection window is displayed.

      Alternatively, right-click the logical Universal Messaging connection and then click Open.

    2. Click the Bindings tab. Alternatively, click Project > Edit Environments in the menu bar to open the Environment Editor window and click the Bindings tab to modify the bindings of the selected environment.
  7. Optionally, click the Bindings tab. Alternatively, click Project > Edit Environments in the menu bar to open the Environment Editor window and click the Bindings tab to modify the bindings of the selected environment.

    If you did not bind the Universal Messaging connection to a physical Software AG Universal Messaging Broker, UNBOUND is displayed under Binding and you must complete the following tasks:

    1. When you click UNBOUND, it displays a list of all physical Universal Messaging Brokers in your project.
    2. Select a physical UM broker. If there are no physical Universal Messaging Brokers displayed, you must create one.
  8. Optionally, to add a log file for the new logical Universal Messaging connection, click the Monitoring tab.

    You can monitor the log file during the execution of a test that involves the new logical Universal Messaging connection.

  9. Optionally, to enter additional information about the new logical Universal Messaging connection, click the Documentation tab. Although this additional information is optional, it might help with the maintenance of the resources in the project or help future users of the project.
  10. Click OK.

Results

The new logical UM connection is added to the project. A Software AG Universal Messaging Broker resource is automatically created in the Physical View. Each physical Software AG Universal Messaging Broker resource represents a Universal Messaging Broker transport that can be selected and configured.