What's new in this release?
Version 12.1.0.2 adds further enhancements to APA:
- New preference added to the General Preferences page which allows the user to select the location of the APA reports repository.
- New preference added to the General Preferences page which allows the user to view all downloaded local STC repositories (both active and inactive).
- Bug fix to correct thread error launching 'updates available' dialog.
- Added SYSVIEW option for the C08 - CPU Referred Attribution report, which shows attribution back to system modules.
- New report added: B11 - WAS/CICS Calls
- New DB2 Explain (DB2X) extractor added.
- Websphere Application Server (WAS) measurements can now optionally include DB2 and CICS extractors for new observations.
The What's New topic in the Application Performance Analyzer help documentation describes
the new and changed items in more detail. To display the topic, click .
Version 12.1.0.2 also includes the APA CICS Explorer Connection Plug-in which utilizes the CICS Explorer connectivity framework across IBM Eclipse-based products.
The APA CICS Explorer Connection help documentation describes the functionality in more detail. To display the topic, click
Back to Contents
Plug-in Overview
APA Plug-in Overview
The Application Performance Analyzer Plug-in for Eclipse V12.1.0.2 provides the functionality to run the Application Performance Analyzer for z/OS GUI on Eclipse-based applications such as IBM CICS Explorer.
Version 12.1.0.2 includes all features included in all Application Performance Analyzer for z/OS GUI releases up to 12.1.0.2.
The Application Performance Analyzer plug-in 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.
When launched, APA automatically loads and displays the local repository of the Startup APA Started Task (STC).
If you wish to connect to the z/OS STC (remote repository), connect to APA and 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.
Back to Contents
System requirements and prerequisites
The following minimum hardware levels are required to run the Application Performance Analyzer Plug-in for Eclipse V12.1.0.2:
- CPU - Intel® Pentium® 4 or equivalent.
- RAM - 768 MB in addition to the operating system
requirements.
- Hard disk - 500 MB available space.
Back to Contents
One of the following levels of Windows operating system software is required to install Application Performance Analyzer Plug-in for Eclipse V12.1.0.2:
- 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 V12.1.0.2:
- IBM desktop products based on Eclipse 3.6 or later.
- Application Performance Analyzer for z/OS Version 12.1 or above.
Application Performance Analyzer for z/OS :
- The z/OS Application Performance Analyzer Listener 12.1.x started task must be installed and active on z/OS. Refer to Chapter 6 in the Application Performance Analyzer for z/OS Customization Guide for more information.
The Application Performance Analyzer Plug-in for Eclipse V12.1.0.2 is available in the following national languages:
Updating an existing installation of APA
If you already have APA V12.1.0.1 installed, follow the instructions for Installing Application Performance Analyzer Plug-in for Eclipse V12.1.0.2.
If you already have APA/GUI V11.1.0.4 or earlier installed you must do the following
prior to installing the APA V12.1.0.2:
- Uninstall APA/GUI
From the Help menu, click install New Software > click on "What is already installed" > select APA/GUI plug-in > click Uninstall
- Delete the APA/GUI Perspective
From the Window menu, click Preferences > Eclipse Platform > Perspectives >click on APA/GUI, click on the Delete button, then click on Apply.
Note: Any customized preferences for APA/GUI will be lost, downloaded APA repositories and reports will be carried forward to the new release.
Back to Contents
Installing Application Performance Analyzer Plug-in for Eclipse V12.1.0.2
The following steps are required in order to install Application Performance Analyzer Plug-in for Eclipse V12.1.0.2 :
- Extract all the contents of APA_plugin_12102.zip to any writable directory of your choice, for example, C:\APA.
- Start IBM Eclipse-based desktop product (eg. CICS Explorer).
- In the action bar click "Help" -> "Install New Software".
- The "Install" pop-up appears.
- Click "Add", a pop-up is displayed, then click "Archive".
- In the "Repository Archive" pop-up, navigate to the location where you extracted the files from APA_plugin_12102.zip. Select the unzipped folder and click "Open".
- In the "Add Repository" popup, click "OK".
- The "Install" window/ "Available Software" displays the plug-in. Click the "APA" top level checkbox, verify that all checkboxes in the tree are selected, and click "Next".
- Accept the terms of the license agreements, and click "Finish".
- You will be prompted to restart, click "Yes".
Back to
Contents
Getting Started Using Application Performance Analyzer Plug-in for Eclipse V12.1.0.2
Follow the steps below to startup the Application Performance Analyzer Plug-in for Eclipse V12.1.0.2.
- To access Application Performance Analyzer, click "Window" -> "Open perspective" -> "Other".
- Select "APA" and click "OK".
- Follow the instructions in the APA CICS Explorer Connection User Guide for details on how to configure credentials and connections for APA and how to connect to APA on z/OS.
- Once the connection is established, 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 preference that can be changed from the "Set as Default STC" context menu item of the STC List view.
- Application Performance Analyzer will then populate the Observations List.
You can find more information on how to use the Application Performance Analyzer Plug-in for Eclipse V12.1.0.2 in the help of CICS Explorer. In the action bar, click "Help", and scroll
down and select "Help Contents". Expand the section called "APA User Guide". For the APA CICS Explorer Connection plug-in, expand the section called "APA CICS Explorer Connection User Guide".
Back to
Contents
Security Considerations
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.
Back to Contents
Technical Support
This plug-in is available at no charge to all licensed users of IBM Application Performance Analyzer for z/OS V10, or later.
It is supplied under the standard terms and conditions of the IBM International Program License Agreement (IPLA)
and of the associated License Information and other documentation, and provides a defect correction entitlement
for those licensed users entitled to service for IBM Application Performance Analyzer for z/OS V10, or later.
Service is available for this plug-in for as long as the IBM Application Performance Analyzer for z/OS product with which the plug-in
is to be used is generally supported by IBM. In addition, IBM reserves the right to discontinue service on this plug-in when it is
withdrawn from marketing by IBM. Please reference "IBM Application Performance Analyzer for z/OS" as the entitled product when contacting
IBM and requesting support for this plug-in.
Back to
Contents