Application Performance Analyzer for z/OS, Version 11.1, Customization Guide

Installing the plugin version for CICS Explorer

Software and hardware requirements

Verify that the following software and hardware requirements are met:

Downloading and installing Application Performance Analyzer Plug-in for Eclipse V11.1.0.0 into CICS Explorer 1.0

The Application Performance Analyzer Plug-in for Eclipse V11.1.0.0 can be downloaded from the Problem Determination Tools Plug-in website. The download file is called APA_plugin_vrmf.zip.

The following steps are required in order to install the Application Performance Analyzer Plug-in for Eclipse V11.1.0.0 into CICS® Explorer 1.0.

  1. Extract all the contents of APA_plugin_vrmf.zip to any writable directory of your choice, for example, C:/APA.
  2. Start CICS Explorer.
  3. In the action bar click "Help" -> "Software Updates".
  4. The "Software Updates and Add-ons" pop-up is displayed. Click the "Available Software" tab.
  5. Click "Add Site" to point CICS Explorer to the downloaded Application Performance Analyzer plug-in.
  6. A third pop-up is displayed. Click "Archive".
  7. In the "Repository Archive" pop-up, navigate to the location where you extracted the files from APA_plugin_vrmf.zip. Select the apa_gui_plugin.zip file and click "Open".
  8. In the "Add Site" popup, click "OK".
  9. The "Available Software" tab displays the plug-in. Click the "APA/GUI Plugin Platform" top level checkbox, verify that all checkboxes in the tree are selected, and click "Install...".
  10. The Install window is displayed. Make sure there is a check mark by each item and click "Next". (The "Finish" button might be enabled rather than "Next".)
  11. Accept the terms of the license agreements, and click "Finish".
  12. You will be prompted to restart CICS Explorer. Click "Yes".

Downloading and installing Application Performance Analyzer Plug-in for Eclipse V11.1.0.0 into CICS Explorer 1.1 or later

The Application Performance Analyzer Plug-in for Eclipse V11.1.0.0 can be downloaded from the Problem Determination Tools Plug-in website. The download file is called APA_plugin_vrmf.zip.

The following steps are required in order to install the Application Performance Analyzer Plug-in for Eclipse V11.1.0.0 into CICS Explorer 1.1 or later:.

  1. Extract all the contents of APA_plugin_vrmf.zip to any writable directory of your choice, for example, C:/APA.
  2. Start CICS Explorer 1.1 or later.
  3. In the action bar click "Help" -> "Install New Software".
  4. The "Install" pop-up appears. Make sure the "Group items by category" is un-checked (default is checked).
  5. Click "Add" to point CICS Explorer to the downloaded Application Performance Analyzer plug-in.
  6. A third pop-up is displayed. Click "Archive".
  7. In the "Repository Archive" pop-up, navigate to the location where you extracted the files from APA_plugin_vrmf.zip. Select the apa_gui_plugin.zip file and click "Open".
  8. In the "Add Repository" popup, click "OK".
  9. The "Install" window/ "Available Software" displays the plug-in. Click the "APA/GUI Plugin Platform" top level checkbox, verify that all checkboxes in the tree are selected, and click "Next".
  10. Accept the terms of the license agreements, and click "Finish".
  11. You will be prompted to restart CICS Explorer. Click "Yes".

Application Performance Analyzer for z/OS GUI communications requirements

The z/OS Application Performance Analyzer Listener 11.1.x started task must be installed and active on z/OS. Refer to Customizing Application Performance Analyzer Listener for more information.

Getting Started Using Application Performance Analyzer for z/OS Plug-in for Eclipse V11.1.0.0

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

  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 ftp host address of the machine.
    Host Port
    The port where the z/OS Application Performance Analyzer server is listening. This is the ftp 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.

You can find more information on how to use the Application Performance Analyzer Plug-in for Eclipse V11.1.0.0 in the help of CICS Explorer. In the action bar, click "Help" and scroll down and select "Help Contents". Expand the section called "Application Performance Analyzer for z/OS client for Eclipse".

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.

Follow your company's security policy when determining whether to save the password on your workstation.




Rate this page

[ Top of Page | Previous Page | Next Page | Contents | Index ]