EISConnector Service

This service manages communication between the SAP J2EE Engine 6.20 and Enterprise Information Systems (EIS). Using connector architecture, EISConnector service integrates EIS with application servers and enterprise applications.

Visual Administrator

Runtime Control

EISConnector Service runs on server nodes of SAP J2EE Engine 6.20 cluster. It can be configured at runtime using the “Runtime” tab of the Visual Administrator tool. This tab provides information about the existing Resource Adapters, and you can add new ones. It also contains several subtabs explained below – “General,” “Resource Adapter,” “Config Properties,” “Auth Mechanism” and “Security Permission.”

General Tab

The following input fields must be filled:

Vendor Name – specifies the name of resource adapter provider
Connector Version – specifies the version of the resource adapter
EIS Type – specifies the type of EIS. For example, this can be a product name of EIS, independent of any version info. This helps identify EIS instances that can be used with this resource adapter.
Version – specifies the version of the connector architecture specification that is supported by the current resource adapter

The “License” textbox in the “General” tab specifies licensing requirements for the resource adapter module. It also specifies whether a license is required to deploy and use this resource adapter, and an optional description of the license terms (duration of license, number of connection restrictions). The “isLicenseRequired” field specifies whether a license is required to deploy and use the resource adapter.

Resource Adapter Tab

The “Resource Adapter” tab specifies information about the resource adapter provider. The information includes fully qualified names of class or interfaces required as part of the connector architecture specified contracts, level of transaction support provided, configurable properties for the ManagedConnectionFactory instance, one or more authentication mechanisms supported, and additional required security permissions. The following input fields must be filled, according to the resource adapter:

Managed connection Factory Class – specifies the fully qualified name of Java class that implements the javax.resource.spi.ManagedConnectionFactory interface
Connection Factory Interface – specifies the fully qualified name of the ConnectionFactory interface supported by the resource adapter
Connection Factory Impl Class – specifies the fully qualified name of the ConnectionFactory class that implements the resource adapter’s specific ConnectionFactory interface
Connection Interface – specifies the fully qualified name of the Connection interface supported by the resource adapter
Connection Impl Class – specifies the fully qualified name of the Connection Class supported by the resource adapter’s specific Connection interface
Transaction Support – provides information about the level of transaction support provided by the resource adapter. The default value is Local_Transaction.
Reauthentication Support – provides information as to whether the resource adapter implementation supports reauthentication of the existing ManagedConnection instance

Config Properties Tab

“Config Property” tab contains a declaration of a single configuration property for a ManagedConnectionFactory instance.

Each ManagedConnectionFactory instance creates connections to a specific EIS instance based on the properties configured on the ManagedConnectionFactory instance. The configurable properties are specified only once in the deployment descriptor, even though a resource adapter can be used to configure multiple ManagedConnectionFactory instances.

The declaration consists of an optional description, name, type, and an optional value of the configuration property. If the resource adapter provider does not specify a value, the deployer is responsible for providing a valid value for a configuration property.

Any bounds or well-defined values of properties must be described in the description element.

The following options relate to the “Config Properties” pane:

Add – adds the name of a configuration property. The connector architecture defines a set of well-defined properties all of type java.lang.String, which can be selected in “Name” field. In addition, a type and a value must be specified. “Type” field contains a fully qualified Java type of configuration property as required by ManagedConnectionFactory instance. “Value” field has to contain the value of a configuration entry – for example, “Wombat Server.”
Remove – removes a specified name from
Set – sets a specified name

Auth Mechanism Tab

The “Auth Mechanism” tab specifies an authentication mechanism supported by the resource adapter. This support is for the resource and not for the underlying EIS instance. The optional description specifies any resource adapter-specific requirement for the support of the security contract and authentication mechanism.

In the “Auth Mechanism” pane, different types of authentication mechanisms can be amended using “Add” and “Remove.” Every authentication mechanism added to the “Auth Mechanism” pane has two basic fields:

Credential Interface – specifies the interface that the resource adapter implementation supports for the representation of the security credentials. This information must be used by the application server to find out the Credential interface as part of the security contract.
Type – specifies the type of an authentication mechanism. Any additional mechanisms not specified in the “Type” field are out of scope of the Connector architecture specification.
Description – additional information for authentication mechanisms can be included

Security Permission

“Security Permission” specifies a security permission that is required by the resource adapter code.

The security permissions listed in the deployment descriptor are ones that are different from those required by the default permission set as specified in the connector architecture specification. The optional descriptions can mention specific reasons why the resource adapter requires a given security permission.

The following input field must be filled:

Display Name – specifies the security permission name that is displayed in Visual Administrator
Security Permission – specifies the security permission based on the Security policy file syntax

Different security permissions can be included in the “Security Permission” pane using the “Add” and “Remove” options.

Properties

	Server
Property Key	Description	Default Value

PoolSize	Specifies the size of the pool that stores a number of connections related to EIS.
GranularSize	Specifies the number of the connections to an EIS stored in the pool. For example, if two EISs are integrated and PoolSize has a value of 10 and GranularSize has a value of 6, the real number of fields for connections in the pool is 22.	3

Property files

..cluster/server/services/eisconnector/properties
EISConnector Service properties specified in the Visual Administrator section can be set from this property file as well.