CustomCodeMigration EndToEnd
CustomCodeMigration EndToEnd
2023-10-11
4 What's Next?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
5 Glossary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
SAP S/4HANA 2022 FPS00 2022-10-12 Added chapter Using Exemptions [page
73].
SAP S/4HANA 2021 FPS01 2022-02-23 Added a Document History [page 3].
This guide focuses on the custom code related process from checking custom code remotely, analyzing the
findings, and finally adapting the custom code to SAP S/4HANA 2023.
Read this guide to get instructions on how to adapt your custom code to SAP S/4HANA 2023.
Note
Starting a migration project also provides the opportunity to think about a general re-organization of your
custom code. For this purpose, we recommend you to make yourself familiar with the new extensibility
capabilities and the new technologies in SAP S/4HANA. A comprehensive overview you will find here:
Custom Extensions in SAP S/4HANA Implementations
Custom Code Migration is part of the system conversion process from the classic SAP Business Suite running
on any database to the SAP S/4HANA system. In the context of this system conversion, custom ABAP source
code needs to be adapted, since a lot of SAP code within SAP S/4HANA was simplified and in some cases
changed in a non-compatible way.
Some of your custom code objects are not valid anymore and either do not perform as expected or produce
syntax errors or dumps (red objects in the picture). You almost certainly have other objects that do perform as
expected and do not need to be changed (green objects in the picture).
SAP provides tools, based on the Simplification Database, that detect any custom code that needs to be
adapted to SAP S/4HANA. The Simplification Database is a database table in the SAP S/4HANA system that
1.2 Process
The custom code migration process for the system conversion to SAP S/4HANA describes the tools and
necessary procedures to migrate your custom code. The process consists of the preparatory analysis (custom
code scoping and custom code analysis) and the adaptation of the custom code (custom code adaptation)
after the technical system conversion.
The following figure provides you with an overview of the phases, the activities, and the tools involved in this
process.
Overview of the conversion process that is divided into the preparation phase and the realization phase
Custom code scoping enables you to determine the ABAP custom code that is frequently used and needs to be
taken over to SAP S/4HANA. Unused custom code can be deleted using deletion transport requests during the
system conversion. This means, scoping enables you to reduce the number of custom code to be migrated and
to minimize the efforts of the custom code adaptation.
Note
SAP recommends to scope your custom code in order to delete unused custom code and to minimize your
efforts.
If you want to benefit from scoping, you need to monitor your productive system landscape in advance. To
do this, SAP recommends
You have the following possibilities to run the custom code analysis:
Both options provide the relevant checks in a central check system. The central check system can remotely
execute these checks on any ABAP system (SAP_BASIS 7.00 or higher) where the custom code to be
analyzed is stored.
In the system conversion, you need to adapt any modifications related to ABAP Dictionary objects using
transaction SPDD.
After you performed the system conversion to SAP S/4HANA with Software Update Manager (SUM), you need
to adapt any modifications related to repository objects using transactions SPAU and SPAU_ENH.
After this, we recommend that you run ABAP Test Cockpit (ATC) with SAP S/4HANA checks in ABAP
development tools for Eclipse. The result is a list of ATC findings that relate to SAP S/4HANA simplifications
and refer to SAP Notes which describe how to solve the issues. Based on these ATC findings, you can start
adapting your custom code using quick fixes in a semi-automated way.
Recommendation
SAP recommends you to run ABAP Test Cockpit (ATC) with SAP S/4HANA checks in ABAP development
tools for Eclipse. Here, the check result is provided as a list containing the ATC findings that relate to SAP
S/4HANA simplifications and refer to the SAP Notes which describe how to solve the issues. Based on
these ATC findings and specific quick fixes, you can start adapting your custom code in a semi-automated
way.
You also need to adapt some of your custom code if you upgrade from a lower release to SAP S/4HANA
2023.
Performance Tuning
Finally, you need to check which business processes, for example performance of critical database queries,
need to be optimized in SAP HANA. To do this, you need to check which SQL statements can be optimized.
The relevant performance data for all SQL statements executed in your productive system is displayed in .
Here, you can find the most expensive business processes and the most frequently used SQL statements.
Overview
Some options of the custom code analysis depend on whether your central check system is an on-premise
system or based on SAP BTP ABAP environment.
Options
Follow one of the subsequent options to run the custom code analysis:
1. If your central check system is based on SAP S/4HANA 1809 or higher, you can use the Custom Code
Migration app to define the scope of your custom code that needs be migrated to SAP S/4HANA and to
analyze custom code for SAP S/4HANA custom code checks. This SAP Fiori app acts as a central check
system on the latest version of SAP S/4HANA. This ensures that you run the latest version of the SAP
S/4HANA custom code checks.
Tip
If you choose this option, see Using SAP S/4HANA 2023 as Central Check System [page 10] for more
information on how to run custom code scoping and custom code analysis.
2. If your central check system is based on SAP NetWeaver Application Server for ABAP 7.52, you can
use an ABAP Test Cockpit (ATC) central check system instead. The latter analyzes custom code for SAP
S/4HANA custom code checks.
Tip
If you choose this option, see chapter Using SAP NetWeaver Application Server for ABAP 7.52 as
Central Check System [page 27] for more information how to run the custom code analysis.
3. If your central check system is based on SAP BTP ABAP environment, you can use the Custom Code
Migration app to define the scope of your custom code that needs to be migrated to SAP S/4HANA
and to analyze custom code for SAP S/4HANA custom code checks. The SAP BTP ABAP environment
will analyze your custom code in your on-premise system remotely through Cloud Connector. The SAP
BTP ABAP environment is updated four times a year and contains the latest features of the Custom Code
Migration app.
Tip
If you choose this option, see Using SAP BTP ABAP environment as Central Check System [page 41]
for more information how to run the custom code scoping and custom code analysis.
If your central check system is based on SAP S/4HANA 2023, you use the Custom Code Migration app to
scope and analyze custom code in your on-premise SAP system for SAP S/4HANA custom code checks. This
ensures that you run the analysis based on the latest ATC check versions in the context of ABAP platform.
The Custom Code Migration app enables you to scope and analyze custom code that needs to be migrated
from an SAP Business Suite system to SAP S/4HANA 2023.
To evaluate the development objects to be adapted, this SAP Fiori app performs the SAP S/4HANA custom
code checks.
Setup of the remote custom code adaption of the check results investigated using the Custom Code Migration app
If you have already set up an SAP S/4HANA Sandbox system of the latest release (2022), this system can
also be used for the custom code analysis.
If you have already set up an SAP S/4HANA Foundation system of the latest release (2022), this system
will be technically sufficient to run the custom code migration app. For more information about SAP S/
4HANA Foundation, see SAP Note 3015497 .
To perform the custom code analysis with the Custom Code Migration app, you must set up an SAP
S/4HANA 2021 system.
Moreover, you have to set up the SAP Fiori front-end server on the central check system. For more information,
see Embedded Deployment of SAP Fiori Front-End Server.
In the checked system, the RFC user needs the following authorizations:
Authorization Object
Value Parameter Value
RFC_TYPE FUGR
RFC_NAME SCA_REMOTE_DATA_ACCESS
SABP_COMP_PROCS_E
SYCM_APS_REMOTE
SYST
S_CODE_INSPECTOR_TESTS
RFC_TYPE FUNC
RFC_NAME FUNCTION_EXISTS
REPOSITORY_ENVIRONMENT_ALL
RFC_GET_NAMETAB
SVRS_GET_VERSION_DIRECTORY_46
RFCPING
SLINRMT_RUN
TRINT_PROGRESS_INDICATOR
TRINT_TP_UPDATE_TPSTAT
SLDAG_GET_SYSTEM_NAME
DEVCLASS *
OBJNAME *
OBJTYPE *
P_GROUP *
02 (Change)
03 (Display)
DOMAIN *
DESTSYS *
TTYPE TRAN
02 (Change)
03 (Display)
TTYPE TRAN
FILENAME *
PROGRAM SAPLSABC
SAPLSTRF
In the Central Check System, you need the following user to use transaction ATC to perform custom code
checks:
In addition, you need the following authorization object for importing the Simplification Database into the
Central Check System:
Apply all the relevant SAP Notes that are mentioned in the following SAP Notes in the central check System:
• 2436688 - Recommended SAP Notes for using SAP S/4HANA custom code checks in ATC
• 2364916 - Recommended SAP Notes for using ATC to perform remote analysis
To perform the custom code analysis, you need to configure the connection between the Central Check System
and the checked system.
The Custom Code Migration app performs the SAP S/4HANA custom code checks in the checked system
in which the custom code to be analyzed is stored.
Prerequisites
The RFC user in the checked system requires the authorizations that are specified in SAP Note 2672703 .
Context
You want to configure the required connection from the back-end system of this SAP Fiori app to the checked
system.
Procedure
Use transaction SM59 to create RFC connections for each checked system.
Procedure
2. In the navigation pane, expand the node ATC Administration Setup and double-click Object
Providers.
3. Double-click the item System Groups for selection.
Procedure
1. In the RFC Object Providers view, double-click the item RFC Object Providers for selection.
Fields Description
Note
This ID is used when configuring an ATC run series.
<System Group> The system group to which the Object Provider belongs
<RFC Destination> Valid RFC destination for RFC connection to the checked
system
Note
This RFC connection must be usable without a logon
dialog.
Perform the following tasks to implement the Custom Code Migration app.
Prerequisites
Before implementing the Custom Code Migration app, ensure that you have followed the steps for
Implementing SAP Fiori Apps for Administrative, Configuration, and Extensibility Tasks.
1. In transaction PFCG, add the business catalog SAP_BASIS_BC_CCM (Custom Code Migration) to the user
roles that will use the Custom Code Migration app.
2. Assign the user role to all users that will use the Custom Code Migration app.
The app is now available in SAP Fiori launchpad for all users that have assigned the changed user role.
Tip
Each user can add the app to its SAP Fiori launchpad by using the app finder in their user settings.
1. Assign the user role SAP_BC_YCM_APS to the users who will work with the Custom Code Migration app.
Note
For users who should only display the findings, you can add the authorization object S_YCM_APS to
their roles and set the field ACTVT to the value Display.
The following steps are relevant for the custom code analysis:
To check your custom code against the SAP S/4HANA simplifications, you need to import the Simplification
Database into the Central Check System.
SAP provides content for the Simplification Database of an SAP product in the SAP Support Portal. The
content of the Simplification Database can be downloaded as a ZIP file. This ZIP file then has to be uploaded to
the central check system.
Procedure
2. Choose Types of Software Installations & Upgrades Access downloads and search for CCMSIDB.
3. Choose the relevant ZIP file and choose Download Basket.
Note
To find the most recent content of the Simplification Database provided for SAP S/4HANA, see also
SAP Note 2241080 .
Results
The ZIP file is downloaded and saved on your selected drive. It contains the content of the Simplification
Database.
To add the content of the Simplification Database to your system for further analysis, you need to upload the
downloaded ZIP file to the Central Check System.
Procedure
3. Choose Simplification Database Import from ZIP File from the menu bar.
4. Choose the ZIP file with the downloaded Simplification Database from your drive and confirm with Open.
Results
The Simplification Database is uploaded to the Central Check System and is now available for analysis in
transaction SYCM.
You can display the content of the Simplification Database to get an overview of all changes or specific changes
and the corresponding SAP objects that are simplified in SAP S/4HANA.
Procedure
To get a list of all Simplification Items, choose Ctrl + F8 or the Overview button.
To limit the number of Simplification Items displayed, enter the relevant filter criteria in transaction SYCM
and choose Execute.
Results
The Simplification Database Content view is opened. From here you can order the displayed list, for example by
their SAP Object Type, the assigned Simplification Category, or the relevant SAP Note Number.
From the overview, you can display the list of objects contained in a Simplification Item.
Example
To find out whether a certain object is related to a Simplification Item, enter the name of the object (for
example MATNR) in the Object Name field and execute ( F8 ). Then you can navigate to the corresponding SAP
Note to get more information.
The Custom Code Migration app enables you to scope and analyze custom code that needs to be migrated
from an SAP Business Suite system to SAP S/4HANA. In addition, this app supports you with identifying
unused custom code based on your collected usage data. This enables you to remove unused custom code
during the system conversion.
Key Features:
Scoping:
• Based on usage data, you can define which ABAP custom code needs to be migrated to SAP S/4HANA
• This app creates a deletion transport in order to delete unused ABAP source code during the system
conversion to SAP S/4HANA
The Custom Code Migration app enables you to create an SAP S/4HANA Migration Project.
With the help of an SAP S/4HANA Migration Project, you can analyze custom code that shall be migrated from
an existing product like SAP Business Suite to SAP S/4HANA.
In addition to the SAP S/4HANA Migration Project, the Custom Code Migration app offers two
additional project types.
• The SAP BTP Analysis Project enables you to analyze custom code for readiness to run in SAP BTP
ABAP environment.
• The Custom Code Analysis Project enables you to analyze custom code with arbitrary ATC check
variants.
These project types are not relevant for the custom code migration process and will not be described in this
guide. To find out more about the SAP BTP Analysis and Custom Code Analysis project, you can use the
in-app help and the guided tours in the Custom Code Migration app .
A custom code migration project defines the scope of custom code which you want to analyze and migrate to
SAP S/4HANA.
Procedure
1. Start the tile Custom Code Migration from the SAP Fiori launchpad.
2. Choose Create to create a new custom code migration project.
3. Enter a Project Description for your new project.
4. Define the Target Release of the back-end and the Material Number Length.
Note
Make sure that the checkboxes for Extended Amount Length, Extended Stock/Requirement Segment
and Extended Season/Theme/Collection are enabled, if you use them.
The Custom Code Migration app supports you with identifying your unused custom code based on your
collected usage data. With the scope of a custom code migration project, you can specify which of your custom
code needs to be converted to SAP S/4HANA.
To define the scope of your custom code migration project, you can either use your usage data collected with
transaction SUSG or your usage data collected in your Solution Manager (this requires Solution Manager 7.2
support package 8 or higher).
If you have not aggregated your usage data so far, you should activate the aggregation of your usage data
in transaction SUSG in your production system now. To do so, start transaction SUSG in your production
system and choose Activate to activate the aggregation of your usage data.
If you have applications that you only use in your development or test system, we recommend that you also
collect usage data from these systems.
Ideally, the usage data you add to your custom code migration project should cover at least one year of
usage information, so that also usage data of quarter and year ending functionality is considered.
To define the scope of your custom code migration project, you can use your usage data collected with
transaction SUSG.
Prerequisites
Note
If you have applications that you only use in your development or test system, we recommend that you also
add usage data from these systems.
Procedure
4. Add the snapshot of your usage data to your custom code migration project in the Custom Code
Migration app.
a. Choose Edit.
b. In the Usage Data frame, choose Add.
c. Choose beneath the Usage Description field.
Note
If you transferred your usage data to your checked system, your usage data is displayed
automatically in the Items overview.
e. Select your usage data to add it to your custom code migration project.
Note
When you add usage data to your custom code migration project, a default scope is calculated. The
default scope includes all used objects, all objects which are statically referenced by the used objects,
and objects for which no usage data is available, such as database tables or data elements.
Here you can see how many objects are in and out of scope.
Tip
Choose View By to display detailed scope information or your scope sorted by object name or object
type.
You can also upload your usage data collected in the SAP Solution Manager (using UPL or SCMON).
Prerequisites
Your SAP Solution Manager system must be on the release 7.20 (SP8) or higher.
• 2599695
• 2190065
On the central check system, the RFC destination to the SAP Solution Manager system must be created in the
transaction SM59. See Configuring the Connection Between Central Check System and Checked System [page
14].
Note
If you have applications that you only use in your development or test system, we recommend that you also
add usage data from these systems.
1. Add the usage data to your custom code migration project in the Custom Code Migration app.
a. Choose Edit.
b. In the Usage Data frame, choose Add.
2. Use the value help in the Destination for Usage field.
3. Enter the destination to your SAP Solution Manager system in the Connection field and choose your
destination in the corresponding table row.
4. In the Usage Description field, use the value help to select the right SAP Solution Manager usage data
snapshot from the list.
Results
The Solution Manager usage data will be added to your custom code migration project.
Note
When loading usage data collected in SAP Solution Manager, the usage counter will not display usage
numbers (0 usages). Usage counter data is not supported by the APIs of SAP Solution Manager.
You can find the usage counter here: Scope Change Scope Entry Points (List Page) Choose a
Request Entry Point Procedures within the Entry Point Procedures Number Usages .
In the Custom Code Migration app, you can change the scope on the following levels:
Example
When do you need to change the scope of your custom code migration project?
When you have specified your scope in your custom code migration project, you can create a deletion transport
in the checked system. This deletion transport contains all objects which will not be migrated during the
system conversion.
Procedure
The deletion transport is also shown in the field Request/Task in your custom code migration project.
Next Steps
For more information, see chapter "Integration of Customer Transports" in the corresponding upgrade guide
for SAP HANA DB Software Update Manager 2.0.
When you create a custom code migration project, the SAP S/4HANA custom code checks are performed
automatically. The Custom Code Migration app then gives you an analytical representation of SAP S/4HANA
custom code check findings.
Procedure
1. Choose Analysis to get an overview of the results, as soon as the first analysis has been finished.
2. Choose Analyze Findings to get a detailed analysis.
3. In the Custom Code Migration - Analysis - Findings view, you can specify various filters, for example:
• Simplification Item Category: The simplification item category specifies whether findings are related to
functionality which is not available any more or has been changed in an incompatible way.
• SAP Note Number: Lets you analyze findings of a specific Simplification Item (for example field length
extension of material number)
To show the Quick Fix availability per SAP Note title, you must specify the following settings for the chart:
• SAP Note title (as Category)
• Findings (as Axis 1)
• Quick Fix Availability (as Series)
Results
You can now continue with chapter Custom Code Adaptation After System Conversion [page 61].
If the central check system is based on SAP NetWeaver Application Server for ABAP 7.52, your custom code
needs to be checked remotely against the SAP S/4HANA simplification items in the Simplification Database
using ABAP Test Cockpit (ATC) in the classic SAP GUI. The result is a list of findings where your custom code
does not comply with the scope and data structure of SAP S/4HANA. At this point, you can estimate the effort
required to adapt custom code to be migrated to SAP S/4HANA.
Note
The Central Check System can be used to check one or more SAP Business Suite systems.
To perform the custom code analysis, you need to set up a centralized SAP NetWeaver AS for ABAP 7.52
system as the Central Check System within your SAP system landscape.
For remote access, the Central Check System needs RFC destinations for each relevant system that you want
to check using ATC. When executed, the Central Check System accesses the checked system using Remote
Stubs and the RFC connection. These Remote Stubs are an interface between the Central Check System and
the checked system and return a model from custom code that needs to be checked.
To analyze your custom code in SAP GUI, you need to meet the following system requirements:
In the checked system, the RFC user needs the following authorizations:
Authorization Object
Value Parameter Value
RFC_TYPE FUGR
RFC_NAME SCA_REMOTE_DATA_ACCESS
SABP_COMP_PROCS_E
SYCM_APS_REMOTE
SYST
S_CODE_INSPECTOR_TESTS
RFC_TYPE FUNC
RFC_NAME FUNCTION_EXISTS
REPOSITORY_ENVIRONMENT_ALL
RFC_GET_NAMETAB
SVRS_GET_VERSION_DIRECTORY_46
RFCPING
SLINRMT_RUN
TRINT_PROGRESS_INDICATOR
TRINT_TP_UPDATE_TPSTAT
SLDAG_GET_SYSTEM_NAME
DEVCLASS *
OBJNAME *
OBJTYPE *
P_GROUP *
02 (Change)
03 (Display)
DOMAIN *
DESTSYS *
TTYPE TRAN
02 (Change)
03 (Display)
TTYPE TRAN
FILENAME *
PROGRAM SAPLSABC
SAPLSTRF
Apply all the relevant SAP Notes that are mentioned in the following SAP Notes in the central check System:
• 2436688 - Recommended SAP Notes for using SAP S/4HANA custom code checks in ATC
• 2364916 - Recommended SAP Notes for using ATC to perform remote analysis
To perform the custom code analysis, you need to configure the connection between the Central Check System
and the checked system.
The Custom Code Migration app performs the SAP S/4HANA custom code checks in the checked system
in which the custom code to be analyzed is stored.
Prerequisites
The RFC user in the checked system requires the authorizations that are specified in SAP Note 2672703 .
Context
You want to configure the required connection from the back-end system of this SAP Fiori app to the checked
system.
Procedure
Use transaction SM59 to create RFC connections for each checked system.
A system group is a logical unit that groups multiple SAP systems. Every Object Provider must be assigned to a
system group and therefore you need to create a system group before you configure an Object Provider.
Procedure
2. In the navigation pane, expand the node ATC Administration Setup and double-click Object
Providers.
3. Double-click the item System Groups for selection.
An Object Provider defines the RFC connection to be used for analysis in a remote SAP system. While a check
run is being executed, the ATC framework uses this RFC connection to the checked system to extract a model
from the custom code.
Procedure
1. In the RFC Object Providers view, double-click the item RFC Object Providers for selection.
Note
This ID is used when configuring an ATC run series.
<System Group> The system group to which the Object Provider belongs
<RFC Destination> Valid RFC destination for RFC connection to the checked
system
Note
This RFC connection must be usable without a logon
dialog.
The following steps are relevant for the custom code analysis:
To check your custom code against the SAP S/4HANA simplifications, you need to import the Simplification
Database into the Central Check System.
Procedure
2. Choose Types of Software Installations & Upgrades Access downloads and search for CCMSIDB.
3. Choose the relevant ZIP file and choose Download Basket.
Note
To find the most recent content of the Simplification Database provided for SAP S/4HANA, see also
SAP Note 2241080 .
Results
The ZIP file is downloaded and saved on your selected drive. It contains the content of the Simplification
Database.
Procedure
3. Choose Simplification Database Import from ZIP File from the menu bar.
Results
The Simplification Database is uploaded to the Central Check System and is now available for analysis in
transaction SYCM.
You can display the content of the Simplification Database to get an overview of all changes or specific changes
and the corresponding SAP objects that are simplified in SAP S/4HANA.
Procedure
To get a list of all Simplification Items, choose Ctrl + F8 or the Overview button.
Note
To limit the number of Simplification Items displayed, enter the relevant filter criteria in transaction SYCM
and choose Execute.
Results
The Simplification Database Content view is opened. From here you can order the displayed list, for example by
their SAP Object Type, the assigned Simplification Category, or the relevant SAP Note Number.
From the overview, you can display the list of objects contained in a Simplification Item.
Example
To find out whether a certain object is related to a Simplification Item, enter the name of the object (for
example MATNR) in the Object Name field and execute ( F8 ). Then you can navigate to the corresponding SAP
Note to get more information.
If the central check system is based on SAP NetWeaver Application Server for ABAP 7.52, your custom code
needs to be checked remotely against the SAP S/4HANA simplification items in the Simplification Database
using ABAP Test Cockpit (ATC) in the classic SAP GUI
The system role needs to be specified as Central Check System for remote SAP S/4HANA checks.
Procedure
2. In the navigation pane, expand the node ATC Administration Setup and double-click System Role.
3. Switch to change mode ( F6 ).
4. In the Change System Role view, choose ATC Checks Using Object Providers.
5. Save the new settings and return to the ABAP Test Cockpit Overview screen.
In the Central Check System, you can perform SAP S/4HANA checks to analyze development objects in a
checked system remotely. In this step, you can estimate the effort required to adapt your ABAP source code to
SAP S/4HANA-related changes.
Procedure
2. In the navigation pane, expand the nodes ATC Administration Runs and double-click Schedule Runs.
The screen that appears displays a list of existing run series.
3. Choose the Create button in the toolbar.
4. Enter the name for the series you want to create and confirm.
5. Specify the following entries for the run series you want to create:
Field Description
<Description> Enter a short description for the ATC run series you want
to configure.
Tip
You can use the template provided by the Description
field. When you execute the run series, the built-in
variables are filled with data for the system, the day
of the week, the calendar week, and for the year. How-
ever, you can also add further texts to these variables,
rearrange them, or replace the built-in variables with
your own text.
S4HANA_READINESS_2022_NO_FLE
Predefined settings:
S4HANA_READINESS_2022
Predefined settings:
Note
These product-specific global check variants check all
the simplifications relevant for SAP S/4HANA 2022,
including those for previous releases.
<Object Provider> Enter the ID of the relevant object provider that represents
the remote system you want to check.
<Objects to Check> Specify the set of development objects you want to check
in the checked system.
Tip
You can use the value help to choose the packages or
the object set in the remote system.
Procedure
1. In the list of run series, select the run series in question and click the Schedule button in the toolbar.
2. In the dialog that appears, adapt the settings for the Life Span of the series and for Execution to your
needs. Otherwise, leave these settings unchanged.
Note
The Life Span defines how long (in days) the ATC result is kept in the system. After this, the ATC result
is automatically deleted from the system.
3. Choose Execute ( F8 ).
Note
You can use the option Execute in Background ( F9 ) to schedule a run series at regular intervals.
In this step, you can monitor the status of the remote ATC run series.
Procedure
2. In the navigation pane, expand the nodes ATC Administration Runs and double-click Monitor and
Control Runs.
3. Leave the run series field empty and execute ( F8 ).
The ATC Run Monitor view is displayed. The view shows the status of check runs as running, finished, or
failed.
Procedure
2. In the navigation pane, expand the nodes ATC Administration Runs and double-click Manage
Results.
Note
By default, the ATC run results of the last 10 days are displayed. If you want to see the ATC run results
from a different period of time, change the settings in Schedule Data.
The ATC Manage Results view is displayed. The view shows a list of ATC run results from your requested
period of time.
4. In the ATC Manage Results view, select a run series and choose Display to inspect the results.
9. Click the object name to navigate to the source code to see where the incompatible code occurs.
Results
You can now continue with chapter Custom Code Adaptation After System Conversion [page 61].
You want to bring your custom code from an SAP Business Suite system to SAP S/4HANA. The central check
system, where the analysis for possible adaptations takes place, is based on SAP BTP ABAP environment. Note
that in this case always the latest ATC checks are provided.
To bring your custom code from an SAP Business Suite system to SAP S/4HANA, the Custom Code
Migration app enables you to find the relevant parts in your source code to estimate the effort for converting
your customer code to SAP S/4HANA, on-premise edition.
To use this SAP Fiori app, your SAP administrator must enable the app to provide access for the relevant users.
In addition, you also need to establish an RFC connection for the Cloud Connector. This enables you to access
the on-premise system from the ABAP environment remotely.
The connection between the ABAP environment as central check system to the on-premise system as Checked
System is established through an RFC connection that is configured as destination and a communication
arrangement in the Cloud Connector.
Remote infrastructure using an RFC connection between an on-premise SAP system and SAP BTP ABAP environment across
the Cloud Connector
We recommend using the Cloud Integration Automation Service (CIAS) to set up the Custom Code Migration
app in the SAP BTP ABAP environment. This service provides a guided workflow for simpler and faster setup
and configuration. You'll find more information about the CIAS in the Cloud Integration Automation Service
User Guide.
Note
You can also do the setup manually as described in chapter Manual Setup [page 42].
1. Verify that the prerequisites for the CIAS are fulfilled, as described in the CIAS user guide in the topic
Pre-Requisites.
2. Subscribe to the Cloud Integration Automation Service, as described in Subscription to Standard Plan.
3. Assign the roles CIASIntegrationExpert and CIASIntegrationAdministrator to your user, as
described in Assigning Roles to the Users.
4. Go to Services Instances and Subscriptions Subscriptions to check the status of the CIAS
application. Once the status has changed to Subscribed, choose (Go to Application).
5. The CIAS launchpad opens. Choose the tile Plan for Integration to display all available Solutions and
Scenarios.
6. Use the Search field to find the Custom Code Migration scenario.
7. Open the scenario and choose Select Systems.
8. Select your on-premise SAP system and your SAP Cloud Connector.
9. Choose Generate Workflow, then follow the steps to set up the Custom Code Migration app.
Before you start enabling the Custom Code Migration app for SAP BTP ABAP environment, check whether
the following prerequisites are fulfilled:
For more information about getting started with the ABAP environment, see the SAP BTP documentation on
SAP Help Portal: Getting Started with a Customer Account: Workflow in the ABAP environment.
Before you can use the Custom Code Migration app in the context of SAP BTP ABAP environment, set up
the ABAP environment for your company.
SAP recommends you using a booster. See Using a Booster to Automate the Setup of the ABAP
Environment (Optional). Using this booster, you have to perform the step Creating a Service Key (Optional)
for the Custom Code Migration app in addition.
For more information about the general ABAP environment setup, see Getting Started in the ABAP
environment
Cloud Connector
You have installed the Cloud Connector. For more information see Cloud Connector.
In the checked system, the RFC user needs the following authorizations:
Authorization Object
Value Parameter Value
RFC_TYPE FUGR
RFC_NAME SCA_REMOTE_DATA_ACCESS
SABP_COMP_PROCS_E
SYCM_APS_REMOTE
SYST
S_CODE_INSPECTOR_TESTS
RFC_TYPE FUNC
RFC_NAME FUNCTION_EXISTS
REPOSITORY_ENVIRONMENT_ALL
RFC_GET_NAMETAB
SVRS_GET_VERSION_DIRECTORY_46
RFCPING
SLINRMT_RUN
TRINT_PROGRESS_INDICATOR
TRINT_TP_UPDATE_TPSTAT
SLDAG_GET_SYSTEM_NAME
DEVCLASS *
OBJNAME *
OBJTYPE *
P_GROUP *
02 (Change)
03 (Display)
DOMAIN *
DESTSYS *
TTYPE TRAN
02 (Change)
03 (Display)
TTYPE TRAN
FILENAME *
PROGRAM SAPLSABC
SAPLSTRF
A subaccount enables you to run applications and services in the global account of your ABAP environment.
Prerequisites
Context
You want to establish an RFC connection to your on-premise system to be checked. To do this, you need to
create a subaccount for the Cloud Foundry environment.
Note
If you use the Prepare an Account for ABAP Development booster, you can skip this step. The
booster will perform this task.
Procedure
1. As an SAP administrator, select the Global Accounts navigation pane and open the relevant global account
in the SAP BTP Cockpit.
2. Select the Subaccounts navigation pane.
3. Choose the New Subaccount button from the header toolbar to create a new subaccount in the Cloud
Foundry environment.
4. In the dialog, enter the following data:
a. Define and enter a Display Name.
b. [Optional:] Provide a Description.
c. Make sure that the Neo checkbox is unmarked.
d. Choose the Provider and Region of your system connection.
e. Define and enter the Subdomain to use a custom domain for your company.
f. [Optional:] If required, choose the following checkboxes:
• Use for production
• Enable beta features
5. Choose Create.
The subaccount will be created and added to your subaccounts. This will take a few moments.
6. Open the subaccount you just created.
7. In the Cloud Foundry tile, choose Enable Cloud Foundry.
Results
The new subaccount for the Cloud Foundry environment appears in the global account page and displays the
details.
This subaccount enables you to connect your cloud connector which contains the RFC connection(s) to your
on-premise system(s).
The Cloud Connector enables the connection between the SAP BTP ABAP environment and on-premise
systems in a secured network.
Prerequisites
Context
You want to add and connect your subaccount for the Cloud Foundry environment to the Cloud Connector.
• Managing Subaccounts
• Cloud Connector
Procedure
Results
A new entry for the Cloud Foundry subaccount is added in the Subaccount Dashboard table in the Cloud
Connector.
The resource accessible represents the on-premise system that can be accessed through the Cloud Connector.
Context
You want to enable the connection for SAP BTP ABAP environment to an on-premise system.
Procedure
1. In the Cloud Connector, select the [Display Name of the Cloud Foundry Subaccount] Cloud to On-
Premise navigation pane.
2. To add a new system mapping, choose from the section toolbar of the Mapping Virtual To Internal
System table.
3. In the Add System Mapping wizard, provide the following data:
4. Note
To use a connection with load balancing, skip this step and proceed with the next step.
Note
You will find these details in the SAP Logon of your On-Premise system.
• Application Server.
• Instance Number of your Application Server ABAP.
• Name of the SAProuter, if applicable.
d. Enter a virtual name for the Application Server.
e. Enter a virtual Instance Number.
f. Choose Next.
g. Optional: Enter a description.
h. Choose Next.
5. Note
If you use a connection without load balancing, skip this step. Follow the instructions in the previous
step instead.
Note
You will find these details in the SAP Logon of your On-Premise system.
• Message Server.
• System ID.
• Name of the SAProuter, if applicable.
d. Choose Next.
e. Define and enter a virtual name for the Message Server.
f. Define and enter a virtual System ID.
g. Optional: Enter a description.
h. Choose Next.
Now, you want to define the permitted function modules as resources for a specific back-end system.
Note
To get the relevant import file for the Custom Code Migration scenario, see SAP Note 2861842 -
Custom Code Migration in SAP BTP ABAP environment: Set up SAP Cloud Connector.
Results
You have defined the on-premise system(s) that are accessible from the ABAP environment.
Now, you can call the defined function modules in the on-premise system.
To assign the Custom Code Migration app to the users and to configure the connectivity between the ABAP
environment and the Cloud Connector, proceed as follows.
The user assignment describes the relevant roles that a user requires to access SAP BTP ABAP environment
using the Custom Code Migration app.
Context
You want to enable business users to access the Custom Code Migration app.
For more information see, How to Create a Business Role from a Template.
If you use Prepare an Account for ABAP Development booster, you can skip this step. The booster
will perform this task.
Procedure
1. In the SAP Fiori launchpad, navigate to the Identity and Access Management section and open the
Maintain Business Roles app.
2. On the initial screen, select Create from Template from the bottom of the page.
The new business role is created and opened in the Maintain Business Role page.
8. Select Maintain Restrictions from the title toolbar.
Results
The business role is created and added. The assigned users now have access to the Custom Code
Migration app.
Prerequisites
To create these communication arrangements, you need the Administrator and the Project Manager –
IT role.
You have created a destination to your on-premise system in the Cloud Connector that is connected to your
BTP subaccount.
Context
You want to enable communication from your ABAP environment to your on-premise systems using Remote
Function Calls (RFC).
To do this, you need to use the communication arrangement SAP_COM_0464 (SAP Custom Code Migration
Integration).
Procedure
If not yet available or defined, create a new communication system for the communication arrangement to
define an endpoint for your checked system.
a. For the Communication System, choose New.
b. In the New Communication System dialog, enter the System ID and System Name of the checked
system.
c. Choose Create.
d. In the Technical Data tab under General, enter the virtual host as specified in your Cloud Connector as
Host Name. The field Port has already been filled in automatically with the default 443.
e. Turn on the slider for Cloud Connector.
f. Filling in the field SCC Location ID is optional.
g. Under RFC Settings, fill in the fields Client, Instance Number and Target Host as specified as virtual host
in your Cloud Connector.
6. Under Outbound Services Retrieve Custom Code , ensure that the Service Status is set to Active.
7. Choose Save to save the communication arrangement. A message should now pop up at the bottom of the
screen telling you that the activation was successful.
Results
You can now select the communication arrangement in the Connection to Remote System field in the Custom
Code Migration app to establish the connection to your on-premise system.
During ATC execution, the central check system accesses the systems in your landscape remotely through
so-called remote stubs using RFC connection. So, remote stubs serve as an interface between the central
check system and on-premise systems. They return a model from custom code which needs to be checked.
Prerequisites
In the on-premise system, implement SAP Note 2599695 (Custom Code Migration Fiori App: Remote Stubs
for the Checked System) in advance.
Context
You want to analyze your custom code in your on-premise system using the Custom Code Migration app.
Procedure
The Custom Code Migration app now has access to the on-premise system. You can now start the custom
code analysis.
The Custom Code Migration app enables you to scope and analyze custom code that needs to be migrated
from an SAP Business Suite system to SAP S/4HANA. In addition, this app supports you with identifying
unused custom code based on your collected usage data. This enables you to remove unused custom code
during the system conversion.
Key Features:
Scoping:
• Based on usage data, you can define which ABAP custom code needs to be migrated to SAP S/4HANA
• This app creates a deletion transport in order to delete unused ABAP source code during the system
conversion to SAP S/4HANA
The Custom Code Migration app enables you to create an SAP S/4HANA Migration Project.
With the help of an SAP S/4HANA Migration Project, you can analyze custom code that shall be migrated from
an existing product like SAP Business Suite to SAP S/4HANA.
Note
In addition to the SAP S/4HANA Migration Project, the Custom Code Migration app offers two
additional project types.
• The SAP BTP Analysis Project enables you to analyze custom code for readiness to run in SAP BTP
ABAP environment.
• The Custom Code Analysis Project enables you to analyze custom code with arbitrary ATC check
variants.
These project types are not relevant for the custom code migration process and will not be described in this
guide. To find out more about the SAP BTP Analysis and Custom Code Analysis project, you can use the
in-app help and the guided tours in the Custom Code Migration app .
A custom code migration project defines the scope of custom code which you want to analyze and migrate to
SAP S/4HANA.
Procedure
1. Start the tile Custom Code Migration from the SAP Fiori launchpad.
2. Choose Create to create a new custom code migration project.
3. Enter a Project Description for your new project.
4. Define the Target Release of the back-end and the Material Number Length.
Note
Make sure that the checkboxes for Extended Amount Length, Extended Stock/Requirement Segment
and Extended Season/Theme/Collection are enabled, if you use them.
The Custom Code Migration app supports you with identifying your unused custom code based on your
collected usage data. With the scope of a custom code migration project, you can specify which of your custom
code needs to be converted to SAP S/4HANA.
To define the scope of your custom code migration project, you can either use your usage data collected with
transaction SUSG or your usage data collected in your Solution Manager (this requires Solution Manager 7.2
support package 8 or higher).
Note
If you have not aggregated your usage data so far, you should activate the aggregation of your usage data
in transaction SUSG in your production system now. To do so, start transaction SUSG in your production
system and choose Activate to activate the aggregation of your usage data.
If you have applications that you only use in your development or test system, we recommend that you also
collect usage data from these systems.
Ideally, the usage data you add to your custom code migration project should cover at least one year of
usage information, so that also usage data of quarter and year ending functionality is considered.
To define the scope of your custom code migration project, you can use your usage data collected with
transaction SUSG.
Prerequisites
Note
If you have applications that you only use in your development or test system, we recommend that you also
add usage data from these systems.
Procedure
4. Add the snapshot of your usage data to your custom code migration project in the Custom Code
Migration app.
a. Choose Edit.
b. In the Usage Data frame, choose Add.
c. Choose beneath the Usage Description field.
d. Search for your usage data you created as a snapshot.
Note
If you transferred your usage data to your checked system, your usage data is displayed
automatically in the Items overview.
e. Select your usage data to add it to your custom code migration project.
Note
When you add usage data to your custom code migration project, a default scope is calculated. The
default scope includes all used objects, all objects which are statically referenced by the used objects,
and objects for which no usage data is available, such as database tables or data elements.
Tip
Choose View By to display detailed scope information or your scope sorted by object name or object
type.
You can also upload your usage data collected in the SAP Solution Manager (using UPL or SCMON).
Prerequisites
Your SAP Solution Manager system must be on the release 7.20 (SP8) or higher.
• 2599695
• 2190065
On the central check system, the RFC destination to the SAP Solution Manager system must be created in the
transaction SM59. See Configuring the Connection Between Central Check System and Checked System [page
14].
Note
If you have applications that you only use in your development or test system, we recommend that you also
add usage data from these systems.
Procedure
1. Add the usage data to your custom code migration project in the Custom Code Migration app.
a. Choose Edit.
b. In the Usage Data frame, choose Add.
2. Use the value help in the Destination for Usage field.
3. Enter the destination to your SAP Solution Manager system in the Connection field and choose your
destination in the corresponding table row.
4. In the Usage Description field, use the value help to select the right SAP Solution Manager usage data
snapshot from the list.
The Solution Manager usage data will be added to your custom code migration project.
Note
When loading usage data collected in SAP Solution Manager, the usage counter will not display usage
numbers (0 usages). Usage counter data is not supported by the APIs of SAP Solution Manager.
You can find the usage counter here: Scope Change Scope Entry Points (List Page) Choose a
Request Entry Point Procedures within the Entry Point Procedures Number Usages .
Example
When do you need to change the scope of your custom code migration project?
When you have specified your scope in your custom code migration project, you can create a deletion transport
in the checked system. This deletion transport contains all objects which will not be migrated during the
system conversion.
Procedure
The deletion transport is also shown in the field Request/Task in your custom code migration project.
Next Steps
For more information, see chapter "Integration of Customer Transports" in the corresponding upgrade guide
for SAP HANA DB Software Update Manager 2.0.
When you create a custom code migration project, the SAP S/4HANA custom code checks are performed
automatically. The Custom Code Migration app then gives you an analytical representation of SAP S/4HANA
custom code check findings.
Procedure
1. Choose Analysis to get an overview of the results, as soon as the first analysis has been finished.
2. Choose Analyze Findings to get a detailed analysis.
3. In the Custom Code Migration - Analysis - Findings view, you can specify various filters, for example:
• Simplification Item Category: The simplification item category specifies whether findings are related to
functionality which is not available any more or has been changed in an incompatible way.
• SAP Note Number: Lets you analyze findings of a specific Simplification Item (for example field length
extension of material number)
• Scope Information: Lets you filter the findings to show only findings for objects that are in scope.
• Quick Fix Availability: Lets you analyze which findings can be solved by a Quick Fix and which findings
have to be solved manually.
4. Choose to change the settings for the chart.
To show the Quick Fix availability per SAP Note title, you must specify the following settings for the chart:
Results
You can now continue with chapter Custom Code Adaptation After System Conversion [page 61].
After Software Update Manager (SUM) has performed the technical conversion, you can start adapting your
custom code.
SAP provides the adjustment tools SPDD, SPAU, and SPAU_ENH, which enable you to reimplement any
modifications related to ABAP Dictionary objects and development objects (such as programs, function
modules, screens, interfaces, and documentation) in system upgrades.
Note
Transaction SPDD is performed during the system conversion whereas all other adaptations take place after
the conversion.
To check for ATC findings in the converted system, you need to configure a local ATC run series that checks the
requested development objects.
To detect custom code which needs to be adapted to SAP S/4HANA, SAP provides tools based on the
Simplification Database.
Procedure
Import the Simplification Database. For more information, see Importing the Simplification Database [page 18].
Prerequisites
Apply all the relevant SAP Notes that are mentioned in 2436688
Procedure
3. In the navigation pane, expand the nodes ATC Administration Runs and double-click the Schedule
Runs entry.
<Description> Enter a short description for the ATC run series you want
to configure.
Tip
You can use the template provided by the Description
field. When you execute the run series, the built-in
variables are filled with data for the system, the day of
the week, the calendar week, and the year. However,
you can also add further texts to these variables, rear-
range them, or replace the built-in variables with your
own text.
S4HANA_READINESS_2022_NO_FLE
Predefined settings:
S4HANA_READINESS_2022
Predefined settings:
Note
These product-specific global check variants check all
the simplifications relevant for SAP S/4HANA 2022,
including those for previous releases.
<Objects to Check> Specify the set of development objects you want to check.
Tip
You can use the value help to choose the packages or
the object set in the remote system.
Procedure
1. In the list of run series, select the run series in question and click the Schedule button in the toolbar.
2. In the dialog that appears, choose Set to Active Result.
3. Adapt the settings for the Life Span of the series and for Execution to your needs. Otherwise, leave these
settings unchanged.
Note
The Life Span defines how long (in days) the ATC result is kept in the system. After this, the ATC result
is automatically deleted in the system.
4. Choose Execute in Background ( F9 ) to schedule the run series in regular time intervals.
SAP recommends to schedule the local ATC run series in regular time intervals since new ATC findings
could emerge during custom code adaptation.
After a local ATC run series has checked the requested development objects, you can start adapting the
custom code by fixing the ATC findings of the ATC run result with ABAP development tools for Eclipse.
Prerequisites
You have installed the latest version of ABAP development tools for Eclipse. In Eclipse, you created an ABAP
Project which is connected to your converted SAP S/4HANA system. For more information, see the Help
Contents in ABAP development tools for Eclipse.
Procedure
Note
By default, all ATC findings are filtered by your user name and only ATC findings belonging to your user
are displayed. To display the ATC findings of all users, open the context menu of the ABAP Project in the
ATC Result Browser view, choose Change User Filter, and enter * as the user name.
4. Choose Group By Check to display the ATC findings sorted by the different checks of the check
variant S4HANA_READINESS.
Choose Configure Columns to add or remove the columns you want to display or hide in the details of
the result. Subsequently, you can filter the active result according to all values in the visible columns.
5. Select the check group S/4HANA: Search for S/4 related syntax errors and choose Recheck in the context
menu.
If you want to assign ATC findings of an ATC run result to a certain developer, you can do that by changing the
contact person of the ATC findings.
Prerequisites
You need the authorization object S_Q_GOVERN (ACTVT = 03 and ATC_OTYPGO = 02) to change the contact
person.
Note
You can change the contact person only for local check runs.
1. In the ATC Result Browser view, select the Active Result to display the list of ATC findings.
2. Select all ATC findings in question and choose Change Contact Person in the context menu.
3. In the Change Contact Person view in the field New Contact Person, enter the user name of the developer to
whom you want to assign the ATC findings.
Procedure
The view shows a Worklist of ATC findings resulting from the recheck on the check group S/4HANA: Search
for S/4 related syntax errors.
2. Select an ATC finding to display further information about what and where the statements with problems
are and what you can do to fix the ATC finding.
3. Double-click an ATC finding to jump to the source code at the position where the ATC found a statement
with a problem.
4. Fix each ATC finding in the Worklist as described in the Details view and the assigned SAP Note.
Note
You can also fix ATC findings by using Quick Fixes. See Applying Quick Fixes [page 68] for more
information.
You can fix certain ATC findings with Quick Fixes. These Quick Fixes provide functions that enable you to
resolve errors and warnings without adapting your source code manually.
Context
In the context of the custom code migration, Quick Fixes are available for the following checks and its
corresponding simplification items:
S/4HANA: Field length extensions 2215852 - Material Number Field for example MATNR
Length Extension: Code Adaptions
S/4HANA: Search for database opera- 2198647 - S/4 HANA: Data Model VBFA, VBUK, VBUP
tions Changes in SD
S/4HANA: Search for usages of simpli- 2198647 - S/4 HANA: Data Model VBTYP
fied objects Changes in SD
S/4HANA: Search for S/4 related syn- 2198647 - S/4 HANA: Data Model VBTYP
tax errors Changes in SD
Note
Please note, that not all ATC findings resulting from these checks can be fixed with Quick Fixes.
Procedure
Note
ATC findings that can be fixed with a Quick Fix are displayed with a lightbulb icon .
1. Select an ATC finding with a lightbulb icon in the ATC Problems view.
Recommendation
If there is more than one Quick Fix available for an ATC finding, we recommend that you select the first
Quick Fix displayed.
You can also fix multiple ATC findings at once with the Recommended Quick Fixes wizard.
Procedure
Tip
If you want to display all affected objects and their respective ATC findings, choose Group by Object.
4. In the Quick Fix column in the Quick Fix Selection frame, the recommended Quick Fixes for the ATC findings
are displayed by default. Select a Quick Fix to open a dropdown list with alternative Quick Fixes.
Recommendation
5. In the Post Processing frame, you can specify that the changed objects are activated after you apply the
Quick Fixes. If this option is selected, you can specify that the selected ATC findings are rechecked after
you finish the wizard.
Note
If you do not select any post processing options, the initial ATC result is displayed after you finish the
wizard. In this case, you have to activate and recheck the ATC findings manually.
6. Choose Next.
7. Select a transport request if required.
8. Choose Next.
9. Review the changes. Here, a comparison editor is displayed where you can review the refactored source
code. The code line where the source code has been refactored is highlighted.
Results
This feature enables you to add automatically generated comments to your refactored code.
Context
Note
• In order to keep your code readable and clean, SAP recommends to leave this function deactivated.
• Quick fix comments are currently available only for transportable objects. It is not possible to apply
them for local objects.
1. To enable quick fix comments in your system, mark the checkbox Enable Comments in the Quick Fix
Comments section of the Recommended Quick Fixes wizard.
2. To include information about the author of the Quick Fix and and the date when it was applied, mark the
checkbox Include author / date.
The source code comment in the refactored code contains the following information:
Example
Sample Code
This is an example of a Quick Fix comment that has been automatically generated and added to the refactored
code. It contains the following information:
Pseudo comments are one way of suppressing ATC findings. Sometimes it is the case that certain ATC findings
cannot be fixed (so-called false positives). In this case and especially in the context of the Custom Code
Procedure
Note
If SAP S/4HANA-related pseudo comments are available for an ATC finding, they can easily be applied as a
Quick Fix.
Apply the Quick Fix. For more information, see Applying Quick Fixes [page 68].
The pseudo comment is appended at the end of the code line in question.
Remember
The pseudo comment appended does not fix the ATC finding. It only suppresses the ATC finding, so it does
not appear anymore after a recheck.
If you can't clear an ATC finding by correcting the underlying problem, you can still clear it by requesting an
exemption. Once approved, an exemption masks an ATC error or warning message. The finding then does not
appear as an open issue in the ATC results anymore.
Note
The exemption does not fix the ATC finding. It only suppresses the ATC finding, so it does not appear
anymore after a recheck.
For more information about creating exemptions and maintinaing approver responsibilities in an on-premise
environment, see:
• ATC Exemptions
• Working with ATC Exemptions
In the ABAP environment, exemptions are transportable objects of the type CHKE. You can use the ATC
exemption editor to edit the details of an exemption, retrieve the ABAP development tools for Eclipse link to
trigger an exemption request or, as an approver, make your assessment on an exemption.
Once you have fixed the ATC findings of the check group S/4HANA: Search for S/4 related syntax errors, you
need to recheck the active result and fix all other ATC findings.
Procedure
The view shows a Worklist of ATC findings resulting from the recheck on the active result.
4. Fix the ATC findings in the Worklist.
5. Recheck the Active Result in ATC Result Browser view again to validate that the ATC findings are fixed.
Note
Repeat the steps 4 and 5 if there are still ATC findings in the Worklist after the recheck.
Rerun the local ATC run series once all the ATC findings are fixed, since new ATC findings could have emerged
during the adaptation of your custom code.
There are a few more things you can do after the custom code migration:
Testing Applications
Test your applications to check whether your programs run on SAP S/4HANA.
Note
ATC is not able to find all potential issues (for example, dynamic coding is not covered by static code
checks).
Add the SAP S/4HANA checks with check variant S4HANA_READINESS to your regular ATC checks.
Runtime Checks
Run the Runtime Check Monitor in transaction SRTCM in the new productive system and activate the checks
Empty table in FOR ALL ENTRIES clause and Missing ORDER BY or SORT after SELECT. Schedule the check
runs on a regular basis and correct the additional findings found by the runtime check.
Performance Optimizations
Switch on SQL Monitor in the productive system. Sort the SQL Monitor results by execution time and
optimize the top 10-20 SQLs in your custom code which affect relevant business processes. After performance
optimizations reach the productive system, this process needs to be repeated 2-3 times to achieve the best
results.
For more information, see ABAP SQL Monitor Implementation Guide and Best Practices
After the successful migration, you can now start to think about optimizing your business processes by
using code push down techniques of SAP S/4HANA, like the Core Data Services (CDS) and ABAP-managed
database procedures (AMDP) implemented by the native HANA language SQL script.
You can access in-app help from the UIs of an app that provides you context-sensitive help information for UI
elements and guided tours.
The in-app help is web-based and needs to be configured in the context of ABAP platform. In addition, an
embedded help system (for example, the SAP Help Portal) is required.
Note
In your on-premise system, you need to configure the in-app help, before you can benefit from it.
In the context of ABAP environment, the in-app help is enabled per default.
If you want to customize the help content, you need to implement your own help system.
The following terms are used within the context of this Custom Code Migration guide:
Term Definition
(ABAP) Custom Code Describes the development objects and ABAP source code
that has been developed by customers or SAP partners.
ABAP Test Cockpit (ATC) Tool for performing static and dynamic quality checking of
ABAP source code and associated repository objects both
remotely and locally.
Central Check System Backend system that provides and performs the SAP S/
4HANA custom code checks for one or multiple SAP sys-
tems remotely.
Checked System System with custom code that gets checked remotely by the
central check system.
Conversion / Migration Describes the process of bringing custom code from an ex-
isting Enterprise Resource Planning (ERP) system to an SAP
S/4HANA system.
Simplification Database Database table in the SAP S/4HANA system that contains
all the simplification items referring to SAP objects simpli-
fied in SAP S/4HANA.
Simplification Item Describes the adaptation of an SAP product that has a tech-
nical impact on custom code.
Transformation Describes the process for bringing custom code from an ex-
isting on-premise Enterprise Resource Planning (ERP) sys-
tem to SAP BTP ABAP environment.
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
• Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
• The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
• SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
• Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering an SAP-hosted Web site. By using
such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities,
genders, and abilities.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.