z/VM: TCP/IP User's Guide - z/VM - IBM

FTP Subcommands
If quotes are encountered that enclose a subcommand string which does not
contain embedded blanks, the z/VM FTP client assumes the supplied quotes are
inherent to this string. Thus, the delimiting quotes are retained, and are passed on
to the FTP server on the foreign host.
Fully-Qualified Pathnames
For certain FTP subcommands, the z/VM FTP server allows a fully-qualified
pathname.
For example, assume the SFS directory FPSERV1:TSTUSER.TESTCASES is the
working directory, but that information about all TEST007 files that reside in the
FPSERV1:TSTUSER.TESTDATA directory needs to be obtained at a given time. This
information can be obtained using the DIR command that follows:
dir fpserv1:tstuser.testdata.test007.*
If these files reside on the NOTSECUR 191 minidisk (for which a read password of
ALL is in effect), this information would be retrieved using this command:
dir notsecur.191/test007.*
A fully-qualified pathname can be specified for these FTP subcommands:
v APPEND (APPE)
v DELETE (DELE)
v DIR (LIST)
v LS (NLST)
v GET, MGET (RETR)
v SIZE (SIZE)
v PUT, MPUT (STOR)
v PUT, MPUT with SUNIQUE active (STOU)
Note: When fully-qualified path names are used with FTP subcommands, the FTP
server temporarily acquires the appropriate z/VM file system resource
necessary to satisfy a request. This action by the FTP server does not alter
the working directory that has been established through use of either the
CD or CWD commands.
Storage Space Requirements for Transferred Files
The information that follows must be considered when files are stored on a z/VM
host, especially when minidisk or SFS storage space is constrained, or when
attempts are made to minimize the use of such space.
As part of necessary overhead required by the FTP server and by CMS for
performing file system management, a number of storage blocks must be reserved
and used for other than data storage purposes. For instance, some blocks are used
as control blocks to maintatin the minidisk file directory (for which additional
block space may be required as new files are created), while others are used as
pointer blocks to manage file structure.
However, these various reserved blocks are not reflected in the output returned for
the CMS QUERY DISK or QUERY LIMITS commands. This means the results
obtained from these commands must be used only as an approximation of storage
block usage and availability when determining whether a file can be stored on a
z/VM host.
Chapter 2. Transferring Files Using FTP 33