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:
- 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
- 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. |
- Click Apply to save the configuration or Cancel to
cancel the process and close the Preferences view without saving the
new connection.
- 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.