Internal JMS Connections

An Internal JMS Connection is a JMS Connection being a part of a graph. The Internal JMS Connection is contained in the graph and can be seen in its source tab.

Creating Internal JMS Connections

Internal JMS connection is created in Outline pane.

  1. Right click the Connections group or any connection item.

  2. Select ConnectionsCreate JMS connection.

  3. An Edit JMS connection wizard opens. You can define the JMS connection in this wizard. Its appearance and the way how you must set up the connection are described in Edit JMS Connection Wizard.

Externalizing Internal JMS Connections

Any existing Internal JMS Connection can be converted (externalized) to the External JMS Connection. This gives you the ability to use the same JMS connection across multiple graphs.

How to Externalize JMS Connection
  1. Right-click an internal connection item in the Outline pane and select Externalize connection from the context menu.

    Externalizing JMS Connection from Context menu

    Figure 33.11. Externalizing JMS Connection from Context menu


  2. A new wizard will be opened. The wizard offers location for the new external (shared) connection configuration file in conn directory of your project and file name for external JMS Connection. If a file with the connection file name already exists, you can change the suggested name of the connection configuration file.

  3. Finish the wizard by OK button.

  4. A new configuration file appears in the conn subfolder of the project and it can be seen in the Navigator pane. Internal connection item in Outline is converted to link to the external (shared) newly created connection.

Externalizing Multiple JMS Connections at once

You can even externalize multiple internal connection items at once.

  1. Choose JMS Connections to be externalized in the Outline pane.

  2. Right-click and select Externalize connection from the context menu.

  3. A new wizard will be opened. The wizard offers the conn folder of your project as the location for the first of the selected internal connection items.

  4. Continue using OK button.

  5. The same wizard will be opened for each of the selected connection items until all selected connections are externalized. The wizard works in the same way as it would externalize only one connection.

[Tip]Tip

To choose adjacent connection items press Shift and move the Down Cursor or the Up Cursor key.

To choose non-adjacent items, use Ctrl+Click at each of the desired connection items instead.

The same approach is valid for both: database and JMS connections.

Exporting Internal JMS Connections

This case is somewhat similar to that of externalizing internal JMS connection. But, while you create a connection configuration file that is outside the graph in the same way as externalizing, the file is not linked to the original graph. Only the connection configuration file is being created.

You can use such a file for more graphs as an external (shared) connection configuration file as mentioned in the previous sections.

How to Export JMS Connection
  1. Choose JMS Connection in Outline.

  2. Right-click and choose Export connection.

  3. Use the wizard in the same way as in case of externalization of JMS connection.

  4. After the export of JMS Connection the Outline pane connection folder remains the same. The newly created connection configuration file appears in the conn directory in the Navigator pane.

You can export multiple selected internal JMS connections in a similar way to how it is described in the previous section about externalizing.