Client FTP2

This chapter describes Client FTP2, the File Transfer Protocol (FTP) that allows file transfers among unlike hosts in diverse internetworking environments. It contains these sections:

• About File Transfer Protocol

Provides a brief overview of the Cisco IOS for S/390 File Transfer Protocol implementation.

• Client FTP2

Provides a flow chart of how FTP works.

• Invoking Client FTP2

Describes how to use Client FTP2 as both a TSO command processor and as a regular batch program.

• Client FTP2 Invocation Options

Describes both the general and debug options available with the FTP2 command.

• General Client FTP2 Operation

Describes the general operation of the Client FTP2 program.

• Client FTP2 Commands

Describes each of the Client FTP2 commands and includes a table listing all the commands with a brief description of each.

Commands are:

• Restart Support

Describes how to restart an interrupted file transfer.

• Client FTP2 File Transfer Examples

Provides examples of some of the Client FTP2 commands.

About File Transfer Protocol

The File Transfer Protocol (FTP) is an application protocol in the Internet protocol suite. It allows file transfers among unlike hosts in diverse internetworking environments. Using FTP, you can move a file from one computer to another, even if each computer has a different operating system and file storage format. Files can contain data, programs, text, or anything that can be stored online.

Client FTP/Client FTP2

Two versions of Client FTP are provided with Cisco IOS for S/390: Client FTP2 and Client FTP.

Client FTP2 operates as a three-party model in which there are two control connections and one data connection. The FTP2 control connection and the local host connection are one and the same.

The FTP protocols require that you connect to a host before most commands can be issued. With the Client FTP2 program, an MVS TSO or batch user signs on to the remote host only. Client FTP2 automatically connects and logs on to the Cisco IOS for S/390 MVS host as the local host (thus hiding one side of the three-party model). So after a single sign-on to the remote host, the user can transfer files between the local host and the remote host.

Although Client FTP and Client FTP2 both operate internally as third-party models, Client FTP2 appears to you, the user, to be a two-party model. Also, Client FTP2 commands are designed to resemble UNIX FTP commands; therefore, Client FTP and Client FTP2 commands differ somewhat.

Client FTP2

Figure 2-1 shows the relationship between the Client FTP2 program and two FTP servers in the three-party model, indicating that three connections are maintained. Two connections are for command control and one is for data flow.

Figure 2-1: Client FTP2 program in the Three-Party Model

In Figure 2-1, the user is logged in to the local MVS system and is running FTP2 under TSO. Through FTP2, the user opens a connection to the remote FTP server. The connection to the local FTP server is opened automatically by the Client FTP2 program and is hidden from the user. FTP2 maintains two control connections: One for communication with the Cisco IOS for S/390 FTP server and the second with the remote FTP server.

With FTP2, the user has access to files on both systems. Data transfer occurs directly between the local and remote servers. Data does not pass through the Client FTP2 application.

Invoking Client FTP2

The Client FTP2 program runs as both a TSO command processor and as a regular batch program. This means that you can use Client FTP2 as a TSO command or call it as a regular program with MVS JCL.

Invoking Client FTP2 through TSO

In a TSO environment, Client FTP2 can be accessed as a TSO command processor or can be called as a program with the TSO CALL command. Because Client FTP2 does not use full-screen facilities, it can be used from any type of terminal supported by TSO, including 3270 systems, 3767 systems, and asynchronous ASCII terminals supported by NTO or NPSI.

FTP2 Command Processor

Invoke Client FTP2 by entering the FTP2 TSO command in this format.

Syntax Description

Client FTP2 Enter command or '?' 

Setting local directory to the TSO profile prefix 
250 "USER1." is current prefix 
Client FTP2 Enter command or '?'

FTP2 invocation options are described in Client FTP2 Invocation Options.

Usage Guidelines

All Client FTP2 options must be preceded by a slash (/). If the slash is omitted, the options are not recognized by Client FTP2.

TSO CALL Command

Use the tso call command in a TSO environment to call and execute the FTP2 program out of a specific library. This is especially useful at sites that run multiple releases of the product or have test and production versions of the product at different maintenance levels.

Syntax Description

Usage Guidelines

The data set name, t01tcp.link, might need to be replaced by the appropriate data set name at your installation. Check with your Cisco IOS for S/390 site administrator.

When options are specified in the command statement, they must be enclosed in single quotes.

When invoked by the call command, Client FTP2 runs as a program and not as a TSO command processor. It is not necessary to allocate data sets before calling FTP2 with the call command.

Under TSO, any data set needed by the Client FTP2 program is dynamically allocated and freed.

See Client FTP2 Invocation Options for detailed descriptions of the FTP2 invocation options.

Batch Invocation

The Client FTP2 program can be run in batch as either a program like any other, or as a TSO command processor by running it under a batch Terminal Monitor Program (TMP). FTP2 commands DO, DIR, and LS require a TSO environment to execute, thus they only execute in batch under the TMP.

When run in batch, Client FTP2 sets a program condition code depending on the severity of Client FTP2 errors encountered; a return code of 0 indicates that all commands entered were successful.

You can specify a NETRC file in batch mode. Specify a NETRC DD file with the name of your NETRC file. Use the NETRC invocation option described in Client FTP2 Invocation Options.

Batch Program

You can invoke Client FTP2 in batch in a manner similar to any other batch utility program. Invoking FTP2 as a batch program does not provide a TSO environment that the DO, DIR, and LS commands need. Thus these commands are rejected when FTP2 executes as a batch program.

//jobname    JOB job_stmt_parms 
//FTPSTEP    EXEC PGM=FTP2,PARM='/ option1 option2...'
//STEPLIB    DD DSN=T01TCP.LINK,DISP=SHR 
//SYSPRINT   DD SYSOUT=*
//SYSPUT     DD SYSOUT=*,DCB=BLKSIZE=133
//SYSGET     DD *,DCB=BLKSIZE=80
open unix
user pass
mkdir /u/lpn/d.new

//NETRC DD DISP=SHR,DSN=userid.FTP.NETRC

Read Client FTP2 General Options for detailed descriptions of the FTP2 options.

Batch TMP

You can invoke Client FTP2 in batch as a TSO command processor by running it under a batch TMP.

In the following example, the batch TMP program is IKJEFT01, which is the normal TSO TMP. Since the batch TMP provides the TSO environment, all FTP2 commands are available.

For this example, the user programs are made available through the link list.

//jobname     JOB job_stmt_parms
//* JOB TO RUN FTP IN BATCH
//EXEC PGM=IKJEFT01,REGION=3000K
//SYSTSPRT   DD SYSOUT=X
//SYSPRINT   DD SYSOUT=X
//SYSPUT     DD *,DCB=BLKSIZE=80
open unix
user pass
mkdir /u/lpn/d.new
//SYSTSIN DD *
FTP2 / option1 option2...

Client FTP2 Invocation Options

This section describes the Client FTP2 invocation options and their requirements. These general notes apply to the Client FTP2 invocation options:

• No invocation options are required for the Client FTP2 program. If you specify any, they must be preceded by a slash (/) to meet the conventions of the PL/I runtime support package.

• An option name can immediately follow a slash, as in /FIOS.

• Invocation options are not case sensitive.

• Specify option names exactly as shown. Abbreviations are not permitted.

Client FTP2 General Options

This section describes the Client FTP2 general invocation options.

APP

The APP option (in the form APP=vtam_application_name) identifies the VTAM application name where the client connects. vtam_application_name is a 1- to 8-character name.

FIOS

Normally the FTP program interacts with the user through a terminal. The FIOS option lets the program read and execute a file containing commands and sends the results to a different file. Commands are read from a sequential file allocated to the SYSGET DD statement; execution results are written to a sequential file allocated to the SYSPUT DD statement. Under TSO, the files can be allocated as shown here:

HOST

The HOST option identifies the remote host with which you want to connect. If you include the remote host name specified here in the NETRC file (userid.FTP.NETRC), the program takes the user ID and password from the NETRC file. Otherwise, you are prompted for a user ID and password.

Syntax Description

LOGT

The LOGT option displays the current time before each line is sent to the terminal. This option is automatically set if either the test or FIOS option is specified.

NETRC

The NETRC option indicates a NETRC file is to be used to resolve the remote host ID and password. For batch TMP and straight batch FTP2, the netrc parameter must be coded if a NETRC file is to be used. Additionally, straight batch FTP2 requires a //NETRC DD statement in the job stream pointing to the NETRC file. Interactive and batch TMP users can also pre-allocate the NETRC file by coding an ALLOC statement with NETRC as the DD name. This is useful if the default naming conventions for the NETRC file are not being used.

NOA

No Automatic Logon (noa) specifies that there is no automatic connection to the local host (Cisco IOS for S/390 on MVS).

NOFIRE

The NOFIRE (No Firewall) option indicates that client FTP2 should disregard the Firewall-Friendly FTP RFC1579. The default is to implement FRC1579.

SYS

The SYS invocation option, in the form SYS=x, where x is an arbitrary character, identifies an alternate Cisco IOS for S/390 VTAM application to handle the Telnet connections established by the Client FTP2 program. This option is useful in cases where multiple copies of Cisco IOS for S/390 are running concurrently. You can specify SYS=x to access a network server called ACCESx instead of the usual ACCES.

WAIT

The WAIT option causes the terminal keyboard to remain locked while a data transfer is in progress. Normally the keyboard remains unlocked allowing additional commands to be entered during a data transfer.

This option is automatically set if the FIOS option is specified.

Client FTP2 Debugging Options

The Client FTP2 debugging options are used to gather debugging information on the internal operation of the Client FTP2 program and the interactions between the Client FTP2 program and the Server FTPs. Normally the debugging information displays on the terminal, but if the FIOS option is in effect, the information is written to the data set represented by the SYSPUT DD statement.

TEST

Use the TEST option to display all requests sent and all responses received on the control connections to each Server FTP. This option can be turned on or off while the program is running by issuing the debug command.

TESTI

Use the TESTI option to obtain local terminal input and output information, as well as to provide the TEST and DISP information.

VLT

The VLT option turns on tracing of the virtual line terminal sessions associated with the FTP2 session. This option is useful for debugging VTAM problems between the FTP2 session and the Cisco IOS for S/390 address space. The VLT option generates an enormous amount of output. When used interactively, this output comes to the terminal. When used in batch, the output is written to the SYSVLT DD. When you run FTP2 in batch, you must add this DD statement to the JCL:

General Client FTP2 Operation

These steps outline the general procedure for using the Client FTP2 program:

Path Name

A path name is a string that identifies a file to a file system. A path name must contain a device and/or directory name and a file name. The FTP specification does not specify a standard path name convention. Each user must follow the file naming conventions of the file systems involved in the transfer. Consult the System Administrators at the host sites involved in the transfer for file naming conventions.

Many of the Client FTP2 commands take one or more path name arguments. For information about the syntax for MVS path names supported by the Cisco IOS for S/390 Server FTP, read Data Set Names in Server FTP.

Client FTP2 Command Conventions

These general notes apply to the Client FTP2 commands:

Program Prompt

To indicate successful completion of most commands, the Client FTP2 program gives a new prompt. However, when a data transfer command is issued, a prompt appears when the operation begins successfully. You can then enter other commands (such as, status requests with the stat command) while the operation proceeds.

Completion of Data Transfer

Final completion of the data transfer command is indicated with a message.

You can use the TEST invocation option to see the specific FTP commands and responses sent and received over the control connections as a result of Client FTP2 commands. If you want more information about this test, refer to RFC 959.

Case Sensitivity

The Client FTP2 commands are not case sensitive.

Abbreviations in Commands

Abbreviations are permitted if they are not ambiguous. For example, you can type AB for ABORT but you cannot type only A because several commands begin with this letter.

Brackets in Commands

In the examples, parameters enclosed by brackets are optional for the command line. In many cases, if the optional parameters are omitted from the command line, you are prompted for them.

Syntax Conventions

Command words are shown in uppercase and parameters are shown in lowercase. When the actual values for a parameter are given (such as, debug[on/off]), they are shown in uppercase.

Example Conventions

In all examples of Client FTP2 input and output in this manual, user entries are shown in boldface type.

The Client FTP2 examples in this manual assume that you have issued open and implied log commands similar to this example to connect an IBM MVS TSO user to another system:

OPEN unix
220 unix FTP server (SunOS 4.0) ready.
Enter name (unix:jim): jim
331 Enter PASS command
Password:

The NETRC File

The Client FTP2 program uses information in the NETRC file for automatic login to the remote host. The NETRC file is assumed to be named dsnpref.FTP.NETRC. The dsnpref is the same as the TSO profile prefix at the time of execution of the ftp2 command. If noprefix is set in the TSO profile, then the dsnpref is the same as the executing TSO user ID. To use a different naming convention for this file, you must pre-allocate it with an NETRC DD statement.

The NETRC file also contains macros executed by the FTP2 program. You can define up to twenty macros in the NETRC file. Begin each macro with a MACDEF statement, enter valid Client FTP2 commands, and terminate the macro with an ENDMAC statement. If you define a macro named INIT, it is executed automatically before the Client FTP2 program issues the first prompt. (You do not need to issue a $ command to execute the INIT macro.) For more information about the MACDEF statement, read MACDEF.

---

If you have not created a NETRC file, you are prompted to supply a user ID and password for the remote host whenever you open a connection to a remote host.

This is the format of the NETRC file; edit this file to specify user IDs, passwords, and accounts or to create a macro.

MACHINE remote_host_name 
LOGIN userid (for preceding remote host)
PASSWORD password (for preceding remote host)
ACCOUNT account (for the preceding remote host)
MACDEF macro-name 
stat
ENDMAC (terminates a macro)

If an installation does not require a password and/or an account, these can be omitted. Before using the following Client FTP2 commands, you must log on to a remote host with an open command.

 
Caution You should use your local access control facility to protect NETRC files since these files can contain valid user ID password combinations for remote hosts. Only the TSO user ID using the NETRC file should be able to read their own NETRC file.

The NETRC file can also be used in batch jobs by using the NETRC invocation along with a NETRC DD pointing to your NETRC data set.

---

Note The batch invocation for NETRC does not assume a default FTP.NETRC data set name.

---

Client FTP2 High-Level Qualifier

The DEFPRFX parameter on the FTP statement in the file APPCFGxx is a server configuration parameter. It tells Server FTP what is the default high level qualifier to be used when starting an FTP server session. You can change the high level qualifier with the appropriate directory commands (cwd and cdup).

Client FTP2 Commands

Table 2-1 gives a brief description of each command and its function; detailed descriptions of each command follow the table.

? Command

Use the ? command to display information about using the Client FTP2 program.

Syntax Description

Default

If the ? command is specified with no arguments, it displays a list of Client FTP2 commands.

Usage Guidelines

The ? command can be used either with or without arguments.

If command_name is specified as an argument to the ? command, a line of information displays similar to the information in the table in Client FTP2 Commands. The line shows the command syntax and a short description of the command function.

Example

? Dir

Related Commands

! Command

The ! command (do tso command) requests the Client FTP2 program to execute a tso command for you.

Syntax Description

Usage Guidelines

The tso_command argument is required.

This command requires that the TSO environment exist.

The ! command cannot be used for batch FTP2 without the TMP.

Example

! listc
IN CATALOG: CATALOG.MVSICF1.VMVSTSO
USER1.ACCES.ASM
USER1.LIB.LOAD
USER1.T.D
USER1.VBIG.D
USER1.VB.D.

$ Command

The $ command executes a specified macro you have defined either with a macdef command or in the NETRC file (see the sections of this chapter describing the macdef command and the NETRC file for more information).

Example

In the following example, $ is calling a macro called sp, which displays status, the current working directory, and ends the macro.

macdef sp
SP:stat
SP:pwd
SP:endmac
$ sp
EXECUTING: stat
Connected to: UNIX
--- STATUS ---
-- FTP Parameters ---
Remote DT Host, Port 127.0.0.1, 0 
Local DT  Host, Port 138.42.224.15, 0
Type A N   Tabs 8   Stru F   Mode S   Recall 5
-- END --
-- Control --
User USER1   Acct Accs E0000200   Unit SYSALLDA
Host 138.42.224.15
-- End Control --
-- Path Data --
Rlse
-- End Path Data --
-- Transfer Information --
Data transfer not in progress
-- END --
211 <End of Status>
Executing: pwd
257 "/home/unix/user1" is current directory.
Executing: endmac

ABOR

Use abor (abort) to instruct the Server FTP to abort the last command issued and any associated transfer of data. No action is taken by the Server FTPs if the previous command has been completed (including data transfer). The control connections to the Server FTPs are not closed, but the data connections are closed.

Syntax Description

This command has no arguments or keywords.

Default

The abor request is directed to both Server FTPs.

Example

get +outmail temp.data
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Path USER1.TEMP.DATA
Volser HAGCAT   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80
Blksize 3120   Space 1 5 Tracks Rlse
150 ASCII data connection for +outmail (138.42.224.15,4099) (167076 bytes)
ABOR
-Data transfer aborted.
 65536 bytes received in 6.65 seconds (9855 bytes/s)
Path USER1.TEMP.DATA   User USER1   Data bytes received 68948
Disk tracks written 1   Records padded 2997
226 Abort command completed.
426 Transfer aborted. Data connection closed.
226 Abort successful
225 ABOR command successful.

ALLO

The allo command allocates a file size to those Server FTPs that require it. Refer to the documentation for your particular Server FTP to see if you need this command. The Cisco IOS for S/390 Server FTP does not require use of the allo command; you can use it to cause records to be truncated or to allocate space.

Syntax Description

Usage Guidelines

If files are sent with record or page structure, a maximum record or page size (in logical bytes) can be required.

The R size argument is optional; if specified it must be separated from the first argument by the three characters, " R " (space R space)

The allo command requires a host prefix. For information on host prefixes, see Using Host Name Strings in Introduction to Cisco IOS for S/390.

Example

stru r
site lrecl(60) blk(6000)
allo 12000 r 60
put n.d allor.data
ALLOCMD = ALLO 12000 r 60
150-Data set open with attributes:
Type A N   Tabs 8   Stru R   Mode S   Recall Path USER1.ALLOR.DATA
Volser ICSPK1   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80
Blksize 6160   Space 1 1 Tracks Rlse   Maxr 60
-Data set open with attributes:
Type A N   Tabs 8   Stru R   Mode S   PATH USER1.N.D
Volser COLPK1   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80
Blksize 3120   Rlse
226-Transfer complete
 3441 bytes received in 0.37 seconds (9300 bytes/s)
Path USER1.ALLOR.DATA   User USER1   Data bytes received 3277
Disk tracks written 1   Records truncated 21   Records padded 80
-Transfer complete
 3441 bytes sent in 0.25 seconds (13764 bytes/s)   Path USER1.N.D
User COLMBIA   Data bytes sent 6480
Disk tracks read 1

APPEND

The append command requests that a file from the local host be appended to a file at the remote host.

Syntax Description

Default

If either file name is omitted, you are prompted for the file name.

Usage Guidelines

The syntax for each path depends on the associated Server FTP.

Example

append n.d myappend.data
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Path USER1.N.D
Volser COLPK1   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80
Blksize 3120   Rlse
150-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Recall 5
Path USER1.MYAPPEND.DATA
Volser HAGCAT   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80
Blksize 6160   Space 5 3 Tracks Rlse
-Transfer complete
 3439 bytes sent in 0.46 seconds (7476 bytes/s)   Path USER1.N.D
User COLMBIA   Data bytes sent 6480
Disk tracks read 1
226-Transfer complete
 3439 bytes received in 0.42 seconds (8188 bytes/s)
Path USER1.MYAPPEND.DATA   User USER1   Data bytes received 3277
Disk tracks written 1   Records padded 80

ASCII

The ascii command sets the data type to ASCII for the transfer of an ASCII file.

Example

ASCII
stat
Connected to: MVS
--- STATUS ---
--- FTP PARAMETERS ---
Remote DT Host, Port 138.42.224.13, 0 
Local DT  Host, Port 138.42.224.15, 0
Type A N   Tabs 8   Stru F   Mode S   Recall 5  Server is passive
-- END --
-- Control --
User COLMBIA   Acct Accs E0000200   Unit SYSALLDA   Host 138.42.224.15
-- End Control --
-- Path Data --
Rlse
-- End Path Data --
-- Transfer Information --
Data transfer not in progress   Data bytes sent 6480
Disk tracks read 1   Network bytes sent 3439   Elapsed time 00.00.00
Bytes/Second 7476
-- END --
211 <End of Status>

Related Commands

BINARY

The BINARY command sets the data type to binary for the transfer of a binary file.

Syntax Description

This command has no arguments or keywords.

Example

BINARY 
stat
Connected to: MVS
--- STATUS ---
-- FTP Parameters --
Remote DT Host, Port 138.42.128.13, 0
Local DT  Host, Port 138.42.224.15, 0
Type I N   Stru F   Mode S   Recall 5   Server is passive
-- END --
-- Control --
User COLMBIA   Acct Accs E0000200   Unit SYSALLDA   Host 138.42.224.15
-- End Control --
-- Path Data --
Rlse
-- End Path Data --
-- Transfer Information --
Data transfer not in progress   Data bytes sent 6480
Disk tracks read 1   Network bytes sent 3439   Elapsed time 00.00.00
Bytes/Second 7476
-- END --
211 <End of Status>

Related Commands

BYE

The BYE command terminates the Client FTP2 program. This command is the same as the END and QUIT commands.

Syntax Description

This command has no arguments or keywords.

Example

BYE
221 Goodbye.

Related Commands

CD

The CD command requests that the remote Server FTP change the current directory to a new directory.

Syntax Description

Default

If you omit path_name, the Client FTP2 program prompts you for the desired value.

Usage Guidelines

The syntax for path_name depends on the associated Server FTP.

Example

A UNIX Server FTP in session with the Client FTP2 program is using /u/user1/work as the current directory. If a CD junk command is issued by the Client FTP2 to that UNIX Server FTP, the resulting current directory is /u/user1/work/junk. The same result is achieved by specifying CD /u/user1/work/junk.

This example shows a change of directory to a remote UNIX system:

250 CWD command successful.

This example shows a change to a directory on a remote system running Cisco IOS for S/390:

250 "'USER1.ACCES.'" is current prefix

CDUP

The CDUP command directs the remote Server FTP to change the current directory to the parent directory of the old current directory. The CDUP command is most useful when the Server FTP manipulates a hierarchical file system such as UNIX.

Syntax Description

This command has no arguments or keywords.

Example

A UNIX Server FTP in session with the Client FTP2 program has /u/user1/work as the current directory. If a CDUP command is issued by the Client FTP2 to that UNIX Server FTP, the resulting current directory is the parent of the old current directory (/u/user1).

This example shows a change to the parent directory of the old current directory on a remote UNIX system:

CDUP
250 CWD command successful.

CLOSE

The CLOSE command logs you out and terminates the connection between you and the remote Server FTP.

Syntax Description

This command has no arguments or keywords.

Example

CLOSE
221 Goodbye.

DEBUG

The DEBUG command displays all commands and responses going to and from the Server FTPs and the user. This command is equivalent to specifying the TEST option on the Client FTP2 command line.

Syntax Description

Default

If no parameter is specified with the DEBUG command, the command toggles the previous state.

Example

DEBUG ON

DELETE

The DELETE command directs the remote Server FTP to delete the specified file.

Syntax Description

Default

If you omit path_name, you are prompted to supply one.

Usage Guidelines

The syntax for path_name depends on the associated Server FTP.

Example

DELETE gatedel
250 DELE command successful. 

DIR

The DIR command requests that the remote Server FTP provide a directory list for the specified path.

Syntax Description

Defaults

The current directory is displayed to your screen.

Usage Notes:

The DIR command requires that the TSO environment exist (that is, you are not running batch FTP2 without the TMP).

Example

The following example lists the contents of a directory on an MVS system.

ftp> DIR /export/home/user1/mvs
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Recall 5
Path USER1.FTP.TMP.T1330492
Volser ICSUSR   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80
Blksize 6160   Space 5 3 Tracks Rlse
150 ASCII data connection for /bin/ls (138.42.224.15,4126) (0 bytes).
226 ASCII Transfer complete.
-Transfer complete
 322 bytes received in 1.50 seconds (214 bytes/s)
Path USER1.FTP.TMP.T1330492   User USER1   Data bytes received 310
Disk tracks written 1   Records padded 6
total 20
-rw-------     1 user1     dvlp     2730 Oct 22     08:36 channel
-rw-------     1 user1     dvlp     2901 Sep  1     09:17 comten
-rw-------     1 user1     dvlp     1276 Oct 21     14:43 dump
-rw-------     1 user1     dvlp      729 Nov 12     05:24 ibmlink
-rw-------     1 user1     dvlp      751 Nov 12     07:41 ibmlink2
IDC05501 ENTRY (A) USER1.FTP.TMP.T1330492 DELETED
ftp>

DISCONNECT

The DISCONNECT command disconnects you from a host. It logs you out and terminates the connection between you and the remote Server FTP. The CLOSE command is the same as the DISCONNECT command.

Syntax Description

This command has no arguments or keywords.

Example

The following example shows the DISCONNECT command.

ftp> DISCONNECT
disconnect
221 Goodbye.
ftp.

DO

The DO (do TSO command) command requests the Client FTP2 program to execute a TSO command for you.

Syntax Description

Usage Notes

The tso_command argument is required.

The DO command is handled by the Client FTP2 program.

The DO command requires that the TSO environment exist (in other words, you are not running batch FTP2 without the TMP).

Example

DO listc l(lpn)
NONVSAM-------LPN.ABOR
IN-CAT--CATALOG.MVSICF1.VMVSTSO
NONVSAM-------LPN.FTPNETRC
IN-CAT--CATALOG.MVSICF1.VMVSTSO
NONVSAM-------LPN.CNTL
IN-CAT--CATALOG.MVSICF1.VMVSTSO
NONVSAM-------LPN.FTPEXAMPLE 
IN-CAT--CATALOG.MVSICF1.VMVSTSO.

EBCDIC

The EBCDIC command sets the data type to EBCDIC for transfer of an EBCDIC file. The command is equivalent to the TYPE command with the EBCDIC (E) parameter specified.

Example

EBCDIC 
EBCD ENTERED
stat
CONNECTED TO: MVS
--- FTP PARAMETERS ---
REMOTE DT HOST,PORT 129.192.224.136, 0 
LOCAL DT HOST,PORT 129.192.224.136, 20
TYPE E N TABS 8 STRU F MODE S
--- ACCESS CONTROL ---
USER LPN ACCT ACCS E0000200 VOLS MVSTSO TELNET HOST 129.192.224.136
SESSION# 412
--- PATH DATA ---
--- TRANSFER INFORMATION ---
DATA TRANSFER NOT IN PROGRESS

END

The END command terminates the Client FTP2 program. This is typically the last command you enter. Any open control connections are closed before the program terminates.

Syntax Description

This command has no arguments or keywords.

Example

END
221 Session terminated

Related Commands

EXPE

The EXPE command toggles the use of experimental or regular directory commands. Since there is no consistent support for this command, it is recommended that you not use this command.

Defaults

No operands are associated with the EXPE command since it is a Client FTP2 command.

Usage Guidelines

Table 2-2 shows the FTP command that is sent over the control connection for each directory command with an EXPE setting:

FIREWALL

The FIREWALL command toggles the implementation of Firewall-Friendly FTP RFC 1579 on and off. RFC 1579 specifies that for FTP data connection establishment, the client sends the PASV command to the remote and the PORT command to the local host. This is the default. When the FIREWALL command is entered to disable this implementation, the FTP2 client will send the PASV command to the local and the PORT command to the remote. You can turn the implementation back on by entering FIREWALL again. A message is returned to the user indicating if Firewall is enabled or disabled.

Syntax Description

This command has no arguments or keywords.

Usage Guidelines

No arguments are associated with the FIREWALL command.

Example

The following example shows the effect of turning the firewall on and off. Initially, the firewall implementation is on.

10:06:23   FTP2:  put n.d temp
10:07:26     TEST - SENDING - B:PASV
10:07:27   227 Entering Passive Mode (138,42,32,165,145,225)
10:07:27     TEST - SENDING - A:PORT 138,42,32,165,145,225
10:07:28   200 OK, Ready
10:07:28     TEST - SENDING - A:RETR n.d
10:07:29   150-Dataset open with attributes:
10:07:29   Type A N    Tabs    8   Stru F   Mode S   Path ABC.N.D   Volser ICS007
10:07:29   Unit SYSICS   Dsorg          PS   Recfm FB   Lrecl   80   Blksize   3120
10:07:29   Rlse 
10:07:30   150 
10:07:30     TEST - SENDING - B:STOR temp
10:07:31   150 ASCII data connection for temp (138.42.220.13,20).
10:07:31   FTP2:    
10:07:34   226-Transfer complete
10:07:35    3439 bytes sent in 1.17 seconds (2939 bytes/s)   Path ABC.N.D
10:07:35   User ABC Data bytes read 6480
10:07:36   Disk tracks read 1
10:07:36   226 
10:07:36   226 Transfer complete.
10:07:36   FTP2:  firewall
10:10:28   ACC831I - Firewall has been disabled
10:10:28   FTP2:  put n.d temp
10:10:58     TEST - SENDING - A:PASV
10:11:00   227 Entering passive mode    138,42,220,13,20,27
10:11:00     TEST - SENDING - B:PORT 138,42,220,13,20,27
10:11:01   200 PORT command successful.
10:11:01     TEST - SENDING - A:RETR n.d
10:11:02   150-Dataset open with attributes:
10:11:03   Type A N    Tabs    8   Stru F   Mode S   Path ABC.N.D   Volser ICS007
10:11:04   Unit SYSICS   Dsorg          PS   Recfm FB   Lrecl   80   Blksize   3120
10:11:04   Rlse 
10:11:04   150 
10:11:04     TEST - SENDING - B:STOR temp
10:11:05   150 ASCII data connection for temp (138.42.220.13,5147).
10:11:05   FTP2:   
10:11:27   226-Transfer complete
10:11:28    3439 bytes sent in 1.22 seconds (2818 bytes/s)   Path ABC.N.D
10:11:28   User ABC   Data bytes read 6480
10:11:28   Disk tracks read 1
10:11:28   226 
10:11:28   226 Transfer complete.
10:11:28   FTP2:  firewall
10:13:10   ACC831I - Firewall has been enabled
10:13:10   FTP2:

GET

The GET command requests that a file from the remote host be copied to a file on the local host by the appropriate Server FTPs. The file to be retrieved is always at the remote host, and the file to be copied into is always at the local host.

Syntax Description

Defaults

If you omit either file name, you are prompted for one.

Usage Guidelines

The syntax for each path depends on the associated Server FTP.

Example

The following example gets the file comten from the remote host and saves it on the local host as temp.data:

ftp> GET comten temp.data
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S  Recall 5  Path USER1.TEMP.DATA
Volser HAGCAT   Unit SYSALLDA   Dsorg  PS   Recfm FB   Lrecl  80
Blksize 3120   Space 1 5 Tracks Rlse
150 ASCII data connection for comten (138.42.224.15,4127) (2091 bytes).
-Transfer complete
 2291 bytes received in 1.34 seconds (2232 bytes/s) Path USER1.TEMP.DATA
User USER1   Data bytes received 2825
Disk tracks written 1   Records padded 90   Records folded 2
226 ASCII Transfer complete.
ftp>

Related Commands

HELP

The HELP command requests help information from the local Server FTP.

Syntax Description

The HELP command has no required operands. Any operands specified on the HELP command are passed through unchanged to the Server FTP and are interpreted by the Server FTP.

Usage Guidelines

After a REST command, STOR and APPE have identical meanings.

Data transfer must be MODE B (block).

A file retrieved normally includes restart markers approximately every 32767 bytes. The REST parameter on the SITE command allows the user to change this interval or even entirely suppress restart markers. See HELP SITE. The actual decision to send a marker depends on a count of data bytes read from the disk (not including OS count/control bytes). When this count reaches the limit, the marker is sent at the next end of a complete logical record, segment of a spanned record (if RECFM includes VS), or a physical disk block (if RECFM is U, V, or F).

FTP can accept (and send) restart markers in either STRU F  or STRU R.

FTP restart markers consist of 10 characters, which are the hexadecimal representation of five 8-bit bytes: TTRBB. Here, TTR forms a standard OS disk block address, and  BB is a byte offset within the block.

Example

HELP REST
--- HELP---
*** HELP REST ***
FTP REST (Restart) Command:
Function: Specifies that the data transfer command that follows  (immediately) is to restart
at a specified intermediate point in the file.
Syntax:  REST <marker>
214  <end of HELP>

Related Commands

LOG

The log (login) command gives a user ID and password to a remote Server FTP to identify the user. You can optionally change your password when logging in to the Cisco IOS for S/390 server. The log command typically is issued immediately following the open command.

Syntax Description

Default

The Client FTP2 program prompts you for the user ID and/or current password.

Usage Guidelines

If the remote Server FTP requires additional accounting information during the user identification process, the Client FTP2 program prompts you to enter the accounting data.

Examples

The /new_password parameter is a 1- to 8-character string password. The new password replaces the current password after the user ID and current password are validated. The new password option is valid only when talking to the Cisco IOS for S/390 server. The slash (/) must follow the current password without any intervening blanks. The new password must follow the slash without any intervening blanks, as in the following example:

LOG lpn tstpass 
230 User lpn logged in.

In the following example, user USER01 wants to change his current password from CJAY to MACDUFF.

LOG user01 cjay/macduff
230 User USER01 logged in.

LQUOTE

The lquote command sends an uninterpreted, unaltered character string to the local Server FTP over the control connection. This mechanism sends FTP commands to the Server that the Client FTP2 program might not be able to send.

Syntax Description

This command has no arguments or keywords.

Default

If the text is omitted, you are prompted for it.

Usage Guidelines

The text is sent to the local FTP Server over the control connection exactly as you entered it.

Example

LQUOTE site vol(mvsts2)

LS

The ls command requests a remote Server FTP to provide a list of file names for the specified path.

Syntax Description

Default

If a local path is not specified, the list of files appears on your screen.

Usage Guidelines

If the path specifies a directory or other group of files, the remote Server FTP transfers a list of files.

The syntax for each path depends on the associated Server FTP

If a local path is specified, the list of files is written to the specified file.

The LS command requires that the TSO environment exist (that is, you are not running batch FTP2 without the TMP).

Examples

The following example shows the ls command with parameters:

LS /export/home/user1 unix.dir.temp
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Recall 5
Path USER1.UNIX.DIR.TEMP
Volser ICSUSR   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl  80 
Blksize 6160   Space 5 3 Tracks Rlse
150 ASCII data connection for /bin/ls (138.42.224.15,4134) (0 bytes).
226 ASCII Transfer complete.
-Transfer Complete
 350 bytes received in 1.54 seconds (227 bytes/s) 
Path USER1.UNIX.DIR.TEMP   User USER1   Data bytes received 274
Disk tracks written 1   Records padded 38

The following example shows the LS command without parameters:

LS
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Recall 5
Path USER1.FTP.TMP.T1443273
Volser ICSUSR   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl  80 
Blksize 6160   Space 5 3 Tracks Rlse
150 ASCII data connection for /bin/ls (138.42.224.15,4135) (0 bytes).
226 ASCII Transfer complete.
-Transfer complete
 42 bytes received in 1.47 seconds (28 bytes/s)
Path USER1.FTP.TMP.T1443273   User USER1   Data bytes received 32
Disk tracks written 1   Records padded 5
channel
comten
dump
filea
tempfile
IDC0550I ENTRY (A) USER1.FTP.TMP.T1443273 DELETED

MACDEF

The MACDEF command enables you to define a sequence of commands you want to execute more than once (a macro).

Syntax Description

Usage Guidelines

When you issue the MACDEF command, you are prompted for each line of input. You must enter valid Client FTP2 commands.

To terminate input, press RETURN.

To execute the macro, issue a $ command (read $ Command).

The macro is temporary and is deleted automatically at the end of your session. To create a permanent macro, read The NETRC File.

MACDEF handles  \  (backslash) and $ (dollar) as special characters.

A $ followed by a digit 1-9 is replaced by the corresponding argument on the macro invocation command line (the $ command).

A  \  followed by any character is replaced by that character. Use  \  with $ to prevent special handling of the $.

Use  \\  to cause a single  \  to be interpreted.

Macros cannot be nested (one macro cannot call another macro).

Example

USERFTP: MACDEF getfrom
GET:open $1
GET:pwd
GET:get $2 $3
GET:close
GET:endmac
USERFTP: $ getfrom host1.md.company.com ftpdata 'abc.ftp.test'
Executing: open host.md.company.com
220 host FTP server (UNIX(r) System V Release 4.0) ready.
230 User abc logged in.
Executing: pwd
257 "/opt/home/abc" is current directory.
Executing: get ftpdata 'abc.ftp.test'
-Dataset open with attributes:
Type A N  Tabs  8   Stru F   Mode S   Recall 5   Path ABC.FTP.TEST
Volser ICSPK3  Unit SYSALLDA  Dsorg  PS   Recfm U
Blksize   6160    Space 1     Tracks   Rlse
150 ASCII data connection for ftpdata (138.42.128.13,4679)
   (2893 bytes
226 ASCII Transfer complete.
-Transfer complete
2927 bytes received in 1.16 seconds (2523 bytes/s)
  Path  ABC.FTP.TES
User ABC  Data bytes written 2927
Disk tracks written 1
Executing: close
Executing: endmac

MKDIR

The MKDIR (make directory) command directs a remote Server FTP to create the specified directory.

Syntax Description

Defaults

If you omit path_name, you are prompted for it.

Usage Guidelines

If the path name is relative, the specified subdirectory is created in the current working directory.

If the path name is absolute, the specified directory is created.

The syntax for path depends on the associated Server FTP.

Example

A UNIX Server FTP in session with the Client FTP2 program has /u/user1/work as the current directory. If a MKDIR junk command is issued by the Client FTP2 to that UNIX Server FTP, the subdirectory junk is created in the current directory (/u/user1/work/junk). The same result is achieved by specifying MKDIR /u/user1/work/junk.

MKDIR /u/lpn/d.new
257 MKD command successful.

MODE

The mode command sets one of two transmission modes:

• Block mode

• Stream mode

Block Mode

Block mode is indicated with the character b. In block mode, the file is transmitted as a series of data blocks preceded by one or more header bytes. Record structures are allowed in this mode, and any representation type can be used. Restart markers are embedded in the data stream.

Stream Mode

Stream mode is set with the character s. This is the default if no mode command has been used. In stream mode, the data is transmitted as a stream of bytes. There are no restrictions on the representation type used, and record structures are allowed. In a record structured file, End of Record (EOR) and End of File (EOF) are each indicated by a two-byte control code included with the data sent over the data connection. If the structure is a file structure, the EOF is indicated by the sending host closing the data connection, and all bytes sent over the data connection are data bytes.

NTRANS

The ntrans command is executed prior to a file transfer to enable you to change the name of the file you are transferring. When you execute the file transfer and create a file at a destination, the transferred file has the name you specify with the ntrans command.

Syntax Description

Default

If either parameter is omitted, you are prompted for it.

Example

Suppose that you have a file named ABC(DEF) and you issue this command:

NTRANS () .z

To effect the change specified in the ntrans command, issue a put or get command to transfer the file, as shown here:

PUT abc(def)

Issue the file transfer command without a second file name. The file ABC(DEF) is created at its destination with the name ABC.DEFZ (the left parenthesis is changed to a period (.) and the right parenthesis is changed to a Z).

NTRANS nd ab
PUT n.d
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Path USER1.N.D
Volser COLPK1   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80 
Blksize 3120 Rlse
150-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Recall 5   Path USER1.A.B
Volser ICSPK2   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80
Blksize 6160   Space 5 3 Tracks Rlse
-Transfer complete
 3439 bytes sent in 0.55 seconds (6252 bytes/s)   Path USER1.N.D
User USER1   Data bytes sent 6480
Disk tracks read 1
226-Transfer complete
 3439 bytes received in 0.48 seconds (7164 bytes/s) Path USER1.A.B
User USER1   Data bytes received 3277
Disk tracks written 1   Records padded 80

OPEN

The open command sets up one control connection between the Client FTP2 program and a Server FTP. You can also connect to a "remote" Server FTP that is actually your local Server FTP by specifying your own local host name.

Syntax Description

Default

If you omit the host name, you are prompted for one.

Usage Guidelines

Host name strings must correspond to the syntax specified in Introduction to Cisco IOS for S/390.

Once a host connection is established, FTP2 prompts for a user ID, password (and optionally an account) combination when one is not provided in the NETRC file.

A successful open command implies an automatic log command attempt by FTP2.

Example

OPEN unix
220 unix FTP server (SunOS 4.0) ready.
Enter name (unix:user1): user1
331 Enter PASS command
Password: 

PUT

The put command requests that the appropriate local Server FTP copy a file to the remote system. The file to be copied is always at the local Server and the file destination is always at the remote Server.

Syntax Description

Default

If you omit either path, you are prompted for the file name.

Usage Guidelines

The command name SEND can be used in place of PUT. There are no other differences when using SEND.

The syntax for each path depends on the associated Server FTP.

Example

PUT telnet.data teltemp
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Path USER1.TELNET.DATA
Volser COLPK1   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 120
Blksize 3600   Rlse
150 ASCII data connection for teltemp (138.42.224.15,4104)
-Transfer complete
 11535 bytes sent in 2.22 seconds (5195 bytes/s)
Path USER1.TELNET.DATA
User COLMBIA   Data bytes sent 19680
Disk tracks read 1
226 ASCII Transfer complete.

PWD

The pwd command directs a remote Server FTP to return the path name of the current working directory.

Syntax Description

This command has no arguments or keywords.

Example

PWD
257 "/u/lpn" is current directory.

QUIT

The quit command terminates the Client FTP2 program. This command is the same as the bye and end commands.

Syntax Description

This command has no arguments or keywords.

Example

quit
221 Goodbye.  

Related Commands

QUOTE

The quote command sends an uninterpreted, unaltered character string to the remote Server FTP over the control connection. This mechanism sends FTP commands to the Server that the Client FTP2 program might not be able to send.

Syntax Description

Default

If the text is omitted, you are prompted to enter it.

Example

QUOTE pasv
227 Entering Passive Mode (26,131,0,17,4,216).

RECV

The recv command requests that a file from the remote host be copied to a file on the local host by the appropriate Server FTPs. The file to be retrieved is always at the remote host, and the file to be copied to is always at the local host.

Syntax Description

Default

If you omit either file name, you are prompted for it.

Usage Guidelines

The syntax for each path depends on the associated Server FTP.

Example

RECV teldata temp.data
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Recall 5   Path USER1.TEMP.DATA
Volser ICSUSR   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80
Blksize 6160   Space 5 3 Tracks Rlse
150 ASCII data connection for teldata (138.42.224.15,4112) (11371 bytes).
226 ASCII Transfer complete.
-Transfer Complete
 11535 bytes received in 1.56 seconds (7394 bytes/s)
Path USER1.TEMP.DATA   User USER1   Data bytes received 11207
Disk tracks written 1   Records padded 147   Records folded 69

Related Commands

REMHELP

The remhelp command requests help information from the remote Server FTP

Syntax Description

Usage Guidelines

No operands are required for the remhelp command.

The remhelp command is different from the ? command in that the remhelp command requests help from the remote Server FTP, whereas the ? command requests help from the Client FTP2 program.

Example

REMHELP list
214 Syntax: LIST .  <sp> path-name . 

REMSITE

The remsite (remote site parameters) command provides the remote Server FTP with specific information it requires. This information is essential to file transfers involving that Server FTP, but is not sufficiently universal to have been included specifically in the FTP. Typically, you use a remhelp site Client FTP2 command to find the site requirements for a specific remote Server FTP. Otherwise, review the Server FTP documentation for the site requirements.

Syntax Description

Example

The following example shows a remsite command to change the default FTP volume:

REMSITE vol(mvsts2)

REMSNDS

The remsnds (resend REMSITE parameters) command directs the Client FTP2 program to resend the last remsite command to the remote Server FTP. Your remsite command is reissued without your having to retype it. Since most Server FTPs require that new site parameters be provided before each data transfer, the remsnds saves time if you repeatedly use identical site parameters.

Syntax Description

This command has no arguments or keywords.

Usage Guidelines

You can preserve site parameters between data transfers by using the PERSIST option in the site command.

Example

SITE vol(mvsts2)
REMSNDS
site vol(mvsts2) <Sent

REMSTAT

The REMSTAT command requests a status response from the remote system.

Syntax Description

Default

If no path name is given, the remote Server FTP sends status information relative to parameters, connection status.

Usage Guidelines

The path_name argument is optional.

When REMSTAT is issued between data transfer operations, the path_name argument can be given.

With REMSTAT, the information is transferred over the control connection instead of the data connection.

The syntax of path_name depends on the associated Server FTP

The Cisco IOS for S/390 Server FTP program implements some additional parameters on the remstat command. Use a help remstat Client FTP2 command to find additional parameters.

Example

REMSTAT /u/lpn
502 STAT command not implemented.

RENAME

The rename command directs a remote Server FTP to rename a file.

Syntax Description

Default

If you omit either argument, you are prompted to enter it.

Usage Guidelines

The syntax of the path names depends on the associated Server FTP.

Example

RENAME titlecol coltitle
350 File exists, ready for destination name
250 RNTO command successful.

REST

The rest (restart) command shows the Server FTP the restart marker where a file transfer is to be restarted. This command does not cause a file transfer but instead causes the Server FTP to skip over the file to the specified data checkpoint. This command should be followed immediately by the Client FTP2 command that causes the file transfer to resume.

Syntax Description

Usage Guidelines

Both marker arguments are required and represent the Server FTP marker where the file transfer is to be restarted.

The format of the restart marker is determined by the sending Server FTP and should be entered exactly as displayed during the interrupted file transfer.

Example

The following example shows a restart marker message received by a user during a previous file transfer:

B:110 MARK 010023010E8C = 010023010E8C

To restart the file transfer at the restart markers, issue the commands shown in bold in this output display:

MODE B
BINARY
SITE REST(100000)
REST 010023010E8C 010023010E8C
PUT 'scm.p016572.T01TCP' job16572.MYFILE
350 Requested file action pending further information
350 Requested file action pending further information
150-Data set open with attributes:
Type I N   Stru F   Mode B   Recall 5   Path USER1.JOB16572.MYFILE
Volser ICSPK2   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 133
Blksize 6650   Space 3 1 Cyl Rlse   Restart at 010023010E8C
-Data set open with attributes:
Type I N   Stru F   Mode B   Path SCM.P016572.MYFILE
Volser HAGCAT   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 133
Blksize 6650  Rlse  Bytes/Restart 100000   Restart at 010023010E8C
110 MARK 010025040F96 = 010025040F96
110 MARK 0100280110A0 = 0100280110A0
-Transfer complete
 223966 bytes sent in 1.91 seconds (117259 bytes/s)
Path SCM.P016572.MYFILE   User COLMBIA   Data bytes sent 218918
Disk tracks read 6   Restart markers send 2
226-Transfer Complete
 223966 bytes received in 1.90 seconds (117876 bytes/s)
Path USER1.JOB16572.MYFILE   User USER1   Data bytes received 218918
Disk tracks written 6   Records folded 1646
Restart markers received 2

RMDIR

The rmdir (remove directory) command directs a remote Server FTP to remove the specified directory.

Syntax Description

Default

If you omit path_name, you are prompted for it.

Usage Guidelines

If the path name is relative, the specified subdirectory is removed from the current working directory.

If the path name is absolute, the specified directory is removed.

The syntax of path_name depends on the associated Server FTP.

Example

As an example, if a UNIX Server FTP in session with the Client FTP2 program has /u/user1/work as the current directory, and a rmdir junk command is issued by Client FTP2 to that UNIX Server FTP, the junk subdirectory of the current directory is removed. The same result is achieved by specifying rmdir /u/user1/work/junk.

RMDIR /u/lpn/d.samp
250 RMD command successful. 

SEND

The SEND command is the same as the PUT command. Read PUT for details about the SEND command.

Syntax Description

Default

If you omit either path, you are prompted for the file name.

Usage Guidelines

The command name PUT can be used in place of SEND. There are no other differences when using PUT.

The syntax for each path depends on the associated Server FTP.

Example

SEND n.d temp
-Data set open with attributes:
Type I N   Stru F   Mode B   Path USER1.N.D
Volser COLPK1   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80 
Blksize 3120   Rlse   Bytes/Restart 500000
150 ASCII data connection for temp (138.42.224.15,4115).
-Transfer complete
 6726 bytes sent in 1.58 seconds (4256 bytes/s)   Path USER1.N.D
User COLMBIA   Data bytes sent 6480
Disk tracks read 1
226 ASCII Transfer complete.

SITE

The SITE (site parameters) command provides the local Server FTP with specific information it requires. This information is essential to file transfers involving that Server FTP, but is not sufficiently universal to have been included specifically in the FTP. Typically, you use a HELP SITE Client FTP2 command to find the SITE requirements for a specific local Server FTP. Otherwise, review the Server FTP documentation for the SITE requirements.

Syntax Description

SITE command parameters are described in the SITE section in Server FTP.

Example

This is an example of a SITE command to change the default FTP volume:

SITE vol(mvsts2)

SNDS

The SNDS (resend SITE parameters) command directs the Client FTP program to resend the last SITE command to the local Server FTP. Your SITE command is reissued without your having to retype it. Since most Server FTPs require that new site parameters be provided before each data transfer, the SNDS saves time if identical site parameters are to be used repeatedly.

Example

SNDS 
SITE vol(mvsts2)
SNDS
site vol(mvsts2) <SENT

STATUS

The STATUS command requests a status response from the local system.

Syntax Description

Defaults

If no parameter is given, the indicated local Server FTP sends status information relative to parameters, such as connection status.

If no data connection is active, the port is zero.

Usage Guidelines

The parameter argument is optional.

When the STATUS command is issued, the information is transferred over the control connection instead of the data connection.

Example

The Cisco IOS for S/390 Server FTP program implements some additional parameters on the STATUS command. Use a HELP STAT Client FTP2 command to find additional parameters.

STATUS
Connected to: UNIX
--- STATUS ---
-- FTP Parameters --
Remote DT Host, Port 138.42,32,160, 0 
Local  DT Host, Port 138.42.224.15, 0
Type I N   Stru F   Mode B   Recall 5   Server is passive
-- END --
-- Control --
User COLMBIA   Acct Accs E0000200   Unit SYSALLDA   Host 138.42.224.15
-- End Control --
-- Path Data --
Volser ICSPK2   Rlse
-- End Path Data --
-- Transfer Information --
Data transfer not in progress   Data bytes sent 6480
Disk tracks read 1   Network bytes sent 6726   Elapsed time 00.00.01
Bytes/Second 4256
-- END --
211 <End of Status>

STRUCT

The STRUCT (file structure) command provides information on file structure to the remote Server FTP.

Syntax Description

Usage Guidelines

One argument is required on the STRUCT command. The argument sets the file structure.

Example

STRUCT F 

SUNIQUE

Use the SUNIQUE (STORE UNIQUE) command to store transferred files by unique file names on a remote machine. SUNIQUE is a toggle command (meaning it is either off or on). When used, the target server automatically ensures that files received in FTP transfer are stored under a unique name.

Syntax Description

This command has no arguments or keywords.

Default

Default for SUNIQUE is OFF.

Usage Guidelines

The target remote FTP server must support the STOU (store unique) command.

If SUNIQUE is not used, FTP2 will issue the standard STOR command. If file names are not unique, files in the target directory could be overwritten.

TYPE

The TYPE command tells a Server FTP the data type to use.

Syntax Description

Defaults

A is the default argument for the TYPE command.

ASCII is the default file type.

For both ASCII and EBCDIC file types, vertical format control N is the default.

Usage Guidelines

One of the four arguments (I, L byte_size, A, or E) is required.

If local type (L) is set, the integer byte size argument must also be set.

If ASCII (A) or EBCDIC (E) type is set, one of the three vertical format control arguments, N, T, or C can also can be set.

Example

Restart Support

If a file transfer is interrupted, it can be restarted. However, restart support requires that mode B be specified.

Using Restart

Use the SITE REST(XXXXX) Client FTP2 command to tell a Cisco IOS for S/390 FTP Server how often to send a restart marker. Send a restart marker after the sending of the record that exceeds or equals XXXXX number of bytes (varying between 1 and 500,000). Send the SITE command only to the RETR side of a data transfer. Other FTP Servers may initiate sending restart markers in a different way from Cisco IOS for S/390.

A 110 message is written once per output block if a restart marker is sent somewhere in the data written for the block.

For example, suppose during a data transfer this restart mark message is sent:

110 MARK 0100030212C0 = 010003020FA0 

You can restart the transfer at this point by sending the first number to the RETR side and the second number to the STOR. If you receive this restart mark message during an aborted data transfer, you can restart the transfer at these disk locations with these Client FTP2 REST commands:

Send this command to the RETR side:

Send this command to the STOR side:

Cisco IOS for S/390 supports restart markers (set at default value of every 32767 data bytes) if these conditions exist:

• TYPE I

• MODE B

Client FTP2 File Transfer Examples

This section provides some examples of file transfers.

Example Notes

These notes clarify the Client FTP2 examples included in this section:

• Issue FTP2 when under TSO to enter Client FTP2.

• Text can be entered in uppercase or lowercase. Some host systems support a mixture of lowercase and uppercase letters, while other host systems use uppercase for most functions. All commands entered are translated to uppercase before being sent to the servers. The data associated with a command is sent to its appropriate FTP server without case translation. The Cisco IOS for S/390 FTP server translates user IDs, passwords, data set names, and similar items to uppercase before the commands associated with them are executed.

• An OPEN command attempts to connect to a remote host. FTP2 attempts to log the user on to the remote host once the connection is made.

The examples are shown in the following sections.

PUT Example

In the following example FTP2 session, the PUT command transfers a file from local MVS host to remote host unix.

Setting local directory to the TSO profile prefix
250 "USER1." is current prefix
Cisco IOS for S/390 Release 2.0 Client FTP2 - Enter command or'?'
open unix
220 unix FTP server (SunOS 4.1) ready.
Enter name (UNIX:user1sys1): user_name
331 Enter PASS command
Password: passwd
230 User user1 loggged in.
put cntl(iefbr14) jclbr14 
-Data set open with attributes:
Type A N  Tabs 8  Stru F  Mode S  Path USER1.CNTL(IEFBR14)
Volser COLPK1  Unit SYSALLDA  Dsorg PO  Recfm FB  Lrecl 80  Blksize 3120  Rlse
150 ASCII data connection for jclbr14 (138.42.224.15,4120).
-Transfer complete
820 bytes sent in 0.26 seconds (3153 bytes/s) 
Path USER1.CNTL(IEFBR14)
User USER1 Data bytes sent 800
Disk tracks read 1
226 ASCII Transfer complete.
end 

• FTP2 makes a connection to the MVS local host. The connection is established automatically unless the NOA invocation option was specified.

User USER1SYS1 is logged on to the local host using information gathered in the TSO address space. FTP2 discovered that user USER1SYS1 has a different TSO profile prefix than his user ID. FTP2 set the local working directory to his current TSO profile prefix of USER1.

• The open unix command establishes a connection to the remote UNIX host. FTP2 automatically prompts for a user ID, password, and optionally, an account.

• At the "Enter name..." entry, FTP2 prompts you for the correct user ID on UNIX.

User USER1SYS1 can press Enter and get a default user ID of user1sys1, or can override the user ID and enter a different user ID.

A user ID of user1 was entered. A password is prompted for and entered in a non-display field. The user ID and password are valid and user user1 logs on to the remote host.

• The put cntl(iefbr14) jclbr14 command tells FTP to transfer the file USER1.CNTL(IEFBR14) from the local host (MVS) and create or overwrite file jclbr14 on the remote host, unix.

The 226 message indicates a successful transfer occurred. Any 400 or 500 level message indicates a data transfer failure.

• The end command ends the FTP2 session.

GET Example

In the following example FTP2 session, the GET command transfers a file from remote host unix to the local MVS host.

Cisco IOS for S/390 Rn Client FTP2 - Enter command or '?'
open unix 
220 unix FTP server (SunOS 4.1) ready. 
Enter name (UNIX:user1): user_name
331 Enter PASS command
Password: passwd
230 User user1 logged in.
get jclbr14 cntl(newbr14)
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Recall 5
Path USER1.CNTL(NEWBR14)
Volser COLPK1   Unit SYSALLDA   Dsorg PO   Recfm FB   Lrecl 80
Blksize 3120   Space 31 15 Tracks Rlse
150 ASCII data connection for jclbr14 (138.42.224.15,4121) (810 bytes).
-Transfer complete
 820 bytes received in 10.1 seconds (80 bytes/s)
Path USER1.CNTL(NEWBR14)   User USER1   Data bytes received 800
Disk tracks written 1
226 ASCII Transfer complete.
end 

FTP2 Restart Marker Example

When transferring large amounts of data across many channels, the transfer sometimes does not complete successfully. The following example FTP2 session shows how to use the rest (restart) command to imbed marks to tell Server FTP where to restart a file transfer. Read REST.

Cisco IOS for S/390 Rn - Usr FTP2 - Enter command or '?'
open mvs 
220 MVS.HQ.COMPANY.COM -- FTP2 Server, Enter command or HELP
Enter name (MVS:columbia): user1
331 Enter PASS command
Password: passwd
230 LOGGED IN - HOST 138.42.128.13 USER user1
binary 
mode b 
site rest(100000) 
remsite space(3 1) cyl recfm(vb) blk(6650) lrecl(133) 
put 'scm.p016572.T01TCP' psr16572.job 
-Dataset open with attributes:
Type I N   Stru F   Mode B   Path SCM.P016572.T01TCP
Volser HAGCAT   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 133
Blksize 6650 Rlse Bytes/Restart 100000
150-Dataset open with attributes:
Type I N   Stru F   Mode B   Recall 5   Path USER1.PSR16572.JOB
Volser HAGCAT   Unit SYSALLDA   Dsort PS   Recfm VBV   Lrecl 133
Blksize 6650 Space 3 1 Cyl Rlse
-Transfer complete
 1656466 bytes sent in 13.5 seconds (122338 bytes/s)
Path SCM.P016472.T01TCP   User COLMBIA   Data bytes sent 1619142
Disk tracks read 41   Restart markers sent 16
110    MARK    000204010a      = 00020414F9
110    MARK    0005010214      = 0005021075
110    MARK    000704031E      = 0007060BF1
110    MARK    000A010428      = 000A040771
110    MARK    000C040532      = 000D0202ED
110    MARK    000F01063C      = 000F0517DE
110    MARK    0011040746      = 001203135E
110    MARK    0014010850      = 0015010EDA
110    MARK    001604095A      = 0017050A56
110    MARK    0019010A64      = 001A0305D6
110    MARK    001B040B6E      = 001D010152
110    MARK    001D010C78      = 001F041643
110    MARK    0020040D82      = 00220211C3
110    MARK    0020040D82      = 00220211C3
110    MARK    0023010E8C      = 0024060D3F
110    MARK    0025040F96      = 00270408BB
110    MARK    00280110A0      = 002A02043B
226-Transfer complete
1656466 bytes received in 13.6 seconds (120998 bytes/s)
Path USER1.PSR16572.JOB  User USER1   Data bytes received 1619142
Disk tracks written 43              Records folded 12551
Restart markers received 16

If the data transfer fails you can restart the data transfer using any of the "110 MARK ..." restart markers.

Read REST for more details.

Transfer to an MVS Internal Reader

The following example FTP2 session shows an FTP2 file transfer from a file on host unix to an MVS internal reader on the local MVS host.

Cisco IOS for S/390Rn Client FTP2 - Enter command or '?' 
open unix 
220 unix FTP server (SunOS 4.1) ready.
Enter name (UNIX:user1): user_name
331 Enter PASS command
Password: passwd
230 User user1 logged in.
site submit 
get jclbr14 anyname 
-Data set open with attributes:
Type A N   Tabs 8   Stru F   Mode S   Intrdr   Recfm FB   Lrecl 80   Blksize 20000
150 ASCII data connection for jclbr14   (138.42.224.15,4122) (810 bytes).
-Transfer complete 
 820 bytes received in 4.17 seconds (196 bytes/s)   User USER1
Data bytes received 800
226 ASCII Transfer complete.
end 

• The open unix command establishes a connection to the remote host unix. The user logs on to the remote host.

• The command site submit is a command to the local MVS host directing the next data transfer to the MVS internal reader for execution. SITE commands are relevant to an MVS host where Cisco IOS for S/390 is running.

• The command get jclbr14 anyname commands FTP2 to transfer file jclbr14 from remote host unix. Due to the previous SITE command, the file is transferred to an MVS internal reader on the local MVS host. The file name (anyname) for the local host is ignored because no data set is being created or updated.

• The end command ends the FTP2 session.

Managing Directories on UNIX-based Systems

The following example FTP2 session shows the directory manipulation commands for the remote host.

Cisco IOS for S/390 Rn Client FTP2 - Enter command or '?' 
open unix 
220 unix FTP2 server (SunOS 4.1) ready.
Enter name (UNIX:user1): user_name
331 Enter PASS command
Password: passwd
230 User user1 logged in. 
pwd 
257 "/home/unix/user1" is current directory.  
mkdir tempdir 
A:257 MKD command successful. 
pwd 
257 "/home/unix/user1" is current directory. 
cwd tempdir 
250 CWD command successful. 
pwd 
257 "/home/unix/user1/tempdir" is current directory.
put cntl(iefbr14) jclbr14 
-Data set open with attributes: 
Type A N   Tabs 8   Stru F   Mode S   Path USER1.CNTL(IEFBR14) 
Volser COLPK1   Unit SYSALLDA   Dsorg PO   Recfm FB   Lrecl  80
Blksize 3120   Rlse
150 ASCII data connection for jclbr14 (138.42.224.15,4123). 
-Transfer complete
 820 bytes sent in 0.54 seconds (1518 bytes/s) Path USER1.CNTL(IEFBR14)
User USER1   Data bytes sent 800
Disk tracks read 1
226 ASCII Transfer complete.
dir 
-Data set open with attributes: 
Type A N   Tabs 8   Stru F   Mode S   Recall 5
Path USER1.FTP.TMP.T2334662
Volser ICSUSR   Unit SYSALLDA   Dsorg PS   Recfm FB   Lrecl 80  
Blksize 6160   Space
5 3 Tracks Rlse
150 ASCII data connection for /bin/ls (138.42.224.15,4124) (0 bytes).
226 ASCII Transfer complete.
-Transfer complete
 72 bytes received in 9.29 seconds (7 bytse/s)
Path USER1.FTP.TMP.T2334662   User COLMBIA   Data bytes received 68
Disk tracks written 1   Records padded 2
total 1
-rw-rw-rw-  1 user1   dvlp   810 Jan 26 10:19 jclbr14
IDC0550I ENTRY (A) USER1.FTP.TMP.T2334662 DELETED
dele jclbr14 
250 DELE command successful. 
cdup 
250 CWD command successful. 
pwd 
257 "/home/unix/user1" is current directory. 
rmd tempdir 
250 RMD command successful.
pwd 
257 "/home/unix/user1" is current directory.
end 

• User1 connects and logs on to the local host and remote host unix.

• The pwd command asks the server to print the current directory on the remote host.

• The command mkdir tempdir asks the remote ftp host server to create a directory called tempdir.

• By creating a directory in the third section of this example, you have not changed your current working directory on the remote host.

The command cwd tempdir changes the remote host directory from /home/unix/user1 to /home/unix/user1/tempdir. The pwd command confirms the directory.

• The put cntl(iefbr14) jclbr14 command copies a file from the local MVS host to the remote host as file jclbr14.

• The dir command finds all the current members on the current remote host directory. The only file in the directory is jclbr14.

• The dele jclbr14 command removes the file from the remote host.

• The command cdup changes the remote host directory from its current directory /home/unix/user1/tempdir to its parent directory home/unix/user1. The pwd command reflects this change.

• The command rmd tempdir asks the remote host server to remove directory /home/unix/user1/tempdir.

• The end command terminates the FTP2 session.

Transferring and Using a File in a Single JCL Job

Transferring a file in one job step and using that file in another job step can run into a file allocation problem, wherein the file transfer fails in the FTP2 job step. This is usually because the file has been allocated to the batch job and the Cisco IOS for S/390 base product cannot allocate the file for a data transfer. The FTP2 and FTP client programs do not perform file transfers in their own address space; the FTP2 and FTP clients direct the Cisco IOS for S/390 base product to perform file transfers.

Examples

The following sample JCL does a file transfer, performs an IDCAMS ALTER NEWNAME, and uses the file in the final job step (the data set MVS.P25206.DATA is created in the first job step, renamed to the file MVS.NEWNAME.DATA in the second step, and the file name MVS.NEWNAME.DATA is used in the last step):

//MVSA JOB (TSO00...99),'FTP2 BATCH',MSGCLASS=X,NOTIFY=MVS,CLASS=A
//* 
//*  JOB TO TRANSFER A FILE AND THEN USE IT IN A LATER JOBSTEP 
//* 
//*  STEP TO DO THE FTP TRANSFER
//*  
//FTP1        EXEC PGM=IKJEFT01,REGION=4000K 
//SYSTSIN     DD *,DCB=BLKSIZE=80 
    FTP2 / APP=ACCES  TEST NETRC
//STEPLIB     DD DCB=BLKSIZE=32000,
//                DISP=SHR,DSN=T01TCP.LINK 
//SYSTSPRT    DD SYSOUT=X 
//SYSPRINT    DD SYSOUT=*,DCB=BLKSIZE=133
//SYSPUT      DD SYSOUT=*,DCB=BLKSIZE=133
//SYSVLT      DD SYSOUT=*,DCB=BLKSIZE=133
//NETRC       DD DISP=SHR,DSN=MVS.FTP.NETRC
//SYSGET      DD *,DCB=BLKSIZE=80
open unix
get temp 'mvs.p25206.data'
END
/*
//* 
//*   STEP TO PERFORM AN IDCAMS ALTER NEWNAME 
//* 
//STEP2       EXEC PGM=IDCAMS 
//SYSPRINT    DD SYSOUT=* 
//SYSIN       DD * 
 ALTER 'MVS.P25206.DATA'                NEWNAME('MVS.NEWNAME.DATA') - 
  CAT(CATALOG.TSO.VESA001) 
//* 
//*   THIS STEP PRINTS THE FILE ON THE SYSUT1 DD CARD 
//* 
//STEP3       EXEC PGM=IEBGENER 
//SYSUT1      DD DISP=SHR,DSN=MVS.NEWNAME.DATA 
//SYSUT2      DD SYSOUT=X,COPIES=1,DCB=*.SYSUT1 
//SYSPRINT    DD   SYSOUT=* 
//SYSIN       DD   DUMMY 

The following sample JCL uses a file, performs an IDCAMS ALTER NEWNAME, and does a file transfer in the final job step (the file MVS.OLDNAME.DATA is used in the first jobstep, renamed to the file MVS.TRANSFER.DATA in the second jobstep, and the file MVS.TRANSFER.DATA is transferred in the last jobstep):

//MVSB JOB (TSO00,,,99),'FTP2 BATCH',MSGCLASS=X,NOTIFY=MVS,CLASS=A
//* 
//* JOB TO TRANSFER A FILE AND USE IT IN A LATER JOBSTEP
//* 
//*   THIS STEP PRINTS THE FILE ON THE SYSUT1 DD CARD 
//* 
//STEP1     EXEC PGM=IEBGENER 
//SYSUT1    DD DISP=SHR,DSN=MVS.OLDNAME.DATA 
//SYSUT2    DD SYSOUT=X,COPIES=1,DCB=*.SYSUT1 
//SYSPRINT  DD    SYSOUT=* 
//SYSIN     DD    DUMMY 
//* 
//*   STEP TO PERFORM AN IDCAMS ALTER NEWNAME 
//* 
//STEP2     EXEC PGM=IDCAMS 
//SYSPRINT  DD SYSOUT=* 
//SYSIN     DD * 
 ALTER 'MVS.OLDNAME.DATA'                NEWNAME('MVS.TRANSFER.DATA') - 
  CAT(CATALOG.TSO.VESA001) 
//* 
//*  STEP TO DO THE FTP TRANSFER 
//* 
//FTP3      EXEC PGM=IKJEFT01,REGION=4000K 
//SYSTSIN   DD *,DCB=BLKSIZE=80 
FTP2 / APP=ACCES  TEST NETRC
//STEPLIB   DD DCB=BLKSIZE=32000, 
//          DISP=SHR,DSN=T01TCP.LOAD 
//SYSTSPRT  DD SYSOUT=X 
//SYSPRINT  DD SYSOUT=*,DCB=BLKSIZE=133
//SYSPUT    DD SYSOUT=*,DCB=BLKSIZE=133
//SYSVLT    DD SYSOUT=*,DCB=BLKSIZE=133
//NETRC     DD DISP=SHR,DSN=MVS.FTP.NETRC
//SYSGET    DD *,DCB=BLKSIZE=80
open unix
put 'mvs.transfer.data' temp
END
/*