Your browser does not allow storing cookies. We recommend enabling them.

SSH Tectia 
PreviousNextUp[Contents] [Index]

    About This Document >>
    Installing SSH Tectia Server for IBM z/OS >>
    Getting Started with SSH Tectia Server for IBM z/OS >>
    Configuring the Server >>
    Authentication >>
    System Administration >>
    File Transfer Using SFTP >>
    Secure File Transfer Using Transparent FTP Security >>
    Tunneling >>
    Troubleshooting SSH Tectia Server for IBM z/OS >>
        Debugging SSH Tectia Server for IBM z/OS>>
            Debugging Using USS shell
            Debugging using a Started Task
            Debugging File Transfer
        Solving Problem Situations>>
    Man Pages and Default Configuration Files >>
    Log Messages >>

Debugging File Transfer

SSH Tectia Server for IBM z/OS uses a separate proces, sft-server-g3 for file transfer operations.

To obtain debug information from sft-server-g3, you can use the environment variables SSH_SFTP_DEBUG, SSH_SFTP_DEBUG_FILE, and SSH_DEBUG_FMT.

When the debugging is enabled, the sft-server-g3 debug messages are by default sent to the standard error, that goes also to the SFTP client. If you want to forward the sft-server-g3 debug messages into a file and not to the client, you can add the following two environment variables affecting the secure file transfer user into the /etc/environment file or the user-specific $HOME/.ssh2/environment file on the server:

  • SSH_SFTP_DEBUG defines the debug level that controls the messages that the sft-server-g3 process will be showing while executing. To get some debug data, you can use, for example:
    To get more details, you can use, for example:
    To get even deeper level of detail, you can use, for example:
    To get full debugging information from the SFTP server, use:
    To get most low-level z/OS debugging information:
    To get all low-level z/OS debugging information:
    To get all debugging information related to dataset allocation:
    To get all debugging information related to z/OS catalog:
  • SSH_SFTP_DEBUG_FILE defines the file where the debug messages from the sft-server-g3 will be printed. The value can be for example:
    Note that the path must be given without citations marks. If this variable is not defined, the messages will be sent to standard error and the SFTP client will receive them.
  • SSH_DEBUG_FMT defines the format of the debug messages. The default variable used is:
    SSH_DEBUG_FMT="%Dd/%Dt/%Dy %Dh:%Dm:%Ds:%Df %m/%s:%n:%f %M"
    For more information on the syntax of this variable, see the sftpg3.1 man page.

On the client side, it is also possible to use the debug command of sftpg3 to get debugging information. For example, to get basic debugging data, give the command:

sftp> debug "Sftp*=2"

The same debug strings as with SSH_SFTP_DEBUG can also be used.

PreviousNextUp[Contents] [Index]

[ Contact Information | Support | Feedback | SSH Home Page | SSH Products ]

Copyright © 2011 SSH Communications Security Corp.
This software is protected by international copyright laws. All rights reserved.
Copyright Notice




What to read next:

  • Reduce Secure Shell risk. Get to know the NIST 7966.

    The NISTIR 7966 guideline from the Computer Security Division of NIST is a direct call to action for organizations regardless of industry and is a mandate for the US Federal government.
    Download now
  • ISACA Practitioner Guide for SSH

    With contributions from practitioners, specialists and SSH.COM experts, the ISACA “SSH: Practitioner Considerations” guide is vital best practice from the compliance and audit community.
    Download now