DEBUG statement

Use the DEBUG parameter statement to provide different levels of debug information for Telnet problems or tracking. Without this statement, only certain connection drop reasons are reported to the operator console.

Telnet is initialized with DEBUG CONN EXCEPTION, DEBUG TASK EXCEPTION, and DEBUG CONFIG EXCEPTION settings.

You can code DEBUG CONN in TELNETGLOBALS, TELNETPARMS, or PARMSGROUP. See Rules for Telnet parameter statements and security parameters for more information about the hierarchy of parameter values. You can code DEBUG CONFIG and DEBUG TASK only in TELNETGLOBALS.

DEBUG CONN, DEBUG TASK, and DEBUG CONFIG can each be specified once in TelenetGlobals without generating a duplicate statement exception. The parameters EXCEPTION, SUMMARY, DEBUG, and TRACE are mutually exclusive on each of the three types of debug statements.

Use the V TCPIP,,T,DEBUG,OFF command to turn off all active debug reporting. This command also turns off the reporting of connection drops that were caused by timeouts or errors.

   .-------------------------------------------------------.   
   V                                                       |   
>>---+---------------------------------------------------+-+---><
     |          .-CONN-.                  .-CONSOLE-.    |     
     +-+-DEBUG--+------+--+-EXCEPTION-+-+-+---------+----+     
     | |        '-CONN-'  +-SUMMARY---+ | +-CONSOLE-+    |     
     | |                  '-DETAIL----' | +-JOBLOG--+    |     
     | +-DEBUG--TASK--+-EXCEPTION-+-----+ '-CTRACE--'    |     
     | |              '-DETAIL----'     |                |     
     | '-DEBUG--CONFIG--EXCEPTION-------'                |     
     |        .-CONN-.         .-CTRACE--.               |     
     +-DEBUG--+------+--TRACE--+---------+---------------+     
     |        '-CONN-'         +-CONSOLE-+               |     
     |                         +-JOBLOG--+               |     
     |                         '-CTRACE--'               |     
     |                       .------------.              |     
     |                       V            |  .-CTRACE--. |     
     +-DEBUG--CONFIG--TRACE----,statement-+--+---------+-+     
     |                                       +-CONSOLE-+ |     
     |                                       +-JOBLOG--+ |     
     |                                       '-CTRACE--' |     
     |        .-CONN---.                                 |     
     '-DEBUG--+--------+--OFF----------------------------'     
              +-CONN---+                                       
              +-TASK---+                                       
              '-CONFIG-'                                       

Parameters

CONN

Specify CONN to issue debug messages for connections. CONN is the default.

TASK

Specify TASK to issue debug messages for Telnet tasks.

CONFIG

Specify CONFIG to issue debug messages for Telnet configuration statements. A CONFIG debug message (EZZ6035I) is issued showing the statements and parameters read by Telnet. Another EZZ6035I message is issued showing the structure of the statement as it is passed to Telnet database processing.

OFF

When OFF is specified, no debug messages are issued.

EXCEPTION

When EXCEPTION is specified, only exception debug messages are issued. Telnet is initialized with the value DEBUG CONN EXCEPTION.

SUMMARY

When SUMMARY is specified, summary debug messages (EZZ6034I) are issued indicating major state changes. EXCEPTION debug messages are also issued when SUMMARY is specified.

DETAIL

When DETAIL is specified, detail debug messages (EZZ6035I) are issued to show key events occurring. You should specify DETAIL when you are solving problems; otherwise, too many messages are generated. EXCEPTION and SUMMARY messages are also issued when DETAIL is specified.

TRACE

When TRACE is specified, data to and from the client and to and from VTAM® for one connection is displayed by debug message EZZ6035I. Detail and summary messages are also issued when TRACE is specified. When DEBUG CONFIG is specified, you can optionally specify statement names immediately after the TRACE parameter to indicate that only those statements should be displayed. You can specify a maximum of 20 statement names.

JOBLOG

When JOBLOG is specified, the debug messages are routed to the joblog (routing code 11) instead of the console.

CONSOLE

When CONSOLE is specified, the debug messages are routed to the master console (routing code 2) and to the teleprocessing console (routing code 8).

CTRACE

When CTRACE is specified, the debug messages are not issued and appear in the Component Trace only.