Setting up a SAP connection

This section describes how to set up a SAP connection, if you plan to develop mobile applications using the SAP framework.

To set up the SAP connection you must:

• Configure the SAP connection using the SAP Java Connector (SAP JCo). SAP JCo is a toolkit that allows a Java application to communicate with any SAP system. The SAP Java Connector can be downloaded from the SAP Service Marketplace Web site by a registered SAP customer.

• Modify the global.properties.xml file to enable SAP and identify ConnectionPools.

• Create a property file for each ConnectionPool, and configure connection properties.

Details for each of these steps are provided in the procedures that follow. Once this is done, a SAP element can be created in Mobile Web Studio’s Application Builder. See the Mobile Application Development Tutorial and the Unwired Accelerator Developer’s Guide for information about using the SAP element.

Configuring the SAP Java connector

1. Open a Web browser window and enter the SAP Marketplace URL, currently:

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

   The Client Authentication window displays.

2. Select the certificate to use when connecting, and click OK. The Enter Network Password window displays.

3. Enter your registered SAP customer user name and password in the User Name and Password fields, and click OK. The SAP Service Marketplace window displays.

4. Select the SAP Java Connector link, and follow the installation instructions provided by SAP. When prompted, copy the .jar and .dll files to these locations:

   • Copy sapjco.jar to:

     Tomcat

     %SYBASE%\UnwiredAccelerator70\tomcat\webapps\onepage \WEB-INF\lib

     EAServer

     %JAGUAR%\EAServer\Repository\WebApplication\Onepage \WEB-INF\lib

   • Copy librfc32.dll and sapjcorfc.dll to:

     Tomcat

     %SYBASE%\UnwiredAccelerator70\jdk1.4\jre\bin

     EAServer

     %JAGUAR%\Shared\jdk1.4.2_06\jre\bin

5. Close the Web browser.

6. Change to the following directory:

   Tomcat

   %SYBASE%\UnwiredAccelerator70\tomcat\webapps\onepage \WEB-INF\classes

   EAServer

   %JAGUAR%\EAServer\Repository\WebApplication\onepage\WEB-INF\classes

7. As a backup, save a copy of the sapjco.properties file to a name such as template.sapjco.properties.

8. Using a text editor, open the sapjco.properties file and edit it for your environment. The SAP wizard uses information in the sapjco.properties file to connect to your SAP system.

   Check the documentation that comes with the JCO package for information about the 30-40 properties you can set to define a SAP connection. Specifically see the Javadocs for the JCO.createClient (java.util.Properties) method. The six most commonly used properties are included in the file as a sample (for example, jco.client.client=400).

9. Save the file and close it.

Modifying the global.properties.xml file for SAP

Modify the SAP-related properties in global.properties.xml.

• ConnectionPools – a comma-separated list of connection pool names. Each connection pool must have a poolname.properties file defined as described in “Creating ConnectionPool property files”.

• DefaultConnectionPoolName – identifies the connection pool to use for the default SAP connection.

1. In a text editor, open global.properties.xml, located in %SYBASE%\UnwiredAccelerator70\tomcat\webapps\onepage\config if you are using Tomcat and %JAGUAR%\EAServer\Repository\WebApplication\Onepage\config if you are using EAServer.

2. Search the file for SAPGroup.

3. Look for: <Property name="DefaultConnection PoolName".

   By default, DefaultConnectionPoolName is set to “sapjco.”

   <Property name="DefaultConnectionPoolName" value="sapjco" description="connection pool name for the default SAP connection" menugroup="100" /> </PropertyGroup>

   Determine which ConnectionPool to use as the default SAP connection from the list, and change the value as necessary.

4. Save the file and close it.

Creating ConnectionPool property files

For each ConnectionPool listed in the global.properties.xml file, there should be a poolname.properties file in %SYBASE%\UnwiredAccelerator70\tomcat\onepage\WEB-INF\classes. Use the sapjco.properties file (or template.sapjco.properties file) as a base, and modify the ConnectionPool connection properties, using information in the JCO package Javadocs as a guide.

1. In a text editor, open sapjco.properties (located in %SYBASE%\UnwiredAccelerator70\tomcat\webapps\onepage \WEB-INF\classes).

2. Save the file in the same directory, using the following naming format:

   poolname.properties
   

   Substitute one of the ConnectionPool names you established in the global.properties.xml file for poolname.

3. Modify the file by setting up the connection properties for the SAP connection. The following properties are included in the file as an example. Check the Javadocs for information about these properties, and many more.

   jco.client.client=400
   jco.client.user=sap
   jco.client.passwd=1sap
   jco.client.lang=EN
   jco.client.ashost=sap.try.sybase.com
   jco.client.sysnr=00
   

4. Save the file and close it.

Copyright © 2005. Sybase Inc. All rights reserved.

View this book as PDF