Creating a destination to represent a public thread from an outside site

A destination, which represents a public thread from an outside site, can be created in the current site.

Creating a new destination automatically populates the Properties tab.

  1. Click Configure Thread Routes in the Network Configurator layout panel.
  2. Drag and drop the destination thread onto the graph panel. You can also right-click in the panel and select New Destination.
    This is enabled on all_threads view, built-in group views, and user-defined views.
    This option is disabled if the destination thread from an outside site does not belong to any process in the current site.
  3. Accept the default name or specify a new Destination Name. The default name is automatically created with dest_1. A number is appended to ensure there is no name duplication in the current site. This name can be changed.
    The reply message routing's transaction ID is the source thread name in the message. The destination name for reply routing can be different from the source thread name because these two definitions come from different contexts. To have reply inter-site routing, keep the destination name the same as the source thread name of the outbound message that requests the reply.
  4. Add a Bitmap and Group Names are optional. If a bitmap setting is not specified, then the default icon is used to represent the destination thread. You can use any bitmap for the destination. All other fields are required.
  5. Using the Host menu, select the target host IP or host name. Click OK, or press Enter after selecting a host name or IP address. The IDE starts to connect to the host and attempts to download the site list.
    If the target host has security enabled, then a log-in dialog box opens to let you log in. After successfully connecting to the target host, the host is added to the Host menu.
    When the IDE is connected to a remote site, and loads a NetConfig file:
    • If NetConfig already stores hostname, then the IDE shows the host server name, or IP address, when the Destination Configuration dialog box is opened.
    • If you specify hostname in the field, then a prompt opens to confirm if this is the connected host server or the client machine. It also confirms whether to always save hostname to the machine IP on which the IDE is running, not the server machine IP.
  6. For Site, all site names are downloaded from the currently connected host and added to the Site menu.
    The current site on the current host is not on the Site menu. There is no requirement to do inter-site routing to a thread in the current site.
    The first site in the list is automatically selected. You can select a different site as required.
    After any site is selected or the selected site is changed, the thread is updated to list all the public threads in the selected sites. The thread can be empty if there is no public thread in the selected site.
  7. Port is automatically populated with the port read from the public thread if the thread is selected from an outside site.
  8. Click Refresh to update the site list, public thread list, and their port numbers from the selected host.
    When the refresh has successfully finished, the menu lists and the Port text are automatically updated with the newest data.
    Note: The Host, Site, Thread, and Port fields are all editable. You can directly specify values without connecting to the target host.
  9. Click Verify Thread.
    Only the basic validation is performed to ensure that Destination Name, Host, Site, Thread, and Port are not empty. The committing is blocked if any of the necessary fields are empty.

    To check whether the configured host, site, thread, and port are valid, clicking Verify Thread does the whole validation for the destination thread. In addition to checking whether the values are empty, it also attempts to connect to the specified host server and open the specified site. When the site is opened, it checks if the public thread exists on the site and that the port is matched with the current one. If any of these are invalid, then the dialog box automatically goes to the Verifications tab with a list of all errors.