Configuring the Adapter for C9 INC

In this section:

x

Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish.


Top of page

x
Declaring Connection Attributes

How to:

Reference:

In order to connect to a C9 INC data source, the adapter requires connection and authentication information.

The connection credentials for a C9 INC data source are the credentials from the Salesforce account of the user.

You supply this information using the SET CONNECTION_ATTRIBUTES command. You can:

You can declare connections to more than one C9 INC data source using the SET CONNECTION_ATTRIBUTES commands. The actual connection takes place when the first query is issued. If you issue multiple SET CONNECTION_ATTRIBUTES commands:



x
Procedure: How to Declare Connection Attributes

You can configure the adapter from either the Web Console or the Data Management Console.

  1. From the Web Console menu bar, click Adapters.

    or

    From the Data Management Console, expand the Adapters folder.

    The Adapters folder opens.

  2. Expand the Available folder, if it is not already expanded.
  3. Expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the connection attributes reference.
  6. Click Configure. The configured adapter is added to the Adapters list in the navigation pane.


x
Reference: Connection Attributes for C9 INC

The C9 INC adapter is under the SQL group folder.

The following list describes the connection attributes for which you can supply values. To complete the attribute declaration, click the Configure button.

Connection name

Logical name used to identify this particular set of connection attributes. The default is CON01.

URL

Location URL for the C9 INC data source:

jdbc:certive://host:port 
Driver name

Name for the C9 INC driver:

com.certive.jdbc.CertiveDriver

See driver documentation for the specific release you are using.

IBI_CLASSPATH

Defines the additional Java Class directories or full-path jar names which will be available for Java Services. Value may be set by editing the communications file or in the Web Console. Using the Web Console, you can enter one reference per line in the input field. When the file is saved, the entries are converted to a single string using colon (:) delimiters for all platforms. OpenVMS platforms must use UNIX-style conventions for values (for example, /mydisk/myhome/myclasses.jar, rather than mydisk:[myhome]myclasses.jar) when setting values. When editing the file manually, you must maintain the colon delimiter.

Security

The user is authenticated with Explicit authentication. This means that the user ID and password are explicitly specified for each connection and passed to the database, at connection time, for authentication.

User

Email address by which you are known to the data source.

Password

Password associated with the email address by which you are known to the data source.

Select profile

Select a profile from the drop-down menu to indicate the level of profile in which to store the CONNECTION_ATTRIBUTES command. The global profile, edasprof.prf, is the default.

If you wish to create a new profile, either a user profile (user.prf) or a group profile if available on your platform (using the appropriate naming convention), choose New Profile from the drop-down menu and enter a name in the Profile Name field (the extension is added automatically).

Store the connection attributes in the server profile (edasprof).



x
Syntax: How to Declare Connection Attributes Manually
ENGINE SQLC9 SET CONNECTION_ATTRIBUTES connection 
'URL'/userid,password

where:

SQLC9

Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.

connection

Is the connection name.

URL

Is the URL to the location of the C9 INC data source.

userid

Is the email address by which you are known to the target database.

password

Is the password associated with the email address by which you are known to the target database.



Example: Declaring Connection Attributes

The following SET CONNECTION_ATTRIBUTES command connects to data source using the C9 INC Driver, with an explicit user ID (MYUSER) and password (PASS). To ensure security, specifying connection attributes from the Web Console or DMC will encrypt the password before adding it to the server profile.

ENGINE SQLC9 SET CONNECTION_ATTRIBUTES CON1
  'jdbc:certive://host:port'

Top of page

x
Overriding the Default Connection

How to:

If multiple connections have been defined, the connection named in the first SET CONNECTION_ATTRIBUTES command serves as the default connection.



x
Syntax: How to Change the Default Connection
ENGINE SQLC9 SET DEFAULT_CONNECTION connection

where:

SQLC9

Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.

connection

Is the connection defined in a previously issued SET CONNECTION_ATTRIBUTES command. If this name was not previously declared, the following message is issued:

FOC1671, Command out of sequence

Note:



Example: Selecting the Default Connection

The following SET DEFAULT_CONNECTION command selects the database server named SAMPLE as the default database server:

ENGINE SQLC9 SET DEFAULT_CONNECTION SAMPLE

WebFOCUS