Configuring an SAP connection configuration file - 7.3

SAP
Version
7.3
Language
English
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
Data Governance > Third-party systems > Business applications > SAP components
Data Quality and Preparation > Third-party systems > Business applications > SAP components
Design and Development > Third-party systems > Business applications > SAP components

You can connect to multiple SAP systems through a Talend SAP RFC Server by creating an SAP connection configuration file under the $TSAPS_HOME/conf/named-connection directory for each of the connections (where $TSAPS_HOME corresponds to the directory where the Talend SAP RFC Server has been installed). An SAP connection configuration file consists of three sections. Before starting Talend SAP RFC Server, you can configure SAP connection configuration files to enable some additional features of the server according to your needs.

Note:
  • Talend SAP RFC Server doesn't support the SAP cluster configuration.
  • Any change of the configuration file requires a restart of the Talend SAP RFC Server.
Note:
  • The $TSAPS_HOME/conf/named-connection directory and SAP connection configuration files are necessary only if you have applied Patch_20210820_TDI-45536_v1-7.3.1.
  • You can customize the path to the $TSAPS_HOME/conf/named-connection directory by setting the named.connections parameter in the tsap-rfc-server.properties file.

Feature section

The Feature section details the connection information to enable functionalities involving the Talend SAP RFC Server.

feature.idoc.enabled: Enables the IDoc feature.

feature.idoc.transactional: Enables the transactional management feature.

  • Reports the entire transaction as a failure to SAP when a message does not get delivered to the JMS broker.
  • Automatically reconnects to the remote JMS broker.

feature.idoc.transactionAbortTimeOut: Refers to the IDOC package processing timeout value in milliseconds.

feature.idoc.mock.enabled: Replaces the IDOC receiver with a mock, which produces an IDOC package every 5 seconds. Not used for SAP servers.

feature.bw_source_system.enabled: Enables the BW source system feature.

feature.bw_source_system.mock.enabled: Replaces the BW source with a mock, which produces a BW data request every 5 seconds. Not used for SAP servers.

feature.streaming.enabled: Enables the streaming mode features (requires a remote connection to a Kafka cluster)

Note: Install a Kafka server version 2.1 onwards prior to using the streaming mode feature. For more information, refer to http://kafka.apache.org/quickstart.

feature.streaming.timeout: Refers to the timeout value for the streaming to start.

feature.streaming.limit.parallel: Maximum number of data streams that can be extracted in parallel. A value of -1 does not limit the number of data streams.

feature.streaming.threadCount: The number of threads for data extraction. The default is 2.

feature.streaming.topic.partitionCount: Kafka topic partition count. The default is 2.

feature.streaming.topic.replicationFactor: Kafka topic replication factor. The default is 1.

Note:
  • The feature.streaming.threadCount, feature.streaming.topic.partitionCount, and feature.streaming.topic.replicationFactor parameters are effective only if you have installed the Talend SAP RFC server shipped with R2020-08 Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.
  • The feature.bw_source_system.mock.enabled and feature.streaming.limit.parallel parameters are effective only if you have applied Patch_20210820_TDI-45536_v1-7.3.1.

SAP JCO server section

The SAP JCO Server section details the SAP information the RFC server needs to connect through RFC calls to SAP.

  • jco.server.gwhost: SAP gateway host on which the RFC server should be registered (mandatory).
  • jco.server.gwserv: SAP gateway service, i.e. the port used for the registration (mandatory).
  • jco.server.progid: Identifier for IDoc on the gateway and as the destination in the SAP system (mandatory).
  • jco.server.connection_count: Number of connections registered at the gateway (mandatory).
  • jco.server.worker_thread_count: Number of threads that can be used by the JCOServer instance.
  • jco.server.worker_thread_min_count: Number of threads that are kept running by the JCOServer instance.
  • jco.server.trace: Enables or disables the RFC trace, this is useful for debugging.
  • destination_name=RFC destination : Sets the RFC destination. You need to set this parameter when the RFC destination differs from its program ID. With this parameter enabled, the value of this parameter is used as the import parameter IV_RFC_DESTINATION of BAPI /CMT/TLND_TABLE_JOIN_STREAM. Otherwise, the program ID (jco.server.progid) is used as the import parameter.
Note: The #destination_name=RFC destination parameter is effective only if you have installed the Talend SAP RFC server shipped with R2020-10 Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.

SAP JCO client section

The SAP JCO client section includes the connection information to the SAP ABAP server. You need all the options provided and you can use the credentials of the user with RFC call rights.

Set the password in clear text, which is then overwritten with the # number sign value when the Talend SAP RFC Server starts.