## Dump Variables

The Dump Variables function is intended to be used primarily for debugging actions. You specify a prompt message to be displayed in the Action Pending Window. The prompt message has variable values appended. You specify which combination of variables, if any, you wish to be dumped. You can choose from:

> Track Variables
>   These are the ten variables stored within each track. For this variable class you can choose:
>   Snapshot
>     When executing Stepwise, a snapshot displays a single set of values for the variables contained across all selected files. If a variable has more than one value across all tracks it will be displayed as multiple values. If executing Groupwise, the variables in the current track will be displayed.
>   Per Track
>     When executing Stepwise, the variables in all selected tracks will be displayed. If executing Groupwise, the variables in the current track will be displayed.
>   None
>     No variables contained in tracks will be displayed.
> System Variables
>   The ten system variables will be dumped.
> Named Variables
>   The complete set of current named variables will be dumped. Note that named variables which have an empty value will not be displayed.

You can also display the current action test state value.

Additionally you can display the call stack which lists every active call's location and execution mode (grouped or stepwise) at the time of the call.

You can set the text color for the prompt to one of Default, (Preferences-General), Black, Blue or Red.

You can elect to issue a beep with the prompt.

The supplied prompt string may contain any of the escape sequences described in Escape Sequences. The prompt is a multi line scrolling area.

The displayed window will have a Copy button, enabling you to copy the displayed information to the system clipboard.

By default, while batch processing, the results will be placed in the batch log file. If the UI option is specified, the results will be issued to the UI. The UI option is intended to be used within the special Batch Start and Batch End inline actions. When run while batch processing the text color option is ignored. When not batch processing the UI option is ignored.