Configuring the TN3270 Telnet Server to access the Terminal Interface Manager

Select an additional unused port (for example, 2024) and then implement Example 1 with the following changes:

  • Specify port 2024 instead of 2023 (3 times)
  • Specify the following value for the DEFAULTAPPL statement: 
    DEFAULTAPPL EQASESSM FIRSTONLY
  • Make the following change on the ALLOWAPPL statement: 
    ALLOWAPPL EQA*

Example 4

The example below shows the modified Example 1, with the changes highlighted with an asterisk ( * ).

PORT
 ...
 *   2024 TCP jobname NOAUTOLOG            ; Telnet Server - z/OS Debugger
 ...

; Add a TELNETPARMS block for the new port

TELNETPARMS
 *   PORT 2024                     ; z/OS Debugger
  ... the rest of this should be a copy of the existing Port 23
ENDTELNETPARMS

; Add a BEGINVTAM block for the new port

BEGINVTAM
 *   PORT 2024

  ; Define the VTAM terminal LUs to use for this port (see EQAWTRML)

  LUGROUP DBGTOOL
      TRMLU001..TRMLU050
  ENDLUGROUP

  ; Allow anyone with access to this system to use the LUs above

  IPGROUP EVERYONE
      0.0.0.0:0.0.0.0
  ENDIPGROUP

  ; The z/OS Debugger Terminal Interface
Manager will be displayed
  ; when an emulator connects

 *   DEFAULTAPPL EQASESSM FIRSTONLY

  ; Indicate that the ACBs always be allocated

  LUMAP DBGTOOL EVERYONE KEEPOPEN

  ; Allow only z/OS Debugger to use this port

 *   ALLOWAPPL   EQA*

ENDVTAM

See hlq.SEQASAMP(EQAWTTS4) for a sample of these definitions.

Instruct TCP/IP to use this additional definition, as described in Configuring the TN3270 Telnet Server to access the terminal LUs.

After you make these changes, your users can set up a unique terminal emulator session that connects to this new port, and debug programs that require the use of full-screen mode using a dedicated terminal with the z/OS® Debugger Terminal Interface Manager. The user does the following steps:

  1. Starts a terminal emulator session that connects to this new port. The z/OS Debugger Terminal Interface Manager is displayed.
  2. The user enters his user ID and password and then presses Enter. The terminal is now ready to receive a z/OS Debugger full-screen mode using a dedicated terminal session.
  3. On another terminal emulator session, the user starts his program with the TEST run-time option and specifies the VTAM%userid suboption. The terminal emulator session connected to this new port displays a full-screen mode using a dedicated terminal session.