How To Fix ESH_IEF_MSG126 - A "generated program" based transport is not allowed in a Customer-system

SAP Error Message - Details

• Message type: E = Error

• Message class: ESH_IEF_MSG - Import/Export Framework

• Message number: 126

• Message text: A "generated program" based transport is not allowed in a Customer-system

What causes this issue?

Search models of software components delived by SAP, can be updated
using Enhancement Packages (EhP),Service Packages (SPS) or SAP-Notes
only. After an update of a search model, existing connectors based on
this model shall be updated (Connector Administration Cockpit).

System Response

The registration of a Software Component for "generated program" based
transport (SNOTE) in a system set as customer system is denied.

How to fix this error?

To get model updates, implement the SAP note corresponding to the update
for the requested SAP Software Component using Note Assistant
(Transaction SNOTE). Afterwards launch the Cockpit and check if there
are connectors flagged as "Modified". For all such connectors, perform
an update, selecting the corresponding connectors and executing
"Actions" -> "Update".
Every time you get an update of a search model (using Upgrade, Update or
SAP-Notes) check the import log for the Software Component (Modeler for
Search and Analytics, menu "Actions->Import Log"). If errors are
displayed, create a customer message for the support component of the
model.
To transport customer defined models, saving will ask you to provide a
transport request. The whole SW comp. will be added to the request
(transport object R3TR SEST).

Procedure for System Administrators

Error message extract from SAP system. Copyright SAP SE.

Smart SAP Assistant

• What is the cause and solution for SAP error message ESH_IEF_MSG126 - A "generated program" based transport is not allowed in a Customer-system ?

  The SAP error message ESH_IEF_MSG126 indicates that a transport request containing a "generated program" is not allowed in a customer system. This typically occurs in the context of SAP's Enterprise Search or similar components where certain generated objects cannot be transported due to system restrictions or configuration settings.
  Cause:
  
  Transport Restrictions: SAP has certain restrictions on transporting generated programs or objects in customer systems to prevent inconsistencies or issues that may arise from moving generated content between different environments (e.g., development to production).
  System Configuration: The system may be configured to disallow the transport of certain types of objects, particularly those that are generated dynamically or are environment-specific.
  Development Guidelines: SAP's guidelines may dictate that certain objects should not be transported to ensure that they are generated in the target environment based on the specific configuration and data of that environment.
  
  Solution:
  
  Check Transport Request: Review the transport request to identify the generated program or object that is causing the issue. You may need to remove it from the transport request.
  Manual Creation: If the generated program is essential, consider manually creating it in the target system instead of transporting it.
  Consult Documentation: Refer to SAP documentation or notes related to the specific component (e.g., Enterprise Search) to understand the best practices for handling generated programs.
  Adjust Configuration: If applicable, consult with your SAP Basis team to see if there are configuration settings that can be adjusted to allow for the transport of certain objects, though this is generally not recommended.
  SAP Support: If the issue persists or if you believe it is a system error, consider reaching out to SAP Support for further assistance.
  
  Related Information:
  
  SAP Notes: Check for any relevant SAP Notes that may provide additional context or solutions for this specific error message.
  Transport Management: Familiarize yourself with SAP's transport management system and guidelines for transporting objects, especially generated ones.
  Development Best Practices: Ensure that your development practices align with SAP's recommendations to avoid similar issues in the future.
  
  By following these steps, you should be able to address the error message ESH_IEF_MSG126 effectively.