The Debug panel is displayed whenever debugging starts. The top of the panel displays the configured content and if initiated by a Debug statement, whatever prompt text (if any) was specified. What information is displayed can be configured in the Debug Content Configuration panel which is displayed via the Configure button.
The area to the top of the Configure button displays the following:
- A status indicating the value of the action debug state.
- A status indicating if breakpoints are enabled.
- A status indicating the value of the action test state.
- A status indicating if implicit exits are enabled.
A red circle icon implies false and a green circle icon implies true. Clicking on a displayed status toggles its value. Be careful when you change the value of the action test state. While this may be useful for testing, it does change the value of the action test state as it was set by the action execution.
The disclosure control to the right of the Configure button provides additionally functionality by a displayed menu. The following items are available:
- Open Action
- A menu will be displayed containing all of your actions. You can use this menu to select an action to be opened in an action editor window. You can edit the opened action but it cannot be saved until action processing terminates.
- Open Action from Call Stack
- A menu will be displayed representing the call stack. Selecting menu item opens the action and positions to the appropriate line number. You can edit the opened action but it cannot be saved until action processing terminates.
- View Metadata for all Active Files
- This is equivalent to doing a View>Metadata as Text. The metadata will be displayed in the Log Viewer.
- View Metadata for Initial Set of Files
- File availability statements can cause the set of active files to differ from the initial set of files.
- View Metadata for Current File
- When executing grouped or in an action started by a Load & Run statement, or a Run statement is being executed which sets the file availability by testing a track variable, there is the concept of the current file. This item is only displayed when pertinent.
- View Container
- A menu will be displayed containing the names of all active containers. Selecting a container will display its content in the Log Viewer.
- View Debug Info in Log Viewer
- The debug panel's content will be displayed in the Log Viewer with a fixed font. Note that the Compress content configuration setting is effectively disabled when the content is displayed. Displaying the content in the Log Viewer allows to you see it in its entirety and to save it to a file.
The Continue button will close the debug panel and return control to the executing action.
You can also exit the debug panel by stepping to a subsequent statement. There are four types of stepping:
- Step (➔)
Step will cause the debug panel to again be displayed on the next statement to be executed. This statement can potentially be in a different action.
- Step over (⤵︎)
This form will attempt to step over the next statement to be executed. The statement executed after it finishes will be displayed in the debug panel. ie. the statements in the called action will not be debugged. This mode is only meaninful for the following statement. For any other statement type, Step over is equivalent to Step.
- Load & Run
- Repeat For
- Repeat Forever
- Repeat With
- Run or Test & Run
- Step out (↑)
This form will debug the next statement to be executed, if any, after the current action is terminated. If you are in the main portion of an executing action, no subsequent statements will be debugged prior to termination.
- Step out grouped (⇑)
If an action is executing grouped, the next statement to be debugged will be the first statement for the next file or the statement after the call if there is no next file. If an action is not executing grouped, the mode is equivalent to the Step out (↑) mode.
Additional information on the step functions can be found in the Debugging Actions topic.
Debug Content Configuration
The Debug Statement
Debugging Actions