Define and start the Debugger Server port

From m204wiki
Revision as of 18:39, 19 April 2023 by Ekern (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
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.