実行時にリレーショナル・データベースに接続する場合は、
プログラムで使用するデータ・ソースを定義する必要があります。
WebSphere® Application Serverを使用している場合、
それを行うための指示は管理コンソールのヘルプ・システムに記載されています。
サポートされる別の J2EE サーバーを使用している場合は、そのサーバーの資料で、
データ・ソースの定義に関する指示を確認してください。
データ・ソースを定義する際は、以下のプロパティーに値を割り当てます。
- JNDI name
- JNDI レジストリー内でデータベースがバインドされる名前と一致する値を指定します。
- J2EE モジュールがデフォルトで使うデータベースに接続するデータ・ソースを定義している場合は、
データ・ソース定義で指定されている JNDI 名が、実行時に使用される J2EE
デプロイメント記述子内の vgj.jdbc.default.database
プロパティーの値と一致することを確認してください。
- システム関数 vgLib.connectionService の実行時にアクセスされるデータ・ソースを定義している場合は、
データ・ソース定義で指定されている JNDI 名が、実行時に使用される
J2EE デプロイメント記述子内の適切な vgj.jdbc.database.SN
プロパティーの値と一致することを確認してください。
- データベース名
- データベース管理システムに認識されているデータベースの名前を指定します。
- ユーザー ID
- データベースに接続するユーザー名を指定します。
データ・ソース定義がデフォルト・データベースを参照する場合、
「ユーザー ID」フィールドで指定する値は、実行時に使用される J2EE
デプロイメント記述子の vgj.jdbc.default.userid
プロパティーで設定されている値によってオーバーライドされます。
ただし、そうなるのは、vgj.jdbc.default.userid
と vgj.jdbc.default.password の両方の値を指定している場合のみです。
同様に、データ・ソース定義が、sysLib.connect または vgLib.connectionService システム関数によってアクセスされるデータベースを参照している場合、「ユーザー ID」フィールドに指定した値は、そのシステム関数への呼び出しで指定したユーザー ID によってオーバーライドされます。ただし、そうなるのは、その呼び出しがユーザー ID とパスワードの両方を渡す場合のみです。
この名前は、認証別名をセットアップするときに指定します。
その別名を定義できる表示に到達するには、管理コンソールで次の順に選択します。
- パスワード
- データベースに接続するためのパスワードを指定します。
データ・ソース定義がデフォルト・データベースを参照する場合、
「パスワード」フィールドで指定する値は、実行時に使用される
J2EE デプロイメント記述子の vgj.jdbc.default.password
プロパティーで設定されている値によってオーバーライドされます。
ただし、そうなるのは、vgj.jdbc.default.userid と vgj.jdbc.default.password
の両方の値を指定している場合のみです。
同様に、データ・ソース定義が、vgLib.connectionService システム関数によってアクセスされるデータベースを参照している場合、「パスワード」フィールドに指定した値は、そのシステム関数への呼び出しで指定したパスワードによってオーバーライドされます。ただし、そうなるのは、その呼び出しがユーザー ID とパスワードの両方を渡す場合のみです。
このパスワードは、認証別名をセットアップするときに指定します。
その別名を定義できる表示に到達するには、管理コンソールで次の順に選択します。
複数のデータ・ソースを定義することもできます。
その場合は、システム関数 vgLib.connectionService を使用してデータ・ソースを切り替えることができます。