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
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:
- Click Window > Preferences from the workbench menu
bar, and click Connections. The Connections Preferences view
is displayed. If it has been pre configured, you see the connection
details displayed as in the example below. If not, the fields are
blank.
- Click New.
- 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. |
User ID |
Your authorized user ID for the system. |
- Click Apply to save the configuration or Cancel to
cancel the process and close the Preferences view without saving the
new connection.
- 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.