Configuring a CICS system connection

You must establish a connection between CICS Explorer® and your CICS® systems before you can view any information. You must provide details about the system connection, its location, and its authentication requirements.

Before you begin

If you are connecting to a CICS TS version 3 system, you must connect to a WUI server by using the CICSPlex® SM Data Interface read-only connection.

If you are connecting to a CICS version 4 or later system, you can connect to a WUI server by using the CICSPlex SM Data Interface read-only connection. Alternatively, if you want update capability, you can use the CICS management client interface (CMCI) connection. If you are using the CMCI connection, the CICS system must be set up to use CMCI. For more information, see Setting up access for CICS Explorer in the CICS TS 5.1 Information Center.
Note: The CICS Explorer does not support the use of SSL client certificates with CMCI connections.

If you are connecting to a CICS TS for VSE/ESA 1.1.1 system, you can use the CICS management client interface (CMCI) read-only connection.

If CICS Explorer is not configured, or you want to add a connection, run these steps:

Procedure

  1. On the workbench menu bar, click Window > Manage Connections. The Host Connections view is displayed.

    If your connections are preconfigured, you see the connections under the categories in the view. If not, the categories are empty. The following example screen shows the Host Connections view with one connection in each category type. Each connection is associated with a credential, except for the z/OS® FTP connection. The credential is shown in brackets after the connection name.

    Host Connections view that shows one connection in each category type. Each connection is associated with a credential, except for the z/OS FTP connection. The credential is shown in brackets after the connection name.

  2. Select the required connection category under CICS System Management, and click Add. The Add Connection window opens. The following example shows the Add CMCI Connection window.
    A screen capture that shows the Add CICS Management interface Connection window.
  3. Type the TCP/IP host name of your server in the Host name field. As you type, the characters up to the end of the first qualifier are inserted in the Name field. If your host name is myserver.example.ibm.com then the name would display as myserver.
  4. Enter the port number. As you type, the port number is also appended to the Name field, so the name is displayed as something like myserver:20332.
  5. Optional: You can specify a different name by replacing the name in the Name field.
  6. If the host connection is configured for SSL, select the Secure connection (SSL) check box.
  7. 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 CICS 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.