Connections > SAP ADSO Writer connection properties
  

SAP ADSO Writer connection properties

When you set up an SAP ADSO Writer connection, configure the connection properties.
The following table describes the SAP ADSO Writer connection properties:
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.
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 and the Data Access Management services.
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.
Note: If you’re using this connection to apply data access policies through pushdown or proxy services, you cannot use the Secret Vault configuration option.
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.
Select a Secure Agent, serverless, or elastic runtime environment.
For more information about how to configure and use the runtime environments, see Runtime environments.
SAP Server Connection Type
The SAP server connection type to use.
Select from the following options:
  • - Application Server Connection. Connect to an SAP Application Server using the SAP user name and password.
  • - Application Server SNC Connection. Connect to an SAP Application Server using the secured network connection:
    • - With X.509 Certificate. You do not need to specify the SAP user name and password explicitly. You must provide the path of the x.509 certificate file.
    • - Without X.509 Certificate. You must provide the SAP user name.
  • - Load Balancing Server Connection. Connect to an SAP Application Server with the least load at run time.
  • - Load Balancing Server SNC Connection. Connect to an SAP Application Server using SNC with the least load at run time.
Note: Before you use an SNC connection, you must verify that SNC is configured both on the SAP Server and the machine where the Secure Agent runs.
The following table describes the properties that must configure when you select Application Server Connection as the connection type:
Connection property
Description
SAP Client Number
The client number of the SAP Server.
SAP Language
Language code that corresponds to the SAP language.
SAP Application Server
The host name of the SAP Application Server.
SAP System Number
The system number of the SAP Server to connect.
SAP Username
The SAP user name with the appropriate user authorization.
SAP Password
The SAP password.
Additional Parameters
Additional SAP parameters that the Secure Agent uses to connect to the SAP system.
For example, to generate SAP JCo and SAP CPIC trace, specify the following properties:
jco.client.trace="1";
jco.client.cpic_trace="3";
During the runtime, the JCo and CPIC traces file 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 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
The following table describes the properties that must configure when you select Load Balancing Server Connection as the connection type:
Connection property
Description
SAP Client Number
The client number of the SAP Server.
SAP Language
Language code that corresponds to the SAP language.
SAP Message Server
The IP address or the host name of the SAP Message Server.
SAP System ID
The system ID of the SAP Message Server.
SAP Group
The login group name, for example, PUBLIC.
SAP Username
The SAP user name with the appropriate user authorization.
SAP Password
The SAP password.
Additional Parameters
Additional SAP parameters that the Secure Agent uses to connect to the SAP system.
For example, to generate SAP JCo and SAP CPIC trace, specify the following properties:
jco.client.trace="1";
jco.client.cpic_trace="3";
During the runtime, the JCo and CPIC traces file 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 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
The following table describes the properties that must configure when you select Application Server SNC Connection as the connection type:
Connection property
Description
SAP Client Number
The client number of the SAP Server.
SAP Language
Language code that corresponds to the SAP language.
SAP Application Server
The host name of the SAP Application Server.
SAP System Number
The system number of the SAP Server to connect.
SNC My Name
Optional. The Informatica client Personal Security Environment (PSE) or certificate name.
Default length is 256.
SNC Partner Name
The Informatica client PSE or certificate name.
Default length is 256.
SNC Quality of Protection (QoP)
Specifies the SAP PSE or certificate name.
You can select from the following options:
  • - 1 - Apply authentication only.
  • - 2 - Apply integrity protection (authentication).
  • - 3 - Apply privacy protection (integrity and authentication).
  • - 8 - Apply the default protection.
  • - 9 - Apply the maximum protection.
Default is 3 - Apply privacy protection (integrity and authentication).
SAP Cryptographic Library Path
The path to the cryptographic library.
Specify sapcrypto.dll for Windows or libsapcrypto.so for Linux.
Use X509 Certificate
Specifies the quality of protection. Select to use X509 Certificate based SNC connection.
X509 Certificate Path or SAP Username
The path to the X509 certificate file.
If you select to use the X509 certificate, specify the path to the X509 certificate file with .crt extension. You do not need to specify the SAP user name and password.
If you do not want to use the X509 certificate, specify the SAP username for which SNC is configured in SAP Server.
Additional Parameters
Additional SAP parameters that the Secure Agent uses to connect to the SAP system.
For example, to generate SAP JCo and SAP CPIC trace, specify the following properties:
jco.client.trace="1";
jco.client.cpic_trace="3";
During the runtime, the JCo and CPIC traces file 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 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
The following table describes the properties that must configure when you select Load Balancing Server SNC Connection as the connection type:
Connection property
Description
SAP Client Number
The client number of the SAP Server.
SAP Language
Language code that corresponds to the SAP language.
SAP Message Server
The IP address or the host name of the SAP Message Server.
SAP System ID
The system ID of the SAP Message Server.
SAP Group
The login group name, for example, PUBLIC.
SNC My Name
Optional. The Informatica client PSE or certificate name generated on the Secure Agent machine.
Default length is 256.
SNC Partner Name
The Informatica client PSE or certificate name generated on the SAP Server.
Default length is 256.
SNC Quality of Protection (QoP)
Specifies the SAP PSE or certificate name.
You can select from the following options:
  • - 1 - Apply authentication only.
  • - 2 - Apply integrity protection (authentication).
  • - 3 - Apply privacy protection (integrity and authentication).
  • - 8 - Apply the default protection.
  • - 9 - Apply the maximum protection.
Default is 3 - Apply privacy protection (integrity and authentication).
SAP Cryptographic Library Path
The path to the cryptographic library.
Specify sapcrypto.dll for Windows or libsapcrypto.so for Linux.
Use X509 Certificate
Specifies the quality of protection. Select to use X509 Certificate based SNC connection.
X509 Certificate Path or SAP Username
The path to the X509 certificate file.
If you select to use the X509 certificate, specify the path to the X509 certificate file with .crt extension. You do not need to specify the SAP user name and password.
If you do not want to use the X509 certificate, specify the SAP user name for which SNC is configured in the SAP Server.
Additional Parameters
Additional SAP parameters that the Secure Agent uses to connect to the SAP system.
For example, to generate SAP JCo and SAP CPIC trace, specify the following properties:
jco.client.trace="1";
jco.client.cpic_trace="3";
During the runtime, the JCo and CPIC traces file 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 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