Configuring a z/OS FTP system connection

You must have an FTP or z/OSMF connection to use the views in the z/OS perspective.

Before you begin

You must have at least one connection credential before you can connect to a system. A credential is a repository for a user ID and password combination. For more information, see Defining connection credentials.

Note: For z/OS® Explorer to successfully obtain the required spool files, the FTP.DATA configuration file for the Server must specify JESINTERFACELEVEL 2. For more information about the JESINTERFACELEVEL parameter, see your System z/OS documentation.

Procedure

  1. Click Window > Manage Connections from the workbench menu bar. The Host Connections view is displayed.

    If your connections are preconfigured, you see the connections listed under the categories in the view. If not, the categories are empty. The following example screen shows the Host Connections view in thez/OS Explorer. One connection is defined in each category type. Each connection is associated with a credential, with the exception of the z/OSMF connection. The credential is shown in brackets after the connection name.

    A screen capture of the Host Connections view with one connection defined in each category type. Each connection is associated with a credential, with the exception of the z/OSMF connection. The credential is shown in parenthesis after the connection name.

  2. In the Connections section select the z/OS FTP category and click Add. The Add System z - FTP Connection window opens.
    A screen capture showing the Add System z - FTP Connection window.
  3. In the Host name field enter the FTP host name of your server . As you type, the characters up to the end of the first qualifier are inserted in the Name field. So if your host name is myserver.example.ibm.com then the name would display as myserver.
  4. Optional: You can specify a different name by overtyping the name in the Name field.
  5. Optional: Select the local and remote character sets to be used during file transfer. You may also need to set the transfer mode in the file properties window. If you do not set these values correctly, files could be corrupted during transfer. For more information, see Changing z/OS Unix file and directory permissions.
  6. Optional: You can choose to associate a credential with the connection at this time. Right-click the connection name and hover over Set Credentials to show the credentials available. Click the credential you want to use for the connection.
  7. Complete the other fields as appropriate for your organization
  8. Click Save and Close to save the configuration without connecting or click Save and Connect to save the configuration and connect immediately. If you click Save and Connect, you are presented with the Signon window, where you must select an existing credential to use with this connection, or define a new credential.

Results

The connection and associated credential are displayed in the Host Connections view.

What to do next

When you connect, the z/OS Explorer tries to connect to the system that you configured.

If the connection is successful, the connection name is displayed in the workbench window next to a green icon.

If the connection is not successful, the connection name is displayed in workbench window next to a red icon. An error message is displayed in the workbench status bar providing a reason for the failure. Check the values in the fields, correct any errors, and try to connect again.