DBPARTNER2 Client プログラマーズガイド

解説・手引・文法書

3020-6-152

前書き

対象製品

P-2C63-4514 DBPARTNER2 Client（参照版） 02-01（適用OS：Windows Vista，Windows Server 2008，Windows 7，Windows 8，Windows 8.1，Windows 2008 R2，Windows Server 2012，Windows 20012 R2，Windows 10）

P-2C63-4614 DBPARTNER2 Client（更新版） 02-01（適用OS：Windows Vista，Windows Server 2008，Windows 7，Windows 8，Windows 8.1，Windows 2008 R2，Windows Server 2012，Windows 20012 R2，Windows 10）

P-2C63-4714 DBPARTNER2 Client（定義版） 02-01（適用OS：Windows Vista，Windows Server 2008，Windows 7，Windows 8，Windows 8.1，Windows 2008 R2，Windows Server 2012，Windows 20012 R2，Windows 10）

P-2C63-5514 DBPARTNER ODBC Driver 02-00（適用OS：Windows Vista，Windows Server 2008，Windows 7，Windows 8，Windows 8.1，Windows 2008 R2，Windows Server 2012，Windows 20012 R2，Windows 10）

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，DBPARTNER2 Clientは，株式会社 日立製作所の商標または登録商標です。

ActiveXは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MicrosoftおよびExcelは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MicrosoftおよびSQL Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MicrosoftおよびVisual Basicは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MicrosoftおよびWindowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MicrosoftおよびWindows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。

UNIXは，The Open Groupの米国ならびに他の国における登録商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

製品構成について

DBPARTNER2 Clientは，次に示す製品から構成されます。

・DBPARTNER2 Client

・DBPARTNER ODBC Driver

DBPARTNER2 Clientの形名の違いで，次に示す機能の差異があります。

機能

P-2C63-4514

（参照版）

P-2C63-4614

（更新版）

P-2C63-4714

（定義版）

データ抽出

○

○

○

データ更新

−

○

○

表定義

−

−

○

データベースの保存

−

−

○

予約検索

−

−

○

（凡例）

○：機能を使えます。

−：機能を使えません。

発行

2016年1月　3020-6-152

著作権

All Rights Reserved. Copyright (C) 2016, Hitachi, Ltd.

はじめに

このマニュアルは，データベースアクセスプログラムDBPARTNER2 Clientの使い方について説明したものです。DBPARTNER2 Clientは，次に示す製品から構成されます。

DBPARTNER2 Client

DBPARTNER ODBC Driver

このマニュアルでは，DBPARTNER2 ClientのActiveXコントロール仕様とDBPARTNER ODBC Driverについて説明します。

DBPARTNER2の最新情報

次に示すアドレスで，DBPARTNER2の最新情報を参照できます。

http://www.hitachi.co.jp/soft/dbpart/

対象読者

DBPARTNER2 Client又はDBPARTNER ODBC DriverをクライアントPCに組み込んで業務処理をするアプリケーション開発者の方々を対象にしています。

Windowsの操作について知識があることを前提としています。さらに，データベースのサーバと接続するときには，サーバの環境に関する知識があることを前提としています。

アプリケーションを作成するときは，次に示すビジュアル開発ツールの使い方の知識を前提としています。

Microsoft Visual Basic

アプリケーションからSQL文を使ってデータベースにアクセスするときは，SQL文の文法の知識を前提としています。

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　DBPARTNER2 Clientの紹介

DBPARTNER2 Clientの特長と機能，サーバと接続する形態について説明しています。

第2章　環境の設定

DBPARTNER2 Clientの実行環境を設定する方法について説明しています。

第3章　アプリケーションを使ったデータベースアクセス（ODBC接続）

DBPARTNER2 ClientのアプリケーションからActiveXコントロールのオブジェクトを使ってデータベースにアクセスする方法について説明しています。

第4章　DBPARTNER2 Clientのオブジェクトの文法（ODBC接続）

DBPARTNER2 Clientのアプリケーションを開発するときに使うActiveXコントロールのオブジェクトの文法について説明しています。

第5章　ODBC関数を使ったデータベースアクセス

DBPARTNER ODBC Driverをセットアップすると使えるODBC関数について説明しています。

第6章　アプリケーションを使ったデータベースアクセス（CommuniNet接続）

DBPARTNER2 ClientのアプリケーションからActiveXコントロールのオブジェクトを使ってデータベースにアクセスする方法について説明しています。

第7章　DBPARTNER2 Clientのオブジェクトの文法（CommuniNet接続）

DBPARTNER2 Clientのアプリケーションを開発するときに使うActiveXコントロールのオブジェクトの文法について説明しています。

第8章　CommuniNet接続を使うときの参照情報

CommuniNet接続でDBPARTNER2 Clientのアプリケーションを開発するときに，データベースとサーバプログラム別で注意する必要がある項目について説明しています。

第9章　トラブルが起こったときは

DBPARTNER2 Clientにトラブルが起こったときの対処について説明しています。

第10章　メッセージの一覧

DBPARTNER2 Clientをインストールするときに出力されるメッセージの意味と，DBPARTNER ODBC Driverから通知されるメッセージの意味について説明しています。

付録A　AP作成ウィザード

ActiveXコントロールを使用したアプリケーション作成を支援するプログラムであるAP作成ウィザードについて説明しています。

付録B　DBPARTNER2 Clientの予約語

表名や列名として使用できない，DBPARTNER2 Clientの予約語について説明しています。

付録C　DBPARTNER2 Clientが扱うデータの形式

DBPARTNER2 Clientが扱うデータ（ファイル）の形式について説明しています。

付録D　プロパティとメソッドの制限値

ActiveXコントロールのプロパティとメソッドのパラメタの制限値，及び文字定数について説明しています。

付録E　列の属性

アプリケーションで使用する文字定数の属性について説明しています。

付録F　繰り返し列と配列列での制限事項

表の列に繰り返し列や配列列を使用している場合の制限事項について説明しています。

付録G　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報について説明しています。

付録H　用語解説

このマニュアルで使用している用語について説明しています。

読書手順

このマニュアルは，利用目的に合わせて章を選んで参照できます。利用目的別にお読みいただくことをお勧めします。

マニュアルで使用する記号

全体で使用する記号

このマニュアル全体で使う記号を次のように定義します。

<　>：文字キーを示します。

［　］：メニューの名称やダイアログボックス又はダイアログボックス中のボタンを示します。

補足：操作や機能の補足説明を示します。

Windowsの［スタート］ボタンからメニューをたどって開く操作又はダイアログボックスのメニューを開く操作は，ハイフンでつないで表記します。

（例）

［スタート］ボタンから［プログラム］メニューの下の［DBPARTNER2］メニューを選ぶ操作は「［スタート］-［プログラム］-［DBPARTNER2］メニューを選ぶ」と表記します。

Windowsを組み込んだドライブやフォルダ名は，標準的な例で記述してあります。標準的な環境と異なるWindowsで使うときは，ドライブやフォルダ名をお使いになるWindowsの環境に読み替えてください。

図中で使用する記号

このマニュアルの図中に使う記号を次のように定義します。

条件式の文法で使用する記号

このマニュアルの条件式の説明で使う記号を次のように定義します。

記号

意味

｜

ストローク

横に並べられた複数の項目に対し，項目間の区切りを示し，「又は」の意味を示します。

（例）

A｜B｜Cは，「A，B又はC」を意味します。

{　}

波括弧

この記号で囲まれている複数の項目のうちから一つを選択します。項目が縦に複数行にわたって記述されている場合は，そのうちの1行分を選択します。項目が並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。

（例）

{A｜B｜C}では，「A，B又はCのどれかを指定する」ことを示しています。

〔　〕

きっ甲

この記号で囲まれている項目は省略してもよいことを意味します。複数の項目が縦又は横に並べて記述されている場合には，すべてを省略するか，記号{　}と同じく，どれか一つを選択します。

（例）

〔A〕は「何も指定しない」か，「Aと指定する」ことを示します。〔B｜C〕は「何も指定しない」か，「B又はCと指定する」ことを示します。

…

リーダ

記述が省略されていることを示します。この記号の直前に示された項目を繰り返し複数個指定できます。

（例）

A，B，B，…は，「Aの後ろにBを必要個指定する」ことを示します。

__

下線

括弧内のすべての項目を省略したときに，システムが仮定する値を示します。複数の項目のうち，1項目にだけ付けてあります。

（例）

〔A｜B｜C〕は，「A，B，Cのどれも指定しなかった場合，システムはCを指定したときと同じ処理をする」ことを示します。

《 》

二重角括弧

設定値を省略したときに，システムが仮定する値を示します。

（例）

《HiRDB》は，「値を省略すると，HiRDBという文字列が仮定される」ことを示します。

△

白三角

空白を空けることを示します。

（例）

EDIT△PANELは，EDITとPANELの間に一つ空白を空けることを示します。

△n

白三角

空白をn回以上繰り返して指定することを示します。

（例）

NOT△₂INは，NOTの後ろに二つ以上の空白を空けることを示します。

コマンドの変数指定で使用する記号

このマニュアルの条件式の変数指定で使う記号を次のように定義します。

記号

意味

〈　　〉

項目を記述するときに従わなければならない構文要素を示します。

このマニュアルで使用する構文要素

このマニュアルの文法説明で使用する構文要素の種類を次に示します。

種類

定義

〈英字〉

A〜Z　a〜z

〈英大文字〉

A〜Z　@　#　¥

〈英小文字〉

a〜z

〈数字〉

0〜9

〈英数字〉

A〜Z　a〜z　0〜9

〈カナ文字〉

ア〜ン　ヲ　カナ小文字　゛　゜　ー

〈記号〉

！　"　＃　＄　％　＆　‘　’　（　）　＋　，　ー　．　／　：　；　＜　＝　＞　＠　［　］　＾　＿　｛　｝　￣　タブ　空白

マニュアルとオンラインヘルプの使い分け

DBPARTNER2 Clientでは，オンラインヘルプを提供しています。マニュアルとオンラインヘルプは，それぞれの用途に応じて使い分けてください。

マニュアル

ActiveXコントロールを使用して初めてアプリケーションを作成するとき。

ActiveXコントロールの全体の機能を理解したいとき。

DBPARTNER2 Clientの機能の概要を知りたいとき。

DBPARTNER2 Clientを使用するときに必要な環境設定を知りたいとき。

オンラインヘルプ

アプリケーションの作成時にActiveXコントロールのプロパティ,メソッドの形式やパラメタの指定内容などを参照したいとき。

第1編　概要

1　DBPARTNER2 Clientの紹介

この章では，DBPARTNER2 Clientの特長と機能，サーバと接続する形態について説明します。

1.1　DBPARTNER2 Clientの概要

DBPARTNER2 Clientとは，WindowsのクライアントPCからUNIX/Windows/メインフレームのサーバのデータベースにアクセスできるようにする製品です。

DBPARTNER2 Clientを使うと，クライアントPCからデータベースのデータを取り出したり，データベースのデータを更新したりできます。UNIXやWindowsサーバなどで稼働するDBMSにも，メインフレーム（VOS3，VOS1，VOSK）で稼働するDBMSにも，DBPARTNER2 Clientからアクセスできます。どのOSのデータベースにアクセスするときもDBPARTNER2 Clientの操作は同じなので，クライアントPCでデータベースのOSを意識する必要はありません。

DBPARTNER2 Clientに関連する製品を表1-1に示します。このマニュアルでは，DBPARTNER2 ClientのActiveXコントロール仕様について説明します。

表1‒1　DBPARTNER2 Clientに関連する製品

DBPARTNER2 Clientの関連製品

機能

DBPARTNER2 Client ※

データベースにアクセスする，次に示す製品の総称です。

DBPARTNER2 Client

クライアントPCからデータベースに，WindowsのGUIでアクセスできるようにする製品です。

Visual Basicなどのビジュアル開発ツールでアプリケーションを開発できるように，ActiveXコントロールのオブジェクトも提供しています。

DBPARTNER ODBC Driver

クライアントPCからデータベースに，ODBC接続で通信できるようにする製品です。

注※

DBPARTNER2 Clientは，複数の製品を統合しています。製品は，必要に応じてクライアントPCにインストールします。DBPARTNER2 Clientの各製品の概要については，「2.2　DBPARTNER2 Clientのインストール」を参照してください。

DBPARTNER2 Clientの関連製品を使ったデータベースへのアクセスを図1-1に示します。

図1‒1　DBPARTNER2 Clientの関連製品を使ったデータベースへのアクセス

DBPARTNER2 Clientからサーバのデータベースへのアクセスを仲介するプログラムのことを，サーバプログラムといいます。クライアントPCとサーバの接続形態とサーバプログラムの関係については，「1.4　DBPARTNER2 Clientとサーバを接続する形態」を参照してください。

1.2　DBPARTNER2 Clientの特長

DBPARTNER2 ClientのActiveXコントロール仕様の特長について説明します。

1.2.1　ActiveXコントロールのオブジェクトを使ってデータベースにアクセスできます

DBPARTNER2 Clientは，データベースアクセスの各操作をActiveXコントロールのオブジェクトで提供しています。このオブジェクトからVisual Basicなどのビジュアル開発ツールを使ってデータベースにアクセスできるアプリケーションを開発できます。アプリケーションを作成するときは，データベースアクセスの処理をSQL文で記述することも，SQL文を使わないで記述することもできます。

作成したアプリケーションを操作するときは，アクセスするデータベースを意識する必要はありません。異なるデータベースにアクセスするときでも，DBPARTNER2 Clientのアプリケーションでは同じユーザインタフェースで操作できます。

DBPARTNER2 Clientを使ったデータベースアクセスの概要を図1-2に示します。

図1‒2　DBPARTNER2 Clientを使ったデータベースアクセスの概要

(1)　抽出する条件を付けて，効率良くデータを抽出できます

DBPARTNER2 Clientのアプリケーションでは，次に示すようにデータを抽出できます。

条件を設定したデータの抽出（比較条件，LIKE条件，NULL条件，AND，OR など）

データベースから表データを抽出するときに，指定した列だけを抽出したり，設定した条件に合う列の行だけを抽出したりできます。また，指定した複数の条件を関連付けた抽出もできます。

指定した件数までのデータの抽出

表から抽出するデータの件数（行）を指定できます。指定した件数を超えるデータは切り捨てられます。

表名と列名を検索

表名や列名が分かっていないときは，接続しているデータベースに存在する表名や列名を一度表示させて，必要なものを選択して操作できるようなGUIを作成できます。

(2)　データベースのデータを更新できます

DBPARTNER2 Clientのアプリケーションを使って，データベースのデータを更新できます。データベースの更新には，変更，追加，削除があります。

データの変更

データベースの表のデータを変更できます。

データの追加

データベースの表にデータを追加できます。

データの削除

データベースの表のデータを削除できます。

(3)　マルチメディアデータ（BLOB型データ）にアクセスできます

DBPARTNER2 Clientを使うと，音声や画像などを使ったマルチメディアデータ（BLOB型データ）を抽出できます。さらに，抽出したマルチメディアデータを加工して更新することもできます。DBPARTNER2 Clientでマルチメディアデータを扱うときは，DBPARTNER2 ClientのオブジェクトのプロパティやメソッドにBLOB型データ用の設定をします。

アクセスするデータベースやサーバプログラムによっては，BLOB型データを扱えないことがあります。BLOB型データを使えるかどうかについては，アクセスするデータベースのマニュアルを参照してください。

(4)　アプリケーション開発にビジュアル開発ツールを使えます

DBPARTNER2 Clientのアプリケーションは，各種のビジュアル開発ツールを使って作成できます。次に示す製品で，動作を確認済みです。

Microsoft Visual Basic 4.0（32ビット版），Microsoft Visual Basic 5.0，Microsoft Visual Basic 6.0

APPGALLERY 4.0

Power Builder 5.0

上記以外のビジュアル開発ツールを使うときは，別途確認が必要です。

(5)　サンプルを提供しています

DBPARTNER2 Clientは，すぐにアプリケーションの動作を体験できるように，サンプル（Visual Basic 4.0　32ビット版対応）を提供しています。サンプルを使ってアプリケーションを作成したり，サンプルを業務に合わせた処理に修正したりすれば，DBPARTNER2 Clientのアプリケーションを最初から作成する手間が省けます。各サンプルについては，Readme.txtを参照してください。サンプルを格納しているフォルダについては，マニュアル「DBPARTNER2 Client操作ガイド」を参照してください。

(6)　AP作成ウィザードで簡単にアプリケーションが作成できます。

AP作成ウィザードは，ActiveXコントロールを使用したアプリケーションを開発するためのプログラムです。AP作成ウィザードを使用すると，データベースからデータを抽出するアプリケーションが簡単に作成できます。AP作成ウィザードについては，「付録A　AP作成ウィザード」を参照してください。

1.2.2　ODBCに対応したデータベースにアクセスできます

DBPARTNER2 Clientは，ODBCに対応しています。DBPARTNER2では，日立データベース用の各種ODBCドライバを提供しています。ODBC対応の表計算ソフトからデータベースにアクセスするときはDBPARTNER2 ClientのODBCドライバだけを経由するので，それぞれの表計算ソフトのユーザインタフェースをそのまま使えます。

ODBCドライバを使うときは，DBPARTNER ODBC DriverをクライアントPCに組み込みます。DBPARTNER ODBC Driverは，DBPARTNER2 Clientと一緒に使うことも，DBPARTNER2 Client以外のアプリケーションで使うこともできます。

(1)　ODBCドライバの種類

DBPARTNER2 Clientが提供するODBCドライバには，次のドライバがあります。

DABrokerドライバ

（DABroker，Database Connection Server接続用）

DBPARTNER2 ClientのODBCドライバを使ってアクセスできるデータベースについては，「1.4　DBPARTNER2 Clientとサーバを接続する形態」を参照してください。

1.3　DBPARTNER2 Clientの機能

DBPARTNER2 ClientのActiveXコントロールを使ってアプリケーションを作成すると，データベースから指定した条件に合ったデータを読み込めます（データの抽出）。また，抽出したデータを編集してデータベースを更新できます（データの更新）。

DBPARTNER2 Clientを使ったデータの抽出／更新の概要を図1-3に示します。

図1‒3　DBPARTNER2 Clientを使ったデータの抽出／更新の概要

1.3.1　データの抽出

クライアントPCのアプリケーションから，データベースにアクセスしてデータを抽出できます。このとき，複数の表を結合してデータを抽出することもできます。さらに，データベース上の表からデータを抽出するときに特定した列だけを抽出したり，条件に合うデータだけを抽出したりできます。

DBPARTNER2 Clientを使ったデータの抽出を図1-4に，抽出で使える機能の一覧を表1-2に示します。

図1‒4　DBPARTNER2 Clientを使ったデータの抽出

表1‒2　抽出で使える機能の一覧

抽出で使える機能

説明

複数の表を結合して抽出する

表と表で共通する列を結び付けて，一つの表として抽出できます（表結合）。表結合を使うと，関連する表のデータを一括して利用できます。

表を取得するときに絞り込みをする

表を選ぶときに，条件を付けて絞り込めます。抽出対象の表が大量にある場合などに，効率良く表を選べます。

特定の列だけを抽出する

抽出する表から特定の列だけを選んで抽出できます。選択した列のデータをソートしたり，列のデータの最大値，最小値などを抽出したりすることもできます。

条件に合うデータを抽出する

抽出する表から条件に合うデータだけを抽出できます。また，複数の条件式を関連付けることもできます。例えば，定価が50,000円以上のデータを抽出する条件と，商品名が冷蔵庫又はテレビのデータを抽出する条件を「AND」で関連付けます。この場合，定価が50,000円以上でかつ，商品名が冷蔵庫又はテレビのデータだけを抽出できます。

特定の列で，条件に合うデータを抽出する

列と条件の両方を設定して，データを抽出できます。指定した列のデータのうち，条件に合うデータだけを抽出できます。

抽出するデータの件数を制限する

データを抽出するときに，その件数を指定できます。抽出するデータをソートして上位10件だけを抽出したり，表計算ソフトに表示できるデータ量を考慮して，抽出する件数を制限したりするときなどに使います。

1.3.2　データの更新

クライアントPCのアプリケーションから，データベースにアクセスしてデータを更新（変更，追加，削除）できます。

DBPARTNER2 Clientを使ったデータの更新を図1-5に示します。

図1‒5　DBPARTNER2 Clientを使ったデータの更新

1.4　DBPARTNER2 Clientとサーバを接続する形態

DBPARTNER2 Clientとサーバを接続する形態について説明します。DBPARTNER2 Clientとサーバとの接続形態には，次に示す2通りがあります。

ODBCに準拠した接続形態（ODBC接続）

CommuniNetを使った接続形態（CommuniNet接続）

一つのクライアントPCに複数のDBPARTNER2 Clientの製品（例：DBPARTNER2 ClientとDBPARTNER/Client32）を組み込んで，ODBC接続とCommuniNet接続と組み合わせて使うこともできます。

クライアントPC上でDBPARTNER2 Clientとほかの製品を連携して使うときは，すべて32ビット対応のソフトウェアを使ってください。

1.4.1　DBPARTNER2 Clientで使えるサーバプログラム

DBPARTNER2 Clientからデータベースにアクセスするときは，仲介の役割をするプログラムが必要です。このプログラムをサーバプログラムといいます。DBPARTNER2 Clientで使えるサーバプログラムを次に示します。

(1)　ODBC接続で使うサーバプログラム

DABroker

分散オブジェクト環境に準拠したサーバプログラムです。Windows又はUNIXで稼働します。

Database Connection Server

メインフレーム上で稼働するサーバプログラムです。

XDM/DF

VOS3で稼働するサーバプログラムです。

DF1

VOS1で稼働するサーバプログラムです。

DF/K

VOSKで稼働するサーバプログラムです。

(2)　CommuniNet接続で使うサーバプログラム

HOAPDBS E2，ACE3 E3

VOS3で稼働するサーバプログラムです。

DBPARTNER/Link

VOS1で稼働するサーバプログラムです。

HOAPDBS/PC

VOSKで稼働するサーバプログラムです。

1.4.2　ODBCドライバの概要

ODBC接続でデータベースにアクセスする場合は，それに対応するODBCドライバ（DBPARTNER ODBC Driver）を用意する必要があります。

DBPARTNER2 Clientで同梱しているDBPARTNER ODBC Driverでは，次に示すODBCドライバを提供しています。

DABrokerドライバ（DBPARTNER/Serverドライバ）

それぞれのODBCドライバは，アクセスするデータベースによって使い分けます。

DBPARTNER ODBC DriverのほかにDBPARTNER2 Clientで接続を確認しているODBCドライバを次に示します。

DBPARTNER ODBC 3.0 Driver

HiRDB ODBC Driver

(1)　ODBCドライバを使ってアクセスできるデータベース

DBPARTNER2 ClientのODBCドライバを使ってアクセスできるデータベースを表1-3に示します。

表1‒3　DABrokerドライバ（DBPARTNER/Serverドライバ）の場合

サーバプログラム

アクセスできるデータベース

DABroker

HiRDB ※

Oracle

Microsoft SQL Server

Sybase Adaptive Server Anywhere

VOS3 XDM/RD E2

VOS3 XDM/SD E2

VOS1 RDB1 E2

VOSK　RDB編成ファイル

Database Connection Server

VOS3 XDM/RD E2

VOS3 XDM/SD E2

VOS1 PDMII E2

VOSK RDB編成ファイル

VOSK スプールファイル

注※

HiRDBのデータベース管理で扱えるデータは，接続するサーバプログラムによって決まります。

(2)　DBPARTNER2 Clientが稼働する環境（ODBC接続）

DBPARTNER2 ClientのクライアントPCに必要なソフトウェアとドライバ，サーバ側で必要なソフトウェアの関係を表1-4に示します。

表1‒4　DBPARTNER2 Clientが稼働する環境（ODBC接続）

データベース

サーバプログラム

ODBCドライバ

クライアントPC側の環境

HiRDB

DABroker

DABrokerドライバ

（DBPARTNER/Serverドライバ）

−

Oracle

DABroker

DABrokerドライバ

（DBPARTNER/Serverドライバ）

−

Microsoft SQL Server，

Sybase Adaptive Server Anywhere

DABroker

DABrokerドライバ

（DBPARTNER/Serverドライバ）

−

VOS3 XDM/RD E2

DABroker ※

DABrokerドライバ

（DBPARTNER/Serverドライバ）

−

Database Connection Server

VOS3 XDM/SD E2

DABroker ※

DABrokerドライバ

（DBPARTNER/Serverドライバ）

−

Database Connection Server

VOS1 RDB1 E2

DABroker ※

DABrokerドライバ

（DBPARTNER/Serverドライバ）

−

Database Connection Server

VOS1 PDMII E2

DABroker ※

DABrokerドライバ

（DBPARTNER/Serverドライバ）

−

Database Connection Server

VOSK RDB編成ファイル

DABroker ※

DABrokerドライバ

（DBPARTNER/Serverドライバ）

−

Database Connection Server

VOSK スプールファイル

DABroker ※

DABrokerドライバ

（DBPARTNER/Serverドライバ）

−

Database Connection Server

注※

メインフレーム系データベースにアクセスするときは，RDA Link for Gateway，又はDatabase Connection Serverが必要です。DABrokerに必要なソフトウェアについては，マニュアル「DABroker」を参照してください。

(3)　使えるデータベースと表の数

1回のデータ抽出処理で処理対象にできるデータベースの個数は1個です。つまり，複数のデータベースから同時にデータを抽出できません。

1個のデータベースから使える表の最大数は，データベースによって異なります。また，権限によって処理対象にならない表があります。権限については，システム管理者に確認してください。

(4)　データの形式

DBPARTNER2 Clientで扱える形式のデータを表1-5に示します。データの形式については，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

表1‒5　転送時のデータ形式

形式

拡張子

出力先

利用できるソフトウェア

ファイル

クリップボード

CSV形式

.csv

○

×

表計算ソフト

DAT形式

.dat

○

×

表計算ソフト

TEXT形式

.txt

○

○

表計算ソフト

XLS形式

.xls

○

○

表計算ソフト（Excel）

XLSB形式

.xlsb

○

×

表計算ソフト（Excel 2007以降）

XLSX形式

.xlsx

○

×

表計算ソフト（Excel 2007以降）

（凡例）

○：出力できます。

×：出力できません。

1.4.3　CommuniNet接続の概要

CommuniNet接続でデータベースにアクセスするときは，DBPARTNER2 ClientのPCにCommuniNetが必要です。

DBPARTNER2 ClientのActiveXコントロールでCommuniNet接続を使うときに必要なプログラムを次に示します。

CommuniNet Version 3.0以降

CommuniNet Extension Version 3.0以降

さらに，上記のCommuniNetが稼働するために必要なソフトウェアがあります。CommuniNetに関連する製品については，CommuniNetの該当するマニュアルを参照してください。

(1)　CommuniNet接続でアクセスできるデータベース

CommuniNet接続でアクセスできるデータベースを表1-6に示します。

表1‒6　CommuniNet接続でアクセスできるデータベース

サーバのOS

サーバプログラム

アクセスできるデータベース

VOS3

HOAPDBS E2

XDM/RD E2，XDM/SD E2

ACE3 E3

PDMII E2，RDB1，ACE3ユーザファイル

VOSK

HOAPDBS/PC

RDB編成ファイル，VOSKスプールファイル

VOS1

DBPARTNER/Link

PDMII E2，ACE3ユーザファイル，VOS1スプールファイル

(2)　DBPARTNER2 Clientが稼働する環境（CommuniNet接続）

DBPARTNER2 ClientのクライアントPCに必要なソフトウェア，サーバ側で必要なソフトウェアの関係を表1-7に示します。

表1‒7　DBPARTNER2 Clientが稼働する環境（CommuniNet接続）

データベース

サーバプログラム

クライアントPC側の環境

VOS3 XDM/RD E2

HOAPDBS E2

CommuniNet，

CommuniNet Extension

VOS3 XDM/SD E2

VOS3 PDMII E2

ACE3 E3

VOS3 RDB1

VOS3 ACE3ユーザファイル

VOSK RDB編成ファイル

HOAPDBS/PC

VOSKスプールファイル

VOS1 PDMII E2

DBPARTNER/Link

VOS1 ACE3ユーザファイル

VOS1スプールファイル

(3)　アクセスするデータベースの制限

CommuniNet接続のときには，DBPARTNER2 Clientからアクセスするデータベースによって，使える機能に制限があります。データベースごとの制限については，「8.　CommuniNet接続を使うときの参照情報」の説明を参照してください。

(4)　使えるデータベースと表の数

1回のデータ抽出処理で処理対象にできるデータベースの個数は1個です。つまり，複数のデータベースから同時にデータを抽出できません。

1個のデータベースから使える表の最大数は，データベースによって異なります。また，権限によって処理対象にならない表があります。権限については，システム管理者に確認してください。

(5)　データの形式

DBPARTNER2 Clientで扱える形式のデータを表1-8に示します。データの形式については，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

表1‒8　転送時のデータ形式

形式

拡張子

出力先

利用できるソフトウェア

ファイル

クリップボード

CSV形式

.csv

○

×

表計算ソフト

DAT形式

.dat

○

×

表計算ソフト

TEXT形式

.txt

○

○

表計算ソフト

XLS形式

.xls

○

○

表計算ソフト（Excel）

XLSB形式

.xlsb

○

×

表計算ソフト（Excel 2007以降）

XLSX形式

.xlsx

○

×

表計算ソフト（Excel 2007以降）

（凡例）

○：出力できます。

×：出力できません。

第2編　準備

2　環境の設定

この章では，DBPARTNER2 Clientの実行環境を設定する方法について説明します。

2.1　DBPARTNER2 Clientの環境を設定する手順

DBPARTNER2 Clientの環境を設定する手順について説明します。環境を設定する手順を図2-1に示します。

図2‒1　環境を設定する手順

DBPARTNER2 Clientをセットアップします

DBPARTNER2 ClientをクライアントPCに組み込みます。

ODBCドライバ又はCommuniNetをセットアップします

ODBC接続のとき

接続するサーバに応じたODBCドライバを，次に示すどちらかから選んでインストールします。

DABrokerドライバ（DBPARTNER/Serverドライバ）

HiRDB，ORACLE，Microsoft SQL Server，Sybase Adaptive Server Anywhere，VOS3 XDM/RD E2，VOS3 XDM/SD E2，VOS1 RDB1 E2，VOSK RDB編成ファイル，VOS1 PDMII E2，VOSKスプールファイル

CommuniNet接続のとき

CommuniNetをセットアップします。

必要に応じてODBCドライバマネージャをインストールします

ODBCドライバマネージャのインストールについては，「2.3.1　ODBCドライバのインストールの手順」を参照してください。

データソースと通信ドライバの環境を設定します

ODBCドライバのとき

DABrokerドライバ（DBPARTNER/Serverドライバ）を使うときは，2．でインストールしたODBCドライバのデータソース名と通信ドライバに関する情報を指定します。

DBPARTNER2 Clientと一緒にODBCドライバを使うときは，ODBCドライバで指定するデータソース名とDBPARTNERオブジェクトに設定するデータソース名は同じ名前にしてください。

CommuniNet接続のとき

CommuniNetの環境を設定して，接続するサーバの環境に応じたマクロスクリプトファイルを作成します。

CommuniNetのマクロスクリプトファイル名は，CommuniNet接続のDBPARTNERオブジェクトに設定します。

2.2　DBPARTNER2 Clientのインストール

インストールできるDBPARTNER2 Clientの製品の種類について説明します。インストールの手順については，マニュアル「DBPARTNER2 Client 操作ガイド」を参照してください。

2.2.1　DBPARTNER2 Clientの製品の種類

DBPARTNER2 Clientには，参照版，更新版，定義版があります。業務で使うDBPARTNER2 Clientを選んでインストールしてください。

(1)　DBPARTNER2 Clientの製品体系

DBPARTNER2 Clientは，複数の製品を同梱しています。DBPARTNER2 Clientの製品名と機能の一覧を表2-1に示します。

表2‒1　DBPARTNER2 Clientの製品名と機能の一覧

DBPARTNER2 Clientの製品名

機能

DBPARTNER2 Client

クライアントPCからデータベースに，WindowsのGUIでアクセスできるようにする製品です。

Visual Basicなどのビジュアル開発ツールでアプリケーションを開発できるように，ActiveXコントロールのオブジェクトも提供しています。

DBPARTNER ODBC Driver

クライアントPCからデータベースに，ODBC接続で通信できるようにする製品です。ODBC接続を使うときは，必ずクライアントPCに組み込みます。

DBPARTNER ODBC Driverは，DBPARTNER2 Clientと一緒に使うことも，DBPARTNER2 Client以外のアプリケーションで使うこともできます。

(2)　DBPARTNER2 Clientの製品の種類と使える機能の関係

DBPARTNER2 Clientの製品の種類（参照版，更新版，定義版）と使える機能の関係を表2-2に示します。

SQLDirectオブジェクトでSQLを直接実行するときは，表2-2に示す制限はありません。

表2‒2　DBPARTNER2 Clientの製品と使える機能の関係

DBPARTNER2 Clientの製品

デザイン ※1

実行 ※2

QueryDefine

オブジェクト

UpdateDefine

オブジェクト

QueryDefine

オブジェクト

UpdateDefine

オブジェクト

DBPARTNER2 Client（参照版）

○

○

○

−

DBPARTNER2 Client（更新版）

○

○

○

○

DBPARTNER2 Client（定義版）

○

○

○

○

（凡例）

○：機能を使えます。

−：機能を使えません（エラーになります）。

注※1

デバッグを実行するときは，実行時と同じ制限があります。

注※2

デザインしたDBPARTNER2 Clientのアプリケーションを稼働するクライアントPCのDBPARTNER2 Clientを示します。

2.3　ODBCドライバのセットアップ

DBPARTNER2 ClientのODBCドライバ（DBPARTNER ODBC Driver）をセットアップする方法について説明します。DBPARTNER ODBC Driverは，DBPARTNER2 Clientと一緒に使うことも，DBPARTNER2 Client以外のアプリケーションで使うこともできます。

DBPARTNER ODBC Driverでは，次に示すODBCドライバが使えます。

DABrokerドライバ（DBPARTNER/Serverドライバ）

2.3.1　ODBCドライバのインストールの手順

ODBCドライバは，DBPARTNER ODBC Driverの提供媒体のSetup.exeを実行してインストールします。

提供媒体のSetup.exeを実行してODBCドライバをインストールする手順を次に示します。

ODBCドライバの提供媒体をドライブにセットします。

1. でセットしたODBCドライバの提供媒体のSetup.exeを実行します。Setup.exe実行後は，表示される画面に従ってインストールしてください。

ODBCドライバ，及びODBCドライバマネージャのインストール完了後，データソースをセットアップします。

データソースのセットアップは，「2.3.3　DABrokerドライバのデータソースと通信ドライバの設定」で示す手順に従って操作してください。

2.3.2　ODBCドライバをインストールすると作成されるファイル

ODBCドライバのインストール時の選択によって作成されるファイルについて説明します。

(1)　DABrokerドライバを選択すると作成されるファイル

DABrokerドライバ（DBPARTNER/Serverドライバ）を選択すると作成されるファイルの一覧を表2-3に示します。

表2‒3　DABrokerドライバ（DBPARTNER/Serverドライバ）を選択すると作成されるファイルの一覧

ファイル名

ファイルの内容

格納先

Readme.txt

はじめにお読みください

インストール先ディレクトリ

Dbpsvd32.dll

ODBCドライバ

Windowsのフォルダ¥System

Dbpwsc32.dll

通信部(Windows Sockets用)

Windowsのフォルダ¥System

Dbpsvl32.dll

共通サービス機能

Windowsのフォルダ¥System

Dbpsvs32.dll

ODBCドライバのセットアップ機能

Windowsのフォルダ¥System

Dbpdfh32.hlp

ヘルプ

Windowsのフォルダ¥System

2.3.3　DABrokerドライバのデータソースと通信ドライバの設定

DABrokerドライバ（DBPARTNER/Serverドライバ）は，DABrokerを経由してデータベースにアクセスするときに必要です。

DABrokerドライバをインストールして環境を設定する方法について説明します。

データソースのセットアップ

接続先サーバのセンタ名称を「データソース名」としてODBCドライバに登録します。また，接続先サーバのホスト名称，使う通信ドライバ，応答監視時間を設定します。使える通信ドライバは「Windows Sockets」だけです。

通信ドライバの環境設定

DABrokerドライバ（DBPARTNER/Serverドライバ）は，TCP/IPを使用してサーバプログラムと通信しています。そのため，TCP/IPに関する通信ドライバの環境を，次の手順に従って設定してください。

ホスト名称とインターネットアドレスの登録

hostsファイルに，接続するサーバのホスト名称とインターネットアドレスを登録します。ホスト名称には，［DBPARTNER ODBC Driver for DABroker−セットアップ−］ダイアログボックスで指定するホスト名称を指定します。ホスト名称の登録方法については，通信ドライバのマニュアルを参照してください。

ポート番号の登録

servicesファイルに，接続するサーバのサービス名，ポート番号および通信プロトコル種別を登録します。

ポート番号に登録する内容を次に示します。

　　サービス名：DBPARTNER_SV

　　ポート番号：XXXXX

　　通信プロトコル種別：tcp

　　（登録例）DBPARTNER_SV 40179/tcp

XXXXX：サーバ側のservicesファイルに定義されているDABROKER_SVの値と一致させます。DABROKER_SVの値が40179の場合，DBPARTNER_SVの登録を省略できます。

DABrokerドライバ（DBPARTNER/Serverドライバ）のセットアップ手順を図2-2に示します。

図2‒2　DABrokerドライバ（DBPARTNER/Serverドライバ）のセットアップ手順

(1)　データソースのセットアップ（新規追加）

DABrokerドライバ（DBPARTNER/Serverドライバ）を使うときに，データソースを新規で追加する手順を説明します。

データソースをセットアップするときは，ODBC接続を定義する画面（［ODBCデータソースアドミニストレータ］ダイアログボックス）を開いてください。

(a)　［DBPARTNER ODBC Driver for DABroker −セットアップ−］ダイアログボックスに項目を設定

サーバにアクセスするために，接続先のサーバのセンタ名称を「データソース名」としてODBCドライバに追加します。同時に接続先の環境を設定します。

［ODBCデータソースアドミニストレータ］ダイアログボックスの［追加(D)...］ボタンをクリックします。［データソースの新規作成］ダイアログボックスが表示されます。

使う通信ドライバに応じてODBCドライバの中から選んでから［OK］ボタンをクリックします。ボタンをクリックすると，［DBPARTNER ODBC Driver for DABroker −セットアップ−］ダイアログボックスが表示されます。

［DBPARTNER ODBC Driver for DABroker−セットアップ−］ダイアログボックスに設定する項目を次に示します。

［データソース名］テキストボックス　　〜〈1〜32けたの文字列〉

データソースを識別するために任意の名称を指定します。データソース名は省略できません。

（例）東京センタ

このデータソース名は，接続するサーバをユーザが認識できるようにするための名称です。ユーザが認識できればどんな名称を指定してもかまいません。すべて全角文字（シフトJISコード）で入力するときは16文字まで，すべて半角文字（JIS8コード）で入力するときは32文字まで入力できます。全角文字と半角文字が混在してもかまいません。

［ホスト名称］テキストボックス　　〜〈1〜32けたの文字列〉

使う通信ドライバに登録されている接続先システムのインターネットアドレスに対応するホスト名称を指定します。ホスト名称は省略できません。

［接続データベース］テキストボックス　　〜〈1〜32けたの文字列〉

接続するデータベースの種別を指定します。次に示す項目から選んで指定してください。

HiRDB：HiRDBを示します。

Oracle：ORACLEを示します。

SQL Server：Microsoft SQL Serverを示します。

SQL Anywhere：Sybase Adaptive Server Anywhereを示します。

XDM/RD：XDM/RD E2を示します。

RDB1 E2：RDB1 E2を示します。

SQL/K：RDB編成ファイルを示します。

XDM/SD E2：XDM/SD E2を示します。

PDM2：PDMII E2を示します。

SQL/K SPOOL：VOSKスプールファイルを示します。

［データベース識別子］テキストボックス　　〜〈文字列〉

データベースがHiRDB又はORACLEの場合

サーバに複数のデータベースが存在するときに，接続するデータベース識別子を指定します。

HiRDBの場合

接続するHiRDBシステムのポート番号を指定します。データベースが一つでPCサーバにHiRDBのポート番号が設定してあるときは，指定しなくても接続できます。省略すると，PDNAMEPORTの値が仮定されます。

ORACLEの場合

ネットサービス名を指定します。データベースが一つしかないときは，指定は不要です。省略すると，ORACLE_SIDの値が仮定されます。

データベースがMicrosoft SQL Server，Sybase Adaptive Server Anywhereの場合

DABrokerがインストールされているマシンのシステムDSNに設定したデータソース名を指定します。

サーバプログラムがDABroker経由-RDA Link for Gatewayで，データベースがXDM/RD E2，RDB1 E2，SQL/Kの場合

RDA Link for Gatewayで定義されている，RDノード名称を指定します。

サーバプログラムがDABroker経由-Database Connection Serverで，データベースがXDM/RD E2，RDB1 E2，SQL/K，XDM/SD E2，PDMII E2の場合

指定しません。指定しても，指定した内容は無視されます。

サーバプログラムがDatabase Connection Serverで，データベースがXDM/RD E2，RDB1 E2，SQL/K，XDM/SD E2，PDMII E2の場合

Database Connection Serverで定義されている，データベース識別子を指定します。

データベースがVOSKスプールファイルの場合

指定しません。指定した場合，指定した内容は無視されます。

［データベースホスト名］テキストボックス　　〜〈文字列〉

接続するデータベースがHiRDBのとき，HiRDBのホスト名（PDHOST）を指定します。接続するデータベースがHiRDB以外の場合は不活性となります。

［送受信領域サイズ］テキストボックス　　〜〈符号なし整数〉((1〜16,000))（単位：キロバイト）

データ送受信時にDABrokerドライバが使うデータ受信用領域サイズを，1〜16,000kBの範囲で指定します。省略すると，64kBが仮定されます。

指定した値が1〜16,000の範囲外のときは，次に示す領域サイズを仮定して処理します。

指定値 ＜ 1のとき：64

指定値 ＞ 16,000のとき：16,000

送受信領域サイズは，注意に示す理由で，取り扱うデータがBLOBなどの長大なデータのとき以外は指定しないことをお勧めします。

注意

DABrokerドライバでは，指定したサイズの送受信領域を使うSQLステートメントごとに送信用，受信用それぞれ1個ずつ確保します（1ステートメントごとの指定サイズ×2のメモリを使います）。使うマシンの性能を考慮して，適正な値を指定してください。

DABrokerドライバでは，指定したサイズの受信領域に格納できる行数分の結果データを．DABrokerから一度に受け取って処理します。そのため，受信領域サイズが大きいと，一度に取得できるデータ数は多くなって，通信の発生頻度は減ります。その反面，受信領域サイズの指定が大き過ぎるときは，メモリエラーになって処理が続けられない，又はメモリの圧迫による性能劣化，さらに1回のデータ通信量の増大によってバッファ境界でのFetch性能が劣化するおそれがあります（ただし，結果的には通信オーバーヘッドは変わりません）。この項目を指定するときは，上限1,000 kB（1MB）程度に抑えて，マシンの性能を考慮した適正な値に設定してください。受信領域サイズ指定の目安を次に示します。

受信領域長 ＝ （（（行データに含まれる列データ長の合計 +（ 4 × 行データの列数 ））+ 4 ）× 一回の通信で取得する行数 ）+ 42

［DABroker経由-Database Connection Server接続］欄

DABroker経由-Database Connection Server接続を使用するかどうかを指定します。

DABroker経由-Database Connection Server接続を使用する場合，［使用する］チェックボックスをオンにします。

［データベース種別名］テキストボックス　　〜〈文字列〉

DABrokerの接続先データベース定義で定義されたデータベース種別名を指定します。

［データベース名］テキストボックス　　〜〈文字列〉

DABrokerの接続先データベース定義で定義されたデータベース名を指定します。

［ユーザ外字］欄

自PCで作成した外字とサーバのデータベースで作成した外字を対応付けるかどうかを指定します。

サーバのシフトJISコード又はEUCコードにユーザ外字を使ってODBCドライバで外字コードを変換するときは，［使用する］チェックボックスをオンにして，［選択(S)...］ボタンをクリックしてからユーザ外字変換ファイルを選びます。ユーザ外字変換ファイルの作成方法については，「2.3.3（5）ユーザ外字変換ファイルの作成方法」を参照してください。

ユーザ外字を使う指定をすると，ODBCドライバはユーザ外字変換ファイルの内容に従って，外字コードを変換します。

［EUC-SJIS変換を行わない］チェックボックス

EUC-SJIS変換をするかどうかを指定します。

サーバ側の文字コードがEUCコードの場合でODBCアプリケーションがEUCコード処理をする場合，この項目をオンにします。

この項目をオンにすると，すべてのEUC-SJIS変換が行われません。また，ユーザ外字の使用の指定も無視されます。

［Oracle接続でSQLDescribeParamを使用］チェックボックス

接続するデータベースがORACLEの場合，通常SQLDescribeParamは使用できませんが，このチェックボックスを指定すると，すべてのパラメタのSQLデータ型がSQL_VARCHAR型で出力されます。

デフォルトはチェックなしで，接続するデータベースがORACLE以外の場合はグレー表示になります。

［検索データの余分な空白文字を削除］チェックボックス

検索するデータの後ろに含まれる空白文字を削除するかどうかを指定します。削除するときは，［検索データの余分な空白文字を削除］チェックボックスをオンにしてください。

デフォルトはチェックなしです。

(b)　［DBPARTNER ODBC Driver for DABroker −環境定義−］ダイアログボックスに項目を設定

［DBPARTNER ODBC Driver for DABroker −セットアップ−］ダイアログボックスの項目を設定した後，［環境定義(E)...］ボタンをクリックします。ボタンをクリックすると，［DBPARTNER ODBC Driver for DABroker −環境定義−］ダイアログボックスが表示されます。

［DBPARTNER ODBC Driver for DABroker −環境定義−］ダイアログボックスに指定する項目を次に示します。

［通信ドライバ］テキストボックス　　〜〈文字列〉

「WINSOCK」で固定です。変更できません。

［応答監視時間］テキストボックス　　〜〈符号なし整数〉((0〜3600))《60》（単位：秒）

サーバプログラムからの応答監視時間を秒単位で指定します。ここで指定した時間を過ぎてもサーバプログラムから応答が返らないと，処理が打ち切られます。

指定を省略すると，60（秒）が仮定されます。0を指定すると，時間監視しません。

［非同期キャンセル機能を使用する］チェックボックス

このチェックボックスは無効です。このチェックボックスのチェックの有無にかかわらず，非同期キャンセルは実行されます。ODBC関数の非同期実行については，「5.7　ODBC関数の非同期実行」を参照してください。

(c)　設定の完了

［DBPARTNER ODBC Driver for DABroker −環境定義−］ダイアログボックスの項目を指定した後，［OK］ボタンをクリックします。

［DBPARTNER ODBC Driver for DABroker −セットアップ−］ダイアログボックスに戻ったら，［OK］ボタンをクリックします。

これでデータソースのセットアップは終了しました。

(2)　セットアップの中止

データソースのセットアップを中止するときは，［DBPARTNER ODBC Driver for DABroker −セットアップ−］ダイアログボックスの［キャンセル］ボタンをクリックします。ボタンをクリックすると，設定した内容は登録されません。

(3)　データソース名の変更

既に設定した内容を変更する場合は，次の手順に従ってください。

［ODBCデータソースアドミニストレータ］ダイアログボックスで変更するデータソース名を選択し，［構成(C)...］ボタンをクリックします。

［DBPARTNER ODBC Driver for DABroker −セットアップ−］ダイアログボックスが表示されます。

データソース名を変更します。

これ以降の操作は，新規追加の2．からの操作に従ってください。

(4)　データソース名の削除

データソース名を削除するときは，［ODBCデータソースアドミニストレータ］ダイアログボックスから削除するデータソース名を選んでから［削除(R)］ボタンをクリックします。

ボタンをクリックすると，データソース名が削除されます。

(5)　ユーザ外字変換ファイルの作成方法

ユーザ外字変換ファイルの作成方法について説明します。外字コードを変換するときは，次に示すテキスト形式のファイル（〜.txt）を作成します。

(a)　形式

　　　クライアントPC側外字コード1＝サーバ側外字コード1，

　　　クライアントPC側外字コード2＝サーバ側外字コード2

(b)　規則

行の先頭に空白文字を入れないでください。

クライアントPC側外字コード，サーバ側外字コードとも，16進数表記で指定してください。16進数を示す先頭の「0x」は付けないでください。

（例）「0xF040」は「F040」と記述してください。

コードに小文字は使えません。

（例）「0xf040」は「F040」と記述してください。

使える文字は，半角英数字と半角スペースです。使える文字数を次に示します。

サーバがEUCコードの場合：4文字又は6文字（例：F040，8FA1A1）

サーバがシフトJISコードの場合：4文字（例：F040）

指定できる外字コードの範囲を次に示します。範囲については，サーバのOSがサポートする外字コードの範囲を確認してください。

クライアントPCの文字コード：F040〜F9FC（ただし，外字エディタで使える範囲に限ります）

サーバの文字コード：任意（指定が妥当かどうかは，チェックされません）

「＝」の前後に空白文字を記述できます。

1行に複数のコードを記述できます。複数のコードを記述するときは，「，」で区切ってください。

改行は，区切りを示す「，」の直後だけでできます。

同じ変換前外字コードを複数回定義したときは，最後に定義したコードが有効になります。

「#」から改行するまでは，コメント行とみなされます。コメント行も，行の先頭に空白文字を入れないでください。

(c)　ユーザ外字変換ファイルの記述例

　　　# ユーザ定義文字マッピング（SJIS<->EUC）

　　　F040＝8FA1A1

　　　F041＝F5A1

　　　# END

(d)　注意

ユーザ外字変換ファイルに指定したコード範囲が妥当かどうかは，チェックしません。また，変換する外字として使える文字コードの範囲は，サーバ側のシステムに依存します。ユーザ外字変換ファイルに文字コードを指定するときは，サーバ側のシステムのOSやDBMSのマニュアルを参照して，サポートする文字コードの範囲を事前に確認してください。

ユーザ外字変換ファイルは，サーバ側のシステムとの接続を開始するときに読み込まれます。このため，ユーザ外字変換ファイルの内容を変更したときは，サーバ側のシステムとの接続をいったん解除してから，再び接続してください。

2.4　マクロスクリプトの設定（CommuniNet接続の場合）

CommuniNet接続のDBPARTNER2 ClientのActiveXコントロールを使ってアプリケーションを開発するときには，CommuniNetをインストールする必要があります。

2.4.1　CommuniNetのインストールの手順

CommuniNetをインストールするときは，［コントロールパネル］を閉じてから実行してください。

CommuniNetのセットアップについては，該当するCommuniNetのマニュアルを参照してください。

2.4.2　マクロスクリプトファイルの作成

CommuniNet接続でDBPARTNER2 Clientを使うときは，HOAPDBS E2やACE3 E3などのサーバプログラムにログオン，ログオフするためのマクロスクリプトを設定する必要があります。マクロスクリプトをCommuniNetで実行させると，オンライン画面で実行するログオン，ログオフなどのキー入力操作を自動的に実行できます。

マクロスクリプトについては，CommuniNetのマニュアルを参照してください。

(1)　マクロスクリプトファイルの例

ログオン，ログオフの操作はTSSの設定で異なるので，次の例を参考に作成してください。

マクロスクリプトファイルのサンプルは，DBPARTNER2 Clientのフォルダ¥Samplesフォルダに格納してあります。ファイルの内容を必要に応じて修正して使うと，最初からマクロスクリプトファイルを作成する手間が省けます。

(a)　サーバプログラムがVOS3 HOAPDBS E2の例

このサンプルは，VOS3 HOAPDBS E2を使うときの例です。データベースにはVOS3 XDM/RD E2，VOS3 XDM/SD E2を使えます。

LOGONマクロスクリプト

# Begin Logon Macro
# WRITEコマンド,SENDコマンドを実行する前には,
# ステータスが"キーOK"になるのを待ちます。
AWAIT KEYOK
SEND SRQ
AWAIT KEYOK
WRITE (1,1) "LOGON "
WRITE %1
WRITE "/"
WRITE %2
WRITE " S(5000) G(GENKA)"
SEND  EXEC
RECEIVE (1,10) "READY"
# 画面に"READY"が表示されるのを待ちます。
# 環境によってカーソル位置,文字列を変更してください。
AWAIT KEYOK
WRITE "SETCS &¥¥HOAPDBSPCDBID VALUE(XRDA)" ※
SEND EXEC
AWAIT KEYOK
WRITE "HDBPC" ※
SEND EXEC
# End

注※　この部分に指定する値については，マニュアル「VOS3 統合情報管理共通サービス　HOAPSERV 運用の手引」を参照してください。

LOGOFFマクロスクリプト

# Begin Logoff Macro
AWAIT KEYOK
WRITE "LOGOFF"
SEND EXEC
AWAIT KEYOK
# End

(b)　サーバプログラムがVOS3 ACE3 E3の例

このサンプルは，VOS3 ACE3 E3を使うときの例です。データベースにはVOS3 PDMII E2，VOS3 ユーザファイル，VOS3 RDB1を使えます。

LOGONマクロスクリプト

# Begin Logon Macro
# WRITEコマンド,SENDコマンドを実行する前には,
# ステータスが"キーOK"になるのを待ちます。
AWAIT KEYOK
SEND SRQ
AWAIT KEYOK
WRITE (1,1) "LOGON"
WRITE %1
WRITE "/"
WRITE %2
WRITE " S(5000) G(GENKA)"
SEND  EXEC
# 画面に"READY"が表示されるのを待ちます。
# 環境によってカーソル位置,文字列を変更してください。
RECEIVE (1,10) "READY"

 ※1
AWAIT KEYOK
WRITE "SETCS &¥¥ACE3E3PCUSID V('"
WRITE %1
WRITE ")"
SEND EXEC
AWAIT KEYOK
WRITE "SETCS &¥¥ACE3E3PCPSWD V('"
WRITE %2
WRITE ")"
SEND EXEC

 ※2
AWAIT KEYOK
WRITE "SETCS &¥¥ACE3E3PCLINK V('YES')" ※3
SEND EXEC
AWAIT KEYOK

AWAIT KEYOK
WRITE "ACE3E3" ※3
SEND EXEC
# End

注※1　サーバにTRUSTを組み込んでいないときは，この指定が必要です。

注※2　VOS3 ACE3 E3の環境を作成して，ACE3OPTマクロにPCLINK＝YESを指定したときは，この指定は不要です。

注※3　この部分の指定については，マニュアル「VOS3 エンドユーザ言語 ACE3 E3 運用編」を参照してください。

LOGOFFマクロスクリプト

# Begin Logoff Macro
AWAIT KEYOK
WRITE "LOGOFF"
SEND EXEC
AWAIT KEYOK
# End

(c)　サーバプログラムがVOS1 DBPARTNER/Linkの例

このサンプルは，VOS1 DBPARTNER/Linkを使うときの例です。データベースにはVOS1 PDMII E2，VOS1ユーザファイル，VOS1スプールファイルを使えます。

LOGONマクロスクリプト

# Begin Logon Macro
# 端末とES/IEXを接続します。
SEND EXEC
RECEIVE (1,2) "JCK071I ENTER LOGON"
AWAIT KEYOK
WRITE (1,2)   "LOGON IEX          "
SEND EXEC
# セション選択画面の表示を待ち,ユーザID,パスワード,セション名を入力
# します。
RECEIVE (1,14) "セション選択画面"
AWAIT KEYOK
WRITE (21,18) %1
WRITE (21,58) %2
WRITE (22,18) "ACE3001"
SEND EXEC
# マスタメニュー画面の表示を待ち,ACE3 E2を起動します。
RECEIVE (2,2) "JMASTER" ※
AWAIT KEYOK
WRITE (22,13) "@@ACE3 CPROC=ACE3DCT,DBUSE=P,MODE=DBPARTNER" ※
SEND EXEC
# END

注※　この部分の指定については，マニュアル「VOS1 エンドユーザ言語 ACE3 E2 運用の手引」を参照してください。

LOGOFFマクロスクリプト

# Begin Logoff Macro
# マスタメニュー画面の表示を待ち,"6.セションの終了"を入力します。
RECEIVE (2,2) "JMASTER"
AWAIT KEYOK
WRITE (22,13) "6"
SEND EXEC
# セションの終了画面の表示を待ち,"1.このメニューを実行中のセションの終
# 了"を選択します。
RECEIVE (2,2) "JUSESSI"
AWAIT KEYOK
WRITE (4,46) "1"
SEND EXEC
#セション選択画面の表示を待ち,入力行へLOGOFFを入力します。
RECEIVE (1,14) "セション選択画面"
AWAIT KEYOK
WRITE (24,13) "LOGOFF"
SEND EXEC
#"JIC101I"メッセージの表示を待ちます。
RECEIVE (20,3) "JIC101I"
AWAIT KEYOK
SEND EXEC
# オンラインモードに戻ったことを確認します。
RECEIVE (1,2) "JCK071I ENTER LOGON"
AWAIT KEYOK
# END

(d)　サーバプログラムがVOSK HOAPDBS/PCの例

このサンプルは，VOSK HOAPDBS/PCを使うときの例です。データベースにはVOSK RDB編成ファイル，VOSKスプールファイルを使えます。

LOGONマクロスクリプト

# Begin Logon Macro
# "ログオン画面"が表示されるのを待ちます。
RECEIVE (1,36) "ログオン画面"
# 環境によってログオン画面の表示が完了するまでに時間が掛かり,
# 完了しないまま SENDコマンドを実行するとエラーになります。
# ログオン画面が表示完了するまでに時間が掛かる場合は,
# PAUSEコマンドでマクロスクリプトの実行を一時中断してください。
# PAUSE 3
AWAIT KEYOK
WRITE (3,27) "1"
WRITE (6,27) %1
WRITE (6,57) %2
WRITE (7,27) "#HDBSPC"
SEND EXEC
RECEIVE (22,3) "コマンド"
# WRITEコマンド,SENDコマンドを実行する前には,
# ステータスが"キーOK"になるのを待ちます。
AWAIT KEYOK
WRITE (22,14) "DEF HDBID,DBID=RDFA" ※
SEND EXEC
AWAIT KEYOK
WRITE (22,14) "HDBPC" ※
SEND EXEC
# End

注※　この部分の指定については，マニュアル「VOSK システムOA」を参照してください。

LOGOFFマクロスクリプト

# Begin Logoff Macro
AWAIT KEYOK
WRITE (22,14) "LOGOFF"
SEND EXEC
RECEIVE (1,36) "ログオン画面"
# End

第3編　ODBC接続のActiveXコントロール

3　アプリケーションを使ったデータベースアクセス（ODBC接続）

この章では，DBPARTNER2 ClientのアプリケーションからActiveXコントロールのオブジェクトを使ってデータベースにアクセスする方法（ODBC接続）について説明します。

3.1　DBPARTNER2 Clientが提供するActiveXコントロールの概要

DBPARTNER2 Clientのアプリケーションを作成するときは，DBPARTNER2 Clientが提供するActiveXコントロールのオブジェクトを使います。オブジェクトを使って，データベースからデータを抽出したり，更新したりできます。

3.1.1　ActiveXコントロールのオブジェクトの階層

ActiveXコントロールのオブジェクトの階層を図3-1に，オブジェクトの説明を表3-1に示します。複数形のオブジェクト名（Tables，Columns など）は，下位のオブジェクトを管理するコレクションオブジェクトです。

図3‒1　DBPARTNER2 Clientが提供するActiveXコントロールのオブジェクトの階層

表3‒1　DBPARTNER2 Clientが提供するActiveXコントロールのオブジェクトの説明

オブジェクト

説明

DBPARTNER

サーバプログラムとの接続を管理するオブジェクトです。

SQLDirect

ユーザが作成するSQL文の実行を管理するオブジェクトです。

Result

抽出データを管理するオブジェクトです。

TableList

表情報を管理するオブジェクトです。

ColumnList

列情報を管理するオブジェクトです。

QueryDefine

抽出処理を実行するオブジェクトです。

Tables

Tableオブジェクトを管理するコレクションオブジェクトです。

Table

抽出表を管理するオブジェクトです。

Columns

Columnオブジェクトを管理するコレクションオブジェクトです。

Column

抽出列を管理するオブジェクトです。

Conditions

Conditionオブジェクトを管理するコレクションオブジェクトです。

Condition

抽出条件を管理するオブジェクトです。

UpdateDefine

更新処理を実行するオブジェクトです。

Updates

Updateオブジェクトを管理するコレクションオブジェクトです。

Update

変更行条件，変更情報を管理するオブジェクトです。

Inserts

Insertオブジェクトを管理するコレクションオブジェクトです。

Insert

追加情報を管理するオブジェクトです。

Deletes

Deleteオブジェクトを管理するコレクションオブジェクトです。

Delete

削除行条件を管理するオブジェクトです。

Catalog

手順ファイルを管理するオブジェクトです。

VariableList

手順ファイルの可変値を管理するオブジェクトです。

Procedure

ストアドプロシジャを実行するオブジェクトです。

ParamList

ストアドプロシジャのパラメタ一覧を管理するオブジェクトです。

ProcedureList

ストアドプロシジャ一覧を管理するオブジェクトです。

注意事項

DBPARTNER2 ClientのActiveXコントロールのオブジェクトには，使い方に制限があります。制限については，「3.12　避けて欲しい処理」を参照してください。

3.1.2　プロパティとメソッドの表記

ActiveXコントロールのオブジェクトに属するプロパティとメソッドは，「オブジェクト名．プロパティ又はメソッド名」で示します。

（例）DBPARTNERオブジェクトのConnectメソッドの表記

DBPARTNER.Connectメソッド

ビジュアル開発ツールでは，オブジェクト名を「.」（ピリオド）で表記できます。そのため，このマニュアルでプロパティ又はメソッド名にオブジェクト名を付けて表記するときは，オブジェクト名を斜体文字にしています。

このマニュアルでは，Visual Basicでアプリケーションを開発することを想定して説明します。ほかのビジュアル開発ツールを使ってアプリケーションを作成するときは，マニュアルの記述を読み替えてください。

3.1.3　アプリケーションのサンプル

DBPARTNER2 Clientでは，次に示すフォルダ下にサンプルを提供しています。

DBPARTNER2 Clientのフォルダ¥Ocx¥Samples

サンプルでは，テキストボックスやリストボックスも実装しています。DBPARTNER2 Clientの詳しいアプリケーションの処理については，サンプルを参照してください。

3.1.4　アプリケーションの作成

ActiveXコントロールを使用したアプリケーションを開発するためのプログラムとして，AP作成ウィザードを提供しています。AP作成ウィザードを使用すると，データベースからデータを抽出するアプリケーションが簡単に作成できます。AP作成ウィザードについては，「付録A　AP作成ウィザード」を参照してください。

3.2　データベースアクセスの手順

DBPARTNER2 Clientが提供するActiveXコントロールのオブジェクトを使って，データベースにアクセスする方法について説明します。DBPARTNER2 Clientからデータベースにアクセスする手順の概要を図3-2に示します。

図3‒2　DBPARTNER2 Clientからデータベースにアクセスする手順の概要

データベースにアクセスするときは，トランザクションと排他制御の知識が必要です。トランザクションと排他制御については，「3.4　トランザクションと排他制御（DBPARTNERオブジェクト）」を参照してください。

ActiveXコントロールのオブジェクトの文法については，「4.　DBPARTNER2 Clientのオブジェクトの文法（ODBC接続）」を参照してください。

サンプルの参照先

DBPARTNERオブジェクトは，抽出／更新で使います。サンプルについては，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Odbcフォルダを参照してください。

3.2.1　DBPARTNERオブジェクトのプロパティの設定

DBPARTNERオブジェクトは，DBPARTNER2 Clientのトップオブジェクトです。データベースに接続する前に，DBPARTNERオブジェクトのプロパティを設定してください。

(1)　DBPARTNERオブジェクトのプロパティに設定する内容

DBPARTNERオブジェクトのプロパティを次に示します。

DBPARTNER.CommitModeプロパティ

トランザクションの終了モードを設定します。

DBPARTNER.ConnectDialogModeプロパティ

データベースと接続するときに，ユーザIDとパスワードの入力を要求するダイアログボックスを表示するかどうかを設定します。

DBPARTNER.DataSourceプロパティ

データソース名を設定します。ODBCドライバのセットアップで設定したデータソース名を設定してください。

DBPARTNER.UserIDプロパティ

ユーザIDを設定します。

DBPARTNER.Passwordプロパティ

パスワードを設定します。

3.3　データベースへの接続と接続の解除（DBPARTNERオブジェクト）

DBPARTNER2 Clientとデータベースを接続する方法と接続を解除する方法について説明します。DBPARTNER2 Clientとデータベースを接続するときは，サーバプログラム（DABroker又はDatabase Connection Server）が必要です。DBPARTNER2 Clientがサーバプログラムに接続すると，データベースに接続されたことになります。

3.3.1　データベースへの接続

DBPARTNER2 Clientからデータベースに接続するときは，DBPARTNER.Connectメソッドを使います。DBPARTNER.Connectメソッドは，データソース名（DBPARTNER.DataSourceプロパティ），ユーザID（DBPARTNER.UserIDプロパティ），パスワード（DBPARTNER.Passwordプロパティ）を参照して，データベースに接続します。

それぞれのプロパティを変更すると，接続するデータベースを変更できます。

データベースと接続するときにデータベース又はサーバプログラムが起動されていないときは，エラーメッセージが表示されます。

(1)　複数のデータベースにアクセスするとき

一つのアプリケーションから，複数のデータベースにアクセスできます。例えば，HiRDBの「支店データベース」と「全社データベース」の両方にアクセスしたり，HiRDBとORACLEなど別の種類のデータベースにアクセスしたりできます。

複数のデータベースにアクセスするときは，ODBCドライバで複数のデータソース名を指定します。そして，それぞれのデータベースごと（データソース名ごと）にDBPARTNERオブジェクトをデータベースの数だけ実行して，DBPARTNER.Connectメソッドを実行します。このとき，トランザクションはデータベース単位で管理されます。

(2)　データベースとの接続の確認

DBPARTNER2 Clientとサーバプログラムが接続されているかどうかは，DBPARTNER.lsConnectプロパティを参照して確認できます。

3.3.2　データベースへのアクセスのキャンセル

DBPARTNER2 Clientからデータベースへのアクセス処理をキャンセルするときは，DBPARTNER.Cancelメソッドを使います。DBPARTNER.Cancelメソッドを実行できる条件とキャンセル後の格納データについては，「4.　DBPARTNER2 Clientのオブジェクトの文法（ODBC接続）」のDBPARTNER.Cancelメソッドの説明を参照してください。

3.3.3　データベースとの接続の解除

DBPARTNER2 Clientとデータベースの接続を解除するときは，DBPARTNER.Disconnectメソッドを使います。DBPARTNER.Disconnectメソッドを使った後は，接続していたデータベースへの処理はすべてエラーになります。

抽出処理を実行している間にDBPARTNER.Disconnectメソッドを使うと，メソッドがエラーになります。また，DBPARTNER.Connectメソッドで接続していないデータベースにDBPARTNER.Disconnectメソッドを実行しても無視されます（エラーになりません）。

3.4　トランザクションと排他制御（DBPARTNERオブジェクト）

アプリケーションでトランザクションを制御するときの手順について説明します。

3.4.1　トランザクションの制御の設定

トランザクションをDBPARTNER2 Clientで自動的に制御するか，アプリケーションからトランザクションを制御するかは，DBPARTNER.CommitModeプロパティに設定します。

(1)　DBPARTNER2 Clientで自動的にトランザクションを制御するとき

DBPARTNER2 Clientで自動的にトランザクションを制御するときは，DBPARTNER.CommitModeプロパティにdbpAutoを設定します。dbpAutoを設定すると，データベースアクセスのトランザクションをDBPARTNER2 Clientのアプリケーションから意識する必要はありません。

(2)　アプリケーションからトランザクションを制御するとき

アプリケーションからメソッドを使ってトランザクションを制御するときは，DBPARTNER.CommitModeプロパティにdbpManualを設定して，DBPARTNER.Commitメソッド又はDBPARTNER.Rollbackメソッドを使います。

DBPARTNER2 Clientは，データベースへのアクセス処理（表の参照，SQLの実行など）をExecuteメソッドで実行してからDBPARTNER.Commitメソッド又はDBPARTNER.Rollbackメソッドの実行までを，1件のトランザクションとして扱います。DBPARTNER.Commit又はDBPARTNER.Rollbackが成功すると，その時点から次のトランザクションが開始されます。データベースにアクセスし直す必要はありません。

トランザクションを終了させないでオブジェクトを削除，又はデータベースとの接続を切断すると，DBPARTNER2 Clientがアプリケーションの処理が異常と判断してDBPARTNER.Rollbackメソッドの処理を自動的に実行します。

3.4.2　排他制御

DBPARTNER2 Clientのアプリケーションからデータを抽出／更新するときには，ほかのアプリケーションからのアクセスを許すかどうかを設定します。これを排他制御といいます。

(1)　排他制御の設定

排他制御は，データにアクセスするプロパティ（QueryDefine.Exclusiveプロパティ又はUpdateDefine.Exclusiveプロパティ）に文字列で設定します。アクセスするデータベースによって，設定する内容が異なります。設定する内容については，アクセスするデータベースのマニュアルを参照してください。

(2)　排他エラーになったときの動作の設定

データにアクセスしようとした場合に，ほかのアプリケーションがデータを確保しているときは，データが解放されるまで待つか，エラーにするかを選べます。どちらにするかは，データにアクセスするプロパティ（QueryDefine.Exclusiveプロパティ又はUpdateDefine.Exclusiveプロパティ）に設定します。

データが解放されるまで待つ設定をすると，複数のアプリケーションが互いが確保しているデータの解放を待ち続ける状態（デッドロック）になるおそれがあります。デッドロックにならないように，複数のアプリケーション間でデータを確保する順番を決めておいてください。さらに，複数のアプリケーションからデータベースにアクセスするときは，確保するデータの範囲を最小限に抑えてください。

エラーにする設定をするときは，データベースアクセスごとにエラーの対処（一定時間を空けてリトライをするなど）が必要になります。

3.5　表と列の情報の取得（TableListオブジェクト，ColumnListオブジェクト）

データを抽出する前に表と列の情報を取得して，どのように抽出するかを決めます。情報には，表情報と列情報があります。

3.5.1　表情報の取得

表情報を取得するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，TableListオブジェクトを使います。

表情報を取得するときのオブジェクトの流れとプロパティとメソッドの実行手順を図3-3に示します。

図3‒3　表情報を取得するときのオブジェクトの流れとプロパティとメソッドの実行手順

サンプルの参照先

TableListオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Odbc¥Queryフォルダを参照してください。

(1)　表情報を取得する手順

表情報を取得する手順を次に示します。

見出し辞書を使用しない場合

次に示すTableListオブジェクトのプロパティを設定します。

TableList.Patternプロパティ：絞り込み条件を設定します。

TableList.CountLimitプロパティ：取得する表情報の個数を設定します。

TableList.Getメソッドで，表情報の取得を実行します。TableList.Getメソッドを実行すると，次に示すプロパティの値を参照できます。

TableList.Countプロパティ：取得した表情報の個数。

TableList.TableNameプロパティ：取得した表の名前。

TableList.TableTypeプロパティ：取得した表の属性。

TableList.TableOwnerプロパティ：取得した表の所有者。

TableList.TableCommentプロパティ：取得した表の注釈。

TableList.TableCreateDateプロパティ：取得したVOSKスプールファイルの作成日付。

TableList.TableGroupNameプロパティ：取得した表のグループ名。

TableList.TableHeaderプロパティ：取得した表のラベル。

上記のプロパティから，必要な情報を参照してください。

見出し辞書を使用する場合

次に示すオブジェクトのプロパティを設定します。

DBPARTNER.DictPathプロパティ：使用する見出し辞書のパスを設定します。

DBPARTNER.TableDefSourceプロパティ：表情報の取得元を設定します。

TableList.SelectDictプロパティ：使用する見出し辞書を限定します。

TableList.Patternプロパティ：絞り込み条件を設定します。

TableList.CountLimitプロパティ：取得する表情報の個数を設定します。

TableList.Getメソッドで，表情報の取得を実行します。TableList.Getメソッドを実行すると次に示すプロパティの値を参照できます。

TableList.TableDataSourceプロパティ：接続先の名称を取得します。

TableList.Countプロパティ：取得した表情報の個数。

TableList.TableNameプロパティ：取得した表の名前。

TableList.TableTypeプロパティ：取得した表の属性。

TableList.TableOwnerプロパティ：取得した表の所有者。

TableList.TableCommentプロパティ：取得した表の注釈。

TableList.TableCreateDateプロパティ：取得したVOSKスプールファイルの作成日付。

TableList.TableGroupNameプロパティ：取得した表のグループ名。

TableList.TableHeaderプロパティ：取得した表のラベル。

上記のプロパティから，必要な情報を参照してください。

(2)　注意

TableList.PatternプロパティとTableList.CountLimitプロパティは，TableList.Getメソッドを実行する前に設定してください。TableList.Getメソッドを実行した後に変更しても，無視されます。

3.5.2　列情報の取得

列情報を取得するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，ColumnListオブジェクトを使います。

表情報を取得するときのオブジェクトの流れとプロパティとメソッドの実行手順を図3-4に示します。

図3‒4　列情報を取得するときのオブジェクトの流れとプロパティとメソッドの実行手順

サンプルの参照先

ColumnListオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Odbc¥Queryフォルダを参照してください。

(1)　列情報を取得する手順

列情報を取得する手順を次に示します。

見出し辞書を使用しない場合

次に示すColumnListオブジェクトのプロパティを設定します。

ColumnList.Tablenameプロパティ：列情報を取得する表の名前を設定します。

ColumnList.CountLimitプロパティ：取得する列情報の個数を設定します。

ColumnList.Getメソッドで，列情報の取得を実行します。ColumnList.Getメソッドを実行すると，次に示すプロパティの値を参照できます。

ColumnList.Countプロパティ：取得した列の個数。

ColumnList.ColumnNameプロパティ：取得した列の名前。

ColumnList.ColumnTypeプロパティ：取得した列の属性。

ColumnList.ColumnLengthプロパティ：取得した列の定義長。

ColumnList.ColumnScaleプロパティ：取得した列の小数点以下のけた数。

ColumnList.ColumnCommentプロパティ：取得した列の注釈。

ColumnList.ColumnHeaderプロパティ：取得した列のラベル。

上記のプロパティから，必要な情報を参照してください。

見出し辞書を使用する場合

次に示すオブジェクトのプロパティを設定します。

DBPARTNER.DictPathプロパティ：使用する見出し辞書のパスを設定します。

DBPARTNER.TableDefSourceプロパティ：列情報の取得元を設定します。

TableList.SelectDictプロパティ：使用する見出し辞書を限定します。

ColumnList.Tablenameプロパティ：列情報を取得する表の名前を設定します。

ColumnList.CountLimitプロパティ：取得する列情報の個数を設定します。

ColumnList.Getメソッドで，列情報の取得を実行します。ColumnList.Getメソッドを実行すると，次に示すプロパティの値を参照できます。

ColumnList.Countプロパティ：取得した列の個数。

ColumnList.ColumnNameプロパティ：取得した列の名前。

ColumnList.ColumnTypeプロパティ：取得した列の属性。

ColumnList.ColumnLengthプロパティ：取得した列の定義長。

ColumnList.ColumnScaleプロパティ：取得した列の小数点以下のけた数。

ColumnList.ColumnCommentプロパティ：取得した列の注釈。

ColumnList.ColumnHeaderプロパティ：取得した列のラベル。

上記のプロパティから，必要な情報を参照してください。

(2)　注意

ColumnList.TableNameプロパティとColumnList.CountLimitプロパティは，ColumnList.Getメソッドを実行する前に設定してください。ColumnList.Getメソッドを実行した後に変更しても，無視されます。

3.6　データの抽出（QueryDefineオブジェクト）

DBPARTNER2 ClientのオブジェクトQueryDefineを使って，データを抽出する方法について説明します。データを抽出するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，QueryDefineオブジェクトを使います。

QueryDefineオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順を図3-5に示します。

図3‒5　QueryDefineオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順

サンプルの参照先

QueryDefineオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Odbc¥Queryフォルダを参照してください。

3.6.1　QueryDefineオブジェクトを使ってデータを抽出する手順

QueryDefineオブジェクトを使ってデータを抽出する手順を次に示します。

次に示すオブジェクトに，抽出データに関する条件を設定します。

Tablesコレクションオブジェクト：下位にある複数のTableオブジェクトに，抽出表の名称を設定します。TableオブジェクトのTableNameプロパティに，抽出表の名称を設定します。

Columnsコレクションオブジェクト：下位にある複数のColumnオブジェクトに，抽出列の名称を設定します。ColumnオブジェクトのColumnNameプロパティに，抽出列の名称を，SortModeプロパティとSortPriorityプロパティにソートする条件を，FunctionModeプロパティに集合関数を設定します。

Conditionsコレクションオブジェクト：下位にある複数のConditionオブジェクトに，抽出条件式を設定します。ConditionオブジェクトのTextプロパティに抽出条件式を設定します。

QueryDefine.Exclusiveプロパティに，排他モードを設定します。

QueryDefine.Executeメソッドで，抽出を実行します。

Resultオブジェクトで，抽出データを処理します。Resultオブジェクトの使い方については，「3.7　抽出データの管理（Resultオブジェクト）」を参照してください。

3.7　抽出データの管理（Resultオブジェクト）

SQLDirect.Executeメソッド又はQueryDefine.Executeメソッドを実行して抽出したデータを処理する方法について説明します。抽出データを処理するときは，Resultオブジェクトを使います。

サンプルの参照先

Resultオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Odbc¥Queryフォルダ又はDBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Odbc¥Updateフォルダを参照してください。

3.7.1　抽出データの格納手順

Resultオブジェクトを使って，抽出データを格納する手順について説明します。

(1)　抽出データを格納する方法

抽出データを格納する手順を次に示します。

次に示すResultオブジェクトのプロパティを設定します。

Result.QueryCountLimitプロパティ：抽出処理の結果として出力する行数を設定します。

Result.DataCheckプロパティ：抽出データの文字コードをチェックするかどうかを設定します。

Result.HeaderOutputプロパティ：抽出データの先頭行に，列名を付けるかどうかを設定します。

Result.FieldCodeTypeプロパティ：抽出データを取得するときのデータ型を設定します。Result.FieldCodeTypeプロパティの設定内容と抽出できるデータ型の関係については，「3.7.2　Resultオブジェクトと取得するデータの関係」を参照してください。

1行ずつデータを抽出するときは，Result.Getメソッドを実行します。Result.Getメソッドを実行すると，次に示すプロパティの値を参照できます。

Result.RecordHeaderプロパティ：抽出処理の結果として出力される列名。

Result.RecordDataプロパティ：抽出データ。1行単位で返します。

Result.FieldDataプロパティ：文字列型の抽出データ。1列単位で返します。

Result.FieldDataBプロパティ：バイト型の抽出データ。1列単位で返します。

Result.FieldTypeプロパティ：列の属性。

Result.FieldDataLengthプロパティ：列のデータ長。

Result.FieldCountプロパティ：抽出データの列数。

必要に応じて，次に示すプロパティを設定します。

Result.FieldHeaderプロパティ：列にヘッダを設定します。

抽出データを一括してファイルに出力するときは，Result.SaveToFileメソッドを実行します。メソッドには，抽出するデータの形式（TXT形式，CSV形式，XLS形式，DAT形式）を設定します。

抽出データがLONG VARBINARY属性のデータのときは，Result.SaveLargeObjectメソッドを使ってください。

いったんクリップボードに退避するときは，Result.CopyToClipboardメソッドを実行します。メソッドには，抽出するデータの形式（TXT形式，XLS形式）を設定します。クリップボードに退避した抽出データは，Excelなどのアプリケーションに貼り付けて使えます。

データをすべて取得できたかどうかは，Result.EOFプロパティで判定します。抽出処理を途中で終了させるときは，Result.Closeメソッドを実行します。

3.7.2　Resultオブジェクトと取得するデータの関係

Resultオブジェクトのプロパティ／メソッドと，取得するデータの関係について説明します。

(1)　列属性とデータ取得の関係

列属性とデータの取得に使うプロパティ／メソッドによって，プロパティ／メソッドが使えるかどうか，又はプロパティ／メソッドに戻る値が異なります。

列属性とデータ取得の関係を表3-2に示します。FieldCodeTypeプロパティを使ってデータを取得するときは，「（2）FieldCodeTypeプロパティに設定した値とデータ取得の関係」を参照してください。

表3‒2　列属性とデータ取得の関係

プロパティ／メソッド

列属性

dbpTypeLONGVARBINARY

dbpTypeVARBINARY

dbpTypeBINARY

左記以外の列属性

FieldDataプロパティ

データの長さ

×

文字列型のデータ

FieldDataBプロパティ

バイト型のデータ

バイト型のデータ

×

RecordDataプロパティ

データの長さ

データの長さ

文字列型のデータ

SaveToFileメソッド

データの長さ

データの長さ

文字列型のデータ

CopyToClipboardメソッド

データの長さ

データの長さ

文字列型のデータ

SaveLargeObjectメソッド

バイト型のデータ

×

×

（凡例）

×：プロパティ／メソッドでは使えない列属性です。

(2)　FieldCodeTypeプロパティに設定した値とデータ取得の関係

FieldCodeTypeプロパティの取得モードに取得するデータ型を設定したときは，取得モードとデータの取得に使うプロパティ／メソッドによって，取得できるかどうか，又は戻る値が異なります。FieldCodeTypeプロパティに設定した値とデータ取得の関係を表3-3に示します。

表3‒3　FieldCodeTypeプロパティに設定した値とデータ取得の関係

FieldCodeType

プロパティの属性

プロパティ／メソッド

取得モード

dbpTypeCHAR

dbpTypeBINARY

dbpTypeLONGVARBINARY

FieldDataプロパティ

dbpTypeLONGVARBINARYの列には，dbpTypeCHARは設定できません。

×

FieldDataBプロパティ

バイト型のデータ

RecordDataプロパティ

データの長さ

SaveToFileメソッド

データの長さ

CopyToClipboardメソッド

データの長さ

SaveLargeObjectメソッド

×

dbpTypeVARBINARY，

dbpTypeBINARY

FieldDataプロパティ

文字列型のデータ

×

FieldDataBプロパティ

×

バイト型のデータ

RecordDataプロパティ

文字列型のデータ

データの長さ

SaveToFileメソッド

文字列型のデータ

データの長さ

CopyToClipboardメソッド

文字列型のデータ

データの長さ

SaveLargeObjectメソッド

×

×

上記以外の属性

FieldDataプロパティ

文字列型のデータ

×

FieldDataBプロパティ

×

バイト型のデータ

RecordDataプロパティ

文字列型のデータ

×

SaveToFileメソッド

文字列型のデータ

×

CopyToClipboardメソッド

文字列型のデータ

×

SaveLargeObjectメソッド

×

×

（凡例）

×：プロパティ／メソッドでは使えない列属性です。

3.7.3　FieldCodeTypeプロパティで取得するデータ

Result.FieldCodeTypeプロパティで設定する取得モードと列属性の関係を表3-4に示します。

表3‒4　FieldCodeTypeプロパティで設定する取得モードと列属性の関係

列属性の文字定数

FieldCodeTypeプロパティで設定する取得モード

dbpTypeCHAR

dbpTypeBINARY

dbpTypeCHAR

◎

○

dbpTypeNUMERIC

◎

○

dbpTypeDECIMAL

◎

○

dbpTypeINTEGER

◎

○

dbpTypeSMALLINT

◎

○

dbpTypeFLOAT

◎

○

dbpTypeREAL

◎

○

dbpTypeDOUBLE

◎

○

dbpTypeDATE

◎

○

dbpTypeTIME

◎

○

dbpTypeTIMESTAMP

◎

○

dbpTypeVARCHAR

◎

○

dbpTypeLONGVARCHAR

◎

○

dbpTypeBINARY

○

◎

dbpTypeVARBINARY

○

◎

dbpTypeLONGVARBINARY

×

◎

dbpTypeBIGINT

◎

○

dbpTypeTINYINT

◎

○

dbpTypeBIT

◎

○

dbpTypeNCHAR

◎

○

dbpTypeNVARCHAR

◎

○

dbpTypeLONGNVARCHAR

◎

○

dbpTypeMCHAR

◎

○

dbpTypeMVARCHAR

◎

○

dbpTypeLONGMVARCHAR

◎

○

dbpTypeNUMERICUNS

◎

○

（凡例）

◎：設定できます（省略時仮定値を示します）。

○：設定できます。

×：設定できません。

3.8　データの更新（UpdateDefineオブジェクト）

DBPARTNER2 ClientのオブジェクトUpdateDefineを使って，データを更新する方法です。データを更新するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，UpdateDefineオブジェクトを使います。

データの更新は，更新版と定義版のDBPARTNER2 Clientで実行できます。参照版のDBPARTNER2 Clientでは，データの更新はできません。

UpdateDefineオブジェクトを使った更新のオブジェクトの流れとプロパティとメソッドの実行手順を図3-6に示します。

図3‒6　UpdateDefineオブジェクトを使った更新のオブジェクトの流れとプロパティとメソッドの実行手順

サンプルの参照先

UpdateDefineオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Odbc¥Updateフォルダを参照してください。

3.8.1　データを更新する手順

UpdateDefineオブジェクトを使ってデータを更新（変更，追加，削除）する手順について説明します。

(1)　UpdateDefineオブジェクトを使ってデータを更新する手順（変更）

UpdateDefineオブジェクトを使ってデータを更新（変更）する手順を次に示します。

次に示すプロパティを設定します。

UpdateDefine.Exclusiveプロパティ：排他モードを設定します。

UpdateDefine.UpdateModeプロパティ：更新実行モードを設定します。

UpdateDefine.TableNameプロパティ：更新する表の名前を設定します。

UpdateDefine.NCharPrefixModeプロパティ：プレフィックス "N" を付けるかどうかを設定します。

UpdateDefine.Updates.Addメソッドで，Updateオブジェクトを生成します。

Updatesコレクションオブジェクト下のUpdateオブジェクトに，変更するデータに関する条件を設定します。

UpdateDefine.Update.UpdateValueプロパティ：文字列型のデータの変更行条件を設定します。

UpdateDefine.Update.UpdateValueBプロパティ：バイト型のデータの変更行条件を設定します。

変更するデータに関する条件を変更するときは，次に示すメソッドを実行します。

UpdateDefine.Update.AddKeyメソッド：変更行条件を設定します。

UpdateDefine.Update.AddUpdateValueメソッド：文字列型のデータを変更します。

UpdateDefine.Update.AddUpdateValueBメソッド：バイト型のデータを変更します。

UpdateDefine.Executeメソッドを実行します。UpdateDefine.Executeメソッドを実行すると，次に示すプロパティの値を参照できます。

UpdateDefine.ExecutedRowCountプロパティ：サーバプログラムが更新した行数。

(2)　UpdateDefineオブジェクトを使ってデータを更新する手順（追加）

UpdateDefineオブジェクトを使ってデータを更新（追加）する手順を次に示します。

次に示すプロパティを設定します。

UpdateDefine.Exclusiveプロパティ：排他モードを設定します。

UpdateDefine.UpdateModeプロパティ：更新実行モードを設定します。

UpdateDefine.TableNameプロパティ：更新する表の名前を設定します。

UpdateDefine.NCharPrefixModeプロパティ：プレフィックス "N" を付けるかどうかを設定します。

UpdateDefine.Inserts.Addメソッドで，Insertオブジェクトを生成します。

Insertsコレクションオブジェクト下のInsertオブジェクトに，追加するデータに関する条件を設定します。

UpdateDefine.Insert.InsertValueプロパティ：文字列型のデータの追加情報を設定します。

UpdateDefine.Insert.InsertValueBプロパティ：バイト型のデータの追加情報を設定します。

追加するデータに関する条件を変更するときは，次に示すメソッドを実行します。

UpdateDefine.Insert.AddInsertValueメソッド：文字列型のデータを追加します。

UpdateDefine.Insert.AddInsertValueBメソッド：バイト型のデータを追加します。

メソッドを実行した後，UpdateDefine.Executeメソッドを実行します。UpdateDefine.Executeメソッドを実行すると，次に示すプロパティの値を参照できます。

UpdateDefine.ExecutedRowCountプロパティ：サーバプログラムが更新した行数。

更新が正しく実行されたかどうかを確認できます。

(3)　UpdateDefineオブジェクトを使ってデータを更新する手順（削除）

UpdateDefineオブジェクトを使ってデータを更新（削除）する手順を次に示します。

次に示すプロパティを設定します。

UpdateDefine.Exclusiveプロパティ：排他モードを設定します。

UpdateDefine.UpdateModeプロパティ：更新実行モードを設定します。

UpdateDefine.TableNameプロパティ：更新する表の名前を設定します。

UpdateDefine.NCharPrefixModeプロパティ：プレフィックス "N" を付けるかどうかを設定します。

UpdateDefine.Deletes.Addメソッドで，Deleteオブジェクトを生成します。

Deletesコレクションオブジェクト下のDeleteオブジェクトに，削除するデータに関する条件を設定します。

UpdateDefine.Delete.KeyCountプロパティ：削除行条件の数を設定します。

UpdateDefine.Delete.KeyColumnプロパティ：削除行条件の列名を設定します。

UpdateDefine.Delete.KeyValueプロパティ：削除行条件のデータを設定します。

削除するデータに関する条件を変更するときは，次に示すメソッドを実行します。

UpdateDefine.Delete.AddKeyメソッド：削除行条件を設定します。

メソッドを実行した後，UpdateDefine.Executeメソッドを実行します。UpdateDefine.Executeメソッドを実行すると，次に示すプロパティの値を参照できます。

UpdateDefine.ExecutedRowCountプロパティ：サーバプログラムが更新した行数。

3.8.2　更新実行モードとデータ更新の関係

UpdateDefine.UpdateModeプロパティに設定する更新実行モードとデータ更新の関係を表3-5に示します。

表3‒5　更新実行モードとデータ更新の関係

更新実行

モード

メソッド

列属性

dbpTypeLONGVARBINARY

dbpTypeVARBINARY，dbpTypeBIT

その他の属性

dbpNormal

AddKeyメソッド

×

×

○

AddUpdateValueメソッド

×

×

○

AddUpdateValueBメソッド

×

×

×

AddInsertValueメソッド

×

×

○

AddInsertValueBメソッド

×

×

×

dbpVariable

AddKeyメソッド

×

×

○

AddUpdateValueメソッド

○

×

○

AddUpdateValueBメソッド

○

○

○

AddInsertValueメソッド

○

×

○

AddInsertValueBメソッド

○

○

○

3.9　SQLを直接記述してアクセス（SQLDirectオブジェクト）

アプリケーションにSQL文を記述して，データを抽出／更新する方法について説明します。SQL文を直接記述して実行するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，SQLDirectオブジェクトを使います。SQLDirectオブジェクトを使うと，データの抽出／更新のほかにもSQLでサポートしている機能を実行できます。

サンプルの参照先

SQLDirectオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Odbc¥Sqldirectフォルダを参照してください。

3.9.1　データの抽出（SQLDirectオブジェクト）

SQLDirectオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順を図3-7に示します。

図3‒7　SQLDirectオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順

(1)　SQLDirectオブジェクトを使ってデータを抽出する手順

SQLDirectオブジェクトを使ってデータを抽出する手順を次に示します。

SQLDirect.SQLTextプロパティに，データを抽出するSQL文を記述します。

SQLDirect.Executeメソッドで，SQL文を実行します。SQL文を実行した結果は，次に示す方法で確認できます。

Select文の実行結果：Resultオブジェクトを使って取得します。

Select文以外の実行結果：戻り値で返ります。

SQLDirect.SQLTextプロパティに更新処理（SQL文のUpdate文，Insert文，Delete文）を記述してあるときは，次に示すプロパティの値を参照できます。

SQLDirect.ExecutedRowCountプロパティ：サーバプログラムが更新した行数。

Resultオブジェクトで，抽出データを処理します。Resultオブジェクトの使い方については，「3.7　抽出データの管理（Resultオブジェクト）」を参照してください。

3.9.2　データの更新（SQLDirectオブジェクト）

SQLDirectオブジェクトを使った更新のオブジェクトの流れとプロパティとメソッドの実行手順を図3-8に示します。

図3‒8　SQLDirectオブジェクトを使った更新のオブジェクトの流れとプロパティとメソッドの実行手順

(1)　SQLDirectオブジェクトを使ってデータを更新する手順

SQLDirectオブジェクトを使ってデータを更新する手順を次に示します。

SQLDirect.SQLTextプロパティに，データを更新（変更，追加，削除）するSQL文を記述します。

SQLDirect.Executeメソッドで，データの更新を実行します。

SQLDirect.SQLTextプロパティにSQL文のUpdate文，Insert文，Delete文を記述してあるときは，次に示すプロパティの値を参照できます。

SQLDirect.ExecutedRowCountプロパティ：サーバプログラムが更新した行数。

SQL文を実行した結果は，次に示す方法で確認できます。

Select文の実行結果：Resultオブジェクトを使って取得します。

Select文以外の実行結果：戻り値で返ります。

3.10　データの抽出（Catalogオブジェクト）

DBPARTNER2 ClientのオブジェクトCatalogを使って，データを抽出する方法について説明します。データを抽出するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，Catalogオブジェクトを使います。

Catalogオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順を図3-9に示します。

図3‒9　Catalogオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順

3.10.1　Catalogオブジェクトを使ってデータを抽出する手順

Catalogオブジェクトを使ってデータを抽出する手順を次に示します。

次に示すCatalogオブジェクトのプロパティを設定します。

Catalog.FileLoadプロパティ：手順ファイルファイル名を設定します。

Catalog.ConvertメソッドでQueryDefineオブジェクトを作成します。

QueryDefine.Exclusiveプロパティに，排他モードを設定します。

QueryDefine.Executeメソッドで，抽出を実行します。

Resultオブジェクトで，抽出データを処理します。Resultオブジェクトの使い方については，「3.7　抽出データの管理（Resultオブジェクト）」を参照してください。

3.11　ストアドプロシジャの実行（Procedureオブジェクト）

DBPARTNER2 ClientのオブジェクトProcedureを使って，ストアドプロシジャを実行する方法について説明します。ストアドプロシジャを実行するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，Procedureオブジェクトを使います。

Procedureオブジェクトを使ったストアドプロシジャ実行のオブジェクトの流れとプロパティとメソッドの実行手順を図3-10に示します。

図3‒10　Procedureオブジェクトを使ったストアドプロシジャ実行のオブジェクトの流れとプロパティとメソッドの実行手順

3.11.1　Procedureオブジェクトを使ってストアドプロシジャを実行する手順

Procedureオブジェクトを使ってストアドプロシジャを実行する手順を次に示します。

次に示すProcedureオブジェクトのプロパティを設定します。

Procedure.ListPatternプロパティ：ストアドプロシジャの一覧を絞り込む条件を設定します。

Procedure.GetListメソッドでProcedureListオブジェクトを作成します。

ProcedureList.ProcedureNameプロパティに，実行するストアドプロシジャ名を設定します。

Procedure.GetParamメソッドでParamListオブジェクトを作成します。

ParamList.ParamValueプロパティで，ストアドプロシジャに与えるパラメタを設定します。

Procedure.Executeメソッドで，ストアドプロシジャを実行します。

ParamList.ParamValueプロパティで，実行結果を取得します。

3.12　避けて欲しい処理

DBPARTNER2 Clientのアプリケーションを開発するときには，次に示す処理は作らないでください。このような処理を作ったアプリケーションをDBPARTNER2 Clientで使ったときの動作は保証しません。

3.12.1　プロパティとメソッド処理中に，別の入力を許す処理

プロパティとメソッドが処理を実行中に，別の入力を受け取ってプロパティとメソッドを実行する処理は避けてください。プロパティとメソッドが処理中に別のプロパティとメソッドを実行すると，最初に実行したプロパティとメソッド以外はエラーになります。

例えば，ボタンコントロールに対応したコードの中にプロパティとメソッドを記述するときは，ボタンコントロールのコードの最初にコントロールを不活性（入力を受け付けない）に変える処理を記述して，コードの最後に活性（入力を受け付ける）に変える処理を記述してください。

タイマーコントロールなどを使うときは，処理ステータスを管理するフラグを使って，同時に複数のプロパティとメソッドが実行されないようにしてください。

3.12.2　Disconnectメソッドを実行しないでアプリケーションを終了する処理

Disconnectメソッドを実行しないでアプリケーションを終了させると，例外処理が起こるおそれがあります。アプリケーションの終了時には，必ずDisconnectメソッドでサーバプログラムとの接続を終了させてください。

サーバプログラムとの接続状態は，IsConnectプロパティで調べることができます。調べた結果，サーバプログラムとの接続が開始していないときは，Disconnectメソッドを実行する必要はありません。

3.12.3　2フェーズコミットを必要とする更新処理

一つのアプリケーションで複数の表を更新して，互いの表の整合性を保証する必要があるときは，2フェーズコミットを使います。しかし，DBPARTNER2 ClientのActiveXコントロールは，2フェーズコミットをサポートしていません。このため，正常に終了させた更新処理を元の状態に戻せません。

例えば，二つの表を更新する業務で，片方の表に対する更新処理が正常に処理されて，もう片方の更新処理が失敗したときは，二つの表の整合性を保証できなくなります。

3.12.4　Internet ExplorerでActiveXコントロールを使う処理

DBPARTNER2 ClientのActiveXコントロールは，クライアントのアプリケーションを開発するためだけに使ってください。Microsoft ActiveX Control Pad などを使ってHTMLファイルに記述を追加できますが，その動作は保証されません。

3.13　プロパティとメソッドの使い方の詳細

プロパティとメソッドを実行するときの，次に示す条件について説明します。

プロパティとメソッドの実行順序

プロパティとメソッドの制限

3.13.1　プロパティとメソッドの実行順序

プロパティとメソッドを使うときに前提になるプロパティ又はメソッドを，オブジェクトごとに表3-6〜表3-14に示します。

表の項目の「接続」とは，データベースとの接続（DBPARTNER.Connectメソッド）が必要かどうかを示します。必要なときは「○」，特に必要でないときは「−」で示します。

表3‒6　プロパティとメソッドの実行順序（DBPARTNERオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

CommitMode

−

−

ConnectDialogMode

−

−

DataSource

−

−

DictPath

−

−

TableDefSource

−

−

UserID

−

−

Password

−

−

IsConnect

−

−

Cancel

○

−

Disconnect

○

−

Commit

○

−

Rollback

○

−

Connect

−

−

表3‒7　プロパティとメソッドの実行順序（SQLDirectオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

SQLText

−

−

ExecutedRowCount

○

SQLDirect.Execute

Execute

○

SQLDirect.SQLText

表3‒8　プロパティとメソッドの実行順序（TableListオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

Pattern

−

−

CountLimit

−

−

Count

○

TableList.Get

SelectDict

−

−

TableName

○

TableList.Get

TableOwner

○

TableList.Get

TableType

○

TableList.Get

TableComment

○

TableList.Get

TableDataSource

○

TableList.Get

TableCreateDate

○

TableList.Get

TableGroupName

○

TableList.Get

TableHeader

○

TableList.Get

Type

−

−

Get

○

−

表3‒9　プロパティとメソッドの実行順序（ColumnListオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

TableName

−

−

CountLimit

−

−

Count

○

ColumnList.Get

ColumnName

○

ColumnList.Get

ColumnNameLength

○

ColumnList.Get

ColumnType

○

ColumnList.Get

ColumnLength

○

ColumnList.Get

ColumnScale

○

ColumnList.Get

ColumnComment

○

ColumnList.Get

ColumnHeader

○

ColumnList.Get

SelectDict

−

−

Get

○

ColumnList.TableName

表3‒10　プロパティとメソッドの実行順序（Resultオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

QueryCountLimit

−

−

DataCheck

−

−

HeaderOutput

−

−

RecordHeader

○

QueryDefine.Execute又はSQLDirect.Execute

FieldHeader

○

QueryDefine.Execute又はSQLDirect.Execute

FieldNameLength

○

QueryDefine.Execute又はSQLDirect.Execute

RecordData

○

Result.Get

FieldData

○

Result.Get

FieldDataB

○

Result.Get

FieldCodeType

○

QueryDefine.Execute又はSQLDirect.Execute

FieldType

○

QueryDefine.Execute又はSQLDirect.Execute

FieldDataLength

○

Result.Get

FieldCount

○

QueryDefine.Execute又はSQLDirect.Execute

EOF

○

Result.Get

Get

○

QueryDefine.Execute又はSQLDirect.Execute

Close

○

QueryDefine.Execute又はSQLDirect.Execute又はResult.Get

SaveToFile

○

QueryDefine.Execute又はSQLDirect.Execute

CopyToClipboard

○

QueryDefine.Execute又はSQLDirect.Execute

SaveLargeObject

○

Result.Get

表3‒11　プロパティとメソッドの実行順序（QueryDefineオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

Exclusive

−

−

QueryCount

○

QueryDefine.Tables.Add

Execute

○

QueryDefine.Tables.Add

RemoveAll

−

−

Tables.Count

−

QueryDefine.Tables.Add

Tables.Add

−

−

Tables.RemoveAll

−

−

Table.TableName

−

QueryDefine.Tables.Add

Columns.Count

−

QueryDefine.Columns.Add

Columns.Add

−

−

Columns.RemoveAll

−

−

Column.ColumnName

−

QueryDefine.Columns.Add

Column.SortMode

−

QueryDefine.Columns.Add

Column.SortPriority

−

QueryDefine.Column.SortMode

Column.FunctionMode

−

QueryDefine.Columns.Add

Conditions.Count

−

QueryDefine.Conditions.Add

Conditions.Relation

−

QueryDefine.Conditions.Add

Conditions.Add

−

−

Conditions.RemoveAll

−

−

Condition.Text

−

QueryDefine.Conditions.Add

表3‒12　プロパティとメソッドの実行順序（UpdateDefineオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

Exclusive

−

−

UpdateMode

−

−

NCharPrefixMode

−

−

TableName

−

−

ErrorInformation

○

UpdateDefine.Execute

ExecutedRowCount

○

UpdateDefine.Execute

Execute

○

UpdateDefine.TableNameと次に示す組み合わせ

UpdateDefine.Update.AddKeyと

UpdateDefine.Update.AddUpdateValue

UpdateDefine.Update.AddKeyと

UpdateDefine.Update.AddUpdateValueB

UpdateDefine.Insert.AddValue

UpdateDefine.Insert.AddValueB

UpdateDefine.Delete.AddKey

RemoveAll

−

−

Updates.Count

−

UpdateDefine.Updates.Add

Updates.Add

−

−

Updates.RemoveAll

−

−

Update.KeyCount

−

UpdateDefine.Update.AddKey

Update.UpdateValueCount

−

UpdateDefine.Update.AddUpdateValue

Update.KeyColumn

−

UpdateDefine.Update.AddKey

Update.KeyValue

−

UpdateDefine.Update.AddKey

Update.Column

−

UpdateDefine.Update.AddUpdateValue

Update.UpdateValue

−

UpdateDefine.Update.AddUpdateValue

Update.UpdateValueB

−

UpdateDefine.Update.AddUpdateValueB

Update.AddKey

−

UpdateDefine.Updates.Add

Update.AddUpdateValue

−

UpdateDefine.Updates.Add

Update.AddUpdateValueB

−

UpdateDefine.Updates.Add

Inserts.Count

−

UpdateDefine.Inserts.Add

Inserts.Add

−

−

Inserts.RemoveAll

−

−

Insert.InsertValueCount

−

UpdateDefine.Insert.AddInsertValue

Insert.Column

−

UpdateDefine.Insert.AddInsertValue

Insert. InsertValue

−

UpdateDefine.Insert.AddInsertValue

Insert. InsertValueB

−

UpdateDefine.Insert.AddInsertValueB

Insert.AddInsertValue

−

UpdateDefine.Inserts.Add

Insert.AddInsertValueB

−

UpdateDefine.Inserts.Add

Deletes.Count

−

UpdateDefine.Deletes.Add

Deletes.Add

−

−

Deletes.RemoveAll

−

−

Delete.KeyCount

−

UpdateDefine.Delete.AddKey

Delete.KeyColumn

−

UpdateDefine.Delete.AddKey

Delete.KeyValue

−

UpdateDefine.Delete.AddKey

Delete.AddKey

−

UpdateDefine.Deletes.Add

表3‒13　プロパティとメソッドの実行順序（Catalogオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

Convert

○

Catalog.FileLoad

FileLoad

−

−

Variable.Count

−

Catalog.FileLoad

Variable.VariableName

−

Catalog.FileLoad

Variable.VariableValue

−

Catalog.FileLoad

表3‒14　プロパティとメソッドの実行順序（Procedureオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

ListPattern

−

−

Execute

○

Procedure.GetParam

GetList

○

−

GetParam

○

−

ParamList.Count

−

Procedure.GetParam

ParamList.ParamCodeType

○

Procedure.GetParam

ParamList.ParamName

○

Procedure.GetParam

ParamList.ParamType

○

Procedure.GetParam

ParamList.ParamComment

○

Procedure.GetParam

ParamList.ParamDataType

○

Procedure.GetParam

ParamList.ParamLength

○

Procedure.GetParam

ParamList.ParamNullable

○

Procedure.GetParam

ParamList.ParamPrecision

○

Procedure.GetParam

ParamList.ParamRadix

○

Procedure.GetParam

ParamList.ParamScale

○

Procedure.GetParam

ParamList.ParamTypeName

○

Procedure.GetParam

ParamList.ParamValue

○

Procedure.GetParam

ParamList.ParamValueB

○

Procedure.GetParam

ParamList.ParamValueMaxLength

−

Procedure.GetParam

ProcedureList.Count

−

Procedure.GetList

ProcedureList.ProcedureComment

○

Procedure.GetList

ProcedureList.ProcedureName

○

Procedure.GetList

ProcedureList.ProcedureOwner

○

Procedure.GetList

ProcedureList.ProcedureType

○

Procedure.GetList

3.13.2　プロパティとメソッドの制限

プロパティとメソッドは，サーバプログラムと接続していないとエラーになることがあります。プロパティとメソッドの状態遷移を表3-15に示します。表3-15にある「×」は，エラーになることを示します。表3-15に記載していないプロパティとメソッドは，状態遷移による制限はありません。

表3-15に示す状態は，次に示す4種類あります。

未接続：サーバプログラムと接続していない状態を示します。

接続：サーバプログラムと接続している状態を示します。

前処理：Select系SQL文を実行した状態を示します。

取得：抽出結果の取得中の状態を示します。

表3‒15　プロパティとメソッドの状態遷移

オブジェクト

プロパティ

又はメソッド

状態

１：未接続

２：接続

３：前処理

４：取得

DBPARTNER

Cancel

１※1

２※1

２※2

２※2

Disconnect

１※3

１

×

×

Commit

×

２※4

２※5

２※5

Rollback

×

２※4

２※5

２※5

Connect

２

２※6

×

×

SQLDirect

Execute

×

３ 又は

２※7

×

×

Result

RecordHeader

×

×

３

４

FieldHeader

×

×

３

４

RecordData

×

×

×

４

FieldData

×

×

×

４

FieldDataB

×

×

×

４

FieldType

×

×

３

４

FieldDataLength

×

×

×

４

FieldCount

１※8

２※8

３

４

Get

×

×

４ 又は

２※9

４ 又は

２※9

Close

１※3

２※3

２

２

SaveLargeObject

×

×

×

４

SaveToFile

×

×

２

×

CopyToClipboard

×

×

２

×

TableList

Get

×

２

×

×

ColumnList

Get

×

２

×

×

QueryDefine

QueryCount

×

２

×

×

Execute

×

３

×

×

UpdateDefine

Execute

×

２

×

×

注※1

Cancelは正常に終了します。

注※2

Cancelが正常に受け付けられたときは遷移します。受け付けられなかったときは遷移しません。

注※3

何も処理しません。

注※4

Commit/Rollbackメソッドは正常に終了します。

注※5

Commit/Rollbackメソッドを処理した後で，DBPARTNER2 Clientが自動的にCloseメソッドを実行します。

注※6

現在の接続を終了した後で，接続を再開始します。

注※7

Select系のSQLを実行した場合は「3」。それ以外は「2」に遷移します。

注※8

0を返します。

注※9

最終データまで取得したとき，又はエラーになったときは，「2」に遷移します。

4　DBPARTNER2 Clientのオブジェクトの文法（ODBC接続）

この章では，DBPARTNER2 Clientのアプリケーションを開発するときに使うActiveXコントロールのオブジェクトの文法（ODBC接続）について説明します。

4.1　プロパティページの設定

DBPARTNER2 ClientのActiveXコントロールで設定できるプロパティページについて説明します。

DBPARTNER2 Clientのプロパティページを図4-1に示します。

図4‒1　DBPARTNER2 Clientのプロパティページ

コミットモード（DBPARTNER.CommitModeプロパティ）

DBPARTNER2 Clientが自動的にトランザクションを制御するかどうかを設定します。省略時仮定値は「0−AutoCommit」です。

0−AutoCommit

DBPARTNER2 Clientが自動的にトランザクションを制御します。

1−ManualCommit

アプリケーションからCommit/Rollbackを実行してトランザクションを制御します。

ログイン画面（DBPARTNER.ConnectDialogModeプロパティ）

設定した接続先データソースに接続を要求するときに，ODBCが提供する［ログイン］ダイアログボックスを表示するかどうかを設定します。省略時仮定値は「0−非表示」です。

0−非表示

ユーザID／パスワードの設定にかかわらず，［ログイン］ダイアログボックスを表示しません。

1−省略時表示

ユーザID／パスワードを設定していないときだけ，画面を表示します。

2−表示

ユーザID／パスワードの設定にかかわらず，［ログイン］ダイアログボックスを表示します。

接続先（DBPARTNER.DataSourceプロパティ）

接続するサーバプログラムが動作しているサーバマシンに接続するODBCのデータソース名を設定します。接続先には，ODBCドライバのセットアップでデータソースに設定/登録してある値を設定してください。文字列は，最大32バイト入力できます。

ユーザID（DBPARTNER.UserIDプロパティ）

ユーザIDを設定します。ここに設定した値は，UserIDプロパティに設定されます。文字列は，最大32バイト入力できます。

パスワード（DBPARTNER.Passwordプロパティ）

パスワードを設定します。ここに設定した値は，Passwordプロパティに設定されます。文字列は，最大32バイト入力できます。

4.2　DBPARTNERオブジェクトの詳細

DBPARTNERオブジェクトは，サーバプログラムとの接続を管理するオブジェクトです。このオブジェクトは，DBPARTNER2 Clientのトップオブジェクトです。

DBPARTNERオブジェクトのプロパティとメソッドの一覧を次に示します。

●DBPARTNERオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

CommitMode

○

○

トランザクション終了モードを設定します。

ConnectDialogMode

○

○

接続ダイアログボックス表示モードを設定します。

DataSource

○

○

データソース名を文字列で設定します。

DictPath

○

○

見出し辞書を格納しているパスを文字列で設定します。

TableDefSource

○

○

表情報，列情報の取得元を設定します。

IsConnect

−

○

サーバと接続しているかどうかの状態を取得します。

Password

○

○

パスワードを文字列で設定します。

UserID

○

○

ログインするユーザIDを文字列で設定します。

●DBPARTNERオブジェクトのメソッドの一覧

メソッド

説明

Cancel（CancelEx）

実行中の処理をキャンセルします。

Commit

実行中の処理を有効にして，トランザクションを終了させます。

Connect

サーバとの接続を開始します。

Disconnect

サーバとの接続を終了します。

Rollback

実行中の処理を無効にして，トランザクションを終了させます。

CommitModeプロパティ

機能

サーバプログラムに対するトランザクションを自動的に終了するかどうかを，数値で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. CommitMode［= Mode］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Mode

トランザクション終了モードを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpAuto

0

自動的にトランザクションを終了します。

dbpManual

1

アプリケーションで終了を設定します。

使い方

CommitModeプロパティにdbpManualを設定したときは，トランザクションの終了をCommitメソッド又はRollbackメソッドで設定します。Commit/Rollbackメソッドを実行するタイミングを次に示します。

Select文関連以外のSQL文をSQLDirect.Executeメソッドで実行した後

Result.Getメソッドですべてのデータを取得し終えた後

Result.Closeメソッドでデータ取得を中止した後

TableList.Getメソッドの後

ColumnList.Getメソッドの後

QueryDefine.QueryCountメソッドの後

UpdateDefine.Executeメソッドの後

サーバプログラムと接続中（ConnectメソッドからDisconnectメソッドまでの間）は，CommitModeプロパティの値を変更してもトランザクション終了モードを変えることはできません。

ConnectDialogModeプロパティ

機能

Connectメソッドを実行したときに，ODBCが提供する［データソース選択］ダイアログボックスと［ログイン］ダイアログボックスを表示するかどうかを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. ConnectDialogMode［= Mode］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Mode

［データソース選択］ダイアログボックスと［ログイン］ダイアログボックスを表示するかどうかを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpHide

0

ダイアログボックスを表示しません。

dbpCase

1

省略値があるときは，ダイアログボックスを表示します。

dbpShow

2

ダイアログボックスを常に表示します。

使い方

dbpHideを設定又はModeを省略すると，DataSource/UserID/Passwordの各プロパティの値に関係なく［データソース選択］ダイアログボックスと［ログイン］ダイアログボックスは表示されません。

dbpShowを設定すると，DataSource/UserID/Passwordの各プロパティの値に関係なく［データソース選択］ダイアログボックスと［ログイン］ダイアログボックスが表示されます。

dbpCaseを設定すると，DataSource/UserID/Passwordの各プロパティの値によって表示するダイアログボックスが異なります。プロパティの設定とダイアログボックスの関係を次に示します。

プロパティ

設定

ダイアログボックスの表示

DataSource

あり

ダイアログボックスは表示しません。

省略

［データソース選択］ダイアログボックスを表示します。

UserID，

Password

両方あり

ダイアログボックスは表示しません。

どちらかがなし

［ログイン］ダイアログボックスを表示します。

Connectメソッドを実行した後にConnectDialogModeプロパティの値を変更しても，接続には影響しません。

［データソース選択］ダイアログボックスで設定した値は，DataSourceプロパティで取得できません。

［ログイン］ダイアログボックスで設定した値は，UserIDプロパティ又はPasswordプロパティで取得できません。

DataSourceプロパティ

機能

Connectメソッドで接続するサーバプログラムが定義されているデータソース名を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. DataSource［= DSN］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

DSN

データソース名を，0〜32バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

サーバプログラムと接続中（ConnectメソッドからDisconnectメソッドまでの間）は，DataSourceプロパティの値を変更してもデータソースを変えることはできません。

DictPathプロパティ

機能

見出し辞書を格納しているディレクトリのパスを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. DictPath［= Path］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Path

パスを，1〜256の文字列で設定します。パスの終端の“¥”は省略できます。

使い方

表情報，列情報を見出し辞書から取得する場合は，必ず設定してください。

TableDefSourceプロパティ

機能

表情報，列情報を取得するモードを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. TableDefSource［= Mode］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Mode

表情報，列情報の要求先を，定数又は数値で設定します。

定数

数値

情報の要求先

dbpDB

0

表情報，列情報をデータベースから取得します。

dbpDICT

1

表情報，列情報を見出し辞書から取得します。

dbpDBDICT

2

表情報，列情報をデータベースから取得し，ラベル（TableHeader，ColumnHeader）は見出し辞書から取得します。

IsConnectプロパティ

機能

サーバプログラムとの接続状態をBOOLEAN値で取得します。

形式

　　　　Object. IsConnect

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

戻り値

定数

内容

TRUE（真）

サーバプログラムと接続されています。

FALSE（偽）

サーバプログラムと接続されていません。

使い方

サーバプログラムの時間監視機能などで強制的に接続が解除されたときは，接続されていなくてもTRUEが返ることがあります。

Passwordプロパティ

機能

UserIDプロパティで設定したユーザIDのパスワードを，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. Password［= PWD］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

PWD

パスワードを，0〜32バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

サーバプログラムと接続中（ConnectメソッドからDisconnectメソッドまでの間）は，Passwordプロパティの値を変更しても接続ユーザのパスワードを変えることはできません。

UserIDプロパティ

機能

サーバプログラムに接続するためのユーザIDを，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. UserID［= UID］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

UID

ユーザIDを，0〜32バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

サーバプログラムと接続中（ConnectメソッドからDisconnectメソッドまでの間）は，UserIDプロパティの値を変更しても接続ユーザを変えることはできません。

Cancelメソッド（CancelExメソッド）

機能

サーバプログラムに対して実行中の処理をキャンセルします。

ビジュアル開発ツールの仕様によっては，メソッド名を「Cancel」と記述するとエラーになることがあります。このときは，メソッド名を「CancelEx」と記述してください。

形式

　　　　Object. Cancel　　又は　　Object. CancelEx

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

Cancelメソッドが有効になる範囲を次に示します。

SQLDirect.ExecuteメソッドでSelect文関連のSQL文を実行してから処理が終了するまで。

QueryDefine.Executeメソッドを実行してから処理が終了するまで。

1回目のResult.Getメソッドを実行してから処理が終了するまで。ただし，1回目のResult.Getメソッドを発行する直前にCancelメソッドが発行されている場合，Result.Getメソッドの処理をキャンセルします。

TableList.Getメソッドを実行してから処理が終了するまで。

ColumnList.Getメソッドを実行してから処理が終了するまで。

QueryDefine.QueryCountメソッドを実行してから処理が終了するまで。

UpdateDefine.Executeメソッドを実行してから処理が終了するまで。

中断する前に取得していたデータは，削除されます。

中断した処理の結果は保証されません。

UpdateDefine.UpdateModeプロパティにdbpVariableを設定しているときは，Cancelメソッドは使えません。

Result.SaveToFileメソッド，Result.CopyToClipboardメソッドでファイル又はクリップボードにデータを出力中にCancelメソッドを実行すると，キャンセルしたデータまでをファイル又はクリップボードに出力されます。

AP開発ツールの仕様によっては，Cancelメソッドを記述するとエラーが発生することがあります。この場合，「CancelEx」と記述してください。

Commitメソッド

機能

サーバプログラムに対して実行したトランザクションを有効にして，トランザクションを終了します。

形式

　　　　Object. Commit

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

CommitModeプロパティにdbpAutoを設定しているときは，正常に処理が終わった時点で自動的にCommitメソッドが実行されるので，アプリケーションからCommitメソッドを実行する必要はありません。

CommitModeプロパティでdbpAutoを設定している状態でCommitメソッドを実行しても，無視されます（エラーにはなりません）。

Connectメソッド

機能

DataSource，UserID，Passwordの各プロパティに設定された値を使って，サーバプログラムと接続します。

形式

　　　　Object. Connect

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

既にサーバプログラムと接続されている状態でConnectメソッドを実行すると，接続中のセションを終了させて，新たに接続処理が実行されます。

抽出処理の実行中は，Connectメソッドは使えません。使うとConnectメソッドがエラーになります。抽出処理の実行中とは，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行してからデータの取得が完了するまで（又は，データの取得を中止してからCloseメソッドを実行するまで）のことです。

Connectメソッドで接続したセションを終了するときは，Disconnectメソッドを実行してください。

Disconnectメソッド

機能

Connectメソッドで接続したサーバプログラムとの接続を解除します。

形式

　　　　Object. Disconnect

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

抽出処理の実行中は，Disconnectメソッドは使えません。使うとDisconnectメソッドがエラーになります。抽出処理の実行中とは，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行してからデータの取得が完了するまで（又は，データの取得を中止してからCloseメソッドを実行するまで）のことです。

Connectメソッドが実行されていない状態でDisconnectメソッドを実行しても無視されます（エラーにはなりません）。

Connectメソッドでサーバプログラムに接続したときは，アプリケーションを終了させる前に必ずDisconnectメソッドを実行して接続を終了させてください。

Rollbackメソッド

機能

サーバプログラムに対して実行したトランザクションを無効（QueryDefine.Executeメソッド，UpdateDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前の状態）にして，トランザクションを終了します。

形式

　　　　Object. Rollback

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

CommitModeプロパティにdbpAutoを設定しているときは，エラーで処理が終わった時点で自動的にRollbackメソッドが実行されるので，アプリケーションからRollbackメソッドを実行する必要はありません。

CommitModeプロパティでdbpAutoを設定している状態でRollbackメソッドを実行しても，無視されます（エラーにはなりません）。

エラーになった時点までの更新処理を有効にするときは，CommitModeプロパティにdbpManualを設定してください。

ロールバックをサポートしていないデータベースでRollbackメソッドを発行してもエラーにはなりません。この場合，トランザクションを無効にすることはできません。

4.3　SQLDirectオブジェクトの詳細

SQLDirectオブジェクトは，ユーザが記述したSQL文を実行するためのオブジェクトです。SQL文を実行させた結果は，Select文を実行したときはResultオブジェクトを使って取得できます。Select文以外を実行したときは，正常に実行されたかどうかが戻り値で返ります。

SQLDirectオブジェクトのプロパティとメソッドの一覧を次に示します。

●SQLDirectオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

ExecutedRowCount

−

○

サーバプログラムが更新した行数を取得します。

SQLText

○

○

SQL文を文字列で設定します。

●SQLDirectオブジェクトのメソッドの一覧

メソッド

説明

Execute

SQL文を実行します。

ExecutedRowCountプロパティ

機能

サーバプログラムが更新した行数を，数値で取得します。SQLTextプロパティにデータを更新するSQL文（Update文，Insert文，Delete文）が記述してあるときに有効です。

形式

　　　　Object. ExecutedRowCount

パラメタ

Object

SQLDirectオブジェクトへの参照を表すオブジェクト式です。

使い方

SQLDirect.Executeメソッドで実行したSQL文がUpdate/Insert/Delete文以外のときは，0が返ります。

SQLDirect.Executeメソッドを実行する前は，0を返します。

SQLTextプロパティ

機能

サーバプログラムに実行させるSQL文を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. SQLText［= text］

パラメタ

Object

SQLDirectオブジェクトへの参照を表すオブジェクト式です。

text

SQL文を，1〜65,000バイトの文字列で設定します。長さが0の文字列は設定できません。

使い方

SQLTextプロパティの値は，SQLDirect.Executeメソッドを実行するときに使われます。SQLDirect.Executeメソッドを実行した後にSQLTextプロパティの値を変更しても，SQLDirect.Executeメソッドの結果を変えることはできません。

Executeメソッド

機能

SQLTextプロパティに設定したSQL文を，サーバプログラムに対して実行します。

形式

　　　　Object. Execute

パラメタ

Object

SQLDirectオブジェクトへの参照を表すオブジェクト式です。

使い方

Select文の実行結果は，Resultオブジェクトで取得します。結果取得を完了させないで再びSQLDirect.Executeメソッドを実行すると，エラーになります。

Update/Insert/Delete文を実行してサーバプログラムが更新した行数は，ExecutedRowCountプロパティで取得します。

Update/Insert/Delete文以外のSQL文の実行結果は返りません。

4.4　Resultオブジェクトの詳細

Resultオブジェクトは，SQLDirectオブジェクトやQueryDefineオブジェクトで実行した抽出処理の結果として出力する抽出データを管理するオブジェクトです。

Resultオブジェクトのプロパティとメソッドの一覧を次に示します。

●Resultオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

DataCheck

○

○

抽出データの中の文字コードをチェックするかどうかを設定します。

EOF

−

○

データが取得できたかどうかを取得します。

FieldCodeType

○

○

抽出データを取得するときのデータ型を設定します。

FieldCount

−

○

抽出データの列数を返します。

FieldData

−

○

抽出データを1列単位の文字列型データで返します。

FieldDataB

−

○

抽出データを1列単位のバイト型データで返します。

FieldDataLength

−

○

列のデータ長を返します。

FieldHeader

○

○

設定した列にヘッダを設定します。

FieldNameLength

−

○

列の列名長を返します。

FieldType

−

○

列の属性を返します。

HeaderOutput

○

○

抽出データの先頭行に列名を付けるかどうかを設定します。

QueryCountLimit

○

○

抽出処理の結果として出力する行数を，数値で設定します。

RecordData

−

○

抽出データを1行単位の文字列型データで返します。

RecordHeader

−

○

抽出処理の結果として出力される列名を，1行のテキスト形式で取得します。

●Resultオブジェクトのメソッドの一覧

メソッド

説明

Close

抽出処理を終了させます。

CopyToClipboard

抽出データをクリップボードに出力します。

Get

1行分のデータを要求します。

SaveLargeObject

dbpTypeLONGVARBINARY属性のデータをファイルに出力します。

SaveToFile

抽出データをファイルに出力します。

DataCheckプロパティ

機能

抽出データの中に文字コード以外のデータがあったときに，エラーを返すかどうかを設定します。このプロパティは，値の取得もできます。

文字コード以外のデータと判定するデータを，次に示します。

1バイト文字でX'20'〜X'7E'，又はX'A1'〜X'DF'以外の文字。

2バイト文字で1バイト目が，X'81'〜X'9F'，又はX'E0'〜X'FC'以外の文字。

2バイト文字で2バイト目が，X'40'〜X'7E'，又はX'80'〜X'FC'以外の文字。

形式

　　　　Object. DataCheck［= CheckMode］

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

CheckMode

文字コードをチェックするかどうかを，次に示す定数で設定します。

定数

内容

FALSE

文字コードをチェックしません。

TRUE

文字コード以外のデータがあれば，エラーを返します。

使い方

DataCheckプロパティの値は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行するときに使われます。QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後でDataCheckプロパティの値を変更しても，Result.Getメソッドの結果を変えることはできません。

EOFプロパティ

機能

直前に実行したResult.Getメソッドでデータが取得できたかどうかを，BOOLEAN値で取得します。

形式

　　　　Object. EOF

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

戻り値

定数

内容

FALSE（偽）

データを読み込みました。

TRUE（真）

読み込むデータがありません。

使い方

EOFプロパティは，データの最後を知るために使います。Result.Getメソッドの次にEOFプロパティを実行すると，すべての抽出データを取得し終えたかどうかを判断できます。EOFプロパティがTRUEを返したときは，直前のResult.Getメソッドで読み込むデータがなかったことが分かります。

FieldCodeTypeプロパティ

機能

抽出データを取得するときのデータ型を設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. FieldCodeType（Index）［＝Mode］

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

Mode

取得モードを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpTypeBINARY，dbpBINARY

-2

バイト型を設定します。

dbpTypeCHAR，dbpCHAR

1

文字列型を設定します。

使い方

取得モードの設定によって，データを取得するプロパティ／メソッドが異なります。取得モードとデータを取得するプロパティ／メソッドの関係については，「3.7.2　Resultオブジェクトと取得するデータの関係」を参照してください。

列番号は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後，FieldCountプロパティで得られた列数の範囲内で指定してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にFieldCodeTypeプロパティを使うと，エラーになります。

列属性によって，設定できない取得モードがあります。設定できない取得モードについては，「3.7.3　FieldCodeTypeプロパティで取得するデータ」を参照してください。

FieldCodeTypeプロパティで設定した値は，次にQueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行するまで有効です。再びQueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行すると，「3.7.3　FieldCodeTypeプロパティで取得するデータ」で示す省略値のモードに戻ります。

FieldCountプロパティ

機能

抽出データの列数を，数値で取得します。

形式

　　　　Object. FieldCount

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前は，0を返します。

FieldDataプロパティ

機能

列番号で設定した列のデータを，文字列型で取得します。

形式

　　　　Object. FieldData（Index）

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

使い方

列属性がdbpTypeBINARY，dbpTypeVARBINARYのデータをバイト型で取得するときは，FieldDataBプロパティを使ってください。

列属性がdbpTypeLONGVARBINARYのデータは，データ長が文字変換されて返されます。バイト型で取得するには，FieldDataBプロパティ又はSaveLargeObjectメソッドを使ってください。

列番号は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後で，FieldCountプロパティで得られた列数の範囲内で指定してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にFieldDataプロパティを使うと，エラーになります。

FieldDataBプロパティ

機能

列番号で設定した列のデータを，バイト型で取得します。

形式

　　　　Object. FieldDataB（Index）

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

使い方

データを格納する変数は，バイト型で宣言してください。データを格納する変数がバイト型以外のときは，エラーになります。

Visual Basicを使う場合の例を次に示します（データをDataBuffに格納します）。

宣言の例：Dim DataBuff() As Byte

列属性がdbpTypeBINARY，dbpTypeVARBINARY，dbpTypeLONGVARBINARY以外の列のデータをバイト型で取得するときは，FieldCodeTypeプロパティを使ってください。

列番号は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後で，FieldCountプロパティで得られた列数の範囲内で指定してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にFieldDataBプロパティを使うと，エラーになります。

FieldDataLengthプロパティ

機能

列番号で設定した列のデータ長を，数値で取得します。

形式

　　　　Object. FieldDataLength（Index）

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

使い方

列番号は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後，FieldCountプロパティで得られた列数の範囲内で設定してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にFieldDataLengthプロパティを使うと，エラーになります。

FieldHeaderプロパティ

機能

列番号で設定した列にヘッダを，数値と文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. FieldHeader（Index）［= String］

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

String

列に付けるヘッダを，0〜256バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

列番号は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後，FieldCountプロパティで得られた列数の範囲内で設定してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にFieldHeaderプロパティを使うと，エラーになります。

FieldNameLengthプロパティ

機能

列番号で設定した列の列名長を，数値（バイト数）で取得します。列が繰り返し列又は配列列以外の場合，0を返します。

形式

　　　　Object. FieldNameLength（Index）

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

使い方

Result.FieldHeaderプロパティで列名を取得した場合，繰り返し列又は配列列は，"列名(n)"（nは要素番号）の形式で返されます。FieldNameLengthプロパティを使うと，列名部分の長さ（括弧と要素番号を除いた部分の長さ）を取得できます。

列番号は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後，FieldCountプロパティで得られた列数の範囲内で設定してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にFieldNameLengthプロパティを使うと，エラーになります。

FieldTypeプロパティ

機能

列番号で設定した列の属性を，数値で取得します。

形式

　　　　Object. FieldType（Index）

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

使い方

列の属性については，「付録E　列の属性」を参照してください。

列番号は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後に，FieldCountプロパティで得られた列数の範囲内で設定してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にFieldTypeプロパティを使うと，エラーになります。

HeaderOutputプロパティ

機能

SaveToFileメソッド，CopyToClipboardメソッドを使うときに，抽出データの先頭行にヘッダを付けるかどうかを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. HeaderOutput［= HeaderMode］

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

HeaderMode

ヘッダを付けるかどうかを，次に示す定数で設定します。

定数

内容

FALSE

抽出データにヘッダを付けません。

TRUE

抽出データの1行目にヘッダを付けます。

使い方

HeaderOutputプロパティの値は，SaveToFileメソッド又はCopyToClipboardメソッドを実行するときに使われます。SaveToFileメソッド又はCopyToClipboardメソッドを実行した後でHeaderOutputプロパティの値を変更してもSaveToFileメソッド又はCopyToClipboardメソッドの結果を変えることはできません。

ヘッダが設定されていない列は，列名を出力します。

QueryCountLimitプロパティ

機能

抽出処理の結果として出力する行数を，数値で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. QueryCountLimit［= Number］

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Number

抽出する行数の制限値を，次に示す数値で設定します。

数値

内容

0

行数は制限しません。

1〜999,999,999

設定した行数まで，データを取得します。

使い方

QueryCountLimitプロパティの値は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行するときに使われます。QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後でQueryCountLimitプロパティの値を変更しても，Result.Getメソッドの結果を変えることはできません。

RecordDataプロパティ

機能

Result.Getメソッドで取得した1レコード単位の抽出データを，文字列で取得します。取得する文字列は，1行のテキスト形式になっています。

形式

　　　　Object. RecordData

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

テキストデータのフォーマットについては，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

データは，Result.Getメソッドを実行するときに更新されます。

列属性がdbpTypeLONGVARBINARYのデータをRecordDataプロパティで取得すると，データ長が文字変換されて返されます。バイト型でデータを取得するときは，FieldDataBプロパティ又はSaveLargeObjectメソッドを使ってください。

列属性がdbpTypeBINARY，dbpTypeVARBINARYのデータをRecordDataプロパティで取得すると，データ長が文字変換されて返されます。バイト型でデータを取得するときは，FieldDataBプロパティを使ってください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にRecordDataプロパティを使うと，エラーになります。

RecordHeaderプロパティ

機能

抽出処理の結果として出力される列名を，文字列で取得します。取得する文字列は，1行のテキスト形式になっています。

形式

　　　　Object. RecordHeader

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

テキスト形式のフォーマットについては，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にRecordHeaderプロパティを使うと，エラーになります。

Closeメソッド

機能

抽出処理を終了させます。

形式

　　　　Object. Close

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

EOFプロパティがFALSEの状態でほかの処理に移りたいときは，必ずCloseメソッドを実行してください。

Closeメソッドを連続して実行しても，不要なCloseメソッドは無視されます（エラーにはなりません）。

CopyToClipboardメソッド

機能

抽出データを，設定した形式でクリップボードに出力します。

形式

　　　　Object. CopyToClipboard（Type）

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Type

出力するデータの形式を，次に示す定数又は数値で設定します。

定数

数値

内容

dbpTextFormat

0

TEXT形式

dbpBiff4Format

1

Excel 4.0形式

dbpOleBiff8Format

4

Excel 97-2000ブック形式

使い方

データの形式については，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にCopyToClipboardプロパティを使うと，エラーになります。

列属性がdbpTypeLONGVARBINARYのデータをCopyToClipboardメソッドで取得すると，データ長が文字変換されて返されます。バイト型でデータを取得するときは，FieldDataBプロパティ又はSaveLargeObjectメソッドを使ってください。

列属性がdbpTypeBINARY，dbpTypeVARBINARYのデータをCopyToClipboardメソッドで取得すると，データ長が文字変換されて返されます。バイト型でデータを取得するときは，FieldDataBプロパティを使ってください。

Cancelメソッドを実行して処理を中止すると，Cancelメソッドまでのデータをクリップボードに出力します。

CopyToClipboardメソッドがエラーになったときは，クリップボードの内容は保証されません。

抽出するデータが1件もないときは，クリップボードの内容がクリアされます。HeaderOutputプロパティにTRUEを設定して，抽出データの先頭行にヘッダを付けると，先頭行のヘッダだけが出力されます。

Getメソッド

機能

サーバプログラムに対して1行分のデータを要求します。

形式

　　　　Object. Get

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

データを取得するときは，RecordDataプロパティとFieldDataプロパティを使います。

Result.Getメソッドを実行した後には，EOFプロパティで取得状況を確認してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にResult.Getメソッドを使うと，エラーになります。

1回目のResult.Getメソッドが成功して それ以降でデータの取得を中止するときは，Closeメソッドを使ってください。Cancelメソッドでは，データの取得を中止できません。

SaveLargeObjectメソッド

機能

列番号で設定したdbpTypeLONGVARBINARY属性の列のデータを，設定したファイルに格納します。

形式

　　　　Object. SaveLargeObject Index，FileName

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

FileName

データを出力するファイル名を，1〜256バイトの文字列で設定します。この設定で，値はクリアできません。

使い方

列番号がdbpTypeLONGVARBINARY属性の列以外のときは，エラーを返します。

列番号は，QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行した後，FieldCountプロパティで得られた列数の範囲内で指定してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にSaveLargeObjectプロパティを使うと，エラーになります。

SaveToFileメソッド

機能

抽出データを，設定した形式でファイルに出力します。

形式

　　　　Object. SaveToFile FileName，Type

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

FileName

抽出データを出力するファイル名を，1〜256バイトの文字列で設定します。値はクリアできません。

Type

出力するデータの形式を，次に示す定数又は数値で設定します。

定数

数値

内容

dbpTextFormat，dbpTextFile

0

TEXT形式

dbpBiff4Format，dbpBiff4File

1

Excel 4.0形式

dbpCSVFile

2

CSV形式

dbpDATFile

3

DAT形式

dbpOleBiff8File

4

Excelオブジェクトで作成するExcel 97-2003ブック形式（XLS形式）

dbpOleBiff12File

5

Excelオブジェクトで作成するExcel 2007バイナリファイル形式（XLSB形式）

dbpOleXMLWorkbookFile

6

Excelオブジェクトで作成するExcel 2007XMLファイル形式（XLSX形式）

使い方

データの形式については，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

QueryDefine.Executeメソッド又はSQLDirect.Executeメソッドを実行する前にSaveToFileプロパティを使うと，エラーになります。

列属性がdbpTypeLONGVARBINARYのデータをSaveToFileメソッドで取得すると，データ長が文字変換されて返されます。バイト型でデータを取得するときは，FieldDataBプロパティ又はSaveLargeObjectメソッドを使ってください。

列属性がdbpTypeBINARY，dbpTypeVARBINARYのデータをSaveToFileメソッドで取得すると，データ長が文字変換されて返されます。バイト型でデータを取得するときは，FieldDataBプロパティを使ってください。

Cancelメソッドを実行して処理を中止すると，Cancelメソッドまでのデータをファイルに出力します。

SaveToFileメソッドがエラーになったときは，出力されたデータの内容は保証されません。

4.5　TableListオブジェクトの詳細

TableListオブジェクトは，設定したデータソースに格納されている表一覧情報を取得したり，取得した結果を管理したりします。それぞれの表情報は，プロパティによって返されます。

TableListオブジェクトのプロパティとメソッドの一覧を次に示します。

●TableListオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

取得した表情報の個数を取得します。

CountLimit

○

○

取得したい表情報の個数を設定します。

SelectDict

○

○

接続先をキーに，使用する見出し辞書を限定します。

Pattern

○

○

表情報の絞り込み条件を文字列で設定します。

TableComment

−

○

設定した表の注釈を文字列で取得します。

TableCreateDate

−

○

設定したVOSKスプールファイルの作成日付を文字列で取得します。

TableDataSource

−

○

設定した表の見出し辞書中の接続先を文字列で取得します。

TableGroupName

−

○

設定した表のグループ名を文字列で取得します。

TableHeader

−

○

設定した表のラベルを文字列で取得します。

TableName

−

○

設定した表の表名を文字列で取得します。

TableOwner

−

○

設定した表の所有者を文字列で取得します。

TableType

−

○

設定した表の属性を文字列で取得します。

Type

○

○

取得したい表情報の表属性を設定します。

●TableListオブジェクトのメソッドの一覧

メソッド

説明

Get

表情報の取得を要求します。

Countプロパティ

機能

取得した表情報の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

使い方

TableList.Getメソッドを実行する前は，0を返します。

CountLimitプロパティ

機能

取得する表情報の最大数を，数値で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. CountLimit［= max］

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

max

取得する表の制限数を，次に示す数値で設定します。

数値

内容

0

すべての表の情報を取得します。

1〜8192

設定した数だけ，表の情報を取得します。

使い方

CountLimitプロパティの値は，TableList.Getメソッドを実行するときに使われます。TableList.Getメソッドを実行した後でCountLimitプロパティの値を変更しても，TableList.Getメソッドの結果を変えることはできません。

SelectDictプロパティ

機能

接続先をキーに，使用する見出し辞書を限定します。このプロパティは，値の取得もできます。

形式

　　　　Object. SelectDict = DataSource

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

DataSource

接続先を0〜32バイトの文字列で設定します。0バイトの文字列も設定できます。

使い方

接続先には，TableList.TableDataSourceプロパティと同じ文字列を設定してください。

接続先が見出し辞書にない場合，TableList.Countプロパティが0となります。

Patternプロパティ

機能

表情報を取得するときの絞り込み条件を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. Pattern［= text］

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

text

絞り込み条件を，0〜128バイトの文字列で設定します。文字列には，ワイルドカード（_，%）文字を含めることができます。値をクリアするときは，長さ0の文字列を設定します。絞り込み条件は，次の書式で設定してください。

所有者.表名

表名

使い方

絞り込み条件に設定する所有者や表名の最大長は，使うデータベースに依存します。制限を超えた絞り込み条件を設定すると，TableList.Getメソッドがエラーになるか，又は正しく絞り込みできません。

値がクリアされているときは，%.% が仮定されます。

「_」（アンダースコア文字）は何らかの単一文字を示します。

「%」（パーセント文字）は何らかのゼロ個以上の文字のつながりを示します。

使える絞り込み条件を次に示します。

前方一致（例：ABC%）文字列の先頭がABCであり，以降の文字は任意です。

後方一致（例：%ABC）文字列の最後がABCであり，以前の文字は任意です。

任意一致（例：%ABC%）文字列中の任意の部分がABCです。

完全一致（例：ABC）文字列がABCと同じです。

部分一致（例：_ABC_）5文字の文字列のうち，2〜4文字目がABCです。

（例：A_B%C）文字列の先頭がA，3文字目がB，最後がCです。

「_」や「%」を条件に含めるときは，ワイルドカード文字の前に「¥」を付けます。

（例）ABC¥%% ： 文字列の先頭がABC%で，以降の文字は任意です。

Patternプロパティの値は，TableList.Getメソッドを実行するときに使われます。TableList.Getメソッドを実行した後でPatternプロパティの値を変更しても，TableList.Getメソッドの結果を変えることはできません。

TableCommentプロパティ

機能

表番号で設定した表の注釈を，文字列で取得します。

形式

　　　　Object. TableComment（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

接続するデータベースがVOSKスプールファイルの場合は，ジョブに付けたコメント情報が返ります。

TableCreateDateプロパティ

機能

表番号で指定したVOSKスプールファイルの作成日付を文字列で取得します。

形式

　　　　Object. TableCreateDate （Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

TableCreateDateプロパティは，接続するデータベースがVOSKスプールファイルの場合だけ値が取得できます。それ以外のデータベースに対して発行した場合はNULLが返ります。

TableDataSourceプロパティ

機能

表番号で設定した表の見出し辞書の接続先を，文字列で取得します。

形式

　　　　Object. TableDataSource（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getプロパティを発行した後，TableList.Countプロパティで取得した表の数の範囲内で設定してください。

TableGroupNameプロパティ

機能

表番号で指定した表のグループ名を，文字列で取得します。

形式

　　　　Object.TableGroupName(Index)

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表を数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

TableDefSourceプロパティにdbpDICTを設定している場合，見出し辞書のグループ名を返します。

TableDefSourceプロパティにdbpDBDICTを設定している場合，見出し辞書の中に異なる接続先で同一の表名があるときはTableList.SelectDictプロパティで接続先を設定してください。TableList.SelectDictプロパティで接続先を設定しないと，正しいラベルが取得できないことがあります。

TableHeaderプロパティ

機能

表番号で設定した表のラベルを，文字列で取得します。

形式

　　　　Object. TableHeader（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

TableDefSourceプロパティにdbpDICT，又はdbpDBDICTを設定している場合，見出し辞書のラベルを返します。

TableDefSourceプロパティにdbpDBDICTを設定している場合，見出し辞書の中に異なる接続先で同一の表名があるときはTableList.SelectDictプロパティで接続先を設定してください。TableList.SelectDictプロパティで接続先を設定しないと，正しいラベルが取得できないことがあります。

接続するデータベースがVOSKスプールファイルの場合は，ジョブ名称が返ります。

TableNameプロパティ

機能

表番号で設定した表の表名を，文字列で取得します。

形式

　　　　Object. TableName（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

接続するデータベースがVOSKスプールファイルの場合は，ジョブ通し番号とファイル番号を連結した文字列が返ります。

TableOwnerプロパティ

機能

表番号で設定した表の所有者を，文字列で取得します。

形式

　　　　Object. TableOwner（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

接続するデータベースがVOSKスプールファイルの場合は，ジョブを実行したユーザIDが返ります。

TableTypeプロパティ

機能

表番号で設定した表の属性を，文字列で取得します。

形式

　　　　Object. TableType（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表属性には，"TABLE"，"VIEW"，"ALIAS"，"SYNONYM"，又はサーバプログラム固有の表属性があります。

表番号は，TableList.Getメソッドを実行した後で，TableList.Countプロパティで得られた表数の範囲内で設定してください。

Typeプロパティ

機能

取得する表の属性を文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. Type［= Text］

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

text

表の表属性を，0〜256バイトの文字列で設定します。次の書式で設定してください。

"'表属性'[,'表属性',…]"

なお，長さ0の文字列を設定すると，「"'TABLE','VIEW','ALIAS','SYNONYM'"」が仮定されます。

使い方

設定できる表属性は次のとおりです。

"TABLE"

"VIEW"

"SYSTEM TABLE"

"GLOBAL TEMPORARY"

"LOCAL TEMPORARY"

"ALIAS"

"SYNONYM"

TableDefSourceプロパティにdbpDICTを設定している場合，このプロパティの設定は無視されます。

Getメソッド

機能

サーバプログラムに定義されている表情報を要求します。

形式

　　　　Object. Get

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

使い方

このメソッドを実行すると，前回TableList.Getメソッドで取得した表の情報は上書きされます。

4.6　ColumnListオブジェクトの詳細

ColumnListオブジェクトは，設定された表名に定義されている列一覧情報を取得したり，取得した結果を管理したりします。それぞれの列情報は，プロパティによって返されます。

ColumnListオブジェクトのプロパティとメソッドの一覧を次に示します。

●ColumnListオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

ColumnComment

−

○

設定した列の注釈を文字列で取得します。

ColumnHeader

−

○

設定した列のラベルを文字列で取得します。

ColumnLength

−

○

設定した列の定義長を数値で取得します。

ColumnName

−

○

設定した列の列名を文字列で取得します。

ColumnNameLength

−

○

設定した列の列名長を数値で取得します。

ColumnScale

−

○

設定した列の小数点以下のけた数を数値で取得します。

ColumnType

−

○

設定した列の属性を取得します。

Count

−

○

取得した列の個数を取得します。

CountLimit

○

○

列情報を取得する個数を設定します。

SelectDict

○

○

接続先をキーに，使用する見出し辞書を限定します。

TableName

○

○

列情報を取得したい表名を，文字列で設定します。

●ColumnListオブジェクトのメソッドの一覧

メソッド

説明

Get

列情報の取得を要求します。

ColumnCommentプロパティ

機能

列番号で設定した列の注釈を，文字列で取得します。

形式

　　　　Object. ColumnComment（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

ColumnHeaderプロパティ

機能

列番号で設定した列のラベルを，文字列で取得します。

形式

　　　　Object. ColumnHeader（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

TableDefSourceプロパティにdbpDICT，又はdbpDBDICTを設定している場合，見出し辞書のラベルを返します。

TableDefSourceプロパティにdbpDBDICTを設定している場合，見出し辞書の中に異なる接続先で同一の表名があるときはTableList.SelectDictプロパティで接続先を設定してください。TableList.SelectDictプロパティで接続先を設定しないと，正しいラベルが取得できないことがあります。

ColumnLengthプロパティ

機能

列番号で設定した列の定義長を，数値で取得します。

形式

　　　　Object. ColumnLength（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

ColumnNameプロパティ

機能

列番号で設定した列の列名を，文字列で取得します。

形式

　　　　Object. ColumnName（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

ColumnNameLengthプロパティ

機能

列番号で設定した列の列名長を，数値（バイト数）で取得します。列が繰り返し列又は配列列以外の場合，0を返します。

形式

　　　　Object. ColumnNameLength（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

ColumnList.ColumnNameプロパティで列名を取得した場合，繰り返し列又は配列列は，"列名(n)"（nは要素番号）の形式で返されます。ColumnNameLengthプロパティを使うと，列名部分の長さ（括弧と要素番号を除いた部分の長さ）を取得できます。

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

ColumnScaleプロパティ

機能

列番号で設定した列の小数点以下のけた数を，数値で取得します。

形式

　　　　Object. ColumnScale（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

ColumnTypeプロパティ

機能

列番号で設定した列の属性を，数値で取得します。

形式

　　　　Object. ColumnType（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

属性については，「付録E　列の属性」を参照してください。

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

Countプロパティ

機能

取得した列情報の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

使い方

ColumnList.Getメソッドを実行する前は，0を返します。

CountLimitプロパティ

機能

取得する列情報の最大数を，数値で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. CountLimit［= max］

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

max

取得する列数を，次に示す数値で設定します。

数値

内容

0

すべての列を取得します。

1〜8192

設定した数だけ，列の情報を取得します。

使い方

CountLimitプロパティの値は，ColumnList.Getメソッドを実行するときに使われます。ColumnList.Getメソッドを実行した後でCountLimitプロパティの値を変更しても，ColumnList.Getメソッドの結果を変えることはできません。

SelectDictプロパティ

機能

接続先をキーに，使用する見出し辞書を限定します。このプロパティは，値の取得もできます。

形式

　　　　Object. SelectDict = DataSource

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

DataSource

接続先を0〜32バイトの文字列で設定します。0バイトの文字列も設定できます。

使い方

接続先には，TableList.TableDataSourceプロパティと同じ文字列を設定してください。

接続先が見出し辞書にない場合，TableList.Countプロパティが0となります。

TableNameプロパティ

機能

列情報を取得したい表名を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. TableName［= text］

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

text

表名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。表名は，次に示す書式で設定してください。

"所有者"."表名"

"表名"

使い方

TableNameプロパティの値は，ColumnList.Getメソッドを実行するときに使われます。ColumnList.Getメソッドを実行した後でTableNameプロパティの値を変更しても，ColumnList.Getメソッドの結果を変えることはできません。

Getメソッド

機能

ColumnList.TableNameプロパティで設定した表に含まれる列情報の取得を要求します。

形式

　　　　Object. Get

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

使い方

このメソッドを実行すると，前回ColumnList.Getメソッドで取得した列の情報は上書きされます。

4.7　QueryDefineオブジェクトの詳細

QueryDefineオブジェクトは，抽出処理を実行するオブジェクトです。抽出処理の結果として出力する抽出データは，Resultオブジェクトで取得します。

QueryDefineオブジェクトのプロパティとメソッドの一覧を次に示します。

●QueryDefineオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Exclusive

○

○

抽出処理を実行するときの排他モードを，文字列で設定します。

●QueryDefineオブジェクトのメソッドの一覧

メソッド

説明

Execute

抽出処理を実行します。

QueryCount

抽出処理の結果として出力される行数を，数値で取得します。

RemoveAll

すべてのTable，Column，Conditionオブジェクトをクリアします。

Exclusiveプロパティ

機能

抽出する表をほかのユーザが使っているときの動作を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. Exclusive［= String］

パラメタ

Object

QueryDefineオブジェクトへの参照を表すオブジェクト式です。

String

排他オプションを，次に示す 0〜64バイトの文字列で設定します。

文字列

内容

長さ0バイトの文字列

"WITH SHARE LOCK"の説明を参照してください。

"WITH SHARE LOCK"

一度検索した内容を，トランザクション終了まで，ほかのユーザからの参照は許しますが，更新は許しません。

"WITH EXCLUSIVE LOCK"

一度検索した内容を，トランザクション終了まで，ほかのユーザからの参照も更新も許しません。

"WITHOUT LOCK WAIT"

一度検索した内容を，トランザクション終了まで，排他制御しません。

"WITHOUT LOCK NOWAIT"

ほかのユーザが更新中のデータでも，更新の完了を待たないで参照して，一度検索した内容をトランザクション終了まで排他制御しません。

"WITH ROLLBACK"

検索の対象になる表をほかのユーザが使っているときは，トランザクションを取り消して無効にします。

排他オプションの文字列については，各データベースのマニュアルを参照してください。

使い方

Exclusiveプロパティの値は，QueryDefine.Executeメソッドを実行するときに使われます。QueryDefine.Executeメソッドを実行した後でExclusiveプロパティの値を変更しても，QueryDefine.Executeメソッドの結果を変えることはできません。

Executeメソッド

機能

データベースに抽出条件を渡して，検索を実行します。

形式

　　　　Object. Execute

パラメタ

Object

QueryDefineオブジェクトへの参照を表すオブジェクト式です。

使い方

検索したデータは，Resultオブジェクトを使って取得します。

結果取得を完了させないで再びQueryDefine.Executeメソッドを実行すると，エラーになります。

QueryCountメソッド

機能

抽出条件に一致するデータの件数を，数値で取得します。

形式

　　　　Object. QueryCount

パラメタ

Object

QueryDefineオブジェクトへの参照を表すオブジェクト式です。

使い方

QueryCountLimitプロパティの設定内容には依存しません。

RemoveAllメソッド

機能

すべてのTable，Column，Conditionオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

QueryDefineオブジェクトへの参照を表すオブジェクト式です。

4.8　Tablesコレクションオブジェクトの詳細

Tablesコレクションオブジェクトは，Tableオブジェクトをリストオブジェクトとして管理します。

Tablesコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Tablesコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

抽出表の個数を数値で取得します。

●Tablesコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

抽出表を文字列で追加します。

Item

Tableオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのTableオブジェクトをクリアします。

Countプロパティ

機能

抽出条件として設定されている表の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Tablesコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

抽出条件にする表を，文字列で追加します。

形式

　　　　Object. Add（String）

パラメタ

Object

Tablesコレクションオブジェクトへの参照を表すオブジェクト式です。

String

抽出条件にする表の表名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。表名は，次に示すどちらかの書式で設定してください。

"所有者"."表名"

"表名"

Itemメソッド

機能

Tableオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Tablesコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的の抽出表番号（Tableオブジェクトの番号）を，数値で設定します。番号は，1〜Tables.Countプロパティの範囲内で設定します。

RemoveAllメソッド

機能

すべてのTableオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Tablesコレクションオブジェクトへの参照を表すオブジェクト式です。

4.9　Tableオブジェクトの詳細

Tableオブジェクトは，抽出表を管理するオブジェクトです。

Tableオブジェクトのプロパティの一覧を次に示します。Tableオブジェクトのメソッドはありません。

●Tableオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

TableName

○

○

抽出表として設定されている文字列を設定します。

TableNameプロパティ

機能

抽出条件にする表名を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. TableName［= String］

パラメタ

Object

Tableオブジェクトへの参照を表すオブジェクト式です。

String

抽出する表の表名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。表名は，次に示すどちらかの書式で設定してください。

"所有者"."表名"

"表名"

4.10　Columnsコレクションオブジェクトの詳細

Columnsコレクションオブジェクトは，Columnオブジェクトをリストオブジェクトとして管理します。

Columnsコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Columnsコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

抽出列の個数を数値で返します。

●Columnsコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

抽出列を文字列で追加します。

Item

Columnオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのColumnオブジェクトをクリアします。

Countプロパティ

機能

抽出列の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Columnsコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

抽出列の列名を，文字列で追加します。

形式

　　　　Object. Add（String）

パラメタ

Object

Columnsコレクションオブジェクトへの参照を表すオブジェクト式です。

String

抽出列を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

複数の表を使うときは，"所有者.表識別子.列名" の形式で設定してください。

Itemメソッド

機能

Columnオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Columnsコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的の抽出列番号（Columnオブジェクトの番号）を，数値で設定します。番号は，1〜Columns.Countプロパティの範囲内で設定します。

RemoveAllメソッド

機能

すべてのColumnオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Columnsコレクションオブジェクトへの参照を表すオブジェクト式です。

4.11　Columnオブジェクトの詳細

Columnオブジェクトは，抽出列を管理するオブジェクトです。

Columnオブジェクトのプロパティの一覧を次に示します。Columnオブジェクトのメソッドはありません。

●Columnオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

ColumnName

○

○

抽出列の列名を設定します。

FunctionMode

○

○

抽出列に集合関数を設定します。

SortMode

○

○

抽出列にソートを設定します。

SortPriority

○

○

ソートを設定した列の優先順位を設定します。

ColumnNameプロパティ

機能

抽出列とする列名を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. ColumnName［= String］

パラメタ

Object

Columnオブジェクトへの参照を表すオブジェクト式です。

String

抽出列を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

複数の表を使うときは，"所有者.表識別子.列名" の形式で設定してください。

FunctionModeプロパティ

機能

抽出列に集合関数を設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. FunctionMode［= mode］

パラメタ

Object

Columnオブジェクトへの参照を表すオブジェクト式です。

mode

集合関数を，次に示す定数又は数値で設定します。

定数

数値

内容

dbpNormal，dbpNoFunction

0

集合関数なし

dbpGroup

1

重複排除

dbpMaximum

2

最大

dbpMinimum

3

最小

dbpCount

4

件数

dbpAverage

5

平均

dbpSum

6

合計

使い方

抽出列のどれかに集合関数を付けると，集合関数を設定していない抽出列に「重複排除」が仮定されて，抽出処理が実行されます。ただし，集合関数を設定していない抽出列の集合関数の値は変更されません。

SortModeプロパティ

機能

抽出列をソートするかどうかを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. SortMode［= mode］

パラメタ

Object

Columnオブジェクトへの参照を表すオブジェクト式です。

mode

ソートするかどうかを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpNormal，dbpNoSort

0

データをソートしません。

dbpAscend

1

データを昇順にソートします。

dbpDescend

2

データを降順にソートします。

使い方

複数の列にソートを設定したときは，優先するソートを決める必要があります。どの列のソートが優先されるかは，SortModeプロパティの実行順に従います。つまり，最初に設定されたソートが最優先になります。二つめ以降を設定するときには，現在設定されているソートの中で最も低い優先順位の次の順位が割り当てられます。

優先順位を参照又は変更したいときは，SortPriorityプロパティを使ってください。

SortPriorityプロパティ

機能

ソートが設定されている抽出列の優先順位を，数値で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. SortPriority［= number］

パラメタ

Object

Columnオブジェクトへの参照を表すオブジェクト式です。

number

ソートの優先順位を，1〜255の値で設定します。

使い方

SortPriorityプロパティが設定できる列は，SortModeプロパティでソートを設定した列だけです。ソートが設定されていない列には設定できません。

ソート優先順位の値が小さいほど，優先順位が高くなります。

優先順位の値を重複させると，同一番号内での順位は保証されません。

優先順位は，連続している値を設定する必要はありません。

4.12　Conditionsコレクションオブジェクトの詳細

Conditionsコレクションオブジェクトは，Conditionオブジェクトをリストオブジェクトとして管理します。

Conditionsコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Conditionsコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

抽出条件式の個数を取得します。

Relation

○

○

条件関連を文字列で設定します。

●Conditionsコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

抽出条件式を文字列で追加します。

Item

Conditionオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのConditionオブジェクトをクリアします。

Countプロパティ

機能

抽出条件式の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

Relationプロパティ

機能

抽出条件式を関連させる条件関連を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. Relation［= string］

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

string

抽出条件式を関連させる条件を，0〜1,024バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

値をクリアすると，すべての抽出条件式はANDで関連付けられます。

条件はすべて半角文字で設定して，AND，OR，及びNOTの前後にはスペースを入力してください。

AND，and：論理積を示します。

「1 AND 2」は，条件式1と条件式2の両方を満たすデータの抽出を設定します。

OR ，or ：論理和を示します。

「1 OR 2」は，条件式1か条件式2のどちらかを満たすデータの抽出を設定します。

NOT，not：否定を示します。

「NOT 1」は，条件式1を満たさないデータの抽出を設定します。

（ ）：括弧内の条件を優先します。

「1 AND（2 OR 3）」は，条件式2か条件式3のどちらかを満たして，かつ条件式1を満たすデータの抽出を設定します。

Addメソッド

機能

抽出データを絞り込むための条件式を，文字列で追加します。

形式

　　　　Object. Add（String）

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

String

抽出条件式を，1〜30,000バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

代表的な抽出条件式を次に示します。

列名C1のデータがNULL値の行を抽出する（NULL述語）

"C1" IS NULL

列名C2のデータが10，20，30の行を抽出する（IN述語）

"C2" IN（10，20，30）

列名C3のデータがABCから始まる行を抽出する（LIKE述語）

"C3" LIKE 'ABC%'

列名C4のデータが10から50の範囲内にある行を抽出する（BETWEEN述語）

"C4" BETWEEN 10 AND 50

列名C5のデータが100の行を抽出する（比較条件）

"C5" = 100

Itemメソッド

機能

Conditionオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的の抽出条件式番号（Conditionオブジェクトの番号）を，数値で設定します。番号は，1〜Conditions.Countプロパティの範囲内で設定します。

RemoveAllメソッド

機能

すべてのConditionオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

4.13　Conditionオブジェクトの詳細

Conditionオブジェクトは，Select文を生成するための情報になる条件情報を管理します。条件一つに付き，一つのConditionオブジェクトが対応します。

Conditionオブジェクトのプロパティの一覧を次に示します。Conditionオブジェクトのメソッドはありません。

●Conditionオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Text

○

○

抽出条件式を設定します。

Textプロパティ

機能

抽出データを絞り込むための条件式を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. Text［= String］

パラメタ

Object

Conditionオブジェクトへの参照を表すオブジェクト式です。

String

抽出の条件式を，1〜30,000バイトの文字列で設定します。長さ0の文字列は設定できません。

4.14　UpdateDefineオブジェクトの詳細

UpdateDefineオブジェクトは，更新処理を実行するオブジェクトです。

UpdateDefineオブジェクトのプロパティとメソッドの一覧を次に示します。

●UpdateDefineオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

ErrorInformation

−

○

更新処理でエラーになったオブジェクトの番号を取得します。

Exclusive

○

○

抽出処理を実行するときの排他モードを，文字列で設定します。

ExecutedRowCount

−

○

更新処理の結果，サーバプログラムで更新した行数を取得します。

NCharPrefixMode

○

○

各国文字列のデータにプレフィックスとして"N"を付けるかどうかを設定します。

TableName

○

○

更新表を設定します。

UpdateMode

○

○

更新実行モードを設定します。

●UpdateDefineオブジェクトのメソッドの一覧

メソッド

説明

Execute

更新処理を実行します。

RemoveAll

すべてのUpdate，Insert，Deleteオブジェクトをクリアします。

ErrorInformationプロパティ

機能

更新処理でエラーになったUpdate，Insert，Deleteオブジェクトの番号を，数値で取得します。

形式

　　　　Object. ErrorInformation

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

戻り値

値

内容

0

更新する表又は列として，存在しない表名又は列名を設定しています。

1以上

エラーになったUpdate，Insert，Deleteオブジェクトの番号を示します。

使い方

UpdateDefine.Executeメソッドを実行する前は，0を返します。

Exclusiveプロパティ

機能

更新する表をほかのユーザが使っているときの動作を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. Exclusive［= String］

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

String

排他オプションを，次に示す0〜64バイトの文字列で設定します。

文字列

内容

長さ0バイトの文字列

更新対象の表をほかのユーザが使っているときは，使っているユーザのトランザクション終了を待ちます。

"WITH ROLLBACK"

更新対象の表をほかのユーザが使っているときは，トランザクションを取り消して無効にします。

排他オプションの文字列については，各データベースのマニュアルを参照してください。

使い方

Exclusiveプロパティの値は，UpdateDefine.Executeメソッドを実行するときに使われます。UpdateDefine.Executeメソッドを実行した後でExclusiveプロパティの値を変更しても，UpdateDefine.Executeメソッドの結果を変えることはできません。

ExecutedRowCountプロパティ

機能

UpdateDefine.Executeメソッドを実行（Update，Insert，Delete）した結果，サーバプログラムが更新した行数を，数値で取得します。

形式

　　　　Object. ExecutedRowCount

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

使い方

UpdateDefine.Executeメソッドを実行する前は，0を返します。

NCharPrefixModeプロパティ

機能

dbpTypeNCHAR，dbpTypeNVARCHAR，dbpTypeLONGNVARCHARの各国文字列のデータに，プレフィックスとして "N" を付けるかどうかを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. NCharPrefixMode［= Mode］

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

Mode

プレフィックスを付けるかどうかを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpNCHARPrefix

0

プレフィックス "N" を付けます。

dbpCHARPrefix

1

プレフィックス "N" を付けません。

使い方

NCharPrefixModeプロパティの値は，UpdateDefine.Executeメソッドを実行するときに使われます。UpdateDefine.Executeメソッドを実行した後でNCharPrefixModeプロパティの値を変更しても，UpdateDefine.Executeメソッドの処理モードを変えることはできません。

TableNameプロパティ

機能

更新する表名を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. TableName［= string］

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

string

更新する表名を，1〜256バイトの文字列で設定します。長さ0の文字列は，設定できません。

UpdateModeプロパティ

機能

更新処理を実行するときにどのようなSQL文で更新するかを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. UpdateMode［= mode］

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

mode

更新を実行するモードを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpNormal

0

変数（？パラメタ）を使いません。

dbpVariable

1

変数（？パラメタ）を使います。

使い方

dbpNormalを設定すると，Update/Insert/Deleteの各オブジェクト単位にSQL文を作成して更新処理を実行します。

dbpVariableを設定すると，Update/Insert/Deleteの各オブジェクトの値の部分を変数にしたSQL文を作成して更新処理を実行します。dbpVariableを使うときは，更新する列の数や，列の設定順が一定でないと，エラーになります。

次に示す条件で更新するときは，更新実行モードをdbpVariableにしてください。

AddUpdateValueメソッド，AddInsertValueメソッドのデータにファイル名を指定したとき

AddUpdateValueBメソッド，AddInsertValueBメソッドを使ったとき

Executeメソッド

機能

データベースに対して，データを更新します。

形式

　　　　Object. Execute（Type）

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

Type

更新種別を，次に示す定数又は数値で設定します。

定数

数値

内容

dbpUpdate

0

変更処理を示します。

dbpInsert

1

追加処理を示します。

dbpDelete

2

削除処理を示します。

使い方

UpdateDefine.Executeメソッドを実行するためには，次に示す条件があります。

変更処理の場合

一つ以上のUpdateオブジェクトが設定されていること

追加処理の場合

一つ以上のInsertオブジェクトが設定されていること

削除処理の場合

一つ以上のDeleteオブジェクトが設定されていること

トランザクション終了モードにdbpManualを設定しているときは，更新処理が終了した時点で必ずCommitメソッド又はRollbackメソッドを実行してください。更新処理がエラーになったときも，メソッドを実行する必要があります。Commitメソッド又はRollbackメソッドを実行し忘れると，データベースのデータを壊してしまうおそれがあります。

RemoveAllメソッド

機能

Update，Insert，Deleteオブジェクトをすべてクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

4.15　Updatesコレクションオブジェクトの詳細

Updatesコレクションオブジェクトは，Updateオブジェクトをリストオブジェクトとして管理します。

Updatesコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Updatesコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

Updateオブジェクトの個数を数値で取得します。

●Updatesコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

Updateオブジェクトを生成します。

Item

Updateオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのUpdateオブジェクトを削除します。

Countプロパティ

機能

Updates.Addメソッドで作成したUpdateオブジェクトの個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Updatesコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

Updateオブジェクトを生成します。

形式

　　　　Object. Add

パラメタ

Object

Updatesコレクションオブジェクトへの参照を表すオブジェクト式です。

Itemメソッド

機能

Updateオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Updatesコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的のUpdateオブジェクトの番号を，数値で設定します。番号は，1〜Updates.Countプロパティの範囲内で設定します。

RemoveAllメソッド

機能

すべてのUpdateオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Updatesコレクションオブジェクトへの参照を表すオブジェクト式です。

4.16　Updateオブジェクトの詳細

Updateオブジェクトは，サーバプログラムのデータを変更するための情報を管理します。

Updateオブジェクトのプロパティとメソッドの一覧を次に示します。

●Updateオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Column

○

○

変更情報の列名を設定します。

KeyColumn

○

○

変更行条件の列名を設定します。

KeyCount

−

○

変更行条件の数を取得します。

KeyValue

○

○

変更行条件のデータを設定します。

UpdateValue

○

○

変更情報のデータを文字列型で設定します。

UpdateValueB

○

○

変更情報のデータをバイト型で設定します。

UpdateValueCount

−

○

変更情報の数を取得します。

●Updateオブジェクトのメソッドの一覧

メソッド

説明

AddKey

変更行条件を追加します。

AddUpdateValue

文字列型の変更情報を追加します。

AddUpdateValueB

文字列型の変更情報を追加します。

Columnプロパティ

機能

変更情報の番号で設定した情報の列名を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. Column（ValueNumber）［= Column］

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の変更情報を，数値で設定します。番号は，1〜Update.UpdateValueCountプロパティの範囲内で設定します。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

KeyColumnプロパティ

機能

変更行条件の番号で設定した条件の列名を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. KeyColumn（KeyNumber）［= Column］

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

KeyNumber

目的の条件の変更行番号を，数値で設定します。番号は，1〜Update.KeyCountプロパティの範囲内で設定します。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

KeyCountプロパティ

機能

変更行条件の数を，数値で取得します。

形式

　　　　Object. KeyCount

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

KeyValueプロパティ

機能

変更行条件の番号で設定した条件のデータを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. KeyValue（KeyNumber）［= Data］

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

KeyNumber

目的の変更行条件の番号を，数値で設定します。番号は，1〜Update.KeyCountプロパティの範囲内で設定します。

Data

条件のデータを，0〜30,000バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

UpdateValueプロパティ

機能

AddUpdateValueメソッドで追加した変更情報のデータを，文字列型で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. UpdateValue（ValueNumber）［= Data］

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の変更情報を，数値で設定します。番号は，1〜Update.UpdateValueCountプロパティの範囲内で設定します。

Data

データを，0〜30,000バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。データとしてdbpTypeLONGVARBINARY属性のデータを設定するときは，データを格納しているファイル名を設定します。

使い方

ファイルサイズが2ギガバイト以上のファイルは，データとして設定できません。

UpdateValueBプロパティ

機能

AddUpdateValueBメソッドで追加した変更情報のデータを，バイト型で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. UpdateValueB（ValueNumber）［= Data］

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の変更情報を，数値で設定します。番号は，1〜Update.UpdateValueCountプロパティの範囲内で設定します。

Data

データを，バイト型データで設定します。

使い方

更新データを格納する変数は，バイト型で宣言してください。データを格納する変数がバイト型以外のときは，エラーになります。

Visual Basicを使うときの例を次に示します（データをDataBuffに格納します）。

宣言の例：Dim DataBuff() As Byte

UpdateValueCountプロパティ

機能

変更情報の数を，数値で取得します。

形式

　　　　Object. UpdateValueCount

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

AddKeyメソッド

機能

変更行条件を追加します。列名には，Valueに設定するデータを格納している列名を設定します。データには，変更する行を特定するデータを設定します。

形式

　　　　Object. AddKey Column，Value

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

Value

データを，0〜30,000バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

一つの変更行条件で変更する行を特定できないときは，同一のUpdateオブジェクトに対して複数の変更行条件を設定してください。

AddUpdateValueメソッド

機能

変更情報を追加します。列名には，Valueに設定するデータを格納する列名を設定します。データには，新しく格納する文字列型のデータを設定します。

形式

　　　　Object. AddUpdateValue Column，Value

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

Value

データを，0〜30,000バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。データとしてdbpTypeLONGVARBINARY属性のデータを設定するときは，データを格納しているファイル名を設定します。

使い方

変更行条件で決めた行に対して，複数の列のデータを変更するときは，同じUpdateオブジェクトに対して複数の変更情報を設定してください。

ファイルサイズが2ギガバイト以上のファイルは，データとして設定できません。

AddUpdateValueメソッドで設定したデータを変更/取得するときは，UpdateValueプロパティを使います。

AddUpdateValueBメソッド

機能

変更情報を追加します。列名には，Valueに設定するデータを格納する列名を設定します。データには，新しく格納するバイト型のデータを設定します。

形式

　　　　Object. AddUpdateValueB Column，Value

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

Value

データを，バイト型データで設定します。

使い方

更新データを格納する変数は，バイト型で宣言してください。データを格納する変数がバイト型以外のときは，エラーになります。

Visual Basicを使うときの例を次に示します（データをDataBuffに格納します）。

宣言の例：Dim DataBuff() As Byte

変更行条件で決めた行に対して，複数の列のデータを変更するときは，同じUpdateオブジェクトに対して複数の変更情報を設定してください。

AddUpdateValueBメソッドで設定したデータを変更/取得するときは，UpdateValueBプロパティを使います。

4.17　Insertsコレクションオブジェクトの詳細

Insertsコレクションオブジェクトは，Insertオブジェクトをリストオブジェクトとして管理します。

Insertsコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Insertsコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

Insertオブジェクトの個数を，数値で取得します。

●Insertsコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

Insertオブジェクトを追加します。

Item

Insertオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのInsertオブジェクトをクリアします。

Countプロパティ

機能

Inserts.Addメソッドで作成したInsertオブジェクトの個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Insertsコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

Insertオブジェクトを追加します。

形式

　　　　Object. Add

パラメタ

Object

Insertsコレクションオブジェクトへの参照を表すオブジェクト式です。

Itemメソッド

機能

Insertオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Insertsコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的のInsertオブジェクトの番号を，数値で設定します。番号は，1〜Inserts.Countプロパティの範囲内で設定します。

RemoveAllメソッド

機能

すべてのInsertオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Insertsコレクションオブジェクトへの参照を表すオブジェクト式です。

4.18　Insertオブジェクトの詳細

Insertオブジェクトは，表に挿入する1行分のデータを管理するオブジェクトです。一つのInsertオブジェクトには列単位に複数の挿入値を設定できます。

Insertオブジェクトのプロパティとメソッドの一覧を次に示します。

●Insertオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Column

○

○

追加情報の列名を設定します。

InsertValue

○

○

追加情報のデータを文字列型で設定します。

InsertValueB

○

○

追加情報のデータをバイト型で設定します。

InsertValueCount

−

○

追加情報の個数を数値で取得します。

●Insertオブジェクトのメソッドの一覧

メソッド

説明

AddInsertValue

文字列型の追加情報を追加します。

AddInsertValueB

バイト型の追加情報を追加します。

Columnプロパティ

機能

追加情報の番号で設定した情報の列名を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. Column（ValueNumber）［= Column］

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の追加情報の番号を，数値で設定します。番号は，1〜Insert.InsertValueCountプロパティの範囲内で設定します。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

InsertValueプロパティ

機能

AddInsertValueメソッドで追加した追加情報のデータを，文字列型で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. InsertValue（ValueNumber）［= Data］

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の追加情報の番号を，数値で設定します。番号は，1〜Insert.InsertValueCountプロパティの範囲内で設定します。

Data

データを，0〜30,000バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。データとしてdbpTypeLONGVARBINARY属性のデータを設定するときは，データを格納しているファイル名を設定します。

使い方

ファイルサイズが2ギガバイト以上のファイルは，データとして設定できません。

InsertValueBプロパティ

機能

AddInsertValueBメソッドで追加した追加情報のデータを，バイト型で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. InsertValueB（ValueNumber）［= Data］

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の追加情報の番号を，数値で設定します。番号は，1〜Insert.InsertValueCountプロパティの範囲内で設定します。

Data

データを，バイト型データで設定します。

使い方

更新データを格納する変数は，バイト型で宣言してください。データを格納する変数がバイト型以外のときは，エラーになります。

Visual Basicを使うときの例を次に示します（データをDataBuffに格納します）。

宣言の例：Dim DataBuff() As Byte

InsertValueCountプロパティ

機能

追加情報の数を，数値で取得します。

形式

　　　　Object. InsertValueCount

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

AddInsertValueメソッド

機能

追加情報を追加します。列名には，Valueに設定するデータを格納する列名を設定します。データには，新しく追加する文字列型のデータを設定します。

形式

　　　　Object. AddInsertValue Column，Value

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

Value

データを，0〜30,000バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。データとしてdbpTypeLONGVARBINARY属性のデータを設定するときは，データを格納しているファイル名を設定します。

使い方

複数の列にデータを追加するときは，同じInsertオブジェクトに対して複数の追加情報を設定してください。

ファイルサイズが2ギガバイト以上のファイルは，データとして設定できません。

AddInsertValueメソッドで設定したデータを変更/取得するときは，InsertValueプロパティを使います。

AddInsertValueBメソッド

機能

追加情報を追加します。列名には，Valueに設定するデータを格納する列名を設定します。データには，新しく追加するバイト型のデータを設定します。

形式

　　　　Object. AddInsertValueB Column，Value

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

Value

データを，バイト型データで設定します。

使い方

更新データを格納する変数は，バイト型で宣言してください。データを格納する変数がバイト型以外のときは，エラーになります。

Visual Basicを使うときの例を次に示します（データをDataBuffに格納します）。

宣言の例：Dim DataBuff() As Byte

複数の列にデータを追加するときは，同じInsertオブジェクトに対して複数の追加情報を設定してください。

AddInsertValueBメソッドで設定したデータを変更/取得するときは，InsertValueBプロパティを使います。

4.19　Deletesコレクションオブジェクトの詳細

Deletesコレクションオブジェクトは，Deleteオブジェクトをリストオブジェクトとして管理します。

Deletesコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Deletesコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

Deleteオブジェクトの個数を数値で取得します。

●Deletesコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

Deleteオブジェクトを追加します。

Item

Deleteオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのDeleteオブジェクトをクリアします。

Countプロパティ

機能

Deletes.Addメソッドで作成したDeleteオブジェクトの個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Deletesコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

Deleteオブジェクトを生成します。

形式

　　　　Object. Add

パラメタ

Object

Deletesコレクションオブジェクトへの参照を表すオブジェクト式です。

Itemメソッド

機能

Deleteオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Deletesコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的のDeleteオブジェクトの番号を，数値で設定します。番号は，1〜Deletes.Countプロパティの範囲内で設定します。

RemoveAllメソッド

機能

すべてのDeleteオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Deletesコレクションオブジェクトへの参照を表すオブジェクト式です。

4.20　Deleteオブジェクトの詳細

Deleteオブジェクトは，Delete文を生成するための情報になる削除データの設定値情報を管理します。Delete文1文に付き，一つのDeleteオブジェクトが対応します。

Deleteオブジェクトのプロパティとメソッドの一覧を次に示します。

●Deleteオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

KeyColumn

○

○

削除行条件の列名を設定します。

KeyCount

−

○

削除行条件の数を取得します。

KeyValue

○

○

削除行条件のデータを設定します。

●Deleteオブジェクトのメソッドの一覧

メソッド

説明

AddKey

削除行条件を追加します。

KeyColumnプロパティ

機能

削除行条件の番号で設定した条件の列名を，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. KeyColumn（KeyNumber）［= Column］

パラメタ

Object

Deleteオブジェクトへの参照を表すオブジェクト式です。

KeyNumber

目的の削除行条件の番号を，数値で設定します。番号は，1〜Delete.KeyCountプロパティの範囲内で設定します。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

KeyCountプロパティ

機能

削除行条件の数を，数値で取得します。

形式

　　　　Object. KeyCount

パラメタ

Object

Deleteオブジェクトへの参照を表すオブジェクト式です。

KeyValueプロパティ

機能

削除行条件の番号で設定した条件のデータを，文字列で設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. KeyValue（KeyNumber）［= Data］

パラメタ

Object

Deleteオブジェクトへの参照を表すオブジェクト式です。

KeyNumber

目的の削除行条件の番号を，数値で設定します。番号は，1〜Delete.KeyCountプロパティの範囲内で設定します。

Data

データを，0〜30,000バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

AddKeyメソッド

機能

削除行条件を追加します。列名には，Valueに設定するデータを格納している列名を設定します。データには，削除する行を特定するデータを設定します。

形式

　　　　Object. AddKey Column，Value

パラメタ

Object

Deleteオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。列名は，次に示す書式で設定してください。

"列名"（表名で修飾できません）

Value

データを，0〜30,000バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

一つの削除行条件で削除する行を特定できないときは，同一のDeleteオブジェクトに対して複数の削除行条件を設定してください。

4.21　Catalogオブジェクトの詳細

Catalogオブジェクトは，手順ファイルを参照しQueryDefineオブジェクトを生成するための情報を管理します。

Catalogオブジェクトのメソッドの一覧を次に示します。Catalogオブジェクトのプロパティはありません。

●Catalogオブジェクトのメソッドの一覧

メソッド

説明

Convert

読み込んだ手順ファイルの情報からQueryDefineオブジェクトを生成します。

FileLoad

手順ファイルの情報を読み込みます。

Convertメソッド

機能

FileLoadメソッドで読み込まれた手順ファイルの情報から，QueryDefineオブジェクトを生成します。

形式

　　　　Object. Convert

パラメタ

Object

Catalogオブジェクトへの参照を表すオブジェクト式です。

使い方

可変値を使用している手順ファイルを読み込んだ場合は，Convertメソッドを発行する前にVariableListオブジェクトに実行値を設定してください。実行値が設定されていない場合は，手順ファイルが格納している初期値を使用してQueryDefineオブジェクトを生成します。

Convertメソッドを発行すると，現在のQueryDefineオブジェクトの内容は削除されます。

FileLoadメソッド

機能

手順ファイルから抽出に関係する情報を読み込みます。抽出条件として可変値が使用されている場合は，VariableList.Countプロパティに可変値の個数が返されます。手順ファイルの情報からQueryDefineオブジェクトを生成するには，Convertメソッドを使用します。

形式

　　　　Object. FileLoad（FileName）

パラメタ

Object

Catalogオブジェクトへの参照を表すオブジェクト式です。

FileName

ファイル名を，1〜256バイトの文字列で設定します。

使い方

ファイル名にパスが含まれていない場合は，カレントディレクトリが仮定されます。

FileLoadメソッドを発行すると，VariableListオブジェクトの各プロパティの内容が更新されます。

CommuniNet接続の抽出を登録した手順ファイルを設定した場合，動作は保証しません。

次に示す手順ファイルを設定した場合，エラーとなります。

DBPARTNER/Client 03-00以前のバージョンの手順ファイル

表定義を登録した手順ファイル

アウタジョインを登録した手順ファイル

SQLを登録した手順ファイル

保存，予約，絞り込みを登録した手順ファイルからは，表定義に関する情報は読み込みません。

メール連携を登録した手順ファイルからは，メール操作に関する情報は読み込みません。

更新用抽出を登録した手順ファイルは，抽出操作として読み込みます。

手順ファイルに登録されている情報でも，次に示す情報は読み込みません。

ホスト名称，転送先種別，転送先ファイル名，逐次検索，件数確認，抽出件数の制限，仮想列の名称，更新キー解除，BINARY属性のファイル種別

4.22　VariableListオブジェクトの詳細

VariableListオブジェクトは，手順ファイルに格納されている可変値情報を取得したり，取得した情報を管理したりします。それぞれの情報はプロパティによって返されます。

VariableListオブジェクトのプロパティの一覧を次に示します。VariableListオブジェクトのメソッドはありません。

●VariableListオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

手順ファイルに格納されている可変値の個数を数値で取得します。

VariableName

−

○

可変値の名称を文字列で取得します。

VariableValue

○

○

可変値の値とする実行値を設定します。

Countプロパティ

機能

Catalog.FileLoadメソッドで読み込んだ手順ファイルに格納されている可変値の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

VariableListオブジェクトへの参照を表すオブジェクト式です。

使い方

手順ファイルに可変値が使用されていない場合，このプロパティの値は0になります。

VariableNameプロパティ

機能

可変値の名称を文字列で取得します。

形式

　　　　Object. VariableName（Index）

パラメタ

Object

VariableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の可変値の番号を数値で設定します。番号は，1〜VariableList.Countプロパティの範囲で設定します。

使い方

可変値の名称の先頭に付いている“&”は返りません。

VariableValueプロパティ

機能

可変値の値とする実行値を設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. VariableValue（Index）［= String］

パラメタ

Object

VariableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の可変値の番号を数値で設定します。番号は，1〜VariableList.Countプロパティの範囲で設定します。

String

実行値を，1〜30,000バイトの文字列で設定します。

使い方

Catalog.FileLoadメソッド発行直後は，手順ファイルに格納されている初期値が実行値として設定されます。

実行値に長さ0の文字列，又は30,001バイト以上の文字列が設定された場合，エラーとなります。

4.23　Procedureオブジェクトの詳細

Procedureオブジェクトは，ストアドプロシジャを実行する情報を管理します。

Procedureオブジェクトのプロパティとメソッドの一覧を次に示します。

●Procedureオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

ListPattern

○

○

ストアドプロシジャの一覧を絞り込む条件を文字列で指定します。

●Procedureオブジェクトのメソッドの一覧

メソッド

説明

Execute

ストアドプロシジャを実行します。

GetList

ストアドプロシジャの一覧を取得し，ProcedureListオブジェクトを生成します。

GetParam

ストアドプロシジャを構成するパラメタの一覧を取得し，ParamListオブジェクトを生成します。

ListPatternプロパティ

機能

ストアドプロシジャの一覧を取得するための絞り込み条件を，文字列で設定します。このプロパティは値の取得もできます。

形式

　　　　Object.ListPattern[= text]

パラメタ

Object

Procedureオブジェクトへの参照を表すオブジェクト式です。

text

絞り込み条件を0〜128バイトまでの文字列で設定します。文字列には，ワイルドカード（_，%）文字が使えます。値をクリアする場合は，長さ0の文字列を設定します。次の書式で設定してください。

所有者.ストアドプロシジャ名

ストアドプロシジャ名

使い方

絞り込み条件に指定する所有者やストアドプロシジャ名の最大長は，使用するデータベースに依存します。制限を超えた絞り込み条件を指定した場合は，Procedure.GetListメソッドがエラーになるか，絞り込みが正しく行われません。

値がクリアされている場合は，%.% が仮定されます。

_（アンダースコア文字）は，ある1文字を表します。

%（パーセント文字）は，0個以上のある文字のつながりを表します。

使用できる絞り込み条件を次に示します。

前方一致

（例：ABC%）ストアドプロシジャ名の先頭が'ABC'であり，以降の文字は任意です。

後方一致

（例：％ABC）ストアドプロシジャ名の最後が'ABC'であり，以前の文字は任意です。

任意一致

（例：％ABC％）ストアドプロシジャ名中の任意の部分が'ABC'です。

完全一致

（例：ABC）ストアドプロシジャ名が'ABC'と同じです。

部分一致

（例：_ABC_）5文字のストアドプロシジャ名のうち，2〜4文字目が'ABC'です。

（例：A_B%C）ストアドプロシジャ名の先頭がA，3文字目が'B'，最後が'C'です。

_や%を条件に含めたい場合は，それらの文字の前に'¥'を付けます。

ABC¥%% 文字列の先頭が'ABC%'であり，以降の文字は任意です。

ListPatternプロパティの値は，Procedure.GetListメソッド発行時に使用されます。Procedure.GetListメソッド発行後にListPatternプロパティの値を変更しても，Procedure.GetListメソッドの結果を変えることはできません。

Executeメソッド

機能

Procedure.GetParamメソッドで指定したストアドプロシジャを実行します。

形式

　　　　Object.Execute

パラメタ

Object

Procedureオブジェクトへの参照を表すオブジェクト式です。

使い方

Executeメソッドを実行する前に，Procedure.GetParamメソッドを発行しておく必要があります。パラメタがないストアドプロシジャを実行する場合でも，Procedure.GetParamメソッドは発行してください。

GetListメソッド

機能

ストアドプロシジャの一覧を取得し，ProcedureListオブジェクトを生成します。

形式

　　　　Object.GetList

パラメタ

Object

Procedureオブジェクトへの参照を表すオブジェクト式です。

GetParamメソッド

機能

ストアドプロシジャを構成するパラメタの一覧を取得し，ParamListオブジェクトを生成します。

形式

　　　　Object.GetParam(ProcedureName)

パラメタ

Object

Procedureオブジェクトへの参照を表すオブジェクト式です。

ProcedureName

ストアドプロシジャ名を，1〜256バイトの文字列で指定します。

4.24　ParamListオブジェクトの詳細

ParamListオブジェクトは，指定されたストアドプロシジャ名に定義されているパラメタを取得したり，取得した結果を管理したりします。それぞれの列情報は，プロパティによって返されます。

ParamListオブジェクトのプロパティの一覧を次に示します。ParamListオブジェクトのメソッドはありません。

●ParamListオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

取得したパラメタの数を数値で取得します。

ParamCodeType

○

○

出力パラメタの値を文字列で取得するかバイト型データで取得するかを数値で設定します。

ParamName

−

○

パラメタの名称を文字列で取得します。

ParamType

○

○

パラメタの種別を数値で取得します。

ParamComment

−

○

パラメタのコメントを文字列で取得します。

ParamDataType

−

○

パラメタの属性を数値で取得します。

ParamLength

−

○

パラメタの定義長を数値で取得します。

ParamNullable

−

○

入力パラメタにNULLが設定できるかどうかを数値で取得します。

ParamPrecision

○

○

パラメタの精度を数値で取得します。

ParamRadix

−

○

パラメタの基数を数値で取得します。

ParamScale

○

○

パラメタの値の小数点以下けた数を数値で取得します。

ParamTypeName

−

○

パラメタのデータベース依存の属性を文字列で取得します。

ParamValue

○

○

入力パラメタに文字列で値を設定します。又は出力パラメタから文字列で値を取得します。

ParamValueB

○

○

入力パラメタにバイト型データで値を設定します。又は出力パラメタからバイト型データで値を取得します。

ParamValueMaxLength

○

○

出力パラメタから値を取得するときのバイト数を数値で設定します。

Countプロパティ

機能

取得したパラメタの数を数値で取得します。

形式

　　　　Object.Count

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

ParamCodeTypeプロパティ

機能

出力パラメタの値を，文字列(ParamList.ParamValueプロパティ)で取得するかバイト型データ(ParamList.ParamValueBプロパティ)で取得するかを，数値で設定します。

形式

　　　　Object.ParamCodeType(Index)[= Mode ]

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

Mode

モードを，定数，又は数値で設定します。

定数

値

内容

dbpBINARY

-2

ParamList.ParamValueBプロパティを使用してデータを設定又は取得します。

dbpCHAR

1

ParamList.ParamValueプロパティを使用してデータを設定又は取得します。

ParamNameプロパティ

機能

パラメタの名称を文字列で取得します。

形式

　　　　Object.ParamName(Index)

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

ParamTypeプロパティ

機能

パラメタの種別を取得します。取得した値と異なる値を設定することもできます。

形式

　　　　Object.ParamType(Index)[= Type ]

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

Type

返されるパラメタ種別には次の種類があります。

定数

値

内容

dbpParamTypeUnknown

0

未知の型のパラメタ

dbpParamInput

1

入力パラメタ

dbpParamInputOutput

2

入出力パラメタ

dbpResultCol

3

結果セットの列

dbpParamOutput

4

出力パラメタ

dbpReturnValue

5

ストアドプロシジャの戻り値

使い方

ストアドプロシジャに，種別がdbpResultColやdbpParamTypeUnknownのパラメタが定義されていると，Procedure.Executeメソッド発行時にエラーとなります。

取得した種別と異なる種別を設定する必要がある場合は，dbpResultColやdbpParamTypeUnknown以外の種別を設定してください。dbpResultColやdbpParamTypeUnknownを設定すると，Procedure.Executeメソッド発行時にエラーとなります。

ParamCommentプロパティ

機能

パラメタのコメントを文字列で取得します。

形式

　　　　Object.ParamComment(Index)

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

ParamDataTypeプロパティ

機能

パラメタの属性を数値で取得します。

形式

　　　　Object.ParamDataType(Index)

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

使い方

属性の詳細については，「付録E.1　ODBC接続のときの列の属性」を参照してください。

ParamLengthプロパティ

機能

パラメタの定義長を数値で取得します。

形式

　　　　Object.ParamLength(Index)

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

ParamNullableプロパティ

機能

入力パラメタにNULLが設定できるかどうかを数値で取得します。

形式

　　　　Object.ParamNullable(Index)

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

戻り値

定数

値

内容

dbpNoNulls

0

NULL値を設定できない。

dbpNullable

1

NULL値を設定できる。

dbpNullableUnknown

2

NULL値を設定できるかどうか不明。

ParamPrecisionプロパティ

機能

パラメタの精度を数値で取得します。

形式

　　　　Object.ParamPrecision(Index)[= Length]

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

Length

パラメタの精度を，1〜2147483647の数値で設定します。

ParamRadixプロパティ

機能

パラメタの基数を数値で取得します。

形式

　　　　Object.ParamRadix(Index)

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

ParamScaleプロパティ

機能

パラメタの値の小数点以下けた数を数値で取得します。

形式

　　　　Object.ParamScale(Index)[= Length]

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

Length

パラメタの値の小数点以下けた数を，-2147483648〜2147483647の数値で設定します。

ParamTypeNameプロパティ

機能

パラメタのデータベース依存の属性を文字列で取得します。

形式

　　　　Object.ParamTypeName(Index)

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

ParamValueプロパティ

機能

入力パラメタに文字列で値を設定します。又は，出力パラメタから文字列で値を取得します。

形式

　　　　Object.ParamValue(Index)[= Data]

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

Data

データを，0〜30000バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

パラメタの属性がdbpTypeBINARY，dbpTypeVARBINARY，dbpTypeLONGVARBINARYのパラメタに対して，このメソッドで値を設定，又は取得する場合は，ParamCodeTypeプロパティにdbpCHARを設定してからProcedure.Executeメソッドを発行してください。

パラメタ番号で指定したパラメタの種別によって，使い方が異なります。

パラメタ種別

用途

dbpParamInput

ストアドプロシジャを実行させるために必要な値を文字列で入力するプロパティとして使用します。

Procedure.Executeメソッド発行前に値を設定します。

dbpParamOutput

ストアドプロシジャの実行結果を文字列で取得するプロパティとして使用します。

Procedure.Executeメソッド発行後に値を取得します。

dbpParamInputOutput

Procedure.Executeメソッド発行前は，ストアドプロシジャを実行させるために必要な値を文字列で入力するプロパティとして使用します。

Procedure.Executeメソッド発行後は，ストアドプロシジャの実行結果を文字列で取得するプロパティとして使用します。

dbpReturnValue

ストアドプロシジャを実行させた時の戻り値を文字列で取得するプロパティとして使用します。

Procedure.Executeメソッド発行後に値を取得します。

ParamValueBプロパティ

機能

入力パラメタにバイト型データで値を設定します。又は，出力パラメタからバイト型データで値を取得します。

形式

　　　　Object.ParamValueB(Index)[= Data]

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

Data

データを，バイト型データで設定します。

使い方

このメソッドで，パラメタの属性がdbpTypeBINARY，dbpTypeVARBINARY，dbpTypeLONGVARBINARY以外のパラメタに対して値を設定，又は取得する場合は，ParamCodeTypeプロパティにdbpBINARYを設定してからProcedure.Executeメソッドを発行してください。

パラメタ番号で指定したパラメタの種別によって，使い方が異なります。

パラメタ種別

用途

dbpParamInput

ストアドプロシジャを実行させるために必要な値をバイト型データで入力するプロパティとして使用します。

Procedure.Executeメソッド発行前に値を設定します。

dbpParamOutput

ストアドプロシジャの実行結果をバイト型データで取得するプロパティとして使用します。

Procedure.Executeメソッド発行後に値を取得します。

dbpParamInputOutput

Procedure.Executeメソッド発行前は，ストアドプロシジャを実行させるために必要な値をバイト型データで入力するプロパティとして使用します。

Procedure.Executeメソッド発行後は，ストアドプロシジャの実行結果をバイト型データで取得するプロパティとして使用します。

dbpReturnValue

ストアドプロシジャを実行させた時の戻り値をバイト型データで取得するプロパティとして使用します。

Procedure.Executeメソッド発行後に値を取得します。

ParamValueMaxLengthプロパティ

機能

出力パラメタから値を取得するときのバイト数を数値で設定します。

機能

入力パラメタにバイト型データで値を設定します。又は，出力パラメタからバイト型データで値を取得します。

形式

　　　　Object.ParamValueMaxLength(Index)[= Length]

パラメタ

Object

ParamListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のパラメタを数値で設定します。番号は，1〜ParamList.Countプロパティの範囲内で指定します。

Length

出力パラメタから取得するデータのバイト数を，1〜2147483647の数値で設定します。

使い方

パラメタの属性が，dbpLONGVARCHAR，又はdbpLONGVARBINARYのパラメタの値を取得する場合に使用します。上記以外の属性では無視されます。

4.25　ProcedureListオブジェクトの詳細

ProcedureListオブジェクトは，指定されたデータソースに格納されているストアドプロシジャの一覧情報を取得したり，取得した結果を管理したりします。それぞれの情報は，プロパティによって返されます。

ProcedureListオブジェクトのプロパティの一覧を次に示します。ProcedureListオブジェクトのメソッドはありません。

●ProcedureListオブジェクトのプロパティの一覧

プロパティ

説明

Count

取得したストアドプロシジャの個数を数値で取得します。

ProcedureComment

ストアドプロシジャのコメントを文字列で取得します。

ProcedureName

ストアドプロシジャの名称を文字列で取得します。

ProcedureOwner

ストアドプロシジャの所有者を文字列で取得します。

ProcedureType

ストアドプロシジャの型を数値で取得します。

Countプロパティ

機能

取得したストアドプロシジャの個数を数値で取得します。

形式

　　　　Object.Count

パラメタ

Object

ProcedureListオブジェクトへの参照を表すオブジェクト式です。

ProcedureCommentプロパティ

機能

ストアドプロシジャのコメントを文字列で取得します。

形式

　　　　Object.ProcedureComment(Index)

パラメタ

Object

ProcedureListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のストアドプロシジャを数値で設定します。番号は，1〜ProcedureList.Countプロパティの範囲内で指定します。

ProcedureNameプロパティ

機能

ストアドプロシジャの名称を文字列で取得します。

形式

　　　　Object.ProcedureName(Index)

パラメタ

Object

ProcedureListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のストアドプロシジャを数値で設定します。番号は，1〜ProcedureList.Countプロパティの範囲内で指定します。

ProcedureOwnerプロパティ

機能

ストアドプロシジャの所有者を文字列で取得します。

形式

　　　　Object.ProcedureOwner(Index)

パラメタ

Object

ProcedureListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のストアドプロシジャを数値で設定します。番号は，1〜ProcedureList.Countプロパティの範囲内で指定します。

ProcedureTypeプロパティ

機能

ストアドプロシジャの型を数値で取得します。

形式

　　　　Object.ProcedureType(Index)

パラメタ

Object

ProcedureListオブジェクトへの参照を表すオブジェクト式です。

Index

目的のストアドプロシジャを数値で設定します。番号は，1〜ProcedureList.Countプロパティの範囲内で指定します。

戻り値

定数

値

内容

dbpPtUnknown

0

ストアドプロシジャが戻り値を返すかどうか不明です。

dbpPtProcedure

1

戻り値を返さないストアドプロシジャです。

dbpPtFunction

2

戻り値を返すストアドプロシジャです。

使い方

ストアドプロシジャの型がdbpPtProcedureの場合，戻り値はParamList.ParamTypeプロパティがdbpReturnValueの列に格納されます。

第4編　DBPARTNER ODBC Driver

5　ODBC関数を使ったデータベースアクセス

この章では，DBPARTNER ODBC Driverをセットアップすると使えるODBC関数について説明します。

5.1　DBPARTNER ODBC Driverが提供するODBC関数の概要

DBPARTNER ODBC Driverをセットアップすると，ODBC関数（LEVEL1とLEVEL2の一部）が使えます。このODBC関数を使ったアプリケーションから，サーバのデータベースにアクセスできます。

DBPARTNER ODBC Driverは，DBPARTNER2 Clientと一緒にインストールしてActiveXコントロールのアプリケーションと連携して使うことも，DBPARTNER2 Client以外のアプリケーションで使うこともできます。

ここでは，DBPARTNER2 Clientが提供するODBC関数，ODBCとデータベースとのデータ型の対応，及びODBC関数の規則について説明します。ODBC関数については，ODBCドライバのヘルプでも説明しているので，必要に応じて参照してください。

DBPARTNER ODBC Driverで使えるODBC関数は，ODBC 2.0の範囲で使ってください。

5.1.1　ODBCドライバを使ってアクセスできるデータベース

ODBCドライバを使ってアクセスできるデータベースについては，「1.4.2　ODBCドライバの概要」に示す表1-3と表1-4を参照してください。

5.2　DBPARTNER ODBC Driverで使えるODBC関数

5.2.1　DABrokerドライバで使えるODBC関数

DABrokerドライバ（DBPARTNER/Serverドライバ）で使えるODBC関数を表に示します。DABroker経由の場合は表5-1を，DABroker-DBS経由又はDBS直結の場合は表5-2を参照してください。

表5-1の項目名称にある「RDA経由」とは，RDA Link for Gateway経由で接続するデータベースを表しています。RDA Link for Gateway経由で接続するデータベースには，RDB1 E2，XDM/RD E2，及びRDB編成ファイルがあります。「RDA経由」を含む表の項目名称に使用している略称については，凡例で説明しています。また，表の中で※印で示している注意事項については，この項の末尾にまとめて記述しています。

表5‒1　DABrokerドライバで使えるODBC関数（DABroker経由の場合）

分類

ODBC関数

DABroker直結

RDA経由

拡張レベル

HiR

ORA

SQL

Adap

data sourceとの接続

SQLAllocEnv

○

○

○

○

○

Core

SQLAllocConnect

○

○

○

○

○

Core

SQLConnect

○

○

○

○

○

Core

SQLDriverConnect

○

○

○

○

○

Level1

SQLBrowseConnect

○

○

○

○

○

Level2

SQLDataSource

−

−

−

−

−

Level2

SQLDrivers

−

−

−

−

−

Level2

ドライバとdata sourceの情報取得

SQLGetInfo

○

○

○

○

○

Level1

SQLGetFunction

○

○

○

○

○

Level1

SQLGetTypeInfo

○

○

○

○

○

Level1

ドライバオプションの設定と取得

SQLSetConnectOption

○

○

○

○

○

Level1

SQLGetConnectOption

○

○

○

○

○

Level1

SQLSetStmtOption

○

○

○

○

○

Level1

SQLGetStmtOption

○

○

○

○

○

Level1

SQL要求の作成

SQLAllocStmt

○

○

○

○

○

Core

SQLPrepare

○

○

○

○

○

Core

SQLBindParameter

△

△

△

△

△

Level1

SQLSetParam

○

○

○

○

○

Level1

SQLParamOption※1

×

×

×

×

×

Level2

SQLGetCursorName

○

○

○

○

○

Core

SQLSetCursorName

○

○

○

○

○

Core

SQLSetScrollOption※2

×

×

×

×

×

Level2

SQLの実行

SQLExecute

○

○

○

○

○

Core

SQLExecDirect

○

○

○

○

○

Core

SQLNativeSql

○

○

○

○

○

Level2

SQLDescribeParam

○

×

○

○

×

Level2

SQLNumParams

○

○

※4

○

○

○

※4

Level2

SQLParamData

○

○

○

○

○

Level1

SQLPutData

○

○

○

○

○

Level1

実行結果と実行結果情報の取得

SQLRowCount

○

○

○

○

○

Core

SQLNumResultCols

○

○

○

○

○

Core

SQLDescribeCol

○

○

○

○

○

Core

SQLColAttributes

○

○

○

○

○

Core

SQLBindCol

○

○

○

○

○

Core

SQLFetch

○

○

○

○

○

Core

SQLExtendedFetch※2

×

×

×

×

×

Level2

SQLGetData

○

○

○

○

○

Level1

SQLSetPos※2

×

×

×

×

×

Level2

SQLMoreResults※5

○

○

○

○

○

Level1

SQLError

○

○

○

○

○

Core

data sourceのシステム情報の取得

SQLColumnPrivileges

○

○

○

○

○

Level2

SQLColumns

○

○

○

○

○

Level1

SQLForeignKeys※1

×

×

×

×

×

Level2

SQLPrimaryKeys※1

×

※7

○

※3

○

※3

○

※3

×

※7

Level2

SQLProcedureColumns

○

○

○

○

×

※7

Level2

SQLProcedures

○

○

○

○

×

※7

Level2

SQLSpecialColumns

○

※5

○

※6

○

※5

○

※5

○

※5

Level1

SQLStatistics

○

○

○

○

○

Level1

SQLTablePrivileges

○

○

○

○

○

Level2

SQLTables

○

○

○

○

○

Level1

SQL実行の終了

SQLFreeStmt

○

○

○

○

○

Core

SQLCancel

○

○

○

○

○

Core

SQLTransact

○

○

○

○

○

Core

切り離し

SQLDisconnect

○

○

○

○

○

Core

SQLFreeConnect

○

○

○

○

○

Core

SQLFreeEnv

○

○

○

○

○

Core

表5‒2　DABrokerドライバで使えるODBC関数（DABroker-DBS経由又はDBS直結の場合）

分類

ODBC関数

RD

SD

RDB

PDM

RDB1

KSP

拡張レベル

data sourceとの接続

SQLAllocEnv

○

○

○

○

○

○

Core

SQLAllocConnect

○

○

○

○

○

○

Core

SQLConnect

○

○

○

○

○

○

Core

SQLDriverConnect

○

○

○

○

○

○

Level1

SQLBrowseConnect

○

○

○

○

○

○

Level2

SQLDataSource

−

−

−

−

−

−

Level2

SQLDrivers

−

−

−

−

−

−

Level2

ドライバとdata sourceの情報取得

SQLGetInfo

○

○

○

○

○

○

Level1

SQLGetFunction

○

○

○

○

○

○

Level1

SQLGetTypeInfo

○

○

○

○

○

○

Level1

ドライバオプションの設定と取得

SQLSetConnectOption

○

○

○

○

○

○

Level1

SQLGetConnectOption

○

○

○

○

○

○

Level1

SQLSetStmtOption

○

○

○

○

○

○

Level1

SQLGetStmtOption

○

○

○

○

○

○

Level1

SQL要求の作成

SQLAllocStmt

○

○

○

○

○

○

Core

SQLPrepare

○

○

○

○

○

○

Core

SQLBindParameter

△

△

△

△

△

×

※7

Level1

SQLSetParam

○

○

○

○

○

×

※7

Level1

SQLParamOption※1

×

×

×

×

×

×

Level2

SQLGetCursorName

○

○

○

○

○

○

Core

SQLSetCursorName

○

○

○

○

○

○

Core

SQLSetScrollOption※2

×

×

×

×

×

×

Level2

SQLの実行

SQLExecute

○

○

○

○

○

○

Core

SQLExecDirect

○

○

○

○

○

○

Core

SQLNativeSql

○

○

○

○

○

○

Level2

SQLDescribeParam

○

○

○

○

○

×

※7

Level2

SQLNumParams

○

○※3

○※3

○※3

○※3

×

※7

Level2

SQLParamData

○

○

○

○

○

×

※7

Level1

SQLPutData

○

○

○

○

○

×

※7

Level1

実行結果と実行結果情報の取得

SQLRowCount

○

○

○

○

○

○

Core

SQLNumResultCols

○

○

○

○

○

○

Core

SQLDescribeCol

○

○

○

○

○

○

Core

SQLColAttributes

○

○

○

○

○

○

Core

SQLBindCol

○

○

○

○

○

○

Core

SQLFetch

○

○

○

○

○

○

Core

SQLExtendedFetch※2

×

×

×

×

×

×

Level2

SQLGetData

○

○

○

○

○

○

Level1

SQLSetPos※2

×

×

×

×

×

×

Level2

SQLMoreResults※5

○

○

○

○

○

※5

○

Level1

SQLError

○

○

○

○

○

○

Core

data sourceのシステム情報の取得

SQLColumnPrivileges

○

×

○

×

※5

○

×

※5

Level2

SQLColumns

○

○

○

○

○

○

Level1

SQLForeignKeys※1

×

×

×

×

×

×

Level2

SQLPrimaryKeys※1

×

※7

×

※7

×

※7

×

※7

×

※7

×

※7

Level2

SQLProcedureColumns

○

※8

×

※7

×

※7

×

※7

×

※7

×

※7

Level2

SQLProcedures

○

※8

×

※7

×

※7

×

※7

×

※7

×

※7

Level2

SQLSpecialColumns

○

※5

○

※6

○

※6

○

※6

○

※6

○

※5

Level1

SQLStatistics

○

○

○

×

※5

○

×

※5

Level1

SQLTablePrivileges

○

×

○

×

※5

○

×

※5

Level2

SQLTables

○

○

○

○

○

○

Level1

SQL実行の終了

SQLFreeStmt

○

○

○

○

○

○

Core

SQLCancel

○

○

○

○

○

○

Core

SQLTransact

○

○

○

○

○

○

Core

切り離し

SQLDisconnect

○

○

○

○

○

○

Core

SQLFreeConnect

○

○

○

○

○

○

Core

SQLFreeEnv

○

○

○

○

○

○

Core

（凡例）

○：関数をサポートしています。

×：関数をサポートしていません。

△：SQLSetParamの機能だけをサポートしています。

HiR：HiRDBのことです。

ORA：ORACLEのことです。

SQL：SQL Serverのことです。

Adap：Adaptive Server Anywhereのことです。

RDA経由：RDA Link for Gateway経由で接続するデータベースを表します。このデータベースには，RDB1 E2，XDM/RD E2，及びRDB編成ファイルがあります。

RD：XDM/RD E2のことです。

SD：XDM/SD E2のことです。

RDB：RDB編成ファイルのことです。

PDM：PDMII E2のことです。

KSP：VOSKスプールファイルのことです。

RDB1：RDB1 E2のことです。

Core：コアレベルのことです。

注※1

DABrokerドライバではこの関数はサポートしていないので，ドライバマネージャがエラーリターンします（SQL STATE：IM001）。

注※2

DABrokerドライバではサポートしていません。ただし，ODBC 2.0カーソルライブラリで実装しているので，カーソルライブラリで規定された範囲の機能は使えます。

注※3

この関数をサポートしていますが，DBMS又はサーバプログラムがサポートしていないときは，常に0が返ります。

注※4

この関数をサポートしていますが，サーバ側でサポートしていません。関数は使えますが，常にNO_DATA_FOUNDが返ります。

注※5

この関数をサポートしていますが，DBMSがサポートしていないときは，常にNO_DATA_FOUNDが返ります。

注※6

fColTypeがSQL_BEST_ROWIDに対してだけ情報を返します。

注※7

この関数をサポートしていますが，該当するDBMSでサポートしていないのでエラーリターンします（SQL STATE：S1C00）。

注※8

外部プロシジャだけをサポートしています。

5.3　ODBCとデータベースとのデータ型の対応

ODBCとデータベースとのデータ型の対応を，DBPARTNER2 Clientのドライバ別に説明します。ODBCのデータ型とは，ODBC関数のアーギュメントに指定するSQLデータ型のことです。

5.3.1　DABrokerドライバの場合のODBCとデータベースとのデータ型の対応

(1)　ODBCとデータベースとのデータ型の対応

DABrokerドライバ（DBPARTNER/Serverドライバ）の場合の，ODBCとデータベースとのデータ型の対応について表5-3〜表5-11に示します。

表5-3〜表5-11で使用している略号，及び凡例の意味は次のとおりです。また，表の中で※印で示している注意事項については，この項の末尾にまとめて記述しています。

（略号）

HiR：HiRDBのことです。

ORA：ORACLEのことです。

SQL：SQL Serverのことです。

Adap：Adaptive Server Anywhereのことです。

RDB1：RDB1 E2のことです。

RDB編成：RDB編成ファイルのことです。

RD：XDM/RD E2のことです。

SD：XDM/SD E2のことです。

PDM：PDMII E2のことです。

KSP：VOSKスプールファイルのことです。

RDA（経由）：RDA Link for Gatewayのことです。

DBS（経由，直結）：Database Connection Serverのことです。

（凡例）

−：ODBCにはないデータ型を示します。

○：データ型を使えます。

●：データベースに該当するデータ型がありません。

×：ODBCドライバに該当するデータ型がないので使えません。

(a)　文字データ型の対応と各データベースでの使用可否

ODBCとデータベースとの文字データ型の対応を表5-3に，各データベースでの文字データ型の使用可否を表5-4と表5-5に示します。

表5-4/表5-5で使用可否を示す文字データ型については，表5-3を参照してください。表5-3と表5-4/表5-5は，項番で対応しています。

表5‒3　ODBCとデータベースのデータ型の対応（文字データ）

項番

ODBCのデータ型

データベースのデータ型

説明

1

SQL_CHAR

CHAR(n)，ROWID

固定長文字列

2

SQL_VARCHAR

VARCHAR(n)

可変長文字列

3

SQL_LONGVARCHAR

LONG VARCHAR(n)，VARCHAR2，LONG※1

可変長長文字列

4

−※2

NCHAR(n)，NATIONAL CHARACTER

固定長各国文字列

5

−※2

NVARCHAR(n)

可変長各国文字列

6

−※2

LONG NVARCHAR(n)

可変長長各国文字列

7

−※2

MCHAR(n)

固定長混在文字列

8

−※2

MVARCHAR(n)

可変長混在文字列

9

−※2

LONG MVARCHAR(n)

可変長長混在文字列

表5‒4　各データベースでの文字データ型の使用可否（DABroker経由）

項番

DABroker経由

DABroker直結

RDA経由

DBS経由

HiR

ORA

SQL

Adap

RD

RDB1

RDB編成

RD

SD※7

RDB編成

PDM

※8

RDB1

KSP

※5

1

○

○

○

●

○

○

○

○

○

○

○

○

●

2

○

○

○

○

○

○

●

○

●

●

●

○

●

3

●

○

○

○

○

○

●

○

●

●

●

○

●

4

○

●

●

●

○

○

○

○

○

○

○

○

●

5

○

●

●

●

○

○

●

○

●

●

●

○

●

6

●

●

●

●

○

●

●

○

●

●

●

●

●

7

○

●

●

●

○

●

○

○

●

○

●

●

○

8

○

●

●

●

○

●

●

○

●

●

●

●

●

9

●

●

●

●

○

●

●

○

●

●

●

●

●

表5‒5　各データベースでの文字データ型の使用可否（DBS直結）

項番

DBS直結

RD

SD※7

RDB編成

PDM

※8

RDB1

KSP

※5

1

○

○

○

○

○

●

2

○

●

●

●

○

●

3

○

●

●

●

○

●

4

○

○

○

○

○

●

5

○

●

●

●

○

●

6

○

●

●

●

●

●

7

○

●

○

●

●

○

8

○

●

●

●

●

●

9

○

●

●

●

●

●

(b)　数データ型の対応と各データベースでの使用可否

ODBCとデータベースとの数データ型の対応を表5-6に，各データベースでの数データ型の使用可否を表5-7と表5-8に示します。

表5-7/表5-8で使用可否を示す数データ型については，表5-6を参照してください。表5-6と表5-7/表5-8は，項番で対応しています。

表5‒6　ODBCとデータベースのデータ型の対応（数データ）

項番

ODBCのデータ型

データベースのデータ型

説明

1

SQL_DECIMAL

DEC［IMAL］（p,s）※6

固定小数点数

2

SQL_NUMERIC

NUMERIC，NUMBER（p,s）※6

精度1≦p≦15，0≦s≦p

3

LARGE DEC［IMAL］（p,s）※6

拡張精度固定小数点数

1≦p≦29，0≦s≦p

4

SQL_DECIMAL

PACKED DECIMAL FIXED WITH NO SIGN

符号なしPACK形式

5

−※4

WZONE

符号なしZONE形式

6

SQL_DECIMAL

UNPACKED DECIMAL FIXED

WITH NO SIGN

符号なしZONE形式

7

SQL_SMALLINT

SMALLINT

値の範囲が-32,768〜32,767の整数

8

SQL_INTEGER

INTEGER

値の範囲が-2,147,483,648〜

2,147,483,647の整数

9

SQL_TINYINT

TINYINT

-256〜255の整数

10

SQL_BIGINT

BIGINT

1けたの符号と19けたの整数

11

SQL_REAL

SMALLFLT，REAL

単精度浮動小数点数

12

SQL_FLOAT

FLOAT，DOUBLE PRECISION

倍精度浮動小数点数

13

SQL_DOUBLE

DOUBLE

倍精度浮動小数点数

14

SQL_BIT

BIT

ビット

15

SQL_BINARY

BINARY

固定長バイナリデータ

16

SQL_VARBINARY

VARBINARY，RAW

可変長バイナリデータ

17

SQL_LONGVARBINARY

LONG VARBINARY，LONG RAW※1

可変長バイナリデータ

表5‒7　DABrokerドライバ経由での数データの使用可否（DABroker経由）

項番

DABroker経由

DABroker直結

RDA経由

DBS経由

HiR

ORA

SQL

Adap

RD

RDB1

RDB編成

RD

SD※7

RDB編成

PDM

※8

RDB1

KSP

※5

1

●

●

○

○

○

○

○

○

○

○

○

○

●

2

●

○

○

○

●

●

○

●

●

○

●

●

●

3

○

●

●

●

○

●

●

○

●

●

●

●

●

4

●

●

●

●

●

●

●

●

○

●

●

●

●

5

●

●

●

●

●

●

●

●

●

●

●

●

●

6

●

●

●

●

●

●

●

●

○

●

●

●

●

7

○

●

○

○

○

○

○

○

○

○

○

○

●

8

○

●

○

○

○

○

○

○

○

○

○

○

●

9

●

●

○

○

●

●

●

●

●

●

●

●

●

10

●

●

●

○

●

●

●

●

●

●

●

●

●

11

○

●

○

○

○

○

●

○

●

●

●

○

●

12

○

○

○

○

○

○

●

○

●

●

●

○

●

13

●

●

○

○

●

●

●

●

●

●

●

●

●

14

●

●

○

○

●

●

●

●

●

●

●

●

●

15

●

●

○

○

●

●

○

●

○

○

○

●

●

16

●

○

○

●

●

●

●

●

●

●

●

●

●

17

●

○

○

○

●

●

●

○

●

●

●

●

●

表5‒8　DABrokerドライバ経由での数データの使用可否（DBS直結）

項番

DBS直結

RD

SD※7

RDB編成

PDM

※8

RDB1

KSP

※5

1

○

○

○

○

○

●

2

●

●

○

●

●

●

3

○

●

●

●

●

●

4

●

○

●

●

●

●

5

●

●

●

●

●

●

6

●

○

●

●

●

●

7

○

○

○

○

○

●

8

○

○

○

○

○

●

9

●

●

●

●

●

●

10

●

●

●

●

●

●

11

○

●

●

●

○

●

12

○

●

●

●

○

●

13

●

●

●

●

●

●

14

●

●

●

●

●

●

15

●

○

○

○

●

●

16

●

●

●

●

●

●

17

○

●

●

●

●

●

(c)　日付時刻データ型の対応と各データベースでの使用可否

ODBCとデータベースとの日付時刻データ型の対応を表5-9に，各データベースでの日付時刻データ型の使用可否を表5-10と表5-11に示します。

表5-10/表5-11で使用可否を示す日付時刻データ型については，表5-9を参照してください。表5-9と表5-10/表5-11は，項番で対応しています。

表5‒9　ODBCとデータベースのデータ型の対応（日付時刻データ）

項番

ODBCのデータ型

データベースのデータ型

説明

1

SQL_DATE

DATE

日付

2

SQL_TIMESTAMP

DATE

固定長日付/時刻値

3

SQL_TIME

TIME

時刻

4

−※2

INTERVAL YEAR TO DAY

日間隔

5

−※2

INTERVAL HOUR TO SECOND

時間隔

表5‒10　DABrokerドライバ経由での日付時刻データの使用可否（DABroker経由）

項番

DABroker経由

DABroker直結

RDA経由

DBS経由

HiR

ORA

SQL

Adap

RD

RDB1

RDB編成

RD

SD

※7

RDB編成

PDM

※8

RDB1

※5

KSP

※5

1

○

●

●

○

○※3

●

●

○※3

●

●

●

●

●

2

●

○

○

○

●

●

●

●

●

●

●

●

●

3

○

●

●

○

×

●

●

○

●

●

●

●

●

4

×

×

●

●

×

●

●

×

●

●

●

●

●

5

×

×

●

●

×

●

●

×

●

●

●

●

●

表5‒11　DABrokerドライバ経由での日付時刻データの使用可否（DBS直結）

項番

DBS直結

RD

SD※7

RDB編成

PDM

※8

RDB1

※5

KSP

※5

1

○※3

●

●

●

●

●

2

●

●

●

●

●

●

3

○

●

●

●

●

●

4

×

●

●

●

●

●

5

×

●

●

●

●

●

注

データ型の最大文字列長と値の範囲は，各データベースで異なります。各データベースのマニュアルを参照してください。

注※1

データの最大長は，DABroker動作環境定義ファイルのDABORADBA_LONGBUFSIZEで指定した値です。

注※2

「DBPARTNER2 ClientとDABrokerドライバ」を使っているときは，データベースのデータ型がそのまま通知されます。それ以外のときは，アプリケーションに固定長文字列（CHAR）として通知されます。

注※3

XDM/RD E2　01-02以降を使っているときに対応します。

注※4

「DBPARTNER2 ClientとDABrokerドライバ」を使っているときは，データベースのデータ型がそのまま通知されます。それ以外のときは，アプリケーションに固定小数点数（SQL_NUMERIC）として通知されます。

注※5

バージョンが01-02以降のDatabase Connection Server，又はバージョンが02-04以降のDABrokerを使っているときに対応します。

注※6

「(p,s)」の「p」は全体のけた数，「s」は小数点以下のけた数を示します。

注※7

バージョンが02-00以降のDatabase Connection Server，又はバージョンが02-01以降のDABrokerを使っているときに対応します。

注※8

Database Connection Server，又はバージョンが02-04以降のDABrokerを使っているときに対応します。

(2)　データベースのデータ型とSQLデータ型の対応

データベースのデータ型に対するSQLデータ型の対応を次に示します。

(a)　SQL Serverの場合

SQL Serverのデータ型に対するSQLデータ型の対応を表5-12に示します。

表5‒12　SQL Serverのデータ型とSQLデータ型の対応

データベースのデータ型

SQLデータ型

bit

SQL_BIT

tinyint

SQL_TINYINT

smallint

SQL_SMALLINT

int

SQL_INTEGER

binary

SQL_BINARY

timestamp

SQL_BINARY

varbinary

SQL_VARBINARY

image

SQL_LONGVARBINARY

char

SQL_CHAR

varchar

SQL_VARCHAR

sysname

SQL_VARCHAR

text

SQL_LONGVARCHAR

decimal

SQL_DECIMAL

money

SQL_DECIMAL

smallmoney

SQL_DECIMAL

numeric

SQL_NUMERIC

real

SQL_REAL

float

SQL_FLOAT又はSQL_DOUBLE

datetime

SQL_TIMESTAMP

smalldatetime

SQL_TIMESTAMP

(b)　Adaptive Server Anywhereの場合

Adaptive Server Anywhereのデータ型に対するSQLデータ型の対応を表5-13に示します。

表5‒13　Adaptive Server Anywhereのデータ型とSQLデータ型の対応

データベースのデータ型

SQLデータ型

bit

SQL_BIT

tinyint

SQL_TINYINT

oldbit

SQL_TINYINT

smallint

SQL_SMALLINT

integer

SQL_INTEGER

bigint

SQL_BIGINT

binary

SQL_BINARY

varbinary

SQL_BINARY

java serialization

SQL_LONGVARBINARY

java.lang.Object

SQL_LONGVARBINARY

long binary

SQL_LONGVARBINARY

image

SQL_LONGVARBINARY

char

SQL_VARCHAR

varchar

SQL_VARCHAR

sysname

SQL_VARCHAR

long varchar

SQL_LONGVARCHAR

text

SQL_LONGVARCHAR

decimal

SQL_DECIMAL

numeric

SQL_NUMERIC

money

SQL_NUMERIC

smallmoney

SQL_NUMERIC

float

SQL_REAL

double

SQL_DOUBLE

date

SQL_DATE

time

SQL_TIME

timestamp

SQL_TIMESTAMP

datetime

SQL_TIMESTAMP

smalldatetime

SQL_TIMESTAMP

(c)　XDM/SD E2の場合

XDM/SD E2のデータ型に対するSQLデータ型の対応を表5-14に示します。

表5‒14　XDM/SD E2のデータ型とSQLデータ型の対応

データベースのデータ型

SQLデータ型

CHARACTER

SQL_CHAR

NCHARACTER

SQL_CHAR

COMP（2バイト）

SQL_SMALLINT

COMP（4バイト）

SQL_INTEGER

PACKED DECIMAL FIXED

SQL_DECIMAL

UNPACKED DECIMAL FIXED

SQL_DECIMAL

PACKED DECIMAL FIXED WITH NO SIGN

SQL_DECIMAL

UNPACKED DECIMAL FIXED WITH NO SIGN

SQL_DECIMAL

BIT

SQL_BINARY

データベースキー

SQL_BINARY

(d)　RDB編成ファイル（DBS接続）の場合

RDB編成ファイル（DBS接続）のデータ型に対するSQLデータ型の対応を表5-15に示します。

表5‒15　RDB編成ファイル（DBS接続）のデータ型とSQLデータ型の対応

データベースのデータ型

SQLデータ型

CHAR

SQL_CHAR

PACK

SQL_DECIMAL

ZONE

SQL_NUMERIC

WZONE

SQL_NUMERIC

BINARY（2バイト）

SQL_SMALLINT

BINARY（4バイト）

SQL_INTEGER

HEX

SQL_BINARY

NCHAR

SQL_CHAR

MCHAR

SQL_CHAR

BIT

SQL_BINARY

(e)　PDMII E2の場合

PDMII E2のデータ型に対するSQLデータ型の対応を表5-16に示します。

表5‒16　PDMII E2のデータ型とSQLデータ型の対応

データベースのデータ型

SQLデータ型

CHARACTER

SQL_CHAR

NCHARACTER

SQL_CHAR

COMP（2バイト）

SQL_SMALLINT

COMP（4バイト）

SQL_INTEGER

PACKED DECIMAL FIXED

SQL_DECIMAL

UNPACKED DECIMAL FIXED

SQL_DECIMAL

DBK（データベースキー）

SQL_BINARY

(f)　RDB1 E2の場合

RDB1 E2のデータ型に対するSQLデータ型の対応を表5-17に示します。

表5‒17　RDB1 E2のデータ型とSQLデータ型の対応

データベースのデータ型

SQLデータ型

CHAR

SQL_CHAR

VARCHAR

SQL_VARCHAR

LONG VARCHAR

SQL_LONGVARCHAR

NCHAR

SQL_CHAR

NVARCHAR

SQL_VARCHAR

INTEGER

SQL_INTEGER

SMALLINT

SQL_SMALLINT

DECIMAL

SQL_DECIMAL

FLOAT

SQL_FLOAT

SMALLFLT

SQL_REAL

(g)　VOSKスプールファイルの場合

VOSKスプールファイルのデータ型に対するSQLデータ型の対応を表5-18に示します。

表5‒18　VOSKスプールファイルのデータ型とSQLデータ型の対応

データベースのデータ型

SQLデータ型

MCHAR

SQL_CHAR

(3)　データベースと接続するときのSQLGetInfoの戻り値

次のデータベースと接続するときのSQLGetInfoの戻り値を表5-19に示します。

SQL Server

Adaptive Server Anywhere

XDM/SD E2

PDMII E2

RDB1 E2

VOSKスプールファイル

表5‒19　データベースと接続するときのSQLGetInfoの戻り値

FinfoType

SQL Server

Adaptive Server Anywhere

XDM/SD E2

PDMII E2

RDB1 E2

VOSKスプールファイル

SQL_ACCESSIBLE_PROCEDURES

NO

NO

NO

NO

NO

NO

SQL_ACCESSIBLE_

TABLES

YES

NO

YES

YES

YES

YES

SQL_ACTIVE_

CONNECTIONS

0

0

0

0

0

0

SQL_ACTIVE_

STATEMENTS

10（01-03以降では64）

1

128

DBS経由：128

DABroker経由：64

128

SQL_ALTER_TABLE

ADD

DROP

0

0

ADD［0］※

0

SQL_BOOKMARK_

PERSISTENCE

0

0

0

0

0

0

SQL_COLUMN_ALIAS

NO

NO

NO

NO

NO

NO

SQL_CONCAT_NULL_

BEHAVIOR

NULLでない値

SQL_CONVERT_

FUNCTIONS

0

0

0

0

0

0

SQL_CONVERT_Type

0

0

0

0

0

0

SQL_CORRELATION_

NAME

ANY

ANY

NONE

NONE

DIFFERENT

NONE

SQL_CURSOR_COMMIT_BEHAVIOR

カーソルのCLOSE

DELETE

CLOSE

CLOSE

DELETE

SQL_CURSOR_

ROLLBACK_BEHAVIOR

カーソルのCLOSE

DELETE

CLOSE

CLOSE

DELETE

SQL_DATA_SOURCE_

NAME

Connect時に設定

SQL_DATA_SOURCE_

READ_ONLY

NO

NO

NO

NO

NO

YES

SQL_DATABASE_NAME

NULL（データ長は0）

SQL_DBMS_NAME

接続したサーバの名称

SQL_DBMS_VER

接続したサーバのバージョン

SQL_DEFAULT_TXN_

ISOLATION

すべてのトランザクションで変更が認識されます。

（SQL_TXN_READ_UNCOMMITTED）

SQL_DRIVER_NAME

DBPSVD32.dll

SQL_DRIVER_ODBC_VER

02.50

SQL_DRIVER_VER

ドライバのバージョン

SQL_EXPRESSIONS_IN_ORDERBY

YES

YES

NO

NO

YES

NO

SQL_FETCH_DIRECTION

NEXT

SQL_FILE_USAGE

NOT SUPPORT

SQL_GETDATA_

EXTENSIONS

ANY COLUMN

SQL_GROUP_BY

CONTAINS_SELECT

NO_RELATION

NOT_SUPPORTED

NOT_SUPPORTED

EQUALS_SELECT

NOT_SUPPORTED

SQL_IDENTIFIER_CASE

大小文字混在

SENSITIVE

UPPER

SENSITIVE

SQL_IDENTIFIER_

QUOTE_CHAR

"（ダブルクォーテーション）

SQL_KEYWORDS

NULL（データ長は0）

SQL_LIKE_ESCAPE_

CLAUSE

YES

YES

NO

NO

YES

NO

SQL_LOCK_TYPES

0

0

0

0

0

0

SQL_MAX_BINARY_

LITERAL_LEN

0

0

0

0

0

0

SQL_MAX_CHAR_

LITERAL_LEN

0

0

0

0

0

0

SQL_MAX_COLUMN_

NAME_LEN

30

128

30

18

18

4

SQL_MAX_COLUMNS_

IN_GROUP_BY

16

0

0

0

16

0

SQL_MAX_COLUMNS_

IN_INDEX

16

0

0

0

8

0

SQL_MAX_COLUMNS_

IN_ORDER_BY

16

0

0

0

16

0

SQL_MAX_COLUMNS_

IN_SELECT

4000

0

0

0

255

0

SQL_MAX_COLUMNS_

IN_TABLE

250

0

0

0

255

511

SQL_MAX_CURSOR_

NAME_LEN

30

128

30

0

18

0

SQL_MAX_QUALIFIER_

NAME_LEN

30

0

0

0

0

0

SQL_MAX_INDEX_SIZE

900

0

0

0

254

0

SQL_MAX_OWNER_

NAME_LEN

30

128

7

8

8

8

SQL_MAX_PROCEDURE_NAME_LEN

36

128

0

0

0

0

SQL_MAX_ROW_SIZE

1962

2147483647

32000

32000

4056

32767

SQL_MAX_ROW_SIZE_

INCLUDES_LONG

NO

YES

YES

NO

NO

NO

SQL_MAX_STATEMENT_LEN

0

0

30000

30000

16384

8000

SQL_MAX_TABLE_

NAME_LEN

30

128

30

8

18

17

SQL_MAX_TABLES_IN_

SELECT

16

0

1

1

15

1

SQL_MAX_USER_NAME_LEN

30

128

7

8

8

8

SQL_MULT_RESULT_

SETS

NO

NO

NO

NO

NO

NO

SQL_MULTIPLE_ACTIVE_TXN

YES

YES

YES

YES

YES

YES

SQL_NEED_LONG_DATA_LEN

YES

NO

NO

NO

NO

NO

SQL_NON_NULLABLE_

COLUMNS

NULLでない値

SQL_NULL_COLLATION

LOW

START

LOW

0

LOW

0

SQL_NUMERIC_

FUNCTIONS

0

0

0

0

0

0

SQL_ODBC_API_

CONFORMANCE

Level1

SQL_ODBC_SAG_CLI_

CONFORMANCE

NOT SAG-compliant

SQL_ODBC_SQL_

CONFORMANCE

Core

SQL_ODBC_SQL_OPT_IEF

NO

NO

NO

NO

NO

NO

SQL_ORDER_BY_

COLUMNS_IN_SELECT

NO

NO

NO

NO

YES

NO

SQL_OUTER_JOINS

YES

FULL

NO

NO

NO

NO

SQL_OWNER_TERM

所有者

Creator

owner

owner

owner

owner

SQL_OWNER_USAGE

DML，TABLE，INDEX，PRIVILEGE

DML

DML

DML，TABLE，INDEX，PRIVILEGE［DML］※

DML

SQL_POS_OPERATIONS

0

0

0

0

0

0

SQL_POSITIONED_

STATEMENTS

0

0

0

0

0

0

SQL_QUALIFIER_NAME_SEPARATOR

Period

NULL

Period

Period

Period

Period

SQL_QUALIFIER_TERM

データベース

NULL

database

database

database

database

SQL_PROCEDURE_TERM

NULL

NULL

NULL

NULL

NULL

NULL

SQL_PROCEDURES

NO

NO

NO

NO

NO

NO

SQL_QUALIFIER_

LOCATION

START

0

0

0

0

0

SQL_QUALIFIER_USAGE

DML,TABLE

0

DML

0

DML

0

SQL_QUOTED_

IDENTIFIER_CASE

SENSITIVE

UPPER

UPPER

SENSITIVE

UPPER

SENSITIVE

SQL_ROW_UPDATES

NO

NO

NO

NO

NO

NO

SQL_SCROLL_

CONCURRENCY

Read Only

Read Only

Read Only

Read Only

Read Only

Read Only

SQL_SCROLL_OPTIONS

Forward Only

Forward Only

Forward Only

Forward Only

Forward Only

Forward Only

SQL_SEARCH_PATTERN_ESCAPE

'¥'

'~'

NULL

'¥'

'¥'

'¥'

SQL_SERVER_NAME

DABroker，又はDBS

SQL_SPECIAL_CHARACTERS

NULL

"@$#"

NULL

NULL

NULL

NULL

SQL_STATIC_SENSITIVITY

0

0

0

0

0

0

SQL_STRING_FUNCTIONS

0

0

CONCAT，TRIM

0

0

0

SQL_SUBQUERIES

0

0

0

0

0

0

SQL_SYSTEM_FUNCTIONS

0

0

0

0

0

0

SQL_TIMEDATE_ADD_

INTERVALS

0

0

0

0

0

0

SQL_TIMEDATE_DIFF_

INTERVALS

0

0

0

0

0

0

SQL_TABLE_TERM

テーブル

Table

Table

table

Table

table

SQL_TIMEDATE_

FUNCTIONS

0

0

0

0

0

0

SQL_TXN_CAPABLE

ALL

DDL_

COMMIT

DML

DML

DML

DML

SQL_TXN_ISOLATION_

OPTIONS

未サポート

SQL_UNION

ALL

ALL

0

0

0

0

SQL_USER_NAME

ログインユーザID

注※

Database Connection Server経由，DABroker経由Database Connection Server又はDABroker経由RDA Link for Gatewayの場合。［］内の値はDABroker経由RDA Link for Gatewayの場合。

5.4　ODBC関数の規則

ODBC関数を使ったアプリケーションからサーバ上のデータベースにアクセスするときは，データベースによって使える機能が異なります。ODBC関数の規則について，ドライバ別に説明します。

5.4.1　DABrokerドライバの場合に，各データベースで使える機能

DABrokerドライバ（DBPARTNER/Serverドライバ）の場合に，各データベースで使える機能を表5-20〜表5-22に示します。

表5-20〜表5-22で使用している略号，及び凡例の意味は次のとおりです。また，表の中で※印で示している注意事項については，この項の末尾にまとめて記述しています。

（略号）

HiR：HiRDBのことです。

ORA：ORACLEのことです。

SQL：SQL Serverのことです。

Adap：Adaptive Server Anywhereのことです。

RDB1：RDB1 E2のことです。

RDB編成：RDB編成ファイルのことです。

RD：XDM/RD E2のことです。

SD：XDM/SD E2のことです。

PDM：PDMII E2のことです。

KSP：VOSKスプールファイルのことです。

RDA（経由）：RDA Link for Gatewayのことです。

DBS（経由，直結）：Database Connection Serverのことです。

（凡例）

○：データベースで使えます。

×：データベースで使えません。

−：データベースに機能がありません。

表5‒20　データベースで使える機能（1）

機能

HiR

ORA

SQL

Adap

RDA経由

RD

RDB1

RDB編成

スペシャルカラム情報の取得

−

○

−

−

−

−

−

インデクス情報の取得

○

○

○

○

○

○

○

日付，時刻データ型の使用

○※1

○※2

○

○

○※3

−

−

繰り返し列の使用

×

−

−

−

×

×

×

配列列の使用

×

−

−

−

×

−

×

表ヘッダ，列ヘッダの取得※4

−

−

−

−

○

×

○

非同期処理

○

○

○

○

○

○

○

LIKEのエスケープ文字の使用

×

×

×

×

×

×

×

更新行数の取得

○

○

○

○

○

○

○

LOGINタイムアウト時間設定

×

×

×

×

×

×

×

日本語データ型の使用

○※5

−

−

−

○※5

○※5

○※5

定義系SQLの実行

○

○

○

○

○※6

×

×

外部結合エスケープ処理

○

○

○

○

○※7

−

−

表5‒21　データベースで使える機能（2）

機能

DABroker経由

RD

SD

RDB編成

PDM

RDB1

KSP

スペシャルカラム情報の取得

−

○

○

○

○

−

インデクス情報の取得

○

○

○

−

○

−

日付，時刻データの使用

○※3

−

−

−

−

−

繰り返し列の使用

○

○

○

−

○

−

配列列の使用

○

○

×

−

−

−

表ヘッダ，列ヘッダの取得※4

○

○

○

○

○

○

非同期処理

○

○

○

○

○

○

LIKEエスケープ文字の使用

×

−

×

−

×

−

更新行数の取得

○

○

○

○

○

○

LOGINタイムアウト時間設定

×

×

×

×

×

×

日本語データ型の使用※5

○

○

○

○

○

○

定義系SQLの実行

○※6

×

×

×

○

×

外部結合エスケープ処理

○※7

−

−

−

−

−

表5‒22　データベースで使える機能（3）

機能

DBS直結

RD

SD

RDB編成

PDM

RDB1

KSP

スペシャルカラム情報の取得

−

○

○

○

○

−

インデクス情報の取得

○

○

○

−

○

−

日付，時刻データの使用

○※3

−

−

−

−

−

繰り返し列の使用

○

○

○

−

○

−

配列列の使用

○

○

×

−

−

−

表ヘッダ，列ヘッダの取得※4

○

○

○

○

○

○

非同期処理

○

○

○

○

○

○

LIKEエスケープ文字の使用

×

−

×

−

×

−

更新行数の取得

○

○

○

○

○

○

LOGINタイムアウト時間設定

×

×

×

×

×

×

日本語データ型の使用※5

○

○

○

○

○

○

定義系SQLの実行

○※6

×

×

×

○

×

外部結合エスケープ処理

○※7

−

−

−

−

−

注※1

INTERVAL YEAR TO DAYとINTERVAL HOUR TO SECONDは使えません。

注※2

TIMESTAMPは使えます。

注※3

XDM/RD E2　01-02以降の場合，日付データ型は使えます。時刻データ型は使えません。

注※4

XDM/RD E2の場合は，取得するかしないかを接続先定義ファイルのパラメタで指定します。XDM/RD E2以外の場合は，アプリケーションにはNULLを返します。

注※5

「DBPARTNER2 ClientとDBPARTNER/Serverドライバ」を使っているときは，データベースのデータ型がそのまま通知されます。それ以外のときは，アプリケーションに固定長文字列（CHAR），可変長文字列（VARCHAR），可変長長文字列（LONG VARCHAR）として通知されます。

注※6

定義系SQLのうち，CREATE TABLEを実行できます。

注※7

XDM/RD E2　02-00以降の場合だけ使えます。

5.4.2　各ODBC関数での繰り返し列と配列列の扱い

次に示すODBC関数での繰り返し列と配列列の扱いについて説明します。

SQLColumns関数

SQLColumnPrivileges関数

SQLStatistics関数

SQLDescribeCol関数

SQLDescribeParam関数

なお，SQLColumns関数，SQLColumnPrivileges関数，SQLDescribeCol関数，及びSQLDescribeParam関数では，繰り返し列と配列列の扱いが同じです。

(1)　SQLColumns関数などでの繰り返し列と配列列の扱い

列の一覧情報を扱うSQLColumns関数や，列権限一覧情報を扱うSQLColumnPrivileges関数では，繰り返し列と配列列のそれぞれの要素を一つの列として扱います。同様に，SQLDescribeCol関数とSQLDescribeParam関数でも，繰り返し列と配列列のそれぞれの要素を一つの列として扱います。

これらの関数では，要素の数だけ列名が返されます。このとき，列名は次に示す形式で返されます。

列名(n)：「n」は要素数を示します。

例えば，列名が「C1」で，配列要素数が「3」の繰り返し列（又は配列列）の列情報をSQLColumns関数で取得する場合，列名は，「C1(1)」，「C1(2)」，「C1(3)」の形式で返されます。

(2)　SQLStatistics関数での繰り返し列と配列列の扱い

列のインデクス一覧情報を扱うSQLStatistics関数では，同じ列名の繰り返し列全体（又は同じ列名の配列列全体）を一つの列として扱います。したがって，要素が複数ある場合でも，要素が特定されないで列名だけが返されます。

列名が「D1」で，配列要素数が「5」の繰り返し列（又は配列列）のインデクス一覧情報をSQLStatistics関数で取得する場合，列名は「D1」で返されます。

5.5　DBPARTNER ODBC Driverで取得できるODBC関数のオプション値

DBPARTNER ODBC Driverで取得できるODBC関数のオプション値について説明します。オプション値を取得できるODBC関数を次に示します。

SQLSetConnectOption関数，SQLSetStmtOption関数

SQLGetConnectOption関数，SQLGetStmtOption関数

5.5.1　DABrokerドライバで取得できるODBC関数のオプション値

DABrokerドライバ（DBPARTNER/Serverドライバ）で取得できるODBC関数のオプション値について説明します。

(1)　SQLSetConnectOption関数，SQLSetStmtOption関数

SQLSetConnectOption関数で取得できるオプション値とサポート状況を表5-23に，SQLSetStmtOption関数で取得できるオプション値とサポート状況を表5-24に示します。表の備考は，ODBC関数がサポートされたODBCのバージョンを示します。

表5‒23　SQLSetConnectOption関数で取得できるオプション値とサポート状況

fOption

値

vParam

値

サポート状況

指定時の処置

備考

SQL_ACCESS_MODE

101

SQL_MODE_READ_WRITE

0UL

○

正常処理

ODBC 1.0

SQL_MODE_READ_ONLY

1UL

○

正常処理

SQL_AUTOCOMMIT

102

SQL_AUTOCOMMIT_ON

1UL

○

正常処理

ODBC 1.0

SQL_AUTOCOMMIT_OFF

0UL

○

正常処理

SQL_CURRENT_QUALIFIER

109

データソースが使う修飾語名も含むNULL終端文字列

−

×

S1C00エラー

ODBC 2.0

SQL_LOGIN_TIMEOUT

103

秒数に対応する32ビット整数値

−

×

S1C00エラー

ODBC 1.0

SQL_ODBC_CURSORS

110

SQL_CUR_USE_DRIVER

2UL

×

S1C00エラー

ODBC 2.0

SQL_CUR_USE_ODBC

1UL

×

S1C00エラー

SQL_CUR_USE_IF_NEEDED

0UL

×

S1C00エラー

SQL_OPT_TRACE

104

SQL_OPT_TRACE_OFF

0UL

○

正常処理

ODBC 1.0

SQL_OPT_TRACE_ON

1UL

×

S1009エラー

SQL_OPT_TRACEFILE

105

トレースファイル名を含むNULLで終端文字列

−

○

正常処理

ODBC 1.0

SQL_PACKET_SIZE

112

バイト単位のネットワークパケットサイズを示す32ビット整数値

−

×

S1C00エラー

ODBC 2.0

SQL_QUIET_MODE

111

32ビットウィンドウハンドル（hwnd）

−

×

S1C00エラー

ODBC 2.0

SQL_TRANSLATE_DLL

106

DLL名を含むNULL終端文字列

−

×

S1C00エラー

ODBC 1.0

SQL_TRANSLATE_OPTION

107

変換DLLに渡される32ビットのフラグの値

−

×

S1C00エラー

ODBC 1.0

SQL_TXN_ISOLATION

108

現在のhdbcに関するトランザクション分離レベルを設定する32ビットのビットマスク

−

○

正常処理

ODBC 1.0

（凡例）

○：DABrokerドライバで使えるODBC関数です。

×：DABrokerドライバで使えないODBC関数です。

表5‒24　SQLSetStmtOption関数で取得できるオプション値とサポート状況

fOption

値

vParam

値

サポート状況

指定時の処置

備考

SQL_ASYNC_ENABLE

4

SQL_ASYNC_ENABLE_OFF

0UL

○

正常処理

ODBC 1.0

SQL_ASYNC_ENABLE_ON

1UL

○

正常処理

SQL_BIND_TYPE

5

バインド方向を設定する32ビット整数値

−

×

S1C00エラー

ODBC 1.0

SQL_CONCURRENCY

7

SQL_CONCUR_READ_ONLY

1

×

S1C00エラー

ODBC 2.0

SQL_CONCUR_LOCK

2

×

S1C00エラー

SQL_CONCUR_ROWVER

3

×

S1C00エラー

SQL_CONCUR_VALUES

4

×

S1C00エラー

SQL_CURSOR_TYPE

6

SQL_CURSOR_FORWARD_ONLY

0UL

×

S1C00エラー

ODBC 2.0

SQL_CURSOR_STATIC

3UL

×

S1C00エラー

SQL_CURSOR_KEYSET_DRIVEN

1UL

×

S1C00エラー

SQL_CURSOR_DYNAMIC

2UL

×

S1C00エラー

SQL_KEYSET_SIZE

8

キーセット駆動カーソルに対するキーセットの行数を指定する32ビット整数値

−

×

S1C00エラー

ODBC 2.0

SQL_MAX_LENGTH

3

ドライバが文字又はバイナリ列から返すデータの最大量を指定する32ビット整数値

−

○

正常処理

ODBC 1.0

SQL_MAX_ROWS

1

アプリケーションに返すSELECTステートメントの最大行数に相当する32ビット整数値

−

○

正常処理

ODBC 1.0

SQL_NOSCAN

2

SQL_NOSCAN_OFF

0UL

○

正常処理

ODBC 1.0

SQL_NOSCAN_ON

1UL

○

正常処理

SQL_QUERY_TIMEOUT

0

SQLステートメントがアプリケーションに実行して戻るまでの待ち時間を示す秒数に相当する32ビット整数値

−

×

S1C00エラー

ODBC 1.0

SQL_RETRIEVE_DATA

11

SQL_RD_ON

1UL

×

S1C00エラー

ODBC 2.0

SQL_RD_OFF

0UL

×

S1C00エラー

SQL_ROWSET_SIZE

9

行セットの行数を指定する32ビット整数値

−

×

S1C00エラー

ODBC 2.0

SQL_SIMULATE_CURSOR

10

SQL_SC_NON_UNIQUE

0UL

×

S1C00エラー

ODBC 2.0

SQL_SC_TRY_UNIQUE

1UL

×

S1C00エラー

SQL_SC_UNIQUE

2UL

×

S1C00エラー

SQL_USE_BOOKMARKS

12

SQL_UB_OFF

0UL

×

S1C00エラー

ODBC 2.0

SQL_UB_ON

1UL

×

S1C00エラー

（凡例）

○：DABrokerドライバで使えるODBC関数です。

×：DABrokerドライバで使えないODBC関数です。

(2)　SQLGetConnectOption関数，SQLGetStmtOption関数

SQLGetConnectOption関数で取得できるオプション値とサポート状況を表5-25に，SQLGetStmtOption関数で取得できるオプション値とサポート状況を表5-26に示します。表の備考は，ODBC関数がサポートされたODBCのバージョンを示します。

表5‒25　SQLGetConnectOption関数で取得できるオプション値とサポート状況

fOption

値

サポート状況

指定時の処置

備考

SQL_ACCESS_MODE

101

○

正常処理

ODBC 1.0

SQL_AUTOCOMMIT

102

○

正常処理

ODBC 1.0

SQL_CURRENT_QUALIFIER

109

×

S1C00エラー

ODBC 2.0

SQL_LOGIN_TIMEOUT

103

×

S1C00エラー

ODBC 1.0

SQL_ODBC_CURSORS

110

×

S1C00エラー

ODBC 2.0

SQL_OPT_TRACE

104

○

正常処理

ODBC 1.0

SQL_OPT_TRACEFILE

105

○

正常処理

ODBC 1.0

SQL_PACKET_SIZE

112

×

S1C00エラー

ODBC 2.0

SQL_QUIET_MODE

111

×

S1C00エラー

ODBC 2.0

SQL_TRANSLATE_DLL

106

×

S1C00エラー

ODBC 1.0

SQL_TRANSLATE_OPTION

107

×

S1C00エラー

ODBC 1.0

SQL_TXN_ISOLATION

108

○

正常処理

ODBC 1.0

（凡例）

○：DABrokerドライバで使えるODBC関数です。

×：DABrokerドライバで使えないODBC関数です。

表5‒26　SQLGetStmtOption関数で取得できるオプション値とサポート状況

fOption

値

サポート状況

指定時の処置

備考

SQL_ASYNC_ENABLE

4

○

正常処理

ODBC 1.0

SQL_BIND_TYPE

5

×

S1C00エラー

ODBC 1.0

SQL_CONCURRENCY

7

×

S1C00エラー

ODBC 2.0

SQL_CURSOR_TYPE

6

×

S1C00エラー

ODBC 2.0

SQL_KEYSET_SIZE

8

×

S1C00エラー

ODBC 2.0

SQL_MAX_LENGTH

3

○

正常処理

ODBC 1.0

SQL_MAX_ROWS

1

○

正常処理

ODBC 1.0

SQL_NOSCAN

2

○

正常処理

ODBC 1.0

SQL_QUERY_TIMEOUT

0

×

S1C00エラー

ODBC 1.0

SQL_RETRIEVE_DATA

11

×

S1C00エラー

ODBC 2.0

SQL_ROWSET_SIZE

9

×

S1C00エラー

ODBC 2.0

SQL_SIMULATE_CURSOR

10

×

S1C00エラー

ODBC 2.0

SQL_USE_BOOKMARKS

12

×

S1C00エラー

ODBC 2.0

（凡例）

○：DABrokerドライバで使えるODBC関数です。

×：DABrokerドライバで使えないODBC関数です。

5.6　ODBC関数を実行したときのエラーメッセージ

DBPARTNER ODBC Driverから返されるエラーメッセージについて説明します。エラーメッセージについては，「10.2.2　DBPARTNER ODBC Driverのメッセージ」を参照してください。

5.6.1　エラーメッセージに付くODBC関数のプレフィックス

データソースのエラーのときは，DBPARTNER ODBC Driverはサーバから返ってきたエラーメッセージを表示します。

ODBCドライバが検出したエラーのときは，SQLSTATEに関連付けてあるテキストを表示します。

ODBC関数のエラーメッセージの形式を次に示します。

［vender］［ODBC-component］［data-source］error-message

［ ］内の値は，エラー元を識別できるように表示されます。

DBPARTNER ODBC Driverが返すプレフィックスの一覧を表5-27に示します。

表5‒27　DBPARTNER ODBC Driverが返すプレフィックスの一覧

ODBCドライバ

の種別

エラー元

プレフィックスに設定される値

［vender］

［ODBC-component］

［data-source］

DABroker

ドライバ

DABrokerドライバ

［HITACHI］

［DBPARTNER］

−

DABroker

［HITACHI］

［DBPARTNER］

［DABroker］

Database Connection Server

［HITACHI］

［DBPARTNER］

［DBS］

データベース ※

［HITACHI］

［DBPARTNER］

［HiRDB］又は

［ORACLE］

エラーになったサーバ側のプログラムが不明

［HITACHI］

［DBPARTNER］

［SERVER_UNKNOWN］

注※

DBPARTNER ODBC Driver for DABrokerを使ってRDA Link for Gateway経由又はVOS3 Database Connection Server経由でアクセスできるメインフレーム系データベースでのエラーのとき，及びDABrokerのODBC3.0経由で接続するMicrosoft SQL Server又はSybase Adaptive Server Anywhereでのエラーのときは，［data-source］にはデータベース固有の値でなく，各サーバプログラムの値（［DABroker］，［DBS］）が表示されます。

5.6.2　HiRDBのエラーメッセージの見方

ODBC関数を実行してfOptionに「SQL_SUCCESS_WITH_INFO」が返されて，メッセージに「［HITACHI］［DBPARTNER］［HiRDB］」が返されたときは，エラー要因は次の手順に従って見てください。

SQLErrorのpfNativeErrorに返される10進数のコードを2進数16けたに変換します。

変換した2進数は，HiRDBのSQL領域中の「SQL連結領域の内容」のSQLWARNO〜SQLWARNFに対応します。この内容を基に対処してください。

SQL連絡領域のSQLWARNO〜SQLWARNFの内容については，マニュアル「HiRDB　SQLリファレンス」を参照してください。

5.7　ODBC関数の非同期実行

ODBC関数を実行するときは，通常ODBCドライバはODBC関数を同期実行します。このときODBCドライバは，関数の呼び出しが終了するまで，制御をアプリケーションに返しません。

アプリケーションの処理の効率を上げるため，一部のODBC関数は，処理の終了を待たないでアプリケーションに制御を戻せます。このようなODBC関数の実行方法を非同期実行といいます。

ODBCの規約で非同期実行できる関数とDBPARTNER ODBC Driverで非同期実行できるかどうかを表5-28に示します。

表5‒28　ODBCの規約で非同期実行できる関数とDBPARTNER ODBC Driverでの非同期実行の可否

ODBCの規約で非同期実行できる関数名

DBPARTNER ODBC Driverで非同期実行できるかどうか

SQLColAttributes

×

SQLColumnPrivileges

○

SQLColumns

○

SQLDescribeCol

×

SQLDescribeParam

×

SQLExecDirect

○

SQLExecute

○

SQLFetch

○

SQLForeignKeys

×

SQLGetData

×

SQLGetTypeInfo

×

SQLMoreResults

×

SQLNumParams

×

SQLNumResultCols

×

SQLParamData

○

SQLPrepare

○

SQLPrimaryKeys

○

SQLPutData

×

SQLSpecialColumns

×

SQLStatistics

○

SQLTablePrivileges

○

SQLTables

○

（凡例）

○：DBPARTNER ODBC Driverで非同期実行できます。

×：DBPARTNER ODBC Driverで非同期実行できません。

非同期実行のキャンセルと環境定義の非同期キャンセル機能との関係（DBPARTNER/Client32でODBCドライバを使うときの注意）

［DBPARTNER ODBC Driver for DABroker−環境定義−］ダイアログボックスの［非同期キャンセル機能を使用する］チェックボックスの指定は，DBPARTNER/Client32を使うときのオプションです。これは，ODBC規約の正式な非同期キャンセル機能ではありません。したがって，このチェックボックスの指定は，ODBC関数を非同期実行するときは無効になります。

5.8　ストアドプロシジャの実行

結果セットを返すストアドプロシジャは実行できます。ただし，結果セットは取得できません。

第5編　CommuniNet接続のActiveXコントロール

6　アプリケーションを使ったデータベースアクセス（CommuniNet接続）

この章では，DBPARTNER2 ClientのアプリケーションからActiveXコントロールのオブジェクトを使ってデータベースにアクセスする方法（CommuniNet接続）について説明します。

6.1　DBPARTNER2 Clientが提供するActiveXコントロールの概要

DBPARTNER2 Clientのアプリケーションを作成するときは，DBPARTNER2 Clientが提供するActiveXコントロールのオブジェクトを使います。オブジェクトを使って，データベースからデータを抽出したり，更新したりできます。

6.1.1　ActiveXコントロールのオブジェクトの階層

ActiveXコントロールのオブジェクトの階層を図6-1に，オブジェクトの説明を表6-1に示します。複数形のオブジェクト名（Tables，Columns など）は，下位のオブジェクトを管理するコレクションオブジェクトです。

図6‒1　DBPARTNER2 Clientが提供するActiveXコントロールのオブジェクトの階層

表6‒1　DBPARTNER2 Clientが提供するActiveXコントロールのオブジェクトの説明

オブジェクト

説明

DBPARTNER

サーバプログラムとの接続を管理するオブジェクトです。

Result

抽出データを管理するオブジェクトです。

TableList

表情報を管理するオブジェクトです。

ColumnList

列情報を管理するオブジェクトです。

QueryDefine

抽出処理を実行するオブジェクトです。

Tables

Tableオブジェクトを管理するコレクションオブジェクトです。

Table

抽出表を管理するオブジェクトです。

Columns

Columnオブジェクトを管理するコレクションオブジェクトです。

Column

抽出列を管理するオブジェクトです。

Conditions

Conditionオブジェクトを管理するコレクションオブジェクトです。

Condition

抽出条件を管理するオブジェクトです。

UpdateDefine

更新処理を実行するオブジェクトです。

Updates

Updateオブジェクトを管理するコレクションオブジェクトです。

Update

変更行条件，変更情報を管理するオブジェクトです。

Inserts

Insertオブジェクトを管理するコレクションオブジェクトです。

Insert

追加情報を管理するオブジェクトです。

Deletes

Deleteオブジェクトを管理するコレクションオブジェクトです。

Delete

削除行条件を管理するオブジェクトです。

Catalog

手順ファイルを管理するオブジェクトです。

VariableList

手順ファイルの可変値を管理するオブジェクトです。

注意事項

DBPARTNER2 ClientのActiveXコントロールのオブジェクトには，使い方に制限があります。制限については，「6.10　避けて欲しい処理」を参照してください。

6.1.2　プロパティとメソッドの表記

ActiveXコントロールのオブジェクトに属するプロパティとメソッドは，「オブジェクト名．プロパティ又はメソッド名」で示します。

（例）DBPARTNERオブジェクトのConnectメソッドの表記

DBPARTNER.Connectメソッド

ビジュアル開発ツールでは，オブジェクト名を「.」（ピリオド）で表記できます。そのため，このマニュアルでプロパティ又はメソッド名にオブジェクト名を付けて表記するときは，オブジェクト名を斜体文字にしています。

このマニュアルでは，Visual Basicでアプリケーションを開発することを想定して説明します。ほかのビジュアル開発ツールを使ってアプリケーションを作成するときは，マニュアルの記述を読み替えてください。

6.1.3　アプリケーションのサンプル

DBPARTNER2 Clientでは，次に示すフォルダ下にサンプルを提供しています。

DBPARTNER2 Clientのフォルダ¥Ocx¥Samples

サンプルでは，テキストボックスやリストボックスも実装しています。DBPARTNER2 Clientの詳しいアプリケーションの処理については，サンプルを参照してください。

6.1.4　アプリケーションの作成

ActiveXコントロールを使用したアプリケーションを開発するためのプログラムとして，AP作成ウィザードを提供しています。AP作成ウィザードを使用すると，データベースからデータを抽出するアプリケーションが簡単に作成できます。AP作成ウィザードについては，「付録A　AP作成ウィザード」を参照してください。

6.2　データベースアクセスの手順

DBPARTNER2 Clientが提供するActiveXコントロールのオブジェクトを使って，データベースにアクセスする方法について説明します。DBPARTNER2 Clientからデータベースにアクセスする手順の概要を図6-2に示します。

図6‒2　DBPARTNER2 Clientからデータベースにアクセスする手順の概要

データベースにアクセスするときは，トランザクションと排他制御の知識が必要です。トランザクションと排他制御については，「6.4　トランザクションと排他制御（DBPARTNERオブジェクト）」を参照してください。

ActiveXコントロールのオブジェクトの文法については，「7.　DBPARTNER2 Clientのオブジェクトの文法（CommuniNet接続）」を参照してください。

サンプルの参照先

DBPARTNERオブジェクトは，抽出／更新で使います。サンプルについてはDBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Communinetフォルダを参照してください。

6.2.1　DBPARTNERオブジェクトのプロパティの設定

DBPARTNERオブジェクトは，DBPARTNER2 Clientのトップオブジェクトです。データベースに接続する前に，DBPARTNERオブジェクトのプロパティを設定してください。

(1)　DBPARTNERオブジェクトのプロパティに設定する内容

DBPARTNERオブジェクトのプロパティを次に示します。

(a)　サーバプログラムとの接続に関する設定

DBPARTNER.CommitModeプロパティ

トランザクションの終了モードを設定します。

DBPARTNER.CodeChangeModeプロパティ

コード変換をクライアント側で実行するかサーバ側で実行するかを設定します。

(b)　CommuniNetの設定

DBPARTNER.TerminalNameプロパティ

CommuniNetの端末名を設定します。

DBPARTNER.TerminalModeプロパティ

CommuniNetの起動モード（クライアントPCのデスクトップに表示される状態）を設定します。

DBPARTNER.LogonFileNameプロパティ，DBPARTNER.LogoffFileNameプロパティ

CommuniNet接続で使うログオンマクロスクリプトファイル名／ログオフマクロスクリプトファイル名を設定します。

DBPARTNER.MacroTimeLimitプロパティ

CommuniNet接続で使うマクロスクリプトの実行待ち時間を設定します。

(c)　キャンセルの時間監視の設定

DBPARTNER.ResponseLimitプロパティ

キャンセル応答待ち時間（Cancelメソッドの実行待ち時間）を設定します。

(d)　サーバに関する設定

DBPARTNER.TargetServerプロパティ

アクセスするサーバプログラムの製品名を設定します。

DBPARTNER.TargetDatabaseプロパティ

アクセスするデータベースの製品名を設定します。

(e)　利用者に関する設定

DBPARTNER.UserIDプロパティ

ユーザIDを設定します。

DBPARTNER.Passwordプロパティ

パスワードを設定します。

6.3　データベースへの接続と接続の解除（DBPARTNERオブジェクト）

DBPARTNER2 Clientとデータベースを接続する方法と接続を解除する方法について説明します。DBPARTNER2 Clientとデータベースを接続するときは，サーバプログラム（VOS3 HOAPDBS E2，VOS3 ACE3 E3，VOSK HOAPDBS/PC，VOS1 DBPARTNER/Link）が必要です。DBPARTNER2 Clientがサーバプログラムに接続すると，データベースに接続されたことになります。

サンプルの参照先

DBPARTNERオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Communinetフォルダを参照してください。

6.3.1　データベースへの接続

DBPARTNER2 Clientからデータベースに接続するときは，DBPARTNER.Connectメソッドを使います。DBPARTNER.Connectメソッドは，CommuniNetに関するプロパティの設定，ユーザID（DBPARTNER.UserIDプロパティ），パスワード（DBPARTNER.Passwordプロパティ）を参照して，データベースに接続します。

それぞれのプロパティを変更すると，接続するデータベースを変更できます。

データベースと接続するときにデータベース又はサーバプログラムが起動されていないときは，エラーメッセージが表示されます。

(1)　データベースとの接続の確認

DBPARTNER2 Clientとサーバプログラムが接続されているかどうかは，DBPARTNER.lsConnectプロパティを参照して確認できます。

6.3.2　データベースへのアクセスのキャンセル

DBPARTNER2 Clientからデータベースへのアクセス処理をキャンセルするときは，DBPARTNER.Cancelメソッドを使います。

DBPARTNER.Cancelメソッドを実行できる条件とキャンセル後の格納データについては，「7.　DBPARTNER2 Clientのオブジェクトの文法（CommuniNet接続）」のDBPARTNER.Cancelメソッドの説明を参照してください。

6.3.3　データベースとの接続の解除

DBPARTNER2 Clientとデータベースの接続を解除するときは，次に示すどちらかのメソッドを実行します。

DBPARTNER.TerminalCloseメソッド

サーバプログラムとの接続を終了して，CommuniNetを終了させます。

DBPARTNER.Disconnectメソッド

サーバプログラムとの接続だけを終了します。CommuniNetは終了させません。

通常はDBPARTNER.TerminalCloseメソッドを使います。業務の理由でCommuniNetを終了させないときは，DBPARTNER.Disconnectメソッドを使います。

DBPARTNER.TerminalCloseメソッド又はDBPARTNER.Disconnectメソッドを使った後は，接続していたデータベースへの処理はすべてエラーになります。

抽出処理を実行している間に接続を終了しようとすると，メソッドがエラーになります。また，DBPARTNER.Connectメソッドで接続していないデータベースに，接続を終了しようとするメソッドを実行しても無視されます（エラーになりません）。

6.4　トランザクションと排他制御（DBPARTNERオブジェクト）

アプリケーションでトランザクションを制御するときの手順について説明します。

6.4.1　トランザクションの制御の設定

トランザクションをDBPARTNER2 Clientで自動的に制御するか，アプリケーションからトランザクションを制御するかは，DBPARTNER.CommitModeプロパティに設定します。

(1)　DBPARTNER2 Clientで自動的にトランザクションを制御するとき

DBPARTNER2 Clientで自動的にトランザクションを制御するときは，DBPARTNER.CommitModeプロパティにdbpAutoを設定します。dbpAutoを設定すると，データベースアクセスのトランザクションをDBPARTNER2 Clientのアプリケーションから意識する必要はありません。

(2)　アプリケーションからトランザクションを制御するとき

アプリケーションからメソッドを使ってトランザクションを制御するときは，DBPARTNER.CommitModeプロパティにdbpManualを設定してから，DBPARTNER.Commitメソッド又はDBPARTNER.Rollbackメソッドを使います。

DBPARTNER2 Clientは，データベースのデータを更新するExecuteメソッドを実行してからDBPARTNER.Commitメソッド又はDBPARTNER.Rollbackメソッドの実行までを，1件のトランザクションとして扱います。DBPARTNER.Commit又はDBPARTNER.Rollbackが成功すると，その時点から次のトランザクションが開始されます。データベースにアクセスし直す必要はありません。

トランザクションを終了させないでオブジェクトを削除，又はデータベースとの接続を切断すると，DBPARTNER2 Clientがアプリケーションの処理が異常と判断してDBPARTNER.Rollbackメソッドの処理を自動的に実行します。

6.4.2　排他制御

DBPARTNER2 Clientのアプリケーションからデータを抽出／更新するときには，ほかのアプリケーションからのアクセスを許すかどうかを設定します。これを排他制御といいます。

(1)　排他制御の設定

排他制御は，データにアクセスするプロパティ（QueryDefine.Exclusiveプロパティ又はUpdateDefine.Exclusiveプロパティ）に文字列で設定します。アクセスするデータベースによって，設定する内容が異なります。設定する内容については，アクセスするデータベースのマニュアルを参照してください。

(2)　排他エラーになったときの動作の設定

データにアクセスしようとした場合に，ほかのアプリケーションがデータを確保しているときは，データが解放されるまで待つか，エラーにするかを選べます。どちらにするかは，データにアクセスするプロパティ（QueryDefine.Exclusiveプロパティ又はUpdateDefine.Exclusiveプロパティ）に設定します。

データが解放されるまで待つ設定をすると，複数のアプリケーションが互いが確保しているデータの解放を待ち続ける状態（デッドロック）になるおそれがあります。デッドロックにならないように，複数のアプリケーション間でデータを確保する順番を決めておいてください。さらに，複数のアプリケーションからデータベースにアクセスするときは，確保するデータの範囲を最小限に抑えてください。

エラーにする設定をするときは，データベースアクセスごとにエラーの対処（一定時間を空けてリトライをするなど）が必要になります。

6.5　表と列の情報の取得（TableListオブジェクト，ColumnListオブジェクト）

データを抽出する前に表と列の情報を取得して，どのように抽出するかを決めます。情報には，表情報と列情報があります。

6.5.1　表情報の取得

表情報を取得するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，TableListオブジェクトを使います。

表情報を取得するときのオブジェクトの流れとプロパティとメソッドの実行手順を図6-3に示します。

図6‒3　表情報を取得するときのオブジェクトの流れとプロパティとメソッドの実行手順

サンプルの参照先

ColumnListオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Communinet¥Queryフォルダを参照してください。

(1)　表情報を取得する手順

表情報を取得する手順を次に示します。

見出し辞書を使用しない場合

次に示すTableListオブジェクトのプロパティを設定します。

TableList.Patternプロパティ：絞り込み条件を設定します。

TableList.CountLimitプロパティ：取得する表情報の個数を設定します。

TableList.Getメソッドで，表情報の取得を実行します。TableList.Getメソッドを実行すると，次に示すプロパティの値を参照できます。

TableList.Countプロパティ：取得した表情報の個数。

TableList.TableNameプロパティ：取得した表の名前。

TableList.TableTypeプロパティ：取得した表の属性。

TableList.TableOwnerプロパティ：取得した表の所有者。

TableList.TableCommentプロパティ：取得した表の注釈。

TableList.TableGroupNameプロパティ：取得した表のグループ名。

TableList.TableHeaderプロパティ：取得した表のラベル。

TableList.TableCreateDateプロパティ：取得した表の作成日付。

TableList.TableDBMNameプロパティ：取得した表のDBM名。

TableList.TablePasswordModeプロパティ：取得した表に設定してある表パスワードの種別。

TableList.TableSelectAuthプロパティ，TableList.TableUpdateAuthプロパティ，TableList.TableInsertAuthプロパティ，TableList.TableDeleteAuthプロパティ：取得した表への抽出／変更／更新／削除の権限があるかどうか。

上記のプロパティから，必要な情報を参照してください。

見出し辞書を使用する場合

次に示すオブジェクトのプロパティを設定します。

DBPARTNER.DictPathプロパティ：使用する見出し辞書のパスを設定します。

DBPARTNER.TableDefSourceプロパティ：表情報の取得元を設定します。

TableList.SelectDictプロパティ：使用する見出し辞書を限定します。

TableList.Patternプロパティ：絞り込み条件を設定します。

TableList.CountLimitプロパティ：取得する表情報の個数を設定します。

TableList.Getメソッドで，表情報の取得を実行します。TableList.Getメソッドを実行すると，次に示すプロパティの値を参照できます。

TableList.Countプロパティ：取得した表情報の個数。

TableList.TableNameプロパティ：取得した表の名前。

TableList.TableTypeプロパティ：取得した表の属性。

TableList.TableOwnerプロパティ：取得した表の所有者。

TableList.TableCommentプロパティ：取得した表の注釈。

TableList.TableGroupNameプロパティ：取得した表のグループ名。

TableList.TableHeaderプロパティ：取得した表のラベル。

TableList.TableCreateDateプロパティ：取得した表の作成日付。

TableList.TableDBMNameプロパティ：取得した表のDBM名。

TableList.TablePasswordModeプロパティ：取得した表に設定してある表パスワードの種別。

TableList.TableSelectAuthプロパティ，TableList.TableUpdateAuthプロパティ，TableList.TableInsertAuthプロパティ，TableList.TableDeleteAuthプロパティ：取得した表への抽出／変更／更新／削除の権限があるかどうか。

上記のプロパティから，必要な情報を参照してください。

(2)　注意

TableList.PatternプロパティとTableList.CountLimitプロパティは，TableList.Getメソッドを実行する前に設定してください。TableList.Getメソッドを実行した後に変更しても，無視されます。

6.5.2　列情報の取得

列情報を取得するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，ColumnListオブジェクトを使います。

表情報を取得するときのオブジェクトの流れとプロパティとメソッドの実行手順を図6-4に示します。

図6‒4　列情報を取得するときのオブジェクトの流れとプロパティとメソッドの実行手順

サンプルの参照先

ColumnListオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Communinet¥Queryフォルダを参照してください。

(1)　列情報を取得する手順

列情報を取得する手順を次に示します。

見出し辞書を使用しない場合

次に示すColumnListオブジェクトのプロパティを設定します。

ColumnList.TableNameプロパティ：列情報を取得する表の名前を設定します。

ColumnList.CountLimitプロパティ：取得する列情報の個数を設定します。

ColumnList.TablePasswordプロパティ：取得する列情報の個数を設定します。

ColumnList.Getメソッドで，列情報の取得を実行します。ColumnList.Getメソッドを実行すると，次に示すプロパティの値を参照できます。

ColumnList.Countプロパティ：取得した列の個数。

ColumnList.ColumnNameプロパティ：取得した列の名前。

ColumnList.ColumnTypeプロパティ：取得した列の属性。

ColumnList.ColumnLengthプロパティ：取得した列の定義長。

ColumnList.ColumnScaleプロパティ：取得した列の小数点以下のけた数。

ColumnList.ColumnCommentプロパティ：取得した列の注釈。

ColumnList.ColumnHeaderプロパティ：取得した列のラベル。

ColumnList.ColumnNumberプロパティ：取得した列の列番号。

ColumnList.ColumnEditPatternプロパティ：取得した列の編集形式。

上記のプロパティから，必要な情報を参照してください。

見出し辞書を使用する場合

次に示すオブジェクトのプロパティを設定します。

DBPARTNER.DictPathプロパティ：使用する見出し辞書のパスを設定します。

DBPARTNER.TableDefSourceプロパティ：列情報の取得元を設定します。

TableList.SelectDictプロパティ：使用する見出し辞書を限定します。

ColumnList.TableNameプロパティ：列情報を取得する表の名前を設定します。

ColumnList.CountLimitプロパティ：取得する列情報の個数を設定します。

ColumnList.TablePasswordプロパティ：取得する列情報の個数を設定します。

ColumnList.Getメソッドで，列情報の取得を実行します。ColumnList.Getメソッドを実行すると，次に示すプロパティの値を参照できます。

ColumnList.Countプロパティ：取得した列の個数。

ColumnList.ColumnNameプロパティ：取得した列の名前。

ColumnList.ColumnTypeプロパティ：取得した列の属性。

ColumnList.ColumnLengthプロパティ：取得した列の定義長。

ColumnList.ColumnScaleプロパティ：取得した列の小数点以下のけた数。

ColumnList.ColumnCommentプロパティ：取得した列の注釈。

ColumnList.ColumnHeaderプロパティ：取得した列のラベル。

ColumnList.ColumnNumberプロパティ：取得した列の列番号。

ColumnList.ColumnEditPatternプロパティ：取得した列の編集形式。

上記のプロパティから，必要な情報を参照してください。

(2)　注意

ColumnList.TableNameプロパティとColumnList.CountLimitプロパティは，ColumnList.Getメソッドを実行する前に設定してください。ColumnList.Getメソッドを実行した後に変更しても，無視されます。

6.6　データの抽出（QueryDefineオブジェクト）

DBPARTNER2 ClientのオブジェクトQueryDefineを使って，データを抽出する方法について説明します。データを抽出するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，QueryDefineオブジェクトを使います。

QueryDefineオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順を図6-5に示します。

図6‒5　QueryDefineオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順

サンプルの参照先

QueryDefineオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Communinet¥Queryフォルダを参照してください。

6.6.1　QueryDefineオブジェクトを使ってデータを抽出する手順

QueryDefineオブジェクトを使ってデータを抽出する手順を次に示します。

次に示すオブジェクトに，抽出データに関する条件を設定します。

Tablesコレクションオブジェクト：下位にある複数のTableオブジェクトに，抽出表の名称を設定します。TableオブジェクトのTableNameプロパティに，抽出表の名称を設定します。

Columnsコレクションオブジェクト：下位にある複数のColumnオブジェクトに，抽出列の名称を設定します。ColumnオブジェクトのColumnNameプロパティに，抽出列の名称を，SortModeプロパティとSortPriorityプロパティにソートする条件を，FunctionModeプロパティに集合関数を設定します。

Conditionsコレクションオブジェクト：下位にある複数のConditionオブジェクトに，抽出条件式を設定します。ConditionオブジェクトのTextプロパティに抽出条件式を設定します。

QueryDefine.Exclusiveプロパティに，排他モードを設定します。

QueryDefine.Executeメソッドで，抽出を実行します。

Resultオブジェクトで，抽出データを処理します。Resultオブジェクトの使い方については，「6.7　抽出データの管理（Resultオブジェクト）」を参照してください。

6.7　抽出データの管理（Resultオブジェクト）

QueryDefine.Executeメソッドを実行して抽出したデータを処理する方法について説明します。抽出データを処理するときは，Resultオブジェクトを使います。

サンプルの参照先

Resultオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Communinet¥Queryフォルダ又はDBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Communinet¥Updateフォルダを参照してください。

6.7.1　抽出データを格納する方法

抽出データを格納する手順を次に示します。

次に示すResultオブジェクトのプロパティを設定します。

Result.QueryCountLimitプロパティ：抽出処理の結果として出力する行数を設定します。

Result.DataCheckプロパティ：抽出データの文字コードをチェックするかどうかを設定します。

Result.HeaderOutputプロパティ：抽出データの先頭行に，列名を付けるかどうかを設定します。

1行ずつデータを抽出するときは，Result.Getメソッドを実行します。Result.Getメソッドを実行すると，次に示すプロパティの値を参照できます。

Result.RecordHeaderプロパティ：抽出処理の結果として出力される列名。

Result.RecordDataプロパティ：抽出データ。1行単位で返します。

Result.FieldDataプロパティ：抽出データ。1列単位で返します。

Result.FieldDataLengthプロパティ：列のデータ長。

Result.FieldCountプロパティ：抽出データの列数。

必要に応じて，次に示すプロパティを設定します。

Result.FieldHeaderプロパティ：列にヘッダを設定します。

抽出データを一括してファイルに出力するときは，Result.SaveToFileメソッドを実行します。メソッドには，抽出するデータの形式（TXT形式，CSV形式，XLS形式，DAT形式）を設定します。

いったんクリップボードに退避するときは，Result.CopyToClipboardメソッドを実行します。メソッドには，抽出するデータの形式（TXT形式，XLS形式）を設定します。クリップボードに退避した抽出データは，Excelなどのアプリケーションに貼り付けて使えます。

データをすべて取得できたかどうかは，Result.EOFプロパティで判定します。抽出処理を途中で終了させるときは，Result.Closeメソッドを実行します。

6.8　データの更新（UpdateDefineオブジェクト）

DBPARTNER2 ClientのオブジェクトUpdateDefineを使って，データを更新する方法です。データを更新するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，UpdateDefineオブジェクトを使います。

データの更新は，更新版と定義版のDBPARTNER2 Clientで実行できます。参照版のDBPARTNER2 Clientでは，データの更新はできません。

UpdateDefineオブジェクトを使った更新のオブジェクトの流れとプロパティとメソッドの実行手順を図6-6に示します。

図6‒6　UpdateDefineオブジェクトを使った更新のオブジェクトの流れとプロパティとメソッドの実行手順

サンプルの参照先

UpdateDefineオブジェクトのサンプルは，DBPARTNER2 Clientのフォルダ¥Ocx¥Samples¥Vb¥Communinet¥Updateフォルダを参照してください。

6.8.1　UpdateDefineオブジェクトを使ってデータを更新する手順（変更）

UpdateDefineオブジェクトを使ってデータを更新（変更）する手順を次に示します。

次に示すプロパティを設定します。

UpdateDefine.Exclusiveプロパティ：排他モードを設定します。

UpdateDefine.UpdateModeプロパティ：更新実行モードを設定します。

UpdateDefine.TableNameプロパティ：更新する表の名前を設定します。

UpdateDefine.TablePasswordプロパティ：更新する表のパスワードを設定します。

UpdateDefine.Updates.Addメソッドで，Updateオブジェクトを生成します。

Updatesコレクションオブジェクト下のUpdateオブジェクトに，変更するデータに関する条件を設定します。

変更するデータに関する条件を変更するときは，次に示すメソッドを実行します。

UpdateDefine.Update.AddKeyメソッド：変更行条件を設定します。

UpdateDefine.Update.UpdateValueメソッド：変更行条件を設定します。

UpdateDefine.Executeメソッドを実行します。UpdateDefine.Executeメソッドを実行すると，次に示すプロパティの値を参照できます。

UpdateDefine.ExecutedRowCountプロパティ：サーバプログラムが更新した行数。

6.8.2　UpdateDefineオブジェクトを使ってデータを更新する手順（追加）

UpdateDefineオブジェクトを使ってデータを更新（追加）する手順を次に示します。

次に示すプロパティを設定します。

UpdateDefine.Exclusiveプロパティ：排他モードを設定します。

UpdateDefine.UpdateModeプロパティ：更新実行モードを設定します。

UpdateDefine.TableNameプロパティ：更新する表の名前を設定します。

UpdateDefine.TablePasswordプロパティ：更新する表のパスワードを設定します。

UpdateDefine.Inserts.Addメソッドで，Insertオブジェクトを生成します。

Insertsコレクションオブジェクト下のInsertオブジェクトに，追加するデータに関する条件を設定します。

追加するデータに関する条件を変更するときは，次に示すメソッドを実行します。

UpdateDefine.Insert.AddInsertValueメソッド：追加情報を設定します。

メソッドを実行した後，UpdateDefine.Executeメソッドを実行します。UpdateDefine.Executeメソッドを実行すると，次に示すプロパティの値を参照できます。

UpdateDefine.ExecutedRowCountプロパティ：サーバプログラムが更新した行数。

更新が正しく実行されたかどうかを確認できます。

6.8.3　UpdateDefineオブジェクトを使ってデータを更新する手順（削除）

UpdateDefineオブジェクトを使ってデータを更新（削除）する手順を次に示します。

次に示すプロパティを設定します。

UpdateDefine.Exclusiveプロパティ：排他モードを設定します。

UpdateDefine.UpdateModeプロパティ：更新実行モードを設定します。

UpdateDefine.TableNameプロパティ：更新する表の名前を設定します。

UpdateDefine.TablePasswordプロパティ：更新する表のパスワードを設定します。

UpdateDefine.Deletes.Addメソッドで，Deleteオブジェクトを生成します。

Deletesコレクションオブジェクト下のDeleteオブジェクトに，削除するデータに関する条件を設定します。

削除するデータに関する条件を変更するときは，次に示すメソッドを実行します。

UpdateDefine.Delete.AddKeyメソッド：削除行条件を設定します。

メソッドを実行した後，UpdateDefine.Executeメソッドを実行します。UpdateDefine.Executeメソッドを実行すると，次に示すプロパティの値を参照できます。

UpdateDefine.ExecutedRowCountプロパティ：サーバプログラムが更新した行数。

6.9　データの抽出（Catalogオブジェクト）

DBPARTNER2 ClientのオブジェクトCatalogを使って，データを抽出する方法について説明します。データを抽出するときは，DBPARTNER.Connectメソッドでサーバプログラムと接続した後，Catalogオブジェクトを使います。

Catalogオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順を図6-7に示します。

図6‒7　Catalogオブジェクトを使った抽出のオブジェクトの流れとプロパティとメソッドの実行手順

6.9.1　Catalogオブジェクトを使ってデータを抽出する手順

Catalogオブジェクトを使ってデータを抽出する手順を次に示します。

次に示すCatalogオブジェクトのプロパティを設定します。

Catalog.FileLoadプロパティ：手順ファイルのファイル名を設定します。

Catalog.ConvertメソッドでQueryDefineオブジェクトを作成します。

QueryDefine.Exclusiveプロパティに，排他モードを設定します。

QueryDefine.Executeメソッドで，抽出を実行します。

Resultオブジェクトで，抽出データを処理します。Resultオブジェクトの使い方については，「6.7　抽出データの管理（Resultオブジェクト）」を参照してください。

6.10　避けて欲しい処理

DBPARTNER2 Clientのアプリケーションを開発するときには，次に示す処理は作らないでください。このような処理を作ったアプリケーションをDBPARTNER2 Clientで使ったときの動作は保証しません。

6.10.1　プロパティとメソッド処理中に，別の入力を許す処理

プロパティとメソッドが処理を実行中に，別の入力を受け取ってプロパティとメソッドを実行するような処理は避けてください。プロパティとメソッドが処理中に別のプロパティとメソッドを実行すると，最初に実行したプロパティとメソッド以外はエラーになります。

例えば，ボタンコントロールに対応したコードの中にプロパティとメソッドを記述するときは，ボタンコントロールのコードの最初にコントロールを不活性（入力を受け付けない）に変える処理を記述して，コードの最後に活性（入力を受け付ける）に変える処理を記述してください。

タイマーコントロールなどを使うときは，処理ステータスを管理するフラグを使って，同時に複数のプロパティとメソッドが実行されないようにしてください。

6.10.2　TerminalCloseメソッドを実行しないでアプリケーションを終了する処理

TerminalCloseメソッドを実行しないでアプリケーションを終了させると，CommuniNetが終了しないことがあります。CommuniNetが終了しないときは，CommuniNetを強制終了してください。強制終了すると，TSSユーザが残ったままになるので，このTSSユーザはサーバ側で終了させてください。

アプリケーションを終了するときは，必ずTerminalCloseメソッドでサーバプログラムとの接続を終了してからCommuniNetを終了させてください。

サーバプログラムとの接続が開始していないときは，TerminalCloseメソッドを実行する必要はありません。

6.10.3　一つのアプリケーションで複数のActiveXコントロールを使う処理

CommuniNet接続のActiveXコントロールは，同時に複数のコントロールからの接続要求を処理できません。一つのアプリケーションで複数のコントロールを使うときは，サーバプログラムと接続中のコントロールに対してCommuniNetの終了処理（TerminalCloseメソッドの実行）をしてから，別のActiveXコントロールで接続を開始してください。

6.10.4　Internet ExplorerでActiveXコントロールを使う処理

DBPARTNER2 ClientのActiveXコントロールは，クライアントのアプリケーションを開発するためだけに使ってください。Microsoft ActiveX Control Pad などを使ってHTMLファイルに記述を追加できますが，その動作は保証されません。

6.11　プロパティとメソッドの使い方の詳細

プロパティとメソッドを実行するときの，次に示す条件について説明します。

プロパティとメソッドの実行順序

プロパティとメソッドの制限

6.11.1　プロパティとメソッドの実行順序

プロパティとメソッドを使うときに，前提になるプロパティ又はメソッドを表6-2〜表6-8に示します。

表の項目の「接続」とは，データベースとの接続（DBPARTNER.Connectメソッド）が必要かどうかを示します。必要なときは「○」，特に必要でないときは「−」で示します。

表6‒2　プロパティとメソッドの実行順序（DBPARTNERオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

CodeChangeMode

−

−

CommitMode

−

−

DictPath

−

−

TableDefSource

−

−

IsConnect

−

−

LogoffFileName

−

−

LogonFileName

−

−

MacroTimeLimit

−

−

Password

−

−

ResponseLimit

−

−

TargetDatabase

−

−

TargetServer

−

−

TerminalMode

−

−

TerminalName

−

−

UserID

−

−

Cancel

○

−

Commit

○

−

Connect

−

−

Disconnect

○

−

Rollback

○

−

TerminalClose

○

−

表6‒3　プロパティとメソッドの実行順序（TableListオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

Pattern

−

−

CountLimit

−

−

Count

○

TableList.Get

SelectDict

−

−

TableName

○

TableList.Get

TableOwner

○

TableList.Get

TableType

○

TableList.Get

TableComment

○

TableList.Get

TableDataSource

○

TableList.Get

TableGroupName

○

TableList.Get

TableHeader

○

TableList.Get

TableCreateDate

○

TableList.Get

TableDBMName

○

TableList.Get

TableDeleteAuth

○

TableList.Get

TableInsertAuth

○

TableList.Get

TablePasswordMode

○

TableList.Get

TableSelectAuth

○

TableList.Get

TableUpdateAuth

○

TableList.Get

Get

○

−

表6‒4　プロパティとメソッドの実行順序（ColumnListオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

TableName

−

−

CountLimit

−

−

Count

○

ColumnList.Get

ColumnName

○

ColumnList.Get

ColumnType

○

ColumnList.Get

ColumnLength

○

ColumnList.Get

ColumnScale

○

ColumnList.Get

ColumnComment

○

ColumnList.Get

ColumnHeader

○

ColumnList.Get

ColumnEditPattern

○

ColumnList.Get

ColumnNumber

○

ColumnList.Get

TablePassword

−

−

SelectDict

−

−

Get

○

ColumnList.TableName

表6‒5　プロパティとメソッドの実行順序（Resultオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

QueryCountLimit

−

−

DataCheck

−

−

HeaderOutput

−

−

RecordHeader

○

QueryDefine.Execute

FieldHeader

○

QueryDefine.Execute

RecordData

○

Result.Get

FieldData

○

Result.Get

FieldDataLength

○

Result.Get

FieldCount

○

QueryDefine.Execute

EOF

○

Result.Get

Get

○

QueryDefine.Execute

Close

○

QueryDefine.Execute又はResult.Get

SaveToFile

○

QueryDefine.Execute

CopyToClipboard

○

QueryDefine.Execute

表6‒6　プロパティとメソッドの実行順序（QueryDefineオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

Exclusive

−

−

QueryCount

○

QueryDefine.Tables.Add

Execute

○

QueryDefine.Tables.Add

RemoveAll

−

−

Tables.Count

−

QueryDefine.Tables.Add

Tables.Add

−

−

Tables.RemoveAll

−

−

Table.TableName

−

QueryDefine.Tables.Add

Table.TablePassword

−

QueryDefine.Tables.Add

Columns.Count

−

QueryDefine.Columns.Add

Columns.Add

−

−

Columns.RemoveAll

−

−

Column.ColumnName

−

QueryDefine.Columns.Add

Column.SortMode

−

QueryDefine.Columns.Add

Column.SortPriority

−

QueryDefine.Column.SortMode

Column.FunctionMode

−

QueryDefine.Columns.Add

Conditions.Count

−

QueryDefine.Conditions.Add

Conditions.Relation

−

QueryDefine.Conditions.Add

Conditions.Add

−

−

Conditions.RemoveAll

−

−

Condition.Text

−

QueryDefine.Conditions.Add

表6‒7　プロパティとメソッドの実行順序（UpdateDefineオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

Exclusive

−

−

UpdateMode

−

−

TableName

−

−

TablePassword

−

−

ErrorInformation

○

UpdateDefine.Execute

ExecutedRowCount

○

UpdateDefine.Execute

Execute

○

UpdateDefine.TableNameと次に示す組み合わせ

UpdateDefine.Update.AddKeyと

UpdateDefine.Update.AddUpdateValue

UpdateDefine.Update.AddKey

UpdateDefine.Insert.AddInsertValue

UpdateDefine.Delete.AddKey

RemoveAll

−

−

Updates.Count

−

UpdateDefine.Updates.Add

Updates.Add

−

−

Updates.RemoveAll

−

−

Update.KeyCount

−

UpdateDefine.Update.AddKey

Update.UpdateValueCount

−

UpdateDefine.Update.AddUpdateValue

Update.KeyColumn

−

UpdateDefine.Update.AddKey

Update.KeyValue

−

UpdateDefine.Update.AddKey

Update.Column

−

UpdateDefine.Update.AddUpdateValue

Update.UpdateValue

−

UpdateDefine.Update.AddUpdateValue

Update.AddKey

−

UpdateDefine.Updates.Add

Update.AddUpdateValue

−

UpdateDefine.Updates.Add

Inserts.Count

−

UpdateDefine.Inserts.Add

Inserts.Add

−

−

Inserts.RemoveAll

−

−

Insert.InsertValueCount

−

UpdateDefine.Insert.AddInsertValue

Insert.Column

−

UpdateDefine.Insert.AddInsertValue

Insert.InsertValue

−

UpdateDefine.Insert.AddInsertValue

Insert.AddInsertValue

−

UpdateDefine.Inserts.Add

Deletes.Count

−

UpdateDefine.Deletes.Add

Deletes.Add

−

−

Deletes.RemoveAll

−

−

Delete.KeyCount

−

UpdateDefine.Delete.AddKey

Delete.KeyColumn

−

UpdateDefine.Delete.AddKey

Delete.KeyValue

−

UpdateDefine.Delete.AddKey

Delete.AddKey

−

UpdateDefine.Deletes.Add

表6‒8　プロパティとメソッドの実行順序（Catalogオブジェクト）

プロパティ又はメソッド

接続

前提になるプロパティ又はメソッド

Convert

○

Catalog.FileLoad

FileLoad

−

−

Variable.Count

−

Catalog.FileLoad

Variable.VariableName

−

Catalog.FileLoad

Variable.VariableValue

−

Catalog.FileLoad

6.11.2　プロパティとメソッドの制限

プロパティとメソッドは，サーバプログラムと接続していないとエラーになることがあります。プロパティとメソッドの状態遷移を表6-9に示します。表6-9にある「×」は，エラーになることを示します。表6-9に記載していないプロパティとメソッドは，状態遷移による制限はありません。

表6-9に示す状態は，次に示す4種類あります。

未接続：サーバプログラムと接続していない状態を示します。

接続：サーバプログラムと接続している状態を示します。

前処理：Select系SQL文を実行した状態を示します。

取得：抽出結果の取得中の状態を示します。

表6‒9　プロパティとメソッドの状態遷移

オブジェクト

プロパティ又は

メソッド

状態

1：未接続

2：接続

3：前処理

4：取得

DBPARTNER

Cancel

1※1

2※1

2※2

2※2

Disconnect

1※3

1

×

×

TerminalClose

1※3

1

×

×

Commit

×

2※4

2※5

2※5

Rollback

×

2※4

2※5

2※5

Connect

2

2※6

×

×

Result

RecordHeader

×

×

3

4

FieldHeader

×

×

3

4

RecordData

×

×

×

4

FieldData

×

×

×

4

FieldType

×

×

3

4

FieldDataLength

×

×

×

4

FieldCount

1※7

2※7

3

4

Get

×

×

4又は

2※8

4又は

2※8

Close

1※3

2※3

2

2

SaveToFile

×

×

2

×

CopyToClipboard

×

×

2

×

TableList

Get

×

2

×

×

ColumnList

Get

×

2

×

×

QueryDefine

QueryCount

×

2

×

×

Execute

×

3

×

×

UpdateDefine

Execute

×

2

×

×

注※1

Cancelは正常に終了します。

注※2

Cancelが正常に受け付けられたときは遷移します。受け付けられなかったときは遷移しません。

注※3

何も処理しません。

注※4

Commit/Rollbackメソッドは正常に終了します。

注※5

Commit/Rollbackメソッドを処理した後で，DBPARTNER2 Clientが自動的にCloseメソッドを実行します。

注※6

現在の接続を終了した後で，接続を再開始します。

注※7

0を返します。

注※8

最終データまで取得したとき，又はエラーになったときは，2に遷移します。

7　DBPARTNER2 Clientのオブジェクトの文法（CommuniNet接続）

この章では，DBPARTNER2 Clientのアプリケーションを開発するときに使うActiveXコントロールのオブジェクトの文法（CommuniNet接続）について説明します。

7.1　プロパティページの設定

DBPARTNER2 ClientのActiveXコントロールで設定できるプロパティページについて説明します。

CommuniNet接続のときは，プロパティページには［端末］タブと［サーバ］タブがあります。

7.1.1　プロパティページの［端末］タブ

DBPARTNER2 Clientのプロパティページ（CommuniNet接続 ［端末］タブ）を図7-1に示します。

図7‒1　DBPARTNER2 Clientのプロパティページ（CommuniNet接続 ［端末］タブ）

端末名称（DBPARTNER.TerminalNameプロパティ）

通信に使うCommuniNetの端末名を，文字列で設定します。省略時仮定値はありません。

端末起動モード（DBPARTNER.TerminalModeプロパティ）

端末起動モードを，コンボボックスから選びます。省略時仮定値は「0−非表示」です。

0−非表示

CommuniNetを非表示モードで起動します。

1−アイコン表示

CommuniNetを最小化モード（タスクバー上のボタン表示）で起動します。

2−表示

CommuniNetを表示モードで起動します。

ログオンスクリプト（DBPARTNER.LogonFileNameプロパティ）

サーバプログラムと接続するためのログオン操作を登録した，マクロスクリプトのファイルを設定します。［...］ボタンをクリックすると，マクロスクリプトを選ぶ画面が表示されます。マクロスクリプトを選ぶ画面を図7-2に示します。

図7‒2　マクロスクリプトを選ぶ画面

ログオフスクリプト（DBPARTNER.LogoffFileNameプロパティ）

サーバプログラムとの接続を終了するためのログオフ操作を登録した，マクロスクリプトのファイルを設定します。［...］ボタンをクリックすると，マクロスクリプトを選ぶ画面が表示されます。マクロスクリプトを選ぶ画面は，図7-2と同じです。

スクリプト実行時間（DBPARTNER.MacroTimeLimitプロパティ）

ログオン／ログオフ操作のマクロスクリプトの実行待ち時間を設定します。省略すると，60秒が仮定されます。

7.1.2　プロパティページの［サーバ］タブ

DBPARTNER2 Clientのプロパティページ（CommuniNet接続 ［サーバ］タブ）を図7-3に示します。

図7‒3　DBPARTNER2 Clientのプロパティページ（CommuniNet接続 ［サーバ］タブ）

サーバ種別（DBPARTNER.TargetServerプロパティ）

接続するサーバプログラムを，次に示す候補からコンボボックスで選びます。省略時仮定値は「0−HOAPDBS E2，HOAPDBS/PC」です。

0−HOAPDBS E2，HOAPDBS/PC

1−DBPARTNER/Link，ACE3 E3

データベース種別（DBPARTNER.TargetDatabaseプロパティ）

接続するデータベースを，次に示す候補からコンボボックスで選びます。省略時仮定値は「0−VOS3 XDM/RD E2」です。

0−VOS3 XDM/RD E2

1−VOS3 XDM/SD E2

2−VOS3 PDMII E2

3−VOS3 ACE3 ユーザファイル

4−VOS3 RDB1

5−VOSK RDB編成ファイル

6−VOSKスプールファイル

7−VOS1 PDMII E2

8−VOS1 ACE3 ユーザファイル

9−VOS1スプールファイル

ユーザID（DBPARTNER.UserIDプロパティ）

ユーザIDを設定します。ここに設定した値は，UserIDプロパティに設定されます。文字列は，最大8バイト入力できます。

パスワード（DBPARTNER.Passwordプロパティ）

パスワードを設定します。ここに設定した値は，Passwordプロパティに設定されます。文字列は，最大8バイト入力できます。

コミットモード（DBPARTNER.CommitModeプロパティ）

DBPARTNER2 Clientが自動的にトランザクションを制御するかどうかを，次に示す候補からコンボボックスで選びます。省略すると「0−AutoCommit」が仮定されます。

0−AutoCommit

DBPARTNER2 Clientが自動的にトランザクションを制御します。

1−ManualCommit

アプリケーションからCommit/Rollbackを実行してトランザクションを制御します。

7.2　DBPARTNERオブジェクトの詳細

DBPARTNERオブジェクトは，サーバプログラムとの接続を管理するオブジェクトです。このオブジェクトは，DBPARTNER2 Clientのトップオブジェクトです。

DBPARTNERオブジェクトのプロパティとメソッドの一覧を次に示します。

●DBPARTNERオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

CodeChangeMode

○

○

コード変換処理を実行するプログラムを設定します。

CommitMode

○

○

トランザクション終了モードを設定します。

DictPath

○

○

見出し辞書を格納しているパスを文字列で設定します。

TableDefSource

○

○

表情報，列情報の取得元を設定します。

IsConnect

−

○

サーバと接続しているかどうかの状態を取得します。

LogoffFileName

○

○

ログオフに使うマクロスクリプトファイル名を設定します。

LogonFileName

○

○

ログオンに使うマクロスクリプトファイル名を設定します。

MacroTimeLimit

○

○

マクロスクリプトの実行監視時間を設定します。

Password

○

○

パスワードを文字列で設定します。

ResponseLimit

○

○

応答待ち時間を設定します。

TargetDatabase

○

○

接続するデータベースを設定します。

TargetServer

○

○

接続するサーバプログラムを設定します。

TerminalMode

○

○

CommuniNetの起動モードを設定します。

TerminalName

○

○

CommuniNetの端末名を設定します。

UserID

○

○

ログインするユーザIDを文字列で設定します。

●DBPARTNERオブジェクトのメソッドの一覧

メソッド

説明

Cancel（CancelEx）

実行中の処理をキャンセルします。

Commit

実行中の処理を有効にして，トランザクションを終了させます。

Connect

サーバとの接続を開始します。

Disconnect

サーバとの接続を終了します。

Rollback

実行中の処理を無効にして，トランザクションを終了させます。

TerminalClose

サーバとの接続を終了して，CommuniNetを終了させます。

CodeChangeModeプロパティ

機能

コード変換処理を実行するプログラムを設定します。コード変換処理とは，サーバ側の文字コード（EBCDIK/KEIS）とクライアント側の文字コード（JIS/シフトJIS）の変換処理のことです。

dbpServerを設定すると，TargetServerプロパティで設定したサーバでコード変換処理を実行します。dbpClientを設定すると，TerminalNameプロパティで設定したCommuniNetでコード変換処理を実行します。

このプロパティは，値も取得できます。

形式

　　　　Object. CodeChangeMode［= Mode］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Mode

コード変換種別を，次に示す定数又は数値で設定します。

定数

数値

内容

dbpServer

0

コード変換を，サーバ側のプログラムで実行します。

dbpClient

1

コード変換を，クライアント側のプログラムで実行します。

使い方

dbpClientを設定するときは，CommuniNetのコードマッピングユーティリティを使って，シフトJISコードとKEISコードを対応付けてください。

dbpClientを設定するときは，サーバ側の設定を変更する必要があります。dbpClientを設定したときの注意については，「8.2　クライアント側プログラムでコード変換するときの注意」を参照してください。

コード変換種別に設定した値は，初回のConnectメソッド実行時（CommuniNet起動時）にCommuniNetに渡されるので，CommuniNetが終了するまで変更できません。

CommitModeプロパティ

機能

サーバプログラムに対するトランザクションを自動的に終了するかどうかを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. CommitMode［= Mode］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Mode

トランザクション終了モードを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpAuto

0

自動的にトランザクションを終了します。

dbpManual

1

アプリケーションで終了を設定します。

使い方

dbpAutoを設定すると，Commitメソッド又はRollbackメソッドを実行しても無視されます。

dbpAutoを設定したときに一覧情報の取得，データの抽出，データの更新処理が正常に終わると，自動的にトランザクションがCommitされます。

dbpAutoを設定したときに一覧情報の取得，データの抽出，データの更新処理がエラーになると，自動的にトランザクションがRollbackされます。

dbpManualは更新処理のときにだけ有効です。表情報，列情報，データの抽出など，更新以外の処理では有効になりません。

dbpManualを設定したときは，更新処理が終了した時点でCommitメソッド又はRollbackメソッドでトランザクションを終了してください。更新処理が終了した時点でトランザクションを終了しないと，以降の処理の中で自動的にCommitが実行されます。

サーバプログラムと接続中（ConnectメソッドからDisconnectメソッドまでの間）は，CommitModeプロパティの値を変更してもトランザクション終了モードを変えることはできません。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

DictPathプロパティ

機能

見出し辞書を格納しているディレクトリのパスを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. DictPath［= Path］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Path

パスを，1〜256の文字列で設定します。パスの終端の“¥”は省略できます。

使い方

表情報，列情報を見出し辞書から取得する場合は，必ず設定してください。

TableDefSourceプロパティ

機能

表情報，列情報を取得するモードを設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. TableDefSource［= Mode］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Mode

表情報，列情報の要求先を，定数又は数値で設定します。

定数

数値

情報の要求先

dbpDB

0

表情報，列情報をデータベースから取得します。

dbpDICT

1

表情報，列情報を見出し辞書から取得します。

dbpDBDICT

2

表情報，列情報をデータベースから取得し，ラベル（TableHeader，ColumnHeader）は見出し辞書から取得します。

IsConnectプロパティ

機能

サーバプログラムとの接続状態をBOOLEAN値で取得します。

形式

　　　　Object. IsConnect

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

戻り値

定数

内容

TRUE（真）

サーバプログラムと接続されています。

FALSE（偽）

サーバプログラムと接続されていません。

使い方

サーバプログラムの時間監視機能などで強制的に接続が解除されたときは，接続されていなくてもTRUEが返ることがあります。

LogoffFileNameプロパティ

機能

サーバプログラムとの接続を終了するための，ログオフ操作を登録したマクロスクリプトのファイル名を設定します。このプロパティは，値も取得できます。

形式

　　　　Object. LogoffFileName［＝ FileName］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

FileName

ログオフ操作を登録したマクロスクリプトのファイル名を，1〜256バイトの文字列で設定します。マクロスクリプトファイル名は省略できません。

使い方

マクロスクリプトファイル名には，ドライブ名で始まる絶対パス名で設定してください。ファイル名だけを設定すると，CommuniNetを組み込んだフォルダの¥Macroフォルダ下だけを探します。

マクロスクリプトファイルの作成方法については，「2.4.2　マクロスクリプトファイルの作成」を参照してください。

LogonFileNameプロパティ

機能

サーバプログラムと接続するための，ログオン操作を登録したマクロスクリプトのファイル名を設定します。このプロパティは，値も取得できます。

形式

　　　　Object. LogonFileName［＝ FileName］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

FileName

ログオン操作を登録したマクロスクリプトのファイル名を，1〜256バイトの文字列で設定します。マクロスクリプトファイル名は省略できません。

使い方

マクロスクリプトファイル名には，ドライブ名で始まる絶対パス名で設定してください。ファイル名だけを設定すると，CommuniNetを組み込んだフォルダの¥Macroフォルダ下だけを探します。

マクロスクリプトファイルの作成方法については，「2.4.2　マクロスクリプトファイルの作成」を参照してください。

MacroTimeLimitプロパティ

機能

ログオン／ログオフ操作のマクロスクリプトの実行待ち時間を設定します。このプロパティは，値も取得できます。

形式

　　　　Object. MacroTimeLimit［＝ Time］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Time

マクロスクリプトの実行待ち時間を，1〜600（秒）の数値で設定します。省略すると，60（秒）が仮定されます。

使い方

設定した実行待ち時間を超えてもマクロスクリプトの実行が終了しないときは，Connectメソッド，TerminalCloseメソッド，Disconnectメソッドがエラーになります。エラーが頻繁に起こるときは，マクロスクリプトの実行待ち時間を大きくしてください。

Passwordプロパティ

機能

UserIDプロパティで設定したユーザIDのパスワードを，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. Password［= PWD］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

PWD

パスワードを，0〜8バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

サーバプログラムと接続中（ConnectメソッドからDisconnectメソッドまでの間）は，Passwordプロパティの値を変更しても接続ユーザのパスワードを変えることはできません。

ResponseLimitプロパティ

機能

サーバプログラムで実行中の処理に対するキャンセル（中止）を有効にするかどうかと，キャンセル処理に対するサーバプログラムからの応答監視時間（待ち時間）を設定します。このプロパティは，値も取得できます。

形式

　　　　Object. ResponseLimit［＝ Time］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Time

キャンセル応答待ち時間を，次に示す数値（秒）で設定します。

数値（秒）

内容

0

非同期キャンセルしません。

1〜3600

非同期キャンセルの応答を待つ時間です。

使い方

キャンセル応答待ち時間とは，Cancelメソッドを実行してからサーバプログラムが応答するまでの待ち時間です。キャンセル応答待ち時間を超えてもサーバプログラムから応答がないときは，サーバ側で異常が起こったと判断して，Cancelメソッドがエラーになります。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

TargetDatabase プロパティ

機能

接続するデータベースを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TargetDatabase［＝ DB］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

DB

接続するデータベースを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpV3RD

0

VOS3 XDM/RD E2

dbpV3SD

1

VOS3 XDM/SD E2

dbpV3PDM

2

VOS3 PDMII E2

dbpV3USR

3

VOS3 ACE3ユーザファイル

dbpV3RDB1

4

VOS3 RDB1

dbpVKRDBF

5

VOSK RDB編成ファイル

dbpVKSPL

6

VOSKスプールファイル

dbpV1PDM

7

VOS1 PDMII E2

dbpV1USR

8

VOS1 ACE3ユーザファイル

dbpV1SPL

9

VOS1スプールファイル

使い方

このプロパティに設定したデータベースと実際に接続するデータベースが異なると，アプリケーションが正しく動作しないおそれがあります。

設定するデータベースと，TargetServerプロパティで設定するサーバプログラムには，組み合わせの規則があります。データベースとサーバプログラムの組み合わせを次に示します。

TargetDatabaseプロパティの設定

TargetServerプロパティの設定

dbpHoap

dbpAce3

dbpV3RD

○

×

dbpV3SD

○

×

dbpV3PDM

×

○

dbpV3USR

×

○

dbpV3RDB1

×

○

dbpVKRDBF

○

×

dbpVKSPL

○

×

dbpV1PDM

×

○

dbpV1USR

×

○

dbpV1SPL

×

○

（凡例）

○：有効な組み合わせです。

×：この組み合わせは設定できません。この組み合わせでプロパティを設定すると，Connectメソッドがエラーになります。

TargetServerプロパティ

機能

接続するサーバプログラムを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TargetServer［＝ SVR］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

SVR

接続するサーバプログラムを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpHoap

0

HOAPDBS E2又はHOAPDBS/PC

dbpAce3

1

ACE3 E3又はDBPARTNER/Link

使い方

このプロパティに設定したサーバプログラムと実際に接続するサーバプログラムが異なると，アプリケーションが正しく動作しないおそれがあります。

設定するサーバプログラムと，TargetDatabaseプロパティで設定するデータベースには，組み合わせの規則があります。データベースとサーバプログラムの組み合わせについては，TargetDatabaseプロパティの文法の説明を参照してください。

TerminalModeプロパティ

機能

CommuniNetの端末起動モードを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TerminalMode［＝ Mode］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Mode

CommuniNetの端末起動モードを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpHide

0

CommuniNetを非表示モードで起動します。

dbpIcon

1

CommuniNetを最小化モード（タスクバーのボタン表示）で起動します。

dbpShow

2

CommuniNetを表示モードで起動します。

使い方

dbpIcon又はdbpShowを設定すると，マクロスクリプトの実行過程をCommuniNetで確認できます。ただし，CommuniNetに直接キー入力するとサーバプログラムとの通信エラーが起こるおそれがあります。そのため，dbpIcon又はdbpShowはアプリケーションの動作を確認するためだけに使うようにして，通常はdbpHideを設定することをお勧めします。

端末起動モードは，アプリケーション起動後に初めてConnectメソッドを実行するときに参照されます。アプリケーションの起動中に端末起動モードを変更するときは，TerminalCloseメソッドを実行していったんCommuniNetを終了させてください。

TerminalNameプロパティ

機能

通信に使うCommuniNetの端末名を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TerminalName［＝ Name］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

Name

CommuniNetの端末名を，1〜14バイトの文字列で設定します。端末名は，省略できません。

使い方

端末名については，CommuniNetのマニュアル又はオンラインヘルプを参照してください。

端末名の値を変更してConnectメソッドを実行すると，現在起動しているCommuniNetを終了させて，新しく設定した端末名のCommuniNetが起動されます。

UserIDプロパティ

機能

サーバプログラムに接続するためのユーザIDを，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. UserID［= UID］

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

UID

ユーザIDを，0〜8バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

サーバプログラムと接続中（ConnectメソッドからDisconnectメソッドまでの間）は，UserIDプロパティの値を変更しても接続ユーザを変えることはできません。

Cancelメソッド（CancelExメソッド）

機能

サーバプログラムに対して実行中の処理をキャンセルします。

ビジュアル開発ツールの仕様によっては，メソッド名を「Cancel」と記述するとエラーになることがあります。このときは，メソッド名を「CancelEx」と記述してください。

形式

　　　　Object. Cancel　　又は　　Object. CancelEx

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

Cancelメソッドが有効になる範囲を次に示します。

QueryDefine.Executeメソッドを実行してから処理が終了するまで。

1回目のResult.Getメソッドを実行してから処理が終了するまで。

TableList.Getメソッドを実行してから処理が終了するまで。

ColumnList.Getメソッドを実行してから処理が終了するまで。

QueryDefine.QueryCountメソッドを実行してから処理が終了するまで。

UpdateDefine.Executeメソッドを実行してから処理が終了するまで。

Result.SaveToFileメソッドの実行からメソッドの処理終了まで。

Result.CopyToClipboardメソッドの実行からメソッドの処理終了まで。

中断する前に取得していたデータは，削除されます。

中断した処理の結果は保証されません。

Result.SaveToFileメソッド，Result.CopyToClipboardメソッドでファイル又はクリップボードにデータを出力中にCancelメソッドを実行すると，キャンセルしたデータまでをファイル又はクリップボードに出力されます。

AP開発ツールの仕様によっては，Cancelメソッドを記述するとエラーが発生することがあります。この場合，「CancelEx」と記述してください。

Commitメソッド

機能

サーバプログラムに対して実行したトランザクションを有効にして，トランザクションを終了します。

形式

　　　　Object. Commit

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

CommitModeプロパティにdbpAutoを設定しているときは，正常に処理が終わった時点で自動的にCommitメソッドが実行されるので，アプリケーションからCommitメソッドを実行する必要はありません。

CommitModeプロパティでdbpAutoを設定している状態でCommitメソッドを実行しても，無視されます（エラーにはなりません）。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Connectメソッド

機能

CommuniNetを起動して，LogonFileNameプロパティで設定したマクロスクリプトを実行します。マクロスクリプトの実行が正常に完了すると，サーバプログラムと接続します。

形式

　　　　Object. Connect

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

既にサーバプログラムと接続されている状態でConnectメソッドを実行すると，LogoffFileNameプロパティで設定したマクロスクリプトが実行されて，一度サーバプログラムとの接続を終了させた後，新たに接続処理が実行されます。

抽出処理の実行中は，Connectメソッドは使えません。使うとConnectメソッドがエラーになります。抽出処理の実行中とは，QueryDefine.Executeメソッドを実行してからデータの取得が完了するまで（又は，データの取得を中止してからCloseメソッドを実行するまで）のことです。

Connectメソッドで開始したサーバプログラムとの接続を終了させるには，TerminalCloseメソッドを使う方法とDisconnectメソッドを使う方法があります。

サーバプログラムとの接続の終了と一緒にCommuniNetも終了させるときは，TerminalCloseメソッドを使います。通常はTerminalCloseメソッドを使ってください。サーバプログラムとの接続を終了（TSSのログオフだけ）を実行するときは，Disconnectメソッドを使います。このとき，アプリケーションを終了させるときに，TerminalCloseメソッドを実行する必要があります。

Disconnectメソッド

機能

LogoffFileNameプロパティで設定したマクロスクリプトを実行します。マクロスクリプトの実行が正常に完了すると，サーバプログラムとの接続を解除します。

Disconnectメソッドは，サーバプログラムとの接続は終了するがCommuniNetは起動したままにしておくときに使います。CommuniNetを起動したままにしておくと，次回のConnectメソッドに掛かる時間が短縮されます。

サーバプログラムとの接続の終了と一緒にCommuniNetも終了させるときは，TerminalCloseメソッドを使ってください。

形式

　　　　Object. Disconnect

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

抽出処理の実行中は，Disconnectメソッドは使えません。使うとDisconnectメソッドがエラーになります。抽出処理の実行中とは，QueryDefine.Executeメソッドを実行してからデータの取得が完了するまで（又は，データの取得を中止してからCloseメソッドを実行するまで）のことです。

Connectメソッドが実行されていない状態でDisconnectメソッドを実行しても無視されます（エラーにはなりません）。

Rollbackメソッド

機能

サーバプログラムに対して実行したトランザクションを無効（QueryDefine.Executeメソッド，UpdateDefine.Executeメソッドを実行する前の状態）にして，トランザクションを終了します。

形式

　　　　Object. Rollback

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

CommitModeプロパティにdbpAutoを設定しているときは，エラーで処理が終わった時点で自動的にRollbackメソッドが実行されるので，アプリケーションからRollbackメソッドを実行する必要はありません。

CommitModeプロパティでdbpAutoを設定している状態でRollbackメソッドを実行しても，無視されます（エラーにはなりません）。

エラーになった時点までの更新処理を有効にするときは，CommitModeプロパティにdbpManualを設定してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

TerminalCloseメソッド

機能

Disconnectメソッドと同じ処理を実行した後，Connectメソッドで起動したCommuniNetを終了させます。

形式

　　　　Object. TerminalClose

パラメタ

Object

DBPARTNERオブジェクトへの参照を表すオブジェクト式です。

使い方

抽出処理の実行中は，TerminalCloseメソッドは実行しないでください。実行するとTerminalCloseメソッドがエラーになります。抽出処理の実行中とは，QueryDefine.Executeメソッド実行からデータの取得が完了するまで（又は，データの取得を中止してCloseメソッド実行まで）のことです。

Connectメソッドを実行していない状態でTerminalCloseメソッドを実行しても無視されます（エラーになりません）。

TerminalCloseメソッドは，サーバプログラムとの接続終了と一緒にCommuniNetも終了させます。サーバプログラムとの接続だけ終了させてCommuniNetを終了させたくないときは，Disconnectメソッドを使ってください。アプリケーションを終了するときは，必ずTerminalCloseメソッドを実行してCommuniNetも一緒に終了させてください。

サーバプログラムとの通信がエラーになったときは，TerminalCloseメソッドを実行してもCommuniNetが終了しないことがあります。このときは，CommuniNetの終了コマンドを使って終了させてください。

7.3　Resultオブジェクトの詳細

Resultオブジェクトは，QueryDefineオブジェクトで実行した抽出処理の結果として出力する抽出データを管理するオブジェクトです。

Resultオブジェクトのプロパティとメソッドの一覧を次に示します。

●Resultオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

DataCheck

○

○

抽出データの中の文字コードをチェックするかどうかを設定します。

EOF

−

○

データが取得できたかどうかを取得します。

FieldCount

−

○

抽出データの列数を返します。

FieldData

−

○

抽出データを1列単位で返します。

FieldDataLength

−

○

列のデータ長を返します。

FieldHeader

○

○

設定した列にヘッダを設定します。

HeaderOutput

○

○

抽出データの先頭行に列名を付けるかどうかを設定します。

QueryCountLimit

○

○

抽出処理の結果として出力する行数を，数値で設定します。

RecordData

−

○

抽出データを1行単位で返します。

RecordHeader

−

○

抽出処理の結果として出力される列名を，1行のテキスト形式で取得します。

●Resultオブジェクトのメソッドの一覧

メソッド

説明

Close

抽出処理を終了させます。

CopyToClipboard

抽出データをクリップボードに出力します。

Get

1行分のデータを要求します。

SaveToFile

抽出データをファイルに出力します。

DataCheckプロパティ

機能

抽出データの中に文字コード以外のデータがあったときに，エラーを返すかどうかを設定します。このプロパティは，値も取得できます。

文字コード以外のデータと判定するデータを，次に示します。

1バイト文字でX'20'〜X'7E'，又はX'A1'〜X'DF'以外の文字。

2バイト文字で1バイト目が，X'81'〜X'9F'，又はX'E0'〜X'FC'以外の文字。

2バイト文字で2バイト目が，X'40'〜X'7E'，又はX'80'〜X'FC'以外の文字。

形式

　　　　Object. DataCheck［= CheckMode］

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

CheckMode

文字コードをチェックするかどうかを，次に示す定数で設定します。

定数

内容

FALSE

文字コードをチェックしません。

TRUE

文字コード以外のデータがあるときは，エラーを返します。

使い方

DataCheckプロパティの値は，QueryDefine.Executeメソッドを実行するときに使われます。QueryDefine.Executeメソッドを実行した後でDataCheckプロパティの値を変更しても，Result.Getメソッドの結果を変えることはできません。

EOFプロパティ

機能

直前に実行したResult.Getメソッドでデータが取得できたかどうかを，BOOLEAN値で取得します。

形式

　　　　Object. EOF

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

戻り値

定数

内容

FALSE（偽）

データを読み込みました。

TRUE（真）

読み込むデータがありません。

使い方

EOFプロパティは，データの最後を知るために使います。Result.Getメソッドの次にEOFプロパティを実行すると，すべての抽出データを取得し終えたかどうかを判断できます。EOFプロパティがTRUEを返したときは，直前のResult.Getメソッドで読み込むデータがなかったことが分かります。

FieldCountプロパティ

機能

抽出データの列数を，数値で取得します。

形式

　　　　Object. FieldCount

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

QueryDefine.Executeメソッドを実行する前は，0を返します。

FieldDataプロパティ

機能

列番号で設定した列のデータを取得します。

形式

　　　　Object. FieldData（Index）

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

使い方

列番号は，QueryDefine.Executeメソッドを実行した後で，FieldCountプロパティで得られた列数の範囲内で指定してください。

QueryDefine.Executeメソッドを実行する前にFieldDataプロパティを使うと，エラーになります。

FieldDataLengthプロパティ

機能

列番号で設定した列のデータ長を，数値で取得します。

形式

　　　　Object. FieldDataLength（Index）

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

使い方

列番号は，QueryDefine.Executeメソッドを実行した後，FieldCountプロパティで得られた列数の範囲内で設定してください。

QueryDefine.Executeメソッドを実行する前にFieldDataLengthプロパティを使うと，エラーになります。

FieldHeaderプロパティ

機能

列番号で設定した列にヘッダを，数値と文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. FieldHeader（Index）［= String］

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜FieldCountプロパティの範囲内で設定します。

String

列に付けるヘッダを，0〜256バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

列番号は，QueryDefine.Executeメソッドを実行した後，FieldCountプロパティで得られた列数の範囲内で設定してください。

QueryDefine.Executeメソッドを実行する前にFieldHeaderプロパティを使うと，エラーになります。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

HeaderOutputプロパティ

機能

SaveToFileメソッド，CopyToClipboardメソッドを使うときに，抽出データの先頭行にヘッダを付けるかどうかを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. HeaderOutput［= HeaderMode］

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

HeaderMode

ヘッダを付けるかどうかを，次に示す定数で設定します。

定数

内容

FALSE

抽出データにヘッダを付けません。

TRUE

抽出データの1行目にヘッダを付けます。

使い方

HeaderOutputプロパティの値は，SaveToFileメソッド又はCopyToClipboardメソッドを実行するときに使われます。SaveToFileメソッド又はCopyToClipboardメソッドを実行した後でHeaderOutputプロパティの値を変更しても，SaveToFileメソッド又はCopyToClipboardメソッドの結果を変えることはできません。

ヘッダが設定されていない列は，列名を出力します。

QueryCountLimitプロパティ

機能

抽出処理の結果として出力する行数を，数値で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. QueryCountLimit［= Number］

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Number

抽出する行数の制限値を，次に示す数値で設定します。

数値

内容

0

行数は制限しません。

1〜999,999,999

設定した行数まで，データを取得します。

使い方

QueryCountLimitプロパティの値は，QueryDefine.Executeメソッドを実行するときに使われます。QueryDefine.Executeメソッドを実行した後でQueryCountLimitプロパティの値を変更しても，Result.Getメソッドの結果を変えることはできません。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

RecordDataプロパティ

機能

Result.Getメソッドで取得した1レコード単位の抽出データを，文字列で取得します。取得する文字列は，1行のテキスト形式になっています。

形式

　　　　Object. RecordData

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

テキストデータのフォーマットについては，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

データは，Result.Getメソッドを実行するときに更新されます。

QueryDefine.Executeメソッドを実行する前にRecordDataプロパティを使うと，エラーになります。

RecordHeaderプロパティ

機能

抽出処理の結果として出力される列名を，文字列で取得します。取得する文字列は，1行のテキスト形式になっています。

形式

　　　　Object. RecordHeader

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

テキスト形式のフォーマットについては，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

QueryDefine.Executeメソッドを実行する前にRecordHeaderプロパティを使うと，エラーになります。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Closeメソッド

機能

抽出処理を終了させます。

形式

　　　　Object. Close

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

EOFプロパティがFALSEの状態でほかの処理に移りたいときは，必ずCloseメソッドを実行してください。

Closeメソッドを連続して実行しても，不要なCloseメソッドは無視されます（エラーにはなりません）。

CopyToClipboardメソッド

機能

抽出データを，設定した形式でクリップボードに出力します。

形式

　　　　Object. CopyToClipboard（Type）

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

Type

出力するデータの形式を，次に示す定数又は数値で設定します。

定数

数値

内容

dbpTextFormat

0

TEXT形式

dbpBiff4Format

1

Excel 4.0形式

dbpOleBiff8Format

4

Excel 97-2000ブック形式

使い方

データの形式については，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

QueryDefine.Executeメソッドを実行する前にCopyToClipboardプロパティを使うと，エラーになります。

Cancelメソッドを実行して処理を中止すると，Cancelメソッドまでのデータをクリップボードに出力します。

CopyToClipboardメソッドがエラーになったときは，クリップボードの内容は保証されません。

Getメソッド

機能

サーバプログラムに対して1行分のデータを要求します。

形式

　　　　Object. Get

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

使い方

データを取得するときは，RecordDataプロパティとFieldDataプロパティを使います。

Result.Getメソッドを実行した後には，EOFプロパティで取得状況を確認してください。

QueryDefine.Executeメソッドを実行する前にResult.Getメソッドを使うと，エラーになります。

1回目のResult.Getメソッドが成功した以降でデータの取得を中止するときは，Closeメソッドを使ってください。Cancelメソッドでは，データの取得を中止できません。

SaveToFileメソッド

機能

抽出データを，設定した形式でファイルに出力します。

形式

　　　　Object. SaveToFile FileName，Type

パラメタ

Object

Resultオブジェクトへの参照を表すオブジェクト式です。

FileName

抽出データを出力するファイル名を，1〜256バイトの文字列で設定します。値はクリアできません。

Type

出力するデータの形式を，次に示す定数又は数値で設定します。

定数

数値

内容

dbpTextFormat，dbpTextFile

0

TEXT形式

dbpBiff4Format，dbpBiff4File

1

Excel 4.0形式

dbpCSVFile

2

CSV形式

dbpDATFile

3

DAT形式

dbpOleBiff8File

4

Excelオブジェクトで作成するExcel 97-2003ブック形式（XLS形式）

dbpOleBiff12File

5

Excelオブジェクトで作成するExcel 2007バイナリファイル形式（XLSB形式）

dbpOleXMLWorkbookFile

6

Excelオブジェクトで作成するExcel 2007XMLファイル形式（XLSX形式）

使い方

データの形式については，「付録C　DBPARTNER2 Clientが扱うデータの形式」を参照してください。

QueryDefine.Executeメソッドを実行する前にSaveToFileプロパティを使うと，エラーになります。

Cancelメソッドを実行して処理を中止すると，Cancelメソッドまでのデータをファイルに出力します。

SaveToFileメソッドがエラーになったときは，出力されたデータの内容は保証されません。

7.4　TableListオブジェクトの詳細

TableListオブジェクトは，設定したデータソースに格納されている表一覧情報を取得したり，取得した結果を管理したりします。それぞれの表情報は，プロパティによって返されます。

TableListオブジェクトのプロパティとメソッドの一覧を次に示します。

●TableListオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

取得した表情報の個数を取得します。

CountLimit

○

○

取得したい表情報の個数を設定します。

SelectDict

○

○

接続先をキーに，使用する見出し辞書を限定します。

Pattern

○

○

表情報の絞り込み条件を文字列で設定します。

TableComment

−

○

設定した表の注釈を文字列で取得します。

TableCreateDate

−

○

設定した表の作成日時を文字列で取得します。

TableDataSource

−

○

設定した表の見出し辞書中の接続先を文字列で取得します。

TableDBMName

−

○

設定した表のDBM名を文字列で取得します。

TableDeleteAuth

−

○

設定した表のデータに対する削除権限があるかどうかを取得します。

TableGroupName

−

○

設定した表のグループ名を文字列で取得します。

TableHeader

−

○

設定した表のラベルを，文字列で取得します。

TableInsertAuth

−

○

設定した表のデータに対する追加権限があるかどうかを取得します。

TableName

−

○

設定した表の表名を文字列で取得します。

TableOwner

−

○

設定した表の所有者を文字列で取得します。

TablePasswordMode

−

○

設定した表の表パスワードの種別を取得します。

TableSelectAuth

−

○

設定した表のデータに対する検索権限があるかどうかを取得します。

TableType

−

○

設定した表の属性を文字列で取得します。

TableUpdateAuth

−

○

設定した表のデータに対する変更権限があるかどうかを取得します。

●TableListオブジェクトのメソッドの一覧

メソッド

説明

Get

表情報の取得を要求します。

Countプロパティ

機能

取得した表情報の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

使い方

TableList.Getメソッドを実行する前は，0を返します。

CountLimitプロパティ

機能

取得する表情報の最大数を，数値で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. CountLimit［= max］

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

max

取得する表の制限数を，次に示す数値で設定します。

数値

内容

0

すべての表の情報を取得します。

1〜8192

設定した数だけ，表の情報を取得します。

使い方

CountLimitプロパティの値は，TableList.Getメソッドを実行するときに使われます。TableList.Getメソッドを実行した後でCountLimitプロパティの値を変更しても，TableList.Getメソッドの結果を変えることはできません。

SelectDictプロパティ

機能

接続先をキーに，使用する見出し辞書を限定します。このプロパティは，値の取得もできます。

形式

　　　　Object. SelectDict = DataSource

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

DataSource

接続先を0〜32バイトの文字列で設定します。0バイトの文字列も設定できます。

使い方

接続先には，TableList.TableDataSourceプロパティと同じ文字列を設定してください。

接続先が見出し辞書にない場合，TableList.Countプロパティが0となります。

Patternプロパティ

機能

表情報を取得するときの絞り込み条件を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. Pattern［= text］

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

text

絞り込み条件を，0〜128バイトの文字列で設定します。文字列には，ワイルドカード（?，*）文字を含めることができます。値をクリアするときは，長さ0の文字列を設定します。絞り込み条件は，次の書式で設定してください。

所有者名.表名

表名

使い方

値がクリアされているときは，*.* が仮定されます。

「?」（クエスチョンマーク文字）は何らかの単一文字を示します。

「*」（アスタリスク文字）は何らかのゼロ個以上の文字のつながりを示します。

使える絞り込み条件を次に示します。

前方一致（例：ABC*）文字列の先頭がABCであり，以降の文字は任意です。

後方一致（例：*ABC）文字列の最後がABCであり，以前の文字は任意です。

任意一致（例：*ABC*）文字列中の任意の部分がABCです。

完全一致（例：ABC）文字列がABCと同じです。

部分一致（例：?ABC?）5文字の文字列のうち，2〜4文字目がABCです。

　　　　（例：A?B*C）文字列の先頭がA，3文字目がB，最後がCです。

Patternプロパティの値は，TableList.Getメソッドを実行するときに使われます。TableList.Getメソッドを実行した後でPatternプロパティの値を変更しても，TableList.Getメソッドの結果を変えることはできません。

TableCommentプロパティ

機能

表番号で設定した表の注釈を，文字列で取得します。

形式

　　　　Object. TableComment（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

接続するサーバプログラムやデータベースによって，返される文字列が異なります。返される文字列については，「8.4　データベース別の規則」を参照してください。

TableCreateDateプロパティ

機能

表番号で指定した表の作成日付を，文字列で取得します。

形式

　　　　Object. TableCreateDate（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

接続するサーバプログラムやデータベースによって，返される文字列が異なります。返される文字列については，「8.4　データベース別の規則」を参照してください。

TableDataSourceプロパティ

機能

表番号で設定した表の見出し辞書の中の接続先を，文字列で取得します。

形式

　　　　Object. TableDataSource（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getプロパティを発行した後，TableList.Countプロパティで取得した表の数の範囲内で設定してください。

TableDBMNameプロパティ

機能

表番号で指定した表のDBM名を，文字列で取得します。

形式

　　　　Object. TableDBMName（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

TableDeleteAuthプロパティ

機能

表番号で指定した表のデータに対して削除権限があるかどうかを，BOOLEAN値で取得します。

形式

　　　　Object. TableDeleteAuth（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

戻り値

定数

内容

TRUE（真）

データを削除する権限があります。

FALSE（偽）

データを削除する権限がありません。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

TableGroupNameプロパティ

機能

表番号で指定した表のグループ名を，文字列で取得します。

形式

　　　　Object.TableGroupName(Index)

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表を数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

TableDefSourceプロパティにdbpDICTを設定している場合，見出し辞書のグループ名を返します。

TableDefSourceプロパティにdbpDBDICTを設定している場合，見出し辞書の中に異なる接続先で同一の表名があるときはTableList.SelectDictプロパティで接続先を設定してください。TableList.SelectDictプロパティで接続先を設定しないと，正しいラベルが取得できないことがあります。

TableHeaderプロパティ

機能

表番号で設定した表のラベルを，文字列で取得します。

形式

　　　　Object. TableHeader（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

TableDefSourceプロパティにdbpDICT，又はdbpDBDICTを設定している場合，見出し辞書のラベルを返します。

TableDefSourceプロパティにdbpDBDICTを設定している場合，見出し辞書の中に異なる接続先で同一の表名があるときはTableList.SelectDictプロパティで接続先を設定してください。TableList.SelectDictプロパティで接続先を設定しないと，正しいラベルが取得できないことがあります。

接続するサーバプログラムやデータベースによって，返される文字列が異なります。返される文字列については，「8.4　データベース別の規則」を参照してください。

TableInsertAuthプロパティ

機能

表番号で指定した表のデータに対して追加権限があるかどうかを，BOOLEAN値で取得します。

形式

　　　　Object. TableInsertAuth（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

戻り値

定数

内容

TRUE（真）

データを追加する権限があります。

FALSE（偽）

データを追加する権限がありません。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

TableNameプロパティ

機能

表番号で設定した表の表名を，文字列で取得します。

形式

　　　　Object. TableName（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

接続するサーバプログラムやデータベースによって，返される文字列が異なります。返される文字列については，「8.4　データベース別の規則」を参照してください。

TableOwnerプロパティ

機能

表番号で設定した表の所有者を，文字列で取得します。

形式

　　　　Object. TableOwner（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

接続するサーバプログラムやデータベースによって，返される文字列が異なります。返される文字列については，「8.4　データベース別の規則」を参照してください。

TablePasswordModeプロパティ

機能

表番号で指定した表の表パスワードの種別を，数値で取得します。

形式

　　　　Object. TablePasswordMode（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

戻り値

次に示す定数又は数値で取得します。

定数

数値

内容

dbpNoPassword

0

表パスワードは設定されていません。

dbpSPassword

1

参照パスワードが設定されています。

dbpUPassword

2

更新パスワードが設定されています。

dbpSUPassword

3

参照パスワードと更新パスワードが設定されています。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

表パスワードの種別は，実際に表に設定されているパスワードと，表に対する権限で決まります。パスワードと権限の関係と返される表パスワードの種別の対応を次に示します。

パスワード設定状況

参照権限がある表

更新権限がある表

参照／更新の両方の権限がある表

パスワード設定なし

dbpNoPassword

dbpNoPassword

dbpNoPassword

参照パスワードだけ設定

dbpSPassword

dbpNoPassword

dbpSPassword

更新パスワードだけ設定

dbpNoPassword

dbpUPassword

dbpUPassword

両方のパスワードが設定

dbpSPassword

dbpUPassword

dbpSUPassword

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

TableSelectAuthプロパティ

機能

表番号で指定した表のデータに対して検索権限があるかどうかを，BOOLEAN値で取得します。

形式

　　　　Object. TableSelectAuth（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

戻り値

定数

内容

TRUE（真）

データを抽出する権限があります。

FALSE（偽）

データを抽出する権限がありません。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

TableTypeプロパティ

機能

表番号で設定した表の属性を，文字列で取得します。

形式

　　　　Object. TableType（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

使い方

表番号は，TableList.Getメソッドを実行した後で，TableList.Countプロパティで得られた表数の範囲内で設定してください。

表属性には，"TABLE"又は"VIEW"の表属性があります。

属性が "TABLE"又は"VIEW"以外のときは，1文字の空白文字が返されます。

VOSK RDB編成ファイルの併合論理ファイル，連鎖論理ファイル，射影論理ファイル，結合論理ファイルは，"VIEW"として返されます。

TableUpdateAuthプロパティ

機能

表番号で指定した表のデータに対して変更権限があるかどうかを，BOOLEAN値で取得します。

形式

　　　　Object. TableUpdateAuth（Index）

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の表の表番号を，数値で設定します。番号は，1〜TableList.Countプロパティの範囲内で設定します。

戻り値

定数

内容

TRUE（真）

データを変更する権限があります。

FALSE（偽）

データを変更する権限がありません。

使い方

表番号は，TableList.Getメソッドを実行した後，TableList.Countプロパティで得られた表数の範囲内で設定してください。

Getメソッド

機能

サーバプログラムに定義されている表情報を要求します。

形式

　　　　Object. Get

パラメタ

Object

TableListオブジェクトへの参照を表すオブジェクト式です。

使い方

このメソッドを実行すると，前回TableList.Getメソッドで取得した表の情報は上書きされます。

7.5　ColumnListオブジェクトの詳細

ColumnListオブジェクトは，設定された表名に定義されている列一覧情報を取得したり，取得した結果を管理したりします。それぞれの列情報は，プロパティによって返されます。

ColumnListオブジェクトのプロパティとメソッドの一覧を次に示します。

●ColumnListオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

ColumnComment

−

○

設定した列の注釈を文字列で取得します。

ColumnEditPattern

−

○

設定した列の編集形式を文字列で取得します。

ColumnHeader

−

○

設定した列のラベルを文字列で取得します。

ColumnLength

−

○

設定した列の定義長を数値で取得します。

ColumnName

−

○

設定した列の列名を文字列で取得します。

ColumnNumber

−

○

設定した列の列番号を文字列で取得します。

ColumnScale

−

○

設定した列の小数点以下のけた数を数値で取得します。

ColumnType

−

○

設定した列の属性を取得します。

Count

−

○

取得した列の個数を取得します。

CountLimit

○

○

列情報を取得する個数を設定します。

SelectDict

○

○

接続先をキーに使用する見出し辞書を限定します。

TableName

○

○

列情報を取得したい表名を，文字列で設定します。

TablePassword

○

○

表に定義されているパスワードを設定します。

●ColumnListオブジェクトのメソッドの一覧

メソッド

説明

Get

列情報の取得を要求します。

ColumnCommentプロパティ

機能

列番号で設定した列の注釈を，文字列で取得します。

形式

　　　　Object. ColumnComment（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

接続するサーバプログラムやデータベースによって，返される文字列が異なります。返される文字列については，「8.4　データベース別の規則」を参照してください。

ColumnEditPatternプロパティ

機能

列番号で指定した列の編集形式を，文字列で取得します。

形式

　　　　Object. ColumnEditPattern（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

取得した編集形式の内容については，ACE3のマニュアルを参照してください。

ColumnHeaderプロパティ

機能

列番号で設定した列のラベルを，文字列で取得します。

形式

　　　　Object. ColumnHeader（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

TableDefSourceプロパティにdbpDICT，又はdbpDBDICTを設定している場合，見出し辞書のラベルを返します。

TableDefSourceプロパティにdbpDBDICTを設定している場合，見出し辞書の中に異なる接続先で同一の表名があるときはTableList.SelectDictプロパティで接続先を設定してください。TableList.SelectDictプロパティで接続先を設定しないと，正しいラベルが取得できないことがあります。

接続するサーバプログラムやデータベースによって，返される文字列が異なります。返される文字列については，「8.4　データベース別の規則」を参照してください。

ColumnLengthプロパティ

機能

列番号で設定した列の定義長を，数値で取得します。

形式

　　　　Object. ColumnLength（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

ColumnNameプロパティ

機能

列番号で設定した列の列名を，文字列で取得します。

形式

　　　　Object. ColumnName（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

接続するサーバプログラムやデータベースによって，返される文字列が異なります。返される文字列については，「8.4　データベース別の規則」を参照してください。

ColumnNumberプロパティ

機能

列番号で設定した列の列番号を，数値で取得します。

形式

　　　　Object. ColumnNumber（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

繰り返し列の列番号は，同じ番号になります。

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

ColumnScaleプロパティ

機能

列番号で設定した列の小数点以下のけた数を，数値で取得します。

形式

　　　　Object. ColumnScale（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

ColumnTypeプロパティ

機能

列番号で設定した列の属性を，数値で取得します。

形式

　　　　Object. ColumnType（Index）

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の列の列番号を，数値で設定します。番号は，1〜ColumnList.Countプロパティの範囲内で設定します。

使い方

属性については，「付録E　列の属性」を参照してください。

列番号は，ColumnList.Getメソッドを実行した後，ColumnList.Countプロパティで得られた列数の範囲内で設定してください。

Countプロパティ

機能

取得した列情報の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

使い方

ColumnList.Getメソッドを実行する前は，0を返します。

CountLimitプロパティ

機能

取得する列情報の最大数を，数値で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. CountLimit［= max］

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

max

取得する列数を，次に示す数値で設定します。

数値

内容

0

すべての列を取得します。

1〜8192

設定した数だけ，列の情報を取得します。

使い方

CountLimitプロパティの値は，ColumnList.Getメソッドを実行するときに使われます。ColumnList.Getメソッドを実行した後でCountLimitプロパティの値を変更しても，ColumnList.Getメソッドの結果を変えることはできません。

SelectDictプロパティ

機能

接続先をキーに使用する見出し辞書を限定します。このプロパティは，値の取得もできます。

形式

　　　　Object. SelectDict = DataSource

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

DataSource

接続先を0〜32バイトの文字列で設定します。0バイトの文字列も設定できます。

使い方

接続先には，TableList.TableDataSourceプロパティと同じ文字列を設定してください。

接続先が見出し辞書にない場合，TableList.Countプロパティが0となります。

TableNameプロパティ

機能

列情報を取得したい表名を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TableName［= text］

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

text

表名を，1〜128バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

設定する表名の書式については，「8.1.2　表名を設定するときの規則」を参照してください。

TableNameプロパティの値は，ColumnList.Getメソッドを実行するときに使われます。ColumnList.Getメソッドを実行した後でTableNameプロパティの値を変更しても，ColumnList.Getメソッドの結果を変えることはできません。

TablePasswordプロパティ

機能

表にアクセスするパスワードを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TablePassword［＝ Pass］

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

Pass

表パスワードを，0〜8バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

半角文字の「（ 」，「 ）」，又は全角文字は設定できません。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Getメソッド

機能

ColumnList.TableNameプロパティで設定した表に含まれる列情報の取得を要求します。

形式

　　　　Object. Get

パラメタ

Object

ColumnListオブジェクトへの参照を表すオブジェクト式です。

使い方

このメソッドを実行すると，前回ColumnList.Getメソッドで取得した列の情報は上書きされます。

7.6　QueryDefineオブジェクトの詳細

QueryDefineオブジェクトは，抽出処理を実行するオブジェクトです。抽出処理の結果として出力する抽出データは，Resultオブジェクトで取得します。

QueryDefineオブジェクトのプロパティとメソッドの一覧を次に示します。

●QueryDefineオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Exclusive

○

○

抽出処理を実行するときの排他モードを，文字列で設定します。

●QueryDefineオブジェクトのメソッドの一覧

メソッド

説明

Execute

抽出処理を実行します。

QueryCount

抽出処理の結果として出力される行数を，数値で取得します。

RemoveAll

すべてのTable，Column，Conditionオブジェクトをクリアします。

Exclusiveプロパティ

機能

抽出する表をほかのユーザが使っているときの動作を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. Exclusive［= String］

パラメタ

Object

QueryDefineオブジェクトへの参照を表すオブジェクト式です。

String

排他オプションを，次に示す 0〜64バイトの文字列で設定します。

文字列

内容

長さ0バイトの文字列

"WITH SHARE LOCK"の説明を参照してください。

"WITH SHARE LOCK"

一度検索した内容を，トランザクション終了まで，ほかのユーザからの参照は許しますが，更新は許しません。

"WITH EXCLUSIVE LOCK"

一度検索した内容を，トランザクション終了まで，ほかのユーザからの参照も更新も許しません。

"WITHOUT LOCK WAIT"

一度検索した内容を，トランザクション終了まで，排他制御しません。

"WITHOUT LOCK NOWAIT"

ほかのユーザが更新中のデータでも，更新の完了を待たないで参照して，一度検索した内容をトランザクション終了まで排他制御しません。

"WITH ROLLBACK"

検索の対象になる表をほかのユーザが使っているときは，トランザクションを取り消して無効にします。

排他オプションの文字列については，各データベースのマニュアルを参照してください。

使い方

Exclusiveプロパティの値は，QueryDefine.Executeメソッドを実行するときに使われます。QueryDefine.Executeメソッドを実行した後でExclusiveプロパティの値を変更しても，QueryDefine.Executeメソッドの結果を変えることはできません。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Executeメソッド

機能

データベースに抽出条件を渡して，検索を実行します。

形式

　　　　Object. Execute

パラメタ

Object

QueryDefineオブジェクトへの参照を表すオブジェクト式です。

使い方

検索したデータは，Resultオブジェクトを使って取得します。

結果取得を完了させないで再びQueryDefine.Executeメソッドを実行すると，エラーになります。

検索した結果，抽出データがないときは，エラーが返されます。

QueryCountメソッド

機能

抽出条件に一致するデータの件数を，数値で取得します。

形式

　　　　Object. QueryCount

パラメタ

Object

QueryDefineオブジェクトへの参照を表すオブジェクト式です。

使い方

QueryCountLimitプロパティの設定内容には依存しません。

FunctionModeプロパティで抽出列に集合関数を設定しているときは，件数を取得しようとするとエラーになります。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

RemoveAllメソッド

機能

すべてのTable，Column，Conditionオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

QueryDefineオブジェクトへの参照を表すオブジェクト式です。

7.7　Tablesコレクションオブジェクトの詳細

Tablesコレクションオブジェクトは，Tableオブジェクトをリストオブジェクトとして管理します。

Tablesコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Tablesコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

抽出表の個数を数値で取得します。

●Tablesコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

抽出表を文字列で追加します。

Item

Tableオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのTableオブジェクトをクリアします。

Countプロパティ

機能

抽出条件として設定されている表の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Tablesコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

抽出条件にする表名を，文字列で追加します。

形式

　　　　Object. Add（String）

パラメタ

Object

Tablesコレクションオブジェクトへの参照を表すオブジェクト式です。

String

抽出条件にする表の表名を，1〜128バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

設定する表名の書式については，「8.1.2　表名を設定するときの規則」を参照してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Itemメソッド

機能

Tableオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Tablesコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的の抽出表番号（Tableオブジェクトの番号）を，数値で設定します。番号は，1〜Tables.Countプロパティの範囲内で設定します。

RemoveAllメソッド

機能

すべてのTableオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Tablesコレクションオブジェクトへの参照を表すオブジェクト式です。

7.8　Tableオブジェクトの詳細

Tableオブジェクトは，抽出表を管理するオブジェクトです。

Tableオブジェクトのプロパティの一覧を次に示します。Tableオブジェクトのメソッドはありません。

●Tableオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

TableName

○

○

抽出表として設定されている文字列を設定します。

TablePassword

○

○

表に定義されているパスワードを設定します。

TableNameプロパティ

機能

抽出条件にする表名を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TableName［= String］

パラメタ

Object

Tableオブジェクトへの参照を表すオブジェクト式です。

String

抽出する表の表名を，1〜128バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

設定する表名の書式については，「8.1.2　表名を設定するときの規則」を参照してください。

TablePasswordプロパティ

機能

表パスワードを，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TablePassword［= Pass］

パラメタ

Object

Tableオブジェクトへの参照を表すオブジェクト式です。

Pass

更新のパスワードを，0〜8バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

半角文字の「（ 」，「 ）」，又は全角文字は指定できません。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

7.9　Columnsコレクションオブジェクトの詳細

Columnsコレクションオブジェクトは，Columnオブジェクトをリストオブジェクトとして管理します。

Columnsコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Columnsコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

抽出列の個数を数値で返します。

●Columnsコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

抽出列を文字列で追加します。

Item

Columnオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのColumnオブジェクトをクリアします。

Countプロパティ

機能

抽出列の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Columnsコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

抽出列の列名を，文字列で追加します。

形式

　　　　Object. Add（String）

パラメタ

Object

Columnsコレクションオブジェクトへの参照を表すオブジェクト式です。

String

抽出列を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Itemメソッド

機能

Columnオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Columnsコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的の抽出列の番号（Columnオブジェクトの番号）を，数値で設定します。番号は，1〜Columns.Countプロパティの範囲内で設定します。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

RemoveAllメソッド

機能

すべてのColumnオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Columnsコレクションオブジェクトへの参照を表すオブジェクト式です。

7.10　Columnオブジェクトの詳細

Columnオブジェクトは，抽出列を管理するオブジェクトです。

Columnオブジェクトのプロパティの一覧を次に示します。Columnオブジェクトのメソッドはありません。

●Columnオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

ColumnName

○

○

抽出列の列名を設定します。

FunctionMode

○

○

抽出列に集合関数を設定します。

SortMode

○

○

抽出列にソートを設定します。

SortPriority

○

○

ソートを設定した列の優先順位を設定します。

ColumnNameプロパティ

機能

抽出列とする列名を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. ColumnName［= String］

パラメタ

Object

Columnオブジェクトへの参照を表すオブジェクト式です。

String

抽出列名を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

FunctionModeプロパティ

機能

抽出列に集合関数を設定します。このプロパティは，値も取得できます。

形式

　　　　Object. FunctionMode［= mode］

パラメタ

Object

Columnオブジェクトへの参照を表すオブジェクト式です。

mode

集合関数を，次に示す定数又は数値で設定します。

定数

数値

内容

dbpNormal，dbpNoFunction

0

集合関数なし

dbpGroup

1

重複排除

dbpMaximum

2

最大

dbpMinimum

3

最小

dbpCount

4

件数

dbpAverage

5

平均

dbpSum

6

合計

使い方

抽出列のどれかに集合関数を付けると，集合関数を設定していない抽出列に「重複排除」が仮定されて，抽出処理が実行されます。ただし，集合関数を設定していない抽出列の集合関数の値は変更されません。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

SortModeプロパティ

機能

抽出列をソートするかどうかを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. SortMode［= mode］

パラメタ

Object

Columnオブジェクトへの参照を表すオブジェクト式です。

mode

ソートするかどうかを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpNormal，dbpNoSort

0

データをソートしません。

dbpAscend

1

データを昇順にソートします。

dbpDescend

2

データを降順にソートします。

使い方

複数の列にソートを設定したときは，優先するソートを決める必要があります。どの列のソートが優先されるかは，SortModeプロパティの実行順に従います。つまり，最初に設定されたソートが最優先になります。二つめ以降を設定するときには，現在設定されているソートの中で最も低い優先順位の次の順位が割り当てられます。

優先順位を参照又は変更したいときは，SortPriorityプロパティを使ってください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

SortPriorityプロパティ

機能

ソートが設定されている抽出列の優先順位を，数値で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. SortPriority［= number］

パラメタ

Object

Columnオブジェクトへの参照を表すオブジェクト式です。

number

ソートの優先順位を，1〜255の値で設定します。

使い方

SortPriorityプロパティで優先順位を設定できる列は，SortModeプロパティでソートを設定した列だけです。ソートが設定されていない列には設定できません。

ソート優先順位の値が小さいほど，優先順位が高くなります。

優先順位の値を重複させると，同一番号内での順位は保証されません。

優先順位は，連続している値を設定する必要はありません。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

7.11　Conditionsコレクションオブジェクトの詳細

Conditionsコレクションオブジェクトは，Conditionオブジェクトをリストオブジェクトとして管理します。

Conditionsコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Conditionsコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

抽出条件式の個数を取得します。

Relation

○

○

条件関連を文字列で設定します。

●Conditionsコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

抽出条件式を文字列で追加します。

Item

Conditionオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのConditionオブジェクトをクリアします。

Countプロパティ

機能

抽出条件式の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

Relationプロパティ

機能

複数の抽出条件式の関連を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. Relation［= string］

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

string

抽出条件式を関連させる条件を，0〜1,024バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

抽出条件式の関係は，抽出条件式番号を使って設定します。値をクリアすると，すべての抽出条件式はANDで関連付けられます。

条件はすべて半角文字で設定して，AND，OR，及びNOTの前後にはスペースを入力してください。

AND，and：論理積を示します。

「1 AND 2」は，条件式1と条件式2の両方を満たすデータの抽出を設定します。

OR ，or ：論理和を示します。

「1 OR 2」は，条件式1か条件式2のどちらかを満たすデータの抽出を設定します。

NOT，not：否定を示します。

「NOT 1」は，条件式1を満たさないデータの抽出を設定します。

（ ）：括弧内の条件を優先します。

「1 AND（2 OR 3）」は，条件式2か条件式3のどちらかを満たして，かつ条件式1を満たすデータの抽出を設定します。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Addメソッド

機能

抽出データを絞り込むための条件式を，文字列で追加します。

形式

　　　　Object. Add（String）

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

String

抽出条件式を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

代表的な抽出条件式を次に示します。

列名C1のデータがNULL値の行を抽出する（NULL述語）

"C1" IS NULL

列名C2のデータが10，20，30の行を抽出する（IN述語）

"C2" IN（10，20，30）

列名C3のデータがABCから始まる行を抽出する（LIKE述語）

"C3" LIKE 'ABC%'

列名C4のデータが10から50の範囲内にある行を抽出する（BETWEEN述語）

"C4" BETWEEN 10 AND 50

列名C5のデータが100の行を抽出する（比較条件）

"C5" = 100

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Itemメソッド

機能

Conditionオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的の抽出条件式の番号（Conditionオブジェクトの番号）を，数値で設定します。番号は，1〜Conditions.Countプロパティの範囲内で設定します。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

RemoveAllメソッド

機能

すべてのConditionオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Conditionsコレクションオブジェクトへの参照を表すオブジェクト式です。

7.12　Conditionオブジェクトの詳細

Conditionオブジェクトは，Select文を生成するための情報になる条件情報を管理します。条件一つに付き，一つのConditionオブジェクトが対応します。

Conditionオブジェクトのプロパティの一覧を次に示します。Conditionオブジェクトのメソッドはありません。

●Conditionオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Text

○

○

抽出条件式を設定します。

Textプロパティ

機能

抽出データを絞り込むための条件式を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. Text［= String］

パラメタ

Object

Conditionオブジェクトへの参照を表すオブジェクト式です。

String

抽出の条件式を，1〜256バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

7.13　UpdateDefineオブジェクトの詳細

UpdateDefineオブジェクトは，更新処理を実行するオブジェクトです。

UpdateDefineオブジェクトのプロパティとメソッドの一覧を次に示します。

●UpdateDefineオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

ErrorInformation

−

○

更新処理でエラーになったオブジェクトの番号を取得します。

Exclusive

○

○

抽出処理を実行するときの排他モードを，文字列で設定します。

ExecutedRowCount

−

○

更新処理の結果，サーバプログラムで更新した行数を取得します。

TableName

○

○

更新表を設定します。

TablePassword

○

○

表に定義されているパスワードを設定します。

UpdateMode

○

○

更新実行モードを設定します。

●UpdateDefineオブジェクトのメソッドの一覧

メソッド

説明

Execute

更新処理を実行します。

RemoveAll

すべてのUpdate，Insert，Deleteオブジェクトをクリアします。

ErrorInformationプロパティ

機能

更新処理でエラーになったUpdate，Insert，Deleteオブジェクトの番号を，数値で取得します。

形式

　　　　Object. ErrorInformation

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

戻り値

値

内容

0

更新する表又は列として，存在しない表名又は列名を設定しています。

1以上

エラーになったUpdate，Insert，Deleteオブジェクトの番号を示します。

使い方

UpdateDefine.Executeメソッドを実行する前は，0を返します。

Exclusiveプロパティ

機能

更新する表をほかのユーザが使っているときの動作を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. Exclusive［= String］

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

String

排他オプションを，次に示す0〜64バイトの文字列で設定します。

文字列

内容

長さ0バイトの文字列

更新対象の表をほかのユーザが使っているときは，使っているユーザのトランザクション終了を待ちます。

"WITH ROLLBACK"

更新対象の表をほかのユーザが使っているときは，トランザクションを取り消して無効にします。

排他オプションの文字列については，各データベースのマニュアルを参照してください。

使い方

Exclusiveプロパティの値は，UpdateDefine.Executeメソッドを実行するときに使われます。UpdateDefine.Executeメソッドを実行した後でExclusiveプロパティの値を変更しても，UpdateDefine.Executeメソッドの結果を変えることはできません。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

ExecutedRowCountプロパティ

機能

UpdateDefine.Executeメソッドを実行（Update，Insert，Delete）した結果，サーバプログラムが更新した行数を，数値で取得します。

形式

　　　　Object. ExecutedRowCount

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

使い方

UpdateDefine.Executeメソッドを実行する前は，0を返します。

TableNameプロパティ

機能

更新する表名を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TableName［= string］

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

string

更新する表名を，1〜128バイトの文字列で設定します。長さ0の文字列は，設定できません。

使い方

設定する表名の書式については，「8.1.2　表名を設定するときの規則」を参照してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

TablePasswordプロパティ

機能

表にアクセスするためのパスワードを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. TablePassword［＝ Pass］

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

Pass

参照のパスワード又は更新のパスワードを，0〜8バイトの文字列で設定します。値をクリアするときは，長さ0の文字列を設定します。

使い方

半角文字の「（ 」，「 ）」，又は全角文字は設定できません。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

UpdateModeプロパティ

機能

更新処理を実行するときにどのようなSQL文で更新するかを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. UpdateMode［= mode］

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

mode

更新を実行するモードを，次に示す定数又は数値で設定します。

定数

数値

内容

dbpNormal

0

変数（？パラメタ）を使いません。

dbpVariable

1

変数（？パラメタ）を使います。

使い方

dbpNormalを設定すると，Update/Insert/Deleteの各オブジェクト単位にSQL文を作成して更新処理を実行します。

dbpVariableを設定すると，Update/Insert/Deleteの各オブジェクトの値の部分を変数にしたSQL文を作成して更新処理を実行します。dbpVariableを使うときは，更新する列の数や，列の設定順が一定でないと，エラーになります。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Executeメソッド

機能

データベースに対して，データを更新します。

形式

　　　　Object. Execute（Type）

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

Type

更新種別を，次に示す定数又は数値で設定します。

定数

数値

内容

dbpUpdate

0

変更処理を示します。

dbpInsert

1

追加処理を示します。

dbpDelete

2

削除処理を示します。

使い方

UpdateDefine.Executeメソッドを実行するためには，次に示す条件があります。

変更処理の場合

一つ以上のUpdateオブジェクトが設定されていること

追加処理の場合

一つ以上のInsertオブジェクトが設定されていること

削除処理の場合

一つ以上のDeleteオブジェクトが設定されていること

トランザクション終了モードにdbpManualを設定しているときは，更新処理が終了した時点で必ずCommitメソッド又はRollbackメソッドを実行してください。更新処理がエラーになったときも，メソッドを実行する必要があります。Commitメソッド又はRollbackメソッドを実行し忘れると，データベースのデータを壊してしまうおそれがあります。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

RemoveAllメソッド

機能

Update，Insert，Deleteオブジェクトをすべてクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

UpdateDefineオブジェクトへの参照を表すオブジェクト式です。

7.14　Updatesコレクションオブジェクトの詳細

Updatesコレクションオブジェクトは，Updateオブジェクトをリストオブジェクトとして管理します。

Updatesコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Updatesコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

Updateオブジェクトの個数を数値で取得します。

●Updatesコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

Updateオブジェクトを生成します。

Item

Updateオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのUpdateオブジェクトを削除します。

Countプロパティ

機能

Update.Addメソッドで作成したUpdateオブジェクトの個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Updatesコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

Updateオブジェクトを生成します。

形式

　　　　Object. Add

パラメタ

Object

Updatesコレクションオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Itemメソッド

機能

Updateオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Updatesコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的のUpdateオブジェクトの番号を，数値で設定します。番号は，1〜Updates.Countプロパティの範囲内で設定します。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

RemoveAllメソッド

機能

すべてのUpdateオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Updatesコレクションオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

7.15　Updateオブジェクトの詳細

Updateオブジェクトは，サーバプログラムのデータを変更するための情報を管理します。

Updateオブジェクトのプロパティとメソッドの一覧を次に示します。

●Updateオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Column

○

○

変更情報の列名を設定します。

KeyColumn

○

○

変更行条件の列名を設定します。

KeyCount

−

○

変更行条件の数を取得します。

KeyValue

○

○

変更行条件のデータを設定します。

UpdateValue

○

○

変更情報のデータを設定します。

UpdateValueCount

−

○

変更情報の数を取得します。

●Updateオブジェクトのメソッドの一覧

メソッド

説明

AddKey

変更行条件を追加します。

AddUpdateValue

変更情報を追加します。

Columnプロパティ

機能

変更情報の番号で設定した情報の列名を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. Column（ValueNumber）［= Column］

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の変更情報を，数値で設定します。番号は，1〜Update.UpdateValueCountプロパティの範囲内で設定します。

Column

列名を，1〜64バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

KeyColumnプロパティ

機能

変更行条件の番号で設定した条件の列名を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. KeyColumn（KeyNumber）［= Column］

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

KeyNumber

目的の条件の変更行番号を，数値で設定します。番号は，1〜Update.KeyCountプロパティの範囲内で設定します。

Column

列名を，1〜64バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

KeyCountプロパティ

機能

変更行条件の数を，数値で取得します。

形式

　　　　Object. KeyCount

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

KeyValueプロパティ

機能

変更行条件の番号で設定した条件のデータを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. KeyValue（KeyNumber）［= Data］

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

KeyNumber

目的の変更行条件の番号を，数値で設定します。番号は，1〜Update.KeyCountプロパティの範囲内で設定します。

Data

条件のデータを，0〜256バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

UpdateValueプロパティ

機能

AddUpdateValueメソッドで追加した変更情報のデータを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. UpdateValue（ValueNumber）［= Data］

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の変更情報を，数値で設定します。番号は，1〜Update.UpdateValueCountプロパティの範囲内で設定します。

Data

データを，0〜256バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

UpdateValueCountプロパティ

機能

変更情報の数を，数値で取得します。

形式

　　　　Object. UpdateValueCount

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

AddKeyメソッド

機能

変更行条件を追加します。列名には，Valueに設定するデータを格納している列名を設定します。データには，変更する行を特定するデータを設定します。

形式

　　　　Object. AddKey Column，Value

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜64バイトの文字列で設定します。長さ0の文字列は設定できません。

Value

データを，0〜256バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

一つの変更行条件で変更する行を特定できないときは，同一のUpdateオブジェクトに対して複数の変更行条件を設定してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

AddUpdateValueメソッド

機能

変更情報を追加します。列名には，Valueに設定するデータを格納する列名を設定します。データには，新しく格納するデータを設定します。

形式

　　　　Object. AddUpdateValue Column，Value

パラメタ

Object

Updateオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜64バイトの文字列で設定します。長さ0の文字列は設定できません。

Value

データを，0〜256バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

変更行条件で決めた行に対して，複数の列のデータを変更するときは，同じUpdateオブジェクトに対して複数の変更情報を設定してください。

AddUpdateValueメソッドで設定したデータを変更/取得するときは，UpdateValueプロパティを使います。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

7.16　Insertsコレクションオブジェクトの詳細

Insertsコレクションオブジェクトは，Insertオブジェクトをリストオブジェクトとして管理します。

Insertsコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Insertsコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

Insertオブジェクトの個数を，数値で取得します。

●Insertsコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

Insertオブジェクトを追加します。

Item

Insertオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのInsertオブジェクトをクリアします。

Countプロパティ

機能

Inserts.Addメソッドで作成したInsertオブジェクトの個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Insertsコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

Insertオブジェクトを追加します。

形式

　　　　Object. Add

パラメタ

Object

Insertsコレクションオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Itemメソッド

機能

Insertオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Insertsコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的のInsertオブジェクトの番号を，数値で設定します。番号は，1〜Inserts.Countプロパティの範囲内で設定します。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

RemoveAllメソッド

機能

すべてのInsertオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Insertsコレクションオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

7.17　Insertオブジェクトの詳細

Insertオブジェクトは，表に挿入する1行分のデータを管理するオブジェクトです。一つのInsertオブジェクトには列単位に複数の挿入値を設定できます。

Insertオブジェクトのプロパティとメソッドの一覧を次に示します。

●Insertオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Column

○

○

追加情報の列名を設定します。

InsertValue

○

○

追加情報のデータを設定します。

InsertValueCount

−

○

追加情報の個数を数値で取得します。

●Insertオブジェクトのメソッドの一覧

メソッド

説明

AddInsertValue

追加情報を追加します。

Columnプロパティ

機能

追加情報の番号で設定した情報の列名を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. Column（ValueNumber）［= Column］

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の追加情報の番号を，数値で設定します。番号は，1〜Insert.InsertValueCountプロパティの範囲内で設定します。

Column

列名を，1〜64バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

InsertValueプロパティ

機能

AddInsertValueメソッドで追加した追加情報のデータを設定します。このプロパティは，値も取得できます。

形式

　　　　Object. InsertValue（ValueNumber）［= Data］

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

ValueNumber

目的の追加情報の番号を，数値で設定します。番号は，1〜Insert.InsertValueCountプロパティの範囲内で設定します。

Data

データを，0〜256バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

InsertValueCountプロパティ

機能

追加情報の数を，数値で取得します。

形式

　　　　Object. InsertValueCount

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

AddInsertValueメソッド

機能

追加情報を追加します。列名には，Valueに設定するデータを格納する列名を設定します。データには，新しく追加するデータを設定します。

形式

　　　　Object. AddInsertValue Column，Value

パラメタ

Object

Insertオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜64バイトの文字列で設定します。長さ0の文字列は設定できません。

Value

データを，0〜256バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

複数の列にデータを追加するときは，同じInsertオブジェクトに対して複数の追加情報を設定してください。

AddInsertValueメソッドで設定したデータを変更/取得するときは，InsertValueプロパティを使います。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

7.18　Deletesコレクションオブジェクトの詳細

Deletesコレクションオブジェクトは，Deleteオブジェクトをリストオブジェクトとして管理します。

Deletesコレクションオブジェクトのプロパティとメソッドの一覧を次に示します。

●Deletesコレクションオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

Deleteオブジェクトの個数を数値で取得します。

●Deletesコレクションオブジェクトのメソッドの一覧

メソッド

説明

Add

Deleteオブジェクトを追加します。

Item

Deleteオブジェクトのオブジェクト式を取得します。

RemoveAll

すべてのDeleteオブジェクトをクリアします。

Countプロパティ

機能

Deletes.Addメソッドで作成したDeleteオブジェクトの個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

Deletesコレクションオブジェクトへの参照を表すオブジェクト式です。

Addメソッド

機能

Deleteオブジェクトを生成します。

形式

　　　　Object. Add

パラメタ

Object

Deletesコレクションオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

Itemメソッド

機能

Deleteオブジェクトのオブジェクト式を取得します。

形式

　　　　Object. Item（ObjectNumber）

パラメタ

Object

Deletesコレクションオブジェクトへの参照を表すオブジェクト式です。

ObjectNumber

目的のDeleteオブジェクト番号を，数値で設定します。番号は，1〜Deletes.Countプロパティの範囲内で設定します。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

RemoveAllメソッド

機能

すべてのDeleteオブジェクトをクリアします。

形式

　　　　Object. RemoveAll

パラメタ

Object

Deletesコレクションオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

7.19　Deleteオブジェクトの詳細

Deleteオブジェクトは，Delete文を生成するための情報になる削除データの設定値情報を管理します。Delete文1文に付き，一つのDeleteオブジェクトが対応します。

Deleteオブジェクトのプロパティとメソッドの一覧を次に示します。

●Deleteオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

KeyColumn

○

○

削除行条件の列名を設定します。

KeyCount

−

○

削除行条件の数を取得します。

KeyValue

○

○

削除行条件のデータを設定します。

●Deleteオブジェクトのメソッドの一覧

メソッド

説明

AddKey

削除行条件を追加します。

KeyColumnプロパティ

機能

削除行条件の番号で設定した条件の列名を，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. KeyColumn（KeyNumber）［= Column］

パラメタ

Object

Deleteオブジェクトへの参照を表すオブジェクト式です。

KeyNumber

目的の削除行条件の番号を，数値で設定します。番号は，1〜Delete.KeyCountプロパティの範囲内で設定します。

Column

列名を，1〜64バイトの文字列で設定します。長さ0の文字列は設定できません。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

KeyCountプロパティ

機能

削除行条件の数を，数値で取得します。

形式

　　　　Object. KeyCount

パラメタ

Object

Deleteオブジェクトへの参照を表すオブジェクト式です。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

KeyValueプロパティ

機能

削除行条件の番号で設定した条件のデータを，文字列で設定します。このプロパティは，値も取得できます。

形式

　　　　Object. KeyValue（KeyNumber）［= Data］

パラメタ

Object

Deleteオブジェクトへの参照を表すオブジェクト式です。

KeyNumber

目的の削除行条件の番号を，数値で設定します。番号は，1〜Delete.KeyCountプロパティの範囲内で設定します。

Data

データを，0〜256バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

AddKeyメソッド

機能

削除行条件を追加します。列名には，Valueに設定するデータを格納している列名を設定します。データには，削除する行を特定するデータを設定します。

形式

　　　　Object. AddKey Column，Value

パラメタ

Object

Deleteオブジェクトへの参照を表すオブジェクト式です。

Column

列名を，1〜64バイトの文字列で設定します。長さ0の文字列は設定できません。

Value

データを，0〜256バイトの文字列で設定します。長さ0の文字列を設定すると，NULLデータが仮定されます。

使い方

設定する列名の書式については，「8.1.3　列名を設定するときの規則」を参照してください。

一つの削除行条件で削除する行を特定できないときは，同一のDeleteオブジェクトに対して複数の削除行条件を設定してください。

このプロパティは，使えるデータベースに制限があります。データベースの制限については，「8.3　データベースと使えるプロパティ／メソッド」を参照してください。

7.20　Catalogオブジェクトの詳細

Catalogオブジェクトは，手順ファイルを参照しQueryDefineオブジェクトを生成するための情報を管理します。

Catalogオブジェクトのメソッドの一覧を次に示します。Catalogオブジェクトのプロパティはありません。

●Catalogオブジェクトのメソッドの一覧

メソッド

説明

Convert

読み込んだ手順ファイルの情報からQueryDefineオブジェクトを生成します。

FileLoad

手順ファイルの情報を読み込みます。

Convertメソッド

機能

FileLoadメソッドで読み込まれた手順ファイルの情報から，QueryDefineオブジェクトを生成します。

形式

　　　　Object. Convert

パラメタ

Object

Catalogオブジェクトへの参照を表すオブジェクト式です。

使い方

可変値を使用している手順ファイルを読み込んだ場合は，Convertメソッドを発行する前にVariableListオブジェクトに実行値を設定してください。実行値が設定されていない場合は，手順ファイルが格納している初期値を使用してQueryDefineオブジェクトを生成します。

Convertメソッドを発行すると，現在のQueryDefineオブジェクトの内容は削除されます。

FileLoadメソッド

機能

手順ファイルから抽出に関係する情報を読み込みます。抽出条件として可変値が使用されている場合は，VariableList.Countプロパティに可変値の個数が返されます。手順ファイルの情報からQueryDefineオブジェクトを生成するには，Convertメソッドを使用します。

形式

　　　　Object. FileLoad（FileName）

パラメタ

Object

Catalogオブジェクトへの参照を表すオブジェクト式です。

FileName

ファイル名を，1〜256バイトの文字列で設定します。

使い方

ファイル名にパスが含まれていない場合は，カレントディレクトリを仮定します。

FileLoadメソッドを発行すると，VariableListオブジェクトの各プロパティの内容が更新されます。

ODBC接続の抽出を登録した手順ファイルを設定した場合，動作は保証しません。

次に示す手順ファイルを設定した場合，エラーとなります。

DBPARTNER/Client 03-00以前のバージョンの手順ファイル

表定義を登録した手順ファイル

アウタジョインを登録した手順ファイル

保存，予約，絞り込みを登録した手順ファイルからは，表定義に関する情報は読み込みません。

メール連携を登録した手順ファイルからは，メール操作に関する情報は読み込みません。

更新用抽出を登録した手順ファイルは，抽出操作として読み込みます。

手順ファイルに登録されている情報でも，次に示す情報は読み込みません。

ホスト名称，転送先種別，転送先ファイル名，逐次検索，件数確認，抽出件数の制限，仮想列の名称，更新キー解除，BINARY属性のファイル種別

7.21　VariableListオブジェクトの詳細

VariableListオブジェクトは，手順ファイルに格納されている可変値情報を取得したり，取得した情報を管理したりします。それぞれの情報はプロパティによって返されます。

VariableListオブジェクトのプロパティの一覧を次に示します。VariableListオブジェクトのメソッドはありません。

●VariableListオブジェクトのプロパティの一覧

プロパティ

設定

取得

説明

Count

−

○

手順ファイルに格納されている可変値の個数を数値で取得します。

VariableName

−

○

可変値の名称を文字列で取得します。

VariableValue

○

○

可変値の値とする実行値を設定します。

Countプロパティ

機能

Catalog.FileLoadメソッドで読み込んだ手順ファイルに格納されている可変値の個数を，数値で取得します。

形式

　　　　Object. Count

パラメタ

Object

VariableListオブジェクトへの参照を表すオブジェクト式です。

使い方

手順ファイルに可変値が使用されていない場合，このプロパティの値は0になります。

VariableNameプロパティ

機能

可変値の名称を文字列で取得します。

形式

　　　　Object. VariableName（Index）

パラメタ

Object

VariableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の可変値の番号を数値で設定します。番号は，1〜VariableList.Countプロパティの範囲で設定します。

使い方

可変値の名称の先頭に付いている“&”は返りません。

VariableValueプロパティ

機能

可変値の値とする実行値を設定します。このプロパティは，値の取得もできます。

形式

　　　　Object. VariableValue（Index）［= String］

パラメタ

Object

VariableListオブジェクトへの参照を表すオブジェクト式です。

Index

目的の可変値の番号を数値で設定します。番号は，1〜VariableList.Countプロパティの範囲で設定します。

String

実行値を，1〜256バイトの文字列で設定します。

使い方

Catalog.FileLoadメソッド発行直後は，手順ファイルに格納されている初期値が実行値として設定されます。

実行値に長さ0の文字列，又は257バイト以上の文字列が設定された場合，エラーとなります。

8　CommuniNet接続を使うときの参照情報

CommuniNet接続でDBPARTNER2 Clientのアプリケーションを開発するときに，データベースとサーバプログラム別で注意する必要がある項目について説明しています。

8.1　条件式，表名，列名，配列列の形式

CommuniNet接続で条件式，表名，列名，配列列を設定するときの規則について説明します。

8.1.1　条件式を設定するときの規則

条件式を設定するときの書式と規則を次に示します。

条件式

<条件式>：＝｛ <条件><比較演算子><条件> ｜ <述語> ｝

条件

<条件>：＝｛ <定数> ｜ <列> ｜ <条件> ｜ <条件><算術演算子><条件> ｝

定数

<定数>：＝｛ 数値 ｜ '文字列' ｝

文字列は「'」（アポストロフィ）で囲んでください。文字列に「'」（アポストロフィ）を含めるときは，アポストロフィを二つ「''」設定してください。

列

<列>：＝［<表>.］"列名"

列名は「"」（ダブルクォーテーション）で囲んでください。

表

<表>：＝［"所有者".］"表名"

所有者と表名は「"」（ダブルクォーテーション）で囲んでください。

算術演算子

<算術演算子>：＝｛ + ｜ - ｜ * ｜ / ｝

比較演算子

<比較演算子>：＝｛ ＝ ｜ <> ｜ < ｜ > ｜ <＝ ｜ >＝ ｝

述語

<述語>：＝｛ <列> IS［NOT］NULL ｜

<列>［NOT］IN （<定数>［，<定数>・・・］） ｜

<列>［NOT］LIKE <文字パターン> ｜

<列>［NOT］BETWEEN <定数> AND <定数> ｝

記号の説明を次に示します。

記号

説明

｛ ｝

波括弧

この記号で囲まれている複数の項目のうちから一つを選択します。

（例）｛ A ｜ B ｜ C ｝は，「A，B又はCのどれかを指定する」ことを示します。

［］

きっ甲

この記号で囲まれている項目は省略してもよいことを示します。

（例）［A.］Bは，「A.Bと指定する」又は「Bを指定する」ことを示します。

..

リーダ

記述を省略していることを示します

（例） A，B，...は，「Aの後ろにBを複数指定する」ことを示します。

△

白三角

空白を空けることを示します。

（例） A△Bは，「AとBの間に空白を入れる」ことを示します。

8.1.2　表名を設定するときの規則

表名を設定するときは，所有者と表名を「"」（ダブルクォーテーション）で囲みます。書式を次に示します。

書式

〔"所有者".〕"表名"

表名と列名を設定するプロパティとメソッドを次に示します。

ColumnList.TableNameプロパティ

Tables.Addメソッド

Table.TableNameプロパティ

UpdateDefine.TableNameプロパティ

(1)　所有者と表名の規則

データベースごとの所有者と表名の規則を表8-1に示します。

表8‒1　データベースごとの所有者と表名の規則

データベース

所有者

表名

V3RD，V3SD，V3RDB1，V1PDM，V3PDM

表の所有者

表名

V3USR，V1USR

表の所有者

表名（ただし，ACE3の設定でデータベースと混在させている場合は，表名の後ろに「/F」を付けます）

V1SPL

ユーザ名

「ジョブ通し番号」「分割番号」「出力クラス」を連結した文字列

VKSPL

ユーザ名

「ジョブ通し番号」「ファイル通し番号」を連結した文字列

VKRDBF

表の所有者（所有者が8バイト未満のときは，所有者の後ろに空白文字を入れて8バイトにします）

表名

8.1.3　列名を設定するときの規則

プロパティとメソッドに列名を設定するときは，列名を「"」（ダブルクォーテーション）で囲みます。列名の書式を次に示します。

(1)　抽出列を設定するときの書式

抽出列を設定するときの書式を次に示します。

通常の列の書式

〔"所有者".〕〔"表名".〕"列名"

繰り返し列，配列列の書式

〔"所有者".〕〔"表名".〕"列名（n）"

n：要素数

抽出列の設定の対象になるプロパティ／メソッドを次に示します。

Columns.Addメソッド

Column.ColumnNameプロパティ

(2)　更新する列を設定するときの書式

更新する列を設定するときの書式を次に示します。

通常の列の書式

"列名"

繰り返し列，配列列の書式

"列名（n）"

n：要素数

更新する列の設定の対象になるプロパティ／メソッドを次に示します。

Update.KeyColumnプロパティ

Update.KeyValueプロパティ

Update.AddKeyメソッド

Update.AddUpdateValueメソッド

Insert.Columnプロパティ

Insert.AddInsertValueメソッド

Delete.KeyColumnプロパティ

Delete.AddKeyメソッド

8.1.4　配列列を設定するときの規則

VOS3 XDM/RD E2の配列列にデータを追加するときは，次に示す制限があります。

すべての要素にデータを設定してください

配列列のすべての要素にデータを設定してください。データを設定していない要素があると，更新の実行時にエラーになります。

列の要素が昇順になるように設定してください

配列列の要素が昇順になるように設定してください。要素が昇順に並んでいないと，更新の実行時にエラーになります。

列の要素は続けて設定してください

配列列の要素は連続して設定してください。要素の途中に配列列以外の列があると，更新の実行時にエラーになります。

（例）

下記の表（列Bが配列列）にデータを追加する場合のコーディング例を示します。

列A

列B（1）

列B（2）

列C

1

x

y

5

正しい設定

　　　　　：
　　　　　AddInsertValue "列A"，1
　　　　　AddInsertValue "列B（1）"，"x"
　　　　　AddInsertValue "列B（2）"，"y"
　　　　　AddInsertValue "列C"，5
　　　　　：

1．に該当する誤り（要素1の列にデータが設定されていません）

　　　　　：
　　　　　AddInsertValue "列A"，1
　　　　　AddInsertValue "列B（2）"，"y"
　　　　　AddInsertValue "列C"，5
　　　　　：

2．に該当する誤り（要素が降順に設定されています）

　　　　　：
　　　　　AddInsertValue "列A"，1
　　　　　AddInsertValue "列B（2）"，"y"
　　　　　AddInsertValue "列B（1）"，"x"
　　　　　AddInsertValue "列C"，5
　　　　　：

3．に該当する誤り（要素が連続して設定されていません）

　　　　　：
　　　　　AddInsertValue "列A"，1
　　　　　AddInsertValue "列B（1）"，"x"
　　　　　AddInsertValue "列C"，5
　　　　　AddInsertValue "列B（2）"，"y"
　　　　　：

8.2　クライアント側プログラムでコード変換するときの注意

CodeChangeModeプロパティでdbpClientを設定するときに注意する項目について説明します。

8.2.1　サーバプログラムの設定

サーバプログラムごとに，コマンド記号の設定が必要です。

コマンド記号は，ログオンマクロスクリプトの中でも指定できます。

(1)　VOS3 HOAPDBS E2の場合

コマンド記号：&¥HOAPDBSPCCONVERTPROC

指定値 ：NOCONV

VOS3 HOAPDBS E2のコマンド記号については，マニュアル「VOS3 統合情報管理共通サービス　HOAPSERV 運用の手引」を参照してください。

(2)　VOSK HOAPDBS/PCの場合

コマンド記号：&@S¥HDBPCCONVERTPROC（セション階層の指定例）

指定値 ：NOCONV

VOSK HOAPDBS/PCのコマンド記号については，マニュアル「VOSK システムOA」を参照してください。

(3)　VOS3 ACE3 E3の場合

コマンド記号：&¥ACE3E3PCCDCHG

指定値 ：PC

VOS3 ACE3 E3のコマンド記号については，マニュアル「VOS3 エンドユーザ言語 ACE3 E3 運用編」を参照してください。

(4)　VOS1 DBPARTNER/Linkの場合

コマンド記号：@¥DBPLKPCCDCHG

指定値 ：PC

VOS1 DBPARTNER/Linkのコマンド記号については，マニュアル「VOS1 エンドユーザ言語 ACE3 E2 運用の手引」を参照してください。

8.2.2　空白文字に変換されるコード

次に示す範囲のEBCDIKコードは，JISの空白文字（'20'X）に変換されます。

'00'X〜'3F'X，'B2'X〜'B9'X，'CA'X〜'CF'X，'DA'X〜'DF'X，'E1'X，'EA'X〜'EF'X，'FA'X〜'FF'X

8.2.3　外字の変換規則

KEISコードの外字は，CommuniNetがシフトJISの外字に変換します。変換の規則は，CommuniNetのコードマッピングユーティリティを使って作成してください。コードマッピングユーティリティで対応できない外字は，シフトJISの未定義コード（'889E'X）に変換されます。

外字の変換規則については，CommuniNetのコードマッピングユーティリティについて説明しているドキュメントを参照してください。

8.2.4　1列当たりの制限

1列のデータが2,993バイトを超える漢字データは抽出できません。該当するデータがあると，各オブジェクトのGetメソッド又はExecuteメソッドがエラーを返します。

8.3　データベースと使えるプロパティ／メソッド

CommuniNet接続のときは，データベースによってDBPARTNER2 Clientのプロパティ／メソッドが使えないことがあります。

ここでは，サーバプログラム（HOAPDBS，ACE3）ごとに，プロパティ／メソッドが使えるかどうかを表形式で説明します。

8.3.1　HOAPDBSがサーバプログラムのとき

サーバプログラムがHOAPDBSのときの，データベースと使えるプロパティ／メソッドの関係を，オブジェクトごとに示します。表の表記と凡例を次に示します。

（表記）

dbpV3RD：VOS3 XDM/RD E2を示します。

dbpV3SD：VOS3 XDM/SD E2を示します。

dbpVKRDBF：VOSK RDB編成ファイルを示します。

dbpVKSPL：VOSKスプールファイルを示します。

（凡例）

○：このプロパティ／メソッドを使えます。

△：このプロパティ／メソッドを使えますが，注※に示す注意が必要です。

×：このメソッドを実行すると，エラーになります。

−：このメソッドを実行しても，何も処理されません。又はこのプロパティに値を設定しても，使われません。

(1)　DBPARTNERオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

CodeChangeMode

○

○

○

○

CommitMode

○

○

○

−

DictPath

○

○

○

○

TableDefSource

○

○

○

○

IsConnect

○

○

○

○

LogoffFileName

○

○

○

○

LogonFileName

○

○

○

○

MacroTimeLimit

○

○

○

○

Password

○

○

○

○

ResponseLimit

−

−

−

−

TargetDatabase

○

○

○

○

TargetServer

○

○

○

○

TerminalMode

○

○

○

○

TerminalName

○

○

○

○

UserID

○

○

○

○

Cancel

○

○

○

○

Commit

○

○

○

−

Connect

○

○

○

○

Disconnect

○

○

○

○

Rollback

○

○

○

−

TerminalClose

○

○

○

○

(2)　Resultオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

QueryCountLimit

○

○

○

○

DataCheck

○

○

○

○

HeaderOutput

○

○

○

○

RecordHeader

○

○

○

△ ※

FieldHeader

○

○

○

△ ※

RecordData

○

○

○

○

FieldData

○

○

○

○

FieldDataLength

○

○

○

○

FieldCount

○

○

○

○

EOF

○

○

○

○

Get

○

○

○

○

Close

○

○

○

○

SaveToFile

○

○

○

○

CopyToClipboard

○

○

○

○

注※

FieldHeaderプロパティの設定がないときは，空白1文字を返します。

(3)　TableListオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Count

○

○

○

○

CountLimit

○

○

○

○

Pattern

○

○

○

○

SelectDict

○

○

○

○

TableComment

○

○

○

○

TableCreateDate

○

○

○

○

TableDataSource

○

○

○

○

TableDBMName

△ ※

△ ※

△ ※

△ ※

TableDeleteAuth

○

○

○

○

TableGroupName

○

○

○

○

TableHeader

○

○

○

○

TableInsertAuth

○

○

○

○

TableName

○

○

○

○

TableOwner

○

○

○

○

TableSelectAuth

○

○

○

○

TableType

○

○

○

○

TableUpdateAuth

○

○

○

○

Get

○

○

○

○

注※

常に長さ0の文字列を返します。

(4)　ColumnListオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

ColumnComment

○

○

○

×

ColumnEditPattern

○

○

○

×

ColumnHeader

○

○

○

×

ColumnLength

○

○

○

×

ColumnName

○

○

○

×

ColumnNumber

○

○

○

×

ColumnScale

○

○

○

×

ColumnType

○

○

○

×

Count

○

○

○

△ ※1

CountLimit

○

○

○

△ ※2

SelectDict

○

○

○

○

TableName

○

○

○

△ ※2

TablePassword

−

○

−

−

Get

○

○

○

×

注※1

常に0を返します。

注※2

Getメソッドがエラーになるため，設定は無意味です。

(5)　QueryDefineオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Exclusive

○

−

−

−

QueryCount

△ ※1

×

△ ※1

×

Execute

○

○

○

△ ※2

RemoveAll

○

○

○

○

注※1

集合関数が設定されているときは，エラーを返します。

注※2

抽出列，抽出条件が設定してあると，エラーを返します。

(6)　Tablesコレクションオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Count

○

○

○

○

Add

○

△ ※

△ ※

△ ※

Item

○

○

○

○

RemoveAll

○

○

○

○

注※

複数の表を設定すると，QueryDefine.Executeメソッドでエラーを返します。

(7)　Tableオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

TableName

○

○

○

○

TablePassword

−

○

−

−

(8)　Columnsコレクションオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Count

○

○

○

△ ※

Add

○

○

○

△ ※

Item

○

○

○

△ ※

RemoveAll

○

○

○

△ ※

注※

抽出する列が設定されていると，QueryDefine.Executeメソッドでエラーを返します。

(9)　Columnオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

ColumnName

○

○

○

△ ※3

SortMode

○

△ ※1

○

△ ※3

SortPriority

○

△ ※1

○

△ ※3

FunctionMode

○

△ ※2

○

△ ※3

注※1

列にソート種別が設定されていると，QueryDefine.Executeメソッドでエラーを返します。

注※2

列に集合関数が設定されていると，QueryDefine.Executeメソッドでエラーを返します。

注※3

抽出する列が設定されていると，QueryDefine.Executeメソッドでエラーを返します。

(10)　Conditionsコレクションオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Count

○

○

○

△ ※

Relation

○

○

○

△ ※

Add

○

○

○

△ ※

Item

○

○

○

△ ※

RemoveAll

○

○

○

△ ※

注※

抽出条件を設定すると，QueryDefine.Executeメソッドでエラーを返します。

(11)　Conditionオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Text

○

○

○

△ ※

注※

抽出条件を設定すると，QueryDefine.Executeメソッドでエラーを返します。

(12)　UpdateDefineオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Exclusive

○

−

−

−

UpdateMode

○

△ ※1

○

△ ※2

TableName

○

○

○

△ ※2

TablePassword

−

○

−

−

ExecutedRowCount

○

○

○

△ ※3

ErrorInformation

○

○

○

△ ※3

Execute

○

○

○

×

RemoveAll

○

○

○

○

注※1

dbpVariableを設定すると，UpdateDefine.Executeメソッドでエラーを返します。

注※2

更新処理ができないデータベースです。値の設定は無意味です。

注※3

常に0を返します。

(13)　Updatesコレクションオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Count

○

○

○

−

Add

○

○

○

△ ※

Item

○

○

○

−

RemoveAll

○

○

○

−

注※

更新処理ができないデータベースです。値の設定は無意味です。

(14)　Updateオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

KeyCount

○

○

○

○

UpdateValueCount

○

○

○

○

KeyColumn

○

○

○

△ ※

KeyValue

○

○

○

△ ※

Column

○

○

○

△ ※

UpdateValue

○

○

○

△ ※

AddKey

○

○

○

△ ※

AddUpdateValue

○

○

○

△ ※

注※

更新処理ができないデータベースです。値の設定は無意味です。

(15)　Insertsコレクションオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Count

○

○

○

○

Add

○

○

○

△ ※

Item

○

○

○

○

RemoveAll

○

○

○

○

注※

更新処理ができないデータベースです。値の設定は無意味です。

(16)　Insertオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

InsertValueCount

○

○

○

○

Column

○

○

○

△ ※

InsertValue

○

○

○

△ ※

AddInsertValue

○

○

○

△ ※

注※

更新処理ができないデータベースです。値の設定は無意味です。

(17)　Deletesコレクションオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Count

○

○

○

○

Add

○

○

○

△ ※

Item

○

○

○

○

RemoveAll

○

○

○

○

注※

更新処理ができないデータベースです。値の設定は無意味です。

(18)　Deleteオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

KeyCount

○

○

○

○

KeyColumn

○

○

○

△ ※

KeyValue

○

○

○

△ ※

AddKey

○

○

○

△ ※

注※

更新処理ができないデータベースです。値の設定は無意味です。

(19)　Catalogオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Convert

○

○

○

○

FileLoad

○

○

○

○

(20)　VariableListオブジェクト

プロパティ／メソッド

データベース

dbpV3RD

dbpV3SD

dbpVKRDBF

dbpVKSPL

Count

○

○

○

○

VariableName

○

○

○

○

VariableValue

○

○

○

○

8.3.2　ACE3 E3がサーバプログラムのとき

サーバプログラムがACE3 E3のときの，データベースと使えるプロパティ／メソッドの関係を，オブジェクトごとに示します。表の表記と凡例を次に示します。

（表記）

dbpV3PDM：VOS3 PDMII E2を示します。

dbpV3USR：VOS3 ユーザファイルを示します。

dbpV3RDB1：VOS3 RDB1を示します。

dbpV1PDM：VOS1 PDMII E2を示します。

dbpV1USR：VOS1 ユーザファイルを示します。

dbpV1SPL：VOS1スプールファイルを示します。

（凡例）

○：このプロパティ／メソッドを使えます。

△：このプロパティ／メソッドを使えますが，注※に示す注意が必要です。

×：このメソッドを実行すると，エラーになります。

−：このメソッドを実行しても，何も処理されません。又はこのプロパティに値を設定しても，使われません。

(1)　DBPARTNERオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

CodeChangeMode

○

○

○

○

○

○

CommitMode

−

−

−

−

−

−

DictPath

○

○

○

○

○

○

TableDefSource

○

○

○

○

○

○

IsConnect

○

○

○

○

○

○

LogoffFileName

○

○

○

○

○

○

LogonFileName

○

○

○

○

○

○

MacroTimeLimit

○

○

○

○

○

○

Password

○

○

○

○

○

○

ResponseLimit

−

−

−

○

○

○

TargetDatabase

○

○

○

○

○

○

TargetServer

○

○

○

○

○

○

TerminalMode

○

○

○

○

○

○

TerminalName

○

○

○

○

○

○

UserID

○

○

○

○

○

○

Cancel

○

○

○

○

○

○

Commit

−

−

−

−

−

−

Connect

○

○

○

○

○

○

Disconnect

○

○

○

○

○

○

Rollback

−

−

−

−

−

−

TerminalClose

○

○

○

○

○

○

(2)　Resultオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

QueryCountLimit

○

○

○

○

○

○

DataCheck

○

○

○

○

○

○

HeaderOutput

○

○

○

○

○

○

RecordHeader

○

○

○

○

○

△ ※

FieldHeader

○

○

○

○

○

△ ※

RecordData

○

○

○

○

○

○

FieldData

○

○

○

○

○

○

FieldDataLength

○

○

○

○

○

○

FieldCount

○

○

○

○

○

○

EOF

○

○

○

○

○

○

Get

○

○

○

○

○

○

Close

○

○

○

○

○

○

SaveToFile

○

○

○

○

○

○

CopyToClipboard

○

○

○

○

○

○

注※

FieldHeaderプロパティを設定していないと，空白1文字を返します。

(3)　TableListオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Count

○

○

○

○

○

○

CountLimit

○

○

○

○

○

○

SelectDict

○

○

○

○

○

○

Pattern

○

○

○

○

○

○

TableComment

○

○

○

○

○

○

TableCreateDate

○

○

○

○

○

○

TableDataSource

○

○

○

○

○

○

TableDBMName

○

△ ※

△ ※

○

△ ※

△ ※

TableDeleteAuth

○

○

○

○

○

○

TableGroupName

○

○

○

○

○

○

TableHeader

○

○

○

○

○

○

TableInsertAuth

○

○

○

○

○

○

TableName

○

○

○

○

○

○

TableOwner

○

○

○

○

○

○

TableSelectAuth

○

○

○

○

○

○

TableType

○

○

○

○

○

○

TableUpdateAuth

○

○

○

○

○

○

Get

○

○

○

○

○

○

注※

常に長さ0の文字列を返します。

(4)　ColumnListオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

ColumnComment

○

○

○

○

○

×

ColumnEditPattern

○

○

○

○

○

×

ColumnHeader

○

○

○

○

○

×

ColumnLength

○

○

○

○

○

×

ColumnName

○

○

○

○

○

×

ColumnNumber

○

○

○

○

○

×

ColumnScale

○

○

○

○

○

×

ColumnType

○

○

○

○

○

×

Count

○

○

○

○

○

△ ※1

CountLimit

○

○

○

○

○

△ ※2

SelectDict

○

○

○

○

○

○

TableName

○

○

○

○

○

△ ※2

TablePassword

−

−

−

−

−

−

Get

○

○

○

○

○

×

注※1

常に0を返します。

注※2

Getメソッドがエラーになるため，設定は無意味です。

(5)　QueryDefineオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Exclusive

−

−

−

−

−

−

QueryCount

△ ※1

△ ※1

△ ※1

△ ※1

△ ※1

△ ※2

Execute

○

○

○

○

○

△ ※2

RemoveAll

○

○

○

○

○

○

注※1

集合関数を設定していると，エラーを返します。

注※2

抽出列，抽出条件を設定していると，エラーを返します。

(6)　Tablesコレクションオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Count

○

○

○

○

○

○

Add

△ ※1

△ ※1

△ ※1

△ ※1

△ ※1

△ ※2

Item

○

○

○

○

○

○

RemoveAll

○

○

○

○

○

○

注※1

6個以上の表を設定すると，QueryDefine.Executeでエラーを返します。

注※2

複数の表を設定すると，QueryDefine.Executeでエラーを返します。

(7)　Tableオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

TableName

○

○

○

○

○

○

TablePassword

−

−

−

−

−

−

(8)　Columnsコレクションオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Count

○

○

○

○

○

○

Add

○

○

○

○

○

△ ※

Item

○

○

○

○

○

○

RemoveAll

○

○

○

○

○

○

注※

抽出列を設定すると，QueryDefine.Executeメソッドでエラーを返します。

(9)　Columnオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

ColumnName

○

○

○

○

○

△ ※

SortMode

○

○

○

○

○

△ ※

SortPriority

○

○

○

○

○

△ ※

FunctionMode

○

○

○

○

○

△ ※

注※

抽出列を設定すると，QueryDefine.Executeメソッドでエラーを返します。

(10)　Conditionsコレクションオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Count

○

○

○

○

○

○

Relation

○

○

○

○

○

△ ※

Add

○

○

○

○

○

△ ※

Item

○

○

○

○

○

○

RemoveAll

○

○

○

○

○

○

注※

抽出条件を設定すると，QueryDefine.Executeメソッドでエラーを返します。

(11)　Conditionオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Text

○

○

○

○

○

△ ※

注※

抽出条件を設定すると，QueryDefine.Executeメソッドでエラーを返します。

(12)　UpdateDefineオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Exclusive

−

−

−

−

−

−

UpdateMode

△ ※1

△ ※1

△ ※1

△ ※1

△ ※1

△ ※1

TableName

△ ※1

△ ※1

△ ※1

△ ※1

△ ※1

△ ※1

TablePassword

−

−

−

−

−

−

ExecutedRowCount

△ ※2

△ ※2

△ ※2

△ ※2

△ ※2

△ ※2

ErrorInformation

△ ※2

△ ※2

△ ※2

△ ※2

△ ※2

△ ※2

Execute

×

×

×

×

×

×

RemoveAll

○

○

○

○

○

○

注※1

更新処理ができないデータベースです。値を設定しても無意味です。

注※2

常に0を返します。

(13)　Updatesコレクションオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Count

○

○

○

○

○

○

Add

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

Item

○

○

○

○

○

○

RemoveAll

○

○

○

○

○

○

注※

更新処理ができないデータベースです。値を設定しても無意味です。

(14)　Updateオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

KeyCount

○

○

○

○

○

○

UpdateValueCount

○

○

○

○

○

○

KeyColumn

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

KeyValue

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

Column

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

UpdateValue

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

AddKey

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

AddUpdateValue

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

注※

更新処理ができないデータベースです。値を設定しても無意味です。

(15)　Insertsコレクションオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Count

○

○

○

○

○

○

Add

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

Item

○

○

○

○

○

○

RemoveAll

○

○

○

○

○

○

注※

更新処理ができないデータベースです。値を設定しても無意味です。

(16)　Insertオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

InsertValueCount

○

○

○

○

○

○

Column

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

InsertValue

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

AddInsertValue

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

注※

更新処理ができないデータベースです。値を設定しても無意味です。

(17)　Deletesコレクションオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Count

○

○

○

○

○

○

Add

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

Item

○

○

○

○

○

○

RemoveAll

○

○

○

○

○

○

注※

更新処理ができないデータベースです。値を設定しても無意味です。

(18)　Deleteオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

KeyCount

○

○

○

○

○

○

KeyColumn

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

KeyValue

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

AddKey

△ ※

△ ※

△ ※

△ ※

△ ※

△ ※

注※

更新処理ができないデータベースです。値を設定しても無意味です。

(19)　Catalogオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Convert

○

○

○

○

○

○

FileLoad

○

○

○

○

○

○

(20)　VariableListオブジェクト

プロパティ

／メソッド

データベース

dbp

V3PDM

dbp

V3USR

dbp

V3RDB1

dbp

V1PDM

dbp

V1USR

dbp

V1SPL

Count

○

○

○

○

○

○

VariableName

○

○

○

○

○

○

VariableValue

○

○

○

○

○

○

8.4　データベース別の規則

接続するデータベースごとの規則について説明します。

8.4.1　VOS3 XDM/RD E2の場合の規則

(1)　表情報の値

表情報で返される値の意味を表8-2に示します。

表8‒2　表情報で返される値の意味（VOS3 XDM/RD E2）

プロパティ／メソッド

値の説明

TableComment

表の注釈

TableCreateDate

'YYMMDDhhmmss'（YY：西暦の下2けた MM：月 DD：日 hh：時 mm：分 ss：秒）

TableDBMName

長さ0バイトの文字列

TableGroupName

表のグループ名

TableHeader

表の見出し

TableName

表名

TableOwner

表の所有者

(2)　列情報の値

列情報で返される値の意味を表8-3に示します。

表8‒3　列情報で返される値の意味（VOS3 XDM/RD E2）

プロパティ／メソッド

値の説明

ColumnComment

列の注釈

ColumnEditPattern

編集形式文字列

ColumnHeader

列の見出し

ColumnName

列名

(3)　集合関数（FunctionModeプロパティ）の規則

dbpGroupは，255列まで設定できます。

集合関数の設定は，列属性によっては使えない集合関数があります。列属性と使える集合関数の組み合わせを表8-4に示します。

表8‒4　列属性と使える集合関数の組み合わせ（VOS3 XDM/RD E2）

列属性

dbpGroup

dbpMaximum

dbpMinimum

dbpAverage

dbpSum

dbpCount

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

○

○

○

○

○

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

dbpTypeMCHAR

dbpTypeMVARCHAR

dbpTypeDATE

dbpTypeINTERVAL_YEAR_TO_DAY

○

○

○

×

×

○

（凡例）

○：指定できます。

×：指定できません。

(4)　ソート（Column.SortModeプロパティ）の規則

ソートは，255列まで設定できます。

(5)　抽出条件（Conditions.Addメソッド）の規則

(a)　列と定数の比較条件の規則

列と定数の比較は，列属性によっては使えない定数があります。列属性と使える定数の組み合わせを表8-5に示します。

表8‒5　列属性と使える定数の組み合わせ（VOS3 XDM/RD E2）

列属性

定数

整数定数

10進数定数

浮動小数点定数

文字定数

各国文字定数

混在文字定数

日付の文字表現

日間隔の10進表現

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

×

×

×

×

○

dbpTypeCHAR

dbpTypeVARCHAR

×

○

×

×

○

×

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

○

×

×

×

dbpTypeMCHAR

dbpTypeMVARCHAR

×

○

○

○

○

×

dbpTypeDATE

×

×

×

×

○

×

dbpTypeINTERVAL_YEAR_TO_DAY

×

×

×

×

×

○

（凡例）

○：設定できます。

×：設定できません。

(b)　列と列の比較条件の規則

列と列の比較は，列属性によっては使えない組み合わせがあります。比較できる列属性の組み合わせを表8-6に示します。

表8‒6　比較できる列属性の組み合わせ（VOS3 XDM/RD E2）

左辺の列属性

右辺の列属性

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

dbpType

CHAR

dbpType

VARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

dbpTypeMCHAR

dbpTypeMVARCHAR

dbpTypeDATE

dbpTypeINTERVAL_YEAR_TO_DAY

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

×

×

×

×

×

dbpType

CHAR

dbpType

VARCHAR

×

○

×

○

×

×

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

○

×

×

×

dbpTypeMCHAR

dbpTypeMVARCHAR

×

○

×

○

×

×

dbpTypeDATE

×

×

×

×

○

×

dbpTypeINTERVAL_YEAR_TO_DAY

×

×

×

×

×

○

（凡例）

○：設定できます。

×：設定できません。

(c)　IN条件の規則

定数の設定規則は，「表8-5　列属性と使える定数の組み合わせ（VOS3 XDM/RD E2）」に従ってください。

定数は，255個まで設定できます。

(d)　LIKE条件の規則

LIKE条件の設定は，列属性によっては使えないことがあります。LIKE条件が設定できる列属性を表8-7に示します。

表8‒7　LIKE条件が設定できる列属性（VOS3 XDM/RD E2）

列属性

設定できるかどうか

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

×

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

dbpTypeMCHAR

dbpTypeMVARCHAR

○

dbpTypeDATE

dbpTypeINTERVAL_YEAR_TO_DAY

×

（凡例）

○：指定できます。

×：指定できません。

列と文字パターン（定数）の規則は，「表8-5　列属性と使える定数の組み合わせ（VOS3 XDM/RD E2）」に従ってください。

「_」，「%」は，指定する列属性に応じて，全角又は半角を使ってください。

定数

文字種別

文字定数

半角文字の「_」，「%」

各国文字定数

全角文字の「＿」，「％」

混在文字定数

半角文字の「_」，「%」

文字パターンの指定方法を表8-8に示します。

表8‒8　文字パターンの指定方法（VOS3 XDM/RD E2）

項目

指定例

意 味

前方一致

ABC%

先頭が「ABC」で，以降は任意の文字列を検索します。

後方一致

%ABC

最後が「ABC」で，それより前は任意の文字列を検索します。

任意一致

%ABC%

任意の部分が「ABC」の文字列を検索します。

完全一致

ABC

「ABC」と等しい文字列を検索します。

部分一致

_ _ABC_

6文字のうち，3〜5文字目が「ABC」で，ほかの部分は任意の文字列を検索します。

上記以外

ABC%DE

先頭が「ABC」で，最後が「DE」の文字列を検索します。

%ABC%DE%

任意の部分に「ABC」を含み，以降の任意の部分に「DE」を含む文字列を検索します。

ABC_ _DE%

先頭が「ABC」で，2文字の任意の文字列をはさんで「DE」を含む文字列を検索します。

(e)　BETWEEN条件の規則

列と定数の規則は，「表8-5　列属性と使える定数の組み合わせ（VOS3 XDM/RD E2）」に従ってください。

(f)　NULL条件の規則

制限事項はありません。

(g)　列演算条件の規則

繰り返し列，配列列は指定できません。

演算を指定できる定数を次に示します。

整数定数，10進数定数，浮動小数点定数

演算を指定できる列属性を次に示します。

dbpTypeINTEGER，dbpTypeNUMERIC，dbpTypeFLOAT，dbpTypeREAL

演算は，各辺の「+」，「-」，「*」，「/」，又は「（」，「）」の総和が64個まで指定できます。

列と定数を比較するときは，「表8-5　列属性と使える定数の組み合わせ（VOS3 XDM/RD E2）」に従ってください。

(6)　条件関連（Conditions.Relationプロパティ）の規則

NOT，AND及びORを組み合わせて，255個まで指定できます。

括弧，NOT，AND及びORの優先順位は，括弧 ＞ NOT ＞ AND ＞ ORです。

括弧，NOT，AND及びORは，すべて半角文字で指定してください。

NOT，AND及びORの前後には空白を入力してください。

(7)　各条件で指定する定数の規則

各条件で指定する定数の規則を表8-9と表8-10に示します。

表8‒9　定数の指定方法（VOS3 XDM/RD E2）

定数の種類

指定方法

整数定数

［符号］符号なし整数

10進数定数

［符号］整数部.小数部

浮動小数点定数

［符号］仮数E［符号］指数

文字定数

［'］半角の文字列［'］

各国文字定数

［'］全角の文字列［'］

混在文字定数

［'］全角及び半角の文字列［'］

日付の文字表現

［'］YYYY-MM-DD［'］年（YYYY）月（MM）日（DD）をハイフンで結ぶ

日間隔の10進表現

［符号］YYYYMMDD年（YYYY）月（MM）日（DD）を10進数で並べる

表8‒10　定数の指定範囲（VOS3 XDM/RD E2）

定数の種類

指定範囲

指定例

整数定数

-（10³⁰-1）〜（10³⁰-1）

123，-123

10進数定数

10⁻²⁹〜（10³⁰-1），-（10³⁰-1）〜-10⁻²⁹，及び0

45.6，-45.6

浮動小数点定数

約1.7E-308〜1.7E+308，約-1.7E+308〜-1.7E-308，及び0

5.1E3，-5.1E-3

文字定数

1〜255バイト

ABC

各国文字定数

1〜127文字

テレビ

混在文字定数

1〜255バイト

テレビABC

日付の文字表現

YYYY：0001〜9999

MM：01〜12

DD：01〜その月の最終日

1999-03-22

日間隔の10進表現

YYYY：0000〜9999

MM：00〜99

DD：00〜99

全体の指定範囲：-99991199〜99991199

00020304

（2年3か月と4日）

8.4.2　VOSK　RDB編成ファイルの場合の規則

(1)　表情報の値

表情報で返される値の意味を表8-11に示します。

表8‒11　表情報で返される値の意味（VOSK　RDB編成ファイル）

プロパティ／メソッド

値の説明

TableComment

表の注釈

TableCreateDate

'YYMMDDhhmmss'

（YY：西暦の下2けた MM：月 DD：日 hh：時 mm：分 ss：秒）

TableDBMName

長さ0バイトの文字列

TableGroupName

表のグループ名

TableHeader

表の見出し

TableName

表名

TableOwner

表の所有者

所有者が8バイト未満の場合は，後ろに空白文字が埋められます。

(2)　列情報の値

列情報で返される値の意味を表8-12に示します。

表8‒12　列情報で返される値の意味（VOSK　RDB編成ファイル）

プロパティ／メソッド

値の説明

ColumnComment

長さ0バイトの文字列

ColumnEditPattern

編集形式文字列

ColumnHeader

列の見出し

ColumnName

列名

(3)　集合関数（FunctionModeプロパティ）の規則

ソートが設定されている列には，dbpGroup以外の集合関数は設定できません。

dbpGroupは，9列まで設定できます。

集合関数の設定は，列属性によっては使えない集合関数があります。列属性と使える集合関数の組み合わせを表8-13に示します。

表8‒13　列属性と使える集合関数の組み合わせ（VOSK RDB編成ファイル）

列属性

dbpGroup

dbpMaximum

dbpMinimum

dbpAverage

dbpSum

dbpCount

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

○

○

○

○

○

○

dbpTypeCHAR

dbpTypeNCHAR

dbpTypeMCHAR

dbpTypeBINARY

○

○

○

×

×

○

（凡例）

○：指定できます。

×：指定できません。

(4)　ソート（Column.SortModeプロパティ）の規則

9列まで指定できます。

dbpGroup以外の集合関数が設定されている列に，ソートは設定できません。

(5)　抽出条件（Conditions.Addメソッド）の規則

(a)　列と定数の比較条件の規則

列と定数の比較は，列属性によっては使えない定数があります。列属性と使える定数の組み合わせを表8-14に示します。

表8‒14　列属性と使える定数の組み合わせ（VOSK RDB編成ファイル）

列属性

定数

整数定数

10進数定数

文字定数

各国文字定数

混在文字定数

16進定数

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

○

×

×

×

×

dbpTypeCHAR

×

○

×

×

○

dbpTypeNCHAR

×

×

○

×

×

dbpTypeMCHAR

×

○

○

○

○

dbpTypeBINARY

×

×

×

×

○

（凡例）

○：比較できます。

×：比較できません。

(b)　列と列の比較条件の規則

列と列の比較は，列属性によっては使えない組み合わせがあります。比較できる列属性の組み合わせを表8-15に示します。

表8‒15　比較できる列属性の組み合わせ（VOSK RDB編成ファイル）

左辺の列属性

右辺の列属性

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

dbpTypeCHAR

dbpTypeNCHAR

dbpTypeMCHAR

dbpTypeBINARY

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

○

×

×

×

×

dbpTypeCHAR

×

○

×

×

×

dbpTypeNCHAR

×

×

○

×

×

dbpTypeMCHAR

×

○

○

○

×

dbpTypeBINARY

×

×

×

×

○

（凡例）

○：指定できます。

×：指定できません。

(c)　IN条件の規則

IN条件は使えません。

(d)　LIKE条件の規則

LIKE条件の設定は，列属性によっては使えないことがあります。LIKE条件が設定できる列属性を表8-16に示します。

表8‒16　LIKE条件が設定できる列属性（VOSK RDB編成ファイル）

列属性

設定できるかどうか

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

dbpTypeBINARY

×

dbpTypeCHAR

dbpTypeNCHAR

dbpTypeMCHAR

○

（凡例）

○：指定できます。

×：指定できません。

列と文字パターン（定数）の規則は，「表8-14　列属性と使える定数の組み合わせ（VOSK RDB編成ファイル）」に従ってください。

「%」は，指定する列属性に応じて，全角又は半角を使ってください。

定数

文字種別

文字定数

半角文字の「%」

各国文字定数

全角文字の「％」

混在文字定数

半角文字の「%」

文字パターンの指定方法を表8-17に示します。

表8‒17　文字パターンの指定方法（VOSK RDB編成ファイル）

項目

指定例

意 味

前方一致

ABC%

先頭が「ABC」で，以降は任意の文字列を検索します。

後方一致

%ABC

最後が「ABC」で，それより前は任意の文字列を検索します。

任意一致

%ABC%

任意の部分が「ABC」の文字列を検索します。

完全一致

ABC

「ABC」と等しい文字列を検索します。

(e)　BETWEEN条件の規則

BETWEEN条件は使えません。

(f)　NULL条件の規則

NULL条件は使えません。

(g)　列演算条件の規則

列演算条件は使えません。

(6)　条件関連（Conditions.Relationプロパティ）の規則

NOTは使えません。

括弧，AND及びORの優先順位は，括弧 ＞ AND ＞ ORです。

条件関連のネスト数は64までです。ネスト数は，AND又はORに対して優先順位を表す括弧を省略しないで指定したときの左括弧の数です。

（例）

1 AND（（2 OR 3 AND 4）OR 5）AND 6のときに，括弧を省略しないと（1 AND（（（2 OR 3）AND 4）OR 5）AND 6）になって，ネスト数は4です。

括弧，AND及びORは，すべて半角文字で指定してください。

AND及びORの前後には空白を入力してください。

(7)　各条件で指定する定数の規則

各条件で指定する定数の規則を表8-18と表8-19に示します。

表8‒18　定数の指定方法（VOSK RDB編成ファイル）

定数の種類

指定方法

整数定数

［符号］符号なし整数

10進数定数

［符号］整数部.小数部

文字定数

［'］半角の文字列［'］

漢字定数

［'］全角の文字列［'］

混在文字定数

［'］全角及び半角の文字列［'］

16進定数

［'］0〜9，A〜Fの半角の文字列［'］

表8‒19　定数の指定範囲（VOSK RDB編成ファイル）

定数の種類

指定範囲

指定例

整数定数

-9,223,372,036,854,775,808〜9,223,372,036,854,775,807

123，-123

10進数定数

.000,000,000,000,000,001〜999,999,999,999,999,999，

-999,999,999,999,999,999〜-000,000,000,000,000,001，

及び0

45.6，-45.6

文字定数

1〜254バイト

ABC

漢字定数

1〜127文字

テレビ

混在文字定数

1〜254バイト

テレビABC

16進定数

1〜254バイト

9F

8.4.3　VOS3　XDM/SD E2の場合の規則

(1)　表情報の値

表情報で返される値の意味を表8-20に示します。

表8‒20　表情報で返される値の意味（VOS3　XDM/SD E2）

プロパティ／メソッド

値の説明

TableComment

表の注釈

TableCreateDate

'YYMMDDhhmmss'（YY：西暦の下2けた MM：月 DD：日 hh：時 mm：分 ss：秒）

TableDBMName

長さ0バイトの文字列

TableGroupName

表のグループ名

TableHeader

表の見出し

TableName

表名

TableOwner

表の所有者

(2)　列情報の値

列情報で返される値の意味を表8-21に示します。

表8‒21　列情報で返される値の意味（VOS3　XDM/SD E2）

プロパティ／メソッド

値の説明

ColumnComment

列の注釈

ColumnEditPattern

編集形式文字列

ColumnHeader

列の見出し

ColumnName

ACE3で定義した列名，又はXDM/SD E2の構成要素名

(3)　集合関数（FunctionModeプロパティ）の規則

集合関数は設定できません。

(4)　ソート（Column.SortModeプロパティ）の規則

ソートは設定できません。

(5)　抽出条件（Conditions.Addメソッド）の規則

(a)　列と定数の比較条件の規則

比較演算子の「<>」は使えません。

列と定数の比較は，列属性によっては使えない定数があります。列属性と使える定数の組み合わせを表8-22に示します。

表8‒22　列属性と使える定数の組み合わせ（VOS3 XDM/SD E2）

定数

列属性

整数定数

10進数定数

文字定数

漢字定数

16進定数

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

○

×

×

×

dbpTypeCHAR

×

○

×

○

dbpTypeNCHAR

×

×

○

×

dbpTypeBINARY

×

×

×

○

（凡例）

○：比較できます。

×：比較できません。

(b)　列と列の比較条件の規則

比較演算子の「<>」は使えません。

列と列の比較は，列属性によっては使えない組み合わせがあります。比較できる列属性の組み合わせを表8-23に示します。

表8‒23　比較できる列属性の組み合わせ（VOS3 XDM/SD E2）

左辺の列属性

右辺の列属性

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

dbpTypeCHAR

dbpTypeNCHAR

dbpTypeBINARY

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

○

×

×

×

dbpTypeCHAR

×

○

×

×

dbpTypeNCHAR

×

×

○

×

dbpTypeBINARY

×

×

×

○

（凡例）

○：比較できます。

×：比較できません。

(c)　IN条件の規則

IN条件は使えません。

(d)　LIKE条件の規則

LIKE条件は使えません。

(e)　BETWEEN条件の規則

BETWEEN条件は使えません。

(f)　NULL条件の規則

NULL条件は使えません。

(g)　列演算条件の規則

列演算条件は使えません。

(6)　条件関連（Conditions.Relationプロパティ）の規則

NOTは指定できません。

AND，ORを組み合わせて，254個まで指定できます。

括弧，AND及びORの優先順位は，括弧 ＞ AND ＞ ORです。

括弧は64組まで指定できます。

括弧，AND及びORは，すべて半角文字で指定してください。

AND及びORの前後には空白を入力してください。

(7)　各条件で指定する定数の規則

各条件で指定する定数の規則を表8-24と表8-25に示します。

表8‒24　定数の指定方法（VOS3 XDM/SD E2）

定数の種類

指定方法

整数定数（2バイト）

［符号］符号なし整数

整数定数（4バイト）

［符号］符号なし整数

整数定数（8バイト）

［符号］符号なし整数

10進数定数

［符号］整数部.小数部

文字定数

［'］半角の文字列［'］

漢字定数

［'］全角の文字列［'］

16進定数

［'］0〜9，A〜Fの半角の文字列［'］

表8‒25　定数の指定範囲（VOS3 XDM/SD E2）

定数の種類

指定範囲

指定例

整数定数（2バイト）

-32,768 〜 32,767

123，-123

整数定数（4バイト）

-2,147,483,648 〜 2,147,483,647

整数定数（8バイト）

-9,223,372,036,854,775,808 〜 9,223,372,036,854,775,807

10進数定数

m：全けた数 n：小数点以下のけた数

M：列定義の全けた数 N：列定義の小数点けた数

1≦m≦M，1≦n≦N，n≦m

45.6，-45.6

文字定数

1〜254バイト

ABC

漢字定数

1〜127文字

テレビ

16進定数

1〜254バイト

9F

8.4.4　VOS3　PDMII E2，VOS1　PDMII E2の場合の規則

(1)　表情報の値

表情報で返される値の意味を表8-26に示します。

表8‒26　表情報で返される値の意味（VOS3　PDMII E2，VOS1　PDMII E2）

プロパティ／メソッド

値の説明

TableComment

表の注釈

TableCreateDate

'YYMMDDhhmmss'（YY：西暦の下2けた MM：月 DD：日 hh：時 mm：分 ss：秒）

TableDBMName

PDMII E2のDBM名

TableGroupName

表のグループ名

TableHeader

表の見出し

TableName

表名

TableOwner

表の所有者

(2)　列情報の値

列情報で返される値の意味を表8-27に示します。

表8‒27　列情報で返される値の意味（VOS3　PDMII E2，VOS1　PDMII E2）

プロパティ／メソッド

値の説明

ColumnComment

列の注釈

ColumnEditPattern

編集形式文字列

ColumnHeader

列の見出し

ColumnName

列名

(3)　集合関数（FunctionModeプロパティ）の規則

dbpGroupは，21列まで設定できます。ただし，ソートを設定した列数との和が22列以上は設定できません。

集合関数の設定は，列属性によっては使えない集合関数があります。列属性と使える集合関数の組み合わせを表8-28に示します。

表8‒28　列属性と使える集合関数の組み合わせ（VOS3 PDMII E2，VOS1 PDMII E2）

列属性

dbpGroup

dbpMaximum

dbpMinimum

dbpAverage

dbpSum

dbpCount

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

○

○

○

○

○

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

○

○

○

×

×

○

（凡例）

○：指定できます。

×：指定できません。

(4)　ソート（Column.SortModeプロパティ）の規則

21列まで指定できます。ただし，dbpGroupを設定した列数との和が22列以上は設定できません。

(5)　抽出条件（Conditions.Addメソッド）の規則

(a)　列と定数の比較条件の規則

列と定数の比較は，列属性によっては使えない定数があります。列属性と使える定数の組み合わせを表8-29に示します。

表8‒29　列属性と使える定数の組み合わせ（VOS3 PDMII E2，VOS1 PDMII E2）

定数

列属性

整数定数

10進数定数

浮動小数点定数

文字定数

漢字定数

dbpTypeINTEGER

dbpTypeNUMERIC

○

×

×

×

dbpTypeFLOAT

dbpTypeREAL

○

○

×

×

dbpTypeCHAR

dbpTypeVARCHAR

×

×

○

×

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

×

○

（凡例）

○：比較できます。

×：比較できません。

(b)　列と列の比較条件の規則

列と列の比較は，列属性によっては使えない組み合わせがあります。比較できる列属性の組み合わせを表8-30に示します。

表8‒30　比較できる列属性の組み合わせ（VOS3 PDMII E2，VOS1 PDMII E2）

左辺の列属性

右辺の列属性

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

×

×

dbpTypeCHAR

dbpTypeVARCHAR

×

○

×

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

○

（凡例）

○：比較できます。

×：比較できません。

(c)　IN条件の規則

定数の設定規則は，「表8-29　列属性と使える定数の組み合わせ（VOS3 PDMII E2，VOS1 PDMII E2）」に従ってください。

定数は，255個まで設定できます。

(d)　LIKE条件の規則

LIKE条件の設定は，列属性によっては使えないことがあります。LIKE条件が設定できる列属性を表8-31に示します。

表8‒31　LIKE条件が設定できる列属性（VOS3 PDMII E2，VOS1 PDMII E2）

列属性

設定できるかどうか

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

×

dbpTypeCHAR

dbpTypeNCHAR

dbpTypeVARCHAR

dbpTypeNVARCHAR

○

（凡例）

○：指定できます。

×：指定できません。

列と文字パターン（定数）の規則は，「表8-29　列属性と使える定数の組み合わせ（VOS3 PDMII E2，VOS1 PDMII E2）」に従ってください。

「_」，「%」は，指定する列属性に応じて，全角又は半角を使ってください。

定数

文字種別

文字定数

半角文字の「_」，「%」

各国文字定数

全角文字の「＿」，「％」

文字パターンの指定方法を表8-32に示します。

表8‒32　文字パターンの指定方法（VOS3 PDMII E2，VOS1 PDMII E2）

項目

指定例

意 味

前方一致

ABC%

先頭が「ABC」で，以降は任意の文字列を検索します。

後方一致

%ABC

最後が「ABC」で，それより前は任意の文字列を検索します。

任意一致

%ABC%

任意の部分が「ABC」の文字列を検索します。

完全一致

ABC

「ABC」と等しい文字列を検索します。

部分一致

_ _ABC_

6文字のうち，3〜5文字目が「ABC」で，ほかの部分は任意の文字列を検索します。

上記以外

ABC%DE

先頭が「ABC」で，最後が「DE」の文字列を検索します。

%ABC%DE%

任意の部分に「ABC」を含み，以降の任意の部分に「DE」を含む文字列を検索します。

ABC_ _DE%

先頭が「ABC」で，2文字の任意の文字列をはさんで「DE」を含む文字列を検索します。

「%」は，二つ以上設定できません。「%」を二つ設定できるのは，任意一致のパターンだけです。「A%B%C」のようなパターンは設定できません。

(e)　BETWEEN条件の規則

列と定数の規則は，「表8-29　列属性と使える定数の組み合わせ（VOS3 PDMII E2，VOS1 PDMII E2）」に従ってください。

(f)　NULL条件の規則

NULL条件は使えません。

(g)　列演算条件の規則

演算を指定できる定数を次に示します。

整数定数，10進数定数，浮動小数点定数

演算を指定できる列属性を次に示します。

dbpTypeINTEGER，dbpTypeNUMERIC，dbpTypeFLOAT，dbpTypeREAL

演算は，各辺の「+」，「-」，「*」，「/」，又は「（」，「）」の総和が64個まで指定できます。

列と定数を比較するときは，「表8-29　列属性と使える定数の組み合わせ（VOS3 PDMII E2，VOS1 PDMII E2）」に従ってください。

(6)　条件関連（Conditions.Relationプロパティ）の規則

NOTは使えません。

括弧，AND及びORの優先順位は，括弧 ＞ AND ＞ ORです。

条件関連のネスト数は64までです。ネスト数は，AND又はORに対して優先順位を表す括弧を省略しないで指定したときの，左括弧の数です。

（例）

1 AND（（2 OR 3 AND 4）OR 5）AND 6の場合，括弧を省略しないと（1 AND（（（2 OR 3）AND 4）OR 5）AND 6）になって，ネスト数は4です。

括弧，AND及びORは，すべて半角文字で指定してください。

AND及びORの前後には空白を入力してください。

(7)　各条件で指定する定数の規則

各条件で指定する定数の規則を表8-33と表8-34に示します。

表8‒33　定数の指定方法（VOS3 PDMII E2，VOS1 PDMII E2）

定数の種類

指定方法

整数定数（2バイト）

［符号］符号なし整数

整数定数（4バイト）

［符号］符号なし整数

10進数定数

［符号］整数部.小数部

浮動小数点定数

［符号］仮数E［符号］指数

文字定数

［'］半角の文字列［'］

漢字定数

［'］全角の文字列［'］

表8‒34　定数の指定範囲（VOS3 PDMII E2，VOS1 PDMII E2）

定数の種類

指定範囲

指定例

整数定数（2バイト）

-32,768 〜 32,767

123，-123

整数定数（4バイト）

-2,147,483,648 〜 2,147,483,647

10進数定数

m：全けた数 n：小数点以下のけた数

M：列定義の全けた数 N：列定義の小数点けた数

1≦m≦M，1≦n≦N，n≦m

45.6，-45.6

浮動小数点定数

仮数16けた以内

指数 -99 〜 75

5.1E3，5.1E-3

文字定数

1〜255バイト

ABC

漢字定数

1〜127文字

テレビ

8.4.5　VOS3 RDB1の場合の規則

(1)　表情報の値

表情報で返される値の意味を表8-35に示します。

表8‒35　表情報で返される値の意味（VOS3 RDB1）

プロパティ／メソッド

値の説明

TableComment

表の注釈

TableCreateDate

'YYMMDDhhmmss'（YY：西暦の下2けた MM：月 DD：日 hh：時 mm：分 ss：秒）

TableDBMName

長さ0バイトの文字列

TableGroupName

表のグループ名

TableHeader

表の見出し

TableName

表名

TableOwner

表の所有者

(2)　列情報の値

列情報で返される値の意味を表8-36に示します。

表8‒36　列情報で返される値の意味（VOS3 RDB1）

プロパティ／メソッド

値の説明

ColumnComment

列の注釈

ColumnEditPattern

編集形式文字列

ColumnHeader

列の見出し

ColumnName

列名

(3)　集合関数（FunctionModeプロパティ）の規則

dbpGroupは，21列まで設定できます。ただし，ソートを設定した列数との和が22列以上は設定できません。

集合関数の設定は，列属性によっては使えない集合関数があります。列属性と使える集合関数の組み合わせを表8-37に示します。

表8‒37　列属性と使える集合関数の組み合わせ（VOS3 RDB1）

列属性

dbpGroup

dbpMaximum

dbpMinimum

dbpAverage

dbpSum

dbpCount

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

○

○

○

○

○

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

○

○

○

×

×

○

（凡例）

○：指定できます。

×：指定できません。

(4)　ソート（Column.SortModeプロパティ）の規則

21列まで指定できます。ただし，dbpGroupを設定した列数との和が22列以上は設定できません。

(5)　抽出条件（Conditions.Addメソッド）の規則

(a)　列と定数の比較条件の規則

列と定数の比較は，列属性によっては使えない定数があります。列属性と使える定数の組み合わせを表8-38に示します。

表8‒38　列属性と使える定数の組み合わせ（VOS3 RDB1）

列属性

定数

整数定数

10進数定数

浮動小数点定数

文字定数

漢字定数

dbpTypeINTEGER

dbpTypeNUMERIC

○

×

×

×

dbpTypeFLOAT

dbpTypeREAL

○

○

×

×

dbpTypeCHAR

dbpTypeVARCHAR

×

×

○

×

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

×

○

（凡例）

○：比較できます。

×：比較できません。

(b)　列と列の比較条件の規則

列と列の比較は，列属性によっては使えない組み合わせがあります。比較できる列属性の組み合わせを表8-39に示します。

表8‒39　比較できる列属性の組み合わせ（VOS3 RDB1）

左辺の列属性

右辺の列属性

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

×

×

dbpTypeCHAR

dbpTypeVARCHAR

×

○

×

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

○

（凡例）

○：比較できます。

×：比較できません。

(c)　IN条件の規則

定数の設定規則は，「表8-38　列属性と使える定数の組み合わせ（VOS3 RDB1）」に従ってください。

定数は，255個まで設定できます。

(d)　LIKE条件の規則

LIKE条件の設定は，列属性によっては使えないことがあります。LIKE条件が設定できる列属性を表8-40に示します。

表8‒40　LIKE条件が設定できる列属性（VOS3 RDB1）

列属性

設定できるかどうか

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

×

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

○

（凡例）

○：指定できます。

×：指定できません。

列と文字パターン（定数）の規則は，「表8-38　列属性と使える定数の組み合わせ（VOS3 RDB1）」に従ってください。

「_」，「%」は，指定する列属性に応じて，全角又は半角を使ってください。

定数

文字種別

文字定数

半角文字の「_」，「%」

各国文字定数

全角文字の「＿」，「％」

文字パターンの指定方法を表8-41に示します。

表8‒41　文字パターンの指定方法（VOS3 RDB1）

項目

指定例

意 味

前方一致

ABC%

先頭が「ABC」で，以降は任意の文字列を検索します。

後方一致

%ABC

最後が「ABC」で，それより前は任意の文字列を検索します。

任意一致

%ABC%

任意の部分が「ABC」の文字列を検索します。

完全一致

ABC

「ABC」と等しい文字列を検索します。

部分一致

_ _ABC_

6文字のうち，3〜5文字目が「ABC」で，ほかの部分は任意の文字列を検索します。

上記以外

ABC%DE

先頭が「ABC」で，最後が「DE」の文字列を検索します。

ABC_ _DE%

先頭が「ABC」で，2文字の任意の文字列をはさんで「DE」を含む文字列を検索します。

「%」は，二つ以上設定できません。「%」を二つ以上設定できるパターンは，任意一致のパターンだけです。A%B%C のようなパターンは設定できません。

(e)　BETWEEN条件の規則

列と定数の規則は，「表8-38　列属性と使える定数の組み合わせ（VOS3 RDB1）」に従ってください。

(f)　NULL条件の規則

制限事項はありません。

(g)　列演算条件の規則

演算を指定できる定数を次に示します。

整数定数，10進数定数，浮動小数点定数

演算を指定できる列属性を次に示します。

dbpTypeINTEGER，dbpTypeNUMERIC，dbpTypeFLOAT，dbpTypeREAL

演算は，各辺の「+」，「-」，「*」，「/」，又は「（」，「）」の総和が64個まで指定できます。

列と定数を比較するときは，「表8-38　列属性と使える定数の組み合わせ（VOS3 RDB1）」に従ってください。

(6)　条件関連（Conditions.Relationプロパティ）の規則

NOTは使えません。

括弧，AND及びORの優先順位は，括弧 ＞ AND ＞ ORです。

条件関連のネスト数は64までです。ネスト数はAND又はORに対して，優先順位を表す括弧を省略しないで指定したときの，左括弧の数です。

（例）

1 AND（（2 OR 3 AND 4）OR 5）AND 6のときに，括弧を省略しないと（1 AND（（（2 OR 3）AND 4）OR 5）AND 6）になって，ネスト数は4です。

括弧，AND及びORは，すべて半角文字で指定してください。

AND及びORの前後には空白を入力してください。

(7)　各条件で指定する定数の規則

各条件で指定する定数の規則を表8-42と表8-43に示します。

表8‒42　定数の指定方法（VOS3 RDB1）

定数の種類

指定方法

整数定数（2バイト）

［符号］符号なし整数

整数定数（4バイト）

［符号］符号なし整数

10進数定数

［符号］整数部.小数部

浮動小数点定数

［符号］仮数E［符号］指数

文字定数

［'］半角の文字列［'］

漢字定数

［'］全角の文字列［'］

表8‒43　定数の指定範囲（VOS3 RDB1）

定数の種類

指定範囲

指定例

整数定数（2バイト）

-32,768 〜 32,767

123，-123

整数定数（4バイト）

-2,147,483,648 〜 2,147,483,647

10進数定数

m：全けた数 n：小数点以下のけた数

M：列定義の全けた数 N：列定義の小数点けた数

1≦m≦M，1≦n≦N，n≦m

45.6，-45.6

浮動小数点定数

仮数16けた以内 指数 -99〜75

5.1E3，5.1E-3

文字定数

1〜255バイト

ABC

漢字定数

1〜127文字

テレビ

8.4.6　VOS1 ACE3ユーザファイルの場合の規則

(1)　表情報の値

表情報で返される値の意味を表8-44に示します。

表8‒44　表情報で返される値の意味（VOS1 ACE3ユーザファイル）

プロパティ／メソッド

値の説明

TableComment

表の注釈

TableCreateDate

'YYMMDDhhmmss'

（YY：西暦の下2けた MM：月 DD：日 hh：時 mm：分 ss：秒）

TableDBMName

長さ0バイトの文字列

TableGroupName

表のグループ名

TableHeader

表の見出し

TableName

表名（ただし，ACE3の設定でデータベースと混在させているときは，表名の後ろに「/F」が付きます）

TableOwner

表の所有者

(2)　列情報の値

列情報で返される値の意味を表8-45に示します。

表8‒45　列情報で返される値の意味（VOS1 ACE3ユーザファイル）

プロパティ／メソッド

値の説明

ColumnComment

列の注釈

ColumnEditPattern

編集形式文字列

ColumnHeader

列の見出し

ColumnName

列名

(3)　集合関数（FunctionModeプロパティ）の規則

dbpGroupは，21列まで設定できます。ただし，ソートを設定した列数との和が22列以上は設定できません。

集合関数の設定は，列属性によっては使えない集合関数があります。列属性と使える集合関数を表8-46に示します。

表8‒46　列属性と使える集合関数の組み合わせ（VOS1 ACE3ユーザファイル）

列属性

dbpGroup

dbpMaximum

dbpMinimum

dbpAverage

dbpSum

dbpCount

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

○

○

○

○

○

dbpTypeCHAR

dbpTypeVARCHAR

○

○

○

×

×

○

dbpTypeNCHAR

dbpTypeNVARCHAR

○

○

○

×

×

○

dbpTypeMCHAR

dbpTypeMVARCHAR

○

○

○

×

×

○

（凡例）

○：指定できます。

×：指定できません。

(4)　ソート（Column.SortModeプロパティ）の規則

21列まで指定できます。ただし，dbpGroupを設定した列数との和が22列以上は設定できません。

(5)　抽出条件（Conditions.Addメソッド）の規則

(a)　列と定数の比較条件の規則

列と定数の比較は，列属性によっては使えない定数があります。列属性と使える定数の組み合わせを表8-47に示します。

表8‒47　列属性と使える定数の組み合わせ（VOS1 ACE3ユーザファイル）

列属性

定数

整数定数

10進数定数

浮動小数点定数

文字定数

漢字定数

混在文字定数

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

×

×

×

dbpTypeCHAR

dbpTypeVARCHAR

×

○

×

×

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

○

×

dbpTypeMCHAR

dbpTypeMVARCHAR

×

○

○

○

（凡例）

○：比較できます。

×：比較できません。

(b)　列と列の比較条件の規則

列と列の比較は，列属性によっては使えない組み合わせがあります。比較できる列属性の組み合わせを表8-48に示します。

表8‒48　比較できる列属性の組み合わせ（VOS1 ACE3ユーザファイル）

左辺の列属性

右辺の列属性

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

dbpTypeMCHAR

dbpTypeMVARCHAR

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

○

×

×

×

dbpTypeCHAR

dbpTypeVARCHAR

×

○

×

○

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

○

×

dbpTypeMCHAR

dbpTypeMVARCHAR

×

○

×

○

（凡例）

○：比較できます。

×：比較できません。

(c)　IN条件の規則

定数の設定規則は，「表8-47　列属性と使える定数の組み合わせ（VOS1 ACE3ユーザファイル）」に従ってください。

定数は，255個まで設定できます。

(d)　LIKE条件の規則

LIKE条件の設定は，列属性によっては使えないことがあります。LIKE条件が設定できる列属性を表8-49に示します。

表8‒49　LIKE条件が設定できる列属性（VOS1 ACE3ユーザファイル）

列属性

設定できるかどうか

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeFLOAT

dbpTypeREAL

×

dbpTypeCHAR

dbpTypeNCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

dbpTypeMCHAR

dbpTypeMVARCHAR

○

（凡例）

○：指定できます。

×：指定できません。

列と文字パターン（定数）の規則は，「表8-47　列属性と使える定数の組み合わせ（VOS1 ACE3ユーザファイル）」に従ってください。

「_」，「%」は，指定する列属性に応じて，全角又は半角を使ってください。

定数

文字種別

文字定数

半角文字の「_」，「%」

各国文字定数

全角文字の「＿」，「％」

混在文字定数

半角文字の「_」，「%」

文字パターンの指定方法を表8-50に示します。

表8‒50　文字パターンの指定方法（VOS1 ACE3ユーザファイル）

項目

指定例

意 味

前方一致

ABC%

先頭が「ABC」で，以降は任意の文字列を検索します。

後方一致

%ABC

最後が「ABC」で，それより前は任意の文字列を検索します。

任意一致

%ABC%

任意の部分が「ABC」の文字列を検索します。

完全一致

ABC

「ABC」と等しい文字列を検索します。

部分一致

_ _ABC_

6文字のうち，3〜5文字目が「ABC」で，ほかの部分は任意の文字列を検索します。

上記以外

ABC%DE

先頭が「ABC」で，最後が「DE」の文字列を検索します。

ABC_ _DE%

先頭が「ABC」で，2文字の任意の文字列をはさんで「DE」を含む文字列を検索します。

「%」は，二つ以上設定できません。「%」を二つ設定できるのは，任意一致のパターンだけです。「A%B%C」のようなパターンは設定できません。

(e)　BETWEEN条件の規則

列と定数の規則は，「表8-47　列属性と使える定数の組み合わせ（VOS1 ACE3ユーザファイル）」に従ってください。

(f)　NULL条件の規則

制限事項はありません。

(g)　列演算条件の規則

演算を指定できる定数を次に示します。

整数定数，10進数定数，浮動小数点定数

演算を指定できる列属性を次に示します。

dbpTypeINTEGER，dbpTypeNUMERIC，dbpTypeFLOAT，dbpTypeREAL

演算は，各辺の「+」，「-」，「*」，「/」，又は「（」，「）」の総和が64個まで指定できます。

列と定数を比較するときは，「表8-47　列属性と使える定数の組み合わせ（VOS1 ACE3ユーザファイル）」に従ってください。

(6)　条件関連（Conditions.Relationプロパティ）の規則

NOTは使えません。

括弧，AND及びORの優先順位は，括弧 ＞ AND ＞ ORです。

条件関連のネスト数は64までです。ネスト数はAND又はORに対して，優先順位を表す括弧を省略しないで指定したときの，左括弧の数です。

（例）

1 AND（（2 OR 3 AND 4）OR 5）AND 6のときは，括弧を省略しないと（1 AND（（（2 OR 3）AND 4）OR 5）AND 6）になって，ネスト数は4です。

括弧，AND及びORは，すべて半角文字で指定してください。

AND及びORの前後には空白を入力してください。

(7)　各条件で指定する定数の規則

各条件で指定する定数の規則を表8-51と表8-52に示します。

表8‒51　定数の指定方法（VOS1 ACE3ユーザファイル）

定数の種類

指定方法

整数定数（2バイト）

［符号］符号なし整数

整数定数（4バイト）

［符号］符号なし整数

10進数定数

［符号］整数部.小数部

浮動小数点定数

［符号］仮数E［符号］指数

文字定数

［'］半角の文字列［'］

漢字定数

［'］全角の文字列［'］

混在文字定数

［'］全角及び半角の文字列［'］

表8‒52　定数の指定範囲（VOS1 ACE3ユーザファイル）

定数の種類

指定範囲

指定例

整数定数（2バイト）

-32,768 〜 32,767

123，-123

整数定数（4バイト）

-2,147,483,648 〜 2,147,483,647

10進数定数

m：全けた数 n：小数点以下のけた数

M：列定義の全けた数 N：列定義の小数点けた数

1≦m≦M，1≦n≦N，n≦m

45.6，-45.6

浮動小数点定数

仮数16けた以内 指数 -99〜75

5.1E3，5.1E-3

文字定数

1〜254バイト

ABC

漢字定数

1〜127文字

テレビ

混在文字定数

1〜254バイト

テレビABC

8.4.7　VOS3 ACE3ユーザファイルの場合の規則

(1)　表情報の値

表情報で返される値の意味を表8-53に示します。

表8‒53　表情報で返される値の意味（VOS3 ACE3ユーザファイル）

プロパティ／メソッド

値の説明

TableComment

表の注釈

TableCreateDate

'YYMMDDhhmmss'（YY：西暦の下2けた MM：月 DD：日 hh：時 mm：分 ss：秒）

TableDBMName

長さ0バイトの文字列

TableGroupName

表のグループ名

TableHeader

表の見出し

TableName

表名

ACE3の設定でデータベースと混在させているときは，表名の後ろに「/F」が付きます。

TableOwner

表の所有者

所有者が8バイト未満の場合は，後ろに空白文字が埋められます。

(2)　列情報の値

列情報で返される値の意味を表8-54に示します。

表8‒54　列情報で返される値の意味（VOS3 ACE3ユーザファイル）

プロパティ／メソッド

値の説明

ColumnComment

列の注釈

ColumnEditPattern

編集形式文字列

ColumnHeader

列の見出し

ColumnName

列名

(3)　集合関数（FunctionModeプロパティ）の規則

dbpGroupは，21列まで設定できます。ただし，ソートを設定した列数との和が22列以上は設定できません。

集合関数の設定は，列属性によっては使えない集合関数があります。列属性と使える集合関数の組み合わせを表8-55に示します。

表8‒55　列属性と使える集合関数の組み合わせ（VOS3 ACE3ユーザファイル）

列属性

dbpGroup

dbpMaximum

dbpMinimum

dbpAverage

dbpSum

dbpCount

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

dbpTypeFLOAT

dbpTypeREAL

○

○

○

○

○

○

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

dbpTypeMCHAR

dbpTypeMVARCHAR

dbpTypeDATE

dbpTypeINTERVAL_YEAR_TO_DAY

dbpTypeTIME

dbpTypeINTERVAL_HOUR_TO_SECOND

○

○

○

×

×

○

（凡例）

○：指定できます。

×：指定できません。

(4)　ソート（Column.SortModeプロパティ）の規則

21列まで指定できます。ただし，dbpGroupを設定した列数との和が22列以上は設定できません。

(5)　抽出条件（Conditions.Addメソッド）の規則

(a)　列と定数の比較条件の規則

列と定数の比較は，列属性によっては使えない定数があります。列属性と使える定数の組み合わせを表8-56に示します。

表8‒56　列属性と使える定数の組み合わせ（VOS3 ACE3ユーザファイル）

列属性

定数

整数定数

10進数定数

浮動小数点定数

文字定数

漢字定数

混在文字定数

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

dbpTypeFLOAT

dbpTypeREAL

○

×

×

×

dbpTypeCHAR

dbpTypeVARCHAR

×

○

×

×

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

○

×

dbpTypeMCHAR

dbpTypeMVARCHAR

×

○

○

○

dbpTypeDATE

dbpTypeINTERVAL_YEAR_TO_DAY

dbpTypeTIME

dbpTypeINTERVAL_HOUR_TO_SECOND

×

×

×

×

（凡例）

○：比較できます。

×：比較できません。

(b)　列と列の比較条件の規則

列と列の比較は，列属性によっては使えない組み合わせがあります。比較できる列属性の組み合わせを表8-57に示します。

表8‒57　比較できる列属性の組み合わせ（VOS3 ACE3ユーザファイル）

左辺の列属性

右辺の列属性

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

dbpTypeFLOAT

dbpTypeREAL

dbpTypeCHAR

dbpTypeVARCHAR

dbpTypeNCHAR

dbpTypeNVARCHAR

dbpTypeMCHAR

dbpTypeMVARCHAR

dbpTypeDATE

dbpTypeINTERVAL_YEAR_TO_DAY

dbpTypeTIME

dbpTypeINTERVAL_HOUR_TO_SECOND

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

dbpTypeFLOAT

dbpTypeREAL

〇

×

×

×

×

dbpTypeCHAR

dbpTypeVARCHAR

×

〇

×

〇

×

dbpTypeNCHAR

dbpTypeNVARCHAR

×

×

〇

×

×

dbpTypeMCHAR

dbpTypeMVARCHAR

×

〇

×

〇

×

dbpTypeDATE

dbpTypeINTERVAL_YEAR_TO_DAY

dbpTypeTIME

dbpTypeINTERVAL_HOUR_TO_SECOND

×

×

×

×

×

（凡例）

○：比較できます。

×：比較できません。

(c)　IN条件の規則

定数の設定規則は，「表8-56　列属性と使える定数の組み合わせ（VOS3 ACE3ユーザファイル）」に従ってください。

定数は，255個まで設定できます。

(d)　LIKE条件の規則

LIKE条件の設定は，列属性によっては使えないことがあります。LIKE条件が設定できる列属性を表8-58に示します。

表8‒58　LIKE条件が設定できる列属性（VOS3 ACE3ユーザファイル）

列属性

設定できるかどうか

dbpTypeINTEGER

dbpTypeNUMERIC

dbpTypeNUMERICUNS

dbpTypeFLOAT

dbpTypeREAL

dbpTypeDATE

dbpTypeINTERVAL_YEAR_TO_DAY

dbpTypeTIME

dbpTypeINTERVAL_HOUR_TO_SECOND

×

dbpTypeCHAR

dbpTypeNCHAR

dbpTypeVARCHAR

dbpTypeNVARCHAR

dbpTypeMCHAR

dbpTypeMVARCHAR

○

（凡例）

○：指定できます。

×：指定できません。

列と文字パターン（定数）の規則は，「表8-56　列属性と使える定数の組み合わせ（VOS3 ACE3ユーザファイル）」に従ってください。

「_」，「%」は，指定する列属性に応じて，全角又は半角を使ってください。

定数

文字種別

文字定数

半角文字の「_」，「%」

各国文字定数

全角文字の「＿」，「％」

混在文字定数

半角文字の「_」，「%」

文字パターンの指定方法を表8-59に示します。

表8‒59　文字パターンの指定方法（VOS3 ACE3ユーザファイル）

項目

指定例

意 味

前方一致

ABC%

先頭が「ABC」で，以降は任意の文字列を検索します。

後方一致

%ABC

最後が「ABC」で，それより前は任意の文字列を検索します。

任意一致

%ABC%

任意の部分が「ABC」の文字列を検索します。

完全一致

ABC

「ABC」と等しい文字列を検索します。

部分一致

_ _ABC_

6文字のうち，3〜5文字目が「ABC」で，ほかの部分は任意の文字列を検索します。

上記以外

ABC%DE

先頭が「ABC」で，最後が「DE」の文字列を検索します。

ABC_ _DE%

先頭が「ABC」で，2文字の任意の文字列をはさんで「DE」を含む文字列を検索します。

「%」は，二つ以上設定できません。「%」を二つ設定できるのは，任意一致のパターンだけです。「A%B%C」のようなパターンは設定できません。

(e)　BETWEEN条件の規則

列と定数の規則は，「表8-56　列属性と使える定数の組み合わせ（VOS3 ACE3ユーザファイル）」に従ってください。

(f)　NULL条件の規則

制限事項はありません。

(g)　列演算条件の規則

演算を指定できる定数を次に示します。

整数定数，10進数定数，浮動小数点定数

演算を指定できる列属性を次に示します。

dbpTypeINTEGER，dbpTypeNUMERIC，dbpTypeNUMERICUNS，dbpTypeFLOAT，dbpTypeREAL

演算は，各辺の「+」，「-」，「*」，「/」，又は「（」，「）」の総和が64個まで指定できます。

列と定数を比較するときは，「表8-56　列属性と使える定数の組み合わせ（VOS3 ACE3ユーザファイル）」に従ってください。

(6)　条件関連（Conditions.Relationプロパティ）の規則

NOTは使えません。

括弧，AND及びORの優先順位は，括弧 ＞ AND ＞ ORです。

条件関連のネスト数は64までです。ネスト数はAND又はORに対して，優先順位を表す括弧を省略しないで指定したときの，左括弧の数です。

（例）

1 AND（（2 OR 3 AND 4）OR 5）AND 6のときに，括弧を省略しないと（1 AND（（（2 OR 3）AND 4）OR 5）AND 6）になって，ネスト数は4です。

括弧，AND及びORは，すべて半角文字で指定してください。

AND及びORの前後には空白を入力してください。

(7)　各条件で指定する定数の規則

各条件で指定する定数の規則を表8-60と表8-61に示します。

表8‒60　定数の指定方法（VOS3 ACE3ユーザファイル）

定数の種類

指定方法

整数定数（2バイト）

［符号］符号なし整数

整数定数（4バイト）

［符号］符号なし整数

10進数定数

［符号］整数部.小数部

浮動小数点定数

［符号］仮数E［符号］指数

文字定数

［'］半角の文字列［'］

漢字定数

［'］全角の文字列［'］

混在文字定数

［'］全角及び半角の文字列［'］

表8‒61　定数の指定範囲（VOS3 ACE3ユーザファイル）

定数の種類

指定範囲

指定例

整数定数（2バイト）

-32,768 〜 32,767

123，-123

整数定数（4バイト）

-2,147,483,648 〜 2,147,483,647

10進数定数

m：全けた数 n：小数点以下のけた数

M：列定義の全けた数 N：列定義の小数点けた数

1≦m≦M，1≦n≦N，n≦m

45.6，-45.6

浮動小数点定数

仮数16けた以内 指数 -99〜75

5.1E3，5.1E-3

文字定数

1〜254バイト

ABC

漢字定数

1〜127文字

テレビ

混在文字定数

1〜254バイト

テレビABC

8.4.8　VOS1スプールファイルの場合の規則

(1)　表情報の値

表情報で返される値の意味を表8-62に示します。

表8‒62　表情報で返される値の意味（VOS1スプールファイル）

プロパティ／メソッド

値の説明

TableComment

ジョブに付けたコメント情報

TableCreateDate

'MM/DD hh：mm'（MM：月 DD：日 hh：時 mm：分）

TableDBMName

長さ0バイトの文字列

TableGroupName

表のグループ名

TableHeader

ジョブの名称

TableName

「ジョブ通し番号」，「分割番号」，「出力クラス」を連結した文字列

TableOwner

ジョブを実行したユーザID

(2)　列情報の値

列情報は取得できません。

(3)　集合関数（FunctionModeプロパティ）の規則

集合関数は設定できません。

(4)　ソート（Column.SortModeプロパティ）の規則

ソートは設定できません。

(5)　抽出条件（Conditions.Addメソッド）の規則

抽出条件は設定できません。

(6)　条件関連（Conditions.Relationプロパティ）の規則

条件関連は設定できません。

8.4.9　VOSKスプールファイルの場合の規則

(1)　表情報の値

表情報で返される値の意味を表8-63に示します。

表8‒63　表情報で返される値の意味（VOSKスプールファイル）

プロパティ／メソッド

値の説明

TableComment

ジョブに付けたコメント情報

TableCreateDate

'YYMMDDhhmmss'（YY：西暦の下2けた MM：月 DD：日 hh：時 mm：分 ss：秒）

TableDBMName

長さ0バイトの文字列

TableGroupName

表のグループ名

TableHeader

ジョブの名称

TableName

「ジョブ通し番号」，「ファイル通し番号」を連結した文字列

TableOwner

ジョブを実行したユーザID

(2)　列情報の値

列情報は取得できません。

(3)　集合関数（FunctionModeプロパティ）の規則

集合関数は設定できません。

(4)　ソート（Column.SortModeプロパティ）の規則

ソートは設定できません。

(5)　抽出条件（Conditions.Addメソッド）の規則

抽出条件は設定できません。

(6)　条件関連（Conditions.Relationプロパティ）の規則

条件関連は設定できません。

第6編　エラーの対処

9　トラブルが起こったときは

この章では，DBPARTNER2 Clientにトラブルが起こったときの対処について説明します。

9.1　トラブルの現象と対処

トラブルの現象と対処を示します。

9.1.1　インストール時に起こるトラブル

ODBCドライバのインストールで「上書きできないためインストールできない」ことを知らせるメッセージが出力された。

［無視］ボタンをクリックして，インストールを続行してください。

ODBCドライバのインストールで，インストール完了の通知がないまま終了した。

IME97の対策版がインストールされていません。Microsoft社に問い合わせて，IME97の対策版を入手してください。

9.1.2　データベースと接続するときに起こるトラブル

DBPARTNER2 Clientのドライバが一覧に表示されない。

ODBCドライバをインストールしてください。インストール手順については，「2.3　ODBCドライバのセットアップ」を参照してください。

データソースの一覧に，何も表示されない。

ODBC接続でデータソースに接続先を設定していないときは，［コントロールパネル］−［ODBCデータソース］アイコンを開いて［ユーザDSN］で接続先を設定してください。設定する手順については，「2.3　ODBCドライバのセットアップ」を参照してください。

ODBCドライバでエラーが表示された。

HiRDBに接続する場合

識別子を指定する必要はありません。

ORACLEに接続する場合

DABrokerとORACLEが同じマシン（WS又はPC）で動作している環境のときは，ネットサービス名を指定する必要がありません。

DABrokerとORACLEが異なるマシン（WS又はPC）で動作している環境，又は複数のORACLEが動作している環境では，ネットサービス名を指定する必要があります。

DABrokerが動作しているマシン（WS又はPC）からORACLEのユティリティを実行するときに指定するネットサービス名を指定してください。

エラー 10709（サーバとの接続に失敗）が出力された。

CommuniNetとCommuniNet Extensionの前提バージョンが正しいかどうかを確認してください。

CommuniNetの自動実行マクロを設定しているときは，設定を削除してください。

CommuniNetを表示させた状態で接続処理を実行して，ログオンマクロスクリプトに設定した文字列が正しく画面に表示されているかどうかを確認してください。

ログオンマクロスクリプトの実行中にエラーになるときは，マクロスクリプトの実行待ち時間を大きくしてください。

10709「サーバとの接続に失敗しました」が返される。

CommuniNetとCommuniNet Extensionの前提バージョンが正しいか確認してください。

CommuniNetの自動実行マクロが設定されている場合は，設定を削除してください

CommuniNetを表示させた状態から接続処理をして，LOGONマクロスクリプトに設定した文字列が正しく画面に入力されているか確認してください。

LOGONマクロスクリプト実行中にエラーが発生する場合は，マクロスクリプト実行待ち時間を大きくしてください。

9.1.3　DBPARTNER2 Clientの操作時に起こるトラブル

データを更新するメソッドを使ったアプリケーションがエラーになる。

インストールしているDBPARTNER2 Clientの型名（参照版／更新版／定義版）が正しいかどうかを確認してください。

更新機能のメソッドを使ったAPがエラーとなる。

インストールしているDBPARTNER2 Clientの形名を確認してください。

9.1.4　システムに関するトラブル

アプリケーションが異常終了した。

アプリケーション又はDBPARTNER2 Clientのどこが原因で異常終了したか示すメッセージが表示されます。DBPARTNER2 Clientに原因があるときは，保守契約内容に従って対処してください。

処理中にDBPARTNER2 Clientによって勝手にセッションが切られてしまった。

ODBC接続の場合は，ドライバの応答監視時間の設定を確認してください。

アプリケーションが異常終了した。

DBPARTNERが異常終了したメッセージが表示されます。保守契約内容に従い対処してください。

処理中にセッションが切られる。

ODBC接続の場合，応答監視時間の設定を確認してください。

10　メッセージの一覧

この章では，DBPARTNER2 Clientをインストールするときに出力されるメッセージの意味と，DBPARTNER ODBC Driverから通知されるメッセージの意味について説明します。

10.1　メッセージの形式と見方

DBPARTNER2 Clientのメッセージの形式と見方について説明します。

10.1.1　メッセージの形式

DBPARTNER2 Clientで表示されるメッセージは，メッセージのダイアログボックスに表示されます。形式を次に示します。

シンボルマーク

メッセージの種類を表したマークです。T（タイプコード）に対応しています。

XXX

メッセージを表示した製品を示します。

INS：DBPARTNER2 Clientのインストール関連のメッセージを示します。

DBL：DBPARTNER ODBC Driverのメッセージを示します。

nnnn

メッセージの通し番号です。

T

タイプコードです。次のように対応しています。

E（エラー）

情報の誤りが通知されるメッセージです。

I（インフォメーション）

情報が通知されるメッセージです。

W（ワーニング）

警告が通知されるメッセージです。

［OK］ボタン

メッセージのダイアログボックスを閉じます。

10.1.2　メッセージの見方

このマニュアルでは，メッセージを次の形式で説明しています。

XXX nnnn T　　　　　　　　　　　　　　　　　　　　　　　

メッセージテキスト

要因：メッセージが表示された原因

処理：DBPARTNER2の処理

対処：ユーザの処置

10.1.3　注意

「保守担当者に連絡してください」とは，システム管理者が購入時の契約に基づき当社問い合わせ窓口へ連絡することを示します。

エラーコード，シグナル番号などは，保守担当者が使う情報です。

サーバプログラムから通知されたメッセージについては，次に示すマニュアルを参照してください。

「DABroker」

データベースから通知されたメッセージについては，該当するデータベース（DBMS）のマニュアルを参照してください。

10.2　メッセージの詳細

このマニュアルでは，次に示すメッセージについて説明します。

DBPARTNER2 Clientのインストールのメッセージ

DBPARTNER ODBC Driver（ODBCドライバ）のメッセージ

CommuniNet接続のときに表示される，サーバからのメッセージについては，マニュアル「DBPARTNER2 Client　操作ガイド」を参照してください。

10.2.1　DBPARTNER2 Clientのインストールのメッセージ

DBPARTNER2 Clientをインストールするときに出力されるメッセージを示します。

INS0101E

インストールで使用するフロッピーディスク中のファイルが正しくありません。又はファイルがありません。インストールを終了します。

要因：インストールで使うフロッピーディスク中のファイルに誤りがあるか，又はファイルがありません。

対処：正しいインストール用のフロッピーディスクを使って，インストールを再実行してください。

INS0102W

ディレクトリaaaaを作成することができません。

要因：フォルダ（aaaa）を作成できません。

対処：フォルダと同名のファイルがあるおそれがあります。その場合，指定するフォルダを変更してください。その後も同じエラーが繰り返し起こるときは，保守担当者に連絡してください。

INS0103E

Windowsのバージョンが違います。インストールを終了します。

要因：DBPARTNER2 Clientを稼働できるWindowsではありません。

対処：DBPARTNER2 Clientを稼働できるWindowsをインストールして，DBPARTNER2 Clientのインストールを再実行してください。

INS0104E

新しいDBPARTNER2 Clientがインストールされています。インストールを終了します。

要因：インストール先に，現在インストール中のDBPARTNER2 Clientよりも新しいバージョンのものがインストールされています。

対処：古いバージョンのDBPARTNER2 Clientはインストールできません。同じ又は新しいバージョンのDBPARTNER2 Clientをインストールしてください。

INS0105W

指定されたディレクトリが正しくありません。

要因：フォルダ名の指定が間違っています。

対処：フォルダ名を正しく指定して，再実行してください。

INS0106W

ドライブaaに，DBPARTNER2 Client nnnnをインストールするだけの容量がありません。インストールにはmmmmmバイトの容量を確保してください。

要因：aaで示すインストール先のドライブに，DBPARTNER2 Clientをインストールするための容量が不足しています。mmmmmバイト以上を確保してください。

nnnn：DBPARTNER2 Clientのバージョン番号

対処：インストール先ドライブの不要ファイルの削除などで，DBPARTNER2 Clientをインストールするために必要な容量を確保して，インストールを再実行してください。

INS0107W

ドライブの指定が誤っています。正しいドライブを指定してください。

要因：指定されたパスのドライブの指定に間違いがあります。

対処：存在するドライブ名を正しく英字で指定して，再実行してください。

INS0108E

Windows又はインストールプログラムに異常があります。インストールを終了します（nnnn）。

要因：Windowsのシステム又はインストールプログラムで異常が発生しました。

nnnn：保守コード

対処：DBPARTNER2 Clientを終了して，保守担当者に連絡してください。

INS0109W

組み込みディレクトリに，必要なファイルがありません。ActiveXコントロールを選択してください。

要因：組み込みフォルダに，必要なファイルがありません。

対処：ActiveXコントロールを選択して，再実行してください。

INS0110W

ディレクトリの長さがnnnnバイトを超えています。

要因：フォルダ名の長さ（完全パス名から¥ファイル名を除いたもの）が，nnnnバイトを超えています。

対処：フォルダ名の長さをnnnnバイト以内に指定し直してください。

INS0111E

本プログラムはnnnnでは動作しません。mmmmで実行してください。

要因：現在起動しているOS（nnnn）では動作しません。このプログラムはOS（mmmm）で動作します。

nnnn：動作できないOS

mmmm：動作できるOS

対処：このプログラムではmmmmのどれかのOSで起動して，実行してください。

INS0112E

このプログラムはVGAか，それ以上の解像度で実行してください。

要因：解像度がVGA以上でないため，インストールが実行できません。

対処：VGAか，それ以上の解像度に変更して，再実行してください。

INS0113I

いくつかのファイルを他のプログラムが使用しているため，インストールすることができませんでした。システムを再起動するとファイルを更新します。

要因：一部のファイルをほかのプログラムが使っているため，インストールできませんでした。

対処：インストールできなかったファイルを更新するためには，システムを再起動してください。

INS0114W

ActiveXコントロールの登録ができません。

要因：ActiveXコントロールの登録に失敗しました。

対処：インストールを再実行してください。

INS0115W

インストールするコンポーネントが指定されていません。

要因：インストールするコンポーネントを何も指定していません。

対処：インストールするコンポーネントを一つ以上指定してから，再実行してください。

10.2.2　DBPARTNER ODBC Driverのメッセージ

DBPARTNER ODBC Driver（ODBCドライバ）のメッセージを示します。

DBL0001E

RDA Link定義ユティリティが見つかりませんでした。RDA Link定義ユティリティがインストールされているか確認してください。

要因：ネットワーク定義をするためにはRDA Link定義ユティリティが必要です。RDA Link定義ユティリティがインストールされていないか，又はインストールが失敗しているおそれがあります。DBPARTNER ODBC Driverは，処理を終了します。

対処：RDA Link定義ユティリティをインストールしていないときは，インストールを実行してください。RDA Link定義ユティリティのインストールが失敗していると考えられるときは，インストールを再実行してください。

DBL0002E

RDA Link定義ユティリティの起動に必要なメモリが不足しています。他のアプリケーションプログラムを終了し，再度ネットワーク定義をクリックしてRDA Link定義ユティリティを起動してください。

要因：ネットワーク定義をするためのRDA Link定義ユティリティの起動に必要なメモリが不足しています。DBPARTNER ODBC Driverは，処理を終了します。

対処：ほかのアプリケーションを終了してから［ネットワーク定義］をやり直した後，RDA Link定義ユティリティを起動してください。

DBL0003E

RDA Linkのバージョンが違います。

要因：DBPARTNER2 Clientを稼働できるバージョンのRDA Linkではありません。DBPARTNER ODBC Driverは，処理を終了します。

対処：DBPARTNER2 Clientを稼働できるバージョンのRDA Linkをインストールして，再実行してください。

DBL0010E

応答監視時間の指定に誤りがあります。

要因：応答監視時間に0〜3600の整数以外の値を指定しています。DBPARTNER ODBC Driverは，次の処理の入力待ちとなります。

対処：0〜3600の整数を指定してから，再実行してください。

DBL0020E

送受信領域サイズに数字以外の文字が指定されました。

要因：送受信領域サイズに数字以外の文字を指定しています。ODBCドライバは，次の処理の入力待ちになります。

対処：送受信領域サイズを数字で指定してから，再実行してください。

DBL0030E

受信データ件数に数字以外の文字が指定されました。

要因：受信データ件数の指定に，数字以外の文字を指定しています。DBPARTNER ODBC Driverは，次の処理の入力待ちになります。

対処：受信データ件数を数字で指定してから，再実行してください。

DBL0100E

通信ドライバの指定が不正なため，処理を中止しました。

要因：DABrokerドライバをインストールしてから 一度も通信ドライバを設定していないか，又は環境定義が破壊されているおそれがあります。DBPARTNER ODBC Driverは，処理を終了します。

対処：［DBPARTNER ODBC Driver for DABroker−環境定義−］ダイアログボックスで，通信ドライバを設定してください。

DBL0101E

指定された通信ドライバに対応したDBPARTNER ODBC Driverドライバが見つかりませんでした。

要因：環境定義に指定した通信ドライバに対応するDABrokerドライバがインストールされていないか，又は所定のフォルダから移動されているおそれがあります。DBPARTNER ODBC Driverは，処理を終了します。

対処：通信ドライバに対応したDABrokerドライバをインストールした後，再実行してください。

DBL0401E

システムコールでエラーが発生しました。［XXXX（），errno＝YYYY］

要因：OSのシステムコール関数がエラーになりました。ODBCドライバは，処理を終了します。

XXXX：システムコール名

YYYY：エラー番号

対処：操作を再実行してください。その後も同じエラーが繰り返し起こるときは，保守担当者に連絡してください。

DBL0900E

受信バッファが破壊されています。保守担当者に連絡してください。

要因：受信バッファのデータが，途中で破壊されました。DBPARTNER ODBC Driverは，処理を終了します。

対処：［DBPARTNER ODBC Driver for DABroker−セットアップ−］ダイアログボックスの設定の，受信データ件数の設定値を少なくしてから，再実行してください。設定値を少なくしても同じエラーになるときは，保守担当者に連絡してください。

DBL1001E

通信ドライバのローディングに失敗しました。

要因：下位の通信ドライバのローディングに失敗しました。DBPARTNER ODBC Driverは，処理を終了します。

対処：次の処置をしてください。

通信ドライバをインストールしているかどうかを確認してください。

DABrokerドライバをセットアップしたときの，通信ドライバの選択が正しいかどうかを確認してください。

DBL1002E

コネクション確立時，ソケットのオープンに失敗しました。［errno＝XXXX］

要因：コネクションを確立しようとしましたが，空いているソケットがありません。DBPARTNER ODBC Driverは，処理を終了します。

XXXX：エラーコード

対処：ほかのアプリケーションが終了するのを待ってから，再実行してください。再実行してもエラーが起こるときは，通信ドライバに設定するソケット数を増やしてください。ソケット数の設定については，通信ドライバのマニュアル又はヘルプを参照してください。

DBL1003E

コネクション確立時にTCPコネクション確立処理に失敗しました。［errno＝XXXX］

要因：コネクションを確立時にTCPコネクション確立処理に失敗しました。DBPARTNER ODBC Driverは，処理を終了します。

XXXX：エラーコード

対処：次に示す処置をしてください。

一定時間後，再実行してください。

サーバプログラム（DABroker，Database Connection Server）又はサーバプログラム下の通信プログラムがエラーになっていないかどうかを確認してください。

通信ドライバに登録したインターネットアドレスを見直してください。

ポート番号を見直してください。

回線の接続状態を調査してください。

TCP/IPを使っているほかのアプリケーションを終了させるか，又は通信ドライバに設定するTCPコネクションの数を増やしてください。

DBL1004E

コネクションが切断されました。［errno＝XXXX］

要因：データの送受信時にコネクションが切断されました。DBPARTNER ODBC Driverは，処理を終了します。

XXXX：エラーコード

対処：次に示す処置をしてください。

一定時間後，再実行してください。

サーバプログラム（DABroker，Database Connection Server）又はサーバプログラム下の通信プログラムがエラーになっていないかどうかを確認してください。

回線の接続状態を調査してください。

サーバプログラムの動作環境設定ファイルの内容とDABrokerドライバをセットアップしたときの設定内容を見直してください。

DBL1005E

応答監視時間を超えました。

要因：データの送受信時に応答監視時間を超えました。DBPARTNER ODBC Driverは，処理を終了します。

対処：サーバプログラム（DABroker，Database Connection Server）がエラーになっていないかどうかを確認してください。エラーになっていないときは，DABrokerドライバの［DBPARTNER ODBC Driver for DABroker−環境定義−］ダイアログボックスで設定した応答監視時間の値を大きくしてください。

DBL1006E

インタネットアドレスが取得できません。

要因：接続先のインターネットアドレスが取得できません。DBPARTNER ODBC Driverは，処理を終了します。

対処：通信ドライバの接続先のインターネットアドレスが登録されているかどうかを確認してください。

DBL1007E

通信時に異常が発生しました。［errno＝XXXX］

要因：サーバとの通信時に異常が起こりました。DBPARTNER ODBC Driverは，処理を終了します。

XXXX：エラーコード

対処：環境が壊れているおそれがあります。ODBCドライバを再インストールしてください。再インストールしても同じエラーとなるときは，保守員に連絡してください。

DBL1010E

HITSENSER5以外からDIAPRISMはアクセスできません。

要因：HITSENSER5以外からDIAPRISMはアクセスできません。

処理：処理を終了します。

対処：DIAPRISMにアクセスする場合はHITSENSER5を使用してください。

DBL1011E

接続したデータベースとデータソースに指定したデータベースの種類が異なります。

要因：接続したデータベースとデータソースに指定したデータベースの種類が異なります。

処理：処理を終了します。

対処：データソースに指定したデータベース識別子が正しいかどうか見直してください。

DBL2001E

ユーザ外字ファイルのOPENに失敗しました。

要因：ファイルが見付からない，オープンされているファイルが多過ぎるなどの理由で，指定したユーザ外字ファイルをオープンできません。DBPARTNER ODBC Driverは，処理を終了します。

対処：ファイルを使える状態かどうかを調べて，使えない状態のときは原因を取り除いてから，再実行してください。

DBL2002E

ユーザ外字ファイルのREADに失敗しました。

要因：ユーザ外字ファイルの読み込み中にエラーが起こりました。DBPARTNER ODBC Driverは，処理を終了します。

対処：ファイルを使える状態かどうかを調べて，使えない状態のときは原因を取り除いてから，再実行してください。

DBL2003E

ユーザ外字ファイルの内容が不正です。

要因：ユーザ外字ファイルに指定した内容が間違っています。DBPARTNER ODBC Driverは，処理を終了します。

対処：ユーザ外字ファイルの内容を見直して，間違いがあるときは記述内容を修正してから，再実行してください。

DBL9001E

新しい DBPARTNER ODBC Driver がインストールされています。インストールを終了します。

要因：インストール先に，現在インストール中のDBPARTNER ODBC Driverよりも新しいバージョンのものがインストールされています。DBPARTNER ODBC Driverは，処理を終了します。

対処：現在インストールされているものより古いバージョンのDBPARTNER ODBC Driverはインストールできません。同じ，又は新しいバージョンのDBPARTNER ODBC Driverをインストールしてください。

DBL9002W

ディレクトリの長さがXXXXバイトを超えています。

要因：フォルダ名の長さ（絶対パス名から¥ファイル名を除いたもの）が，XXXXバイトを超えています。DBPARTNER ODBC Driverは，次の処理要求を待ちます。

対処：フォルダ名の長さをXXXXバイト以内で指定し直してください。

DBL9003E

システム又は，インストールプログラムに異常があります。インストールを終了します。（XXXX）

XXXX：保守コード

要因：システム又はインストールプログラムで異常が発生しました。DBPARTNER ODBC Driverは，処理を終了します。

対処：再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

DBL9004E

DBPARTNER ODBC Driverが稼動できるシステムのバージョンではありません。

要因：DBPARTNER ODBC Driverが稼働できるシステムのバージョンではありません。DBPARTNER ODBC Driverは，処理を終了します。

対処：DBPARTNER ODBC Driverが稼働できるシステムのバージョンをインストールして，DBPARTNER ODBC Driverのインストールを再実行してください。

DBL9005E

XXXXには，DBPARTNER ODBC Driverをインストールするだけの容量がありません。インストールには，YYYYバイトの容量を確保してください。

XXXX：インストール先ディレクトリ

要因：XXXXで示すドライブに，DBPARTNER ODBC Driverをインストールするための容量が不足しています。YYYYバイト以上の容量を確保してください。DBPARTNER ODBC Driverは，次の処理要求を待ちます。

対処：XXXXで示すドライブの不要なファイルの削除などで，DBPARTNER ODBC Driverをインストールするために必要な容量を確保して，インストールを再実行してください。

DBL9006E

DBPARTNER ODBC DriverのDLLファイル（XXXX）は，現在使用中のためインストールすることができません。

XXXX：ファイル名

要因：XXXXで示すファイルが使用中のため，インストールできません。DBPARTNER ODBC Driverは，処理を終了します。

対処：XXXXで示すファイルを使用しているプログラムを終了して，インストールを再実行してください。

DBL9007E

DBPARTNER ODBC Driverのインストールファイル転送中にエラーが発生しました（XXXX,YYYY）。

XXXX：エラーコード

YYYY：ファイル名

要因：DBPARTNER ODBC Driverのインストールファイル転送中にエラーが発生しました。DBPARTNER ODBC Driverは，処理を終了します。

対処：再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

DBL9008E

DBPARTNER ODBC Driverのインストール起動パラメタ解析中にエラーが発生しました。

要因：DBPARTNER ODBC Driverのインストール起動パラメタ解析中にエラーが発生しました。DBPARTNER ODBC Driverは，処理を終了します。

対処：再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

DBL9009E

OSの画面情報の取得に失敗しました。

要因：OSの画面情報の取得に失敗しました。DBPARTNER ODBC Driverは，処理を終了します。

対処：再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

DBL9010E

ドライバに関する情報のレジストリ登録に失敗しました。

要因：ドライバに関する情報のレジストリ登録に失敗しました。DBPARTNER ODBC Driverは，処理を終了します。

対処：再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

DBL9011W

コンポーネントが一つも選択されていません。一つ以上のコンポーネントを選択してください。

要因：コンポーネントが一つも選択されていません。DBPARTNER ODBC Driverは，次の処理要求を待ちます。

対処：一つ以上のコンポーネントを選択してください。

付録

付録A　AP作成ウィザード

AP作成ウィザードは，DBPARTNER2 Clientが提供するActiveXコントロールを使用したアプリケーションを作成するためのプログラムです。AP作成ウィザードを使用すると，ActiveXコントロールのオブジェクトを意識することなく，データベースからデータを抽出するアプリケーションが作成できます。

ただし，AP作成ウィザードでは，アプリケーションの実行ファイルは作成できません。AP作成ウィザードは，アプリケーションの実行ファイルの作成に必要となるVisual Basicのプロジェクトを作成するだけです。アプリケーションの実行ファイルを作成するには，AP作成ウィザード以外にVisual Basicが必要です。

AP作成ウィザードを使用して作成できるアプリケーションは，Visual Basic 5.0以降に対応します。

付録A.1　アプリケーション作成の流れ

アプリケーションを作成するには，AP作成ウィザードとVisual Basicを使用します。次に，AP作成ウィザードとVisual Basicを使用してアプリケーションを作成する処理の流れについて説明します。

図A‒1　アプリケーションの作成の流れ

(1)　AP作成ウィザードでの処理

AP作成ウィザードでは，データベースからデータを抽出するための情報（表名，列名，条件など）を設定し，アプリケーションの実行ファイルの作成に必要となるVisual Basicのプロジェクト（*.frm，*.bas，*.vbpなどのファイル）を自動作成します。

AP作成ウィザードでは，表示されるダイアログボックスに従って操作するだけで，データを抽出するための情報設定からVisual Basicのプロジェクトの自動作成までの処理ができます。AP作成ウィザードのダイアログボックスの名称と，各ダイアログボックスで設定する情報の概要を次に示します。

［ActiveX種別設定］：ActiveXコントロールを選択します。

［接続先設定］：接続先を設定します。

［抽出表設定］：データを抽出する表名を設定します。

［抽出条件設定］：データを抽出する条件を設定します。

［抽出列設定］：データを抽出する列名を設定します。

［ソート設定］：抽出列にソートを設定します。

［集合関数設定］：抽出列に集合関数を設定します。

［プロジェクト設定］：プロジェクト及びAPの作成を確認します。

(2)　VisualBasicでの処理

Visual Basicでは，AP作成ウィザードで作成したプロジェクト（*.frm，*.bas，*.vbpなどのファイル）を編集してアプリケーションの実行ファイル（*.exe）を作成します。

付録A.2　AP作成ウィザードの起動と終了

AP作成ウィザードを起動，終了する操作について，次に説明します

(1)　AP作成ウィザードの起動

AP作成ウィザードは，［スタート］メニューから［プログラム］−［DBPARTNER2］−［AP作成ウィザード］を選択することで起動できます。この操作によってAP作成ウィザードが起動し，次に示すダイアログボックスが表示されます。

(2)　AP作成ウィザードの終了

AP作成ウィザードを終了するには，最後に表示される［プロジェクト設定］ダイアログボックスの［終了］ボタンをクリックします。この操作によってダイアログボックスが閉じ，AP作成ウィザードが終了します。

また，次に示す操作でもAP作成ウィザードを終了させることができます。

ダイアログボックスの［キャンセル］ボタンをクリックする。

ダイアログボックスのタイトル部分の左端にあるアイコンをクリックし，表示されたシステムメニューで［閉じる］メニューをクリックする。

ダイアログボックスのタイトル部分の右端にある［×］をクリックする。

付録A.3　AP作成ウィザードの操作

AP作成ウィザードは，表示されるダイアログボックスに従って操作します。ダイアログボックスに従って操作すると，プログラミングの知識がなくてもアプリケーションを作成できます。

AP作成ウィザードのダイアログボックスの表示順序，名称，及び各ダイアログボックスで設定する情報の概要を表A-1に示します。

表A‒1　AP作成ウィザードのダイアログボックス

表示順

ダイアログボックス名

設定内容

1

［ActiveX種別設定］

ActiveXコントロールを選択します

2

［接続先設定］

接続先を設定します

3

［抽出表設定］

データを抽出する表名を設定します

4

［抽出条件設定］

データを抽出する条件を設定します

5

［抽出列設定］

データを抽出する列名を設定します

6

［ソート設定］

抽出列にソートを設定します

7

［集合関数設定］

抽出列に集合関数を設定します

8

［プロジェクト設定］

プロジェクト及びAPの作成を確認します

(1)　ActiveXコントロールを選択する：［ActiveX種別設定］

アプリケーションで使用するActiveXコントロールの種別を選択します。

●指定項目の説明

・［使用するコントロール(A)］

ActiveXコントロールの種別を選択します。

ODBC接続用ActiveX

CommuniNet接続用ActiveX

●ボタンの説明

・［戻る(B)］

このダイアログボックスでは無効（不活性）です。

・［次へ(N)］

次のダイアログボックスに進みます。

・［キャンセル］

AP作成ウィザードを終了します。

(2)　接続先を設定する：［接続先設定］

AP作成ウィザードがデータベースに接続するための情報を設定します。

データベースに接続するための情報は，使用するActiveXコントロールによって異なります。

(a)　ODBC接続用ActiveXコントロールの場合

●指定項目の説明

・［接続先(C)］

使用するデータソース名を指定又は選択します。

選択肢には端末に登録されているデータソースを表示します。

・［ユーザID(U)］

サーバに接続するユーザID（32文字以内）を指定します。

・［パスワード(P)］

［ユーザID］テキストボックスに指定したIDのパスワード（32文字以内）を指定します。

・［［ユーザID/パスワード入力］ダイアログボックスを表示する(V)］

アプリケーションの起動時に［ユーザID/パスワード入力］ダイアログボックスを表示する場合，チェックします。

チェックがない場合，［ユーザID(U)］，［パスワード(P)］テキストボックスに設定した内容でデータベースに接続します。

●ボタンの説明

・［戻る(B)］

前のダイアログボックスに戻ります。この画面で設定した内容は破棄されます。

・［次へ(N)］

次のダイアログボックスに進みます。

・［キャンセル］

AP作成ウィザードを終了します。

(b)　CommuniNet接続用ActiveXコントロールの場合

●指定項目の説明

・［端末名称(C)］

通信に使用するCommuniNetの端末名称（14文字以内）を指定します。

・［ユーザID(U)］

サーバに接続するユーザID（8文字以内）を指定します。

・［パスワード(P)］

［ユーザID］テキストボックスに指定したIDのパスワード（8文字以内）を指定します。

・［データベース種別(D)］

使用するデータベースの種別を選択します。

VOS3 XDM/RD E2

VOS3 XDM/SD E2

VOS3 PDMII E2

VOS3 ACE3 ユーザファイル

VOS3 RDB1

VOSK RDB編成ファイル

VOS1 PDMII E2

VOS1 ACE3 ユーザファイル

VOS3 XDM/SD E2を選択した場合，参照パスワードが設定されている表には［抽出表設定］ダイアログボックスでの設定だけができます。［抽出条件設定］，［抽出列設定］，［ソート設定］，［集合関数設定］ダイアログボックスでの設定はできません。

・［サーバ種別(S)］

使用するサーバプログラムを選択します。

HOAPDBS E2，HOAPDBS/PC

DBPARTNER/Link，ACE3 E3

・［ログオン用マクロスクリプト(L)］

サーバプログラムと接続するための，ログオン操作を登録したマクロスクリプトのファイル名を完全パス（256文字以内）で指定します。フォルダを含まないファイル名を指定した場合は，CommuniNetをインストールしたフォルダの¥Macroフォルダを検索します。

右端の［…］ボタンをクリックすることで，ファイル選択の画面から指定できます。

・［ログオフ用マクロスクリプト(F)］

サーバプログラムとの接続を終了するための，ログオフ操作を登録したマクロスクリプトのファイル名を完全パス（256文字以内）で指定します。フォルダを含まないファイル名を指定した場合は，CommuniNetをインストールしたフォルダの¥Macroフォルダを検索します。

右端の［…］ボタンをクリックすることで，ファイル選択の画面から指定できます。

・［［ユーザID/パスワード入力］ダイアログボックスを表示する(V)］

アプリケーションの起動時に［ユーザID/パスワード入力］ダイアログボックスを表示する場合，チェックします。

チェックがない場合，［ユーザID(U)］，［パスワード(P)］テキストボックスに設定した内容でデータベースに接続します。

●ボタンの説明

・［戻る(B)］

前のダイアログボックスに戻ります。この画面で設定した内容は破棄されます。

・［次へ(N)］

次のダイアログボックスに進みます。

・［キャンセル］

AP作成ウィザードを終了します。

(3)　データを抽出する表名を設定する：［抽出表設定］

データを抽出する表を選択します。

表を選択するには，［表(T)］リストボックスで表の名称を選択した後，［>］ボタンをクリックします。選択した表の名称が［選択表(S)］リストボックスに表示されます。

表の選択を解除するには，［選択表(S)］リストボックスで選択を解除する表の名称をクリックした後，［<］ボタンをクリックします。選択を解除した表の名称が［選択表(S)］リストボックスから消えます。

●表示/指定項目の説明

・［表名］

［表(T)］リストボックスで選択（反転表示）している表の名称が表示されます。

・［表(T)］

データベースに定義されている表の名称が表示されます。

・［選択表(S)］

選択した表の名称が表示されます。

●ボタンの説明

・［＞］

［表(T)］リストボックスで選択（反転表示）している表を選択します。選択した表の名称が［選択表(S)］リストボックスに表示されます。

・［＜］

［選択表(S)］リストボックスで選択（反転表示）している表の選択を解除します。選択を解除した表の名称が［選択表(S)］リストボックスから消えます。

・［戻る(B)］

前のダイアログボックスに戻ります。この画面で設定した内容は破棄されます。

・［次へ(N)］

次のダイアログボックスに進みます。

・［完了(X)］

最後のダイアログボックスに進みます。

・［キャンセル］

AP作成ウィザードを終了します。

(4)　データを抽出する条件を設定する：［抽出条件設定］

データを抽出する条件を設定します。

抽出条件を設定するには，［列名(C)］，［述語(J)］，［値(V)］の各コンボボックスで条件を設定した後，［▽追加(A)］ボタンをクリックします。設定した抽出条件が，［条件(L)］リストボックスに表示されます。

設定した抽出条件を削除するには，［条件(L)］リストボックスで削除する条件を選択した後，［△削除(D)］ボタンをクリックします。削除した抽出条件が，［条件(L)］リストボックスから消えます。

●表示/指定項目の説明

・［列名(C)］

抽出条件の左辺とする列名を選択します。

・［述語(J)］

列名と値をつなぐ述語を選択します。

"="，"<>"，"<="，"<"，">="，">"，

"LIKE"，"NOT LIKE"，"IS NULL"，"IS NOT NULL"

・［値(V)］

抽出条件の右辺とする値（256文字以内）を指定します。

列比較条件の右辺とする列名を選択することもできます。

［述語(J)］コンボボックスで"IS NULL"又は"IS NOT NULL"を選択した場合，この項目を指定する必要はありません。

・［属性］

［列名(C)］リストボックスで選択している列の属性が表示されます。

・［条件(L)］

設定した抽出条件が表示されます。

右辺に定数を設定した抽出条件は，先頭をチェックすることでアプリケーションの実行時に定数の値が変更できます。

・［条件関連(R)］

設定した抽出条件の関連を256文字以内で設定します。

抽出条件の関連は，抽出条件の番号と"AND"，"OR"，"NOT"を使用して設定します。

（例）

1 AND 2 OR 3

●ボタンの説明

・［▽追加(A)］

［列名(C)］，［述語(J)］，［値(V)］の各コンボボックスで指定している抽出条件を設定します。設定した抽出条件は，［条件(L)］リストボックスに表示されます。

・［△削除(D)］

［条件(L)］リストボックスで選択（反転表示）している抽出条件を削除します。削除した抽出条件は，［条件(L)］リストボックスから消えます。

・［戻る(B)］

前のダイアログボックスに戻ります。この画面で設定した内容は破棄されます。

・［次へ(N)］

列を選択した場合は，次のダイアログボックスに進みます。

列を選択していない場合は，最後のダイアログボックスに進みます。

・［完了(X)］

最後のダイアログボックスに進みます。

・［キャンセル］

AP作成ウィザードを終了します。

(5)　データを抽出する列名を設定する：［抽出列設定］

データを抽出する列を選択します。

抽出する列を選択するには，［列(C)］リストボックスで列を選択した後，［>］ボタンをクリックします。選択した列が，［抽出列(S)］リストボックスに表示されます。［>>］ボタンですべての列を一括して選択できます。

列の選択を解除するには，［抽出列(S)］リストボックスで列を選択した後，［<］ボタンをクリックします。選択を解除した列が，［抽出列(S)］リストボックスから消えます。［<<］ボタンですべての列の選択を一括して解除できます。

●表示/指定項目の説明

・［列名］

［列(C)］リストボックスで選択（反転表示）している列の名称が表示されます。

・［列(C)］

［抽出表設定］ダイアログボックスで選択した表に定義されている列が表示されます。

・［抽出列(S)］

選択した列の名称が表示されます。

初期表示は，［列(C)］リストボックスと同一の内容です。

●ボタンの説明

・［＞］

［列(C)］リストボックスで選択（反転表示）している列を，抽出する列として選択します。選択した列が，［抽出列(S)］リストボックスに表示されます。

・［>>］

［列(C)］リストボックスに表示されているすべての列を，抽出する列として選択します。選択した列が，［抽出列(S)］リストボックスに表示されます。

・［＜］

［抽出列(S)］リストボックスで選択（反転表示）している列を，抽出する列から削除します。削除した列は，［抽出列(S)］リストボックスから消えます。

・［<<］

［抽出列(S)］リストボックスに表示されているすべての列を，抽出する列から削除します。削除した列は，［抽出列(S)］リストボックスから消えます。

・［戻る(B)］

前のダイアログボックスに戻ります。この画面で設定した内容は破棄されます。

・［次へ(N)］

次のダイアログボックスに進みます。

・［完了(X)］

最後のダイアログボックスに進みます。

・［キャンセル］

AP作成ウィザードを終了します。

(6)　抽出列にソートを設定する：［ソート設定］

抽出したデータ（列）にソートを設定します。

ただし，［抽出列設定］ダイアログボックスで列を選択していない場合はソートを設定できません。

列にソートを設定するには，［列(C)］リストボックスで列を選択した後，［▲昇順(A)］ボタン又は［▼降順(D)］ボタンをクリックします。ソートを設定した列が，［ソート(S)］リストボックスに表示されます。

ソートの設定を解除するには，［ソート(S)］リストボックスで列を選択した後，［削除(E)］ボタンをクリックします。ソートの設定を解除した列が，［ソート(S)］リストボックスから消えます。

●表示項目の説明

・［列(C)］

［抽出列設定］ダイアログボックスで選択した列が表示されます。

・［ソート(S)］

ソートを設定した列の名称が表示されます。

各列の右側に，設定されているソート順（▲：昇順，▼：降順）が表示されます。

複数の列にソートを設定している場合，上に表示されている列のソートが優先されます。

●ボタンの説明

・［▲昇順(A)］

［列(C)］リストボックスで選択（反転表示）している列に，昇順のソートを設定します。ソートを設定した列が，［ソート(S)］リストボックスに表示されます。

・［▼降順(D)］

［列(C)］リストボックスで選択（反転表示）している列に，降順のソートを設定します。ソートを設定した列が，［ソート(S)］リストボックスに表示されます。

・［▲(U)］

［ソート(S)］リストボックスで選択（反転表示）している列のソートの優先順位を一つ上げます。

・［▼(O)］

［ソート(S)］リストボックスで選択（反転表示）している列のソートの優先順位を一つ下げます。

・［削除(E)］

［ソート(S)］リストボックスで選択（反転表示）している列の，ソートの設定を解除します。解除した列が，［ソート(S)］リストボックスから消えます。

・［戻る(B)］

前のダイアログボックスに戻ります。この画面で設定した内容は破棄されます。

・［次へ(N)］

次のダイアログボックスに進みます。

・［完了(X)］

最後のダイアログボックスに進みます。

・［キャンセル］

AP作成ウィザードを終了します。

(7)　抽出列に集合関数を設定する：［集合関数設定］

抽出したデータ（列）に集合関数を設定します。

ただし，［抽出列設定］ダイアログボックスで列を選択していない場合は集合関数を設定できません。

列に集合関数を設定するには，［集合関数(F)］リストボックスで列を選択した後，［最大(M)］，［最小(I)］，［合計(S)］，［平均(V)］，［件数(C)］，又は［グループ(G)］のボタンをクリックします。列の左側に，設定した集合関数が表示されます。

［全取消(A)］ボタンで，すべての集合関数の設定が解除できます。

●表示項目の説明

・［集合関数(F)］

［抽出列設定］ダイアログボックスで抽出列とした列を表示します。

●ボタンの説明

・［最大(M)］

［集合関数(F)］リストボックスで選択している列に，集合関数"最大"を設定します。列の左側に"（最大）"と表示されます。

・［最小(I)］

［集合関数(F)］リストボックスで選択している列に，集合関数"最小"を設定します。列の左側に"（最小）"と表示されます。

・［合計(S)］

［集合関数(F)］リストボックスで選択している列に，集合関数"合計"を設定します。列の左側に"（合計）"と表示されます。

・［平均(V)］

［集合関数(F)］リストボックスで選択している列に，集合関数"平均"を設定します。列の左側に"（平均）"と表示されます。

・［件数(C)］

［集合関数(F)］リストボックスで選択している列に，集合関数"件数"を設定します。列の左側に"（件数）"と表示されます。

・［グループ(G)］

［集合関数(F)］リストボックスで選択している列に，グループ分けを設定します。列の左側に"（グループ）"と表示されます。

・［全取消(A)］

すべての集合関数の設定を解除します。

・［戻る(B)］

前のダイアログボックスに戻ります。この画面で設定した内容は破棄されます。

・［次へ(N)］

このダイアログボックスでは無効（不活性）です。

・［完了(X)］

最後のダイアログボックスに進みます。

・［キャンセル］

AP作成ウィザードを終了します。

(8)　プロジェクト及びAPの作成を確認する：［プロジェクト設定］

次に示す情報を設定します。

プロジェクト作成後のVisual Basicの起動

作成するプロジェクトの名称と格納フォルダ

アプリケーションでデータを抽出する際の検索方法，及び抽出したデータの表示，保存方法

●表示/指定項目の説明

・［Visual Basic起動(U)］

［作成(E)］ボタンをクリックした際，Visual Basicを起動させたい場合にチェックします。

・［プロジェクト名称(P)］

作成するアプリケーションのプロジェクトの名称（40文字以内）を指定します。プロジェクト名称に，/ ¥ < > * ? " | : は使用できません。

・［格納フォルダ(F)］

アプリケーションを格納するフォルダを完全パス（256文字以内）で指定します。

右端の［…］ボタンをクリックすることで，フォルダ選択の画面から指定できます。

・［単純検索(T)］

検索方法を単純検索とします。

単純検索を指定した場合，アプリケーションが表示するダイアログボックスには［抽出］ボタンが表示されます。

・［繰返し検索(K)］

検索方法を繰り返し検索とします。

繰り返し検索を指定した場合，アプリケーションが表示するダイアログボックスには［開始］，［停止］ボタンが表示されます。

・［間隔(I)］

抽出を繰り返す間隔（1〜99）を指定します。また，間隔に指定した値の単位（分，時間）を選択します。

・［クリップボード(C)］

抽出結果をクリップボードに格納します。

・［ファイル(F)］

抽出結果をファイルに格納します。

また，抽出結果を格納するファイル名を完全パス（256文字以内）で指定します。

右端の［…］ボタンをクリックすることで，ファイル選択の画面から指定できます。

・［出力形式(O)］

抽出結果を出力する際のデータ形式を選択（TEXT形式，Excel 4.0形式，CSV形式，DAT形式）します。

・［自動表示(V)］

抽出結果を表示させるかどうか（しない，メモ帳，Excel）を選択します。

●ボタンの説明

・［戻る(B)］

前のダイアログボックスに戻ります。この画面で設定した内容は破棄されます。

・［作成(E)］

Visual Basicのプロジェクトを作成します。

プロジェクトの各ファイルの名称は，［プロジェクト名称(P)］テキストボックスに指定した名称に，次に示すサフィックスが付けられます。

プロジェクトファイル：［プロジェクト名称］+".Vbp"

フォームモジュール1：［プロジェクト名称］+"1.Frm"

フォームモジュール2：［プロジェクト名称］+"2.Frm"

標準モジュール：［プロジェクト名称］+".Bas"

・［終了］

AP作成ウィザードを終了します。

プロジェクトを作成していない場合，終了の確認メッセージが表示されます。

付録A.4　作成できるアプリケーションの仕様

AP作成ウィザードで作成できるアプリケーションの仕様は接続形態によって異なります。接続形態別のアプリケーションの仕様を表A-2と表A-3に示します。

表A‒2　ODBC接続

指定項目

仕　様

設定ダイアログ

接続先

一覧から選択したデータソース（固定）

［接続先設定］

ユーザID

[[ユーザID/パスワード入力]ダイアログボックスを表示する]を指定した場合は，入力できる

パスワード

[[ユーザID/パスワード入力]ダイアログボックスを表示する]を指定した場合は，入力できる

抽出表

一覧から選択した表名（固定）

［抽出表設定］

抽出列

一覧から選択した列名（固定）

［抽出列設定］

抽出条件(左辺)

一覧から選択した列名（固定）

［抽出条件設定］

抽出条件(演算子)

比較演算子，LIKE，NOT LIKEから選択した演算子（固定）

抽出条件(右辺)

設定した値（固定）

条件の先頭をチェックした場合，設定した値をデフォルトで表示し設定できる

条件関連式

設定した条件関連式（固定）

ソート

一覧で指定したソート（固定）

［ソート設定］

集合関数

一覧で指定した集合関数（固定）

［集合関数設定］

抽出データ出力先

クリップボード，ファイルから選択した出力先（固定）

［プロジェクト設定］

抽出データ出力形式

クリップボードの場合，TEXT形式，Excel 4.0形式から選択した形式（固定）

ファイルの場合，TEXT形式，Excel 4.0形式，CSV形式，DAT形式から選択した形式（固定）

抽出データ表示

しない，メモ帳，Excelから選択した方法（固定）

タイマ監視

単純検索，繰り返し検索から選択したモード（固定）

表A‒3　CommuniNet接続

指定項目

仕　様

設定ダイアログ

端末名称

設定した端末名称（固定）

［接続先設定］

ログオンファイル名

設定したファイル名（固定）

ログオフファイル名

設定したファイル名（固定）

データベース種別

選択した種別（固定）

サーバ種別

選択した種別（固定）

ユーザID

[[ユーザID/パスワード入力]ダイアログボックスを表示する]を指定した場合は，入力できる

パスワード

[[ユーザID/パスワード入力]ダイアログボックスを表示する]を指定した場合は，入力できる

抽出表

一覧から選択した表名（固定）

［抽出表設定］

抽出列

一覧から選択した列名（固定）

［抽出列設定］

抽出条件(左辺)

一覧から選択した列名（固定）

［抽出条件設定］

抽出条件(演算子)

比較演算子，LIKE，NOT LIKEから選択した演算子（固定）

抽出条件(右辺)

設定した値（固定）

条件の先頭をチェックした場合，設定した値をデフォルトで表示し設定できる

条件関連式

設定した条件関連式（固定）

ソート

一覧で指定したソート（固定）

［ソート設定］

集合関数

一覧で指定した集合関数（固定）

［集合関数設定］

抽出データ出力先

クリップボード，ファイルから選択した出力先（固定）

［プロジェクト設定］

抽出データ出力形式

クリップボードの場合，TEXT形式，Excel 4.0形式から選択した形式（固定）

ファイルの場合，TEXT形式，Excel 4.0形式，CSV形式，DAT形式から選択した形式（固定）

抽出データ表示

しない，メモ帳，Excelから選択した方法（固定）

タイマ監視

単純検索，繰り返し検索から選択したモード（固定）

また，作成したアプリケーションの操作は，［プロジェクト設定］で設定する検索方法（単純検索，繰り返し検索）によって異なります。検索方法の違いによるアプリケーションの操作の違いを次に示します。

付録B　DBPARTNER2 Clientの予約語

DBPARTNER2 Clientの予約語の一覧を表B-1に示します。DBPARTNER2 Clientのアプリケーションを作成するときには，ここに示す名称を表名や列名に使わないでください。

SQLを使ってアプリケーションを作成するときは，ここに示す予約語に加えて，SQLの予約語が使えないので注意してください。

アクセスするデータベースやサーバプログラムの予約語については，該当するマニュアルを参照してください。

表B‒1　DBPARTNER2 Clientの予約語の一覧

先頭の英字

予約語になる文字列

A

AND，and，ASC，AVG

B

BETWEEN，BIGINT，BINARY，BIT

C

Cn（n は1〜2147483647の数値），CHAR，CHARACTER，CNT，COUNT，CPT

D

DAT，DATE，DAY，DAYS，DBPxxx（xxxは任意の長さの文字列），DEC，DECIMAL，DESC，DIGITS，DOUBLE

F

FLOAT

G

GROUP，GRP

H

HEX

I

IN，INTEGER，INTERVAL，IS

L

LARGE，LENGTH，LIKE，LONG，LONG MVARCHAR，LONG NVARCHAR，LONG VARBINARY，LONG VARCHAR

M

MAX，MCHAR，MIN，MINUTE，MONTH，MVARCHAR

N

NCHAR，NOT，not，NULL，NUMERIC，NVARCHAR

O

OR，or

P

POL

R

REAL

S

SECOND，SMALLFLT，SMALLINT，SQLxxx（xxxは任意の長さの文字列），SQL_xxx（xxxは任意の長さの文字列），SUBSTR，SUM

T

Tn（nは 1〜2048の数値），TCm（mは1〜2048の数値），TIME，TIMESTAMP，TINYINT，TO，TXT

V

VALUE，VARBINARY，VARCHAR

W

WJ2

X

XLS

Y

YEAR

付録C　DBPARTNER2 Clientが扱うデータの形式

DBPARTNER2 Clientが扱うデータの形式を表C-1に示します。

表C‒1　DBPARTNER2 Clientが扱うデータの形式

データの形式

項目

データとデータの区切りコード

改行コード

（行の終わり）

終端コード

（全データの終わり）

データの詳細

CSV形式

コンマ

（0x2c）

CR

（0x0d0a）

−

文字列データは，データを「"」（ダブルクォーテーション）で囲みます。

文字列データに「"」があるときは，「"」2個に変換します。

数値データは，データを「"」で囲みません。

DAT形式

コンマ

（0x2c）

CR

（0x0d0a）

EOF

（0x1a）

文字列データは，データを「"」（ダブルクォーテーション）で囲みます。

文字列データ中に「"」があるときは，「'」（アポストロフィ）に変換します。

数値データは，データを「"」で囲みません。

TEXT形式

タブコード

¥t（0x09）

CR

（0x0d0a）

−

データが文字列か数値かの区別はありません。

XLS形式

−

−

−

Biff4形式です。

付録D　プロパティとメソッドの制限値

DBPARTNER2 ClientのActiveXコントロールのプロパティとメソッドの制限値を，ODBC接続とCommuniNet接続で分けて説明します。

付録D.1　ODBC接続のときのプロパティとメソッドの制限値

ODBC接続のときの，DBPARTNER2 ClientのActiveXコントロールのプロパティとメソッドの制限値を，次の(1)〜(20)に示します。表中のアンダラインは，省略時の仮定値を示します。ここでは，制限値があるプロパティ又はメソッドの文字定数について説明しています。制限値がない文字定数は掲載していません。

(1)　DBPARTNERオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値/文字定数：値

CommitMode

トランザクション終了モード

dbpAuto：0

dbpManual：1

ConnectDialogMode

接続ダイアログ表示モード

dbpHide：0

dbpCase：1

dbpShow：2

DataSource

データソース名

0〜32バイト

DictPath

パス

0〜256バイト

TableDefSource

情報の要求先

dbpDB：0

dbpDICT：1

dbpDBDICT：2

UserID

ユーザID

0〜32バイト

Password

パスワード

0〜32バイト

(2)　SQLDirectオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

SQLText

SQL文

1〜30,000バイト

(3)　Resultオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

QueryCountLimit

抽出行数の制限値

0

1〜999,999,999

DataCheck

文字のチェックモード

FALSE，TRUE

HeaderOutput

ヘッダ出力モード

FALSE，TRUE

FieldHeader

ヘッダ

0〜256バイト

FieldCodeType

取得モード

dbpTypeCHAR，dbpCHAR：1

dbpTypeBINARY，dbpBINARY：-2

SaveToFile

ファイル名

1〜256バイト

データタイプ

dbpTextFormat，dbpTextFile：0

dbpBiff4Format，dbpBiff4File：1

dbpCSVFile：2

dbpDATFile：3

dbpOleBiff8File：4

CopyToClipboard

データタイプ

dbpTextFormat：0

dbpBiff4Format：1

dbpOleBiff8Format：4

SaveLargeObject

ファイル名

1〜256バイト

(4)　TableListオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

Pattern

表の絞り込み条件

0〜128バイト

CountLimit

表数の制限値

0

1〜8,192

SelectDict

接続先

1〜32

Type

表の表属性

0〜256バイト

(5)　ColumnListオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

TableName

表名

1〜256バイト

CountLimit

列数の制限値

0

1〜8,192

SelectDict

接続先

1〜32

(6)　QueryDefineオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

Exclusive

排他オプション

0〜64バイト

(7)　Tablesコレクションオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

Add

抽出表

1〜256バイト

(8)　Tableオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

TableName

抽出表

1〜256バイト

(9)　Columnsコレクションオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

Add

抽出列

1〜256バイト

(10)　Columnオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値/文字定数：値

ColumnName

抽出列

1〜256バイト

SortMode

ソートモード

dbpNormal，dbpNoSort：0

dbpAscend：1

dbpDescend：2

SortPriority

ソート優先順位

1〜255

FunctionMode

集合関数

dbpNormal，dbpNoFunction：0

dbpGroup：1

dbpMaximum：2

dbpMinimum：3

dbpCount：4

dbpAverage：5

dbpSum：6

(11)　Conditionsコレクションオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

Relation

条件関連

0〜1,024バイト

Add

抽出条件式

1〜30,000バイト

(12)　Conditionオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

Text

抽出条件式

1〜30,000バイト

(13)　UpdateDefineオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値/文字定数：値

Exclusive

排他オプション

0〜64バイト

UpdateMode

更新実行モード

dbpNormal：0

dbpVariable：1

TableName

更新表

1〜256バイト

NCharPrefixMode

NCHAR定数モード

dbpNCHARPrefix：0

dbpCHARPrefix：1

Execute

更新種別

dbpUpdate：0

dbpInsert：1

dbpDelete：2

(14)　Updateオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

KeyColumn

列名

1〜256バイト

KeyValue

データ

0〜30,000バイト

Column

列名

1〜256バイト

UpdateValue

データ

0〜30,000バイト

UpdateValueB

データ

0〜2ギガバイト

AddKey

列名

1〜256バイト

データ

0〜30,000バイト

AddUpdateValue

列名

1〜256バイト

データ

0〜30,000バイト

AddUpdateValueB

列名

1〜256バイト

データ

0〜2ギガバイト

(15)　Insertオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

Column

列名

1〜256バイト

InsertValue

データ

0〜30,000バイト

InsertValueB

データ

0〜2ギガバイト

AddInsertValue

列名

1〜256バイト

データ

0〜30,000バイト

AddInsertValueB

列名

1〜256バイト

データ

0〜2ギガバイト

(16)　Deleteオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

KeyColumn

列名

1〜256バイト

KeyValue

データ

0〜30,000バイト

AddKey

列名

1〜256バイト

データ

0〜30,000バイト

(17)　Catalogオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

FileLoad

ファイル名

1〜256バイト

(18)　VariableListオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

VariableValue

実行値

1〜30,000バイト

(19)　Procedureオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

ListPattern

絞り込み条件

0〜128バイト

GetParam

プロシジャ名

1〜256バイト

(20)　ParamListオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値/文字定数：値

ParamCodeType

取得モード

dbpBINARY：-2

dbpCHAR：1

ParamType

パラメタ種別

dbpParamTypeUnknown：0

dbpParamInput：1

dbpParamInputOutput：2

dbpResultCol：3

dbpParamOutput：4

dbpReturnValue：5

ParamPrecision

精度

1〜2,147,483,647

ParamScale

小数点以下けた数

-2,147,483,648〜2,147,483,647

ParamValue

データ

0〜30,000バイト

ParamValueB

データ

0〜2ギガバイト

ParamValueMaxLength

データ長

0〜2,147,483,647

付録D.2　CommuniNet接続のときのプロパティとメソッドの制限値

CommuniNet接続のときの，DBPARTNER2 ClientのActiveXコントロールのプロパティとメソッドの制限値を，次の(1)〜(17)に示します。表中のアンダラインは，省略時の仮定値を示します。ここでは，制限値があるプロパティ又はメソッドの文字定数について説明しています。制限値がない文字定数は掲載していません。

(1)　DBPARTNERオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値/文字定数：値

CodeChangeMode

コード変換種別

dbpServer：0

dbpClient：1

CommitMode

トランザクション終了モード

dbpAuto：0

dbpManual：1

DictPath

パス

0〜256バイト

TableDefSource

情報の要求先

dbpDB：0

dbpDICT：1

dbpDBDICT：2

LogoffFileName

マクロスクリプトファイル名

1〜256バイト

LogonFileName

マクロスクリプトファイル名

1〜256バイト

MacroTimeLimit

マクロスクリプト実行待ち時間

1〜600

ResponseLimit

キャンセル応答待ち時間

0〜3600

TargetDatabase

データベース種別

dbpV3RD：0

dbpV3SD：1

dbpV3PDM：2

dbpV3USR：3

dbpV3RDB1：4

dbpVKRDBF：5

dbpVKSPL：6

dbpV1PDM：7

dbpV1USR：8

dbpV1SPL：9

TargetServer

サーバプログラム種別

dbpHoap：0

dbpAce3：1

TerminalMode

端末起動モードの種別

dbpHide：0

dbpIcon：1

dbpShow：2

TerminalName

端末名称

1〜14バイト

UserID

ユーザID

0〜8バイト

Password

パスワード

0〜8バイト

(2)　Resultオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値/文字定数：値

QueryCountLimit

抽出行数の制限値

0

1〜999,999,999

HeaderOutput

ヘッダ出力モード

FALSE，TRUE

FieldHeader

ヘッダ

0〜256バイト

SaveToFile

ファイル名

1〜256バイト

データタイプ

dbpTextFormat，dbpTextFile：0

dbpBiff4Format， dbpBiff4File：1

dbpCSVFile：2

dbpDATFile：3

dbpOleBiff8File：4

CopyToClipboard

データタイプ

dbpTextFormat：0

dbpBiff4Format：1

dbpOleBiff8Format：4

(3)　TableListオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値/文字定数：値

Pattern

表の絞り込み条件

0〜128バイト

CountLimit

表数の制限値

0

1〜8,192

SelectDict

接続先

0〜32バイト

TablePasswordMode

表パスワード種別

dbpNoPassword：0

dbpSPassword：1

dbpUPassword：2

dbpSUPassword：3

(4)　ColumnListオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値

TableName

表名

1〜128バイト

CountLimit

列数の制限値

0

1〜8,192

SelectDict

接続先

0〜32バイト

TablePassword

表パスワード

0〜8バイト

(5)　QueryDefineオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値

Exclusive

排他オプション

0〜64バイト

(6)　Tablesコレクションオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値

Add

抽出表

1〜128バイト

(7)　Tableオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値

TableName

抽出表

1〜128バイト

TablePassword

表パスワード

0〜8バイト

(8)　Columnsコレクションオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値

Add

−

1〜256バイト

(9)　Columnオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値/文字定数：値

ColumnName

−

1〜256バイト

SortMode

−

dbpNormal，dbpNoSort：0

dbpAscend：1

dbpDescend：2

SortPriority

ソート優先順位

1〜255

FunctionMode

集合関数

dbpNormal，dbpNoFunction：0

dbpGroup：1

dbpMaximum：2

dbpMinimum：3

dbpCount：4

dbpAverage：5

dbpSum：6

(10)　Conditionsコレクションオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値/文字定数：値

Relation

条件関連

0〜1,024バイト

Add

抽出条件式

1〜256バイト

(11)　Conditionオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値

Text

抽出条件式

1〜256バイト

(12)　UpdateDefineオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値/文字定数：値

Exclusive

排他オプション

0〜64バイト

UpdateMode

更新実行モード

dbpNormal：0

dbpVariable：1

TableName

更新表

1〜128バイト

TablePassword

表パスワード

0〜8バイト

Execute

更新種別

dbpUpdate：0

dbpInsert：1

dbpDelete：2

(13)　Updateオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値

KeyColumn

列名

1〜64バイト

KeyValue

データ

0〜256バイト

Column

列名

1〜64バイト

UpdateValue

データ

0〜256バイト

AddKey

列名

1〜64バイト

データ

0〜256バイト

AddUpdateValue

列名

1〜64バイト

データ

0〜256バイト

(14)　Insertオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値

Column

列名

1〜64バイト

InsertValue

データ

0〜256バイト

AddInsertValue

列名

1〜64バイト

データ

0〜256バイト

(15)　Deleteオブジェクト（CommuniNet接続）

プロパティ/メソッド

項目

制限値

KeyColumn

列名

1〜64バイト

KeyValue

データ

0〜256バイト

AddKey

列名

1〜64バイト

データ

0〜256バイト

(16)　Catalogオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

FileLoad

ファイル名

1〜256バイト

(17)　VariableListオブジェクト（ODBC接続）

プロパティ/メソッド

項目

制限値

VariableValue

実行値

1〜256バイト

付録E　列の属性

DBPARTNER2 Clientのアプリケーションで設定する文字定数の属性を，ODBC接続とCommuniNet接続に分けて説明します。

付録E.1　ODBC接続のときの列の属性

ODBC接続のときの，DBPARTNER2 Clientの文字定数の値を表E-1に示します。

表E‒1　DBPARTNER2 Clientの文字定数の値（ODBC接続）

列属性の文字定数

数値

説明

ODBCのデータ型

dbpTypeCHAR

1

固定長の文字列

SQL_CHAR

dbpTypeNUMERIC

2

符号付き固定小数点数値※1

SQL_NUMERIC

dbpTypeDECIMAL

3

符号付き固定小数点数値※1

SQL_DECIMAL

dbpTypeINTEGER

4

符号付き固定小数点数値※1

SQL_INTEGER

dbpTypeSMALLINT

5

符号付き固定小数点数値※1

SQL_SMALLINT

dbpTypeFLOAT

6

符号付き浮動小数点数値※1

SQL_FLOAT

dbpTypeREAL

7

符号付き浮動小数点数値※1

SQL_REAL

dbpTypeDOUBLE

8

符号付き浮動小数点数値※1

SQL_DOUBLE

dbpTypeDATE

9

日付データ

SQL_DATE

dbpTypeTIME

10

時刻データ

SQL_TIME

dbpTypeTIMESTAMP

11

タイムスタンプデータ

SQL_TIMESTAMP

dbpTypeVARCHAR

12

可変長文字列

SQL_VARCHAR

dbpTypeLONGVARCHAR

-1

可変長文字列

SQL_LONGVARCHAR

dbpTypeBINARY

-2

固定長バイナリデータ

SQL_BINARY

dbpTypeVARBINARY

-3

可変長バイナリデータ

SQL_VARBINARY

dbpTypeLONGVARBINARY

-4

可変長バイナリデータ

SQL_LONGVARBINARY

dbpTypeBIGINT

-5

固定小数点数値※1

SQL_BIGINT

dbpTypeTINYINT

-6

符号付き固定小数点数値※1

SQL_TINYINT

dbpTypeBIT

-7

1けたのバイナリ値

SQL_BIT

dbpTypeNCHAR※2

-1001

固定長の各国文字列

なし

dbpTypeNVARCHAR※2

-1002

可変長の各国文字列

なし

dbpTypeLONGNVARCHAR※2

-1003

可変長長各国文字列

なし

dbpTypeMCHAR※2

-1004

固定長の混在文字列

なし

dbpTypeMVARCHAR※2

-1005

可変長の混在文字列

なし

dbpTypeLONGMVARCHAR※2

-1006

可変長長混在文字列

なし

dbpTypeNUMERICUNS※2

-2000

符号なし固定小数点数値※1

なし

注※1

有効けた数，小数部けた数については，各データベースの制限に従います。

注※2

DBPARTNER2 ClientのODBCドライバ（DBPARTNER ODBC Driver）を使ったときにだけ使えます。

付録E.2　CommuniNet接続のときの列の属性

(1)　列属性の文字定数

CommuniNet接続のときの，DBPARTNER2 Clientの文字定数の値を表E-2に示します。

表E‒2　DBPARTNER2 Clientの文字定数の値（CommuniNet接続）

列属性の文字定数

数値

説明

dbpTypeCHAR

1

固定長の文字列

dbpTypeNUMERIC

2

符号付き固定小数点数値

dbpTypeINTEGER

4

符号付き固定小数点数値

dbpTypeFLOAT

6

符号付き浮動小数点数値

dbpTypeREAL

7

符号付き浮動小数点数値

dbpTypeDATE

9

日付データ

dbpTypeTIME

10

時刻データ

dbpTypeVARCHAR

12

可変長文字列

dbpTypeINTERVAL_HOUR_TO_SECOND

112

時間間隔データ

dbpTypeBINARY

-2

固定長バイナリデータ

dbpTypeNCHAR

-1001

固定長の各国文字列

dbpTypeNVARCHAR

-1002

可変長の各国文字列

dbpTypeMCHAR

-1004

固定長の混在文字列

dbpTypeMVARCHAR

-1005

可変長の混在文字列

dbpTypeNUMERICUNS

-2000

符号なし固定小数点数値

dbpTypeINTERVAL_YEAR_TO_DAY

-2001

日間隔データ

(2)　列属性とデータベースの属性

DBPARTNER2 Clientが返す列属性と使うデータベースの列属性の対応を，データベースごとに次の（a）〜（h）に示します。

(a)　VOS3 XDM/RD E2のとき

列属性の文字定数

ACE3定義のデータ型

XDM/RD E2のデータ型

dbpTypeCHAR

C

CHARACTER

dbpTypeVARCHAR

VC

VARCHAR

LC

LONG VARCHAR

dbpTypeNCHAR

N

NCHAR

dbpTypeNVARCHAR

VN

NVARCHAR

LN

LONG NVARCHAR

dbpTypeMCHAR

MC

MCHAR

dbpTypeMVARCHAR

VM

MVARCHAR

LM

LONG MVARCHAR

dbpTypeINTEGER

B

INTEGER

B

SMALLINT

dbpTypeNUMERIC

P

DECIMAL

LP

LARGE DECIMAL

dbpTypeFLOAT

D

FLOAT

dbpTypeREAL

F

SMALLFLT

dbpTypeDATE

DT

DATE

dbpTypeINTERVAL_YEAR_TO_DAY

ID

INTERVAL YEAR TO DAY

(b)　VOS3 XDM/SD E2のとき

列属性の文字定数

ACE3定義のデータ型

XDM/SD E2のデータ型

dbpTypeCHAR

C

CHARACTER

dbpTypeNCHAR

N

NCHARACTER

dbpTypeINTEGER

M

COMP

dbpTypeNUMERIC

P

PACKED DECIMAL FIXED

Z

UNPACKED DECIMAL FIXED

dbpTypeBINARY

X

BIT

(c)　VOS3 RDB1のとき

列属性の文字定数

ACE3定義のデータ型

RDB1のデータ型

dbpTypeCHAR

C

CHAR

dbpTypeVARCHAR

VC

VARCHAR

LC

LONGVARCHAR

dbpTypeNCHAR

N

NCHAR

dbpTypeNVARCHAR

VN

NVARCHAR

dbpTypeINTEGER

B

SMALLINT

B

INTEGER

dbpTypeNUMERIC

P

DECIMAL

dbpTypeFLOAT

D

FLOAT

dbpTypeREAL

F

SMALLFLT

(d)　VOS3 PDMII E2のとき

列属性の文字定数

ACE3定義のデータ型

PDMII E2のデータ型

dbpTypeCHAR

C

X

dbpTypeVARCHAR

VC

−

dbpTypeNCHAR

N

N

dbpTypeNVARCHAR

VN

−

dbpTypeINTEGER

B

B

dbpTypeNUMERIC

P

P

Z

Z

dbpTypeFLOAT

D

F

dbpTypeREAL

F

F

(e)　VOS3 ACE3ユーザファイルのとき

列属性の文字定数

ACE3定義のデータ型

dbpTypeCHAR

C

dbpTypeVARCHAR

VC

dbpTypeNCHAR

N

dbpTypeNVARCHAR

VN

dbpTypeMCHAR

MC

dbpTypeMVARCHAR

VM

dbpTypeINTEGER

B

dbpTypeNUMERIC

P

Z

dbpTypeNUMERICUNS

UP

UZ

dbpTypeFLOAT

D

dbpTypeREAL

F

dbpTypeDATE

DT

dbpTypeINTERVAL_YEAR_TO_DAY

ID

dbpTypeTIME

TM

dbpTypeINTERVAL_HOUR_TO_SECOND

IS

(f)　VOS1 PDMII E2のとき

列属性の文字定数

ACE3定義のデータ型

PDMII E2のデータ型

dbpTypeCHAR

C

X

dbpTypeVARCHAR

VC

X

dbpTypeNCHAR

N

N

dbpTypeNVARCHAR

VN

N

dbpTypeINTEGER

B

B

dbpTypeNUMERIC

P

P

Z

Z

dbpTypeFLOAT

D

D

dbpTypeREAL

F

F

(g)　VOS1 ACE3ユーザファイルのとき

列属性の文字定数

ACE3定義のデータ型

dbpTypeCHAR

C

dbpTypeVARCHAR

VC

dbpTypeNCHAR

N

dbpTypeNVARCHAR

VN

dbpTypeMCHAR

MC

dbpTypeMVARCHAR

VM

dbpTypeINTEGER

B

dbpTypeNUMERIC

P

Z

dbpTypeFLOAT

D

dbpTypeREAL

F

(h)　VOSK RDB編成ファイルのとき

列属性の文字定数

物理フィールド定義でのデータ型

dbpTypeCHAR

C

dbpTypeBINARY

X

dbpTypeNCHAR

N

dbpTypeMCHAR

M

dbpTypeNUMERIC

Z

P

dbpTypeNUMERICUNS

W

dbpTypeINTEGER

B

付録F　繰り返し列と配列列での制限事項

表の列に繰り返し列や配列列を使っている場合の制限事項について説明します。

繰り返し列を含む表は，データの更新，削除はできません。

付録F.1　データの抽出，更新，削除時の制限事項

データの抽出，更新，削除をするときに，繰り返し列又は配列列の列名をメソッドやプロパティに設定する場合，列名を次に示す形式で設定してください。

列名の形式

要素数を囲む括弧の形式はデータベースにより異なります。各データベースの括弧の形式にあわせて設定してください。

（例）

VOSK RDB編成ファイルの場合："列名"[n]

例として，商品コード，売り上げ，及び支店在庫（繰り返し列又は配列列）で構成される在庫管理表（A）から，支店在庫のデータを抽出する場合のコーディングについて説明します。

繰り返し列又は配列列が含まれる在庫管理表（A）

商品コード

支店在庫（1）

支店在庫（2）

売り上げ

A0100

100

110

1000

A0200

200

220

2000

A0300

300

330

3000

在庫管理表1から，支店在庫（2）の220の行を抽出する場合のコーディングは次のとおりです。データの更新や削除をするときも列名の指定は同じ形式になります。

コーディング例

繰り返し列を含む表に，データの追加はできません。

付録F.2　データの追加時の制限事項

データを追加するときに，配列列の列名をメソッドやプロパティに設定する場合，列名を次に示す形式で設定してください。

列名の形式

注意

データを追加するときには，すべての要素のデータを設定してください。データを設定していない要素がある場合には，データの追加処理を実行したときにエラーになります。

繰り返し列又は配列列の要素を連続して設定してください。設定する要素に配列列以外の列がある場合には，データの追加処理を実行したときにエラーになります。

例として，商品コード，売り上げ，及び支店在庫（配列列）で構成される在庫管理表（B）にデータを追加する場合のコーディングについて説明します。

配列列が含まれる在庫管理表（B）

商品コード

支店在庫（1）

支店在庫（2）

売り上げ

B0100

50

55

5000

在庫管理表2にデータを追加する場合のコーディングは次のとおりです。追加するデータは，商品コード「B0200」，支店在庫（1）「60」，支店在庫（2）「66」，売り上げ「6000」とします。

コーディングの例

付録G　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

付録G.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

(1)　サーバ側

サーバのOSごとに関連するマニュアルを次に示します。

UNIX/Windowsの場合

DABroker（3020-6-031）

スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（UNIX(R)用）（3000-6-355）

スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（Winodws(R)用）（3020-6-355）

スケーラブルデータベースサーバ HiRDB Version 8 SQL リファレンス（3020-6-357）

スケーラブルデータベースサーバ HiRDB Version 8 メッセージ（3020-6-358）

スケーラブルデータベースサーバ HiRDB Version 9 コマンドリファレンス（UNIX(R)用）（3000-6-455）

スケーラブルデータベースサーバ HiRDB Version 9 コマンドリファレンス（Windows(R)用）（3020-6-455）

スケーラブルデータベースサーバ HiRDB Version 9 SQL リファレンス（3020-6-457）

スケーラブルデータベースサーバ HiRDB Version 9 メッセージ（3020-6-458）

注

このマニュアルのHiRDBマニュアルへの参照指示では，HiRDBのバージョンとOS名は省略して表記しています。HiRDBマニュアルを参照するときは，該当するバージョンと該当するOSのマニュアルをご利用ください。

VOS3の場合

VOS3 データマネジメントシステム XDM E2系 プログラム作成の手引（XDM/SD）（6190-6-652）

VOS3 データマネジメントシステム XDM E2系 プログラム作成の手引（XDM/RD E2）（6190-6-638）

VOS3データマネジメントシステム XDM E2系 SQLリファレンス（XDM/RD E2）（6190-6-656）

VOS3 データマネジメントシステム XDM E2系 メッセージ（XDM/RD E2）（6190-6-643）

VOS3 データマネジメントシステム XDM E2系 運用の手引 -解説編-（6190-6-628）

VOS3 データマネジメントシステム XDM E2系 メッセージ（コンソール・端末出力メッセージ）（6190-6-629）

VOS3/FS システムメッセージ/システムコード（6190-3-103）

VOS3 データマネジメントシステム RDB1 解説（6180-6-550）

VOS3 データマネジメントシステム RDB1 EQL文法（6180-6-551）

VOS3 データマネジメントシステム RDB1 使用の手引（6180-6-552）

VOS3 Database Connection Server（6190-6-648）

VOSKの場合

VOSK システムOA（650-7-321）

VOSK/FS Database Connection Server（650-3-243）

VOS1の場合

VOS1 データマネジメントシステム RDB1 E2 使用の手引（6150-6-561）

VOS1 Database Connection Server（6150-6-802）

(2)　クライアント側（クライアントPC側）

DBPARTNER2 Clientを組み込むクライアント側で関連するマニュアルを次に示します。

クライアント用データベースアクセス関連

DBPARTNER2 Client 操作ガイド（3020-6-151）

ODBC接続の場合

DBPARTNER ODBC 3.0 Driver（3020-6-073）

CommuniNet接続の場合

CommuniNet Version 3（3020-3-821）

CommuniNet Extension Version 3（3020-3-822）

CommuniNet Version 4（3020-3-N71）

CommuniNet Extension Version 4（3020-3-N72）

付録G.2　このマニュアルで使用する略称

このマニュアルでは，製品名を次に示す略称で表記しています。

品名

略称

Microsoft(R) Excel

Excel

Microsoft(R) SQL Server

Microsoft SQL Server又はSQL Server

Microsoft(R) Visual Basic

Visual Basic

Microsoft(R) Visual C++

Visual C++

Microsoft(R) Windows(R) Sockets

Windows Sockets

Microsoft(R) Internet Explorer

Internet Explorer

ORACLE(R)のデータベース

ORACLE

Sybase Adaptive Server Anywhere

Sybase Adaptive Server Anywhere

又はAdaptive Server Anywhere

VOS3/FS，VOS3/AS，VOS3/ES1

VOS3

VOS1/FS，VOS1/ES2

VOS1

VOSK/FS，VOSK

VOSK

このマニュアルでは，オペレーティングシステムを次に示す略称で表記しています。

製品名

略称

Microsoft(R) Windows Vista(R) Business

Windows Vista

Windows

Microsoft(R) Windows Vista(R) Enterprise

Microsoft(R) Windows Vista(R) Ultimate

Microsoft(R) Windows(R) 7 Professional

Windows 7

Microsoft(R) Windows(R) 7 Enterprise

Microsoft(R) Windows(R) 7 Ultimate

Microsoft(R) Windows(R) 8 Pro

Windows 8

Microsoft(R) Windows(R) 8 Enterprise

Microsoft(R) Windows(R) 8.1 Pro

Microsoft(R) Windows(R) 8.1 Enterprise

Microsoft(R) Windows(R) 10 Pro

Windows 10

Microsoft(R) Windows(R) 10 Enterprise

Microsoft(R) Windows Server(R) 2008 Standard

Windows Server 2008

Microsoft(R) Windows Server(R) 2008 Enterprise

Microsoft(R) Windows Server(R) 2008 Datacenter

Microsoft(R) Windows Server(R) 2008 R2 Standard

Microsoft(R) Windows Server(R) 2008 R2 Enterprise

Microsoft(R) Windows Server(R) 2008 R2 Datacenter

Microsoft(R) Windows Server(R) 2012 Standard

Windows Server 2012

Microsoft(R) Windows Server(R) 2012 Datacenter

Microsoft(R) Windows Server(R) 2012 R2 Standard

Microsoft(R) Windows Server(R) 2012 R2 Datacenter

Microsoft(R) MS-DOS(R)

MS-DOS

このマニュアルでは，データベースに接続するときに使う通信形態を次に示すように表記しています。通信形態とマニュアルでの表記を次に示します。

通信形態

マニュアルでの表記

ODBCドライバ

ODBC接続

CommuniNet Extension

CommuniNet接続

このマニュアルでは，WWWブラウザをWebブラウザ，WWWサーバをWebサーバと表記します。

付録G.3　略語一覧

このマニュアルで使う英略語の一覧を次に示します。

英略語

英字の表記

ACE3

Available Command language for End users 3

ACE3 E2

Available Command language for End users 3 Extended Version 2

ACE3 E3

Available Command language for End users 3 Extended Version 3

AP

Application Program

API

Application Programming Interface

CD-ROM

Compact Disc - Read Only Memory

DB

Database

DBMS

Database Management System

DDL

Data Definition Language

DF/1

Distributing Facility / for VOS1

DF/K

Distributing Facility / for VOSK

DLL

Dynamic Linking Library

DML

Data Manipulation Language

EBCDIK

Extended Binary Coded Decimal Interchange Kana code

EUC

Extended UNIX Code

GUI

Graphical User Interface

HOAPDBS E2

High Level Object Management and Processing Database Service Extended Version 2

HOAPDBS/PC

High Level Object Management and Processing Database Service / Personal Computer Feature

HTML

Hyper Text Markup Language

JIS

Japanese Industrial Standard code

KEIS

Kanji processing Extended Information System

LAN

Local Area Network

MAPI

Microsoft Messaging Application Programming Interface

OA

Office Automation

ODBC

Open Database Connectivity

OS

Operating System

OSCF

Operating System Control Facility

OSI

Open Systems Interconnection

PC

Personal Computer

PDM II

Practical Data Manager II

PDM II E2

Practical Data Manager II Extended Version 2

RD

Relational Database

RDB1

Relational Database Manager 1

RDB1 E2

Relational Database Manager 1 Extended Version 2

SAM

Sequential Access Method

SQL

Structured Query Language

SQL/K

Structured Query Language / VOSK

TCP/IP

Transmission Control Protocol / Internet Protocol

UAP

User Application Program

URL

Uniform Resource Locator

VOS1

Virtual-storage Operating System 1

VOS3

Virtual-storage Operating System 3

VOSK

Virtual-storage Operating System Kindness

WS

Workstation

WWW

World Wide Web

XDM/DF

Extensible Data Manager / Distributing Facility

XDM/RD E2

Extensible Data Manager / Relational Database Extended Version 2

XDM/SD E2

Extensible Data Manager / Sequential Database Extended Version 2

付録G.4　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録H　用語解説

（英字）

NCHAR定数モード

各国文字列の列に対する更新データに付けるプレフィックスのことです。

SQL文

データベースを操作したり定義したりするための高級言語のことです。DBPARTNER2 Clientでは，アプリケーションからデータを抽出するときに使います。

（カ行）

カスタムインストール

作成するファイルや初期値の内容を，任意に設定してインストールする方法です。

クイックインストール

作成するファイルや初期値の内容を，DBPARTNER2 Clientが仮定してインストールする方法です。

クライアント/サーバ

プログラムとプログラムの通信方法の一つです。業務処理を依頼する方をクライアント，要求を受けて業務を実行する方をサーバといいます。DBPARTNER2 Clientを使った業務では，DBPARTNER2 Clientがクライアント，データベースがサーバになります。クライアント/サーバとは，プログラム間の相対的な関係を示す用語です。

更新種別

データベースへ更新データをどのように反映するかを意味します。更新種別には，変更，追加，削除があります。変更とは，データベースの表の行のデータを変更することです。追加とは，データベースの表に行を追加することです。削除とは，データベースの表の行を削除することです。

更新処理

データベースのデータを変更，追加又は削除する処理のことです。

更新表

更新処理の対象になる表のことです。

（サ行）

サーバ

ほかのシステムやプログラムから要求を受けて，業務を実行するシステム又はプログラムのことです。代表的なサーバの業務は，データベース管理です。DBPARTNER2 Clientを使った業務では，HiRDBやORACLEなどのデータベース，DABrokerなどのサーバプログラムを総称してサーバといいます。

サーバプログラム

DBPARTNER2 Clientとデータベースの中間に位置するサーバのプログラムのことです。DBPARTNER2 ClientのActiveXコントロール仕様では，次に示すサーバプログラムと接続できます。

ODBC接続のとき

DABroker，VOS3 Database Connection Server，VOS1 Database Connection Server，VOSK Database Connection Server

CommuniNet接続のとき

VOS3 HOAPDBS E2，VOS3 ACE3 E3，VOSK HOAPDBS/PC，VOS1 DBPARTNER/Link

削除行条件

削除する行を特定するための1列分の条件のことです。

削除処理

更新表の1行又は複数行を削除する処理のことです。

集合関数

抽出する列中のデータから，最大値，最小値，平均値，合計値，及び件数を抽出する関数です。

条件

データを抽出するときに，データを絞り込む方法です。条件には，＝，>，<，≠，≧，≦，NULL，^NULL，IN，^IN，LIKE，^LIKE，BETWEEN，^BETWEEN，列比較，列演算があります。

条件関連

NOT，AND，OR，又は（ ）を使って，複数の抽出条件式を関連付ける文字列のことです。何も指定しないと，条件式間のつながりはANDになります。

所有者

表を所有しているユーザの認可識別子のことです。

ソートモード

抽出データを昇順又は降順に並び替えるモードのことです。

ソート優先順位

複数の列に設定されているソートモードの優先順位のことです。

属性

データベースに定義している列の属性です。列の属性は，TableListオブジェクト又はResultオブジェクトで取得できます。

（タ行）

抽出条件

抽出データとして出力する行を決める条件のことです。抽出条件は，抽出条件式と条件関連から構成されます。

抽出処理

データベースからデータを取り出す処理のことです。抽出処理の対象になる表のことを抽出表といいます。抽出処理で取り出したデータのことを抽出データといいます。抽出データを絞り込む条件を抽出条件式といいます。

抽出データ格納ファイル

データベースから抽出したデータを格納するファイルです。抽出データ格納ファイルの拡張子（ファイルの種類）は，抽出するときに設定したデータの形式で決まります。

抽出列

抽出データとして出力する列のことです。

追加情報

データを追加するための1列分の情報のことです。

追加処理

更新表に1行又は複数行を追加する処理のことです。

データソース名

［コントロールパネル］の［ODBCデータソース］アイコンに登録されているユーザデータソースに付けてある名称のことです。

データの更新

データベースからデータを抽出して，そのデータをDBPARTNER2 Client上で編集してデータベースを更新することです。データを更新するときは，UpdateDefineオブジェクトを使います。

データの絞り込み

抽出するデータの対象を狭めることです。

データの抽出

データベースからデータを取り出すことです。データを抽出するときは，QueryDefineオブジェクト又はSQLDirectオブジェクトを使います。抽出したデータは，抽出データ格納ファイルに格納します。

データの転送

サーバにあるデータベースの内容を，クライアントPCのファイルやクリップボードに送ることです。

データベース

論理的に関連のあるデータの集合のことです。

トランザクション

DBPARTNER2 Clientからデータベースへの処理要求の単位をトランザクションといいます。トランザクションは，Executeメソッドを実行してからCommitメソッド又はRollbackメソッドを実行するまでを一つの単位として扱います。

（ハ行）

排他オプション

抽出表，更新表を処理するときの排他制御を設定する文字列のことです。

表

データの集まりの単位のことです。データベースによっては，ファイルやテーブルに相当します。DBPARTNER2 Clientではファイルやテーブルを含めて，表といいます。

表絞り込み条件

取得する表情報を絞り込むための条件のことです。

表情報

データベースに定義されている表の情報のことです。表の情報には，表名，属性，所有者，注釈，ラベルがあります。

表番号

複数の表を識別するための番号のことです。

表名

表を識別するための名称のことです。自分の表と他人の表を区別したいときは，表名を所有者で修飾します。

ヘッダ

データを取得するときに列名の代わりに使う文字列のことです。

ヘッダ出力モード

抽出データの先頭行にヘッダを付けるかどうかの設定のことです。

変更行条件

変更する行を特定するための1列分の条件のことです。

変更情報

変更行条件で特定した行のデータを変更する1列分の情報のことです。

変更処理

更新表の1行又は複数行のデータを変更する処理のことです。

（ラ行）

列一覧

データベースの表を構成する列の一覧のことです。

列情報

データベースに定義されている表を構成する列の情報のことです。列の情報には，列名，属性，定義長，小数点以下けた数，注釈，ラベルがあります。

列番号

複数の列を識別するための番号のことです。

列名

データベースに表を定義するときに指定した列の名前のことです。データベースによっては，カラム名，欄名に相当します。DBPARTNER2 Clientではカラム名や欄名を含めて，列名といいます。複数の表を扱うときは，列名を表名で修飾します。

（ワ行）

ワイルドカード

文字の代わりに指定する記号のことです。検索する単語の一部しか分からないとき，分からない部分をワイルドカードに置き換えて指定します。ワイルドカードは抽出する表を絞り込む操作で使えます。

索引

記号

［DBPARTNER ODBC Driver for DABroker −環境定義−］ダイアログボックス[1]

［DBPARTNER ODBC Driver for DABroker −セットアップ−］ダイアログボックス[1]

［ODBCデータソースアドミニストレータ］ダイアログボックス[1]

A

ACE3 E3[1]、[2]、[3]

ACE3 E3がサーバプログラムのとき[1]

ACE3ユーザファイル[1]、[2]

ACE3ユーザファイルの場合の規則[1]、[2]

ActiveXコントロール[1]、[2]、[3]、[4]、[5]

ActiveXコントロールのオブジェクトの階層[1]、[2]

ActiveXコントロールのオブジェクトの文法（ODBC接続）[1]

Adaptive Server Anywhere[1]、[2]

AddInsertValueBメソッド[1]

AddInsertValueBメソッド〔ODBC〕[1]

AddInsertValueメソッド[1]、[2]

AddInsertValueメソッド〔CommuniNet〕[1]

AddInsertValueメソッド〔ODBC〕[1]

AddKeyメソッド[1]、[2]、[3]、[4]

AddKeyメソッド〔CommuniNet〕[1]、[2]

AddKeyメソッド〔ODBC〕[1]、[2]

AddUpdateValueBメソッド[1]

AddUpdateValueBメソッド〔ODBC〕[1]

AddUpdateValueメソッド[1]

AddUpdateValueメソッド〔CommuniNet〕[1]

AddUpdateValueメソッド〔ODBC〕[1]

Addメソッド[1]、[2]、[3]、[4]、[5]、[6]

Addメソッド〔CommuniNet〕[1]、[2]、[3]、[4]、[5]、[6]

Addメソッド〔ODBC〕[1]、[2]、[3]、[4]、[5]、[6]

AND[1]

APPGALLERY 4.0[1]

AP作成ウィザード[1]

B

BLOB型データ[1]

C

CancelExメソッド〔CommuniNet〕[1]

CancelExメソッド〔ODBC〕[1]

Cancelメソッド[1]、[2]

Cancelメソッド〔CommuniNet〕[1]

Cancelメソッド〔ODBC〕[1]

Catalogオブジェクト[1]

Catalogオブジェクトの詳細〔CommuniNet〕[1]

Catalogオブジェクトの詳細〔ODBC〕[1]

Closeメソッド[1]、[2]

Closeメソッド〔CommuniNet〕[1]

Closeメソッド〔ODBC〕[1]

CodeChangeModeプロパティ〔CommuniNet〕[1]

ColumnCommentプロパティ[1]、[2]、[3]、[4]

ColumnCommentプロパティ〔CommuniNet〕[1]

ColumnCommentプロパティ〔ODBC〕[1]

ColumnEditPatternプロパティ[1]、[2]

ColumnEditPatternプロパティ〔CommuniNet〕[1]

ColumnHeaderプロパティ[1]、[2]、[3]、[4]

ColumnHeaderプロパティ〔CommuniNet〕[1]

ColumnHeaderプロパティ〔ODBC〕[1]

ColumnLengthプロパティ[1]、[2]、[3]、[4]

ColumnLengthプロパティ〔CommuniNet〕[1]

ColumnLengthプロパティ〔ODBC〕[1]

ColumnListオブジェクト[1]、[2]、[3]、[4]

ColumnListオブジェクトの詳細〔CommuniNet〕[1]

ColumnListオブジェクトの詳細〔ODBC〕[1]

ColumnNameLengthプロパティ〔ODBC〕[1]

ColumnNameプロパティ[1]、[2]、[3]、[4]

ColumnNameプロパティ〔CommuniNet〕[1]、[2]

ColumnNameプロパティ〔ODBC〕[1]、[2]

ColumnNumberプロパティ[1]、[2]

ColumnNumberプロパティ〔CommuniNet〕[1]

ColumnScaleプロパティ[1]、[2]、[3]、[4]

ColumnScaleプロパティ〔CommuniNet〕[1]

ColumnScaleプロパティ〔ODBC〕[1]

Columnsコレクションオブジェクトの詳細〔CommuniNet〕[1]

Columnsコレクションオブジェクトの詳細〔ODBC〕[1]

ColumnTypeプロパティ[1]、[2]、[3]、[4]

ColumnTypeプロパティ〔CommuniNet〕[1]

ColumnTypeプロパティ〔ODBC〕[1]

Columnオブジェクトの詳細〔CommuniNet〕[1]

Columnオブジェクトの詳細〔ODBC〕[1]

Columnプロパティ〔CommuniNet〕[1]、[2]

Columnプロパティ〔ODBC〕[1]、[2]

CommitModeプロパティ[1]、[2]、[3]、[4]

CommitModeプロパティ〔CommuniNet〕[1]

CommitModeプロパティ〔ODBC〕[1]

Commitメソッド[1]、[2]

Commitメソッド〔CommuniNet〕[1]

Commitメソッド〔ODBC〕[1]

CommuniNet Extension Version 3.0[1]

CommuniNet Version 3.0[1]

CommuniNet接続[1]、[2]

CommuniNet接続でアクセスできるデータベース[1]

CommuniNet接続のときのプロパティとメソッドの制限値[1]

CommuniNet接続のときの列の属性[1]

CommuniNet接続を使うときの参照情報[1]

Conditionsコレクションオブジェクトの詳細〔CommuniNet〕[1]

Conditionsコレクションオブジェクトの詳細〔ODBC〕[1]

Conditionオブジェクトの詳細〔CommuniNet〕[1]

Conditionオブジェクトの詳細〔ODBC〕[1]

ConnectDialogModeプロパティ[1]

ConnectDialogModeプロパティ〔ODBC〕[1]

Connectメソッド[1]、[2]

Connectメソッド〔CommuniNet〕[1]

Connectメソッド〔ODBC〕[1]

Convertメソッド〔CommuniNet〕[1]

Convertメソッド〔ODBC〕[1]

CopyToClipboardメソッド[1]、[2]

CopyToClipboardメソッド〔CommuniNet〕[1]

CopyToClipboardメソッド〔ODBC〕[1]

CountLimitプロパティ[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]

CountLimitプロパティ〔CommuniNet〕[1]

CountLimitプロパティ〔ODBC〕[1]、[2]

CountLimitプロパティ[1]

Countプロパティ[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]

Countプロパティ〔CommuniNet〕[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]、[9]

Countプロパティ〔ODBC〕[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]、[9]、[10]、[11]

CSV形式[1]、[2]、[3]、[4]、[5]

D

DABroker[1]、[2]、[3]

DABroker（DBPARTNER/Serverドライバ）[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]

DABrokerドライバ[1]、[2]

DABrokerドライバ（DBPARTNER/Serverドライバ）のセットアップ手順[1]

DABrokerドライバで使えるODBC関数[1]

DABrokerドライバのデータソースと通信ドライバの設定[1]

DABrokerドライバの場合に，各データベースで使える機能[1]

DABrokerドライバの場合のODBCとデータベースとのデータ型の対応[1]

DABrokerドライバを選択すると作成されるファイル[1]

Database Connection Server[1]、[2]、[3]、[4]

DataCheckプロパティ[1]、[2]

DataCheckプロパティ〔CommuniNet〕[1]

DataCheckプロパティ〔ODBC〕[1]

DataSourceプロパティ[1]

DataSourceプロパティ〔ODBC〕[1]

DAT形式[1]、[2]、[3]、[4]、[5]

DBPARTNER/Link[1]、[2]、[3]

DBPARTNER2 Client[1]、[2]、[3]

DBPARTNER2 Clientが扱うデータの形式[1]

DBPARTNER2 Clientが稼働する環境（CommuniNet接続）[1]

DBPARTNER2 Clientが稼働する環境（ODBC接続）[1]

DBPARTNER2 Clientが提供するActiveXコントロールの概要[1]、[2]

DBPARTNER2 Clientからデータベースにアクセスする手順の概要[1]、[2]

DBPARTNER2 Clientで自動的にトランザクションを制御するとき[1]、[2]

DBPARTNER2 Clientで使えるサーバプログラム[1]

DBPARTNER2 Clientとサーバを接続する形態[1]

DBPARTNER2 Clientに関連する製品[1]

DBPARTNER2 Clientのインストール[1]

DBPARTNER2 Clientのインストールのメッセージ[1]

DBPARTNER2 Clientのオブジェクトの文法（CommuniNet接続）〔CommuniNet〕[1]

DBPARTNER2 Clientのオブジェクトの文法（ODBC接続）[1]

DBPARTNER2 Clientの環境を設定する手順[1]

DBPARTNER2 Clientの機能[1]

DBPARTNER2 Clientの紹介[1]

DBPARTNER2 Clientの製品体系[1]

DBPARTNER2 Clientの操作時に起こるトラブル[1]

DBPARTNER2 Clientの特長[1]

DBPARTNER2 Clientの文字定数の値[1]、[2]

DBPARTNER2 Clientの予約語[1]

DBPARTNER2 Clientを使ったデータの更新[1]

DBPARTNER2 Clientを使ったデータの抽出[1]

DBPARTNER2 Clientを使ったデータベースアクセスの概要[1]

DBPARTNER ODBC 3.0 Driver[1]

DBPARTNER ODBC Driverのメッセージ[1]

DBPARTNERオブジェクト[1]、[2]、[3]、[4]

DBPARTNERオブジェクトの詳細〔CommuniNet〕[1]

DBPARTNERオブジェクトの詳細〔ODBC〕[1]

dbpTypeLONGVARBINARY属性の列のデータ〔ODBC〕[1]

Deletesコレクションオブジェクトの詳細〔CommuniNet〕[1]

Deletesコレクションオブジェクトの詳細〔ODBC〕[1]

Deleteオブジェクト[1]、[2]

Deleteオブジェクトの詳細〔CommuniNet〕[1]

Deleteオブジェクトの詳細〔ODBC〕[1]

DF/K[1]

DF1[1]

DictPathプロパティ〔CommuniNet〕[1]

DictPathプロパティ〔ODBC〕[1]

Disconnectメソッド[1]、[2]

Disconnectメソッド〔CommuniNet〕[1]

Disconnectメソッド〔ODBC〕[1]

E

EOFプロパティ[1]、[2]

EOFプロパティ〔CommuniNet〕[1]

EOFプロパティ〔ODBC〕[1]

ErrorInformationプロパティ〔CommuniNet〕[1]

ErrorInformationプロパティ〔ODBC〕[1]

Exclusiveプロパティ[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]

Exclusiveプロパティ〔CommuniNet〕[1]、[2]

Exclusiveプロパティ〔ODBC〕[1]、[2]

ExecutedRowCountプロパティ[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]

ExecutedRowCountプロパティ〔CommuniNet〕[1]

ExecutedRowCountプロパティ〔ODBC〕[1]、[2]

Executeメソッド[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]、[9]、[10]

Executeメソッド〔CommuniNet〕[1]、[2]

Executeメソッド〔ODBC〕[1]、[2]、[3]、[4]

F

FieldCodeTypeプロパティ[1]

FieldCodeTypeプロパティ〔ODBC〕[1]

FieldCodeTypeプロパティで取得するデータ[1]

FieldCodeTypeプロパティに設定した値とデータ取得の関係[1]

FieldCountプロパティ[1]、[2]

FieldCountプロパティ〔CommuniNet〕[1]

FieldCountプロパティ〔ODBC〕[1]

FieldDataBプロパティ[1]

FieldDataBプロパティ〔ODBC〕[1]

FieldDataLengthプロパティ[1]、[2]

FieldDataLengthプロパティ〔CommuniNet〕[1]

FieldDataLengthプロパティ〔ODBC〕[1]

FieldDataプロパティ[1]、[2]

FieldDataプロパティ〔CommuniNet〕[1]

FieldDataプロパティ〔ODBC〕[1]

FieldHeaderプロパティ[1]、[2]

FieldHeaderプロパティ〔CommuniNet〕[1]

FieldHeaderプロパティ〔ODBC〕[1]

FieldNameLengthプロパティ〔ODBC〕[1]

FieldTypeプロパティ[1]

FieldTypeプロパティ〔ODBC〕[1]

FileLoadメソッド〔CommuniNet〕[1]

FileLoadメソッド〔ODBC〕[1]

FunctionModeプロパティ〔CommuniNet〕[1]

FunctionModeプロパティ〔ODBC〕[1]

G

GetListメソッド〔ODBC〕[1]

GetParamメソッド〔ODBC〕[1]

Getメソッド[1]、[2]、[3]、[4]、[5]、[6]

Getメソッド〔CommuniNet〕[1]、[2]、[3]

Getメソッド〔ODBC〕[1]、[2]、[3]

H

HeaderOutputプロパティ[1]、[2]

HeaderOutputプロパティ〔CommuniNet〕[1]

HeaderOutputプロパティ〔ODBC〕[1]

HiRDB[1]、[2]

HiRDB ODBC Driver[1]

HiRDBのエラーメッセージの見方[1]

HOAPDBS/PC[1]、[2]、[3]

HOAPDBS E2[1]、[2]、[3]

HOAPDBSがサーバプログラムのとき[1]

I

Insertsコレクションオブジェクトの詳細〔CommuniNet〕[1]

Insertsコレクションオブジェクトの詳細〔ODBC〕[1]

InsertValueBプロパティ〔ODBC〕[1]

InsertValueBプロパティ[1]

InsertValueCountプロパティ〔CommuniNet〕[1]

InsertValueCountプロパティ〔ODBC〕[1]

InsertValueプロパティ[1]

InsertValueプロパティ〔CommuniNet〕[1]

InsertValueプロパティ〔ODBC〕[1]

Insertオブジェクト[1]、[2]

Insertオブジェクトの詳細〔CommuniNet〕[1]

Insertオブジェクトの詳細〔ODBC〕[1]

IsConnectプロパティ[1]

IsConnectプロパティ〔CommuniNet〕[1]

IsConnectプロパティ〔ODBC〕[1]

Itemメソッド〔CommuniNet〕[1]、[2]、[3]、[4]、[5]、[6]

Itemメソッド〔ODBC〕[1]、[2]、[3]、[4]、[5]、[6]

K

KeyColumnプロパティ[1]

KeyColumnプロパティ〔CommuniNet〕[1]、[2]

KeyColumnプロパティ〔ODBC〕[1]、[2]

KeyCountプロパティ[1]

KeyCountプロパティ〔CommuniNet〕[1]、[2]

KeyCountプロパティ〔ODBC〕[1]、[2]

KeyValueプロパティ[1]

KeyValueプロパティ〔CommuniNet〕[1]、[2]

KeyValueプロパティ〔ODBC〕[1]、[2]

L

LIKE条件[1]

ListPatternプロパティ〔ODBC〕[1]

LogoffFileNameプロパティ[1]

LogoffFileNameプロパティ〔CommuniNet〕[1]

LogonFileNameプロパティ[1]

LogonFileNameプロパティ〔CommuniNet〕[1]

lsConnectプロパティ[1]、[2]

M

MacroTimeLimitプロパティ[1]

MacroTimeLimitプロパティ〔CommuniNet〕[1]

N

NCharPrefixModeプロパティ[1]、[2]、[3]

NCharPrefixModeプロパティ〔ODBC〕[1]

NCHAR定数モード〔用語解説〕[1]

NULL条件[1]

O

ODBC[1]

ODBC関数のオプション値[1]

ODBC関数の概要[1]

ODBC関数の規則[1]

ODBC関数の非同期実行[1]

ODBC関数を使ったデータベースアクセス[1]

ODBC接続[1]

ODBC接続のときのプロパティとメソッドの制限値[1]

ODBC接続のときの列の属性[1]

ODBCとデータベースとのデータ型の対応[1]

ODBCドライバ[1]、[2]

ODBCドライバのインストールの手順[1]

ODBCドライバの種類[1]

ODBCドライバのセットアップ[1]

ODBCドライバを使ってアクセスできるデータベース[1]、[2]

OR[1]

Oracle[1]、[2]

P

ParamCodeTypeプロパティ〔ODBC〕[1]

ParamCommentプロパティ〔ODBC〕[1]

ParamDataTypeプロパティ〔ODBC〕[1]

ParamLengthプロパティ〔ODBC〕[1]

ParamListオブジェクトの詳細〔ODBC〕[1]

ParamNameプロパティ〔ODBC〕[1]

ParamNullableプロパティ〔ODBC〕[1]

ParamPrecisionプロパティ〔ODBC〕[1]

ParamRadixプロパティ〔ODBC〕[1]

ParamScaleプロパティ〔ODBC〕[1]

ParamTypeNameプロパティ〔ODBC〕[1]

ParamTypeプロパティ〔ODBC〕[1]

ParamValueBプロパティ〔ODBC〕[1]

ParamValueMaxLengthプロパティ〔ODBC〕[1]

ParamValueプロパティ〔ODBC〕[1]

Passwordプロパティ[1]、[2]

Passwordプロパティ〔CommuniNet〕[1]

Passwordプロパティ〔ODBC〕[1]

Patternプロパティ[1]、[2]、[3]、[4]

Patternプロパティ〔CommuniNet〕[1]

Patternプロパティ〔ODBC〕[1]

PDMII E2[1]、[2]、[3]、[4]

PDMII E2の場合の規則[1]

Power Builder 5.0[1]

ProcedureCommentプロパティ〔ODBC〕[1]

ProcedureListオブジェクトの詳細[1]

ProcedureNameプロパティ〔ODBC〕[1]

ProcedureOwnerプロパティ〔ODBC〕[1]

ProcedureTypeプロパティ〔ODBC〕[1]

Procedureオブジェクト[1]

Procedureオブジェクトの詳細〔ODBC〕[1]

Q

QueryCountLimitプロパティ[1]、[2]

QueryCountLimitプロパティ〔CommuniNet〕[1]

QueryCountLimitプロパティ〔ODBC〕[1]

QueryCountメソッド〔CommuniNet〕[1]

QueryCountメソッド〔ODBC〕[1]

QueryDefineオブジェクト[1]、[2]、[3]

QueryDefineオブジェクトの詳細〔CommuniNet〕[1]

QueryDefineオブジェクトの詳細〔ODBC〕[1]

R

RDA Link for Gateway[1]

RDB1[1]

RDB1 E2[1]、[2]

RDB1の場合の規則[1]

RDB編成ファイル[1]、[2]、[3]、[4]

RDB編成ファイルの場合の規則[1]

RecordDataプロパティ[1]、[2]

RecordDataプロパティ〔CommuniNet〕[1]

RecordDataプロパティ〔ODBC〕[1]

RecordHeaderプロパティ[1]、[2]

RecordHeaderプロパティ〔CommuniNet〕[1]

RecordHeaderプロパティ〔ODBC〕[1]

Relationプロパティ〔CommuniNet〕[1]

Relationプロパティ〔ODBC〕[1]

RemoveAllメソッド〔CommuniNet〕[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]

RemoveAllメソッド〔ODBC〕[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]

ResponseLimitプロパティ[1]

ResponseLimitプロパティ〔CommuniNet〕[1]

Resultオブジェクト[1]、[2]、[3]

Resultオブジェクトの詳細〔CommuniNet〕[1]

Resultオブジェクトの詳細〔ODBC〕[1]

Rollbackメソッド[1]、[2]

Rollbackメソッド〔CommuniNet〕[1]

Rollbackメソッド〔ODBC〕[1]

S

SaveLargeObjectメソッド[1]

SaveLargeObjectメソッド〔ODBC〕[1]

SaveToFileメソッド〔CommuniNet〕[1]

SaveToFileメソッド〔ODBC〕[1]

SelectDictプロパティ〔CommuniNet〕[1]、[2]

SelectDictプロパティ〔ODBC〕[1]、[2]

Setup.exe[1]

SortModeプロパティ〔CommuniNet〕[1]

SortModeプロパティ〔ODBC〕[1]

SortPriorityプロパティ〔CommuniNet〕[1]

SortPriorityプロパティ〔ODBC〕[1]

SQLDirectオブジェクト[1]、[2]、[3]、[4]

SQLDirectオブジェクトの詳細〔ODBC〕[1]

SQLGetInfo[1]

SQL Server[1]、[2]

SQLTextプロパティ[1]、[2]

SQLTextプロパティ〔ODBC〕[1]

SQLデータ型[1]

SQL文〔ODBC〕[1]

SQL文〔用語解説〕[1]

SQLを直接記述してアクセス[1]

T

TableCommentプロパティ[1]、[2]、[3]、[4]

TableCommentプロパティ〔CommuniNet〕[1]

TableCommentプロパティ〔ODBC〕[1]

TableGroupNameプロパティ[1]、[2]

TableCreateDateプロパティ[1]、[2]、[3]、[4]

TableCreateDateプロパティ〔CommuniNet〕[1]

TableCreateDateプロパティ〔ODBC〕[1]

TableDataSourceプロパティ〔CommuniNet〕[1]

TableDataSourceプロパティ〔ODBC〕[1]

TableDBMNameプロパティ[1]、[2]

TableDBMNameプロパティ〔CommuniNet〕[1]

TableDefSourceプロパティ〔CommuniNet〕[1]

TableDefSourceプロパティ〔ODBC〕[1]

TableDeleteAuthプロパティ[1]、[2]

TableDeleteAuthプロパティ〔CommuniNet〕[1]

TableGroupNameプロパティ[1]、[2]

TableGroupNameプロパティ〔CommuniNet〕[1]

TableGroupNameプロパティ〔ODBC〕[1]

TableHeaderプロパティ[1]、[2]、[3]、[4]

TableHeaderプロパティ〔CommuniNet〕[1]

TableHeaderプロパティ〔ODBC〕[1]

TableInsertAuthプロパティ[1]、[2]

TableInsertAuthプロパティ〔CommuniNet〕[1]

TableListオブジェクト[1]、[2]、[3]、[4]

TableListオブジェクトの詳細〔CommuniNet〕[1]

TableListオブジェクトの詳細〔ODBC〕[1]

Tablenameプロパティ[1]、[2]

TableNameプロパティ[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]、[9]、[10]、[11]、[12]

TableNameプロパティ〔CommuniNet〕[1]、[2]、[3]、[4]

TableNameプロパティ〔ODBC〕[1]、[2]、[3]、[4]

TableOwnerプロパティ[1]、[2]、[3]、[4]

TableOwnerプロパティ〔CommuniNet〕[1]

TableOwnerプロパティ〔ODBC〕[1]

TablePasswordModeプロパティ[1]、[2]

TablePasswordModeプロパティ〔CommuniNet〕[1]

TablePasswordプロパティ[1]、[2]、[3]、[4]、[5]

TablePasswordプロパティ〔CommuniNet〕[1]、[2]、[3]

TableSelectAuthプロパティ[1]、[2]

TableSelectAuthプロパティ〔CommuniNet〕[1]

Tablesコレクションオブジェクトの詳細〔CommuniNet〕[1]

Tablesコレクションオブジェクトの詳細〔ODBC〕[1]

TableTypeプロパティ[1]、[2]、[3]、[4]

TableTypeプロパティ〔CommuniNet〕[1]

TableTypeプロパティ〔ODBC〕[1]

TableUpdateAuthプロパティ[1]、[2]

TableUpdateAuthプロパティ〔CommuniNet〕[1]

Tableオブジェクトの詳細〔CommuniNet〕[1]

Tableオブジェクトの詳細〔ODBC〕[1]

TargetDatabaseプロパティ[1]

TargetDatabase プロパティ〔CommuniNet〕[1]

TargetServerプロパティ[1]

TargetServerプロパティ〔CommuniNet〕[1]

TerminalCloseメソッド[1]

TerminalCloseメソッド〔CommuniNet〕[1]

TerminalModeプロパティ[1]

TerminalModeプロパティ〔CommuniNet〕[1]

TerminalNameプロパティ[1]

TerminalNameプロパティ〔CommuniNet〕[1]

TEXT形式[1]、[2]、[3]

Textプロパティ〔CommuniNet〕[1]

Textプロパティ〔ODBC〕[1]

TXT形式[1]、[2]

Typeプロパティ〔ODBC〕[1]

U

UpdateDefineオブジェクト[1]、[2]、[3]

UpdateDefineオブジェクトの詳細〔CommuniNet〕[1]

UpdateDefineオブジェクトの詳細〔ODBC〕[1]

UpdateModeプロパティ[1]、[2]、[3]、[4]、[5]、[6]

UpdateModeプロパティ〔CommuniNet〕[1]

UpdateModeプロパティ〔ODBC〕[1]

Updatesコレクションオブジェクトの詳細〔CommuniNet〕[1]

Updatesコレクションオブジェクトの詳細〔ODBC〕[1]

UpdateValueBプロパティ[1]

UpdateValueBプロパティ〔ODBC〕[1]

UpdateValueCountプロパティ〔CommuniNet〕[1]

UpdateValueCountプロパティ〔ODBC〕[1]

UpdateValueプロパティ[1]

UpdateValueプロパティ〔CommuniNet〕[1]

UpdateValueプロパティ〔ODBC〕[1]

UpdateValueメソッド[1]

Updateオブジェクト[1]、[2]

Updateオブジェクトの詳細〔CommuniNet〕[1]

Updateオブジェクトの詳細〔ODBC〕[1]

UserIDプロパティ[1]、[2]

UserIDプロパティ〔CommuniNet〕[1]

UserIDプロパティ〔ODBC〕[1]

V

VariableListオブジェクトの詳細〔CommuniNet〕[1]

VariableListオブジェクトの詳細〔ODBC〕[1]

VariableNameプロパティ〔CommuniNet〕[1]

VariableNameプロパティ〔ODBC〕[1]

VariableValueプロパティ〔CommuniNet〕[1]

VariableValueプロパティ〔ODBC〕[1]

Visual Basic[1]

Visual Basic 4.0（32ビット版）[1]

Visual Basic 5.0[1]

Visual Basic 6.0[1]

VOS1スプールファイル[1]

VOS1スプールファイルの場合の規則[1]

VOSKスプールファイル[1]

VOSKスプールファイルの作成日付〔ODBC〕[1]

VOSKスプールファイルの場合の規則[1]

X

XDM/DF[1]

XDM/RD E2[1]、[2]、[3]、[4]

XDM/RD E2の場合の規則[1]

XDM/SD E2[1]、[2]、[3]、[4]

XDM/SD E2の場合の規則[1]

XLSB形式[1]、[2]

XLSX形式[1]、[2]

XLS形式[1]、[2]、[3]、[4]、[5]

あ

アクセスするデータベースの制限[1]

アプリケーション[1]

アプリケーションからトランザクションを制御するとき[1]、[2]

アプリケーションのサンプル[1]、[2]

アプリケーションを使ったデータベースアクセス（CommuniNet接続）[1]

アプリケーションを使ったデータベースアクセス（ODBC接続）[1]

い

インストール[1]

インストールすると作成されるファイル[1]

インストール時に起こるトラブル[1]

え

エラーメッセージに付くODBC関数のプレフィックス[1]

お

応答監視時間[1]

オブジェクト[1]、[2]、[3]

オブジェクトの階層[1]、[2]

オブジェクトの文法（CommuniNet接続）〔CommuniNet〕[1]

か

外字の変換規則[1]

カスタムインストール〔用語解説〕[1]

稼働する環境（CommuniNet接続）[1]

稼働する環境（ODBC接続）[1]

環境の設定[1]

環境を設定する手順[1]

き

行数〔CommuniNet〕[1]

行数〔ODBC〕[1]、[2]

く

クイックインストール〔用語解説〕[1]

空白文字に変換されるコード[1]

クライアント/サーバ〔用語解説〕[1]

クライアントPC[1]

クライアントPCに必要なソフトウェア[1]、[2]

クライアント側プログラムでコード変換するときの注意[1]

クリップボードに出力〔CommuniNet〕[1]

クリップボードに出力〔ODBC〕[1]

け

件数を制限する[1]

こ

更新[1]

更新した行数〔CommuniNet〕[1]

更新した行数〔ODBC〕[1]

更新実行モードとデータ更新の関係[1]

更新種別〔CommuniNet〕[1]

更新種別〔ODBC〕[1]

更新種別〔用語解説〕[1]

更新処理〔用語解説〕[1]

更新する表名〔CommuniNet〕[1]

更新する表名〔ODBC〕[1]

更新版[1]

更新表〔用語解説〕[1]

コミットモード〔CommuniNet〕[1]

コミットモード〔ODBC〕[1]

さ

サーバ[1]

サーバ側で必要なソフトウェア[1]、[2]

サーバプログラム[1]、[2]、[3]、[4]、[5]、[6]

サーバプログラムと接続[1]

サーバプログラムと接続〔CommuniNet〕[1]

サーバプログラムとの接続状態〔CommuniNet〕[1]

サーバプログラムとの接続状態〔ODBC〕[1]

サーバプログラムとの接続を解除[1]

サーバプログラムとの接続を解除〔CommuniNet〕[1]

サーバプログラム〔用語解説〕[1]

サーバ〔用語解説〕[1]

サーバを接続する形態[1]

削除[1]

削除行条件〔用語解説〕[1]

削除処理〔用語解説〕[1]

避けて欲しい処理[1]、[2]

参照版[1]

サンプル[1]、[2]、[3]

し

システムに関するトラブル[1]

指定した件数までのデータの抽出[1]

自動的にトランザクションを制御するとき[1]、[2]

絞り込み[1]

絞り込み条件〔CommuniNet〕[1]

絞り込み条件〔ODBC〕[1]

絞り込み条件〔用語解説〕[1]

集合関数〔CommuniNet〕[1]

集合関数〔ODBC〕[1]

集合関数〔用語解説〕[1]

取得できるODBC関数のオプション値[1]

条件関連〔ODBC〕[1]

条件関連〔用語解説〕[1]

条件式〔CommuniNet〕[1]、[2]

条件式〔ODBC〕[1]、[2]

条件式を設定するときの規則[1]

条件に合うデータを抽出する[1]

条件〔用語解説〕[1]

条件を設定したデータの抽出[1]

所有者〔用語解説〕[1]

す

ストアドプロシジャの実行[1]

スプールファイル[1]、[2]

せ

制限値[1]、[2]

製品の種類[1]

製品の種類と使える機能の関係[1]

接続先〔ODBC〕[1]

そ

ソートモード〔用語解説〕[1]

ソート優先順位〔用語解説〕[1]

属性〔用語解説〕[1]

ち

抽出[1]、[2]

抽出条件〔用語解説〕[1]

抽出処理〔用語解説〕[1]

抽出するデータの形式[1]、[2]

抽出データ〔CommuniNet〕[1]

抽出データ〔ODBC〕[1]

抽出データ格納ファイル〔用語解説〕[1]

抽出データの管理[1]、[2]

抽出で使える機能の一覧[1]

抽出列の個数〔CommuniNet〕[1]

抽出列の個数〔ODBC〕[1]

抽出列の優先順位〔CommuniNet〕[1]

抽出列の優先順位〔ODBC〕[1]

抽出列の列名〔CommuniNet〕[1]

抽出列の列名〔ODBC〕[1]

抽出列〔用語解説〕[1]

つ

追加[1]

追加情報〔用語解説〕[1]

追加処理〔用語解説〕[1]

使えるデータベースと表の数[1]、[2]

て

定義版[1]

データ型[1]

データ受信用領域サイズ[1]

データソース[1]

データソースのセットアップ[1]

データソース名[1]、[2]

データソース名の削除[1]

データソース名の変更[1]

データソース名〔用語解説〕[1]

データの形式[1]、[2]、[3]

データの更新[1]、[2]

データの更新（SQLDirectオブジェクト）[1]

データの更新（UpdateDefineオブジェクト）[1]

データの更新〔用語解説〕[1]

データの削除[1]

データの絞り込み〔用語解説〕[1]

データの抽出[1]

データの抽出（Catalogオブジェクト）[1]

データの抽出（QueryDefineオブジェクト）[1]

データの抽出（SQLDirectオブジェクト）[1]

データの抽出（Catalogオブジェクト）[1]

データの抽出（QueryDefineオブジェクト）[1]

データの抽出〔用語解説〕[1]

データの追加[1]

データの転送〔用語解説〕[1]

データの変更[1]

データベース[1]、[2]、[3]、[4]

データベースアクセスの概要[1]

データベースアクセスの手順[1]、[2]

データベース識別子[1]

データベースと接続するときに起こるトラブル[1]

データベースとの接続の解除[1]、[2]

データベースとの接続の確認[1]、[2]

データベースとのデータ型の対応[1]

データベース別の規則[1]

データベースへのアクセスのキャンセル[1]、[2]

データベースへの接続[1]、[2]

データベースへの接続と接続の解除[1]、[2]

データベース〔用語解説〕[1]

データを更新（削除）[1]、[2]

データを更新（追加）[1]、[2]

データを更新（変更）[1]、[2]

データを更新する手順[1]

デッドロック[1]、[2]

と

特長[1]

特定の列だけを抽出する[1]

トップオブジェクト[1]、[2]

トラブルが起こったときは[1]

トラブルの現象と対処[1]

トランザクション[1]、[2]

トランザクションと排他制御[1]、[2]

トランザクションの終了モード[1]、[2]

トランザクションの制御の設定[1]、[2]

トランザクション〔用語解説〕[1]

は

排他エラーになったときの動作の設定[1]、[2]

排他オプション[1]、[2]

排他オプション〔CommuniNet〕[1]

排他オプション〔ODBC〕[1]

排他オプション〔用語解説〕[1]

排他制御[1]、[2]、[3]

排他制御の設定[1]、[2]

配列列を設定するときの規則[1]

パスワード[1]、[2]

パスワード〔CommuniNet〕[1]、[2]

パスワード〔ODBC〕[1]、[2]

ひ

比較条件[1]

ビジュアル開発ツール[1]、[2]

非同期実行[1]

表結合[1]

表情報の個数〔CommuniNet〕[1]

表情報の個数〔ODBC〕[1]

表情報の最大数〔CommuniNet〕[1]

表情報の最大数〔ODBC〕[1]

表情報の取得[1]、[2]

表情報〔用語解説〕[1]

表と列の情報の取得[1]、[2]

表の個数〔CommuniNet〕[1]

表の個数〔ODBC〕[1]

表の所有者〔CommuniNet〕[1]

表の所有者〔ODBC〕[1]

表の属性〔CommuniNet〕[1]

表の属性〔ODBC〕[1]、[2]

表の注釈〔CommuniNet〕[1]

表の注釈〔ODBC〕[1]

表のラベル〔CommuniNet〕[1]

表のラベル〔ODBC〕[1]

表番号〔用語解説〕[1]

表名〔CommuniNet〕[1]、[2]

表名〔ODBC〕[1]、[2]

表名と列名を検索[1]

表名〔用語解説〕[1]

表名を設定するときの規則[1]

表〔用語解説〕[1]

ふ

ファイルに出力〔CommuniNet〕[1]

ファイルに出力〔ODBC〕[1]

複数のデータベースにアクセスするとき[1]

複数の表を結合して抽出する[1]

プレフィックス〔ODBC〕[1]

プロパティとメソッドの実行順序[1]、[2]

プロパティとメソッドの制限[1]、[2]

プロパティとメソッドの制限値[1]

プロパティとメソッドの表記[1]、[2]

プロパティページの設定〔CommuniNet〕[1]

プロパティページの設定〔ODBC〕[1]

へ

ヘッダ〔CommuniNet〕[1]

ヘッダ〔ODBC〕[1]

ヘッダ出力モード〔用語解説〕[1]

ヘッダ〔用語解説〕[1]

変更[1]

変更行条件〔用語解説〕[1]

変更情報〔用語解説〕[1]

変更処理〔用語解説〕[1]

ほ

ホスト名称[1]

ま

マクロスクリプト[1]

マクロスクリプトの設定（CommuniNet接続の場合）[1]

マクロスクリプトファイルの例[1]

マルチメディアデータ[1]

め

メインフレーム[1]

メソッドの実行順序[1]、[2]

メソッドの制限値[1]、[2]、[3]

メッセージの一覧[1]

メッセージの形式[1]

メッセージの詳細[1]

も

文字定数の値[1]、[2]

ゆ

ユーザID[1]、[2]、[3]

ユーザID〔CommuniNet〕[1]、[2]

ユーザID〔ODBC〕[1]

ユーザIDとパスワードの入力を要求するダイアログボックス[1]

ユーザ外字変換ファイルの作成方法[1]

よ

予約語[1]

れ

列一覧〔用語解説〕[1]

列情報の個数〔CommuniNet〕[1]

列情報の個数〔ODBC〕[1]

列情報の最大数〔CommuniNet〕[1]

列情報の取得[1]、[2]

列情報〔用語解説〕[1]

列数〔CommuniNet〕[1]

列数〔ODBC〕[1]

列属性とデータベースの属性[1]

列の属性[1]

列の属性〔CommuniNet〕[1]

列の属性〔ODBC〕[1]、[2]

列の注釈〔CommuniNet〕[1]

列の注釈〔ODBC〕[1]

列の定義長〔CommuniNet〕[1]

列の定義長〔ODBC〕[1]

列のデータ〔CommuniNet〕[1]

列のデータ〔ODBC〕[1]、[2]

列のデータ長〔CommuniNet〕[1]

列のデータ長〔ODBC〕[1]

列のラベル〔CommuniNet〕[1]

列のラベル〔ODBC〕[1]

列の列名長〔ODBC〕[1]、[2]

列番号〔CommuniNet〕[1]

列番号〔用語解説〕[1]

列名〔CommuniNet〕[1]、[2]

列名〔ODBC〕[1]、[2]

列名〔用語解説〕[1]

列名を設定するときの規則[1]

ろ

ログイン画面〔ODBC〕[1]

ログオフスクリプト〔CommuniNet〕[1]

ログオンスクリプト〔CommuniNet〕[1]

わ

ワイルドカード〔用語解説〕[1]