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

Automatic File Translation
The z/VM FTP server can be configured by the system administrator to
automatically perform EBCDIC-ASCII file translation based on the value of a file
extension, which is defined to be the last component of a file name — that is, the
characters that follow the last period in a path name. For file extensions, up to
eight characters are matched and mixed case is not respected.
Automatic file translation, when enabled, is applicable to only the Image (TYPE I)
file transfer type. Thus, if the transfer type is changed to other than Image — for
example, ASCII — during a session for which automatic file translation is active,
automatic translation ceases and files are transferred in accordance with the newly
established transfer type. In such a case, automatic file translation can be reinstated
by changing back to the Image transfer type.
Automatic file translation is recommended when a web browser or graphical FTP
client is used to interact with a z/VM FTP server, because these clients often
default to using a transfer type of Image (or, binary) and do not offer a way for a
different file transfer type to be specified.
The associations between file extensions and file translation are configured by the
z/VM system administrator, as is the initial automatic file translation setting for an
FTP session. While file extension associations cannot be changed by an FTP client,
whether automatic file translation is performed by the server can be controlled by
using the AUTOTRANS operand of the SITE subcommand. For more information,
see “SITE” on page 68.
File List Formats
After an FTP connection has been established with a z/VM foreign host, the FTP
server can be instructed to provide DIR subcommand responses (file lists) inone
of two different list formats:
v
v
VM-format (VM), or
Unix-format (UNIX), sometimes referred to as Unix long-list format.
These formats are described in more detail in the following sections.
VM-format Lists
The VM-format list response provides file information in a format that — for the
minidisk and Shared File System (SFS) directory file groups — closely resembles
that produced by the CMS LISTFILE command. A sample VM-format list response
follows:
Command:
dir
>>>PORT 9,117,32,30,4,53
200 Port request OK.
>>>LIST
125 List started OK
ENDTRACE TCPIP F 80 1 1 1999-07-28 12:24:01 TCM191
LASTING GLOBALV V 43 10 1 1999-11-16 9:05:22 TCM191
NOTRACE TCPIP F 80 1 1 1999-12-16 13:39:21 TCM191
OBEY EXEC V 72 153 2 1996-01-03 16:07:07 TCM191
PACKMODL TESTFILE F 1024 468 117 1996-07-28 13:56:36 TCM191
PROFILE EXEC V 30 10 1 1999-11-16 9:01:10 TCM191
RECF80 TESTFILE F 80 5 1 2000-01-17 14:47:19 TCM191
SETX XEDIT V 46 13 1 1999-11-04 9:13:53 TCM191
TCPIP DATA V 72 99 2 1999-11-18 17:24:05 TCM191
TCPMNT2 NETLOG V 108 48 2 2000-01-17 14:49:09 TCM191
TCPMNT2 SYNONYM F 80 10 1 1999-11-10 8:46:12 TCM191
TCPSLVL EXEC V 37 23 1 1999-02-05 13:20:46 TCM191
FTP Subcommands
Chapter 2. Transferring Files Using FTP 35