Application Performance Analyzer for z/OS, Version 11.1, User's Guide

Context menu

The Observations List context menu is accessed by a right-mouse button click on an observation request. The Observations List context menu provides Observation (row) level actions that include:

The Download Reports menu item is disabled if an Observation sample file does not exist, for example, the Observation is not in a completed status. The Delete Reports menu item is only enabled if reports have been downloaded for the selected Observation.

Download reports

msblue
Download Reports provides functionality to retrieve the Application Performance Analyzer reports for an Observation. Download Reports triggers formatting of the observation reports on z/OS then download the reports to the local repository. The reports are then available for viewing in the Observation Reports List View. A reports icon Reports icon is displayed on the observation request row where the reports download was issued.

Once the reports have been downloaded, they are available until deleted via the Delete Reports action.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Sticky notes

Sticky notes icon
Sticky Notes provides a tool to write, save, print and delete notes for a specific Observation Request. A sticky note icon is displayed on the observation request row where the note was saved. The sticky note can also be launched by double-clicking the observation row. This is a GUI only feature, and not available in the Application Performance Analyzer ISPF interface.

Sub

newwiz
Sub issues an immediate submission of an Observation request. A new Observation request is automatically submitted to Application Performance Analyzer on z/OS, using the same parameters as the original request. No data entry dialog is presented for this action.

Use Sub instead of New when none of the original request parameters need to be changed.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

New

newwiz
New Observation provides the functionality to create and submit a new observation to Application Performance Analyzer. Because the New Observation request is issued from the context menu instead of the toolbar, the New Observation dialog is pre-populated with values from the selected observation request. All other functionality remains the same.

Refer to New observation and New threshold observation in Toolbar for details.

Figure 42. New Observation (context menu) dialog
fig34
Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Trigger

Trigger creates a new request to be triggered when this request starts. This can only be used on a request that is in SCHED status.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Modify

Modify provides the functionality to edit the parameters of an observation request that has not yet started. A Modify Observation dialog is displayed, pre-populated with values from the selected observation. All other functionality (edits, fields, etc) remains the same as for a New Observation.

Refer to New observation and New threshold observation in Toolbar for details.

Figure 43. Modify Observation dialog
fig35
Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Export

export observation icon
Export saves the observation request to a TSO dataset in XMIT format where it can be imported to other started tasks using the Import Observation action. An information dialog is displayed showing the exported dataset name once completed.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Keep

Keep updates the observation request so that the request is kept until it is manually deleted. This overrides the auto delete feature.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Delete

deledit
Delete removes the observation request. The Observations List automatically refreshes with the deleted observation removed from the list. Additionally any open reports for this request are also removed.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Cancel

Cancel cancels an active observation request.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Mapping Repository

maprepos
The Mapping Repository launches the Source Program Mapping Repository editor dialog. The editor provides an interface to manage files/directories of source program listings used for the source program mapping display feature of individual reports.

For further details, please refer to the Mapping Repository description in Context menu for details.

Download XML

XML icon
Download XML downloads reports for the observation request in XML format. The User is prompted for the location to save the XML file. Report categories, reports and report options are based on the Report download options preferences settings.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Download PDF

PDF icon
Download PDF downloads reports for the observation request in PDF format. The User is prompted for the location to save the PDF file. Report categories, reports and report options are based on the Report download options preferences settings.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Delete reports

deletere
Delete Reports deletes the observation request reports from the local repository. The reports icon displayed on the Observations List row is removed and any open reports for this request are also removed from the display. Reports can be re-downloaded by selecting Download Reports from the context menu.

Tag

tagged
The Tag action is used to flag an Observation(s) used for the Generate Variance Reports and Generate CICS MASS Reports features. The Tag icon is displayed on the Observations List row that was tagged and is removed if the Tag action is selected for an Observation that was already tagged or if the Clear All Tags action is selected, where all tags will be cleared. Up to 20 Observations that include a Sample DSN file can be tagged.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Clear all tags

blank
The Clear All Tags action removes the tag setting for all Observation(s) that are tagged. The Tag icon is removed for each tagged row.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Generate variance reports

msblue
Generate Variance Reports provides functionality to compare up to 20 observations, creating a V - Variance Reports series report. One or more observations must already be tagged and the Observation where the Generate Variance Reports is selected serves as the base.

When selected, this action triggers formatting of the V01 - Measurement Variance Summary report on z/OS and then downloads the report to the local repository. The report is then available for viewing in the Observation Reports List View. A reports icon msblue is displayed on the observation where this action was selected. Once the report is downloaded, it is available until deleted via the Delete Reports action.

If, in addition to the Variance Report, all the reports for the observation are to be viewed, the Download Reports action must be selected after the Generate Variance Report has completed.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.

Generate CICS MASS reports

msblue
Generate CICS MASS Reports provides functionality to report on the activity in up to 21 CICS regions (up to 20 tagged and one base), and creates an X - Multi Address Space series of reports. One or more observations that include a CICS Extractor must already be tagged and the Observation in which the Generate CICS MASS Reports is selected serves as the base.

When selected, this action triggers formatting of the Multi Address Space reports on z/OS and then downloads the reports to the local repository. The reports are then available for viewing in the Observation Reports List View. A reports icon msblue is displayed on the observation where this action was selected. Once the report is downloaded, it is available until deleted via the Delete Reports action.

If, in addition to the CICS MASS Reports, all the reports for the observation are to be viewed, the Download Reports action must be selected after the Generate CICS MASS Reports has completed.

Note:
This action is only available if the z/OS connection has been established and the remote repository is active.



Rate this page

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