Execution menu options: Difference between revisions
No edit summary |
No edit summary |
||
Line 6: | Line 6: | ||
{| | {| | ||
|width="50%"| | |width="50%"| ''' Step ''' | ||
|width="50%"| <span class="f_DefListDD">Executes the next executable User Language statement. </span> | |width="50%"| <span class="f_DefListDD">Executes the next executable User Language statement. </span> | ||
|- | |- | ||
| | | ''' Step Out ''' | ||
| <span class="f_DefListDD">Discontinues debugging and leaves the current simple or complex subroutine, user method, or daemon, and resumes debugging on the statement following the statement that called that subroutine, user method, or daemon. Described further in [[ | | <span class="f_DefListDD">Discontinues debugging and leaves the current simple or complex subroutine, user method, or daemon, and resumes debugging on the statement following the statement that called that subroutine, user method, or daemon. Described further in [[Stepping out|Stepping out]].</span> | ||
|- | |- | ||
| | | ''' Step Over ''' | ||
| <span class="f_DefListDD">Executes the next executable SOUL statement, if it is </span> | | <span class="f_DefListDD">Executes the next executable SOUL statement, if it is </span>'''not'''<span class="f_DefListDD"> </span><span class="f_Para">a simple or complex </span><var>Model 204</var><span class="f_Para"> subroutine or </span><span class="f_DefListDD">an OO </span><span class="f_Para">method</span><span class="f_DefListDD">. Skips to the statement </span>''after''<span class="f_DefListDD">, if the next executable statement is such a subroutine or method invocation. Same as [[Step, Step Over, and Run#Step Over|using the Step Over button]]. </span> | ||
|- | |- | ||
| | | ''' Run ''' | ||
| <span class="f_DefListDD">Executes </span><span class="f_Para">User Language statements in the program being debugged until the end of the request</span><span class="f_DefListDD"> or until interrupted by a breakpoint, program error, or daemon call. </span> | | <span class="f_DefListDD">Executes </span><span class="f_Para">User Language statements in the program being debugged until the end of the request</span><span class="f_DefListDD"> or until interrupted by a breakpoint, program error, or daemon call. </span> | ||
|- | |- | ||
| | | ''' Run Without Daemons ''' | ||
| <span class="f_DefListDD">Performs the same functionality as </span>< | | <span class="f_DefListDD">Performs the same functionality as </span><var>Run</var><span class="f_DefListDD">, but unlike </span><var>Run</var><span class="f_DefListDD">, [[Debugging requests that spawn daemons#Discontinue Daemon debugging|is not interrupted by daemon code]]. </span> | ||
|- | |- | ||
| | | ''' Run Until Variable Changes ''' | ||
| <span class="f_DefListDD">Steps through the program being debugged, stopping if a statement modifies the value of the variable specified in the </span><span class="f_ListNum1">text box above the </span>< | | <span class="f_DefListDD">Steps through the program being debugged, stopping if a statement modifies the value of the variable specified in the </span><span class="f_ListNum1">text box above the </span><var>Watch Window.</var><span class="f_DefListDD"> Displays t</span><span class="f_Para">he statement that modified the variable and the new variable value in the </span><var>Execution Trace</var><span class="f_Para"> tab. </span><span class="f_DefListDD">Same as the [[Tracing until a value change or until a value match|Run to Change button]]. </span> | ||
|- | |- | ||
| | | ''' Run Until Proc ''' | ||
| <span class="f_DefListDD">Runs program code without interruption until it reaches the procedure specified on the </span>< | | <span class="f_DefListDD">Runs program code without interruption until it reaches the procedure specified on the </span><var>Proc Selection</var><span class="f_DefListDD"> page in the </span><var>Run Until Procedure</var><span class="f_DefListDD"> text box, then displays that procedure for debugging. Same as the [[Running to a specific procedure|Run to Procedure button]]. </span> | ||
|- | |- | ||
| | | ''' Get/Display History ''' | ||
| <span class="f_DefListDD">Displays a [[ | | <span class="f_DefListDD">Displays a [[Displaying a statement history|history]] of the statements executed </span>''thus far''<span class="f_DefListDD"> during program evaluation. The history includes calls and returns for methods and subroutines (as many as 1000 statements). </span> | ||
|- | |- | ||
| <span id="select_previous_history_line" class="hmanchor"></span> | | <span id="select_previous_history_line" class="hmanchor"></span>''' Select Previous History Line </span> | ||
| | | | ||
<span class="f_DefListDD">Scans chronologically backward in the statement [[ | <span class="f_DefListDD">Scans chronologically backward in the statement [[Displaying a statement history|execution history]], then highlights </span>''in the'' <var style="font-style: italic;">Source Code</var> ''or'' <var style="font-style: italic;">Daemon</var> ''tab''<span class="f_DefListDD"> the statement that was executed immediately prior to the statement that is currently [[Changing the colors in Client displays#To make a color change|highlighted with the Execution Position color]].</span> | ||
<span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[ | <span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[previousHistory command|previousHistory]]</span><span class="f_DefListDD"> command. </span> | ||
|- | |- | ||
| <span id="select_next_history_line" class="hmanchor"></span> | | <span id="select_next_history_line" class="hmanchor"></span>''' Select Next History Line </span> | ||
| | | | ||
<span class="f_DefListDD">Scans chronologically forward in the statement [[ | <span class="f_DefListDD">Scans chronologically forward in the statement [[Displaying a statement history|execution history]], then highlights </span>''in the'' <var style="font-style: italic;">Source Code</var> ''or'' <var style="font-style: italic;">Daemon</var> ''tab''<span class="f_DefListDD"> the statement that was executed immediately following the statement that is currently [[Changing the colors in Client displays#To make a color change|highlighted with the Execution Position color]]. </span> | ||
<span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[ | <span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[nextHistory command|nextHistory]]</span><span class="f_DefListDD"> command. </span> | ||
|- | |- | ||
| | | ''' Select First History Line ''' | ||
| | | | ||
<span class="f_DefListDD">Scans chronologically backward in the current statement [[ | <span class="f_DefListDD">Scans chronologically backward in the current statement [[Displaying a statement history|execution history]], then highlights </span>''in the'' <var style="font-style: italic;">Source Code</var> ''or'' <var style="font-style: italic;">Daemon</var> ''tab''<span class="f_DefListDD"> the first (earliest) statement in the history. </span> | ||
<span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[ | <span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[firstHistory command|firstHistory]]</span><span class="f_DefListDD"> command. </span> | ||
|- | |- | ||
| | | ''' Select Last History Line ''' | ||
| | | | ||
<span class="f_DefListDD">Scans chronologically forward in the current statement [[ | <span class="f_DefListDD">Scans chronologically forward in the current statement [[Displaying a statement history|execution history]], then highlights </span>''in the'' <var style="font-style: italic;">Source Code</var> ''or'' <var style="font-style: italic;">Daemon</var> ''tab''<span class="f_DefListDD"> the last (latest) statement in the history. </span> | ||
<span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[ | <span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[lastHistory command|lastHistory]]</span><span class="f_DefListDD"> command. </span> | ||
|- | |- | ||
| | | ''' Trace Until Variable Equals Value ''' | ||
| <span class="f_DefListDD">Steps through the program being debugged, stopping if a statement modifies the value of the variable specified in the </span><span class="f_ListNum1">text box above the </span>< | | <span class="f_DefListDD">Steps through the program being debugged, stopping if a statement modifies the value of the variable specified in the </span><span class="f_ListNum1">text box above the </span><var>Watch Window</var><span class="f_DefListDD"> so that it equals a value you specify. Displays the statement that modified the variable and the new variable value in the </span><var>Execution Trace</var><span class="f_DefListDD"> tab. Same as </span><var>[[Tracing until a value change or until a value match|ALT-Run to Change]]</var><span class="f_DefListDD"> button. </span> | ||
|- | |- | ||
| | | ''' Trace Values ''' | ||
| <span class="f_DefListDD">Performs the same functionality as </span>< | | <span class="f_DefListDD">Performs the same functionality as </span><var>Run</var><span class="f_DefListDD">, but also reports in the </span><var>Execution Trace</var><span class="f_DefListDD"> tab all statements that modify a selected variable and what value was assigned to the variable. Described further in [[Tracing all updates to a variable's value|Tracing all updates to a variable's value]].</span> | ||
|- | |- | ||
| | | ''' Trace To End ''' | ||
| <span class="f_DefListDD">Performs the same functionality as </span>< | | <span class="f_DefListDD">Performs the same functionality as </span><var>Run</var><span class="f_DefListDD">, but also reports in the </span><var>Execution Trace</var><span class="f_DefListDD"> tab </span><span class="f_Para">a list of all the statements executed. </span><span class="f_DefListDD">Described further in [[Tracing all lines executed|Tracing all lines executed]].</span> | ||
|- | |- | ||
| | | ''' Turn On White List ''' | ||
| <span class="f_Para">Activates [[ | | <span class="f_Para">Activates [[Running only to listed procedures#Invoking White List or Black List processing|White List filtering]], which by default is not active. Same as clicking the </span><var>Turn On White List</var><span class="f_Para"> button on the </span><var>Proc Selection</var><span class="f_Para"> page or executing </span><span class="f_DefListDD">the </span><span class="f_Monospace">[[turnOnWhiteList command|turnOnWhiteList]]</span><span class="f_DefListDD"> command. </span> | ||
|- | |- | ||
| | | ''' Turn Off White List ''' | ||
| <span class="f_Para">Deactivates [[ | | <span class="f_Para">Deactivates [[Running only to listed procedures#Invoking White List or Black List processing|White List filtering]]. Same as clicking the </span><var>Turn off Lists</var><span class="f_Para"> button on the </span><var>Proc Selection</var><span class="f_Para"> page or executing</span><span class="f_DefListDD"> the </span><span class="f_Monospace">[[turnOffWhiteList command|turnOffWhiteList]]</span><span class="f_DefListDD"> command. </span> | ||
|- | |- | ||
| | | ''' Reload White List ''' | ||
| <span class="f_Para">Updates the existing White List with the current contents of the [[ | | <span class="f_Para">Updates the existing White List with the current contents of the [[Running only to listed procedures#Setting up a White or Black List file|whitelist.txt file]], so you can dynamically update your White List. Same as clicking the </span><var>Reload White List</var><span class="f_Para"> button on the </span><var>Proc Selection</var><span class="f_Para"> page or executing</span><span class="f_DefListDD"> the </span><span class="f_Monospace">[[reloadWhiteList command|reloadWhiteList]]</span><span class="f_Para"> </span><span class="f_DefListDD">command.</span><span class="f_Para"> </span> | ||
|- | |- | ||
| | | ''' Turn On Black List ''' | ||
| <span class="f_Para">Activates [[ | | <span class="f_Para">Activates [[Running only to listed procedures#Invoking White List or Black List processing|Black List filtering]], which by default is not active. Same as clicking the </span><var>Turn On Black List</var><span class="f_Para"> button on the </span><var>Proc Selection</var><span class="f_Para"> page or executing </span><span class="f_DefListDD">the </span><span class="f_Monospace">[[turnOnBlackList command|turnOnBlackList]]</span><span class="f_DefListDD"> command. </span> | ||
|- | |- | ||
| | | ''' Turn Off Black List ''' | ||
| <span class="f_Para">Deactivates [[ | | <span class="f_Para">Deactivates [[Running only to listed procedures#Invoking White List or Black List processing|Black List filtering]]. Same as clicking the </span><var>Turn off Lists</var><span class="f_Para"> button on the </span><var>Proc Selection</var><span class="f_Para"> page or executing</span><span class="f_DefListDD"> the </span><span class="f_Monospace">[[turnOffBlackList command|turnOffBlackList]]</span><span class="f_DefListDD"> command. </span> | ||
|- | |- | ||
| | | ''' Reload Black list ''' | ||
| <span class="f_Para">Updates the existing Black List with the current contents of the [[ | | <span class="f_Para">Updates the existing Black List with the current contents of the [[Running only to listed procedures#Setting up a White or Black List file|blacklist.txt file]], so you can dynamically update your Black List. Same as clicking the </span><var>Reload Black List</var><span class="f_Para"> button on the </span><var>Proc Selection</var><span class="f_Para"> page or executing</span><span class="f_DefListDD"> the </span><span class="f_Monospace">[[reloadBlackList command|reloadBlackList]]</span><span class="f_Para"> </span><span class="f_DefListDD">command.</span><span class="f_Para"> </span> | ||
|- | |- | ||
| | | ''' Skip Previewed Source ''' | ||
| <span class="f_Para">When the [[ | | <span class="f_Para">When the [[Previewing program code|Source Preview feature]] is enabled, executes the program that is being previewed but does not download the rest of the source code for viewing or controlled execution. </span> | ||
|- | |- | ||
| | | ''' Debug Previewed Source ''' | ||
| <span class="f_Para">When the [[ | | <span class="f_Para">When the [[Previewing program code|Source Preview feature]] is enabled, triggers a full download of the program source code for normal debugging. If the program has compilation errors, the full compilation error listing is downloaded. </span> | ||
|- | |- | ||
| | | ''' Toggle Init Exclude ''' | ||
| <span class="f_Para">Inverts the way [[ | | <span class="f_Para">Inverts the way [[Selectively excluding source code blocks|Exclude mode]] operates so that it initially excludes code instead of initially including code (until an explicit directive). </span><span class="f_DefListDD">Same as </span><var>[[toggleInitExclude command|toggleInitExclude]] </var><span class="f_DefListDD">command.</span> | ||
|- | |- | ||
| | | ''' Cancel ''' | ||
| <span class="f_DefListDD">Cancels the request being debugged; same as the [[ | | <span class="f_DefListDD">Cancels the request being debugged; same as the [[Cancelling execution|Cancel button]]. Described further in [[Cancelling execution|Cancelling execution]].</span><span class="f_Para"> </span> | ||
|- | |- | ||
| | | ''' Turn Off Debugging ''' | ||
| <span class="f_DefListDD">Stops a debugging session if it is a </span>< | | <span class="f_DefListDD">Stops a debugging session if it is a </span><var>TN3270 Debugger</var><span class="f_DefListDD"> session or if the TN3270 DEBUG command is being used for a web thread. Same as </span><var>[[TN3270 DEBUG Syntax#TN3270 DEBUG OFF|TN3270 DEBUG OFF]]</var><span class="f_DefListDD"> command.</span> | ||
|} | |} | ||
Latest revision as of 15:58, 30 May 2023
The Execution menu options are identified below:
Step | Executes the next executable User Language statement. |
Step Out | Discontinues debugging and leaves the current simple or complex subroutine, user method, or daemon, and resumes debugging on the statement following the statement that called that subroutine, user method, or daemon. Described further in Stepping out. |
Step Over | Executes the next executable SOUL statement, if it is not a simple or complex Model 204 subroutine or an OO method. Skips to the statement after, if the next executable statement is such a subroutine or method invocation. Same as using the Step Over button. |
Run | Executes User Language statements in the program being debugged until the end of the request or until interrupted by a breakpoint, program error, or daemon call. |
Run Without Daemons | Performs the same functionality as Run, but unlike Run, is not interrupted by daemon code. |
Run Until Variable Changes | Steps through the program being debugged, stopping if a statement modifies the value of the variable specified in the text box above the Watch Window. Displays the statement that modified the variable and the new variable value in the Execution Trace tab. Same as the Run to Change button. |
Run Until Proc | Runs program code without interruption until it reaches the procedure specified on the Proc Selection page in the Run Until Procedure text box, then displays that procedure for debugging. Same as the Run to Procedure button. |
Get/Display History | Displays a history of the statements executed thus far during program evaluation. The history includes calls and returns for methods and subroutines (as many as 1000 statements). |
Select Previous History Line |
Scans chronologically backward in the statement execution history, then highlights in the Source Code or Daemon tab the statement that was executed immediately prior to the statement that is currently highlighted with the Execution Position color. Same as the previousHistory command. |
Select Next History Line |
Scans chronologically forward in the statement execution history, then highlights in the Source Code or Daemon tab the statement that was executed immediately following the statement that is currently highlighted with the Execution Position color. Same as the nextHistory command. |
Select First History Line |
Scans chronologically backward in the current statement execution history, then highlights in the Source Code or Daemon tab the first (earliest) statement in the history. Same as the firstHistory command. |
Select Last History Line |
Scans chronologically forward in the current statement execution history, then highlights in the Source Code or Daemon tab the last (latest) statement in the history. Same as the lastHistory command. |
Trace Until Variable Equals Value | Steps through the program being debugged, stopping if a statement modifies the value of the variable specified in the text box above the Watch Window so that it equals a value you specify. Displays the statement that modified the variable and the new variable value in the Execution Trace tab. Same as ALT-Run to Change button. |
Trace Values | Performs the same functionality as Run, but also reports in the Execution Trace tab all statements that modify a selected variable and what value was assigned to the variable. Described further in Tracing all updates to a variable's value. |
Trace To End | Performs the same functionality as Run, but also reports in the Execution Trace tab a list of all the statements executed. Described further in Tracing all lines executed. |
Turn On White List | Activates White List filtering, which by default is not active. Same as clicking the Turn On White List button on the Proc Selection page or executing the turnOnWhiteList command. |
Turn Off White List | Deactivates White List filtering. Same as clicking the Turn off Lists button on the Proc Selection page or executing the turnOffWhiteList command. |
Reload White List | Updates the existing White List with the current contents of the whitelist.txt file, so you can dynamically update your White List. Same as clicking the Reload White List button on the Proc Selection page or executing the reloadWhiteList command. |
Turn On Black List | Activates Black List filtering, which by default is not active. Same as clicking the Turn On Black List button on the Proc Selection page or executing the turnOnBlackList command. |
Turn Off Black List | Deactivates Black List filtering. Same as clicking the Turn off Lists button on the Proc Selection page or executing the turnOffBlackList command. |
Reload Black list | Updates the existing Black List with the current contents of the blacklist.txt file, so you can dynamically update your Black List. Same as clicking the Reload Black List button on the Proc Selection page or executing the reloadBlackList command. |
Skip Previewed Source | When the Source Preview feature is enabled, executes the program that is being previewed but does not download the rest of the source code for viewing or controlled execution. |
Debug Previewed Source | When the Source Preview feature is enabled, triggers a full download of the program source code for normal debugging. If the program has compilation errors, the full compilation error listing is downloaded. |
Toggle Init Exclude | Inverts the way Exclude mode operates so that it initially excludes code instead of initially including code (until an explicit directive). Same as toggleInitExclude command. |
Cancel | Cancels the request being debugged; same as the Cancel button. Described further in Cancelling execution. |
Turn Off Debugging | Stops a debugging session if it is a TN3270 Debugger session or if the TN3270 DEBUG command is being used for a web thread. Same as TN3270 DEBUG OFF command. |