Procedure documentationDecommissioning


Over time, custom code objects in your system landscape can become obsolete. For example, if a new software version fills a functional gap for which you once implemented a custom development, this custom code is no longer needed and can be decommissioned.

The Decommissioning Cockpit is a lifecycle tool for managing custom code based on your custom code library. The cockpit helps you to identify redundant or obsolete custom code objects and to retire them from your systems. You create decommissioning analyses and schedule background jobs to monitor custom code objects in your system for activity over a defined period. You can run standard analyses created by SAP or you can define your own analyses.

The cockpit provides a graphical representation of the lifecycle status of the custom code objects from the custom code library. If you see that custom code objects are unused, you can schedule these objects for decommissioning.

The number of analyses in each status is displayed at the top of the screen, along with links to navigate to the analysis list of each status.

  • Create monitoring jobs to identify obsolete custom code objects

  • View the lifecycle status of custom code objects from your custom code library

  • View detailed statistics about the custom code objects in your system landscape

  • Schedule objects for decommissioning


  • A custom code library is active in your system landscape and contains data to analyze.

  • You have completed the Custom Code Management scenario of SAP Solution Manager Configuration.

  • You have the necessary authorizations:

    • To access all features of the cockpit, create new analyses, and delete objects, you need the standard role SAP_CCLM_ALL.

    • To view analyses and their results you need the role SAP_CCLM_DIS.

      Note Note

      You generate and assign these roles to users in the Create Template Users step in the Custom Code Management scenario of SAP Solution Manager Configuration.

      End of the note.


Creating New Analyses

You can create a decommissioning analysis project to schedule background jobs that gather and analyze information about the custom code objects in your system landscape from your custom code library.

  1. Under New Analysis, choose Create New Analysis.

  2. In the Create New Analysis screen area, enter basic information about the analysis and set a decommissioning target, that is, either the number of objects or percentage of total objects you want to attempt to decommission. This value is used to measure the success of the decommissioning project.

  3. You have the following options:

    • If you previously created and saved an analysis, you can use the settings of the old analysis as the basis for the new analysis. In the Saved Settings drop-down list, select the analysis you want to use and choose Save & Start Analysis.

    • If you want to create a completely new analysis, continue to the next step.

  4. In the Settings screen area, under Generic Data, enter the values you want in the corresponding fields:

    Note Note

    Mandatory fields are marked with an asterisk (*).

    End of the note.
    • Development Systems

      The development systems in your landscape that you want to include.

    • Statistical Systems

      The quality systems and productive systems in your landscape from which you want to collect usage statistics. Depending on your landscape, these might be the same as your lead systems.

    Under Generic Data:

    • Analysis Period

      The period of time from which objects are considered in the analysis.

    • Wait Time

      After the analysis is complete, the cockpit monitors the custom code objects that have been identified as candidates for decommissioning for the specified wait time. During this waiting period, if the selected object is used, the Used Status turns red. Otherwise, the status remains green, indicating that the object is still recommended for decommissioning.

    • Additional Options

      You can specify whether you want the analysis owner to receive an e-mail notification when an object is used during the waiting period. You can also specify whether users must create a backup transport before objects can be decommissioned.

  5. Under Analysis Data, you specify the type of objects you want to identify as potential candidates for decommissioning. You have the following options:

    • To use SAP standard analyses, select Standard and select one of the analyses types listed. Depending on the analysis type you select, you have to enter some additional values. For example, if you select Objects similar to SAP standard, you must specify a similarity percentage. If you set this value at 90%, all custom code objects that are at least 90% identical to an SAP standard object are identified as candidates for decommissioning.

    • To create your own custom analysis, select Other and enter the values you want in the corresponding fields.

  6. Under Additional Attributes, you can specify attributes and values of objects to further define the scope of the analysis.

  7. Click Save & Start Analysis to confirm your entries.

Working with Active Analyses

After an analysis has started, you can choose the link in either the Analyses in Process or Analyses in Identify and Wait Phase to navigate to a new screen in which you can view and work with the objects found by the analysis projects.

  1. From the Projects table, select an analysis project. Statistics about the number of objects in each lifecycle status are displayed. Depending on your authorizations, you can also edit the analysis.

  2. Under Object Selection Criteria, specify filter criteria for the objects you want to view and choose Get Object List. All objects found by the analysis project that match the specified criteria are displayed. You can leave the criteria blank to display all objects.

  3. Depending on your authorizations, you can select objects and choose the various buttons to perform the following actions:

    • E-Mail Package

      Send e-mail notification to the retirement package owners to inform them that the selected objects are assigned to them for decommissioning.

    • Backup Transport

      Create a backup transport request for the selected objects. Depending on the settings specified during creation of the analysis, a backup transport might be mandatory before deleting objects.

    • Deletion Transport

      Delete the object from the development system and create a deletion transport request for the deleted objects.

    • Change Wait Time

      Specify a different wait time for individual objects. For example, if an object is only intended for use once each year, you might want the wait time for this object to be longer than for the other objects in the analysis.

    • Reject Object

      Remove the selected objects from the list so that they are no longer considered for decommissioning.

    • Details

      Displays the details about the object, for example the author, created-on date, severity.

    • Maintain Attribute

      You can maintain the maintainable object attributes. Choose the desired attribute and enter a value manually.

    • Set Status

      Set the lifecycle status for the selected objects. For example, if an object is recommended for decommissioning, you need to set the Identify & Wait status to start the waiting period and then click Set.

  4. Return to the decommissioning cockpit. When the analysis is complete, you can choose the link in the Completed Analyses screen area to view the results of your analysis and measure the success against the targets defined in the creation step.