Configuration Tab

Use the Configuration tab to specify basic information about an adapter configuration, such as the default connections, and the adapter configuration name.

Adapter for SAP Configuration

In the Adapter for SAP Configuration panel, you can specify an instance ID, a description, and message filter for the adapter configuration.

The following table lists the fields in the Adapter for SAP Configuration panel:

Field Description
Adapter Name The adapter name, SAPAdapter.
Instance Id A unique ID for the adapter configuration.

The default ID is the one you specified when creating the adapter configuration.

The following are rules when specifying an ID:
  • An instance ID must use alphanumeric characters. You can use underscore (_) characters, but you cannot use the space character. The entire instance name must be less than 80 characters.
  • An instance ID cannot use module properties.
  • An instance ID must be unique with respect to other adapter configurations in the same project.

When you create an adapter configuration, TIBCO ActiveMatrix Adapter Framework automatically creates several resources for it. The names of these resources are derived from the ID of the configuration they belong to. Changing the adapter configuration ID results in an automatic regeneration of the resource names. If you manually modify any resource names, that particular name cannot be automatically regenerated when you rename the adapter configuration.

Description Enter a description for the adapter configuration.
Message Filter The filter that performs manipulations on incoming and outgoing messages before sending the messages to the network or handing them to a target application.

You can write filters by using TIBCO® Adapter SDK. See TIBCO Adapter SDK Programmer’s Guide for information about writing a message filter.

Getting Started

In the Getting Started panel, you can find the following links that bring you to the corresponding configuration panel:

Configuration Link Description
Download Schema from SAP This link bring you to the Schema Browser view where you can manage and configure schemas for the adapter configuration.

See Working with Schemas for details.

Configure Adapter Services This link bring you to the Adapter Services tab where you can manage and configure adapter services.

See Adapter Service Reference for details.

Configure Connection Pools This link bring you to the Connection Pools tab where you can manage and configure connection pools.

See Working with Connection Pools for details.

Default Client Connection

In the Default Client Connection panel, you can find the basic settings of the default client connection that the inbound adapter configuration uses to set up connection with the SAP system. The default client connection and the associated connection pool are added by default when creating an adapter configuration and cannot be changed.

After specifying the default client connection, you have to click can click Test Connection to validate the connection.

You can also click Configure Advanced Options to configure the related settings of the associated connection pool, such as the reconnecting parameters, the maximum number of SAP connections, and so on, in the Connection Pools tab. See Connection Pools Tab for details.

The following table lists the fields in the Default Client Connection panel:

Field Description
Enabled This check box is selected by default, which indicates this client connection is enabled as the default one.
Note: You cannot clear this check box.
Connection Type The default client connection type.

Select a connection type from the list:

  • Dedicated Application Server

    This option is selected by default.

  • Load Balancing
  • SNC

For the more details about client connections, see Connection Pools Tab.

Note: If you switch default client connection type in the Configuration tab, parameters for the client connection reference in the Connection Pools tab are automatically updated in accordance with the client connection type.
Application Server The network name of the machine that hosts SAP applications.
Note: This field is displayed only when you select Dedicated Application Server or SNC from the Connection Type list.
System number The number of the SAP systems that the adapter configuration connects to.
Note: This field is displayed only when you select Dedicated Application Server or SNC from the Connection Type list.
System Name The SAP/R3 system ID to be used with the load balancing connection.

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

Note: This field is displayed only when you select Load Balancing from the Connection Type list.
Msg Server The message server to be used with the load balancing connection.
Note: This field is displayed only when you select Load Balancing from the Connection Type list.
Logon Group Server The SAP logon group server to be used with the load balancing connection.

In the SAP system, names of logon groups are case sensitive. When starting multiple adapter configurations by using the same SAP logon group, you have to stagger the start times for adapter configurations.

Note: This field is displayed only when you select Load Balancing from the Connection Type list.
SNC Mode The value of 1 indicates that the SNC connection is enabled.

The value of 0 indicates that the SNC connection is disabled.

Note: This field is displayed only when you select SNC from the Connection Type list.
SNC Partername The SNC name of the communication partner.
Note: This field is displayed only when you select SNC from the Connection Type list.
SNC QOP The protection quality.
  • The value of 1 indicates that only authentication is applied.
  • The value of 2 indicates that the integrity protection is applied.
  • The value of 3 indicates that the privacy protection is applied.
  • The value of 8 indicates that the default protection is applied.
  • The value of 9 indicates that the maximum protection is applied.
Note: This field is displayed only when you select SNC from the Connection Type list.
SNC Lib The library of the external security product.
Note: This field is displayed only when you select SNC from the Connection Type list.
Client The SAP client number.
Username The valid user name used to log on to a specified SAP client.
Password The valid password corresponding to the user name.

Default Server Connection

In the Default Server Connection panel, you can find the basic settings of the default server connection that the outbound adapter configuration uses to set up connection with the SAP system. The default server connection and the associated connection pool are created by default when creating an adapter configuration and cannot be changed.

You can also click Configure Advanced Options to configure the related settings of the associated connection pool, such as the reconnecting parameters, the maximum number of SAP connections, and so on, in the Connection Pools tab. See Connection Pools Tab for details.

The following table lists the fields in the Default Server Connection panel:

Field Description
Enabled This check box is selected by default, which indicates this server connection is enabled as the default one.
Note: You cannot clear this check box.
Connection Type The default server connection type.

Select a connection type from the list:

  • Default

    This option is selected by default.

  • SNC

For details about server connections, see Connection Pools Tab.

Note: If you switch default server connection type in the Configuration tab, parameters for the server connection reference in the Connection Pools tab are automatically updated in accordance with the server connection type.
Program ID The program ID that identifies the RFC Server program for the SAP system.
Gateway Service The SAP gateway service.

The default value is sapgw00.

Gateway Host The Gateway host name, IP address or router string.
SNC Mode The value of 1 indicates that the SNC connection is enabled.

The value of 0 indicates that the SNC connection is disabled.

Note: This field is displayed only when you select SNC from the Connection Type list.
SNC QOP The protection quality.
  • The value of 1 indicates that only authentication is applied.
  • The value of 2 indicates that the integrity protection is applied.
  • The value of 3 indicates that the privacy protection is applied.
  • The value of 8 indicates that the default protection is applied.
  • The value of 9 indicates that the maximum protection is applied.
Note: This field is displayed only when you select SNC from the Connection Type list.
SNC Myname The SNC name of the initiator.
Note: This field is displayed only when you select SNC from the Connection Type list.
SNC Lib The library path of the external security product.
Note: This field is displayed only when you select SNC from the Connection Type list.