Execution menu options: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
__TOC__
The <var>Execution</var><span class="f_Para"> menu options are identified below: </span>
<span class="f_Para">The </span><var>Window</var><span class="f_Para"> menu options are identified below: </span>


[[File:windowmenu4b_zoom80.gif|534x430px|windowMenu4b]]<span class="f_Para">  </span>
[[File:execmenu7a_zoom70.gif|461x477px|execMenu7a]]<span class="f_Para"> </span>
 
<span class="f_Para"> </span>


<div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 10px 0 10px 0;">
<div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 10px 0 10px 0;">


{|
{|
|width="50%"| <span class="f_DefListTerm">'''Top''' </span>
|width="50%"| ''' Step '''
|width="50%"| <span class="f_DefListDD">Scrolls to the top of the currently displayed tab. Same as the [[Button Bar|Top button.]] Comparable mappable command, </span><span class="f_Monospace">[[top command|top]]</span><span class="f_DefListDD">, can be applied to the Client window (main, external, work) that you specify.</span>
|width="50%"| <span class="f_DefListDD">Executes the next executable User Language statement. </span>
|-
|-
| <span class="f_DefListTerm">'''Bottom''' </span>
| ''' Step Out '''
| <span class="f_DefListDD">Scrolls to the bottom of the currently displayed tab. Same as the [[Button Bar|Bottom button]]. Comparable mappable command, </span><span class="f_Monospace">[[bottom command|bottom]]</span><span class="f_DefListDD">, can be applied to the Client window (main, external, work) that you specify.</span>
| <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>
|-
|-
| <span class="f_DefListTerm">'''Clear Audit Trail''' </span>
| ''' Step Over '''
| <span class="f_DefListDD">Clears the contents of the </span><var>Audit Trail</var><span class="f_DefListDD"> tab. Same as the [[Viewing the audit trail|Clear Audit]] button and the </span><span class="f_Monospace">[[clearAudit command|clearAudit]]</span><span class="f_DefListDD"> command. </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>
|-
|-
| <span class="f_DefListTerm">'''Clear Execution Trace'''</span>
| ''' Run '''
| <span class="f_DefListDD">Clears the contents of the </span><var>Execution Trace</var><span class="f_DefListDD"> tab. Same as the </span><span class="f_Monospace">[[clearExecutionTrace command|clearExecutionTrace]]</span><span class="f_DefListDDTable"> </span><span class="f_DefListDD">command.</span><span class="f_DefListDDTable"> </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>
|-
|-
| <span class="f_DefListTerm">'''Clear Web Buffer'''</span>
| ''' Run Without Daemons '''
| <span class="f_DefListDD">Clears the contents of the </span><var>Web Buffer</var><span class="f_DefListDD"> tab. Equivalent mappable command is </span><span class="f_Monospace">[[clearWebBuffer command|clearWebBuffer]]</span><span class="f_DefListDDTable">.</span><span class="f_DefListDD"> </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>
|-
|-
| <span class="f_DefListTerm">'''Copy'''</span>
| ''' Run Until Variable Changes '''
| <span class="f_DefListDD">Copies to the clipboard the lines currently visible in the active tabbed page. Described further in [[The tabbed pages|The tabbed pages.]] </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>
|-
|-
| <span class="f_DefListTerm">'''Paste''' </span>
| ''' Run Until Proc '''
| <span class="f_ListNum1">Pastes the current clipboard contents to the Client's </span><var>Search</var><span class="f_ListNum1"> text box or to the text box above the </span><var>Watch Window.</var>
| <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>
|-
|-
| <span class="f_DefListTerm">'''View Text'''</span>
| ''' Get/Display History '''
| <span class="f_DefListDD">Invokes a [[Copying, printing, or saving text|separate viewer]] for copying, printing, and saving Client text data. </span>
| <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 class="f_DefListTerm">'''Open External Watch Window'''</span>
| <span id="select_previous_history_line" class="hmanchor"></span>''' Select Previous History Line </span>
|
|
<span class="f_DefListDD">Displays in an [[Opening an external window|external window]], that is, separate from the main window, the current contents of the Client </span><var>Watch Window.</var><span class="f_DefListDD"> Or, it brings the existing external </span><var>Watch Window </var><span class="f_DefListDD">to the top of your current stack of open windows. </span>
<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">[[openExternalWatchWindow command|openExternalWatchWindow]]</span><span class="f_DefListDD"> command.</span>
<span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[previousHistory command|previousHistory]]</span><span class="f_DefListDD"> command. </span>
|-
|-
| <span class="f_DefListTerm">'''Open External Audit Trail Window'''</span>
| <span id="select_next_history_line" class="hmanchor"></span>''' Select Next History Line </span>
|
|
<span class="f_DefListDD">Displays in an [[Opening an external window|external window]] the current contents of the Client </span><span class="f_GUIlabel">Audit Trail</span><span class="f_DefListDD"> tab. Or, it brings the existing external </span><span class="f_GUIlabel">Audit Trail</span><span class="f_DefListDD"> window</span><span class="f_GUIlabel"> </span><span class="f_DefListDD">to the top of your current stack of open windows. </span>
<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">[[openExternalAuditTrailWindow command|openExternalAuditTrail]]</span><span class="f_DefListDD"> command.</span>
<span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[nextHistory command|nextHistory]]</span><span class="f_DefListDD"> command. </span>
|-
|-
| <span class="f_DefListTerm">'''Open External Web Buffer Window'''</span>
| ''' Select First History Line '''
|
|
<span class="f_DefListDD">Displays in an [[Opening an external window|external window]] the current contents of the Client </span><var>Web Buffer</var><span class="f_DefListDD"> tab. Or, it brings the existing external </span><var>Web Buffer </var><span class="f_DefListDD">window</span> <span class="f_DefListDD">to the top of your current stack of open windows. </span>
<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">[[openExternalWebBufferWindow command|openExternalWebBuffer]]</span><span class="f_DefListDD"> command.</span>
<span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[firstHistory command|firstHistory]]</span><span class="f_DefListDD"> command. </span>
|-
|-
| <span class="f_DefListTerm">'''Open External Execution Trace Window'''</span>
| ''' Select Last History Line '''
|
|
<span class="f_DefListDD">Displays in an [[Opening an external window|external window]] the current contents of the Client </span><span class="f_GUIlabel">Execution Trace</span><span class="f_DefListDD"> tab. Or, it brings the existing external </span><span class="f_GUIlabel">Execution Trace </span><span class="f_DefListDD">window</span> <span class="f_DefListDD">to the top of your current stack of open windows. </span>
<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">[[openExternalExecutionTraceWindow command|openExternalExecutionTrace]]</span><span class="f_DefListDD"> command.</span>
<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><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><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><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 [[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 [[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 [[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 [[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 [[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 [[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>
|-
|-
| <span id="show_main_button_bar_win" class="hmanchor"></span><span class="f_DefListTerm">'''Show Main Button Bar In External Window''' </span>
| ''' Skip Previewed Source '''
|
| <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>
<span class="f_DefListDD">Displays in an [[Opening an external window|external window]] the current contents of the Client [[Button Bar|main button bar]]. Or, it brings the existing external </span><var>Button Bar </var><span class="f_DefListDD">window</span> <span class="f_DefListDD">to the top of your current stack of open windows. </span>
|-
 
| ''' Debug Previewed Source '''
<span class="f_DefListDD">Same as the </span><span class="f_Monospace">[[buttonBar command|buttonBar show]]</span><span class="f_DefListDD"> command.</span>
| <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 [[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>
|-
|-
| <span class="f_DefListTerm">'''Show Extra Button Bar Window'''</span>
| ''' Cancel '''
| <span class="f_DefListDD">Displays in an [[Opening an external window|external window]] the current contents of the Client [[Button Bar#Launching a second button bar|Extra button bar]]. Or, it brings the existing external </span><span class="f_GUIlabel">Extra Buttons </span><span class="f_DefListDD">window</span> <span class="f_DefListDD">to the top of your current stack of open windows. </span>
| <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>
|-
|-
| <span class="f_DefListTerm">'''Close External Windows'''</span>
| ''' Turn Off Debugging '''
| <span class="f_DefListDD">Closes all Client [[Opening an external window|external windows.]] Same as the </span><span class="f_Monospace">[[closeExternalWindows command|closeExternalWindows]] </span><span class="f_DefListDD">command.</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>
|}
|}




</div>
</div>
[[Category:Debugger Home]]
[[Category: Debugger Home]]

Latest revision as of 15:58, 30 May 2023

The Execution menu options are identified below:

execMenu7a

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.