XI/PI: SAP XI Troubleshooting Guide
Here’s a list of common errors/problems in SAP XI and their possible resolutions. This Guide will help you troubleshoot your integration scenarios in SAP XI/PI. This is in no way an exhaustive list. You can add your points/ideas to this list. Please feel free to post your inputs using the comments form at the end of this article.
Cache Update Problems
Use transaction SXI_CACHE to update the Integration Directory cache. Alternatively, you can use the following URLs to update the CPA cache. Use XIDIRUSER to refresh the cache.
For complete cache refresh - http://<hostname>:<port>/CPACache/refresh?mode=full
For delta cache refresh - http://<hostname>:<port>/CPACache/refresh?mode=delta
If this does not solve the issue, check transaction SLDCHECK to ensure that connection to SLD is available. If the connection fails, check the configuration in the transaction SLDAPICUST. Make sure that the password maintained is correct and the maintained service user is not locked.
Now in the Integration Repository go to Environment → Clear SLD Data Cache. Also go to Integration Directoy and clear the cache using menu Environment → Clear SLD Data Cache.
Open the XI Start Page and click on Administration. On the Repository tab, choose Cache Overview. Refresh the cache using the buttons/icons on the right. Use XIDIRUSER to refresh the cache. Carry out cache refresh in the same way on the Directory and Runtime tabs.
If you are facing cache update problems in your BPM (say you have modified the BPM, but when executed old version of the BPM is picked up instead of the new one), run the transaction SWF_XI_CUSTOMIZING and press F9 carry out automatic BPM/Workflow Customizing.
Routing Errors
- NO_RECEIVER_CASE_BE or NO_RECEIVER_CASE_ASYNC
This means no receiver could be found. Check your Receiver Determination. Activate and update cache. Asysnchronous messages can be manually restarted.
- TOO_MANY_RECEIVERS_CASE_BE
More than one receiver found. Check your ID configuration to ensure that there is exactly one receiver for the synchronous message. Multiple receivers for synchronous interfaces are not permitted.
Mapping Errors
- JCO_COMMUNICATION_FAILURE
Check whether RFC destination AI_RUNTIME_JCOSERVER is correctly configured
- NO_MAPPINGPROGRAM_FOUND
Ensure that mapping program exists and is activated. If it exists then update the cache.
- EXCEPTION_DURING_EXECUTE
This error occurs due to erroneous XML formatting. Check your mapping program and ensure that you supply valid input data.
Messages stuck in queues
Check the queues using transactions SMQ1 (outbound)/SMQ2 (inbound). Resolve the displayed errors. You can cancel the messages from SXMB_MONI. Execute LUW if necessary and avoid deleting entries manually.
Conversion Errors
- Unable to convert the sender service XXXX to an ALE logical system
This error occurs in case of scenarios with IDoc adapters. Whenever you use business systems, make sure that the corresponding logical system name is maintained in the SLD.
Open your business system in the Integration Directory. Switch to Change mode. Access the menu path Service → Adapter Specific Identifiers. Click the button that says ‘Compare with System Landscape Directory’ and chose Apply. Save and activate your change list.
In case of business services, you can manually type a logical system name in the Adapter Specific Identifiers if required. This name should match the corresponding logical system name defined in the partner SAP system’s partner profiles.
Errors on the outbound side
Sometimes the link between SAP XI and the target system (say ERP) goes down and messages fail on the outbound side. It may not be possible to restart them from using RWB or the transactions like SXI_MONITOR/SXMB_MONI. In such cases, you can follow the procedure outlined in the following article - Dealing with errors on the outbound side.
As I said, this is not an exhaustive list. Feel free to add troubleshooting tips that you may have encountered while working with SAP XI. Use the comments form below to add your ideas.



kishore says:
June 22nd, 2008 at 7:38 pm
hello please
provide solution for login error 10061 in sap how to resolve
Thank a lot
Riyaz says:
June 23rd, 2008 at 10:20 am
I dont think this is related to XI…however this link should help you.
XYZ says:
June 24th, 2008 at 5:48 am
This is the following error I am facing when I try to open SLD’s Product or software components
error on page
what to do? How to proceed further? any help would be greatly appreciated…
thanks
Riyaz says:
June 24th, 2008 at 9:56 am
your basis administrator would be able to resolve this
Nutan says:
July 1st, 2008 at 11:16 am
Please provide me details regarding XML payload validation in PI7.1. Whether information is in PI7.0 also. If so then what’s the difference in between both the versions?
Riyaz says:
July 1st, 2008 at 11:36 am
As far as I understand, XML Validation in PI7.1 is nothing but validation of XML structure against an XSD (XML Schema Definition). This functionality is not available in previous versions like PI 7.0, XI 3.0/2.0.
Farooq says:
August 31st, 2008 at 10:27 pm
Hi Riyaz,
I think in this document you can also covers majors sorts of Errors related to Adapters, Mapping, IE, AE and BPM.
For example file adapter: if source DIR is not present, target systems is down, authorization error, invalid message format/xml, java web start is not present etc.
How about making a new section/tab for PI 7.1 and SOA? I beleive these are the emerging areas of SAP.
Keep going with the same pace
Thanks
Farooq
xiuser says:
September 10th, 2008 at 9:29 pm
Hi, first of all sorry for my english.
I have a problem with the adapters,
in the integration builder when i have to edit communication channel template, i can’t see any adapter metadata.
Do you know what can i do to have a list of adapters?I don’t know if i am doing something wrong or it’s a problem with the xi configuration.
thanks
Riyaz says:
September 11th, 2008 at 4:57 pm
Hi,
Check if you have installed the adapters and that the corresponding services for the adapters are active in the Visual Admin.
Are you able to see the list in ID?
Regards,
Riyaz
Hari says:
September 21st, 2008 at 4:57 am
Hi Riyaz,
We migrated Configuration and mapping to our PROD environment. when I run the SXI_CACHE on the ABAP stack of XI in PRD, it shows the Logical system of QAS and SID#client# of QAS as technical system. As a result the out bound idoc from PRD business system is not making it to integration server. The error I am getting in SM58 of Business system is “No services found for PRD client 400″.
Do you know where the SXI_CACHE in XI gets the business system and Technical system from? I have checked the SLD and it looks good. I do not think , there is anything in IR or ID where the Techncical system is specified, may be I am wrong? Please confirm.
The short term solution was to change the entry in SSRVSERVICE table for Technical system from QAS#320 to PRD#400. I am still NOT able to determine the rootcause of why SXI_CACHE in Prod. Integ. srever brings the QAS#320 instead of PRD#400, do you have any thoughts?
Cheers,
Hari
Riyaz says:
September 23rd, 2008 at 9:32 am
Hi Hari,
Run transaction RZ70 on communicating sap system to ensure that the technical system information is up to date.
Also, when you imported the configuration objects in ID, did you update the communcation channels? Also make sure that the Adapter specific identifiers of the business system as displayed in ID are correct. If not, switch to change mode and update the same using Update from SLD button.
Let me know if this helps.
Regards,
Riyaz
JT says:
November 27th, 2008 at 5:14 pm
Hi Riyaz,
We have a Legacy system that will FTP xml data files to the XI server (Eg. In directory /tmp/inbound/data ). From there, the file will be processed and generate IDOC. Then, the XML file will be archieved to another directory (Eg. /tmp/inbound/data/processed ) for those successed file.
But now, all the XML file were stuck in the original directory. Which seems like it never will be processed. (All the while it was working fine).
I am new with the XI - and now totally no idea on how to check for this.
Could you please advise what i can do to get the “process” run?
Any T-code can be used to trigger the “process”??
Appreciate if you can help to advise on this.
Thank you very much.
Riyaz says:
November 28th, 2008 at 1:22 pm
You can check the adapter status and the communication channel log in the Runtime Workbench. Go to Component Monitoring in RWB and choose your adapter engine. Then click on Communication Channel Monitor button and check the status of your sender file adapter. You will find the specific error information there.
Hope this helps.
Regards,
Riyaz
Rizwan says:
February 10th, 2009 at 2:58 am
Hi! Riyaz
I have configured alerts in ALRTCATDEF.
Also, i am getting error notification in my alert Inbox.
However, I would like to get this mails in regular corporate email a/c.
Can you please provide the steps i need to configure in SCOT and also SUO1.
Thank you very much,
Riz
Riyaz says:
February 10th, 2009 at 9:54 pm
Hi Rizwan,
In ALRTCATDEF, select your alert and then choose fixed recipients. Add the SAP user id of the person who should receive the alerts. Save your changes.
Use SU01 to maintain corpoarate email id for the above user and set the communication method as email.
This should send an email to the corporate email a/c. Ofcourse the SMTP setting should be configured on your XI server. If it isnt, get in touch with your basis administrator who should be able to assist you.
Hope this helps.
Regards,
Riyaz
Aaron says:
February 17th, 2009 at 8:20 pm
Hello Riyaz,
In Runtime Workbench when viewing Cluster Node Details there is a column called Short Log. Is there such thing as a Full Log which migh have more useful information?
In my case for a brand new com channel I am seeing “Error during channel initialization; exception trace: {1}” and I’m wondering where to look for more clues about what XI doesn’t like about it.
By the way, your website is very good and it has helped me understand a lot of things so far.
Many thanks,
Aaron
Rajkumar says:
February 24th, 2009 at 7:17 am
Hi Riyaz,
I created my own alter configuration in ALRTCATDEF and then also setup my corp email id in SU01 and also done the setup in SCOT. Finally used this in Se38 i used this(RSALERTTEST) program and chose my alter category which i created in ALRTCATDEF. An test alert id is getting created but i’m not getting any email. Initially i had a doubt abut the SMTP server name, so contacted Basis team, they tested from their side and got a test message when they test. Not sure how they tested. Can you please tell me why i’m not getting an email when i test with my ‘alter catergory’ in ABAP program RSALERTTEST.
Raj.
J B says:
March 4th, 2009 at 5:41 pm
Hi Riyaz
I have come across an error “It is not possible to configure the selected XI domain because the Integration Server does not exist or could not be read from the SLD”. And also no dropdown is available for Integration Server (Component Monitoring Tx- SXMB_IFR-> Runtime Workbench -> Component Monitroing) Can you suggest a solution for this issue
Riyaz says:
March 5th, 2009 at 5:38 pm
I would suggest to check the entries in the SLD. XI server must have entries in the Business/Technical System. Also, associations must be setup correctly. Verify the CIM data in SLD. Get in touch with your basis team if you are unable to access these components.
reddy says:
March 13th, 2009 at 3:44 pm
Hi RIYAZ,
Hi,
Error while access Integration repository in DEVLOPMENT systemin SAP PI 7.0 But i am able to loging to integration directory (ID)
i am using PISUPER user which have ROLE as SAP_XI_IR_SERV_USER
plz give me the solution ASAP
Following Error Message occurred as follows:
* cannot open connetion on host:173.26.242.105 and port 50304
* com.sap.aii.utilxi.misc.api. Reconnect Runtime Exception
Thanks In Advance.
Regards,
JT says:
March 16th, 2009 at 3:13 pm
Hi Riyaz,
I am facing problem in the XI server which the Message having error
JCO_SYSTEM_FAILURE & JCO_COMMUNICATION_FAILURE.
All the subsequent message will stuck in XI server.
After we restart the XI server, it will be OK.
This had happened twice.
My question:
1. May i know what is the Root cause that causing the error occur? (as Most of the time it works fine)
2. Is there any long term solution for this? What we can do to prevent this? Because restarting the Server seems like not the correct solutions.
Please help to advise.
Thanks in advance.
Raghu says:
March 30th, 2009 at 9:46 pm
Hi Riyaz
I am getting a problem when i am using sxmb_ifr tcode. I am not able to open XI page getting error enterprize sever address is not maintained. I just installed PI 7.1 and i dont know the post install activities. Can you please send a proper steps on the same
thanks in advance
Raghu
Archana Singhai says:
May 11th, 2009 at 6:02 pm
Hi,
We have a outgoing Purchase Order interface from XI to one of our Vendors.
We have the relevant certificate installed at our end like other vendors.
However, ever so often, the outgoing message ends in error with the message:
ICM_HTTP_CONNECTION failed.
There have not been any changes made at our end and neither any changes have been made at the Vendor’s end.
Once I had read in the SDN forums, that in this scenario, the soft restart of the ICM monitor helps to eliminate the issue and this actually has helped us in the reprocessing of the messages in error.
I still do not have any idea as to why this happens with ONLY this vendor.
It would be nice if some one could shed some light on this.
Regards,
Archana
XIkiller says:
July 2nd, 2009 at 2:23 pm
When i am trying to logon into ID/IR, then i am getting authorization error. I am able to logon into ABAP stack. What kind of role i need to have in my profile to get into Java Stack. Please let me know.
Thanks
sriram says:
August 5th, 2009 at 3:18 pm
Hi,
I am getting the following errors frequently in message monitoring,Can you provide me root causes.
1.Problem while determining receivers
2.Unauthorized Authorization error while sending by HTTP
3.Error when getting an FTP connection from connection pool: Unable to create new pooled resource:
and also give me a resolution for this.
Thanks
sriram
SKUMAR says:
August 10th, 2009 at 1:48 pm
If I have 100 files in a folder, if XI comes and picking the files from the folder, while picking 50 files connection was lost in between and they are remaining 50 files are there to pick, in this scenario what happens after connection established XI will collect remaining 50 files or again it starts from first.
Can anyone answer this question with explanation.
Archana says:
August 10th, 2009 at 6:22 pm
Hi Riyaz,
First of all, thanks for all the great topic posted by you.
I regularly check your site for updated and additional topics.
I have the below scenario:
File (free text) is being received in XI
Based on certain file ocntents, i have to make a lookup in R/3 and get some value back.
This value will determine the folder location in R/3 where the received file will be placed.
For this, I have made an ejb module to make a look up in R/3, a RFC FM in R/3 making the selection and returning the output.
The code on its own is working but in conjunction with the ejb, the value returned is null.
This is giving jull exception in the channel which has the module configured.
How can I make this work?
Please advise.
Also, there is another scenario where the complete configuration is working fine along with the BPM message but in this particular scenario, the BPM is not sending emails to users even though there is no error.
The email address are configured but still no mail notification for the success or error status.
Can you please give some suggestions or pointers?
Thanks and Regards,
Archana
Samiuddin Syed says:
September 3rd, 2009 at 9:08 am
Hi Riyaz,
How are you doing?
I have 2 seperate SLD’s each one for DEV n QAS environment and I have synchronised both SLD’s using export/import as the version am using is 7.0.
As both the SLD’s are in sync and have the same landscape data, I have configured groups and Transport targets for the business systems.
For Dev environment:
Business system name: ISR_BUSINESSSYSTEM Group: DEV_Group
For QAS environment:
Business system name: ISR_BUSINESSSYSTEM_QAS Group: QAS_Group
Mapping of Transport targets:
ISR_BUSNESSSYSTEM–>ISR_BUSINESSSYSTEM_QAS
The above is done and now when am trying to do transports for Integration builder objects from DEV to QAS then during import am getting an error.
ERROR: “obligatory transport target for business system ISR_BUSINESSSYSTEM not found in system landscape directory”
According to my XI guy, he says the business system name used in transports should be same for both DEV n QAS business systems. Where as I do not see this scenario of same business system name, I have searched the forums but all speaks about the same way I have configured using groups n transports targets.
Please advise to rectify the error of transport.
Cheers,
Samiuddin Syed
Riyaz says:
September 3rd, 2009 at 11:04 am
Have a look at Transporting Business Systems section here - http://www.riyaz.net/?p=321
Jay says:
October 26th, 2009 at 12:31 pm
Hi,
We are using PI 7.1
I have done all the setups , but while testing the configuration, i am getting an execption : Premature end of file in the Interface Determination & mapping step.
How to resolve that.
I have verified all the Mappings and seems to be correct.
Riyaz says:
October 27th, 2009 at 10:42 am
Check this out: http://www.riyaz.net/forums/topic.php?id=50#post-123
Adnan Maqbool says:
December 13th, 2009 at 2:47 pm
Dear Riaz
I am getting error that NO_MAPPING_PROGRAM_FOUND in Moni. How can i resolved the issue where mapping program is located and what is the correct way of reading the moni.
ram says:
December 15th, 2009 at 11:02 pm
Hi Riaz,
I am getting problem while checking the communication channel monitoring.
When i click any button in adapeter engine , it showing page cant be displayed.
Could you please tell me how to resolve this
Ram
Pal Somogyi says:
December 21st, 2009 at 3:38 pm
Hi Riyaz,
we have a sender RFC scenario,where we use a TCP/IP channel toward XI from our SAP system. SAP system is on 4.6C and we have PI 7.1. We have setup the TCP/IP channel in SAP and also the Comm. channel in XI. However, when we execute a Connection test it says:
No such file or directory (/usr/sap/ICX/SYS/exe/run/,
where Program ID is the ID we are using in TCP/IP channel.
Could you please help what can be the problem?
Many thanks.
Pal
Riyaz says:
December 21st, 2009 at 4:27 pm
Hi,
See ‘Testing the Connectivity’ section in the following article: http://www.riyaz.net/?p=42. This will help you identify the issue.
Hope this helps.