Configuring a CICS Explorer system connection

Before you can view any information, you must establish a connection between CICS Explorer™ and your CICS® systems by providing details about the system connection, its location, and authentication requirements. By default, CICS Explorer attempts to connect using the SSL protocol. If the SSL connection is not successful, the connection will be re-attempted without SSL.

Before you begin

You must define at least one connection credential before you can configure a system connection. See the topic Defining connection credentials for further information.

Before proceeding, ensure that you have all your system connection details, that you have the correct level of authorization to connect to your system, and that you are connected to your company's network. If you are connecting to a CICS version 4 system and you want update capability, the CICS system must be set up to use the CICS management client interface (CMCI). See the topic Setting up the CICS management client interface in the CICS Transaction Server for z/OS® version 4 information center for instructions on how to do this.

If your system administrator has preconfigured CICS Explorer, you can view the details in the Connections Preferences view.

If CICS Explorer has not been configured, or you want to add an additional connection, perform these steps:

Procedure

  1. Click Window > Preferences from the workbench menu bar, and expand CICS Explorer in the Preferences view. Click Connections. The Connections Preferences view is displayed. If the connections are pre-configured, you see the connection details displayed as in the example below. If not, the fields are blank.
    Connections Preferences view.
  2. Click New.
  3. Fill in the fields with the details provided by your system administrator. The following table provides a description of the fields.
    Option Description
    Type The type of the connection. The values you can select are as follows:
    • CICSPlex SM Data Interface for read-only connection to a CICS version 3 or version 4 CICSPlex® SM WUI server.
    • CICS Management Interface for connection to a CICS version 4 CICSPlex SM WUI server or a single CICS region with update capability.
    Name The local name used to identify this connection. The name can be anything you choose and is used only to help you distinguish between different connections.
    Host name The TCP/IP host name of your CICSPlex SM WUI server or your stand-alone CICS region. For a WUI server, this is the value specified in the initialization parameter TCPIPHOSTNAME.
    Port number The port used to access the server. For a WUI server, this is the value specified in the TCPIPPORT attribute of the TCPIPSERVICE definition created when configuring the CICS management interface.
    Credentials Your credential for the system. Click the menu twisty to see all defined credentials.
  4. Click Apply to save the configuration or Cancel to cancel the process and close the Preferences view without saving the new connection.
  5. Click Connect.

What to do next

When Connect is clicked CICS Explorer attempts to connect to the system you have configured. The Signon dialog is displayed and you must enter your password before the CICS Explorer will connect to your CICSplex.

If the connection is successful, the connection name appears in the connection status bar in the lower right corner of the workbench window next to a green icon to indicate a non-SSL connection, or a padlock to indicate a SSL connection.

If the connection is not successful, a red icon is displayed in the connection status bar in the lower right corner of the workbench window next to the connection name. An error message is displayed at the top of the Connections Preferences view providing a reason for the failure. Check the values in the fields, correct any errors, and click Connect to test the corrections.

When the connection is successful, click OK or Cancel to close the Preferences view.