Show TOC

Variant DefinitionsLocate this document in the navigation structure

Use

You use this function to define a variant that specifies the measurement to specific criteria.

A measurement variant defines how a program is measured. You can execute a measurement using either personal or default variants delivered by SAP without having to branch to the variant maintenance.

If you want to adapt the measurement results to your needs, then you can either create or adapt measurement variants.

Features

The Variant screen contains the following tabs:

Duration/Type

  • You can set the maximum size of the trace files in kilobytes and the maximum runtime in seconds.

    If the file size of the execution time is exceeded during the measurement, then the measurement is canceled. The generated trace file then only contains the measurement values that were determined until the stop time.

    The maximum duration period (assuming there is anough space in the file system) is around 4293 seconds.

  • In the Aggregation screen area, you can select one of the following:

    • None - With the setting No Aggregation the measurement data is recorded in detail. This type of measurement enables a detailed runtime analysis when using all the hit lists and the call hierarchy.

      The call hierarchy records all Measurable Components. It can also serve as a trace for these components.

    • For Each Call Point - For all calls in the same position in the source code a single entry is written to the measurement data file. The entry aggregates the runtimes of all calls.

  • In Options screen area, you can set the following indicators:

    • Measuring RFC and Update Calls

      If you select this checkbox, you trigger runtime measurements for the update initiated by the application you are tracing, or for the remote function calls in an external SAP system that have been invoked by your application.

    • Activating/Deactivating Measurement Explicitly

      If you select this checkbox, you can trace section of your application instead of the whole run. These sections can be initiated or ended, by entering /ron or /roff in the command field or by choosing Start of the navigation path System Next navigation step Utilities Next navigation step Runtime Analysis Next navigation step Activate End of the navigation path or Start of the navigation path System Next navigation step Utilities Next navigation step Runtime Analysis Next navigation step Deactivate End of the navigation path.

      The runtime analysis can also be activated or deactivated at the program side with the statement SET RUN TIME ANALYZER ON or OFF in the source code.

    • Measure with Memory Use (if aggregation not used)

      If you select this checkbox, you can additionally measure the memory consumption in the course of the program execution.

Statements

You use this tab to select specific statements to be measured. The runtimes of the statements that you do not select are still measured, but they are not displayed individually in the measurement results and their time is added to the total runtime.

This tab contains the following statement groups:

  • Processing Blocks

  • dynpro

  • Internal Tables

    Read and change operations on internal tables are not selected by default due to memory considerations. Since operations on internal tables often count as performance problem spots, do not hesitate to activate these statement options.

  • Database Accesses

    The DB-Level Operations is a read-only checkbox and is selected by default. This assures that external database times (the time spent on the database server and not on the SAP database interface) are always measured and can be distinguished from the time components spent on the DB interface.

  • Data Transfer

  • Generate and Load

  • Other

    The Kernel-level Runtime Administration checkbox is not selected by default. This switch is for SAP internal use

You can select or deselect all checkboxes at once, by choosing with the quick info text Select All or with the quick info text Deselect All.

Program Parts

On this tab you can restrict the measurement to specific objects.

The table contains the following columns:

Column Name

Description

Program Type

You can enter one of the following:

P for an executable program or module pool

C for a global class

F for a function group

Program/Gl. Class/Fct. Group

Name of the program, global class, or function group.

Local class

Name of the local class to be measured.

Procedure Type

You can enter one of the following:

METH for methods

FUNC for function modules

FORM for subprograms

Procedure

Name of the procedure to be measured.
Note

You can also filter measurement results at a later date. For this purpose, read the section Display Filter.

If you select Measure functions called by the given program parts, the system also traces the functions called by these Program (Parts).

Only use the Restrict According to Definition in the Hotspot Monitor option if you are asked to by SAP Support.

Note

If you want to restore the standard settings, choose with the quick info text Standard Settings.