Site Command Examples with Other Clients

The Site commands are the recommended way for controlling file transfer when both the client and server host are running SSH Tectia.

The following examples show Site commands used from SSH Tectia Client on Windows.

C|transfer_codeset=CODESET

During the transfer the data has the specified codeset. CODESET is the codeset name that is known to the iconv function of the system performing the conversion. The available codesets can be listed by invoking the iconv command at a USS prompt with the -l option:

$ iconv -l

Default: none

In the following example, a Windows SFTP client puts a file to a z/OS dataset and gets a dataset from z/OS:

sftp> site C=ISO8859-1 D=IBM-1047
sftp> sput file.txt //DATASET.TXT
sftp> sget //DATASET.TXT file.txt

The site command tells the z/OS server that the codeset during transfer is ISO8859-1 and that the dataset is stored on the server with the IBM-1047 codeset. In sput, this means that the server converts the codeset from ISO8859-1 to IBM-1047 upon receiving the data. In sget, this means that the server converts the codeset from IBM-1047 to ISO8859-1 before sending the data.

	Note
	The codeset information is always given to the host that is capable of performing the conversion, in these cases the z/OS host.

I|transfer_line_delimiter=CONVENTION

The transfer line delimiter specifies the newline convention used during the file transfer. Possible values are:

I=mvs: The line delimiter during the transfer is NL (\n, 0x0a).
I=unix: The line delimiter during the transfer is NL (\n, 0x0a).
I=dos: The line delimiter during the transfer is LFNL (\r\n, 0x0d0a).
I=mac: The line delimiter during the transfer is LF (\r, 0x0d).

Default: none

In the following example, a Windows SFTP client puts a file to a z/OS dataset and gets a dataset from z/OS:

sftp> site I=dos J=mvs
sftp> sput file.txt //DATASET.TXT
sftp> sget //DATASET.TXT file.txt

The site command tells the z/OS server that the line delimiter during the transfer is LFNL and that the dataset is stored with the NL line delimiter. In sput, this means that the server converts the line delimiters from LFNL to NL upon receiving the data. In sget, this means that the server converts the line delimiters from NL to LFNL before sending the data.

	Note
	The line delimiter information is always given to the host that is capable of performing the conversion, in these cases the z/OS host.