Version

    Internal JMS Connections

    Creating Internal JMS Connections
    Externalizing Internal JMS Connections
    Exporting 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

    The Internal JMS connection is created in the Outline pane.

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

    2. Select Connections → Create JMS connection.

    3. The Edit JMS connection wizard opens. Here, you can define the JMS connection. Both the wizard and the instructions on setting 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.

    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 clicking the OK button.

    4. A new configuration file appears in the conn subfolder of the project (visible in the Project Explorer pane). Internal connection item in the Outline pane is converted to link to the newly created external (shared) 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. Click the OK button to continue.

    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 when externalizing a single 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 an 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 the 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 Project Explorer pane.

    Exporting multiple selected internal JMS connections is analogous to externalizing multiple JMS connections described in the previous section.