Adding profiles

To add a new FTP, SFTP, or PDUU-HTTPS profile, use the Add action provided in the FTP or PDUU Profiles table. This action is listed only if you are authorized to define new profiles.

Procedure

In the FTP or PDUU Profiles table, select Add from the Actions menu. The Add FTP Profile page is displayed.
In the Profile name field, enter the name of the profile. 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, FIRE1 and Fire1 are two different profiles.
In the Profile type field, select FTP if the profile is for an FTP server or SFTP if the profile is for an SFTP server.
If the profile type is FTP, complete the following steps:
1. To make this profile the default FTP profile, select Make this profile the default FTP profile.
2. Complete at least one of the following steps:
  1. Select Specify the firewall or proxy server settings, and then complete the following steps:
    1. In the Firewall host field, enter the host name or IP address (IPv4 or IPv6) of the firewall or proxy server at your enterprise. It can contain up to 63 characters. The firewall host is required.
    2. In the Firewall user ID field, enter the user ID required to authenticate with the firewall or proxy server. It can contain up to 40 characters. The firewall user ID is optional.
    3. In the Firewall port field, enter the port number of the firewall or proxy server. The port number must be an integer from 1 through 65535. The port number is optional. If you do not specify a port, the default firewall port defined for the installation is used.
    4. In the Firewall commands field, enter the commands required to transfer data across the firewall or proxy server. Specify the commands in the order required by the firewall or proxy server. The firewall commands are required. This field can contain up to 10 lines with up to 80 characters on each line.
  2. Select Use an FTP.DATA file, and enter the name of the file. A z/OS® data set or a UNIX file name is required. When specifying the name, adhere to z/OS data set and UNIX file naming conventions. Ensure that the file exists on the z/OS system where the FTP client runs.
  3. Select Use a TCPIP.DATA file, and enter the name of the file. A z/OS data set or a UNIX file name is required. When specifying the name, adhere to z/OS data set and UNIX file naming conventions. Ensure that the file exists on the z/OS system where the FTP client runs.
If the profile type is SFTP, complete the following steps:
1. To make this profile the default SFTP profile, select Make this profile the default SFTP profile.
2. In the SSH proxy command field, enter the proxy command for z/OSMF to use when connecting to an SFTP server. This field is displayed when the profile type is SFTP. If displayed, the proxy command is required and can contain a maximum of 500 characters.
  When transferring files, z/OSMF adds the specified proxy command to the SFTP jobs it generates, as follows:
```
-oProxyCommand="proxy-command"
```
  where proxy-command is a placeholder for the command you entered. For example, if you enter the following proxy command:
```
ssh systemAB.xyz.1234.56789.a.pok.ibm.com exec /u/case/nc %h %p
```
  z/OSMF will add the following statement to the generated JCL:
```
-oProxyCommand="ssh systemAB.xyz.1234.56789.a.pok.ibm.com exec /u/case/nc %h %p"
```
  If the resulting JCL statement exceeds 80 characters, z/OSMF locates blanks within the proxy command and splits the command into multiple lines. For example, if you enter the following proxy command:
```
ssh systemAB.xyz.1234.56789.abcdefg.pok.ibm.com exec /u/case/nc %h %p
```
  The resulting JCL statement would contain 86 characters, which is not allowed.
```
----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
-oProxyCommand="ssh systemAB.xyz.1234.56789.abcdefg.pok.ibm.com exec /u/case/nc %h %p"
```
  Therefore, z/OSMF uses the blanks to split the command into multiple lines and adds them to the SFTP jobs, as follows:
```
----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
-oProxyCommand="ssh systemAB.xyz.1234.56789.abcdefg.pok.ibm.com exec /u/case/nc 
%h %p"
```
  If z/OSMF cannot add lines to the SFTP job that contain 80 or fewer characters, a JCL error occurs. In which case, you must break the proxy command into separate parts -- separated by blanks -- so that z/OSMF can generate valid JCL.
If the profile type is PDUU-HTTPS, complete the following steps:
Note: You have the option to select Specify the firewall or proxy server settings.
1. In the Firewall host field, enter the host name or IP address (IPv4 or IPv6) of the firewall or proxy server at your enterprise. It can contain up to 63 characters. The firewall host is required.
2. In the Firewall user ID field, enter the user ID required to authenticate with the firewall or proxy server. It can contain up to 40 characters. The firewall user ID is optional.
3. In the Firewall port field, enter the port number of the firewall or proxy server. The port number must be an integer from 1 through 65535. The port number is optional. If you do not specify a port, the default firewall port defined for the installation is used.
4. In the Firewall commands field, enter the commands required to transfer data across the firewall or proxy server. Specify the commands in the order required by the firewall or proxy server. The firewall commands are required. This field can contain up to 4 lines with up to 80 characters on each line.
Click OK to add the profile.