Debugging Web Server persistent sessions - Revision history

Ekern at 18:38, 19 April 2023

2023-04-19T18:38:16Z

← Older revision		Revision as of 18:38, 19 April 2023
Line 21:		Line 21:
	# <span class="f_ListNumNote1">In the <var>Preferences</var><span class="f_ListNumNote1"> dialog box, locate the </span><var>Web Browser</var><span class="f_ListNumNote1"> text box (in the </span><var>Program Titles</var><span class="f_ListNumNote1"> section) and provide a text string that matches some or all of the browser identifying title that displays at the top of the browser window.</span><br /> The characters in your matching string can be any case and match anywhere in the browser title. Any trailing blanks you enter are preserved<br />		# <span class="f_ListNumNote1">In the <var>Preferences</var><span class="f_ListNumNote1"> dialog box, locate the </span><var>Web Browser</var><span class="f_ListNumNote1"> text box (in the </span><var>Program Titles</var><span class="f_ListNumNote1"> section) and provide a text string that matches some or all of the browser identifying title that displays at the top of the browser window.</span><br /> The characters in your matching string can be any case and match anywhere in the browser title. Any trailing blanks you enter are preserved<br />
	: [[File:preferences16h2_zoom55.gif\|244x164px\|preferences16h2]]		: [[File:preferences16h2_zoom55.gif\|244x164px\|preferences16h2]]
	# <span class="f_ListNumNote1">Click </span><var>Done.</var><span class="f_ListNumNote1"> </span>		: 3. <span class="f_ListNumNote1">Click </span><var>Done.</var><span class="f_ListNumNote1"> </span>
	: The feature takes effect at the next execution of a <span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNum1"> function. </span><span class="f_ListNumNoteContinue">The</span><span class="term"> Web Browser</span><span class="f_ListNumNoteContinue"> setting that exists at the end of the Debugger Client session persists to the next run of the Client. </span>		: The feature takes effect at the next execution of a <span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNum1"> function. </span><span class="f_ListNumNoteContinue">The</span><span class="term"> Web Browser</span><span class="f_ListNumNoteContinue"> setting that exists at the end of the Debugger Client session persists to the next run of the Client. </span>

Ekern at 18:37, 19 April 2023

2023-04-19T18:37:23Z

← Older revision		Revision as of 18:37, 19 April 2023
Line 20:		Line 20:
	# <span class="f_ListNumNote1">In the Client, select </span><var>Preferences</var><span class="f_ListNumNote1"> from the </span><var>File</var><span class="f_ListNumNote1"> menu (or use the CTRL-P keyboard shortcut). </span>		# <span class="f_ListNumNote1">In the Client, select </span><var>Preferences</var><span class="f_ListNumNote1"> from the </span><var>File</var><span class="f_ListNumNote1"> menu (or use the CTRL-P keyboard shortcut). </span>
	# <span class="f_ListNumNote1">In the <var>Preferences</var><span class="f_ListNumNote1"> dialog box, locate the </span><var>Web Browser</var><span class="f_ListNumNote1"> text box (in the </span><var>Program Titles</var><span class="f_ListNumNote1"> section) and provide a text string that matches some or all of the browser identifying title that displays at the top of the browser window.</span><br /> The characters in your matching string can be any case and match anywhere in the browser title. Any trailing blanks you enter are preserved<br />		# <span class="f_ListNumNote1">In the <var>Preferences</var><span class="f_ListNumNote1"> dialog box, locate the </span><var>Web Browser</var><span class="f_ListNumNote1"> text box (in the </span><var>Program Titles</var><span class="f_ListNumNote1"> section) and provide a text string that matches some or all of the browser identifying title that displays at the top of the browser window.</span><br /> The characters in your matching string can be any case and match anywhere in the browser title. Any trailing blanks you enter are preserved<br />
	~~<!--~~ [[File:preferences16h2_zoom55.gif\|244x164px\|preferences16h2]]~~</span> -->~~		: [[File:preferences16h2_zoom55.gif\|244x164px\|preferences16h2]]
	# <span class="f_ListNumNote1">Click </span><var>Done.</var><span class="f_ListNumNote1"> </span>		# <span class="f_ListNumNote1">Click </span><var>Done.</var><span class="f_ListNumNote1"> </span>
	: The feature takes effect at the next execution of a <span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNum1"> function. </span><span class="f_ListNumNoteContinue">The</span><span class="term"> Web Browser</span><span class="f_ListNumNoteContinue"> setting that exists at the end of the Debugger Client session persists to the next run of the Client. </span>		: The feature takes effect at the next execution of a <span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNum1"> function. </span><span class="f_ListNumNoteContinue">The</span><span class="term"> Web Browser</span><span class="f_ListNumNoteContinue"> setting that exists at the end of the Debugger Client session persists to the next run of the Client. </span>
Line 26:		Line 26:
	'''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 executing the part of a program that contains </span><span class="f_ListNumNoteContinue">the </span><span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNumNoteContinue">. For example, the statement 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 executing the part of a program that contains </span><span class="f_ListNumNoteContinue">the </span><span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNumNoteContinue">. For example, the statement might be in code selected to be [[Excluding sections of source code from debugging\|excluded from debugging.]] </span>
	: However, if you also select the <span class="term">Windows When Suspended</span><span class="f_ListNumNoteContinue"> option in the </span><var>Preferences</var><span class="f_ListNumNote1"> dialog box (</span><span class="term">Execution Options</span><span class="f_ListNumNote1"> section), </span><span class="f_ListNumNoteContinue">you can make the feature apply whenever this statement occurs, even in code the Debugger is not actively executing. </span>		: However, if you also select the <span class="term">Windows When Suspended</span><span class="f_ListNumNoteContinue"> option in the </span><var>Preferences</var><span class="f_ListNumNote1"> dialog box (</span><span class="term">Execution Options</span><span class="f_ListNumNote1"> section), </span><span class="f_ListNumNoteContinue">you can make the feature apply whenever this statement occurs, even in code the Debugger is not actively executing. </span>
	~~<!--~~ [[File:preferences17hfrag_zoom60.gif\|276x181px\|preferences17hfrag]]~~<span class="f_ListNumNoteContinue"> </span> -->~~		: [[File:preferences17hfrag_zoom60.gif\|276x181px\|preferences17hfrag]]

	==== Legacy Support sessions ====		==== Legacy Support sessions ====

Ekern at 03:21, 4 April 2023

2023-04-04T03:21:44Z

← Older revision		Revision as of 03:21, 4 April 2023
Line 19:		Line 19:
	: To invoke this feature:		: To invoke this feature:
	# <span class="f_ListNumNote1">In the Client, select </span><var>Preferences</var><span class="f_ListNumNote1"> from the </span><var>File</var><span class="f_ListNumNote1"> menu (or use the CTRL-P keyboard shortcut). </span>		# <span class="f_ListNumNote1">In the Client, select </span><var>Preferences</var><span class="f_ListNumNote1"> from the </span><var>File</var><span class="f_ListNumNote1"> menu (or use the CTRL-P keyboard shortcut). </span>
	# <span class="f_ListNumNote1">In the <var>Preferences</var><span class="f_ListNumNote1"> dialog box, locate the </span><var>Web Browser</var><span class="f_ListNumNote1"> text box (in the </span><var>Program Titles</var><span class="f_ListNumNote1"> section) and provide a text string that matches some or all of the browser identifying title that displays at the top of the browser window.</span><br /> The characters in your matching string can be any case and match anywhere in the browser title. Any trailing blanks you enter are preserved<br />[[File:preferences16h2_zoom55.gif\|244x164px\|preferences16h2]]</span>		# <span class="f_ListNumNote1">In the <var>Preferences</var><span class="f_ListNumNote1"> dialog box, locate the </span><var>Web Browser</var><span class="f_ListNumNote1"> text box (in the </span><var>Program Titles</var><span class="f_ListNumNote1"> section) and provide a text string that matches some or all of the browser identifying title that displays at the top of the browser window.</span><br /> The characters in your matching string can be any case and match anywhere in the browser title. Any trailing blanks you enter are preserved<br />
			<!-- [[File:preferences16h2_zoom55.gif\|244x164px\|preferences16h2]]</span> -->
	# <span class="f_ListNumNote1">Click </span><var>Done.</var><span class="f_ListNumNote1"> </span>		# <span class="f_ListNumNote1">Click </span><var>Done.</var><span class="f_ListNumNote1"> </span>
	: The feature takes effect at the next execution of a <span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNum1"> function. </span><span class="f_ListNumNoteContinue">The</span><span class="~~f_GUIlabel~~"> Web Browser</span><span class="f_ListNumNoteContinue"> setting that exists at the end of the Debugger Client session persists to the next run of the Client. </span>		: The feature takes effect at the next execution of a <span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNum1"> function. </span><span class="f_ListNumNoteContinue">The</span><span class="term"> Web Browser</span><span class="f_ListNumNoteContinue"> setting that exists at the end of the Debugger 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 executing the part of a program that contains </span><span class="f_ListNumNoteContinue">the </span><span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNumNoteContinue">. For example, the statement 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 executing the part of a program that contains </span><span class="f_ListNumNoteContinue">the </span><span class="f_ListBul1">$WEB_FORM_DONE</span><span class="f_ListNumNoteContinue">. For example, the statement might be in code selected to be [[Excluding sections of source code from debugging\|excluded from debugging.]] </span>
	: However, if you also select the <span class="term">Windows When Suspended</span><span class="f_ListNumNoteContinue"> option in the </span><var>Preferences</var><span class="f_ListNumNote1"> dialog box (</span><span class="term">Execution Options</span><span class="f_ListNumNote1"> section), </span><span class="f_ListNumNoteContinue">you can make the feature apply whenever this statement occurs, even in code the Debugger is not actively executing. </span>		: However, if you also select the <span class="term">Windows When Suspended</span><span class="f_ListNumNoteContinue"> option in the </span><var>Preferences</var><span class="f_ListNumNote1"> dialog box (</span><span class="term">Execution Options</span><span class="f_ListNumNote1"> section), </span><span class="f_ListNumNoteContinue">you can make the feature apply whenever this statement occurs, even in code the Debugger is not actively executing. </span>
			<!-- [[File:preferences17hfrag_zoom60.gif\|276x181px\|preferences17hfrag]]<span class="f_ListNumNoteContinue"> </span> -->
	[[File:preferences17hfrag_zoom60.gif\|276x181px\|preferences17hfrag]]<span class="f_ListNumNoteContinue"> </span>

	==== Legacy Support sessions ====		==== Legacy Support sessions ====
Line 50:		Line 50:
	# <span class="f_ListNumNote1">Select </span><var>Preferences</var> from the <var>File</var><span class="f_ListNumNote1"> menu. </span>		# <span class="f_ListNumNote1">Select </span><var>Preferences</var> from the <var>File</var><span class="f_ListNumNote1"> menu. </span>
	# <span class="f_ListNumNote1">In the <var>Preferences</var> dialog box, locate the <var>Web Browser</var><span class="f_ListNumNote1"> text box (in the </span><var>Program Titles</var><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 browser window.</span><br /> The characters in your matching string can be any case and match anywhere in the title. Any trailing blanks you enter are preserved.</span>		# <span class="f_ListNumNote1">In the <var>Preferences</var> dialog box, locate the <var>Web Browser</var><span class="f_ListNumNote1"> text box (in the </span><var>Program Titles</var><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 browser window.</span><br /> The characters in your matching string can be any case and match anywhere in the title. Any trailing blanks you enter are preserved.</span>
	# <span class="f_ListNumNote1">Click </span><span class="~~f_GUIlabel~~">Done.</span><span class="f_ListNumNote1"> </span>		# <span class="f_ListNumNote1">Click </span><span class="term">Done.</span><span class="f_ListNumNote1"> </span>

	[[Category:Debugger Home]]		[[Category:Debugger Home]]

Ekern: Created page with "TOC You can use the `Janus Debugger` to debug `Janus Web Server` "persi..."

2022-11-19T02:39:14Z

Created page with "__TOC__ You can use the <var>Janus Debugger</var> to debug <var>Janus Web Server</var> "persi..."

New page

__TOC__
You can use the <var>Janus Debugger</var> to debug <var>Janus Web Server</var> "persistent session" applications. These are applications in which Online program execution is suspended while a browser user returns data to the program, whereupon the program continues. The Debugger supports two such types of Web Server programs:

* HTML form processing using the $WEB_FORM_DONE SOUL function 
* Janus Web Legacy Support, which presents 3270 screens in a web browser 

==== $WEB_FORM_DONE sessions ====

Using the $WEB_FORM_DONE function, a SOUL program can serve an HTML form, suspend execution until the form is submitted, then resume executing the program at the point where it was suspended. 

To debug a $WEB_FORM_DONE application: 

# Invoke the program from your browser; then, in the Debugger Client, step through the program as usual. 
# When a $WEB_FORM_DONE function call executes, the execution of the SOUL program pauses, and Session awaits browser displays in the [[Status bar|Status bar]]. 
# Move from the Client to your browser, respond to the HTML form inputs, and submit the form. 
# Return to the Client, where Persistent Session Resumed displays in the Status bar, and continue debugging. 

'''Note:''' As a convenience, the Debugger can make your web browser window the topmost on your PC screen when the Client pauses as it processes the $WEB_FORM_DONE call. 
: To invoke this feature:
# In the Client, select <var>Preferences</var> from the <var>File</var> menu (or use the CTRL-P keyboard shortcut). 
# In the <var>Preferences</var> dialog box, locate the <var>Web Browser</var> text box (in the <var>Program Titles</var> section) and provide a text string that matches some or all of the browser identifying title that displays at the top of the browser window. The characters in your matching string can be any case and match anywhere in the browser title. Any trailing blanks you enter are preserved [[File:preferences16h2_zoom55.gif|244x164px|preferences16h2]]
# Click <var>Done.</var> 
: The feature takes effect at the next execution of a $WEB_FORM_DONE function. The Web Browser setting that exists at the end of the Debugger Client session persists to the next run of the Client. 

'''Note:''' By default, this feature does not take effect if the Client is not executing the part of a program that contains the $WEB_FORM_DONE. For example, the statement might be in code selected to be [[Excluding sections of source code from debugging|excluded from debugging.]] 
: However, if you also select the Windows When Suspended option in the <var>Preferences</var> dialog box (Execution Options section), you can make the feature apply whenever this statement occurs, even in code the Debugger is not actively executing. 

[[File:preferences17hfrag_zoom60.gif|276x181px|preferences17hfrag]] 

==== Legacy Support sessions ====
By automatically converting 3270 screens to HTML, the <var>Janus Web Legacy Support</var> feature lets you run under the Janus Web Server applications that do 3270 full screen reads. You can debug such an application with the <var>Janus Debugger</var> only if you also license the <var>TN3270 Debugger.</var> 

To debug a <var>Legacy Support</var> application: 

# Invoke the User Language program from your browser, and in the Debugger Client, step through the program as usual. 
# When a READ SCREEN executes, the execution of the program pauses, and Session awaits browser displays in the [[Status bar|Status bar]]. If you have not also purchased the <var>TN3270 Debugger</var>, the web thread is softly restarted and the debugging session is terminated.
# Move from the Debugger Client to your web browser, respond to the screen (now HTML form) prompts, and submit the form by clicking the Enter button or a PF key button.
# Return to the Debugger Client, where Persistent Session Resumed displays in the Status bar, and continue debugging. 

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

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

'''Note:''' As described above for $WEB_FORM_DONE applications, the Debugger can bring your browser to the top on your PC screen when the Client pauses for the READ SCREEN.
: To invoke this feature:

# Select <var>Preferences</var> from the <var>File</var> menu. 
# In the <var>Preferences</var> dialog box, locate the <var>Web Browser</var> text box (in the <var>Program Titles</var> section) and provide a text string that matches some or all of the title that displays at the top of the browser window. The characters in your matching string can be any case and match anywhere in the title. Any trailing blanks you enter are preserved.
# Click Done. 

[[Category:Debugger Home]]

Debugging Web Server persistent sessions - Revision history

Ekern at 18:38, 19 April 2023

Ekern at 18:37, 19 April 2023

Ekern at 03:21, 4 April 2023

Ekern: Created page with "__TOC__ You can use the Janus Debugger to debug Janus Web Server "persi..."

Ekern: Created page with "TOC You can use the `Janus Debugger` to debug `Janus Web Server` "persi..."