Software and hardware requirements
Verify that the following software and hardware requirements are
met:
- Verify that either Windows XP, Windows 7, Server 2003/2008
or Vista is installed. Only Windows platforms
are supported.
- Verify that you have installed CICS Explorer® (for Windows)
V1.0.0.5, or later.
- Verify that you have installed Application Performance Analyzer for z/OS® Version 11.1 or later.
- Verify that you have an Intel® Pentium® 4 CPU or equivalent.
- Verify that you have 768 MB RAM in addition to the operating system
requirements.
- Verify that you have 500 MB available hard disk space.
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.
- Extract all the contents of APA_plugin_vrmf.zip to
any writable directory of your choice, for example, C:/APA.
- Start CICS Explorer.
- In the action bar click "Help" -> "Software Updates".
- The "Software Updates and Add-ons" pop-up is displayed. Click
the "Available Software" tab.
- Click "Add Site" to point CICS
Explorer to the downloaded Application Performance Analyzer plug-in.
- A third pop-up is displayed. Click "Archive".
- 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".
- In the "Add Site" popup, click "OK".
- 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...".
- 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".)
- Accept the terms of the license agreements, and click "Finish".
- 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:.
- Extract all the contents of APA_plugin_vrmf.zip to
any writable directory of your choice, for example, C:/APA.
- Start CICS Explorer 1.1
or later.
- In the action bar click "Help" -> "Install New Software".
- The "Install" pop-up appears. Make sure the "Group items by category"
is un-checked (default is checked).
- Click "Add" to point CICS
Explorer to the downloaded Application Performance Analyzer plug-in.
- A third pop-up is displayed. Click "Archive".
- 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".
- In the "Add Repository" popup, click "OK".
- 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".
- Accept the terms of the license agreements, and click "Finish".
- 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.
- To access the Application Performance Analyzer for z/OS GUI,
click "Window" -> "Open perspective" -> "Other".
- Select "APA/GUI" and click "OK".
- 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.
- 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.
- 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.
[ Top of Page | Previous Page | Next Page | Contents | Index ]