[Contents] [Index]

About This Document >>     Installing SSH Tectia Server for IBM z/OS >>     Using SSH Tectia Server for IBM z/OS >>     Configuring the Server >>     Configuring the Client >>     Authentication >>     Troubleshooting SSH Tectia Server for IBM z/OS >>     Examples of Use >>         Secure File Transfers Using the z/OS Client>>         Secure File Transfers Using Windows and Unix Clients>>         Submitting JCL Jobs over Secure Shell         Debugging SSH Tectia Server for IBM z/OS>>             Debugging the Clients             Debugging the Server         Example of Distributing Keys >>     Man Pages >>     Log Messages >>

Debugging the Server

The server can be debugged by using either the -d or -D options. The -d option launches server to one-shot mode. In this mode, the server accepts only one connection and exits after the session is disconnected. The -D option launches server to continuous debug mode. In this mode, the server accepts several connection and needs to be stopped manually.

Debug level 4 is usually sufficient. For more detailed information, debug level 7 can be used.

Degugging Using USS shell

When debugging server, second server daemon can be started to a different TCP port or alternatively the existing server can be stopped and the same port can be used for debugging.

Debugging can be started with command:

/usr/lpp/ssh2/sbin/sshd2 -d 4 -p 1234

In the command, -d defines the debug level and -p the TCP port. With this command the debug output is displayed to the screen.

Debug can also be forwarded to a file:

/usr/lpp/ssh2/sbin/sshd2 -d 4 -p 1234 2>/tmp/debug_file.dat

Debugging using a Started Task

The -D option can be used on the SSHD2 started task. Output is stored to the defined STDERR file.

//RUNSSHD2D PROC //SSHD2 EXEC PGM=BPXBATCH,REGION=0M,TIME=NOLIMIT, // PARM='PGM /usr/lpp/ssh2/sbin/sshd2 -D 7' //STDOUT DD PATH='/home/SSHD2/sshd2.out', // PATHOPTS=(OWRONLY,OCREAT,OTRUNC), // PATHMODE=SIRWXU //STDERR DD PATH='/home/SSHD2/sshd2.err', // PATHOPTS=(OWRONLY,OCREAT,OTRUNC), // PATHMODE=SIRWXU //STDENV DD DSN=SSHD2.SSZ.SAMPLIB(SSHENV), // DISP=SHR //STDIN DD DUMMY // PEND