Thread icons

The icons on the Network Configurator represent threads, or connections, that come from or go to an external system. Each system that sends and receives messages through the engine should have a corresponding icon.

Ordered NetConfig

NetConfig contains many processes and threads. There are two types of thread:

  • Protocol thread
  • Destination thread

The order of processes and threads is often changed after saving. For example, in previous Cloverleaf versions, saving the NetConfig could cause the process and thread order within NetConfig to change.

Maintaining the order of processes and threads is necessary to for merging changes by multiple users.

The user ID is a unique property of threads and processes. This ID is composed of hash code containing the file name and sequence number. The sequence starts at "1" and increases by 1. For example, when there are 4 threads, the sequences are from 1 to 4.

The ID is set for each process and thread when loading NetConfig. This property cannot be edited or deleted.

Renamed threads keep their IDs, so their positions do not change. Threads and processes are sorted by ID when saving NetConfig.

New threads and processes do not have an ID, and are sorted by name. These are saved at the end of threads and processes.

Threads and processes from several NetConfig are ordered by file name first, followed by sequence.

Overwritten or merged threads and processes keep their positions.

For BOX deployment, the threads in NetConfig can be from a BOX or site. They are saved together when they are from the same file. For example:

Thread from site Thread from BOX
thread1 thread2
thread3 thread4

After BOX deployment, the order could be:

  • thread1, thread3, thread2, thread4
  • thread2, thread4, thread1, thread3

Creating a new thread/destination

The right-click menu has these options:

  • New Thread

    Click to create a new thread icon. The first icon displays with the name "conn_1." Subsequent icons are numbered consecutively. Create as many icons as required for your configuration.

  • New Thread from Template

    This option is for reusing thread definitions.

    See Thread template.

  • New Destination

    Select this to create a destination that represents a public thread from out-of-site on the current site.

    See Inter-site routing.

  • Paste

    Use this option to create copies of threads:

    • Right-click the icon to be copied. A connection menu opens for that thread. Select Copy.
    • Right-click in an empty portion of the dialog box. Select Paste Thread from the menu.
    • A duplicate icon displays numbered conn_x1, where x is the thread number and 1 is the copy number. Subsequent copies are numbered consecutively.

Configuring the icon

Right-click the icon to be configured to open a menu of options.

  • Verify

    When this is clicked, if a NetConfig error exists, the dialog box automatically goes to the Verifications tab with a listing of all errors.

  • Copy

    Generates a duplicate of the selected thread. The copy contains the same configuration characteristics as the original, including routes. The routes, including reply routes, cannot be copied or pasted alone. Copies are based on the related source/destination thread selection status:

    Routes cannot be copied, even if selected, if the source or destination is not selected.

    If the route and only its source thread are selected, then the route is also copied. The new pasted route connects the new copied thread to the original destination.

    If the route and only its destination thread are selected, then the route is also copied. The new pasted route connects the original source to new pasted destination thread.

    If only the destination thread is selected without selecting the route, then the route to the selected destination is not copied.

    If the source and destination threads of a route are selected and copied, then the new source thread has a route to the new destination thread. This is without regard to the route selection status. The pasted route does not point to the original destination thread.

  • Delete

    Deletes all selected threads. The route/reply route is deleted if any of its source or destination threads are deleted.

  • Create Route

    Clicking this turns the cursor into a crosshair, so you can create a new route to another thread.

  • Create Reply Route

    Clicking this turns the cursor into a crosshair, so you can create a new reply route to another thread.

  • Create View Opens the Create View dialog box, where you can create a view for the new thread.
  • Create BOX

    Opens the New BOX Wizard.

  • Save as Template

    Saves the selected thread as a template.

    See Thread template.