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:
-
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.
-
This option is for reusing thread definitions.
See Thread template.
-
Select this to create a destination that represents a public thread from out-of-site on the current site.
See Inter-site routing.
-
Use this option to create copies of threads:
- Right-click the icon to be copied. A connection menu opens for that thread. Select .
- Right-click in an empty portion of the dialog box. Select from the menu.
- A duplicate
icon displays numbered
conn_x1
, wherex
is the thread number and1
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.
-
When this is clicked, if a NetConfig error exists, the dialog box automatically goes to the Verifications tab with a listing of all errors.
-
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.
-
Deletes all selected threads. The route/reply route is deleted if any of its source or destination threads are deleted.
-
Clicking this turns the cursor into a crosshair, so you can create a new route to another thread.
-
Clicking this turns the cursor into a crosshair, so you can create a new reply route to another thread.
- Opens the Create View dialog box, where you can create a view for the new thread.
-
Opens the New BOX Wizard.
-
Saves the selected thread as a template.
See Thread template.