Replace Configuration Parameters for SAP Suite adapter for JCo 3.x

You can replace the configuration settings of SAP Suite adapter 2 .x with the new settings of SAP Suite adapter for JCo 3 .x from the Administration menu.

About this task

Perform the following steps to replace the existing configuration settings of SAP Suite adapter 2.x with the new configuration settings of SAP Suite adapter for JCo 3.x in Sterling B2B Integrator:

Procedure

  1. From the Administration menu, select Deployment > Services > Configuration.
  2. Under List, select S next to Alphabetically and click Go.
  3. From the list of services, select edit next to SAP Suite adapter.
  4. Note the global configuration parameters of the adapter type ‘SAP Suite Adapter'.
  5. Navigate to Deployment > Services > Configuration
  6. In the Services Configuration page, click Go next to Create New Service.
  7. In the Select Service Type page, type ‘SAP Suite Adapter for JCo 3.x' in the Service Type field. You can also click on the Tree View or List View icons to select the service type.
  8. Click Next.
  9. In the Name page, enter a name and description for the new service instance. You can use the name of the adapter instance configured for SAP Suite adapter (for JCo 2.x) and append ‘_30' at the end of the instance name.
  10. Click Next.
  11. In the SAP Integration Mode page, configure the SAP Integration Mode, Document Storage type, and loadbalanced settings based on the global configuration parameters of the SAP Suite adapter (for JCo 2.x) instance you have noted. You can set the value of Document Storage Type to System Default.
    Document Storage Type is a new parameter for SAP Suite adapter for JCo 3.x. Select the document storage type where the documents are persisted. Valid values are System Default (default), Database, and File System. In SAP suite adapter (for JCo 2.x), the document storage type is defined in the sap.properties file.
  12. Click Next.
  13. If you selected Yes for SAP system is loadbalanced parameter, configure the settings for SAP Message Server, R/3 Name, and SAP Group based on the global configuration parameters of the SAP Suite adapter (for JCo 2.x) instance you have noted. If you selected No for SAP system is loadbalanced parameter, configure the settings for SAP Application Server and SAP System Number based on the global configuration parameters of the SAP Suite adapter (for JCo 2.x) instance you have noted.
  14. Additionally, configure the following new parameters added for SAP Suite adapter for JCo 3.x if the SAP Integration Mode is BAPI or RFC. If the BAPI or RFC contains special characters in the parameter names or data that is not valid in XML, enable Special Character Handling in XML Tags or Special Character Handling in XML Nodes or both. In SAP suite adapter (for JCo 2.x), these parameters are defined in the sap.properties file.
    Option Description
    Special Character Handling in XML Tags (XMLSpecialCharHandling) New parameter for SAP Suite adapter for JCo 3.x. Required for BAPI and synchronous RFC modes. Handles invalid characters in XML tags. Valid values are Yes and No. The default value is No.
    Special Character Handling in XML Nodes (XMLNodesSpecialHandling) New parameter for SAP Suite adapter for JCo 3.x. Required for BAPI and synchronous RFC modes. Handles invalid characters in XML nodes. Valid values are Yes and No. The default value is No.
    Enable verbose logging for XML processing (XMLNodesSpecialHandling) New parameter for SAP Suite adapter for JCo 3.x. Required for BAPI and synchronous RFC modes. Enables verbose logging support during XML processing.
  15. Click Next.
  16. Configure the Connection Retry Settings to connect to a SAP R/3 system:
    Option Description
    Max. Connection Retries (0=unlimited) New parameter for SAP Suite adapter for JCo 3.x. Required. Specify the maximum number of retries to connect to the remote SAP system. When the maximum number is exceeded, the adapter start ends with an error. The default value is 0 (unlimited).
    Retry Connection Interval (seconds): New parameter for SAP Suite adapter for JCo 3.x. Required. Specify the delay interval between two subsequent connection retries in seconds. The default value is 60 seconds.
  17. Click Next.
  18. In the SAP User page, configure the SAP user settings Group based on the global configuration parameters of the SAP Suite adapter (for JCo 2.x) instance you have noted and click Next.
    The maximum length of the password is extended to 40 characters for SAP Suite adapter for JCo 3.x.
  19. Configure the RFC Server (Outbound) settings based on the configuration parameter of the SAP Suite adapter (for JCo 2.x) instance you have noted and click Next.
    If you do not select Start RFC Server automatically, the application skips the settings for RFC Server (Outbound).
  20. This step is applicable if you enabled Start RFC Server automatically in the previous page. In the Start SAP Server to receive outbound calls from SAP page, configure the Gateway Host and Gateway Service parameters based on the configuration settings defined in the SAP Application Server Host or Message Server Host parameters in the SAP Suite adapter (for JCo 2.x) instance and click Next.
    Additionally, configure the following new parameters added for SAP Suite adapter for JCo 3.x.
    Option Description
    RFC Server Connection Count New parameter for SAP Suite adapter for JCo 3.x. A value of greater than 1 allows parallel outbound processing of server instances.
    RFC Server Minimum Thread Count New parameter for SAP Suite adapter for JCo 3.x. Defines the minimum number of JCo Server worker threads for receiving calls from SAP. The default value is 1. If JCo Server is idle, the specified number of minimum threads are kept running in the thread pool.
    RFC Server Maximum Thread Count New parameter for SAP Suite adapter for JCo 3.x. Defines the maximum number of JCo Server worker threads in the thread pool. To enable parallel outbound processing, use a value greater than 1. The default value is 2. It is recommended you use a value of 4 to process a high number of small messages.
  21. In the RFC Outbound page, configure the settings based on the settings configured for all registered remote function calls or BAPI defined in the SAP Suite adapter (for JCo 2.x instance) you have noted. These functions are registered in the JCo Server and can be invoked by SAP through Sterling B2B Integrator.
  22. Click Next.
  23. Specify the Connection Pool settings and click Next. The following are new parameters for SAP Suite adapter for JCo 3.x to define the Connection Pool settings:
    Option Description
    Connection Pool Capacity (PoolCapacity) Required. Maximum number of idle connections kept open. The default value is 4.
    Connection Peak Limit (ConnPeakLimit) Required. Maximum number of simultaneous connections that are active. The default value is 4.
    Connection Expiration Time (ConnExpirationTime) Required. Time (in seconds) after which the idle connections can be closed. The default value is 300 seconds.
    Connection Expiration Time Check Period (ConnExpTimeCheckPeriod) Required. Check interval (in seconds) for expired connections. The default value is 30 seconds.
    Maximum time to wait for a connection (MaxGetClientTime) Required. Maximum time to wait for a connection after peak limit is reached. The default value is 300 seconds.
    In the default configuration, 4 connections to SAP are kept open even if the system is idle for longer than the value set in Connection Expiration Time. If the value set in the Connection Peak Limit parameter is reached, and an additional call is run with a delay longer than the value set for the Maximum time to wait for a connection parameter, the connection pool returns an exception and the call ends in an error. To resolve this issue, increase the value of the Connection Peak Limit parameter.
  24. In the User page, specify the configuration settings defined for a Sterling B2B Integrator user for running outbound business processes configuration parameters of the SAP Suite adapter (for JCo 2.x) instance you have noted and click Next.
  25. In the Confirm page, review the settings for SAP Suite adapter for JCo 3.x and click Finish.