Define and start the Debugger Server port: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
__TOC__ | __TOC__ | ||
1. <span class="f_ListNum1">Select an unused TCP port number on which your Online will run the Debugger Server. </span> | : 1. <span class="f_ListNum1">Select an unused TCP port number on which your Online will run the Debugger Server. </span> | ||
: A Janus server socket port will be opened on that port number to service requests for Debugger Server worker threads. Make sure that port number is free of any security restraints at your site that might prevent access by any Debugger Client workstation seeking a connection. </span> | :: A Janus server socket port will be opened on that port number to service requests for Debugger Server worker threads. Make sure that port number is free of any security restraints at your site that might prevent access by any Debugger Client workstation seeking a connection. </span> | ||
2. <span class="f_ListNum1">Confirm that, as described in [[Set Model 204 system parameters#|Set Model 204 system parameters]], the Debugger Server </span>''worker threads''<span class="f_ListNum1"> have a </span><var>Model 204</var><span class="f_ListNum1"> LPDLST parameter setting of at least 9000 in any Online where either the </span><var>Janus</var><span class="f_ListNum1"> or </span><var>TN3270 Debugger</var><span class="f_ListNum1"> will be used. </span> | : 2. <span class="f_ListNum1">Confirm that, as described in [[Set Model 204 system parameters#|Set Model 204 system parameters]], the Debugger Server </span>''worker threads''<span class="f_ListNum1"> have a </span><var>Model 204</var><span class="f_ListNum1"> LPDLST parameter setting of at least 9000 in any Online where either the </span><var>Janus</var><span class="f_ListNum1"> or </span><var>TN3270 Debugger</var><span class="f_ListNum1"> will be used. </span> | ||
3. <span class="f_ListNum1">Define and start a Debugger Server port. </span> | : 3. <span class="f_ListNum1">Define and start a Debugger Server port. </span> | ||
: You may want to consult with your system manager or whomever sets up Janus port definitions for your site. The Rocket M204wiki [http://m204wiki.rocketsoftware.com/index.php/JANUS_DEFINE JANUS_DEFINE command] documentation describes port definition particulars. </span> | :: You may want to consult with your system manager or whomever sets up Janus port definitions for your site. The Rocket M204wiki [http://m204wiki.rocketsoftware.com/index.php/JANUS_DEFINE JANUS_DEFINE command] documentation describes port definition particulars. </span> | ||
: For Debugger purposes, the JANUS DEFINE command format is: </span> | :: For Debugger purposes, the JANUS DEFINE command format is: </span> | ||
<p class="syntax"><span class="term">JANUS DEFINE </span><span class="term">portName portNumber</span><span class="f_Monospace"> DEBUGGERSERVER </span><span class="term">maxConnections</span><span class="f_CodeExList"> </span></p> | <p class="syntax"><span class="term">JANUS DEFINE </span><span class="term">portName portNumber</span><span class="f_Monospace"> DEBUGGERSERVER </span><span class="term">maxConnections</span><span class="f_CodeExList"> </span></p> | ||
: Note the DEBUGGERSERVER port type, which is a Debugger-only, license-free, Janus server socket. | :: Note the DEBUGGERSERVER port type, which is a Debugger-only, license-free, Janus server socket. | ||
: An example command sequence follows, which creates/recreates and starts a server port on port 3226, then displays the full port definition: | :: An example command sequence follows, which creates/recreates and starts a server port on port 3226, then displays the full port definition: | ||
<p class="syntax"><span class="f_CodeExList">JANUS DRAIN DEBUGSERVER3226 </span> | <p class="syntax"><span class="f_CodeExList">JANUS DRAIN DEBUGSERVER3226 </span> | ||
| Line 18: | Line 18: | ||
<span class="f_CodeExList">JANUS DISPLAY DEBUGSERVER3226 </span></p> | <span class="f_CodeExList">JANUS DISPLAY DEBUGSERVER3226 </span></p> | ||
: For your convenience, you may want to store this command sequence for reuse in a <span class="var">Model 204</span><span class="f_ListContinue"> procedure. </span> | :: For your convenience, you may want to store this command sequence for reuse in a <span class="var">Model 204</span><span class="f_ListContinue"> procedure. </span> | ||
4. <span class="f_ListNum1">Issue the following command to check that the Server port started: </span> | : 4. <span class="f_ListNum1">Issue the following command to check that the Server port started: </span> | ||
<p class="syntax">JANUS STATUS</p> | <p class="syntax">JANUS STATUS</p> | ||
| Line 30: | Line 30: | ||
<span class="f_ListContinue">Where </span><span class="term">portNumber</span><span class="f_ListContinue"> is the port number from above, and </span><span class="term">sockType</span><span class="f_ListContinue"> is DEBUGSRV.</span> | <span class="f_ListContinue">Where </span><span class="term">portNumber</span><span class="f_ListContinue"> is the port number from above, and </span><span class="term">sockType</span><span class="f_ListContinue"> is DEBUGSRV.</span> | ||
5. <span class="f_ListNum1">Once you know the Debugger Server has started, the best way to verify its functioning is to install the Debugger Client on a workstation and make sure the workstation can connect, as described in [[Workstation Configuration|Workstation Configuration]]. </span> | : 5. <span class="f_ListNum1">Once you know the Debugger Server has started, the best way to verify its functioning is to install the Debugger Client on a workstation and make sure the workstation can connect, as described in [[Workstation Configuration|Workstation Configuration]]. </span> | ||
[[Category:Debugger Home]] | [[Category:Debugger Home]] | ||
Latest revision as of 18:39, 19 April 2023
- 1. Select an unused TCP port number on which your Online will run the Debugger Server.
- A Janus server socket port will be opened on that port number to service requests for Debugger Server worker threads. Make sure that port number is free of any security restraints at your site that might prevent access by any Debugger Client workstation seeking a connection.
- 2. Confirm that, as described in Set Model 204 system parameters, the Debugger Server worker threads have a Model 204 LPDLST parameter setting of at least 9000 in any Online where either the Janus or TN3270 Debugger will be used.
- 3. Define and start a Debugger Server port.
- You may want to consult with your system manager or whomever sets up Janus port definitions for your site. The Rocket M204wiki JANUS_DEFINE command documentation describes port definition particulars.
- For Debugger purposes, the JANUS DEFINE command format is:
JANUS DEFINE portName portNumber DEBUGGERSERVER maxConnections
- Note the DEBUGGERSERVER port type, which is a Debugger-only, license-free, Janus server socket.
- An example command sequence follows, which creates/recreates and starts a server port on port 3226, then displays the full port definition:
JANUS DRAIN DEBUGSERVER3226 JANUS DELETE DEBUGSERVER3226 JANUS DEFINE DEBUGSERVER3226 3226 DEBUGGERSERVER 15 TRACE 0 JANUS START DEBUGSERVER3226 JANUS DISPLAY DEBUGSERVER3226
- For your convenience, you may want to store this command sequence for reuse in a Model 204 procedure.
- 4. Issue the following command to check that the Server port started:
JANUS STATUS
You should see a line like the following (using the naming convention in these examples and procedures):
DEBUGSERVERportNumber portNumber socketType Start statistic-values
Where portNumber is the port number from above, and sockType is DEBUGSRV.
- 5. Once you know the Debugger Server has started, the best way to verify its functioning is to install the Debugger Client on a workstation and make sure the workstation can connect, as described in Workstation Configuration.