Ekern at 14:31, 25 April 2023

2023-04-25T14:31:33Z

← Older revision		Revision as of 14:31, 25 April 2023
Line 6:		Line 6:
	<div class="hmImageMap" style="text-indent:0;margin:10px 10px 10px 10px;width:498px;height:117px;position:relative">		<div class="hmImageMap" style="text-indent:0;margin:10px 10px 10px 10px;width:498px;height:117px;position:relative">

	[[File:tabs3_zoom75.gif\|tabs3]][[tour_tabbed_pages.html#proc_selection_tab\|]][[tour_tabbed_pages.html#exec_trace_tab\|]][[tour_tabbed_pages.html#web_buffer_tab\|]][[tour_tabbed_pages.html#source_code_tab\|]][[tour_tabbed_pages.html#audit_trail_tab\|]]		[[File:tabs3_zoom75.gif\|tabs3]]<!--[[tour_tabbed_pages.html#proc_selection_tab\|]][[tour_tabbed_pages.html#exec_trace_tab\|]][[tour_tabbed_pages.html#web_buffer_tab\|]][[tour_tabbed_pages.html#source_code_tab\|]][[tour_tabbed_pages.html#audit_trail_tab\|]] this is all jquery stuff from the original html scrape, doesn't work here as far as I know, and mediawiki has its own system for hyperlinking within a page -->

	</div>		</div>

Ekern: Created page with "TOC An important part of the user interface to the `Janus Debugger` or the `TN3270 Debugger`
2022-11-26T02:48:19Z

Created page with "TOC An important part of the user interface to the <var>Janus Debugger</var> or the <var>TN3270 Debugger</var><span..."

New page
TOC
An important part of the user interface to the <var>Janus Debugger</var> or the <var>TN3270 Debugger</var> is the set of tabbed pages that use the main display window below them (the Web Buffer tab is not present for TN3270 Debugger sessions; [[Debugging requests that spawn daemons|Daemon tabs]] display dynamically if the program invokes daemons):

<div class="p_Normal">

<div class="hmImageMap" style="text-indent:0;margin:10px 10px 10px 10px;width:498px;height:117px;position:relative">

[[File:tabs3_zoom75.gif|tabs3]][[tour_tabbed_pages.html#proc_selection_tab|]][[tour_tabbed_pages.html#exec_trace_tab|]][[tour_tabbed_pages.html#web_buffer_tab|]][[tour_tabbed_pages.html#source_code_tab|]][[tour_tabbed_pages.html#audit_trail_tab|]]

</div>
 

</div>
These pages are resizable by mouse if you grab and drag the black border bar at the bottom of the main window. 

The pages are copyable: 

* If you press the CTRL-C keyboard key combination or select the Copy option from the Window menu, the contents of the active (topmost) page are copied to the Windows clipboard. The number of lines copied is displayed in the [[Status bar|Status bar]]. Only the Proc Selection page is not copyable. 
* If you [[Introducing the configurable components|map the viewText command]] to a Client button or hot key, or select its equivalent from the Window menu, you can [[Copying, printing, or saving text|invoke a text viewer]] that lets you copy, edit, print, and save text data from Client pages. 

Some of the pages are displayable in windows outside of the Client. These [[Opening an external window|external]] windows are easily invoked by double clicking their tabbed page name, by selection from the Client's Window menu, or by [[Reconfiguring GUI buttons and hot keys|mappable command]].

=== Audit Trail tab ===
The Audit Trail page displays, from the beginning of the debugging session:

The Model 204 audit trail lines produced by the online thread that is servicing web requests from your browser(s) or by the thread that is servicing your 3270/Batch2 requests

The Model 204 audit trail lines produced by any threads that run daemons on behalf of your web or 3270/Batch2 requests 

* Information about the state of the Debugger Client, such as the port on which it is listening and the port whose web server requests it is debugging

*All outgoing HTTP messages sent by your browser (passed through by the <var>Janus Debugger</var>)

[[File:tabsaud4a_zoom65.gif|638x265px|tabsAud4a]] 

The [[The lower windows|Most Recent Audit Trail window]] also and only displays audit trail lines. 

The <var>Audit Trail</var> page is displayable separate from the Client in an [[Opening an external window|external]] window.

=== Source Code tab ===
The <var>Source Code</var> page displays the source code lines of the User Language request that is currently being debugged. Here is where most of your interactions with program code take place: setting breakpoints, viewing the current execution position, getting detailed information about a source code line, watching variables from a selected source code line.

[[File:tabssourc3a_zoom65.gif|552x239px|tabsSourc3a]] 

The page display format is: 

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

{|
|width="50%"| '''Column 1'''
|width="50%"|
Line type:

CM> — command 
UL> — User Language statement 
ER> — error message 
BR> — breakpoint
|-
| '''Column 2'''
| Simple line number
|-
| '''Column 3'''
| Include level
|-
| '''Column 4'''
| Line number within include
|}
</div>

=== Web Buffer tab ===
Not ordinarily present for <var>TN3270 Debugger</var> sessions, the <var>Web Buffer</var> page displays the lines the <var>Janus Web Server</var> application is preparing to send to the browser at the completion of the request. The page is updated in real time, each time you break execution, as you step through a code program and PRINT and HTML statements are executed. The most recent lines added to the page are highlighted, and you can watch your output HTML being built. 

[[File:tabswbuf2_zoom65.gif|487x212px|tabsWBuf2]] 

Top, Bottom, and search buttons are available. The page is cleared when a new request is initiated or if you clear it manually (via the Window > Clear Web Buffer button or the [[clearWebBuffer command|clearWebBuffer]] command). 

The <var>Web Buffer</var> page is displayable separate from the Client in an [[Opening an external window|external]] window.

=== Execution Trace tab ===
The <var>Execution Trace</var> page displays the output of the various tracing operations. It is discussed further in [[Tracing program execution|Tracing program execution]]. 

[[File:exectrace1ab_zoom60.gif|529x236px|execTrace1ab]] 

=== Proc Selection tab ===
The <var>Proc Selection</var> page lets you designate some sections of your program or entire programs, for debugging while omitting others. This may be for reasons of time or space economy. You can execute but not display in the Debugger Client specified sections of your code, ranging from a few lines to whole routines or inner or outer procedures. 

[[File:procselect5c_zoom60.gif|632x301px|procSelect5c]] 

The Exclude Parts of Program from Debugging section lets you specify multiple User Language methods, subroutines, or inner procedures whose source code will be executed but not shown in the Debugger Client. From this excluded source code, you can also specify methods, subroutines, or inner procedures whose code you want to be able to view. 

The Skip Whole Programs section of the page lets you specify by name or name pattern only the outer procedures you want to debug. Those procedures not identified are executed but their code is not sent to or displayed in the Client. You can identify the procedures directly (by explicitly specifying them by name or pattern in a "white list") or indirectly (by explicitly excluding the procedures you do not want to debug by specifying them by name or pattern in a "black list"). 

The <var>Proc Selection</var> page options are discussed further in [[Excluding sections of source code from debugging|Excluding sections of source code from debugging.]]

'''See Also'''
: [[Performing basic GUI tasks|Performing Basic GUI Tasks]]
: [[Opening an external window|Opening an external window]]

[[Category:Debugger Home]]