Configuring a system connection

Before you can view any information, you must establish a connection between the CICS® IA plug-in and your CICS system by providing details about the DB2® location, settings. You must also enter your authentication requirements, user IDs and passwords in the Credentials view.

What to do next

The CICS IA plug-in Collector places details about interactions between CICS programs and resources in a set of DB2 tables. To allow the client to access these tables, you require a user ID and password that connects to the location of the DB2 database.

A screen shot of the CICS IA plug-in Preferences window that shows the Connections information, for the DB2 location which includes the Host Name (server address), TCP/IP Port Number and Database name. Authentication information that includes user ID and Password. DB2 Settings has a field to enter the Schema if required. A Connection button, Restore Defaults button and Apply button.
To create and save a connection:
  1. Open the Connections window using Window>Preferences, expand CICS Explorer and select Connections.
  2. Select your Connection Type from the menu.
  3. Enter the name you want to use for this connection set up.
  4. Enter the Host name, Port number. By default, DB2 on z/OS® listens for connections on port 448.
  5. Select your relevant credentials form the Credentials list, see Defining connection credentials for more information.
  6. Enter the Database name. If you do not know the database name, run the job suffixed with MSTR and look in the joblog information for the details required to complete the CICS IA plug-in connection information, shown in the table below.
    • For example, for DB27 look in the job DG27MSTR joblog for the details before the message #DG27 DSNYASCP 'START DB2' NORMAL COMPLETION.
  7. Click Apply, you are prompted to enter your password and you have the option to save your password.
  8. Click Connect to test the connection.
    • The dialog box on the bottom of the main CICS IA plug-in perspective displays the reason for a connection failure or that the connection details are valid:

      Connection failed information
      Connection OK information

  9. If you want to create and save another connection you must click New first and give the new connection a unique name in the Name: field, and work through the previous steps.
Connections Joblog information Joblog information
Database name LOCATION DSN810P2
  LU GBIBMIYA.IYCRZDB8
  GERICLU NONE
Server address DOMAIN dsn810p2.plex2.hursley.ibm.com
Use port TCPPORT 48100
  RESPORT 58102