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

New observation

newwiz
New Observation provides the functionality to create and submit a new observation to Application Performance Analyzer. A dialog is displayed where the details of the new observation must be provided.

The New Observation dialog is initially structured with seven tabs in which detailed request specification information can be entered. Each tab name is preceded by a symbol indicating if data has been entered to the tab. The symbol is displayed in green (green light) if data has been entered and is error free. A yellow or red light is displayed if there are warnings or errors in the data. The yellow warning lights may be suppressed by selecting the ‘Suppress warnings on input fields' checkbox in the General Preferences dialog. Refer to Entering an observation request for details of the individual fields and edits.

Figure 24. New Observation dialog
fig21

If a dash ("-") is entered in the job name field (Job Information tab), a DB2-specific or an IMS Multiple Address Space observation is created. The New Observation dialog is restructured with only three tabs including the Job Information (with limited fields), Options and Subsystems, where the DB2 radio button fields are activated by default. The IMS radio button is also enabled, where, if selected, IMS Multiple Address Space parameters are entered.

Figure 25. New Observation (DB2-specific or IMS Multiple Address Space) dialog
fig22

The Preview button can be clicked at any time to view the request parameters as they are being built. Once the required data has been entered and green light(s) are displayed, the request is valid and ready to be submitted. Once the Submit button is clicked to submit the request, the Observations List automatically displays the new observation on the list.

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

Job Information tab

The Job Information tab includes job-related parameters for the new observation request. If the started task is part of a sysplex, a System dropdown listing the images in the sysplex is displayed. Otherwise, the dropdown is hidden. An entry field colored grey cannot be edited.

Figure 26. Job Information tab
fig23

Refer to Panel 1 - Job Information and Panel 6 - Sysplex for details of the individual fields and edits.

Options tab

The Options tab is used to enter extended measurement options (Data Extractors), and also to specify additional load libraries to be searched for external symbol information. Click the Directories radio button to enter additional HFS Directories. Both the load libraries and directories are validated real-time on the z/OS server.

Figure 27. Options tab
fig24
Figure 28. Options tab
fig24b

Refer to Panel 2 - Options for details of the individual fields and edits.

Multi Steps tab

The Multi Steps tab is used to specify that multiple job steps are to be measured. Up to 20 steps can be measured, using the same specification rules described for single step measurements entered in the Job Information tab.

Figure 29. Multi Steps tab
fig25

Refer to Panel 3 input fields for details of the individual fields and edits.

Active Jobs tab

The Active Jobs tab is used to select active jobs from a list. A Prefix can be entered to limit the jobs listed. If you enter a Pattern in the Job name/Pattern field from the Job Information tab, this is entered as the Prefix in the Active Jobs tab. The z/OS server is accessed real-time to return the list of active jobs that are displayed in the Active Jobs List section. All selected jobs are displayed in the Selected Jobs List section. Up to 20 jobs or the system configuration value can be selected.

Figure 30. Active Jobs tab
fig26

Refer to Panel 4 - Active Jobs for details of the individual fields and edits.

Subsystems tab

The Subsystems tab is used to specify information about the measurement of a CICS region, IMS selection parameters, DB2 parameters, or DDF selection criteria. Specify the CICS transaction codes for which CICS measurement information is to be recorded. Click on the IMS radio button for IMS measurement parameters. A transaction, program name, and user ID to limit the measurement information can be entered. Click on the DDF radio button for DDF measurement criteria which includes Correlation Id, End User Id and Workstation Id. Nulls are allowed (checkbox) and any of the DDF entry fields can be prefixed or suffixed with an "*". "%" is also allowed. DB2 and IMS Multiple Address Space fields are only enabled if a dash ("-") is entered in the job name field (Job Information tab). Application Performance Analyzer will display different fields on the Subsystems tab, depending on the radio button selected.

Figure 31. Subsystems tab - CICS option
fig27
Figure 32. Subsystems tab - IMS option
fig28
Figure 33. Subsystems tab - DDF option
fig28a
Figure 34. Subsystems tab - DB2 option
fig29
Figure 35. Subsystems tab - IMS Multiple Address Space option
fig30b

Enter the DB2® Subsystem name or IMSPLEX Group Name, and the IMS Transaction that is to be measured, and then press the "Get IMS Active Jobs" button to display the list of IMS MPP regions that are eligible to process the transaction. Select the IMS MPP regions that Application Performance Analyzer is to measure from this list.

Refer to Panel 5 - Subsystems for details of the individual fields and edits.

Schedule tab

The Schedule tab is used to generate a schedule for repetitions of future measurements. A maximum of 105 future scheduled measurement entries is allowed.

Click the calendar button to select a date/time or enter the value directly. Enter the Repeat and After fields, then click Add to Schedule to add the date(s). The entry(s) are added to the Measurement Schedule. Click the checkbox to select or unselect one or many entries or click Select All to select all or Unselect All to deselect all the entries.

Figure 36. Schedule tab
fig30

Refer to Panel 7 - Schedule for details of the individual fields and edits.

Sched Options tab

The Sched Options tab includes additional scheduling options in which the available fields depend on if the Measure active job field is checked and whether or not a future schedule has been entered on the Schedule tab.

Figure 37. Sched Options tab
fig31

Refer to Panel 8 - Sched Options for details of the individual fields and edits.




Rate this page

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