Show TOC

PERFLocate this document in the navigation structure

Use

PERF ( <block name> , <command interface> ).

This command is only active in combination with transactions ST30 and SCEN_TEST. From these transactions, the option exists to activate the command. It restricts tracing to the commands inside the PERF…ENDPERF block.

The block name provides a way of identifying the block.

PERF blocks can be nested.

Background

ST30 reads the performance statistics data of the monitored application. The statistics data is logged by the application under test at defined points in time. The time frame for this logging is optimized using the SAP ABAP system kernel and can contain activities that are triggered by one or more eCATT script commands. To restrict the statistics data to those activities relating to the eCATT commands between PERF and ENDPERF, the system starts the monitored ABAP session immediately before PERF and ends it immediately after ENDPERF. It is possible to isolate the session because the RFC connection to the system under test can be closed at PERF and ENDPERF.

Standard Use

PERF is mainly used when the RESCON-ACTIVE option is set to 'X', which activates a reset of the RFC connection at PERF and ENDPERF. If you are dealing with complex scenarios with multiple target systems, you can make additional settings for TARGET_SYSTEMS. If your tests are dependent on a particular transactional context in the system under text that you do not want interrupted by a reset of the connection, you can add settings to skip the closing of the RFC connection either at PERF or ENDPERF. In this case, you can try to separate statistical data records by using additional WAIT commands. During the execution of the script, the RFC connection is only closed if all the following prerequisites are met:

  • eCATT has been started in transaction ST30 using the modular performance measurements option.

  • The corresponding settings are activated at the PERF command.

  • The corresponding start options are set.

Command Interface

The command interface of the PERF command has the following structure:

Node

Description

RESCON

Settings for closing the RFC connection

RESCON - ACTIVE

General activation of closing of the RFC connection for the block

Possible values:

  • Space = RESCON is deactivated

  • X = RESCON is activated

RESCON - SYSTEMS

Restricts the RFC connections to be closed

Possible values:

  • Space = Current target system (default)

  • X/* = All target systems used to date

RESCON - SKIP_PERF

Mode for the RESCON @ PERF command

Possible values:

  • Space = Execute RESCON (default)

  • X = Skip RESCON

RESCON - SKIP_ENDPERF

Mode for the RESCON @ ENDPERF command

Possible values:

  • Space = Execute RESCON (default)

  • X = Skip RESCON

COMMANDS

If you specify any commands, only those commands are traced. If you do not specify anything, tracing is performed for all eCATT commands.

TARGET_SYSTEMS

If you specify any systems, only those systems are traced. If you do not specify anything, tracing is performed for all systems. Contains an additional field for resetting the connection for individual target systems.

Start Options

If eCATT is called in the global performance analysis (ST30), there is an additional start option on the initial screen in the Performance Trace group box. Testers can use this start option to control the behavior of the system when closing the RFC connection. The following options are available:

Option

Description

<space>

The reset of the RFC connection is defined by PERF settings.

X

Reset RFC connection at every PERF/ENDPERF command

N

Never reset RFC connection at PERF/ENDPERF command

P

Only reset RFC connection at PERF of each PERF block

E

Only reset RFC connection at ENDPERF of each PERF block