README for IBM Application Performance Analyzer Plug-in for Eclipse V11.1.0.1

Version 11.1.0.1 adds further enhancements to APA/GUI:

• Version 11.1.0.0 Japanese and Korean translations.

The Application Performance Analyzer Plug-in for Eclipse V11.1.0.1 provides the functionality to run the Application Performance Analyzer for z/OS GUI on Eclipse-based applications such as IBM CICS Explorer. Version 11.1.0.1 includes all features included in all Application Performance Analyzer for z/OS GUI releases up to 11.1.0.1.

The Application Performance Analyzer for z/OS GUI platform has built-in support for both local and remote (z/OS) repositories. The local repository is populated and refreshed automatically with the most recent transaction data, with the exception of the observation reports. Reports are downloaded on-request by selecting 'download reports' from the context menu of the Observation List or clicking "Download Reports" in the Reports View.

The initial install connects to the remote repository, while subsequent startup's automatically load and display the local repository of the Startup APA STC. If you wish to connect to the z/OS STC (remote repository), click "Connect APA" and after login, the remote repository will be downloaded to the Application Performance Analyzer for z/OS GUI.

The target audience for this document is for an experienced Application Performance Analyzer user. The purpose of this document is to provide details needed to setup and run the Application Performance Analyzer for z/OS GUI.

The following minimum hardware levels are required to run the CICS Explorer and are therefore applicable to Application Performance Analyzer Plug-in for Eclipse V11.1.0.1:

• CPU - Intel® Pentium® 4 or equivalent.
• RAM - 768 MB in addition to the operating system requirements.
• Hard disk - 500 MB available space.

One of the following levels of Windows operating system software is required to install the CICS Explorer and is therefore applicable to Application Performance Analyzer Plug-in for Eclipse V11.1.0.1:

• Microsoft® Windows® XP 32-bit
• Microsoft Windows Vista 32-bit
• Microsoft Windows Server 2003 32-bit
• Microsoft Windows Server 2008 32-bit
• Microsoft Windows 7 32-bit

The following levels of software required to install the Application Performance Analyzer Plug-in for Eclipse V11.1.0.1:

• CICS Explorer (for Windows) V1.0.0.5, or later
• Application Performance Analyzer for z/OS Version 11.1 or above.

The Application Performance Analyzer Plug-in V11.1.0.1 is available in the following national languages:

• English
• Japanese
• Korean

Back to Contents

Follow the steps below to startup the Application Performance Analyzer Plug-in for Eclipse V11.1.0.1.

1. To access the Application Performance Analyzer for z/OS GUI, click "Window" -> "Open perspective" -> "Other".



2. Select "APA/GUI" and click "OK".



3. A Logon dialog is displayed where the Host Address, Host Port, TSO userid and password must be entered to connect to z/OS. Contact your system administrator for this information if you do not have it.
   • Host Address :
     The z/OS server where the Application Performance Analyzer for z/OS GUI communications (listener) is installed. This is the host address of the machine.
   • Host Port :
     The port where the z/OS Application Performance Analyzer server is listening. This is the port number the listener is configured to use.
   • TSO Id :
     The logon TSO ID.
   • TSO Password :
     The password for the TSO ID.
   
   
   The address, port and TSO ID are saved as a Network Connection Preference the first time they are entered. If any are changed in a subsequent login, they are not saved as a preference, but kept only for the connection session. The Network Connection Preferences page includes the settings to change and save these preferences.
   
   The connection settings group includes a checkbox where the address and port information can be hidden from display for future logon sessions.
   
   The Logon dialog also includes an option to save the password. If checked, the password is stored so that future connections to z/OS are done automatically using the TSO user ID and password preferences.



4. The Select STC dialog is displayed in which a default startup APA Started Task (STC) must be selected. A list of active APA Started Tasks (STC's) is displayed. The default STC is the started task which will be selected at the startup of Application Performance Analyzer.
   
   The Default STC is displayed for the first successful login only, then saved as a Network Connection Preference that can be changed from either the Network Connection Preferences dialog or from the "Set as Default STC" context menu item of the STC List view.



5. Once a successful connection to z/OS has been established, the Application Performance Analyzer for z/OS GUI automatically populates with the Observations List of the remote repository Default APA STC.

As part of the logon process for the Application Performance Analyzer for z/OS GUI, there is an option to save your password on the workstation. If you select this option, the password will be encrypted before it is saved. Please be aware that while your password cannot be visually determined, it may be compromised by applying various computer algorithms.