Adding servers

To add a new FTP or SFTP server definition, use the Add action provided in the FTP Servers table. This action is listed only if you are authorized to define new server definitions.

1. In the FTP Servers table, select Add from the Actions menu. The Add FTP Server page is displayed.
2. In the FTP server name field, enter the name of the server definition. It can contain up to 40 characters, including alphanumeric characters (A-Z, a-z, and 0-9), blanks, underscores (_), and hyphens (-). The name is required, must be unique, and is case sensitive. For example, DEST1 and Dest1 are two different server definitions.
3. In the Host field, enter the host name or IP address (IPv4 or IPv6) of the FTP or SFTP server on the system. It can contain up to 63 characters. The host name or IP address is required.
4. In the Path name field, enter the directory in which z/OSMF is to place the files on the system. It can contain up to 730 characters. The path name is required. The path name is not case sensitive; for example, /toibm/mvs and /TOIBM/MVS are the same path name. By default, the path is the root directory, which is represented by a forward slash (/).

   The path name is used by the Incident Log task only. It is ignored by other z/OSMF tasks.

5. In the Port number field, enter the port number of the FTP or SFTP server on the system. It can be an integer from 1 through 65535. The port number is optional. If you do not specify a port, the default FTP or SFTP server port defined for the installation is used.
6. Select Use anonymous user ID and password if you can use anonymous as the user ID when logging into the FTP or SFTP server. The anonymous user ID is used by the Incident Log task only. This value is ignored by other z/OSMF tasks.
7. In the Description field, enter a description of the FTP or SFTP server. For example, Use this FTP server for database problems. The description can contain up to 100 characters. The description is optional.
8. In the Transfer method field, select the method z/OSMF is to use when sending files to the FTP or SFTP server. Select one of the following options:
   • FTP. Select this option to send the files unencrypted using standard FTP. Then, in the FTP profile field, select the profile that specifies the FTP settings required to transfer files between the FTP server and FTP client.
   • SFTP. Select this option to send the files over an encrypted SSH transport. Then, complete the following steps:
     1. In the Client utility path field, enter the path to the SFTP client utility that z/OSMF will use when transferring files to the server. The path must be fully qualified and can contain a maximum of 1023 characters. The path must begin with a forward slash (/), and must end with the filename, excluding the suffix (file extension). The default path is /bin/sftp.
     2. In the FTP profile field, select the profile that specifies the SFTP settings required to transfer files between the SFTP server and SFTP client.
   • z/OS® Problem Documentation Upload Utility (PDUU). Select this option to split the files into smaller data sets that are compressed, optionally encrypted, and sent in parallel to an IBM® FTP site using multiple, simultaneous FTP sessions. PDUU does not support UNIX files; therefore, z/OSMF always sends UNIX files unencrypted using standard FTP.
     Then, complete the following steps:

     1. In the Work data set prefix field, enter the data set prefix for the utility to use for the work files it creates on the z/OSMF host system. It can contain up to 40 characters (including periods), and must comply with z/OS data set naming conventions. The data set prefix is optional. If you do not specify a prefix, z/OSMF automatically generates a prefix.
     2. In the Work data set size field, enter the size to use for the work files in megabytes (MB). The work data set size is required. The size must be a number between 1 and 9999 MB. The default size is 100 MB.
     3. In the Work data set data class field, enter the data class the utility is to use when allocating the work files. The work data set data class can contain up to eight characters including alphanumeric characters (A-Z, a-z, and 0-9) and special characters ($ # @). The first character of the data class must be an alphabetic or special character. The data class is optional.
     4. In the Work data set storage class field, enter the storage class the utility is to use when allocating the work files. The work data set storage class can contain up to eight characters including alphanumeric characters (A-Z, a-z, and 0-9) and special characters ($ # @). The first character of the work data set storage class must be an alphabetic or special character. The storage class is optional.
     5. In the Number of FTP sessions field, enter the number of parallel FTP sessions the utility can use when transmitting files. The number of FTP sessions is required. The value must be a number between 1 and 20 sessions. The default is three FTP sessions.
     6. In the FTP profile field, select the profile that specifies the FTP settings required to transfer files between the FTP server and FTP client.
9. Click OK to add the server definition.