PROXy subcommand—Execute FTP subcommand on secondary control connections

Purpose

Use the PROXy subcommand to execute an FTP subcommand on secondary control connections. PROXy enables the FTP client to connect simultaneously to two remote FTP servers and then to establish a data connection between the two servers for the purpose of transferring files between those servers.

Format

Parameters

subcommand

The name of any FTP subcommands except those listed in the first note in Usage. The first PROXy subcommand should be Open, which establishes the secondary server connection.

The following subcommands behave differently when prefaced by the PROXy subcommand:

Open establishes the secondary server connection.
CLose closes the secondary server connection.
Get and MGet transfer files from the host on the primary connection to the host on the secondary connection.
PUt, MPut, and APpend transfer files from the host on the secondary connection to the host on the primary connection.

Examples

The following example shows a proxy open to establish connection to a secondary server.

 Command:
proxy open 9.67.113.57 6321
 Connecting to:  9.67.113.57 port: 6321.
 220-FTPDJG1 IBM FTP CS V1R4 at MVS164, 13:06:23 on 2003-01-14.
 220 Connection will not timeout.
 NAME (9.67.113.57:USER33): user34
 >>>USER user34
 331 Send password please.
 PASSWORD:
 >>>PASS
 230 USER34 is logged on.  Working directory is "USER34.".

The following example shows the commands for a proxy between IPv4 nodes:

PASV to the secondary server
PORT to the primary server
RETR to the primary server
STOR to the secondary server

Two 250 replies are received by the client, one from each server.

 Command:
proxy  m1 mx
 >>>PASV
 227 Entering Passive Mode (9,67,113,57,5,121)
 >>>PORT 9,67,113,57,5,121
 200 Port request OK.
 >>>RETR m1
 125 Sending data set /u/user33/mpp1/m1
 >>>STOR mx
 125 Storing data set USER34.MX
 250 Transfer completed successfully.
 250 Transfer completed successfully.
 Command:

The following shows a proxy open to establish connection to a secondary server with an IPv6 address:

Command:
    proxy open local167v6                         
   Connecting to: Local167v6 2001:0DB8:c2d4::9:67:115:12 port: 21.   
   220-Welcome to my test system.                          
   220-You are logged on from 2001:0DB8:c2d4::9:67:115:13         
   220 Connection will not timeout.                         
Command:
   user user2                                     
   >>> USER user2                                            
   331 Send password please.                                 
   PASSWORD:                           
                                                              
   >>> PASS                                                  
   230 USER2 is logged on.  Working directory is "/".

This example shows the commands for a proxy PUt between IPv6 nodes:

EPSV to the secondary server
EPRT to the primary server
STOR to the primary server
RETR to the secondary server

As in the first example, two 250 replies are received by the client.

Command:                                                           
proxy put bob testfile                                               
Load module transfer does not support load module rename            
>>> EPSV                                                            
229 Entering Extended Passive Mode (|||1027|)                       
>>> EPRT |2|2001:0DB8:c2d4::9:67:115:12|1027|                            
200 EPRT request OK                                                 
>>> STOR testfile                                                   
125 Storing data set /tmp/myTest/testfile                           
>>> RETR bob                                                        
125 Sending data set /tmp/myTest/bob                                
250 Transfer completed successfully.                                
250 Transfer completed successfully.                                
Command:

Usage

The following subcommands are not valid proxy subcommands:
- DEBug
- DUMP
- DELImit
- GLob
- LANGuage
- LCd
- LMkdir
- LOCSIte
- LOCSTat
- LPwd
- PROMpt
- QUIt
- REStart
- SENDPort
- SENDSite
- SRestart
- SUnique
- TSO
- Verbose
To receive help from a server on a secondary control connection, enter PROXy HElp SERVER.
Data transfer in PROXy mode can be restricted if the server is set up to reject PORT and EPRT commands with certain parameters. See the z/OS Communications Server: IP Configuration Guide for more details.
If an open subcommand is entered as a proxy subcommand by the client and the session is currently protected by a security mechanism (for example, TLS), then the subcommand is rejected with the following message:
```
Proxy open is not supported with security mechanisms 
```
If the connection to one server is IPv4 and the connection to the other is IPv6, proxy transfers might not be possible. The two servers must have the ability to connect to each other as well as to the client. A z/OS® FTP server cannot be the primary server in a proxy transfer unless the connection from the client to each of the servers is of the same protocol.
Data transfer in PROXy mode can be restricted if the server is set up to reject the redirection of the passive (PASV) data connection using PASSIVEDATACONN NOREDIRECT. See the z/OS Communications Server: IP Configuration Reference for more details.