Test the end to end configuration: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
=== Janus Debugger === | === Janus Debugger === | ||
# Open the <span class="f_ListNum1">browser you just [[Configure web browser (Janus Debugger only)|set up]] to use the Debugger as a proxy. </span> | |||
# Invoke the URL of a User Language-based page from your target Janus Web Server. | |||
'''Note:'''<span class="f_ListNote"> If you normally use "https://" and not "http://" to begin the URL (that is, your Web Server is SSL-secured), and if you [[Customize debuggerConfig file|set up]] the debuggerConfig.xml file for SSL support, make sure that you use "</span>'''http'''<span class="f_ListNote">://" here now to access the secured web port. </span> | '''Note:'''<span class="f_ListNote"> If you normally use "https://" and not "http://" to begin the URL (that is, your Web Server is SSL-secured), and if you [[Customize debuggerConfig file|set up]] the debuggerConfig.xml file for SSL support, make sure that you use "</span>'''http'''<span class="f_ListNote">://" here now to access the secured web port. </span> | ||
: The source code of the program should appear in the <var>Source Code</var><span class="f_ListContinue"> page of the Client with its procedure name displayed in the title bar, similar to the following </span><var>Source Code</var><span class="f_ListContinue"> display: </span> | : The source code of the program should appear in the <var>Source Code</var><span class="f_ListContinue"> page of the Client with its procedure name displayed in the title bar, similar to the following </span><var>Source Code</var><span class="f_ListContinue"> display: </span> | ||
[[File:jdgui8_zoom60.gif|619x406px|jdgui8]]<span class="f_ImageCaption"> </span> | : [[File:jdgui8_zoom60.gif|619x406px|jdgui8]]<span class="f_ImageCaption"> </span> | ||
: If instead, you receive a Communication Error message that reports an "error while communicating with the remote host," you may have an error in the <var>debuggerConfig.xml </var><span class="f_ListContinue">[[Customize debuggerConfig file|settings]]. If so, and you find the error, restart the Debugger Client and try the test URL again. For more information about error handling, see [[How the Janus Debugger handles communication breaks|How the Janus Debugger handles communication breaks]]. </span> | |||
<span class="f_Para">The Debugger Client is ready to use. From the Client GUI, you can control the execution of your web application's User Language code (see [[ | <span class="f_Para">The Debugger Client is ready to use. From the Client GUI, you can control the execution of your web application's User Language code (see [[Getting started (Debugger)|Getting Started]]). </span> | ||
<span class="f_Para">For an archive of information about features that are new or enhanced in the latest version of the Debugger Client, see the [[ | <span class="f_Para">For an archive of information about features that are new or enhanced in the latest version of the Debugger Client, see the [[Release notes for Debugger|Release Notes]]. </span> | ||
=== TN3270 Debugger === | === TN3270 Debugger === | ||
| Line 23: | Line 21: | ||
: 1. <span class="f_ListNum1">From the </span><var>Model 204</var><span class="f_ListNum1"> command prompt or within a BATCH2 input stream, start a </span><var>TN3270 Debugger</var><span class="f_ListNum1"> session: </span> | : 1. <span class="f_ListNum1">From the </span><var>Model 204</var><span class="f_ListNum1"> command prompt or within a BATCH2 input stream, start a </span><var>TN3270 Debugger</var><span class="f_ListNum1"> session: </span> | ||
<p class="syntax"><span class="f_CodeExList" style="font-weight: bold;">TN3270 DEBUG ON </span><span class=" | <p class="syntax"><span class="f_CodeExList" style="font-weight: bold;">TN3270 DEBUG ON </span><span class="term">janClientPort pcHost pcPort workerPort</span></p> | ||
:: <span class="f_ListContinue">where: </span> | :: <span class="f_ListContinue">where: </span> | ||
| Line 43: | Line 41: | ||
|- | |- | ||
| <span class="term">'''workerPort'''</span><span class="f_DefListDD"> </span> | | <span class="term">'''workerPort'''</span><span class="f_DefListDD"> </span> | ||
| <span class="f_DefListDD">The port number in your Online that [[Define and start the Debugger Server port|is defined]] for worker threads. This can be the same port number that provides worker threads for the </span>< | | <span class="f_DefListDD">The port number in your Online that [[Define and start the Debugger Server port|is defined]] for worker threads. This can be the same port number that provides worker threads for the </span><var>Janus Debugger,</var><span class="f_DefListDD"> as well.</span> | ||
|} | |} | ||
</div> | </div> | ||
: For example: | |||
<p class="syntax">>TN3270 DEBUG ON DEBCLIENT 198.242.244.234 8081 3226 </p> | <p class="syntax">>TN3270 DEBUG ON DEBCLIENT 198.242.244.234 8081 3226 </p> | ||
| Line 70: | Line 66: | ||
<p class="syntax"><span class="f_CodeExList2">TN3270 DEBUG OFF</span></p> | <p class="syntax"><span class="f_CodeExList2">TN3270 DEBUG OFF</span></p> | ||
<span class="f_ListContinue2">You should receive this response in </span><var>Model 204</var><span class="f_ListContinue2">: </span> | : <span class="f_ListContinue2">You should receive this response in </span><var>Model 204</var><span class="f_ListContinue2">: </span> | ||
<p class="syntax"><span class="f_CodeExList2">*** MSIR.0913: TN3270 Debugger is now off </span></p> | <p class="syntax"><span class="f_CodeExList2">*** MSIR.0913: TN3270 Debugger is now off </span></p> | ||
: On the Debugger Client, </span><span class="f_Monospace">Online has disconnected</span><span class="f_ListContinue2"> displays in the Status area. | |||
* <span class="f_ListBul2">Log off of </span><var>Model 204</var><span class="f_ListBul2"> (any logoff is an implied TN3270 DEBUG OFF).</span> | * <span class="f_ListBul2">Log off of </span><var>Model 204</var><span class="f_ListBul2"> (any logoff is an implied TN3270 DEBUG OFF).</span> | ||
| Line 81: | Line 77: | ||
: 5. <span class="f_ListNum1">Reissue the command from step 1 to restart the Debugger Client, and the Debugger Client is ready to use. </span> | : 5. <span class="f_ListNum1">Reissue the command from step 1 to restart the Debugger Client, and the Debugger Client is ready to use. </span> | ||
:: From the Client GUI, you can control the execution of your <var>Model 204</var><span class="f_ListContinue"> application's User Language code (see [[Getting started (Debugger)|Getting started]]). </span> | :: From the Client GUI, you can control the execution of your <var>Model 204</var><span class="f_ListContinue"> application's User Language code (see [[Getting started (Debugger)|Getting started]]). </span> | ||
:: For an archive of information about features that are new or enhanced in the latest version of the Debugger Client, see the [[Release | :: For an archive of information about features that are new or enhanced in the latest version of the Debugger Client, see the [[Debugger Release Notes|Release Notes]]. | ||
[[Category:Debugger Home]] | [[Category:Debugger Home]] | ||
Latest revision as of 21:38, 25 May 2023
Subsections follow for the Janus Debugger and for the TN3270 Debugger. It is assumed that the Debugger Client is up and running.
Janus Debugger
- Open the browser you just set up to use the Debugger as a proxy.
- Invoke the URL of a User Language-based page from your target Janus Web Server.
Note: If you normally use "https://%22 and not "http://%22 to begin the URL (that is, your Web Server is SSL-secured), and if you set up the debuggerConfig.xml file for SSL support, make sure that you use "http://" here now to access the secured web port.
- The source code of the program should appear in the Source Code page of the Client with its procedure name displayed in the title bar, similar to the following Source Code display:
- If instead, you receive a Communication Error message that reports an "error while communicating with the remote host," you may have an error in the debuggerConfig.xml settings. If so, and you find the error, restart the Debugger Client and try the test URL again. For more information about error handling, see How the Janus Debugger handles communication breaks.
The Debugger Client is ready to use. From the Client GUI, you can control the execution of your web application's User Language code (see Getting Started).
For an archive of information about features that are new or enhanced in the latest version of the Debugger Client, see the Release Notes.
TN3270 Debugger
- 1. From the Model 204 command prompt or within a BATCH2 input stream, start a TN3270 Debugger session:
TN3270 DEBUG ON janClientPort pcHost pcPort workerPort
- where:
| janClientPort |
The name of the Janus client socket port that is defined for the TN3270 Debugger to use to contact the Debugger Client workstation. This port must be started. |
| pcHost | The workstation running the Debugger Client. This may be an IP number or a DNS name, as described earlier. |
| pcPort | The workstation port number on which the Debugger Client is listening. As described earlier, this is typically 8081. |
| workerPort | The port number in your Online that is defined for worker threads. This can be the same port number that provides worker threads for the Janus Debugger, as well. |
- For example:
>TN3270 DEBUG ON DEBCLIENT 198.242.244.234 8081 3226
- 2. Verify that you receive a message similar to:
*** MSIR.0915: Debugging is on; client is 198.242.244.234 port 8081,
sessionID: 00000069D812279
- 3. On the Debugger Client, verify that a "busy" cursor displays, as well as a Waiting for Online message in the Status bar:
- Additional Audit Trail page messages identify the Debugger Server's port and the address of its Online host, the user number assigned to the logged-in Model 204 user, as well as the Model 204 version.
- From this point on, any User Language program you initiate from the Model 204 command line will appear in the Source Code tab of the Debugger Client GUI for debugging, the procedure name will appear in the Client's title bar, and the "busy" cursor and Waiting for Online message will display between requests until your session ends.
- 4. Turn off the TN3270 Debugger by doing either of the following:
- From the Model 204 command prompt (or at the end of your BATCH2 stream), issue:
TN3270 DEBUG OFF
- You should receive this response in Model 204:
*** MSIR.0913: TN3270 Debugger is now off
- On the Debugger Client, Online has disconnected displays in the Status area.
- Log off of Model 204 (any logoff is an implied TN3270 DEBUG OFF).
- Note: Explicitly turning off the Debugger is necessary if you are using the Janus Debugger as well as the TN3270 Debugger for the same Online and worker port. To switch from a TN3270 Debugger session to a Janus Debugger session, you must explicitly drop the TN3270 Debugger session. The Janus Debugger automatically closes its connections and does not require an explicit notification to switch or end a session.
- 5. Reissue the command from step 1 to restart the Debugger Client, and the Debugger Client is ready to use.
- From the Client GUI, you can control the execution of your Model 204 application's User Language code (see Getting started).
- For an archive of information about features that are new or enhanced in the latest version of the Debugger Client, see the Release Notes.