Creating an iSeries program call JCA for the host application server

Information for the Advanced edition of the product This function is available only in WebSphere Development Studio Client Advanced Edition for iSeries, V5.0 or later.

Creating an iSeries program call JCA connection for use on WebSphere Application Server, V5.0 and later for an iSeries host, involves the following steps:

  1. Set up authentication on WebSphere Application Server on the host.
  2. Define the connection factory settings.
  3. Define the resource properties for the connection factory.

Step 1 - Set up authentication on the WebSphere Application Server on the host

The connector delegates the authentication to the application server that supports JCA 1.0. JCA 1.0 supports "Basic password" and "Kerboros V5" authentication. For instructions in setting up authentication on the WebSphere Application Server on the host, see the information in the WebSphere Application Server Installation and Configuration documentation.

For information about the JCA 1.0 specification, see the J2EE Connector Architecture (located on Sun Microsystem's Web site at http://java.sun.com/j2ee/connector/index.html.) JCA 1.0 is fully supported by WebSphere Application Server V5.0 and later. However, only Basic password is supported by the application server.

Step 2 - Define the connection factory settings

The connection factory contains the definition for the ServerName, UserName, and Password properties. See iSeries connection connector program example for an illustration of the coding used to define these properties.

Once the connector is installed on the application server, the administrator needs to set the values for the three properties for each instance of ISeriesPgmCallConnectionFactory, identified by the JNDI name.

Step 3 - Define the properties of ISeriesPgmCallConnectionSpecImpl

The ISeriesPgmCallConnectionSpecImpl provides the serverName, userName, password, PcmlName, AS400LibList and Session ID properties that are required for the iSeries program call connection. See the details in the documentation of the iSeries connection connector APIs.

The authentication information in ISeriesPgmCallConnectionSpecImpl takes precedence over that of the connector authentication setting in the application server, which in turn takes precedence over the setting in the ISeriesPgmCallConnectionFactory. In this way, the application component has the flexibility of either delegating the authentication to the application server, or of setting up the authentication information programmatically. The settings in the ISeriesConnectionFactory instance are the default when the other two settings are not defined.