Skip to Content
Before we start, recommended read – Fault Message Type from SAP Help document.

In this blog we will see how to configure a fault message for an asynchronous scenario and how it can be used in monitoring of the message flow.

Note : An Extract from the online help says “The fault message of the application for an asynchronous ABAP server proxy is persisted for monitoring. In the case asynchronous of Java server proxies, the fault message is part of a negative application acknowledgement.”

Lets take the scenario of a File -> XI -> ABAP Proxy. The scenario is so designed that the file will contain a SAP user name and this will be passed to the ABAP proxy via XI. Inside the ABAP proxy, we do two types of checks and trigger the fault message.

1. If there is no entry for the user in the file.
2. If the user specified in the file does not exist in the USR01 table.

The Development:

The Data Type:



The Message type:

1. MT_UserNameFromFile
2. MT_UserName

Use DT_UserName for these message types.

The Fault Message type


The Message Interface:

1. MI_UserNameFile


2. MI_UserNameAndException


Make the message mapping between MT_UserNameFromFile & MT_UserName and also the corresponding Interface mapping.

In the configuration go ahead as you configure any File to Proxy scenario.

In your R3, generate the proxy for the inbound interface, MI_UserNameAndException.

The screenshot below shows that the fault message type that was used in the inbound interface is reflected in the exceptions tab under Methods in your Class generated for the inbound proxy.




ZEXCHANGE_FAULT_DATA structure inside the proxy


In our proxy we will be sending the user to a custom ‘Z’ table after a check in the USR01 table. Else we need to handle two exceptions as mentioned earlier ie;

1. If there is no entry for the user (blank user) in the incoming file.
2. If the user specified in the file does not exist in the USR01 table.

The following code will illustrate how the above is acheived;


Now let us test the scenario and see how the system reacts.

1. File contains a user entry that exists in USR01 table.

So as we expect in R3 -> SXMB_MONI, we have the Success Flag 🙂


2. No user specified in the file (blank entry)

Ok … now here pops up the icon for “Application Error (Restart Possible)”.


Navigate and inside you find the error message;


And if you open the MainDocument for the payload you will find the descriptive error caught by the exception.


3. User specified in the file does not exist in USR01

Everything happens as described above. Only thing that changes is the MainDocument message content.


So that would have given you a grasp on fault message types and its usage. You could now explore more and put them to your use.
In the next part let us use the fault messages in Synchronous scenarios and see how they behave.

A Special thanks to good friend and my guide in profession, Jayakrishnan Nair who helped me in bringing out this blog.

To report this post you need to login first.


You must be Logged on to comment or reply to a post.

    1. Shabarish Vijayakumar Post author
      Thnx Naveen 🙂

      Well, actually i did see your blog before but my personal thought was tht it was more on a high level thought. I was thinking of putting up one with specific details on the sync scenario!!!

      What do u think ?


  1. Vijayakanth Vangala

    I tried the scenario as it is in this article but the message always shows a checkered flag insted of the light bolt. Is there some thing else we need to do to get this ?


      1. Vijayakanth Vangala
        I did raise the exception. Here is the code I put in the server proxy:

        DATA: standard_data     TYPE  zexchange_fault_data,
              detail_data       TYPE  zexchange_log_data.

            standard_data-fault_text   = ‘An Exception has occured’.
            standard_data-fault_url   = ‘’.
            detail_data-severity       = ‘High’.
            detail_data-text           = ‘Test of fault message type’.
            detail_data-id             = ’01’.
            detail_data-url            = ‘Usernull’.

            APPEND detail_data TO standard_data-fault_detail.

        RAISE EXCEPTION TYPE zcx_fmt_num
        *    TEXTID =
        *    PREVIOUS =
        *    AUTOMATIC_RETRY =
        *    CONTROLLER =
        *    NO_RETRY =
            STANDARD = standard_data


Leave a Reply