docs.intersystems.com
Home  /  Application Development: Using Adapters and Gateways in Productions  /  Using the SAP Java Connector in Productions  /  Setup Tasks


Using the SAP Java Connector in Productions
Setup Tasks
[Back]  [Next] 
InterSystems: The power behind what matters   
Search:  


Before you can use the SAP components in a production, you must perform several setup activities. This chapter discusses them:
To access SAP, it is necessary to provide a username and password. This means that you must also create production credentials that contain an SAP username and password. For information on creating credentials, see Configuring Productions.
Setting Up the Java Gateway
For information on setting up the Java Gateway, see Prerequisites in Using the Java Gateway in Productions.
Installing the SAP JCo Jar File
Obtain, from SAP, the SAP Java Connector 3.x, as appropriate for your operating system. Generally, this is provided as a compressed file. Uncompress it and place the contents in a convenient location. The directory should contain the following items:
Generating Proxy Classes for SAP JCo
To communicate with SAP JCo, your interoperability-enabled namespace must contain proxy classes that represent SAP JCo. To generate these classes, do the following:
  1. Start the Java Gateway.
    The easiest way to do this is as follows:
    1. Create a simple production that contains only one business host: EnsLib.JavaGateway.Service.
      Configure the settings for this business host so that it can find the Java Gateway. For information, see Using the Java Gateway in a Production in Using the Java Gateway in Productions.
    2. Start the production, which starts the Java Gateway.
    For other ways to start the Java Gateway, see Using the Java Gateway in Productions.
  2. In the Terminal, change to your interoperability-enabled namespace and use the ImportSAP() method of EnsLib.SAP.BootStrap, as follows:
    do ##class(EnsLib.SAP.BootStrap).ImportSAP(pFullPathToSAPJarFile,pPort,pAddress)
    Where:
Testing the SAP Connection
To test the SAP connection, do the following in the Terminal (or in code):
  1. Create an instance of EnsLib.SAP.Utils.
  2. Set the following properties of that instance. These are string properties unless otherwise noted.
  3. Call the PingSAP() method of your instance. This method connects to SAP and performs a dynamic invocation of the STFC_CONNECTION function. It returns a %Status.