Thread Controls dialog box options

This table lists the options on the Thread Controls dialog box:

Option Description
start Starts the selected thread.
stop Stops the selected thread.
start with hold Starts the thread, with the outbound data on hold.
start with sticky hold Starts the thread with the last hold status.
restart Restarts the selected thread. When restarting a thread, the GUI can still be operated. The command line output is appended to the Command and Engine Output pane. The thread status icon on the GUI changes from green to red to green again.
hold Holds outbound messages in the outbound queue.
release Releases any messages currently being held.
hold reply Holds transmission of all reply messages for the selected thread until released.
release reply Releases hold on all or a specified number of reply messages.
start save Starts the saved message file.
stop save Stops the saved message file.
cycle save Causes the current saved message (SMAT) file to close and be renamed with an .old extension, and then opens a new saved message file. Each thread can have at most two SMAT files, one for inbound data and one for outbound data. The names and locations of these SMAT files are user-definable.
Note: The engine automatically turns off saved messaging when disk space reaches a certain threshold (90%). It turns on again when the percentage used drops below the threshold. This has no effect on the actual messages successfully sent to the receiving system. Saved messages are only copies of messages sent when saved messaging is active.
resend Opens the Resend Datafile dialog box. Use this dialog box to insert a set of messages from a stored file into a running engine.
reload Adds any new Tcl procedures.
purge caches Removes the configuration caches. Use this option after making a change to an existing configuration.
start forward Starts forwarding data messages to a configured destination.
stop forward Stops forwarding data messages.
start reply forward Starts forwarding reply messages to a configured destination.
stop reply forward Stops forwarding reply messages.
watch output Shows engine output as it happens.
browse output Opens the log file of engine output.
engine log configuration Enables the modification of engine output for the current run. This applies an Engine Output (EO) alias, configured in the Engine Output Configurator, to the thread.
reindex Loads Tcl procedures that are created after the engine began running.
status Opens the Status Report dialog box.
message archive log Opens the Message Archive Log Viewer for the archive message logs.
open inbound SMAT Opens the corresponding *_in.smatdb file configured in the Network Configurator’s Properties tab, Inbound pane.

The file type opened depends on which SMAT driver is being used. The SMAT driver can be changed by selecting/clearing Save into Database on the SMAT tab of the Site Preferences dialog box.

If it is selected, then the SMAT database file is opened if it has been configured. Otherwise, the SMAT plain file is opened.

open outbound SMAT Opens the corresponding *_out.smatdb file configured in the Network Configurator’s Properties tab, Outbound pane.

The file type opened depends on which SMAT driver is being used. The SMAT driver can be changed by selecting/clearing Save into Database on the SMAT tab of the Site Preferences dialog box.

If it is selected, then the SMAT database file is opened if it has been configured. Otherwise, the SMAT plain file is opened.

reset statistics Resets statistics and counts for a site’s process or thread.

This calls the hcimsiutil engine command.

Note: Before using this option, there is the potential to produce unreliable counts. The memory does not corrupt when this option is used. The engine and Network Monitor both lock the shared memory for any write/clear.