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 is the Adapter for SAP Configuration panel:

Field Description
Adapter Name The adapter name.
Instance Id Specify a unique ID for the adapter configuration.

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

You have to follow the following 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 the next time you rename the adapter configuration.

Description Enter a description for the adapter configuration.
Message Filter Specify 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 Click this link to download schemas for the adapter configuration in the Schema Browser view.

For more information, see Working with Schemas.

Configure Adapter Services Click this link to add, remove, and configure adapter services in the Adapter Services tab.

For more information, see Adapter Service Reference.

Configure Connection Pools Click this link to add, remove, and configure connection pools in the Connection Pools tab.

For more information, see Working with Connection Pools.

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.

You can click Test Connection to validate the default client 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. After clicking Configure Advanced Options, you are brought to the Connection Pools tab. See Connection Pools Tab for more details.

The following is 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 Select a default client connection type from the following options:
  • Dedicated Application Server

    This option is selected by default.

  • Load Balancing
  • SNC

For the more information 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.
The following fields are the basic client connection settings, which are module property values. You can change the value of each parameter in the Module Properties editor.
Application Server The network name of the machine that hosts SAP applications.
Note: This field is available 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 available 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 available 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 available 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 available 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 the SNC connection is disabled.

Note: This field is available only when you select SNC from the Connection Type list.
SNC Partername The SNC name of the communication partner that is an application server.
Note: This field is available only when you select SNC from the Connection Type list.
SNC QOP The quality of protection:
  • 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 available only when you select SNC from the Connection Type list.
SNC Lib The library of the external security product.
Note: This field is available only when you select SNC from the Connection Type list.
Client The SAP client number.
Username The valid user name that logs 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. After clicking Configure Advanced Options, you are brought to the Connection Pools tab. See Connection Pools Tab for more details.

The following is 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 Select a default client connection type from the following options:
  • Default

    This option is selected by default.

  • SNC

For more information 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.
The following fields define the basic connection settings, which are module property values. You can change the value of each parameter in the Module Properties editor.
Program ID The valid existing program ID that identifies the RFC Server program for the SAP system.
Gateway Service The SAP gateway service.
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 the SNC connection is disabled.

Note: This field is available only when you select SNC from the Connection Type list.
SNC QOP The quality of protection:
  • 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 available only when you select SNC from the Connection Type list.
SNC Myname The SNC name of the initiator.
Note: This field is available only when you select SNC from the Connection Type list.
SNC Lib The library of the external security product.
Note: This field is available only when you select SNC from the Connection Type list.
Contents
Search Results