Customizing Performance Profiles

You can also customize the reports that are part of the Performance Profile. You can control the level of detail in the report and the amount of information contained in the reports. To alter the makeup of the Performance Profile, type Y in the appropriate field on the Strobe- Produce a Performance Profile panel or the Strobe- Create an Auto Performance Profile panel.

• To modify the level of detail or the Performance Profile’s print characteristics, type Y next to Detail Reports.
• To suppress, condense, or expand reports, or show the location of wait, type Y next to Tailor Reports.

Modifying the Level of Detail

The Strobe- Detail for a Performance Profile panel enables you to compress and expand information in the Performance Profile.

Strobe- Detail for a Performance Profile Panel

Title

To specify the title that appears on the title line of the Performance Profile, type its text in this field. The title can be up to 40 characters long and can include commas, blanks, and other special characters. To include an apostrophe in the title, you must type it twice, as follows:

If you clear this field, Strobe uses the name of the measured program as the title.

Compress

To compress modules with identical initial characters into your own named pseudo-sections, specify the module names and the pseudo-section names in these fields. Each prefix can contain as many as eight characters, and each group name can contain as many as seven characters. (Strobe prefixes a period (.) to each group name.)

For example:

You can also use the wildcard character (*) to replace characters two through eight in the prefix.

For example:

To place modules with different prefixes into the same pseudo-section, specify them separately:

Detail

Strobe normally compresses the reporting of system modules (for example, IOCS modules, compiler library routines, CICS and IMS system modules) in the Program Usage by Procedure report. To override this compression, type the module names in these fields. An asterisk (*) in the last character position acts as a wildcard.

Sort Size

To specify the amount of virtual storage (in bytes) available to the system sort/merge program, type a value of 0 or from 12000 to 999999 in this field (default 999999). To give the sort/merge program access to all the available space in the region, omit this parameter. To instruct the sort/merge program to use its system default, type a value of 0.

Lines/Page

To specify the number of lines Strobe prints on each page of the Performance Profile, type a value between 45 and 80 in this field (defaults to the installation parameter or 60).

Other Parameters

To supply additional reporting information to Strobe, type other report parameters in this field. For example, the parameter NODSCS causes Strobe to suppress the Data Characteristics Supplement report. See Creating-performance-profiles-by-using-procedures for details about Reporter parameters.

Tailoring Reports

The Strobe- Tailor Reports panel enables you to alter some of the reports in the Performance Profile. You can change the Wait Time by Module report, the Program Usage by Procedure report, the DASD Usage by Cylinder report, the Transaction Usage by Control Section report, the Attribution reports, the Program Section Usage Summary report and the Time and Resource Demand Distribution reports. The exact appearance of the panel depends on the options available at your site.

Strobe - Tailor Reports Panel (Scrollable)

Wait Time by Module

The Wait Time by Module report does not normally show the location of wait within a module.

To show the location of wait in each module, type Y in the Show location of wait field.

Program Section Usage Summary

To include a report line for each inactive control section in the Program Section Usage Summary report, type Y in the Display inactive field. If you clear this field, Strobe displays only active control sections.

Program Usage by Procedure

To compress the Program Usage by Procedure report, specify the baseline percentage of CPU activity for a procedure codeblock in the Compress below field (default 0). Enter a value from 0 to 99.9 (do not exceed one decimal place). Strobe condenses all contiguous procedures that exhibit less than this percentage on a single line in the Program Usage by Procedure report. Enter whole percentages with or without a decimal point (for example, 2 or 2.0).

To suppress the report, type Y in the Suppress field.

DASD Usage by Cylinder

To compress the DASD Usage by Cylinder report, specify the baseline percentage of activity on a cylinder in the Compress below field (default 2). Enter a value from 0 to 99.9 (do not exceed one decimal place). Strobe condenses activity in all contiguous cylinders that exhibit less than this percentage on a single report line in the DASD Usage by Cylinder report. Enter whole percentages with or without a decimal point (for example, 2 or 2.0).

To suppress the report, type Y in the Suppress field.

Transaction Usage by Control Section

To compress the Transaction Usage by Control Section report, specify the baseline percentage of transaction usage in the Compress below field (default 0). Enter a value from 0 to 99.9 (do not exceed one decimal place). Strobe suppresses the section of the report for all transactions that exhibit less than this percentage of CPU usage. Enter the percentage with or without a decimal point (for example, 2 or 2.0).

To suppress the Transaction Usage by Control Section report, type Y in the Suppress field.

CICS Transaction Profile

To compress the CICS Transaction Profile reports, specify the baseline CPU time in seconds in the Compress below field (default 00.005). Enter a value from 0 to 99.999. Strobe suppresses the lines of the reports for all transactions that exhibit less than the specified amount of CPU time. Enter the value with or without a decimal point (for example, 2 or 2.0). If you do not have Strobe for CICS with the CICS Transaction Profile option, this field does not appear.

To suppress the CICS Transaction Profile reports, type Y in the Suppress field. The following reports are not produced:

• Transaction Summary
• Transaction Profile
• Region Level reports.

CICS Region Level

To compress the CICS Region Level reports, specify the baseline CPU time in seconds in the Compress below field (default 00.005). Enter a value from 0 to 99.999. Strobe suppresses the sections of the reports for all regions that exhibit less than the specified amount of CPU usage. Enter the value with or without a decimal point (for example, 2 or 2.0). If you do not have Strobe for CICS with the CICS Transaction Profile option, this field does not appear.

To suppress the CICS Region Level reports, type Y in the Suppress field.

MQSeries Calls

To compress the reporting of activity in WebSphere MQ calls, in the Compress below field specify the minimum percentage of samples in which Strobe detects an WebSphere MQ call at a given location in a module (default 0). Enter a value from 0 to 99.9 (do not exceed one decimal place). Strobe suppresses all WebSphere MQ calls that exhibit less than this percentage of activity, and these calls do not appear on the CPU Usage by Module by MQSeries Call and the Wait by Module by MQSeries Call reports. Enter the percentage with or without a decimal point (for example, 2 or 2.0).

Attribution Reports

To suppress all Attribution reports in which the total CPU or wait time percentage is less than a specified baseline percentage, type a value from 0 to 99.9 (do not exceed one decimal place) in the Compress below field. To suppress all Attribution reports, type Y in the Suppress all field.

You can also suppress Attribution reports for a specific type by typing Y in the appropriate Suppress reports field. The IEF option enables you to suppress CA Gen attribution reports.

If you specify a baseline percentage, you can also suppress the reports for a particular type of attribution, regardless of its execution percentage. You cannot combine the Suppress All option with either the baseline or the type-dependent suppression option.

Time and Resource Demand Distribution

To condense time spent in all MVS tasks into a single report line in the Time Distribution and Resource Demand Distribution reports, type Y in the Combine tasks field. If you clear this field, Strobe creates a separate line for each active MVS task.

To show all tasks, including those that show no activity, in the Time Distribution and Resource Demand Distribution reports, type Y in the Display all tasks field. If you clear this field, Strobe shows the six tasks that display the highest execution activity.

To show all DD statements, including those that show no activity, in the Time Distribution and Resource Demand Distribution reports, type Y in the Display all DDs field. If you clear this field, Strobe shows the 11 DD statements with the highest activity.

DDF Report Parameters

If your installation uses DDF, the DDF Report Parameters field appears on the panel. Type Y to go to the Strobe- DDF Filters and Thresholds panel to specify thresholds and filters to limit DDF report output.

Use Date and Time Format from Parmlib

The Strobe system programmer has specified one of the supported four-digit year formats and international time formats in the Strobe parameter data set. This format appears on certain Strobe/ISPF panels and Performance Profile reports. To use this format, type Y in this field. Specify this option if the Strobe parameter data set date and time formats have recently changed.

Specifying Output Parameters

Besides controlling the Performance Profile report contents, you can also specify a number of copies to be printed and whether files are created for iStrobe.

Printing Multiple Copies of the Profile

To print multiple copies of the Performance Profile when using background processing, type a value between 1 and 255 in Number of Copies for Background Reports (default 1).

Specifying Files for iStrobe

If you have installed iStrobe and want to use iStrobe to view the Performance Profile, type I in the Output Format field, and follow the instructions in Creating iStrobe Performance Profiles.

Saving the Performance Profile

To save a copy of the Performance Profile, type a data set name in the Data set Name field.

To specify a unit name and volume serial number for the copy of the Performance Profile, type them in the Unit and Volume fields.

Supplying Default Parameters

To specify a SYSIN data set containing Strobe report parameters, type its name in the SYSIN Data set field. The parameters you supply through Strobe override any parameters specified in this data set. If you type new Detail and Compress options, however, Strobe adds them to those supplied in the data set. This data set specification overrides any SYSIN data set named at system installation.