XI/PI FAQ (Frequently Asked Questions)

[MichalKrawczyk]

last FAQ update: 27.10.2006

For the latest/updated version of this FAQ check out - http://mypigenie.com

Integration Engine

1. How can I retrieve MESSAGE_ID from a BPM?
2. I cannot see some of my messages in SXMB_MONI
3. I have an error: "Unable to convert the sender service to an ALE logical system"
4. Can I use alert with variables from the messages payload?
5. How can I implement dynamic mail address with XI mail adapter?
6. ICM_HTTP_TIMEOUT error
7. I got "message waiting in queue" status of my messages
8. I have a problem with the cache on XI
9. There's something wrong with my Integration Process - it has code other then 0 and it's not working
10. I've changed my service user password - but now I see it's not changed completely - what should I do?
11. Unable to check flight availability - status code 500 error
12. I have a problem with namespaces in XI - Is there a way to remove them?
13. The Link "alert configuration" from RWB is not working
14. My ABAP proxy from Application system is not working
15. I have a null pointer exception in XI
16. My alerts don't work - what should I check?
17. I cannot update my CPA cache - which authorizations do I need to do it?
18. How can I unlock a locked object in the Integration Builder?
19. How can I access the lite version Message monitoring tool?
20. How can I monitor the CPA cache?
21. I cannot logon to the Visual Administrator
22. My PMI doesn't work
23. How should I use Message Packages?
24. How can I use correlation in a BPM?
25. How do I start and stop the XI correctly?
26. How can I get message statistics from the ABAP engine?
27. I see an error "Unable to connect to the Integration Builder" while trying to create ABAP Proxies - what can I do?
28. My EOIO messages are stuck what can I do?
29. Is there any way I can upload and test an xml message from file?
30. Is there any way I can do a tag search of an XI message without using a TREX?
31. How to use the enhanced receiver determination?
32. I have a timeout error in my scenario what can I do?
33. How can I transport objects created on older XI's SP level?
34. I have an HTTP error - what should I check?
35. How can I do a stress test in the XI? (NEW 27.10.2006)
36. How can I work with XI and DMZ? (NEW 27.10.2006)

Mappings
1. I have a problem with mapping - are there any guides on this subject?
2. How can I use GlobalContainer - in graphical mapping?
3. How can access technical context object?
4. How should I test my mappings ?
5. Where can I find aii_map_api.jar to create my Java mapping?
6. How can I transform XML into a string?
7. How can I use XSLT with ABAP engine?
8. Are there any how to documents describing standard mapping functions?
9. How can I test user advanced functions in NWDS?
10. I have problems with testing large idocs in the message mapping test tool.
11. Can I use multimappings without the BPM?
12. How can I throw exceptions in message mappings?
13. How to analyze mapping problems?
14. How to analyze problems with value mappings?
15. Are there any RFC API examples?
16. Which mapping type should I use?
17. How can I use my jar files in all software components?
18. How can I do a unit test of my mappings?(NEW 27.10.2006)
19. How to test my java mappings?(NEW 27.10.2006)

Adapters
1. I have a problem with sending RFC from R/3 to XI
2. How do I use 'Apply Control Record Values from Payload' parameter with the IDOC adapter?
3. I can't see my adapters in the adater monitoring after the import of a new SP
4. Where can I find J2SE plain Adapter
5. How can I access filename from File/FTP Sender Adapter
6. Where can I find FAQ on adapters?
7. Where can I find examples on Adapter module development?
8. Where can I find http adapter test tool?
9. How can I access adapter monitor?
10. I'd like to develop my own adapter - how can I test the sample adapter?
11. How can I dynamically set some parameters in the adapter configuration?
12. Which value should I fill in the RFC sender adapter for Program ID parameter?
13. What is the SOAP action value in the SOAP receiver adapter?
14. Where can I find JAR files for creating java proxies?
15. How can I debug my abap proxy?
16. Adapter Engine returns HTTP 401 under high load what can I do? (NEW 27.10.2006)
17. How can I work with profile other then LS with IDOC Adapter?(NEW 27.10.2006)

Software Landscape Directory - SLD
1. I got error message "SLDAccess set to true, but not available".
2. I want to change the number of System Landscape Direcotries
3. How do I define dependencies?
4. How can I access SDL logs?

Documents
1. Where can I find document templates for XI?
2. Are there some problem guides for XI scenarios?
3. Where can I find BPM related weblogs?
4. Where can I find IDOCs related weblogs?
5. Where can I find JDBC related weblogs?
6. Where can I find XI "How to..." documents on service.sap.com?
7. Where can I find XI "Admin Check"?
8. How does software logistics look like in XI?
9. How to use acknowledgments with Java Proxies?
10. How to use ABAP proxies with attachments?
11. Which Transaction codes can I use with the XI?
12. How to start working with Conversion Agent from Itemfield?
13. Where can I find XI best practices? (UPDATED 27.10.2006)
14. I would like to use EDI with XI how can I do it?


Books
1. Are there any books about the XI/PI? (NEW 27.10.2006)

Integration Engine
https://weblogs.sdn.sap.com/cs/blank/edit/wlg/1. How can I retrieve MESSAGE_ID from a BPM?

Take a look at this weblog:
XI: How to... retrieve MESSAGE_ID from a BPM

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/2. I cannot see some of my messages in SXMB_MONI

Take a look at this weblog:
XI: I cannot see some of my messages in the SXMB_MONI

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/3. I have an error: "Unable to convert the sender service to an ALE logical system"

Take a look at this weblog:
XI Error - Unable to convert the sender service to an ALE logical system

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/4. Can I use alert with variables from the messages payload?

Take a look at this weblog:
Alerts with variables from the messages payload (XI) - UPDATED

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/5. How can I implement dynamic mail address with XI mail adapter?

Take a look at this weblog:
Mail Adapter (XI) - how to implement dynamic mail address

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/6. ICM_HTTP_TIMEOUT error

There are two ways of changing this timeout:

a) check out note: 824554 and try to change it in the instance profile

b) TCODE SXMB_ADM -> Configure Integration server -> change specific identifiers
Set Runtime parameter: HTTP_TIMEOUT

Rember to restart XI after the change

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/7. I got "message waiting in queue" status of my messages

You need to register the Queues

TCODE SXMB_ADM -> Manage Queues -> Register the Queues.
Or run program: RSXMB_REGISTER_QUEUES

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/8. I have a problem with the cache on XI

Check this "how to" document from sapNET - login required:
How To handle Caches in SAP XI 3.0

Take a look at this weblog:
Cache Refresh Errors - New Phenomena

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/9. There's something wrong with my Integration Process - it has code other then 0 and it's not working

a) check if you have all entries green in TCODE - SWF_XI_CUSTOMIZING

b) you may try to repeat the activation of the integration process in TCODE - SXI_CACHE.

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/10. I've changed my service user password - but now I see it's not changed completely - what should I do?

Take a look at note: 721548
XI 3.0: Changing the passwords of the XI service users

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/11. Unable to check flight availability - status code 500 error

Check if all clients except Integration server are set as application servers:

a) TCODE - SXMB_ADM

b) Integration Server configuration

c) set the "Role of Business System" as LOC "Application system"

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/12. I have a problem with namespaces in XI - Is there a way to remove them?

The message namespace has a default value taken from the Software Component Version namespace.
If you want to delete it:

a) go to the Message type that you're using in your scenario

b) remove XML namespace

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/13. The Link "alert configuration" from RWB is not working

a) on your XI box go to TCODE - SE38 and run program - RSXMB_ACTIVATE_ICF_SERVICES

b) check SAP note: 750287 (XI 3.0 Runtime Workbench: Alert configuration does not start) and change values in your ExchangeProfile

c) check if you can accept cookies

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/14. My ABAP proxy from Application system is not working

Take a look at "XI Configuration guide" section:
"Connecting Business Systems with an Integration Engine to the Central Integration Server"
and maintain the "dest://" in TCODE: SXMB_ADM for the application system

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/15. I have a null pointer exception in XI

Take a look at these notes:
859465 - NullPointerException in DTR/XI running on AIX
817049 - XI 3.0 SP10 Mail Adapter (Receiver/Outbound) authentication
801868 - Java(TM) Web Start in XI 3.0: FAQ/Troubleshooting

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/16. My alerts don't work - what should I check ?

Take a look at those weblogs:
XI: Alerts - Troubleshooting guide

XI: Alerts - Step by step

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/17. I cannot update my CPA cache - what authorizations do I need to do it?

Take a look at this note:
741214 - Troublesh. during cache update of the J2EE CPACache service

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/18. How can I unloack a locked object in the Integration Builder?

Directory:
http://server:port/dir/support/public/LockAdminService

Repository:
http://server:port/rep/support/public/LockAdminService

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/19. How can I access the like version Message monitoring tool?

Lite MDT:
http://server:port/MessagingSystem/monitor/monitor.jsp

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/20. How can I monitor the CPA cache?

Display:
http://server:port/CPACache/monitor.jsp

History:
http://server:port/CPACache/history.jsp

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/21. I cannot logon to the Visual Administrator

Take a look at this PAG:
Visual Administrator: Logon Failure

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/https://weblogs.sdn.sap.com/cs/blank/edit/wlg/22. My PMI doesn't work

Take a look at this PAG:
No Data From PMI Java Agents

23. How should I use Message Packages?

Take a look at this weblog:
XI:Idoc Message Packages

24. How can I use correlation in a BPM?

Take a look at this weblog:
sravya.talanki2/blog/2005/08/24/do-you-like-to-understand-147correlation148-in-xi

25. How Should I start and stop the XI correctly?

Take a look at this note:

870864 - Starting and Stopping an XI 3.0 System

26. How can I get message statistics from the ABAP engine?

Take a look at a report attached to this note:

746088 - Statistics on XI messages for Remote Services

27.I see an error "Unable to connect to the Integration Builder" while trying to create ABAP Proxies - what can I do?

Take a look at this weblog:
How do you activate ABAP Proxies?

28. My EOIO messages are stuck what can I do?

Take a look at this weblog:
How to deal with stuck EOIO messages in the XI 3.0 Adapter Framework

29. Is there any way I can upload and test an xml message from file?

Take a look at this weblog:
Simulating XI Messages-Proto

30. Is there any way I can do a tag search of an XI message without using TREX?

Take a look at these weblogs:
ABAP based Trex in XI: Proto

Super Message Monitor for SAP XI

31. How to use enhanced receiver determination?

Take a look at this weblog:
Illustration of Enhanced Receiver Determination - SP16

32. I have a timeout error in my scenario what can I do?

Take a look at this weblog:
XI: Timeouts, timeouts, timeouts....

33. How can I transport objects created on older XI's SP level?

Take a look at this SAP note:
735306 - Transporting XI repository objects to the SWCV level

34. I have an HTTP error - what should I check?

Take a look at this weblog:
Http* Errors in XI

35. How can I do a stress test in the XI?

Take a look at this weblog:
XI : Simulating Extreme Concurrent Message Volume

36. How can I work with XI and DMZ?

Take a look at this page:
XI Network zones



Mappings
https://weblogs.sdn.sap.com/cs/blank/edit/wlg/1. I have a problem with mapping - are there any guides on this subject?

take a look at those presentations from SAP:

Exchange Infrastructure - Graphical Advanced Mapping

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/2. How can I use GlobalContainer - in graphical mapping?

Take a look at this weblog:
GlobalContainer - in graphical mapping (XI)

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/3. How can access technical context object?

Take a look at this weblog:
Simple java code in graphical mapping - XI

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/4. How should I test my mappings ?

Take a look at this weblog:
XI: How to test your mapping (in real life scenarios)

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/5. Where can I find aii_map_api.jar to create my Java mapping?

Go to your XI server folders and use this path:

j2eeclusterserver0appssap.comcom.sap.xi.services

Inside com.sap.xi.services folder you'll find the jar file.

6. How can I transform XML into a string?

Take a look at this weblog:
XI: XML node into a string with graphical mapping?

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/7. How can I use XSLT with ABAP engine?

Take a look at this weblog:
Using ABAP XSLT Extensions for XI Mapping

8. Are there any how to documents describing standard mapping functions?

Take a look at those weblogs:
The Use of "suppress" in the XI 3.0 Graphical Mapping Tool

New functions in the Graphical Mapping Tool XI 3.0 SP13

Message Mapping Simplified - Part I

sravya.talanki2/blog/2005/12/08/message-mapping-simplified-150-part-ii

9. How can I test user advanced functions in NWDS?

Take a look at this weblog:
The specified item was not found.

10. I have problems with testing large idocs in the message mapping test tool.

Consider using reduced IDOCs

Take a look at this note:

709400 - Performance problems with large IDocs in mapping tool

11. Can I use multimappings without the BPM?

If you have SP14 then this is possible


Take a look at this weblog:
jin.shin/blog/2006/02/07/multi-mapping-without-bpm--yes-it146s-possible

12. How can I throw exceptions in message mappings?

Take a look at this weblog:
Throwing Smart Exceptions in XI Graphical Mapping

13. How to analyze mapping problems?

Take a look at this note:

801951 - XI30: Analyzing mapping problems

14. How to analyze problems with value mappings?

Take a look at this note:

858766 - XI30: Analysis of value mapping problems

15. Are there any RFC API examples?

Take a look at this weblog:
SAP XI Lookup API: the Killer

16. Which mapping type should I use?

Take a look at this weblog:
Comparing Performance of Mapping Programs

17. How can I use my jar files in all software components?

Create one base software component in which you import
your JAR files and then create dependencies to
all other software components in which you want to use those JAR files

18. How can I do a unit test of my mappings?

Take a look at this weblog:
Detroubulator version 1.0 is out

19. How to test my java mappings?

Take a look at this weblog:
Testing and Debugging Java Mapping in Developer Studio

Adapters
https://weblogs.sdn.sap.com/cs/blank/edit/wlg/1. I have a problem with sending RFC from R/3 to XI

Take a look at this weblog:
Configuring the Sender RFC Adapter - step by step

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/2. How do I use 'Apply Control Record Values from Payload' parameter with the IDOC adapter?

See notes:
a) 728792 - how the fields in the control record get set.
b) 792333 for an overview of how to convert partners in the IDoc adapter.

Also check:

Fields of the IDoc Control Record

XI: IDOC Adapter - EDI_DC40 - demystified

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/3. I can't see my adapters in the adater monitoring after the import of a new SP

a) try reimporting "SAP Basis software component"

b) take a look at the XI installation guide on how to do it: "Importing the XI Content for Software Component Version SAP Basis 6.40"

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/4. Where can I find J2SE plain Adapter


https://websmp106.sap-ag.de/swdc

Then this path:

- Support Packages and Patches
- - SAP NetWeaver
- - - SAP NETWEAVER
- - - - SAP NETWEAVER 04
- - - - Entry by Component
- - - - - XI Adapter Engine J2SE
- - - - - - XI CONNECTIVITY SE 3.0
- - - - - - - OS independent

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/5. How can I access filename from File/FTP Sender Adapter

Take a look at this weblog:
XI: The same filename from a sender to a receiver file adapter - SP14

Develop a module for file adapter and use the code from this SAP note:
819761 - XI 3.0 File Sender: Accessing source file name from a module

Copy a file with same filename using XI

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/6. Where can I find FAQ on adapters?

Take a look at this note:
821268 - XI 3.0 Adapter Framework: Overview of available FAQ notes
inside you'll find all available FAQ SAP notes.

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/7. Where can I find examples on Adapter module development?

Copy a file with same filename using XI

Read Excel instead of XML through FileAdapter

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/8. Where can I find http adapter test tool?

/message/266750#266750 [original link is broken]

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/9. How can I access adapter monitor?

Try this link:
http://xiserver:j2eeport/mdt/amtServlet

10. I'd like to develop my own adapter - how can I test the sample adapter?

Take a look at this weblog:

Testing Sample Adapter

11. How can I dynamically set some parameters in the adapter configuration?

Take a look at this weblog:

Dynamic Configuration of Some Communication Channel Parameters using Message Mapping

12. Which value should I fill in the RFC sender adapter for Program ID parameter?

Take a look at this weblog:

Troubleshooting - RFC and SOAP scenarios *** Updated on 20/04/2009 ***

13. What is the SOAP action value in the SOAP receiver adapter?

Take a look at this weblog:

Troubleshooting - RFC and SOAP scenarios *** Updated on 20/04/2009 ***

14. Where can I find JAR files for creating java proxies?

you can find them on your XI/PI server in folders:

aii_proxy_xirt.jar
j2eeclusterserver0 inextcom.sap.aii.proxy.xiruntime

aii_msg_runtime.jar
j2eeclusterserver0 inextcom.sap.aii.messaging.runtime

aii_utilxi_misc.jar
j2eeclusterserver0 inextcom.sap.xi.util.misc

guidgenerator.jar
j2eeclusterserver0 inextcom.sap.guid

15. How can I debug my abap proxy?

Take a look at this weblog:

XI: Debug your inbound ABAP Proxy implementation

16. Adapter Engine returns HTTP 401 under high load what can I do?

Take a look at this sap note:
821026 - AdapterEngine messaging URL returns HTTP 401 under high load

17. How can I work with a profile other then LS with IDOC Adapter?

Take a look at this weblog:

Wanna Party ?

Software Landscape Directory - SLD
https://weblogs.sdn.sap.com/cs/blank/edit/wlg/1. I got error message "SLDAccess set to true, but not available".

Go to SLD:
http://server:port/sld/ListServlet?bsview=true
Business systems and check if your XI business system has correct "Pipeline URL" parameter defined:
http://server:httpport/sap/xi/engine?type=entry
also check TCODE -> SLDCHECK - if you don't have any errors over there

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/2. I want to change the number of System Landscape Direcotries

Check this "how to" document from sapNET - login required:
HowTo handle SLD and XI

also check this SAP note:
720717 - Reduce the number of System Landscape Direcotries (SLD)

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/3. How do I define dependencies?

XI: Are you Independent...from your dependencies?

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/4. How can I access SDL logs?

Use this link:
http://server:port/sld/admin/log.jsp

Documents
https://weblogs.sdn.sap.com/cs/blank/edit/wlg/1. Where can I find document templates for XI?

Take a look at this weblog:
XI - SAP's document templates

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/2. Are there some problem guides for XI scenarios?

Take a look at this weblog:
XI - Problem Analysis Guide - Have you seen this?

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/3. Where can I find BPM related weblogs?

Walkthrough with BPM

RFC Scenario using BPM --Starter Kit

XI: How to... retrieve MESSAGE_ID from a BPM

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/4. Where can I find IDOCs related weblogs?

Introduction to IDoc-XI-File scenario and complete walk through for starters.

Configuration steps required for posting idoc's(XI)

Convert any flat file to any Idoc-Java Mapping

File to Multiple IDocs (XSLT Mapping)

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/5. Where can I find JDBC related weblogs?

FILE to JDBC Adapter using SAP XI 3.0

JDBC Stored Procedures

RDBMS system integration using XI 3.0 JDBC Sender/Receiver adapter

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/6. Where can I find XI "How to..." documents on the service.sap.com?

XI How to... documents

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/7. Where can I find XI "Admin Check"?

XI Admin Check

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/8. How does software logistics look like in XI?

XI Software Logistics 1: SLD Preparation

XI Software Logistics II: Overview

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/9. How to use acknowledgments with java proxies?

https://weblogs.sdn.sap.com/pub/wlg/3531 [original link is broken] [original link is broken] [original link is broken] [original link is broken]

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/10. How to use ABAP proxies with attachments?

XI: RFC or ABAP Proxy ? ....ABAP Proxies with attachments

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/11. Which transactions can I use with the XI?

Getting started with XI, part 1: XI 3.0 cheat sheet

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/12. How to use ABAP proxies with attachments?

How to get started using Conversion Agent from Itemfield

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/13. Where can I find XI best practices?

SAP Exchange Infrastructure best practices

The D-XIE Soap part 1: basic principles with XI in the middle

The D-XIE Soap part 2: XI design decisions for synchronous or asynchronous messaging

D-XIE Soap part 3: Determine Software Component Version of standard SAP IDocs and RFMs

D-XIE Soap part 4: XI Software Component Architecture for Point-to-Point Scenarios

Structuring Integration Repository Content - Part 1: Software Component Versions

https://weblogs.sdn.sap.com/cs/blank/edit/wlg/14. I would like to use EDI with XI how can I do it?

Thoughts on EDI in an SAP XI Environment - Article

If you want to process EDI you with XI
you need to use some third party tool
like: SAP conversion Agent, or Seeburger's EDI adapter, etc.

Books
https://weblogs.sdn.sap.com/cs/blank/edit/wlg/1. Are there any books about the XI/PI?

XI: New book: Mastering IDoc Business Scenarios with SAP XI by Michal Krawczyk @ Michal Kowalczewski

SAP Exchange Infrastructure by Jens Stumpe and Dr. Joachim Orb

Mastering SAP XI Administration by Marcus Banner and Heinzpeter Klein


********************************************************
This FAQ is also available on my own site:

SAP XI FAQ

********************************************************