Thread List Application

Applications, as well as some system components, run in their own execution threads so that they do not interfere with the execution of other applications or components. The Thread List analysis utility provides a list of the separate threads of execution for which VTS is responsible.

Note: If the Thread List application is not referenced in the VAM, you must manually add it. The Thread List application's directory is named "ThrdList", and is stored within the VTS installation directory. If you require assistance in adding the Thread List application to the VAM, please refer to the instructions provided in "11: Common Tasks: Adding Existing Applications to the VAM: Add an Existing Script Application to the VAM.

If an execution thread becomes blocked (i.e. freezes or gets stuck while executing a statement), the Thread List analysis tool can be used to identify the offending statement that is causing the blockage. This information provides a starting point for examining the scripting code that has caused the thread to be blocked.

An image of the Thread List utility is displayed below.

As you can see from the image displayed above, the Thread List is composed of the following elements:

Pin The pin button can be selected to always keep the Thread List window on top, or can be deselected to allow the Thread List window to be minimized.

Refresh The Refresh button can be clicked to update the display of threads.

Auto Refresh The Auto Refresh button can be latched on to result in the display of threads being updated automatically twice a second.

Save The Save button can be clicked to save the current thread list data to either a text file or a .CSV file. A file dialog will prompt for a name and provide a choice of setting the extension to either ".txt" or ".csv". In older versions of VTS, this file name would have been "ThreadLog.txt", located within the ThrdList directory which is located within the VTS installation directory (e.g. C:\VTS\ThrdList\ThreadLog.txt).

Append The append button can be selected to add new data to existing files rather than over-writing them.

Thread Name The Thread Name column displays the name or title assigned to each thread.

File Name The File Name column displays the path to and name of the document file that contains the currently executing statement.

Module Name The Module Name column displays the name of the module within the document file (specified in the File Name column) that contains the currently executing statement.

State The State column displays the state within the module that contains the currently executing statement.

Statement $image\Number_Hatch.gif$ The Statement $image\Number_Hatch.gif$ column displays the numerical index of the currently executing statement within the state.

Thread ID The Thread ID column displays the ID number for each thread.