Technical Details on Correction Instructions

This section contains information on the following topics:

  • The format of correction instructions
  • The validity of correction instructions
  • Prerequisites for correction instructions

Format

Correction instructions describe the changes that must be made to the source code of ABAP programs to correct errors. Correction instructions are located at the end of an SAP Note. You can use them to automatically correct the source code of ABAP programs, ABAP includes, function modules, method implementations, and screen flow logic.

Each change specifies the object (include, function module, and so on) and the modularization unit (FORM routine, for example). To identify the code that needs to be changed, a unique number of preceding unchanged lines is specified (context block). These are followed by the lines that need to be deleted (delete block) and then the new lines (insert block).

Correction instructions can consist of multiple context, delete and insert blocks.

When the system implements correction instructions automatically, it searches for the context blocks in the function module or include, checks whether the delete blocks follow and then replaces them with the insert block.

If the function module or include has been modified by the customer, the system sometimes cannot find the context blocks or delete blocks specified in the correction instructions, and it cannot implement all the corrections. If this is the case, you can adjust the corrections from the SAP Note to your modifications.

As of the end of 1998, correction instructions were standardized for automatic implementation. Some older SAP Notes may not be in this standardized format. In this case, the Note Assistant cannot implement the SAP Note completely automatically. However, you can edit the source code manually using the Split-Screen Editor. You must do this so that the Note Assistant can register the SAP Note in your system.

Validity

All correction instructions specify the releases and Support Package levels in which you can implement them. These release and Support Package levels are known as the validity range of the correction instructions.

For example, if Support Package 5 corrects and error in Release 4.0B, the validity range of the correction instructions is 4.0B Support Packages 1 – 4.

The Note Assistant checks this validity automatically, and only implements correction instructions if the system is consistent with the validity range specified in the SAP Note.

Prerequisites

In some cases, you can only implement correction instructions if certain other correction instructions have already been implemented. This is due to related changes made to the same part of the source code, or semantic dependencies.

These dependencies are described in the header area of the correction instructions. These dependencies (prerequisites) mean that you need to implement a sequence of SAP Notes, and not just one SAP Note.

No comments: