SSH Reference Manual

Controlling Transfer Summary
Summary information about each file transfer gets generated, e.g.:
165527760 bytes transferred in 86 seconds ( 1.8MB/s)
By default the number of bytes transferred is set to the EOF value of a file. This ensures consistency between the size of
a file displayed by the ls -l command and the summary information. But the size of the actual content of a Guardian edit
or structured file can differ greatly from the EOF value.
If it is of interest to see the actual number of bytes transferred in the transfer summary, then a define
=SFTP^BYTES^TRANSFERRED can be set to ACTUAL:
ADD DEFINE =SFTP^BYTES^TRANSFERRED, CLASS MAP, FILE ACTUAL
The default value for this define is EOF, meaning the "bytes transferred" line contains the EOF value of a file in case the
transfer was successful.
The define must exist in the environment of the SFTP[OSS] client.
Specifying File Names on the NonStop System
When specifying directories, subvolumes, or files on the NonStop™ system, the SSH2/SFTP implementation supports
flexible ways to deal with the various notations:
• Files and directories under the OSS file system are specified using the normal Unix file name notation such as
"/home/tb" for a directory and "/home/tb/myfile" for a file.
• Files and directories under the Guardian file system can be specified in two ways:
o Using the normal Guardian notation, such as "$data1.tbhome" for a subvolume or "$data1.tbhome.myfile"
for a file. Subvolume changes can be specified using the normal syntax such as "cd $data1.tbhome" or "cd
mysubvol". Note that a subvolume needs to be present in a "cd" command.
See the note below regarding Guardian file name notation.
o Using the "Unix-style" notation for Guardian files. For instance, to specify the fully qualified file name
"$data1.testvol.myfile", you can use the notation "/G/data1/testvol/myfile".
Note: Unlike with HP NonStop FTP, there is no explicit command ("quote oss" or "quote guardian") to switch between
the two notations. The Guardian file name notation is only allowed if parameter SFTPALLOWGUARDIANCD is set to
true, and if a "cd /G" command has first been issued to switch to the Guardian notation. The default for
SFTPALLOWGUARDIANCD is false; for details, please refer to the description in chapter "SSH2 Parameter
Reference".
Extended Syntax for Creation of New Guardian Files
By adding a comma and a list of options to a filename, the attributes for this file can be controlled in:
• "get" commands executed on the NonStop system.
• "put" commands executed on the remote system.
The syntax for get and put command is as follows, with the restriction that file attributes can only be appended to files in
the Guardian name space:
get remote-file [ local-file [ ,file-attributes ]]
put local-file [ remote-file [ ,file-attributes ]]
where file-attributes is a comma-separated list, which contains different file attributes depending on file type.
For EDIT and unstructured binary files the file-attributes list is:
[ [filecode],[primary],[secondary],[maxextents] ]
HP NonStop SSH Reference Manual SSH and SFTP Client Reference • 233