Configuring a z/OSMF system connection

The z/OS Management Facility (z/OSMF) is a product for z/OS that provides support for a modern, web browser -based management console for z/OS, and extends the functionality of z/OS® Explorer.

Before you begin

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

About this task

You must have a z/OSMF connection to use the features of z/OSMF.

When you define a z/OSMF system, z/OS Explorer attempts to create an FTP connection at the same time. z/OS Explorer then chooses the connection that is most suitable for the task you are performing.

Procedure

  1. Click Window > Manage Connections from the menu bar for the workbench. 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 z/OS Explorer. Two z/OS FTP connections and one z/OSMF connection are defined. Each z/OS FTP connection is associated with a credential, which is shown in parentheses after the connection name.

    Host Connections view showing connections in the z/OS connection category.

  2. In the Connections section, select the z/OSMF connection type and click Add. The Add Connection window is displayed.
    Add z/OSMF Connection window.
  3. In the Host name field, enter the host name of your z/OSMF server. As you type, the characters up to the end of the first qualifier are inserted in the Name field. For example, for the host name myserver.example.ibm.com, the name displayed is myserver.
  4. Enter the port number. As you type, the port number is appended to the Name field. For example, the name displayed might become myserver:20332.
  5. Optional: You can specify a different name by overtyping the name in the Name field.
  6. By default, the z/OSMF connection also sets up an FTP connection on port 21. If you previously defined a different FTP connection, select it from the FTP Connection list.
  7. Complete the other fields as appropriate for your organization, and click OK.
  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.

To connect to the system, either right-click the connection name and click Connect on the menu, or select the connection name and click Connect. If the connection is not already associated with a credential, you can choose an existing credential or create one at this time.

When you connect, 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.