SAP Note

1320810 - Z_ENQUEUE_PERF Version 54 Validity: 25.06.2013 - active Language English

Header Data
Released On 19.06.2013 18:46:30 Release Status Released for Customer Component BC-CST-EQ Enqueue Priority Recommendations / Additional Info Category Special development

Symptom
When you configure the enqueue function, problems occur or performance deteriorates.

Other Terms
Z_ENQUEUE_PERF, Z_FB_ENQUEUE_PERF, RSMONENQ_PERF, SM12

Reason and Prerequisites

For ABAP Basis Release 6.10 and higher, a report has been developed that does the following systemwide:
l

Checks the configuration of the enqueue function. Performs a range of performance tests to assess possible bottlenecks. Performs a range of tests to detect known problems

In the case of the standalone enqueue server, the system checks the instance profile parameter of the enqueue client (therefore, of the work processes). The execution is possible as of the Enhancement Packages that are specified on the SUPPORT PACKAGES tab page, namely by using transaction S M 1 2 - Error handling - Diagnosis environment (or by entering the okay code "DUDEL" in the okay code field). If the required Enhancement Package level is not available, you can manually implement the report as described below. Since this is a new development that contains certain tests that will certainly be changed regularly in the near future, the development was previously delivered as an attachment to a note to enable customers to access the current version quickly. To install this, proceed as follows: a.) The ABAP report Z_ENQUEUE_PERF In the test system or the quality system, create the report Z_ENQUEUE_PERF and upload the ABAP report that has the same name in the attachment (To do so, proceed as follows in change mode: Choose the pull-down menu: "Utilities -> More Utilities -> Upload/Download -> Upload".). Save and activate the ABAP report. b.) The function module Z_FB_ENQUEUE_PERF You must also call transaction SE37 to create the function module Z_FB_ENQUEUE_PERF. The source code for the function module is provided as a comment at the END of the report Z_ENQUEUE_PERF. Both source texts are delivered in one file to avoid version problems. You can create the function module in any function group that already exists in the customer namespace. 1. On the "Attributes" tab page, you must set the function module to a "Remote-Enabled Function Module" in the "Processing Type" section. If you forget to do this, the following error occurs: Z_FB_ENQUEUE_PERFreturns: 1opcode 2. You must enter the interface parameters on the tab pages "Import", "Export", "Tables", and "Exceptions". These are provided in detail in the information documentation for the function module. In turn, you can find this in the HEADER of the source code for the function module. To avoid compiler error messages of various types, you must take the following into account: a) The check boxes for the value parameter transfer must be set for ALL IMPORT AND EXPORT parameters.

b) All of the IMPORT parameters (apart from OPCODE) must be marked as optional and then, c) The TABLES parameter must also be marked as optional. 3. Finally, in change mode, copy the commented source code in the attached ABAP report onto the "Source code" tab page. Select the entire source text.Right-click to remove the comment (format); this removes all of the comment characters at once. Save and activate the function module.

Solution
You execute the ABAP report Z_ENQUEUE_PERF from transaction SE38. Once the report is complete, the system displays the analysis result as a simple list. You must save this (for example, using the okay code %pc) and provide this to SAP Support. If the following conditions are met, the runtime of the report is as specified below:

If two application servers exist If there are no RFC problems If trace files exist in level 1 If the installation is correct If there are no performance problems.

Around 20 seconds. The runtime increases linearly with more application servers. Note the following: The runtime of an individual test (one line in the output) is restricted to approximately 2.5 seconds. Therefore, the total of the program runs (in the standard SAP system, 100 per test or line) may be lower. If, due to time constraints, 100 loops are not reached, as of version 2.6, a W(arning) message is displayed on the right hand side next to the average time per request. As of version 2.6, the column is in color. In particular, in version 2.7, the average values for tests 2.1 - 2.3 and 2.5 - 2.6 per request are marked in color. Values under 2.5 milliseconds are marked in green, larger values are marked in red. For test 2.4 (real enqueues) the limit is 2 milliseconds, for the test 2.7 the limit is 10 milliseconds (RFCs on the CI). Also note the following:
l

Version 1.11 - May 28, 2009 Version 1.12 - July 08, 2009 Version 1.13 September 20, 2009 Version 1.21 October 01, 2009 Version 1.25 - November 01, 2011 Version 1.27 - April 12, 2011 Version 1.30 - April 27, 2011 Version 1.40 July 22, 2011 Version 1.43 August 23, 2011 Version 2.00 September 02, 2011 Version 2.01 December 01, 2011 Version 2.02 February 27, 2012 Version 2.03 August 16, 2012 Version 2.04 April 30, 2013 Version 2.05 June 4, 2013 Version 2.06 June 5,2013 Version 2.07 June 11, 2013 Version 2.08 June 12, 2013 Version 2.09 June 13, 2013 Version 2.10 14.06.2013 (not runnable)

Version 2.10 June 19, 2013

Improvements in the ABAP report are described in the program header.

Validity
Software Component From Rel. SAP_BASIS 620 700 710 731 72L 740 To Rel. And Subsequent 640 702 730 731 800 740

Support Packages & Patches

Support Packages

Software Component Release Support Package SAP_BASIS 730 SAPKB73002 620 SAPKB62070 710 SAPKB71012 702 SAPKB70207 711 SAPKB71107 720 SAPKB72005 640 SAPKB64028 700 SAPKB70024 701 SAPKB70109 720 SAPKB72008 702 SAPKB70214 730 SAPKB73010 731 SAPKB73109 740 SAPKB74004 700 SAPKB70030 710 SAPKB71018 701 SAPKB70115 711 SAPKB71113 730 SAPKB73011

References
This document refers to:
SAP Notes 1384191 SM50: Many processes in status "holds ENQ"

This document is referenced by:

SAP Notes (1) 1384191 SM50: Many processes in status "holds ENQ"

Attachments
File Name File Size (KB) Mime Type Z_ENQUEUE_PERF.TXT 262 text/plain