Breaking after READ SCREEN or READ MENU statements: 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 12: Line 12:


* <span class="f_ListBul1">Explicitly [[Using breakpoints#setting_breakpoint|Setting a single breakpoint]] after the READ SCREEN or READ MENU statement. </span>
* <span class="f_ListBul1">Explicitly [[Using breakpoints#setting_breakpoint|Setting a single breakpoint]] after the READ SCREEN or READ MENU statement. </span>
* <span class="f_ListBul1">Have processing automatically paused by default </span><span class="term">after</span><span class="f_ListBul1"> the user interaction following READ SCREEN or READ MENU</span><span class="f_Product">.</span><span class="f_ListBul1"> </span>
* <span class="f_ListBul1">Have processing automatically paused by default </span><span class="term">after</span> the user interaction following READ SCREEN or READ MENU.


<span class="f_Para">To invoke the second of the preceding options: </span>
<span class="f_Para">To invoke the second of the preceding options: </span>


# <span class="f_ListNum1">In the Client, select </span><span class="term">Preferences</span><span class="f_ListNum1"> from the </span><span class="term">File</span><span class="f_ListNum1"> menu (or use the CTRL-P keyboard shortcut). </span>
# <span class="f_ListNum1">In the Client, select </span><span class="term">Preferences</span><span class="f_ListNum1"> from the </span><span class="term">File</span><span class="f_ListNum1"> menu (or use the CTRL-P keyboard shortcut). </span>
# <span class="f_ListNum1">In the </span><span class="term">Preferences</span><span class="f_ListNum1"> dialog box, select the </span><span class="term">Break after READ SCREEN</span><span class="f_ListNum1"> checkbox (it is clear by default), then click </span><span class="term">Done:</span><span class="f_ListNum1"> </span>
# <span class="f_ListNum1">In the </span><span class="term">Preferences</span><span class="f_ListNum1"> dialog box, select the </span><span class="term">Break after READ SCREEN</span><span class="f_ListNum1"> checkbox (it is clear by default), then click </span>'''Done''' :'''
 
[[File:preferences22afrag_zoom50.gif|266x109px|preferences22aFrag]]<span class="f_ListContinue"> </span>
[[File:preferences22afrag_zoom50.gif|266x109px|preferences22aFrag]]<span class="f_ListContinue"> </span>


Line 32: Line 31:
# <span class="f_ListNumNote1">Select </span><span class="term">Preferences</span><span class="f_ListNumNote1"> from the </span><span class="term">File</span><span class="f_ListNumNote1"> menu (or use the CTRL-P keyboard shortcut). </span>
# <span class="f_ListNumNote1">Select </span><span class="term">Preferences</span><span class="f_ListNumNote1"> from the </span><span class="term">File</span><span class="f_ListNumNote1"> menu (or use the CTRL-P keyboard shortcut). </span>
# <span class="f_ListNumNote1">In the </span><span class="term">Preferences</span><span class="f_ListNumNote1"> dialog box, locate the </span><span class="term">3270 Emulator</span><span class="f_ListNumNote1"> text box (in the </span><span class="term">Program Titles</span><span class="f_ListNumNote1"> section) and provide a text string that matches some or all of the title that displays at the top of the emulator window.</span>
# <span class="f_ListNumNote1">In the </span><span class="term">Preferences</span><span class="f_ListNumNote1"> dialog box, locate the </span><span class="term">3270 Emulator</span><span class="f_ListNumNote1"> text box (in the </span><span class="term">Program Titles</span><span class="f_ListNumNote1"> section) and provide a text string that matches some or all of the title that displays at the top of the emulator window.</span>
: The characters in your matching string can be any case and match anywhere in the title. Any trailing blanks you enter are preserved.  
:: The characters in your matching string can be any case and match anywhere in the title. Any trailing blanks you enter are preserved.  
 
[[File:preferences16i2_zoom60.gif|263x178px|preferences16i2]]<span class="f_ListNumNoteContinue"> </span>
[[File:preferences16i2_zoom60.gif|263x178px|preferences16i2]]<span class="f_ListNumNoteContinue"> </span>
 
:: '''Note:'''<span class="f_ListNoteContinue"> If you are working with READ SCREEN or READ MENU in a </span><var>Web Legacy </var><span class="f_ListNoteContinue">application, your browser is the tool with which you respond. Therefore, to have the Debugger pop up your browser window </span><span class="f_Notes">when the Client pauses for READ SCREEN or READ MENU, provide a browser name matching string in the </span><span class="term">Web Browser</span><span class="f_Notes"> text box instead of in the </span><var>3270 Emulator</var><span class="f_ListNumNote1"> text box.</span><span class="f_ListNoteContinue"> </span>
'''Note:'''<span class="f_ListNoteContinue"> If you are working with READ SCREEN or READ MENU in a </span><var>Web Legacy </var><span class="f_ListNoteContinue">application, your browser is the tool with which you respond. Therefore, to have the Debugger pop up your browser window </span><span class="f_Notes">when the Client pauses for READ SCREEN or READ MENU, provide a browser name matching string in the </span><span class="term">Web Browser</span><span class="f_Notes"> text box instead of in the </span><var>3270 Emulator</var><span class="f_ListNumNote1"> text box.</span><span class="f_ListNoteContinue"> </span>
 
: 3. <span class="f_ListNumNote1">Click </span><span class="term">Done.</span><span class="f_ListNumNote1"> </span>
: 3. <span class="f_ListNumNote1">Click </span><span class="term">Done.</span><span class="f_ListNumNote1"> </span>
:: The feature takes effect at the next execution of a <span class="f_Notes">READ SCREEN or READ MENU</span><span class="f_ListNum1">. </span><span class="f_ListNumNoteContinue">The</span><var> 3270 Emulator</var><span class="f_ListNumNoteContinue"> (or </span><span class="term">Web Browser</span><span class="f_ListNumNoteContinue">) setting that exists at the end of the Client session persists to the next run of the Client. </span>
:: The feature takes effect at the next execution of a <span class="f_Notes">READ SCREEN or READ MENU</span><span class="f_ListNum1">. </span><span class="f_ListNumNoteContinue">The</span><var> 3270 Emulator</var><span class="f_ListNumNoteContinue"> (or </span><span class="term">Web Browser</span><span class="f_ListNumNoteContinue">) setting that exists at the end of the Client session persists to the next run of the Client. </span>


'''Note:'''<span id="windows_suspended" class="hmanchor"></span><span class="f_ListNoteContinue"> By default, this feature does not take effect if the Client is not debugging the part of a program that contains </span><span class="f_ListNumNoteContinue">the READ SCREEN or READ MENU. For example, these statements might be in code selected to be [[Excluding sections of source code from debugging|excluded from debugging.]] </span>
:: '''Note:'''<span id="windows_suspended" class="hmanchor"></span><span class="f_ListNoteContinue"> By default, this feature does not take effect if the Client is not debugging the part of a program that contains </span><span class="f_ListNumNoteContinue">the READ SCREEN or READ MENU. For example, these statements might be in code selected to be [[Excluding sections of source code from debugging|excluded from debugging.]] </span>
: However, if in addition to a <span class="term">Program Titles</span><span class="f_ListNumNoteContinue"> value you also select the </span><span class="term">Windows When Suspended</span><span class="f_ListNumNoteContinue"> option in the </span><span class="term">Preferences</span><span class="f_ListNumNote1"> dialog box (</span><span class="term">Execution Options</span><span class="f_ListNumNote1"> section), </span><span class="f_ListNumNoteContinue">the feature will apply whenever these statements occur, even in code the Debugger is not actively executing. This will apply whether or not you have selected t</span><span class="f_Para">he </span><span class="term">Break after READ SCREEN</span><span class="f_ListNumNoteContinue"> checkbox. </span>
: However, if in addition to a <span class="term">Program Titles</span><span class="f_ListNumNoteContinue"> value you also select the </span><span class="term">Windows When Suspended</span><span class="f_ListNumNoteContinue"> option in the </span><span class="term">Preferences</span><span class="f_ListNumNote1"> dialog box (</span><span class="term">Execution Options</span><span class="f_ListNumNote1"> section), </span><span class="f_ListNumNoteContinue">the feature will apply whenever these statements occur, even in code the Debugger is not actively executing. This will apply whether or not you have selected t</span><span class="f_Para">he </span><span class="term">Break after READ SCREEN</span><span class="f_ListNumNoteContinue"> checkbox. </span>



Latest revision as of 15:34, 7 April 2023

Normally, the Debugger Client for the TN3270 Debugger pauses at a READ SCREEN or READ MENU statement (displaying a Full Screen Read Pending message in the Status bar), waiting for input from the Online user. Once you complete the input, the Client evaluates your response, displays a READ SCREEN Completed message in the Status bar, and continues (without pause, by default) processing statements until it reaches a breakpoint or the end of the request.

These events are reported in a sequence of lines in the Client Audit Trail page like the following:

... 10:01:48.27      2     20 LI I SCREENO   ... 10:01:48.27      2     20 MS M204.1168: IN FILE GWDEB INCLUDE SCREENO ... 10:02:10    Full Screen Read Pending  ... 10:02:22    READ SCREEN completed  

If you want to examine how the program handles the user response to the READ SCREEN or READ MENU, for example, you can do either of the following:

  • Explicitly Setting a single breakpoint after the READ SCREEN or READ MENU statement.
  • Have processing automatically paused by default after the user interaction following READ SCREEN or READ MENU.

To invoke the second of the preceding options:

  1. In the Client, select Preferences from the File menu (or use the CTRL-P keyboard shortcut).
  2. In the Preferences dialog box, select the Break after READ SCREEN checkbox (it is clear by default), then click Done :

preferences22aFrag

After the Online user replies to the next READ SCREEN or READ MENU statement, the Debugger will pause at the statement following the READ SCREEN or READ MENU, and READ SCREEN completed will display in the Status bar.
Running without a break after replying to READ SCREEN or READ MENU can be restored at any time by clearing the Break after READ SCREEN checkbox.

Note: The Client setPreference command has an option that lets you toggle the Break after READ SCREEN checkbox.

The Break after READ SCREEN setting that exists at the end of the Debugger Client session persists to the next run of the Client.

Note: As a convenience, the Debugger can bring your 3270 Emulator application to the top on your PC screen when the Client pauses for the READ SCREEN or READ MENU.

To invoke this feature:
  1. Select Preferences from the File menu (or use the CTRL-P keyboard shortcut).
  2. In the Preferences dialog box, locate the 3270 Emulator text box (in the Program Titles section) and provide a text string that matches some or all of the title that displays at the top of the emulator window.
The characters in your matching string can be any case and match anywhere in the title. Any trailing blanks you enter are preserved.

preferences16i2

Note: If you are working with READ SCREEN or READ MENU in a Web Legacy application, your browser is the tool with which you respond. Therefore, to have the Debugger pop up your browser window when the Client pauses for READ SCREEN or READ MENU, provide a browser name matching string in the Web Browser text box instead of in the 3270 Emulator text box.
3. Click Done.
The feature takes effect at the next execution of a READ SCREEN or READ MENU. The 3270 Emulator (or Web Browser) setting that exists at the end of the Client session persists to the next run of the Client.
Note: By default, this feature does not take effect if the Client is not debugging the part of a program that contains the READ SCREEN or READ MENU. For example, these statements might be in code selected to be excluded from debugging.
However, if in addition to a Program Titles value you also select the Windows When Suspended option in the Preferences dialog box (Execution Options section), the feature will apply whenever these statements occur, even in code the Debugger is not actively executing. This will apply whether or not you have selected the Break after READ SCREEN checkbox.

preferences17hfrag