In this section: |
Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish.
How to: Reference: |
In order to connect to a UniData data source, the adapter requires connection and authentication information.
You supply this information using the SET CONNECTION_ATTRIBUTES command. You can:
You can declare connections to more than one UniData 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:
You can configure the adapter from either the Web Console or the Data Management Console.
or
From the Data Management Console, expand the Adapters folder.
The Adapters folder opens.
The Add Adapter to Configuration pane opens.
The UniData 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.
Logical name used to identify this particular set of connection attributes. The default is CON01.
Location URL for the UniData data source.
Name for the UniData JDBC driver.
For example: com.ibm.u2.jdbc.UniJDBCDriver
See UniData documentation for the specific driver release you are using.
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.
There are two methods by which a user can be authenticated when connecting to a database server:
Primary authorization ID by which you are known to the data source.
Password associated with the primary authorization ID.
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).
ENGINE SQLUND SET CONNECTION_ATTRIBUTES connection 'URL'/userid,password
where:
Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.
Is the connection name.
Is the URL to the location of the UniData data source.
Is the primary authorization ID by which you are known to the target database.
Is the password associated with the primary authorization ID.
The following SET CONNECTION_ATTRIBUTES command connects to a data source using the UniData 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.
Note: Consult your vendor documentation for the exact name, port, and path.
ENGINE SQLUND SET CONNECTION_ATTRIBUTES CON1 'jdbc:unidata://rediron6:7000/MYUSER,PASSSQLUND
How to: |
If multiple connections have been defined, the connection named in the first SET CONNECTION_ATTRIBUTES command serves as the default connection.
ENGINE SQLUND SET DEFAULT_CONNECTION connection
where:
Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.
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:
FOC1671, Command out of sequence.
The following SET DEFAULT_CONNECTION command selects the database server named SAMPLE as the default database server:
ENGINE SQLUND SET DEFAULT_CONNECTION SAMPLE
How to: |
The SET AUTODISCONNECT command controls the persistence of connections when using the adapter for each of the connections you want to establish.
ENGINE SQLUND SET AUTODISCONNECT ON {FIN|COMMIT}
where:
Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.
Disconnects automatically only after the session has been terminated. FIN is the default value.
Disconnects automatically only after COMMIT or ROLLBACK is issued as a native SQL command.
WebFOCUS |