Primary commands for report navigation

The following is a list of the commands used to navigate reports and explanations for using them:

WIN

You can use the WIN (WINdow) command to display a selection list of open reports in a pop-up panel. From that panel, you can make a selection to jump to the selected report. The main Observation Session List panel will be the report listed at the top of the selection list, so you can use WIN to quickly get back to this panel rather than navigating through all your open reports.

JUMP (PF4)

You can use the JUMP command, or the PF4 key, to jump to another open report. Each time you issue a JUMP request, Application Performance Analyzer will skip to the next open report, on a rotating basis.

END (PF3)

Use the END command, or the PF3 key, to return to the display of the previous report — the one from which the current report was launched. The END command will close (delete) the current report. Entering END from the Report Selection Menu will exit the Application Performance Analyzer Performance Reporting Facility.

CANCEL (PF12)

Use the CANCEL command, or the PF12 key, to return to the display of the previous report — the one from which the current report was launched. The CANCEL command will leave the current report open. You can return to it any time using the JUMP or WIN command. Entering CANCEL from the Report Selection Menu will exit the Application Performance Analyzer Performance Reporting Facility.

REPORT CODE

Once you have selected an observation session, you can enter a three character report code, even if you are not in the report menu. You can be viewing one report, and can immediately open an additional report by typing its code.

UP (PF7)

Use the UP command, or press PF7, to scroll vertically towards the top of the report.

DOWN (PF8)

Use the DOWN command, or press PF8, to scroll vertically towards the bottom of the report.

LEFT (PF10)

Use the LEFT command, or press PF10, to scroll the report horizontally to the left.

RIGHT (PF11)

Use the RIGHT command, or press PF11, to scroll the report horizontally to the right.

FIND

The FIND command (abbreviation “F” can be used) finds all occurrences of a text string. It is similar to an ISPF FIND command, but does not have all the features. All occurrences of the target text string will be highlighted. To remove the highlights, enter the RESET command.

RESET

The RESET command removes the highlights set by the FIND command.

PREF

Use this to set preferences for General Display Settings. Put a slash “/” beside an option to select it. The available options are:

Action bar visible on panels
Use 3270 graphic characters
Show command line in pop-up panels
Show long descriptions on multiple lines
Suppress use of special +/- character

CONNECT

Only available on the R02 Observation Session List screen. If your installation has multiple Application Performance Analyzer instances running, you can change which one your ISPF session is connected to by typing CONNECT followed by the Application Performance Analyzer identifier. You can use the VER command to view which Application Performance Analyzer instances are currently running on the same z/OS® image that you are logged in to.

VERSION

Only available on the R02 Observation Session List screen. Type VERSION or VER and a list of the Application Performance Analyzer started tasks are displayed, along with their version numbers, and when they were started.

You can enter SELECT on the command line of the Started Tasks List panel to connect to a different Application Performance Analyzer started task. The format is ‘SELECT stcid’, where stcid is the value from the ‘Stc Id’ column of the started task you want to connect to. When a valid, active started task is selected, the R02 Observation Session List automatically connects to the specified started task when you exit the VERSION dialog. "S" and "SEL" are aliases of SELECT.

SELECT

Available on the R02 Observation Session List screen. This command starts Performance Analysis Reporting for the selected request number. Specify a request number of a valid request after the command, such as SELECT 1234. The selected request number must contain an observation file. "S" and "SEL" are aliases of SELECT.

SETUP

Use the SETUP command to filter information and select options for reports. This command is useful for reducing the size of reports by removing information that is not critical. The options available using the SETUP command vary by report. You can get more details from the report descriptions.

HIDE

Only available on the R02 Observation Session List screen. Type HIDE to remove the list of commonly used Application Performance Analyzer primary commands from view.

SHOW

Only available on the R02 Observation Session List screen. Type SHOW to redisplay the list of commonly used Application Performance Analyzer primary commands at the top of the screen.

IMPORT

Only available in the R02 Observation Session List screen. Use the IMPORT command to load a sample file, or an exported hierarchy of observations. This can be a native Application Performance Analyzer sample file, or one that has been previously exported using the EXP or EXPH command and is in TSO XMIT format. The IMPORT command displays a pop-up window to enter the fully qualified data set name of the native sample file or TSO XMIT file, and to indicate if that original file is to be deleted after import. A new request description can be optionally entered.

During IMPORT, Application Performance Analyzer creates a new observation, assigns a new request number, and, if provided on the IMPORT pop-up window, adds the description to the imported observation. If a hierarchy is being imported, new request numbers are provided for all observations in the hierarchy. If indicated, Application Performance Analyzer will delete the original files. The date and time of the imported request is set to the current date and time, and the expiry date is recalculated based on the rules of the importing system.