Configuring an Application Performance Analyzer Connection

Before any Application Performance Analyzer information can be viewed, a connection must be established between Application Performance Analyzer on CICS Explorer and the Application Performance Analyzer Listener started task on z/OS. Details about the system connection must be provided to z/OS, including its location, and authentication requirements.

At least one connection credential must be defined before a system connection can be configured.

If an Application Performance Analyzer Connection has not been configured, or an additional connection is to be setup, perform these steps:

  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, the connection details are displayed as in the example below. If not, the fields are blank.
Figure 1. Configure Application Performance Analyzer Connection
Configure Application Performance Analyzer Connection
  1. Click New, complete the preferences below, and select the connection credential to use.
    Preference Description
    Type The type of the connection. Select "APA Connection".
    Name The local name is used to identify the connection.
    Host Name z/OS server address where the Application Performance Analyzer server communications reside.
    Port Number Port where the z/OS Application Performance Analyzer server is listening
    Credentials The credential to use for the connection. Includes user ID and password (optional). Click the menu twistie to see all defined credentials.
    SSL Connection Use SSL (secure) connection Default: unchecked
    Keystore File Keystore file used for SSL connection, should point to the directory and file that has the keystore.
    Keystore Pass phrase Pass phrase for keystore - should have the password used to access the keystore file.
  1. Click Apply to save the configuration or Cancel to cancel the process and close the Preferences view without saving the new connection.
  2. Click Connect. When Connect is clicked, CICS Explorer attempts to connect to the configured system. The Sign on dialog is displayed and you must enter your password before the CICS Explorer will connect to Application Performance Analyzer. 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.