84 Configuring an EIS Login

This chapter describes the various components that you must configure to use an EIS login.

Table 84-1 lists the configurable options for an EIS login.

EIS Login Configuration Overview

Table 84-1 lists the configurable options for an EIS login.

Table 84-1 Configurable Options for EIS Login

Option	Type	TopLink Workbench	Java
"Configuring an EIS Data Source Platform at the Session Level"	Basic
"Configuring EIS Connection Specification Options at the Session Level"	Basic
"Configuring User Name and Password"	Basic
"Configuring Password Encryption"	Advanced
"Configuring External Connection Pooling"	Advanced
"Configuring Properties"	Advanced

Configuring an EIS Data Source Platform at the Session Level

For each EIS session, you must specify the platform (such as AQ). This platform configuration overrides the platform at the project level, if configured.

For more information, see the following:

• "Configuring Relational Database Platform at the Project Level"

• "Data Source Login Types"

Using TopLink Workbench

To specify the database platform options for an EIS session login, use this procedure:

1. Select an EIS session in the Navigator. Its properties appear in the Editor.

2. Click the Login tab. The Login tab appears.

3. Click the Connection subtab. The Connection subtab appears.

   Figure 84-1 Login Tab, Connection Subtab, Platform Options

   
   Description of "Figure 84-1 Login Tab, Connection Subtab, Platform Options"
   
   

Use the following information to enter data in the Platform field on the Connection tab to configure the platform:

Field	Description
Platform	The EIS platform for the session. Select from the menu of options. This menu includes all instances of EISPlatform in the TopLink classpath.

Configuring EIS Connection Specification Options at the Session Level

You can configure connection information at the session level for an EIS application. This information is stored in the sessions.xml file. The Oracle TopLink runtime uses this information whenever you perform a persistence operation using the session in your EIS application.

This connection configuration overrides the connection information at the project level, if configured. For more information about project-level configuration, see "Configuring Development and Deployment Logins" and "Configuring EIS Connection Specification Options at the Project Level".

This connection configuration is overridden by the connection information at the connection pool level. For more information about connection pool-level configuration, see "Configuring Connection Pool Connection Options".

Using TopLink Workbench

Use this procedure to specify the connection options for an EIS session login.

1. Select an EIS session in the Navigator window. Its properties appear in the Editor window.

2. Click the Login tab. The Login tab appears.

3. Click the Connection subtab. The Connection tab appears.

   Figure 84-2 Login Tab, Connection Subtab

   
   Description of "Figure 84-2 Login Tab, Connection Subtab"
   
   

Use the following information to enter data in the connection fields on the tab:

Field	Description
Connection Specification Class	Specify the appropriate connection specification class for the selected Platform. Click Browse to choose from all the classes in the TopLink classpath. (For example: if Platform is oracle.toplink.eis.aq.AQPlatform, use oracle.toplink.eis.aq.AQEISConnectionSpec). For more information on platform configuration, see "Configuring an EIS Data Source Platform at the Session Level".
Connection Factory URL	Specify the appropriate connection factory URL for the selected Connection Specification Class (For example: jdbc:oracle:thin@:localhost:1521:orcl).