Specifying an FTP cloud

One of the cloud types that is supported is the File Transfer Protocol (FTP) server. You can define a connection between Cloud Connector and an FTP cloud, and assign a name to the cloud where you want to save data.

When specifying an FTP server, please keep the following requirements in mind:
  • The FTP server must support passive FTP.
  • The z/OS FTP servers are not supported at this time.

When you type the "C" line command in the CMD column on the Cloud Server Display screen, a window displays asking you to indicate which type of cloud connection you want to create. To create a connection to an FTP cloud, type "2" in the Cloud Server Create window. The following screen displays:

Figure 1. File Transfer Protocol (FTP) Server Definition
CUZ$PRMC V1R1    --------- Cloud Server Display --------- 2016/07/13  13:35:12 
Option  ===>                                                  Scroll ===> PAGE 
                                                                               
Line Commands: C - Create E - Edit  D - Delete                                 
                                                                               
                                                     ROW 1 OF 6          >     
------------------------------------------------------------------------------ 
+----------------- File Transfer Protocol Server Definition -----------------+ 
|                                                                            | 
| Cld Type  FTP           (CLS,FTP,HCP,SFT,S3)                               |
| Cld Name                (Cloud Name used to Match Filter Criteria)         |
| User Id                                                                    |
| Password                                                                   |
| IP Addr                                                                    |
|                                                                            |
| Directory                                                                  |
|                                                                            |
|                                                                            |
|                                                                            |
| Opt Parms                                                                  |
|                                                                            |
|                                                                            |
|                                                                            |
|                                                                            | 
|                                                             PF12: Cancel   |
+----------------------------------------------------------------------------+

The fields on this window are described below.

Cld Type
The type of cloud connection to be created. In this case, the value is FTP for File Transfer Protocol.
Cld Name
The name that Cloud Connector will use to identify the cloud where you want to save data. Type one to eight characters for the name of this cloud. You can assign a different cloud name for the same cloud storage device if you are saving data to a different directory on that cloud or are using different credentials (User ID and Password) to access the cloud.
User ID or Userid
The User ID is the server ID that is required for signing into this cloud. The User ID can be up to 64 characters in length.
Password
The password associated with the User ID that allows access to this cloud. The password can be up to 64 characters in length.
IP Addr
The Internet Protocol Address used to connect to the cloud. The IP Address can be up to 128 characters in length.
Directory or Path
(Optional) The name and path of the directory where the data written to the cloud will be saved. The directory information can be up to 256 characters in length. Leave this field blank if you want to store data in the root folder. The directory designates the top level folder that will hold all of the Cloud Connector data. For example, if you specify "Testdata/" in the Directory field, the data will be sent to the "Testdata/" directory. This is useful to keep Cloud Connector data separate from other data you have stored in that particular cloud.
Opt Parms
(Optional) Use this field to specify additional parameters to help connect to the cloud server. You can also specify parameters to alter some of the Cloud Connector defaults to suit your environment.
Table 1. List of optional parameters for this cloud server definition
Optional parameter Description
PORT Identifies the port by which the product attempts to connect to the cloud server. Valid values are 1 - 65535. The default is 80.
CONNRETRY Consists of a two-part value:
  • The number of times the product will attempt to reconnect if the socket connection is dropped. Valid values are 1 - 999. The default is 5.
  • The number of seconds to wait between connection attempts. Valid values are 1 - 999. The default is 30.
COMPRESSION or COMP Indicates whether to use zEnterprise Data Compression (zEDC) to compress data. The default is NO or N.

If either YES or Y is specified, Cloud Connector will attempt to use zEDC to compress the data when transferring to the cloud.

Note: For more information on zEDC, refer to http://www.redbooks.ibm.com/redbooks/pdfs/sg248259.pdf
For example, consider the following entry in the "Opt Parms" field:
PORT(8080),CONNRETRY(5,30),COMPRESSION(YES)
In this example, Cloud Connector will try to connect to the cloud server using port 8080 instead of the default port of 80. On failed connections, Cloud Connector will attempt to connect again to the cloud server 5 times, waiting 30 seconds between each attempt. Compression through zEDC will be used when transferring data to the cloud.

An example of a completed FTP Server Definition is shown below. The values listed on this screen are not valid, but are provided as an example of the type of values that are expected for an FTP server.

Figure 2. Example of FTP Server Definition
CUZ$PRMC V1R1    --------- Cloud Server Display --------- 2016/07/13  13:35:12 
Option  ===>                                                  Scroll ===> PAGE 
                                                                               
Line Commands: C - Create E - Edit  D - Delete                                 
                                                                               
                                                     ROW 1 OF 6          >     
------------------------------------------------------------------------------ 
+----------------- File Transfer Protocol Server Definition -----------------+ 
|                                                                            | 
| Cld Type  FTP           (CLS,FTP,HCP,SFT,S3)                               |
| Cld Name  FTPEXAMP      (Cloud Name used to Match Filter Criteria)         |
| User Id   JoeSmo1                                                          |
| Password  M0reSpc                                                          |
| IP Addr   ftp.hostname.com                                                 |
|                                                                            |
| Directory Testdata/                                                        |
|                                                                            |
|                                                                            |
|                                                                            |
| Opt Parms PORT(8080),CONNRETRY(5,30),COMPRESSION(Y)                        |
|                                                                            |
|                                                                            |
|                                                                            |
|                                                                            | 
|                                                             PF12: Cancel   |
+----------------------------------------------------------------------------+