File Transfer Environment Variables for the Clients

The file transfer clients use the following environment variables:

SSH_DEBUG_FMT            (default: "%Dd/%Dt/%Dy %Dh:%Dm:%Ds:%Df %m/%s:%n:%f %M")
SSH_SFTP_SMF_TYPE               (default: NULL)
SSH_SFT_PSEUDOVOLUME_VOLSERS    (default: MIGRAT)

The SSH_DEBUG_FMT variable can be used to specify the format of the debug messages. For more information, see SSH_DEBUG_FMT.

If variable SSH_SFTP_SMF_TYPE is set to TYPE119 file transfers create SMF records of type 119.

The SSH_SFT_PSEUDOVOLUME_VOLSERS can be used to define a list of pseudo-volume serial numbers for volumes that are migrated or archived, see Restoring Archived Datasets.

Furthermore, the sftpg3 file transfer client uses the following environment variable:

SSH_SFTP_BATCH_FILE                     (default: NULL)
SSH_SFTP_HOME_MVS                       (default: "no")

The SSH_SFTP_BATCH_FILE variable defines the path to the batch file to be run when sftpg3 is started.

If variable SSH_SFTP_HOME_MVS is set to yes, the sftpg3 local directory is set to USER prefix in the MVS side. If it is set to no, local directory is the current directory.

Setting the File Transfer Home Location

For SFTP connections, the file transfer home location is the directory on the client where the SFTP session starts.

By default, Tectia Server for IBM z/OS uses the user's Unix System Services (USS) home directory as the file transfer home location.

The environment variable SSH_SFTP_HOME_MVS in the user's $HOME/.profile file on the client machine can be used to control the file transfer home location.

If the environment variable is omitted or its value is no, the user's USS home directory is used as the file transfer home, for example /u/userid/, and the MVS user prefix must be accessed using "//".

If the value of the is environment variable yes, the user's MVS USERID prefix is used as the file transfer home location, for example //'USERID., and the USS home directory must be accessed using /u/userid/ or ~.

Examples when `SSH_SFTP_HOME_MVS=no`

When SSH_SFTP_HOME_MVS is set to no (or omitted), the following get command run in the SFTP client results to a file /home/user1/dataset.txt in Tectia Server for IBM z/OS:

sftp> open user1@server
sftp> get dataset.txt

The following sget command run in the SFTP client results to a MVS sequential dataset //'USERID.MF.FILE' in Tectia Server for IBM z/OS:

sftp> open user1@server
sftp> sget remote_file //MF.FILE

Examples when `SSH_SFTP_HOME_MVS=yes`

When SSH_SFTP_HOME_MVS is set to yes, the following get command in the SFTP client results to a dataset //'USER1.DATASET.TXT' in Tectia Server for IBM z/OS:

sftp> open user1@server
sftp> get dataset.txt

The following sget command run in the SFTP client results to a USS file /u/user1/mf.file in Tectia Server for IBM z/OS:

sftp> open user1@server
sftp> sget remote_file ~/mf.file

Or:

sftp> open user1@server
sftp> sget remote_file /u/user1/mf.file