Client Connection Configuration Reference

Depending on the client connection type you selected, the runtime configurations of the client connection are different.

Configure the client connection according to the following information:

• Runtime Configurations for Dedicated Application Server
• Runtime Configurations for Load Balancing
• Runtime Configurations for Secure Network Connection
• Advanced Tab

The options in Advanced Tab are still the same for all types of client connections.

Runtime Configurations for Dedicated Application Server

When Dedicated Application Server is selected as the client connection type, the runtime configuration is as described in the following table.

Client Connection - Dedicated Application Server - Run-Time Inbound Tab

Name

Description

Application Server

The machine that hosts SAP applications.

System Number

SAP system number.

Client

SAP client number.

username

The valid username that logs on to the specified SAP client.

Password

The valid password corresponding to the username.

R/3 Logon Language

The language used by the adapter to set up connection to the SAP system.

R/3 Code Page

The character sets used by the SAP system and database.

The value of this field is null by default. You need not enter a value for it.

Note: If the value of this field is not null in the project of a prior version, after you migrate a project to the version 7.3, the value becomes null.

Test Connection

Click this button to test the connection of your configuration.

Note: For every client connection pool, you need to do a connection test in order to validate the configuration. If the connection is invalid, an error occurs during the startup of adapter.

Runtime Configurations for Load Balancing

When Load Balancing is selected as the client connection type, the runtime configuration is as described in the following table.

Client Connection - Load Balancing - Run-Time Inbound Tab

Name

Description

System Name

The SAP/R3 system ID used in conjunction with the load balancing connection.

For example, to use the load balancing connection, the client machine initiating the request must have a service named SAPmsXXX defined on the system, where XXX is the value of systemName. The default service value is 3600/tcp.

Msg Server

The message server in conjunction with the load balancing connection.

For example, SAPSVR.

Logon Group

The SAP logon group in conjunction with the load balancing connection. For example, PUBLIC.

In the SAP system, names of logon groups are case sensitive.

When starting multiple adapter instances using the same SAP logon group, you need stagger the start times for adapter instances.

Client

SAP client number.

username

The valid username that logs on to the SAP client.

Password

The valid password corresponding to the username.

R/3 Logon Language

The language used by the adapter to set up connection to the SAP system.

R/3 Code Page

The character sets used by the SAP system and database.

The value of this field is null by default. You need not enter a value for it.

Note: If the value of this field is not null in the project of a prior version, after you migrate a project to the version 7.3, the value becomes null.

Test Connection

Click this button to test the connection of your configuration.

Note: For every client connection pool, you need to do a connection test in order to validate the configuration. If the connection is invalid, an error is shown during the startup of the adapter.

Runtime Configurations for Secure Network Connection

When SNC is selected as the client connection type, the runtime configuration is as described in the following table.

For more information on SNC parameters, see Working with Secure Communication or go to the documentation website of SAP.

Client Connection - SNC - Run-Time Inbound Tab

Name

Description

Application Server

The machine hosting SAP applications.

System Number

SAP database instance number.

SNC Mode

SNC activation indicator.

Set the value to 0 to disable the SNC connections.

Set the value to 1 to enable the SNC connections.

SNC Partnername

SNC name of the communication partner, which is an application server.

SNC QOP

Quality of protection.

Set the value to 1 to apply authentication only.

Set the value to 2 to apply integrity protection.

Set the value to 3 to apply privacy protection.

Set the value to 8 to apply the default protection.

Set the value to 9 to apply the maximum protection.

SNC Lib

The library of the external security product.

Client

SAP client number.

username

The valid username logs on to the specified SAP client.

Password

The valid password corresponds to the username.

R/3 Logon Language

The language used by the adapter to set up connection to the SAP system.

R/3 Code Page

The character sets used by SAP and database.

The value of this field is null by default. You need not enter a value for it.

Note: If the value of this field is not null in the project of a prior version, after you migrate a project to the version 7.3, the value becomes null.

Test Connection

Click this button to test the connection of your configuration.

Note:

  • For every client connection pool, you need to do a connection test in order to validate the configuration. If the connection is invalid, an error occurs during the startup of the adapter.

  • When testing a SNC client connection after a successful connection test within the same TIBCO Designer session, you also can receive a successful confirmation even though the connection parameters are incorrect. To avoid this situation, it is recommended that you close the project and reopen the project.

  • To enable/disable SSO add adr3.clientConnection.snc.disableSSO property to adr3.tra file as per the requirement. Set value as ON or OFF.

Advanced Tab

The advanced configuration is as described in the following table.

Client Connection - Advanced Tab

Name

Description

Maximum Number of Reconnect Attempts

The maximum number of times the adapter retries to establish a connection to the SAP system. By default, it is set to 3. This has to be greater than or equal to the value in the Number of Reconnect Attempts Before Suspending Impacted Service(s) field. For reconnect to continue forever, set the value to -1.

Interval Between Reconnect Attempts (milliseconds)

The time interval between two successive reconnections in milliseconds. The default value is 30000ms.

Adapter Termination Criteria (after max number of reconnect attempts)

This field is relevant for Inbound configurations connected to multiple SAP systems. This field is not relevant for Outbound configurations.

Select When All Pools Are Suspended to stop the adapter when all pools are suspended.

Select Any Pool Is Suspended to stop the adapter when any pool is suspended.

The default setting is When All Pools Are Suspended.

Note: If there is only one server connection pool and it is set to “When All Pools Are Suspended", the adapter stops.

Max Connections

The number of SAP connections in the client connection. By default, it is set to 1. The maximum number is 99, subject to limitations in the SAP system.

Note:

• When you specify the number of SAP connections, which is contained in a client connection, you need to consider the number of threads configured in all the Inbound adapter services using the client connection. To achieve maximum throughput from the adapter, the number of SAP connections need to equal the number of required concurrent messages. These messages are processed across all the Inbound adapter services.
• When you set the Max Connections field to 0, you can start the adapter without any errors.

Disable Connection Pooling

Select this checkbox to disable the connection to SAP system after the call to the SAP system is completed for a certain time.