Ekern: Created page with "Whenever you invoke a User Language program from an Online that has been configured for debugging, this sequence of events unfolds: : 1. The initial..."

2023-05-25T21:37:58Z

Created page with "Whenever you invoke a User Language program from an Online that has been configured for debugging, this sequence of events unfolds: : 1. The initial..."

New page

Whenever you invoke a User Language program from an Online that has been configured for debugging, this sequence of events unfolds:

: 1. The initial user call to start the TN3270 Debugger (SIRDEBUG ON DEBCLI1 198.242.244.16 8081 3270 in the <var>SirScan</var> example lines below, which is [[Test the end to end configuration#TN3270 Debugger |described]] as part of the product installation) triggers a socket connection request from the issuing user's thread (using the CLSOCK port [[Define and start a client socket port (TN3270 Debugger only)|defined]] during installation) to the workstation that hosts the Debugger Client. The connection request (trace lines for which are circled below) contains the number of the Debugger Server port (configured during [[Define and start the Debugger Server port|installation]]) and the user thread number. 

[[File:sirwork1a1b_zoom65.gif|700x169px|sirWork1a1b]] 

: 2. Once the connection succeeds, the Debugger Client, in turn, connects to that Debugger Server port, which starts a <var>SirScan</var> thread whose default user ID is SOCKUSER (see top two <var>SirScan</var> lines, below). The Debugger Server communicates over a socket connection with the Client and creates a worker thread for this debugging session. The connection handshake contains a unique ID from the Client for this debugging session (circled, below). The Server worker thread uses AUDIT statements to report its activities to the <var>SirScan</var> audit trail. 

[[File:sirworka1bb_zoom65.gif|869x305px|sirworkA1bb]] 

:: The worker thread reports its actions in lines that begin with three asterisks (***). The worker refers to the Online thread to be debugged as the "debuggee." A successful connection between the Debugger Server and Debugger Client results in a "Debugging is on" message, and the ID referred to in the connection handshake becomes the "session ID" for this debugging session: 

[[File:sirworka2a_zoom65.gif|764x61px|sirworkA2a]] 

: 3. The worker thread is directed by the Debugger Client (based on user interface actions), and the worker thread maintains an internal master/slave, post/wait relationship with the Online thread that is being debugged. The initial action of the worker thread is to announce itself to the Debugger Client in the <var>Audit Trail</var> page: 

[[File:sirdebworker3acli2_zoom75.gif|616x378px|sirdebworker3acli2]] 

: 4. The worker then waits for the Online thread to initiate debuggable activity. If you include a <var>SirScan</var> procedure from the Online thread, for example (DAEMON5.UL in the <var>SirScan</var> excerpt below), the worker detects this and pauses procedure processing while it sends the code lines to the Client (in an XML document) using the DEBCLI1 CLSOCK port, then waits for a response from the Client. 

'''Note:''' The format of the XML messages in the following and subsequent code examples in this section is unpublished and subject to change. 

[[File:sirdebworker2cli3s1_zoom65.gif|632x252px|sirdebworker2cli3s1]] 

[[File:sirdebworker2cli3a2_zoom65.gif|634x371px|sirdebworker2cli3a2]] 

: 5. The Client displays the procedure code in the Debugger Source Code page: 

[[File:sirdebworker3bcli2_zoom75.gif|519x544px|sirdebworker3bcli2]] 

: 6. The Client user initiates the next round of activity by invoking an operation on the source code, say, stepping to the next statement. The Client sends this command in an XML message to the worker (upper circle, below), and the worker wakes up and instructs the Online thread. The worker reports a sequence of "***" audit lines (the ending N's below mean "run to '''N'''ext statement" and "'''N'''ext statement executed"), then sends an XML response to the Client (lower circle, below) about the result of executing the next statement in the program: 

[[File:sirdebworker2cli5a_zoom65.gif|635x431px|sirdebworker2cli5a]] 

: 7. The Client-worker-Online communication continues in this fashion according to the commands invoked by the Client GUI user. The worker continues in a loop/dialogue with the Client, reporting its state and latest activity to the Client, and receiving XML requests from the Client (commands that are based on what the Debugger GUI user is invoking). The worker also maintains a master-slave relationship with the Online thread, guiding the execution of the program and reporting execution results. 

: 8. In case you need to debug the Debugger, you can access the XML traffic exchanged between the worker and Debugger Client. To do so, use the JANUS TRACE command (described in the '''Janus TCP/IP Base Reference Manual''') to increase the tracing on the Debugger Server port (in this example, DEBUGSERVER3270) and on the Online's client socket port (in this example, DEBCLI1), and use <var>SirScan</var> to view the traffic. The JANUS DISPLAYTRACE command reveals the current trace values. 
: Since a high tracing value, say 15, can capture huge amounts of data, remember to return the tracing settings to their former values when you no longer need so much detail. 
: Also of possible use in a debugging situation, the Debugger Client installation folder is the [[Changing the location of Client work files|default location]] for a text log (log.txt) of Client activity and reference file information. 

[[Category:Debugger Home]]

Debugging the TN3270 Debugger - Revision history

Ekern: Created page with "Whenever you invoke a User Language program from an Online that has been configured for debugging, this sequence of events unfolds: : 1. The initial..."