Hidden Tools in SAP XI/PI – BATCH file to launch ESR/ID frameworks
The motive of this blog is to introduce one of the hidden tools in SAP XI/PI, which I found recently when I am investigating on “why mapping export (XIM files) functionality is disabled in latest SAP PI(>=7.1) releases?”. Unfortunately, I could not find a short cut for PI7.3 version, but however I could find it for PI7.1 version (it is, CTRL+SHIFT+ALT 0 in mapping editor).
Apart from this, I found one more interesting hidden tool (applicable from XI version >= 3.0) which can be quite useful to debug/understand repository and directory frameworks loading mechanism, logging, exceptions etc. I believe, SAP uses this tool internally for debugging purposes during product development 😉
In this blog, I will explain how to launch ESR/ID with a batch file with little extra configuration and few other benefits of this hidden tool.
- Open ESR/IR using XI main page. http://<xihostname>:<port>/rep (or) /dir for PI >= 7.1
- Open any existing mapping/create a fresh one
- Go to mapping Test Tab -> and then press CTRL+SHIFT+ALT J. A new window as shown below will be launched.
- Change the folder path if required (For this blog, I am using the default folder option c:\TempIbJars )
- Now copy the IR/ESR path from XI main page into Step 3, JNLP file URL text box and then click execute button.
- We can use some of the downloaded jars for java mapping development/adapter module development. E.g., aii_map_api.jar for PI <= 7.0)/ com.sap.xpi.ib.mapping.lib.jar for PI >= 7.1 version, com.sap.aii.af.lib.mod.jar for adapter module development. Especially, in case of java mapping developments, no need to request BASIS team for mapping jar/download from SAP marketplace/use custom abap reports to download mapping jar from IX server.
- Just to add, we can also download jar files by pointing browser with each jar resource (jar files can be found in JNLP description file) e.g., http://<XIserver>:<port>/rep/repository/com.sap.xpi.ib.mapping.lib.jar
- Few other interesting jars,
- The IR, ID batch DOS consoles clearly shows logging status while launching frameworks and then for each action after launch. This will help developers to closely understand what is happening in the background.
Custom ESR/ID application title:-
04/24/2013, 6:19 PM GMT (Custom ESR/ID application title, request from Dingjun)
- Modify the batch file to force the system variable jnlp.SAPMYNAME value and then pass it to java run time as java -Djnlp.SAPMYNAME=”%jnlp.SAPMYNAME%” as shown in below snap shot.
Result will be as below 🙂
Have fun with the newly explored IR/ESR, ID batch file tools 🙂 and provide your valuable feedback
My new blog with JNLP files: http://scn.sap.com/community/pi-and-soa-middleware/blog/2013/04/25/hidden-tools-functionality-with-esrid-jnlp-files