Connect to SAP ODP

Property	Description
Connection Name	Name of the connection. Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -, Maximum length is 255 characters.
Description	Description of the connection. Maximum length is 4000 characters.
Type	SAP ODP Extractor
Use Secret Vault	Stores sensitive credentials for this connection in the secrets manager that is configured for your organization. This property appears only if secrets manager is set up for your organization. This property is not supported by Data Ingestion and Replication. When you enable the secret vault in the connection, you can select which credentials that the Secure Agent retrieves from the secrets manager. If you don't enable this option, the credentials are stored in the repository or on a local Secure Agent, depending on how your organization is configured. For information about how to configure and use a secrets manager, see Secrets manager configuration.
Runtime Environment	The name of the runtime environment where you want to run tasks to access SAP S/4HANA or SAP ECC. Select a Secure Agent or serverless runtime environment. For more information about how to configure a serverless environment, see Use the serverless runtime environment.

SAP server connection types

Application server connection

Application server connection is the default type which requires your SAP client details.

The following table describes the basic connection properties for an application server connection:

Connection property	Description
SAP Client Number	The client number of the SAP application server. Get the required client number from the SAP system to which you want to connect.
SAP Language	Language code that corresponds to the SAP language. Get the required language code from the SAP system to which you want to connect.
SAP Application Server	The host name of the SAP application Server.
SAP System Number	The system number of the SAP application server to connect. Get the required system number from the SAP system to which you want to connect.
SAP Username	The user name with the appropriate user authorization to connect to the SAP account.
SAP Password	The password to connect to the SAP account.
Subscriber Name	A name that defines the Secure Agent as a unique subscriber in the SAP system. SAP uses this name to define unique operational delta queue (ODQ) in case of delta read from ODP.

Application server SNC connection

Application server SNC connection requires the Secure Agent PSE certificate name, SAP server PSE certificate name, and path to the X509 certificate file along with your SAP client details.

The following table describes the basic connection properties for an application server SNC connection:

Connection property	Description
SAP Client Number	The client number of the SAP application server. Get the required client number from the SAP system to which you want to connect.
SAP Language	Language code that corresponds to the SAP language. Get the required language code from the SAP system to which you want to connect.
SAP Application Server	The host name of the SAP application Server.
SAP System Number	The system number of the SAP application server to connect. Get the required system number from the SAP system to which you want to connect.
SNC My Name	The agent Personal Security Environment (PSE) or certificate name generated for the Secure Agent. Default length is 256.
SNC Partner Name	The server PSE or certificate name generated on the SAP server. Default length is 256.
SNC Quality of Protection (QoP)	The level of protection applied to a communication path when you create an SAP SNC connection. Select one of the following options from the list: - 1 - Apply authentication only - 2 - Apply authentication and integrity protection - 3 - Apply authentication, integrity, and privacy protection (encryption) - 8 - Apply global default protection (usually 3) - 9 - Apply the maximum protection Default is 3 - Apply authentication, integrity, and privacy protection (encryption).
Use X509 Certificate	Method of logging in. Select Use X509 Certificate to log in with SNC encryption that uses the X.509 certificate. If you don't select this option, you need to enter your SAP user name in the X509 Certificate Path or SAP Username property. Default is disabled.
X509 Certificate Path or SAP Username	The path and file name of the X509 certificate file. If the X509 certificate file name is abc.crt and the path is \root\<folder name>, enter both the path and file name in the following format: \root\<folder name>\abc.crt If you select to use the X509 certificate, you don't need to enter the SAP user name. If you don't want to use the X509 certificate, enter the SAP user name for which SNC is configured in the SAP server.
Subscriber Name	A name that defines the Secure Agent as a unique subscriber in the SAP system. SAP uses this name to define unique operational delta queue (ODQ) when the Secure Agent reads delta data from ODP.

The following table describes the advanced connection properties for application server SNC connection:

Property	Description
SAP Cryptographic Library Path	The path and file name of the SAP cryptographic library. Enter both the path and file name in the following format based on the operating system on which the Secure Agent runs: - On Windows: \root\<folder name>\sapcrypto.dll - On Linux: /root/<folder name>/libsapcrypto.so

Load balancing server connection

Create a load balancing server connection when you want to connect to the SAP system with the least load at run time.

Load balancing server connection requires your SAP client details and message server group name.

The following table describes the basic connection properties for a load balancing server connection:

Connection property	Description
SAP Client Number	The client number of the SAP message server. Get the required client number from the SAP system to which you want to connect.
SAP Language	Language code that corresponds to the SAP language. Get the required language code from the SAP system to which you want to connect.
SAP Message Server	The host name of the SAP message server.
SAP System ID	The system ID of the SAP message server. Get the required system ID from the SAP system to which you want to connect.
SAP Group	The name of the SAP logon group through which you want to connect. For example, PUBLIC.
SAP Username	The user name with the appropriate user authorization to connect to the SAP account.
SAP Password	The password to connect to the SAP account.
Subscriber Name	A name that defines the Secure Agent as a unique subscriber in the SAP system. SAP uses this name to define unique operational delta queue (ODQ) when you read delta data from ODP.

Load balancing server SNC connection

Create a load balancing server SNC connection when you want to connect to the SAP system using the (SNC) protocol with the least load at run time.

Load balancing server SNC connection requires the Secure Agent PSE certificate name, SAP server PSE certificate name, and path to the X509 certificate file along with your SAP client details and message server group name.

The following table describes the basic connection properties for a load balancing server SNC connection:

Connection property	Description
SAP Client Number	The client number of the SAP message server. Get the required client number from the SAP system to which you want to connect.
SAP Language	Language code that corresponds to the SAP language. Get the required language code from the SAP system to which you want to connect.
SAP Message Server	The host name of the SAP message server.
SAP System ID	The system ID of the SAP message server. Get the required system ID from the SAP system to which you want to connect.
SAP Group	The name of the SAP logon group through which you want to connect. For example, PUBLIC.
SNC My Name	The agent PSE or certificate name generated for the Secure Agent. Default length is 256.
SNC Partner Name	The server PSE or certificate name generated on the SAP server. Default length is 256.
SNC Quality of Protection (QoP)	The level of protection applied to a communication path when you create an SAP SNC connection. Select one of the following options from the list: - 1 - Apply authentication only - 2 - Apply authentication and integrity protection - 3 - Apply authentication, integrity, and privacy protection (encryption) - 8 - Apply global default protection (usually 3) - 9 - Apply the maximum protection Default is 3 - Apply authentication, integrity, and privacy protection (encryption).
Use X509 Certificate	Method of logging in. Select Use X509 Certificate to log in with SNC encryption that uses the X.509 certificate. If you don't select this option, you need to enter your SAP user name in the X509 Certificate Path or SAP Username property. Default is disabled.
X509 Certificate Path or SAP Username	The path and file name of the X509 certificate file. If the X509 certificate file name is abc.crt and the path is \root\<folder name>, enter both the path and file name in the following format: \root\<folder name>\abc.crt If you select to use the X509 certificate, you don't need to enter the SAP user name. If you don't want to use the X509 certificate, enter the SAP user name for which SNC is configured in the SAP server.
Subscriber Name	A name that defines the Secure Agent as a unique subscriber in the SAP system. SAP uses this name to define unique operational delta queue (ODQ) when you read delta data from ODP.

The following table describes the advanced connection properties for load balancing server SNC connection:

Property	Description
SAP Cryptographic Library Path	The path and file name of the SAP cryptographic library. Enter both the path and file name in the following format based on the operating system on which the Secure Agent runs: - On Windows: \root\<folder name>\sapcrypto.dll - On Linux: /root/<folder name>/libsapcrypto.so

Advanced settings

Property	Description
Additional Parameters	Additional SAP parameters that you can use when you connect to the SAP system. You can enter multiple additional parameters, separated by semicolon, in the following format: <parameter name1>=<value1>;<parameter name2>=<value2>;<parameter name3>=<value3>.... For example, to generate SAP JCo and SAP CPIC trace files, enter the following additional parameters: jco.client.trace="1";jco.client.cpic_trace="3"; During the run time, the SAP JCo and SAP CPIC trace files are generated in the following location: <Informatica Secure Agent installation directory>\apps\Data_Integration_Server\<DIS version>\ICS\main\bin\rdtm During the design time, the SAP CPIC traces are generated in the tomcat.out files at the following location: <Informatica Secure Agent installation directory>\apps\Data_Integration_Server\<DIS version>tomcat.out
Display Delta Fields	Specifies whether the mapping displays the operation modes that caused the changed data on ODP sources. When enabled, the mapping generates the ODQ_CHANGEMODE and ODQ_ENTITYCNTR fields on the Fields tab for ODP sources that are enabled with Operational Delta Queue (ODQ). Default is disabled.

Property

Description

Additional Parameters

Additional SAP parameters that you can use when you connect to the SAP system.

You can enter multiple additional parameters, separated by semicolon, in the following format:

<parameter name1>=<value1>;<parameter name2>=<value2>;<parameter name3>=<value3>....

For example, to generate SAP JCo and SAP CPIC trace files, enter the following additional parameters:

jco.client.trace="1";jco.client.cpic_trace="3";

During the run time, the SAP JCo and SAP CPIC trace files are generated in the following location:

<Informatica Secure Agent installation directory>\apps\Data_Integration_Server\<DIS version>\ICS\main\bin\rdtm

During the design time, the SAP CPIC traces are generated in the tomcat.out files at the following location:

<Informatica Secure Agent installation directory>\apps\Data_Integration_Server\<DIS version>tomcat.out

Display Delta Fields

Specifies whether the mapping displays the operation modes that caused the changed data on ODP sources.

When enabled, the mapping generates the ODQ_CHANGEMODE and ODQ_ENTITYCNTR fields on the Fields tab for ODP sources that are enabled with Operational Delta Queue (ODQ).

Default is disabled.