DABroker

解説・操作書

3020-6-088-20

前書き

対象製品

P-2963-2354 DABroker(64) 03-24（適用OS:Windows Server 2003 x64 Edition，Windows Server 2008，Windows Server 2008 R2，Windows Server 2012，Windows Server 2012 R2，Windows Server 2016，Windows Sever 2019，Windows XP x64 Edition，Windows Vista，Windows 7，Windows 8，Windows 8.1，Windows 10）

P-8463-2451 DABroker(64) 03-24（適用OS:Red Hat Enterprise Linux Server 7（64-Bit x86_64），Red Hat Enterprise Linux Server 8（64-Bit x86_64））

これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「ソフトウェア添付資料」または「Readmeファイル」でご確認ください。

輸出時の注意

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

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

商標類

HITACHI，DABroker，DBPARTNER，HiRDB，HITSENSER，TPBroker，VOS3/LS，VOS3/US，VOS3/XSおよびXDMは，株式会社 日立製作所の商標または登録商標です。

AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

IBMは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。

Microsoftは，マイクロソフト 企業グループの商標です。

OracleおよびJavaは，オラクルおよびその関連会社の登録商標です。

Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hatは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

Red Hat Enterprise Linux is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hat Enterprise Linuxは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

SQL Serverは，マイクロソフト 企業グループの商標です。

UNIXは，The Open Groupの商標です。

Windowsは，マイクロソフト 企業グループの商標です。

Windows Serverは，マイクロソフト 企業グループの商標です。

Windows Vistaは，マイクロソフト 企業グループの商標です。

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

発行

2021年12月　3020-6-088-20

著作権

All Rights Reserved. Copyright (C) 2009, 2021, Hitachi, Ltd.

変更内容

変更内容（3020-6-088-20）　DABroker　03-24

追加・変更内容

変更個所

Oracle19cをサポートしました。

1.2.3，3.5.1(6)，3.11，4.5.1(6)，4.9.2(3)，6.4.2，6.4.3(4)，6.5.2(4)

次に示すメッセージを追加しました。

KFDB027DB-E

7.3

変更内容（3020-6-088-20）　DABroker　03-23

追加・変更内容

変更個所

DBPARTNER2 Client，DBPARTNER ODBC DriverからHiRDBのTimestamp属性を使用できるようにしました。

—

HiRDB V10をサポートしました。

4.9.2(3)，6.4.2

Oracle12c R2をサポートしました。

3.5.1(6)

変更内容（3020-6-088-20）　DABroker　03-22

追加・変更内容

変更個所

DABrokerセットアップコマンドの指定値「-d」の説明を変更しました。

3.2.3(1)(a)

Windows上でDBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合の，ネットワーク環境の設定方法の説明を変更しました。

4.3.1

Windows上でDatabase Connection Serverを経由してメインフレーム系データベースにアクセスする場合の，ネットワーク環境の設定方法の説明を変更しました。

4.3.2

次に示すメッセージの説明を変更しました。

KFDB012YM-E

7.3

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，次に示すプログラムプロダクトの機能と使い方について説明したものです。

P-2963-2354　DABroker(64)

P-8463-2351　DABroker(64)

対象読者

このマニュアルは，DABrokerを使用してデータベースにアクセスする方を対象としています。

マニュアルの構成

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

第1章　DABrokerの概要（共通）

DABroker及びDABroker関連製品の使用目的及び特長について説明しています。

第2章　DABrokerの機能（共通）

DABroker及びDABroker関連製品の使用目的を実現する機能について説明しています。

第3章　DABrokerの環境設定と運用（UNIX）

UNIXで使用する場合に，DABrokerを起動する前に必要な環境設定，及びDABrokerの運用方法，運用コマンドについて説明しています。

第4章　DABrokerの環境設定と運用（Windows）

Windowsで使用する場合に，DABrokerを起動する前に必要な環境設定，及びDABrokerの運用方法，ユティリティについて説明しています。

第5章　DABrokerの運用（共通）

DABrokerの運用方法について説明しています。

第6章　DABrokerの障害対策（共通）

DABrokerの障害時にユーザが取得する情報について説明しています。

第7章　メッセージ（共通）

DABrokerが発行するメッセージの要因と対処について説明しています。

付録A　用語解説（共通）

DABrokerで使用する用語について説明しています。

関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

そのほか，このマニュアルに関連するマニュアルを次に示します。必要に応じてお読みください。

「DBPARTNER2 Client　操作ガイド」（3020-6-027）

「DBPARTNER2 Client　操作ガイド」（3020-6-151）

「DBPARTNER2 Client(64)　操作ガイド」（3020-6-153）

クライアントからのデータベースのデータを使用する場合に参照してください。

「DBPARTNER2 Client　プログラマーズガイド」（3020-6-028）

「DBPARTNER2 Client　プログラマーズガイド」（3020-6-152）

クライアントからのデータベースのデータを使用する場合に参照してください。

インターネット又はイントラネット環境下で，WWWブラウザからデータベースのデータを使用する場合に参照してください。

「HITSENSER5」（3020-6-070）

データベースのデータを使用して，クライアント／サーバ環境で多次元分析（OLAP）をする場合に参照してください。

「HITSENSER5 Web」（3020-6-080）

データベースのデータを使用して，WWWブラウザから多次元分析（OLAP）をする場合に参照してください。

「スケーラブルデータベースサーバ HiRDB Version 8 メッセージ」（3020-6-358）

「HiRDB Version 9 メッセージ」（3020-6-458）

「HiRDB Version 10 メッセージ」（3020-6-562）

HiRDBからのエラーメッセージが出力された場合に参照してください。なお，HiRDBの形名に応じたマニュアルを参照してください。

「スケーラブルデータベースサーバ HiRDB Version 8 UAP 開発ガイド」（3020-6-356）

「HiRDB Version 9 UAP 開発ガイド」（3020-6-456）

「HiRDB Version 10 UAP 開発ガイド」（3020-6-560）

HiRDBの環境変数を設定する場合に参照してください。なお，HiRDBの形名に応じたマニュアルを参照してください。

「スケーラブルデータベースサーバ HiRDB Version 8 SQL リファレンス」（3020-6-357）

「HiRDB Version 9 SQL リファレンス」（3020-6-457）

「HiRDB Version 10 SQL リファレンス」（3020-6-561）

HiRDBとのアクセストレースのRETCODEの内容を知る場合に参照してください。なお，HiRDBの形名に応じたマニュアルを参照してください。

「Database Connection Server」（6190-6-648）

「Database Connection Server」（650-3-243）

「Database Connection Server」（6150-6-802）

Database Connection Serverの機能概要，及び環境設定方法などを知る場合に参照してください。

「データマネージメントシステム　XDM E2系　XDM/RD　E2　解説」（6190-6-637）

「データマネージメントシステム　XDM E2系　プログラム作成の手引（XDM/RD E2）」（6190-6-638）

「データマネージメントシステム　XDM E2系　XDM/RD　E2　SQL入門」（6190-6-655）

「データマネージメントシステム　XDM E2系　XDM/RD　E2　SQLリファレンス」（6190-6-656）

「データマネージメントシステム　XDM E2系　XDM/RD　E2　性能設計」（6190-6-657）

「データマネージメントシステム　XDM E2系　ユティリティ（XDM/RD E2 第１分冊）」（6190-6-647）

「データマネージメントシステム　XDM E2系　ユティリティ（XDM/RD E2 第２分冊）」（6190-6-639）

「データマネージメントシステム　XDM E2系　ユティリティ（XDM/RD E2 第3分冊）」（6190-6-659）

「データマネージメントシステム　XDM E2系　メッセージ（XDM/RD E2）」（6190-6-643）

「データマネージメントシステム　XDM E2系　XDM/RD E2　使用の手引−システム作成・維持編−」（6190-6-644）

「データマネージメントシステム　XDM E2系　XDM/RD　IDP支援　E2　使用の手引」（6180-6-632）

「データマネージメントシステム　XDM E2系　XDM/RD E2　使用の手引−運用編−」（6190-6-660）

「データマネージメントシステム　XDM E2系　XDM/RD E2　使用の手引−RD環境定義文・空間起動制御文・運用コマンド編−」（6190-6-661）

VOS3 XDM/RDを使用する場合の運用方法などを知る場合に参照してください。

「データマネージメントシステム　XDM E2系　プログラム作成の手引（XDM/SD）」（6190-6-652）

「エンドユーザ言語　ACE3 E3　操作編」（6190-6-705）

「エンドユーザ言語　ACE3 E3　定義編」（6190-6-706）

VOS3 XDM/SDを使用する場合の運用方法などを知る場合に参照してください。

「データマネージメントシステム　RDB1 E2　解説」（6150-6-560）

「データマネージメントシステム　RDB1 E2　使用の手引」（6150-6-561）

「データマネージメントシステム　RDB1 E2 EQL文法」（6150-6-562）

VOS1 RDB1 E2を使用する場合の運用方法などを知る場合に参照してください。

「データベースマネージメントシステム　PDM II E2 使用の手引」（6150-6-514）

VOS1 PDM II E2を使用する場合の運用方法などを知る場合に参照してください。

「VOSK DBPARTNER Library」（650-3-240）

VOSK DBPARTNER Libraryを使用する場合の運用方法などを知る場合に参照してください。

「SQL/K」（650-3-241）

VOSK RDB編成ファイル（VOSK SQL/K）を使用する場合の運用方法などを知る場合に参照してください。

「トランザクショナル分散オブジェクト基盤 TPBroker ユーザーズガイド」（3000-3-660）

「TPBroker Developer's Kit - Extension for C++ プログラマーズガイド」（3000-3-680）

「トランザクショナル分散オブジェクト基盤 TPBroker Object Transaction Monitor ユーザーズガイド」（3000-3-689）

TPBrokerの機能概要，環境設定方法などを知る場合に参照してください。

読書手順

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

このマニュアルで使用している記号

このマニュアルで使用している記号について，次に示します。

記　号

説　　　明

{　　　}

この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が縦に複数行にわたって記述されている場合は，そのうちの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が指定されたときと同じ処理をする」ことを示します。

（例）

〔A={B|C|D}〕では「オペランドAを指定しなかった場合，システムはA=Bを指定されたときと同じ処理をする」ことを示します。

<　>

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

△

1個の半角の空白を示します。

△n

n個以上の半角の空白を示します。

↓計算式↓

計算式の答えの小数点以下を切り捨てることを示します。

↑計算式↑

計算式の答えの小数点以下を切り上げることを示します。

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

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

種　類

定　義

<英字>

A〜Z a〜z

<英大文字>

A〜Z ＠　＃　￥

<カナ文字>

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

<数字>

0〜9

<数値>

<数字>　.　+　-

<英数字>

<英字>及び<数字>

<漢字>

2バイトコードの文字列

図中で使用する記号

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

このマニュアルでの表記

このマニュアルでは，製品名称，及び名称について次のように表記します。

製品名称又は名称

表記

AIX 5L

AIX

UNIX

AIX V6.1

AIX V7.1

HP-UX 11.0

HP-UX

HP-UX 11i

HP-UX 11i V2

HP-UX 11i V3

Red Hat Enterprise Linux AS4(AMD64&EMT64)

Red Hat Linux

Red Hat Enterprise Linux ES4(AMD64&EMT64)

Red Hat Enterprise Linux 5(AMD64&EMT64)

Red Hat Enterprise Linux 5 AdvancedPlatform(AMD64&EMT64)

Red Hat Enterprise Linux Server 6(64-Bit x86_64)

Red Hat Enterprise Linux Server 7(64-Bit x86_64)

Red Hat Enterprise Linux Server 8(64-Bit x86_64)

Application Programming Interface

API

Common Object Request Broker Architecture

CORBA

DABroker

DABroker

DABroker for Java

DABroker for Java

DABroker for Java Version 2

DABroker Driver for Java Technology

DABroker for Java Version 2

DABroker for Java Version 2

DABroker Driver for Java Technology

DABroker for Java Version 2 Extension

Extension

DABroker Driver Optional Package for Java Technology

Graphical User Interface

GUI

HiRDB Version 7

HiRDB

HiRDB Version 8

HiRDB Version 9

HiRDB Version 10

HITSENSER5 Standard for Cosmicube

HITSENSER5

HITSENSER5 Professional for Cosmicube

HITSENSER5 Standard for RDB

HITSENSER5 Professional for RDB

HITSENSER5 Standard

HITSENSER5 Professional

Microsoft SQL Server

SQL Server

Microsoft Windows XP Professional x64 Edition

Windows XP

Windows

Microsoft Windows Server 2003,Standard x64 Edition

Windows Server 2003

Microsoft Windows Server 2003,Enterprise x64 Edition

Microsoft Windows Server 2003,Datacenter x64 Edition

Microsoft Windows Server 2003 R2,Standard x64 Edition

Microsoft Windows Server 2003 R2,Enterprise x64 Edition

Microsoft Windows Server 2003 R2,Datacenter x64 Edition

Microsoft Windows Vista Business

Windows Vista

Microsoft Windows Vista Enterprise

Microsoft Windows Vista Ultimate

Microsoft Windows 7 Professional

Windows 7

Microsoft Windows 7 Enterprise

Microsoft Windows 7 Ultimate

Microsoft Windows 8 Pro

Windows 8

Microsoft Windows 8 Enterprise

Microsoft Windows 8.1 Pro

Microsoft Windows 8.1 Enterprise

Microsoft Windows 10 Pro

Windows 10

Microsoft Windows 10 Enterprise

Microsoft Windows Server 2008 Standard

Windows Server 2008

Microsoft Windows Server 2008 Enterprise

Microsoft Windows Server 2008 Datacenter

Microsoft Windows Server R2 2008 Standard

Microsoft Windows Server R2 2008 Enterprise

Microsoft Windows Server R2 2008 Datacenter

Microsoft Windows Server 2012 Standard

Windows Server 2012

Microsoft Windows Server 2012 Datacenter

Microsoft Windows Server 2012 R2 Standard

Microsoft Windows Server 2012 R2 Datacenter

Microsoft Windows Server 2016 Standard

Windows Server 2016

Microsoft Windows Server 2016 Datacenter

Microsoft Windows Server 2019 Standard

Windows Server 2019

Microsoft Windows Server 2019 Datacenter

On-Line Analytical Processing

OLAP

Open Database Connectivity

ODBC

Oracle10g

ORACLE

Oracle11g

Oracle11g R2

Oracle12c

Oracle12c R2

Oracle19c

User Application Program

UAP

VOS3 XDM/RD E2

VOS3 XDM/RD

VOS3 XDM/SD E2

VOS3 XDM/SD

VOSK RDB編成ファイル

VOSK SQL/K

World Wide Web

WWW

このマニュアルでは，DBPARTNER関連の製品名称について，次のように表記します。

名称

マニュアルでの表記

DBPARTNER/Client

DBPARTNER/Client

DBPARTNER

DBPARTNER2 Client

DBPARTNER2 Client(64)

DBPARTNER/Client32

DBPARTNER/Web

DBPARTNER/Web

DBPARTNER2 Web

DBPARTNER/Web for Windows NT

特に，それぞれのプログラムについての記述が必要な場合は，そのまま表記します。

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

1　DABrokerの概要（共通）

この章では，DABrokerの目的及び特長について説明します。

UNIXを使用する環境とWindowsを使用する環境で共通の内容です。なお，DABrokerは，「ディーエーブローカー」と呼びます。

1.1　DABrokerとは

DABrokerは，データベースアクセスを実現するミドルウェアです。複数の異なるDBMSに共通のインタフェースでアクセスできる次のような環境を提供します。

データベースを活用するサーバアプリケーション開発向けインタフェース

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表のデータベースアクセスサーバ

次に，DABrokerの特長を示します。

1.1.1　マルチスレッドによる高性能な処理を実現

従来のデータベースアクセスを実現するミドルウェアは，アプリケーションからのデータベースアクセス要求をプロセス単位（シングルスレッド）で実行するため，同時に実行するプロセスの増加に伴い，システムリソースの消費が増大し，処理性能を劣化させていました。

DABrokerは，アプリケーションからのデータベースアクセス要求をスレッド単位で実行します（マルチスレッド）。マルチスレッドでは，一つのプロセスで使用するメモリ領域で複数のスレッド用のメモリ領域が確保でき，システムリソースの消費を軽減できます。したがって，従来のシングルスレッドでの実行に比べて，システムリソースの利用効率が向上します。

1.1.2　複数DBMSでの共通インタフェースを提供

DBMSが提供するアプリケーション開発用インタフェースは，DBMSごとに異なります。通常，複数のDBMSにアクセスする場合，それぞれのインタフェースに合わせたアプリケーションをDBMSごとに開発する必要があります。

DABrokerは，複数の異なるDBMSのアプリケーション開発用インタフェースを共通化しています。そのため，DABrokerを使用すると，データベースごとのアプリケーション開発用インタフェースの違いを意識することなく，複数のデータベースにアクセスするアプリケーションを開発できます。

ただし，DABrokerのアプリケーション開発用インタフェースを使っても，実行するSQL文の仕様は，各DBMSに依存します。

図1‒1　DABrokerのインタフェースを使用したアプリケーション開発

1.1.3　X/Open DTPモデルXAインタフェースを使用した分散トランザクションを実現

接続先が次のDBMSの場合，TPBrokerのOTS(Object Transaction Services)機能を利用することで，DABrokerからトランザクションを制御することなく，複数異種のデータベースに対して，X/Open DTPモデルXAインタフェースを使用した分散トランザクションを実現できます。

HiRDB

ORACLE

1.2　DABrokerの使用環境

DABrokerを使用すると，多様な環境でデータベースにアクセスできます。

DABrokerを使ったデータベースアクセスには，リモートアクセスとローカルアクセスの2種類があります。

リモートアクセスとは，クライアント側でアプリケーションが動作する環境を指します。DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表からのアクセスもリモートアクセスに分類されます。

ローカルアクセスとは，サーバ側でアプリケーションが動作する環境を指します。

DABrokerが対応する環境（形態）は次のとおりです。

クライアント／サーバ環境

クライアントマシン，サーバマシンの間でTCP/IPなどを使用して通信するシステム形態です。クライアント／サーバ環境でDABrokerを使用する場合には，図1-2で示す(1)〜(4)の形態があります。クライアント／サーバ環境は，リモートアクセスに分類されます。

(1)，(2)の形態については「1.3　アプリケーション開発用インタフェースの使用」を，(3)〜(6)の形態については「1.4　DBPARTNER，HITSENSER5などからのアクセス」を参照してください。

図1‒2　DABrokerの使用環境−1

WWW環境

インターネット又はイントラネットを利用したシステム形態です。WWW環境でDABrokerを使用する場合には，図1-3で示す(7)〜(14)の形態があります。WWW環境は，主にローカルアクセスに分類されます。(13)，(14)の形態だけは，リモートアクセスに分類されます。(7)〜(12)の形態については，WWW環境だけでなく，サーバアプリケーションの内容によって，クライアント／サーバ環境での運用もできます。(7)〜(12)の形態については，「1.3　アプリケーション開発用インタフェースの使用」を，(13)，(14)の形態については「1.4　DBPARTNER，HITSENSER5などからのアクセス」を参照してください。

モバイル環境

ノート型パーソナルコンピュータなどの携帯端末から公衆回線網を使って，移動先からLAN内の各種サーバにあるデータを利用する環境をモバイル環境と呼びます。モバイル環境は，リモートアクセスに分類されます。モバイル環境でDABrokerを使用する場合には，図1-3で示す(15)の形態があります。(15)については，「1.4　DBPARTNER，HITSENSER5などからのアクセス」を参照してください。

図1‒3　DABrokerの使用環境−2

1.2.1　アプリケーション開発用インタフェースが豊富

DABroker関連製品では，サーバアプリケーションを開発するためのインタフェースを提供します。提供するインタフェースは，多様な開発言語に対応しています。したがって，開発環境に応じた言語を選択できます。DABroker(64)関連製品で提供するインタフェースは，次のとおりです。

DABroker for Java

JDBCインタフェース（Java）

DABroker for ODBC

ODBCインタフェース

1.2.2　DBPARTNER，HITSENSER5，DBPARTNER Library，XDM/RD外部表からのアクセスをサポート

DABroker関連製品で提供するAPIを使ってアプリケーションを開発しなくても，GUIを提供するDBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表からデータベースにアクセスできます。

1.2.3　アクセスできるデータベースの種類が豊富

DABrokerは，次のDBMS及びリモートデータベースアクセス用プログラムに対応するインタフェースを提供します。

ORACLE

Oracle10g，Oracle11g，Oracle12c及びOracle19cにアクセスできます。

HiRDB

SQL Server

Windowsの場合だけアクセスできます。

ODBC3.0でアクセスします。

Database Connection Server

（メインフレーム系データベースへのアクセスを実現するプログラム）

DABrokerは，リレーショナルデータベースだけではなく，オブジェクトリレーショナルデータベースやメインフレーム環境のデータベースへのアクセスをサポートします。

アプリケーション開発で使用するインタフェースによって，アクセスできるデータベースが異なります。アクセスできるデータベースについては，次の各マニュアルを参照してください。

「DABroker for Java」

「DABroker for JavaTM Version 2　DABroker Driver for JavaTM Technology」

「DABroker for ODBC」

HITSENSER5からアクセスできるデータベースについては，HITSENSER5のマニュアルを参照してください。

(1)　リレーショナルデータベース（RDBMS）及びオブジェクトリレーショナルデータベース（ORDBMS）のサポート

DABrokerでは，RDBMS（Relational DBMS）の，ORACLE，HiRDB，及びSQL Serverへのアクセスをサポートします。

(2)　メインフレーム系データベースのサポート

DABrokerは，メインフレーム系データベースへのアクセスもサポートします。メインフレーム系データベースへのアクセスには，リモートデータベースへのアクセスを実現するDatabase Connection Serverを使用します。

Database Connection Serverを使ってアクセスできるデータベースは，次のとおりです。

VOS3 XDM/RD

VOS3 XDM/SD

VOSK SQL/K

VOS1 PDMII E2

VOS1 RDB1 E2

VOSK スプールファイル

使用するアプリケーション開発用インタフェースによって，アクセスできるデータベースが異なります。詳細については，各DABroker関連製品，DBPARTNERのマニュアルを参照してください。

1.2.4　分散トランザクション処理

TPBrokerのOTS(Object Transaction Services)機能，Java JTS機能を提供するトランザクションマネージャ(Java TM)を利用することで，DABrokerからトランザクションを制御することなく，複数異種のデータベースに対して，X/Open DTPモデルXAインタフェースを使用した分散トランザクションを実現できます。DABroker(64)ではJavaJTSを使用した分散トランザクション処理だけ使用できます。

(1)　Java JTSを使った分散トランザクション処理

(a)　Java JTSを使った分散トランザクション処理の概要

接続先が次のDBMSの場合，Java JTS機能を提供するトランザクションマネージャ(Java TM)を利用することで分散トランザクションを実現できます。

HiRDB

ORACLE

また，Java TMにトランザクションの制御を任せることで，DABrokerのデータベースアクセス処理と，Java TMと連携する他製品のリソースアクセス処理とを，一つのグローバルトランザクションとして同期制御できるようになります。複数異種の分散データベースへのアクセスの例を図1-4に示します。

図1‒4　複数異種の分散データベースへのアクセスの例（Java JTSを使った分散トランザクション処理）

(b)　Java JTSを利用するまでの手順

Java JTSを使って分散トランザクション処理を実現するには，次の手順で準備しておく必要があります。各手順の詳細については，Java TMが提供するドキュメントを参照してください。

Java TMの環境設定

DBMSのXA接続環境設定

DABroker for Java Version 2とExtensionのJTA環境設定

JNDI環境設定

DABrokerの環境設定

Java TMの開始

1.3　アプリケーション開発用インタフェースの使用

DABroker関連製品では，データベースにアクセスするアプリケーションを開発するための，インタフェースを提供します。ここでは，DABroker関連製品で提供する，アプリケーション開発用インタフェースの特長，及び使用形態について説明します。

1.3.1　DABroker for Javaで開発するアプリケーション

DABroker for Javaでは，JDBCインタフェースに対応するJDBCドライバを提供します。ここで開発するアプリケーションは，JDBCインタフェースの仕様に従って開発します。JDBCとは，Javaの標準的なデータベースアクセス用のインタフェースで，JDK1.2以降（java.sqlパッケージ）で提供されます。DABroker for Javaで開発するアプリケーションは，JDBCで実現できる検索，更新などの処理を要求できます。

DABroker for Javaでは，OSに依存しない実行環境を提供するなどのJavaの特長を活かしたアプリケーションを開発できます。また，Appletを開発した場合，AppletがダウンロードされるクライアントごとにAppletをメンテナンスする必要がないため，Applet開発者の負担を軽減できます。

Extension※は，JDBC2.0の拡張機能を提供します。JNDI（Java Naming and Directory Interface），JTS（Java Transaction Service）やJTA（Java Transaction API）との連携機能を提供します。

注※　DABroker for Java Version 2の機能です。

(1)　DABroker for Javaを使って開発するときの特長

次にDABroker for Javaの特長を示します。

(a)　クライアントアプリケーション及びサーバアプリケーションの開発

DABroker for Javaで開発できるアプリケーションには，次の三種類があります。それぞれのアプリケーションは，JDBCインタフェースの仕様に従って開発します。

Applet

WWWサーバからダウンロードして使用するプログラムです。マスタデータとなるプログラムがサーバにあれば，サーバからのダウンロードで常に最新のAppletを利用できます。ダウンロードするクライアントごとにプログラムをメンテナンスする必要がありません。

クライアントアプリケーション

クライアントマシンに常駐するプログラムです。WWWブラウザを使用しないで動作させます。

サーバアプリケーション

サーバマシンに常駐するプログラムです。サーバアプリケーション，DABroker，JDBCドライバを同一マシンに組み込んで使用するため，通信処理のオーバヘッドがなく，クライアントアプリケーションでの動作に比べて処理性能が向上します。

(b)　JDBCドライバの提供

DABroker for Javaでは，JDBCドライバを提供します。JDBCドライバは，JDBCインタフェースに従って開発したアプリケーションからの要求を処理し，データベースへのアクセスを実現します。

(c)　すぐに使用できるAppletを提供

データの検索をGUIから実行するAppletを提供します。提供Appletは，「DBアクセスアプレット」と呼びます。DBアクセスアプレットは，SQL文を直接入力するGUIを持っているため，SQL文を入力するとデータの更新なども実行できます。DBアクセスアプレットを使用すると，アプリケーションを開発することなく，Javaからデータベースにアクセスできます。

(d)　データベースアクセスを同期処理で実行

DABroker for Javaで開発するアプリケーションは，データベースアクセスを同期処理で実行します。同期アクセス処理でデータベースアクセスを実行すると，データベースでの処理結果がアプリケーションに通知されるまで，アプリケーションでは，次の処理を実行できません。同期アクセス処理については，「2.2　データベースアクセス」を参照してください。

(2)　DABroker for Javaの使用形態

DABroker for Javaは，次の環境で動作するアプリケーションを開発できます。

WWW環境

クライアント／サーバ環境

次に，DABroker for Javaのそれぞれの環境でのシステム構築例を示します。

(a)　WWW環境で使用する−Appletを使用する

Java Appletを作成し，WWWサーバからJava Appletをダウンロードして使用します。図1-5に，システム構成例を示します。

図1‒5　Appletを開発した場合のシステム構成例

(b)　クライアント環境で使用する−クライアントアプリケーションを使用する

クライアント／サーバ環境で使用するアプリケーションです。クライアントマシンに，開発したアプリケーション，及びDABroker for Javaで提供するJDBCドライバを組み込んで使用します。

図1-6に，システム構成例を示します。

図1‒6　Javaでクライアントアプリケーションを開発した場合のシステム構成例

(c)　サーバ環境で使用する−サーバアプリケーションを使用する

クライアント／サーバ環境で使用するアプリケーションです。サーバマシンに，開発したアプリケーション及びDABroker for Javaで提供するJDBCドライバを組み込んで使用します。図1-7に，システム構成例を示します。

図1‒7　Javaでサーバアプリケーションを開発した場合のシステム構成例

(d)　分散トランザクション環境で使用する−サーバアプリケーションを使用する

分散トランザクション環境で使用するアプリケーションです。分散トランザクション機能は，Java TM，Extension及びトランザクション連携機能に関連するクラスのインタフェース定義を組み込んで使用します。また，使用する前提として，データベースとの接続情報をJNDIに登録しておきます。

Java Applicationの動作時には，JNDIに登録してあるデータベースとの接続情報を取り込みます。その情報を元にトランザクションマネージャと連携し，Java ApplicationとDABrokerを接続します。図1-8に，システム構成例を示します。

図1‒8　Javaで分散トランザクション機能を利用したサーバアプリケーションを開発した場合のシステム構成例

1.3.2　DABroker for ODBCで開発するアプリケーション

DABrker for ODBCは，DABrokerに対応するODBCドライバを提供します。

ODBCドライバはデータベースアクセスのためのAPIです。ODBCドライバを使うと，アプリケーションから各種のDBMSに統一したインタフェースでアクセスできます。

DABroker for ODBCを使うと，ODBCインタフェースを利用したサーバアプリケーションを作成できます。また，既存のODBC対応のアプリケーションも，DABroker for ODBCを使ってデータベースにアクセスできます。

注意事項

DABroker(64)ではDABroker for ODBCのローカル接続は使用できません。

(1)　DABroker for ODBCの特長

DABroker for ODBCの特長を次に示します。

ODBC 3.0対応

DABroker for ODBCはODBC 3.0に対応しています。DABroker for ODBCを使えば，ODBC 3.0で新しく追加された機能を含んだアプリケーションが作成できます。

マルチスレッド対応

DABroker for ODBCはサーバ上で動作することを前提としているため，マルチスレッドに対応しています。これによって，複数処理でのスループットの向上を実現しました。

(2)　DABroker for ODBCの使用形態

DABroker for ODBCは，次の環境で動作するアプリケーションを開発できます。

WWW環境

クライアント／サーバ環境

ODBCインタフェースを利用して開発したサーバアプリケーションは，DABroker for ODBCと同じマシンに組み込んで使用します。DABroker for ODBCとDABrokerは，異なるマシンに組み込まれていても構いません。

次に，DABroker for ODBCのそれぞれの環境でのシステム構築例を示します。

(a)　WWW環境で使用する−ASPファイルを使用する

DABroker for ODBCを組み込んだWWWサーバ上に，ODBCインタフェースを使用したASPファイルを作成し，WWWブラウザから使用します。ASPファイルとは，Microsoft Internet Information Serverの機能であるActive Server Pagesで使用するファイルです。

図1-9にシステム構成例を示します。

図1‒9　ODBCインタフェースでASPファイルを作成した場合のシステム構成例

(b)　クライアント／サーバ環境で使用する−サーバアプリケーションを使用する

クライアント／サーバ環境で使用するアプリケーションです。サーバマシンに，開発したアプリケーションとDABroker for ODBCを組み込んで使用します。図1-10にシステム構成例を示します。

図1‒10　ODBCインタフェースでサーバアプリケーションを開発した場合のシステム構成例

1.4　DBPARTNER，HITSENSER5などからのアクセス

DABroker関連製品で提供するAPIを使ってアプリケーションを開発しなくても，GUIを提供するDBPARTNER，又はHITSENSER5からデータベースにアクセスできます。

DBPARTNERには，次の製品があります。

DBPARTNER/Client

クライアント／サーバ環境の形態で使用できます。

DBPARTNER/Web

WWW環境の形態で使用できます。

HITSENSER5には，次の製品があります。

HITSENSER5 Professional

クライアント／サーバ環境の形態で使用できます。

HITSENSER5 Standard

クライアント／サーバ環境の形態で使用できます。

HITSENSER5 for Cosmicube

クライアント／サーバ環境の形態で使用できます。

HITSENSER5 for RDB

クライアント／サーバ環境の形態で使用できます。

HITSENSER5 Web

WWW環境の形態で使用できます。

このほか，次の製品を使用してデータベースにアクセスできます。これらの方法ではデータベースを操作するアプリケーションプログラムを作成します。

DBPARTNER Library

クライアント／サーバ環境の形態で使用できます。

XDM/RD E2の外部表

クライアント／サーバ環境の形態で使用できます。

HITSENSER5からアクセスできるデータベースについては，HITSENSER5のマニュアルを参照してください。

XDM/RD E2の外部表からアクセスできるデータベースについては，XDM/RD E2のマニュアルを参照してください。

1.4.1　DBPARTNER/Clientを利用する場合

データベースアクセスをDBPARTNER/Clientで提供するGUIから要求できます。DBPARTNER/Clientは，各種データベースに直接アクセスしてデータ処理を要求します。実行できるデータベースの操作は，次のとおりです。

データの検索（抽出）

データの更新（追加，変更，削除）

表定義

DBPARTNER/Clientを使用すると，DBPARTNER/Clientのマシン上にある表計算ソフトと連携し，各種アプリケーションと連動できるため，データベースで検索したデータの加工・編集ができます。

DBPARTNER/Clientからのデータベースアクセスは，同期アクセス処理を使用して実行できます。データベースアクセスの方法については，「2.2　データベースアクセス」を参照してください。

図1-11にシステム構成例を示します。

図1‒11　DBPARTNER/Clientを使用する場合のシステム構成例

1.4.2　DBPARTNER/Webを利用する場合

DBPARTNER/Webは，WWWサーバに組み込んで使用します。DBPARTNER/Webを利用する場合は，DBPARTNER/Webが提供するHTMLインタフェースを表示したWWWブラウザからデータベースアクセスを要求します。実行できるデータベースの操作処理を次に示します。

データの検索（抽出）

データの更新（追加，変更，削除）

DBPARTNER/Webからのデータベースアクセスは，同期アクセス処理で実行できます。データベースアクセスの方法については，「2.2　データベースアクセス」を参照してください。

図1-12にシステム構成例を示します。

図1‒12　DBPARTNER/Webを利用する場合のシステム構成例

1.4.3　HITSENSER5を利用する場合

データベースアクセスを，HITSENSER5で提供するGUIから要求できます。HITSENSER5を使うと，多数の条件を組み合わせてデータベース中のデータを絞り込み，結果を表やグラフに表示できます。

HITSENSER5では，次の場合にデータベースを参照します。

分析データベースを作成する場合

分析対象データを作成する場合

分析データを取得する場合

管理情報をリレーショナルデータベースに登録する場合

HITSENSER5からのデータベースアクセスは，同期アクセス処理になります。同期アクセス処理については，「2.2.1　同期アクセス処理」を参照してください。

図1-13にシステム構成例を示します。

図1‒13　HITSENSER5を利用する場合のシステム構成例

1.4.4　HITSENSER5 Webを利用する場合

HITSENSER5 Webは，WWWサーバに組み込んで使用します。HITSENSER5 Webを使うと，HITSENSER5 Webが提供するHTMLインタフェースを表示したWWWブラウザからHITSENSER5の機能を利用できます。データベース中のデータの参照なども，WWWブラウザから要求します。

HITSENSER5 Webからのデータベースアクセスは，同期アクセス処理になります。同期アクセス処理については，「2.2.1　同期アクセス処理」を参照してください。

図1-14にシステム構成例を示します。

図1‒14　HITSENSER5 Webを利用する場合のシステム構成例

1.4.5　DBPARTNER Libraryを利用する場合

データベースアクセスを，DBPARTNER Libraryが提供するAPIを使用して作成したアプリケーションプログラムから要求できます。

DBPARTNER Libraryを使うと，VOSKシステムからDABrokerを経由して，ワークステーションやパーソナルコンピュータ上のデータベースの検索，加工，及び編集ができます。

実行できるデータベース操作は，次のとおりです。

データの検索

データの更新（追加・変更・削除）

図1-15にシステム構成例を示します。

図1‒15　DBPARTNER Libraryを利用する場合のシステム構成例

1.4.6　XDM/RD E2の外部表を利用する場合

データベースアクセスを，XDM/RD E2の外部表を操作するように作成したアプリケーションプログラムから要求できます。

XDM/RD E2の外部表を使うと，VOS3上のXDM/RD E2の外部表からDABrokerを経由して，ワークステーションやパーソナルコンピュータ上のデータベースの検索，加工，及び編集ができます。

実行できるデータベース操作は，次のとおりです。

データの検索

図1-16にシステム構成例を示します。

図1‒16　XDM/RD E2の外部表を利用する場合のシステム構成例

2　DABrokerの機能（共通）

この章では，DABrokerの機能について説明します。

UNIXを使用する環境とWindowsを使用する環境で共通の内容です。

2.1　マルチスレッドの実行

DABrokerは，データベースアクセスをマルチスレッドで実行します。マルチスレッドで実行すると，シングルスレッドで実行する場合に比べてシステムリソースの消費を軽減でき，同時アクセス数（同時に実行できる処理数）の増加を実現します。

図2-1に示すように，シングルスレッドでは，プロセスごとにメモリ領域を確保しますが，マルチスレッドでは，一つのプロセスで使用するメモリ領域で複数スレッドのメモリ領域を確保できます。したがって，システムリソースの消費を軽減できます。

図2‒1　マルチスレッドとシングルスレッドでのシステムリソース消費量の比較

また，マルチスレッドで実行すると，シングルスレッドで実行する場合に比べて，処理にかかる時間を短縮できます。図2-2で同一処理を複数回実行する場合の例を示します。シングルスレッドでは，複数の処理を一つのスレッドで実行しますが，マルチスレッドでは，処理ごとにスレッドを生成し，スレッドを並行して実行できます。したがって，処理時間を短縮できます。スレッドを並行に実行することで処理時間を短縮するため，マルチスレッドは，非同期アクセス処理に適しています。

図2‒2　マルチスレッドとシングルスレッドでの処理時間の比較

次に，DABrokerで実現するスレッドの構成について説明します。

2.1.1　アプリケーションから実行するマルチスレッド

DABrokerでは，開発したアプリケーション，DABroker関連製品，及びDABrokerで一つのプロセスを生成して実行します。プロセスで生成するスレッドの構成は，開発するアプリケーションによって異なります。DABroker関連製品が提供するAPIを使用すると，スレッドの制御方法などを意識することなく，マルチスレッドで実行するアプリケーションを開発できます。図2-3に，スレッドの生成例を示します。

図2‒3　スレッドの生成例

アプリケーションからのマルチスレッドの実行は，同時に複数処理を実行したい場合に適しています。つまり，データベースへの非同期アクセス処理に適しています。

2.1.2　DBPARTNERから実行するマルチスレッド

DABrokerは，DBPARTNERを使用する場合DABrokerにアクセスするユーザの単位にスレッドを生成します。図2-4に，DBPARTNERを使用する場合のスレッドの生成処理を示します。

図2‒4　DBPARTNERの場合のDABrokerの処理方法

1プロセスで処理するスレッド数（＝DABrokerに接続するユーザ数）は決められているので，1プロセスで処理するスレッド数を適切な値にするとDABrokerに同時に接続できるユーザ数の増加にも効率的に対応できます。

1プロセスで処理するスレッド数（1プロセス当たりの実行ユーザ数）は，DABroker動作環境定義ファイルで設定します。

DABroker動作環境定義ファイル，最大接続ユーザ数，最大処理プロセス数，1プロセス当たりの実行ユーザ数については，次の箇所を参照してください。

UNIXの場合：「3.4　DABrokerの動作環境の設定」

Windowsの場合：「4.5　DABroker環境設定項目」

設定値の見積もり方法については「5.2　DBPARTNERを使用する場合のスレッドのチューニング」を参照してください。

2.2　データベースアクセス

ここでは，DABrokerのデータベースアクセスの処理方法について説明します。

図2‒5　データベースアクセス

データベースアクセスは，次のどれかの方法で実行します。なお，アクセスを要求するインタフェースによって実行できる処理方法は異なります。

2.2.1　同期アクセス処理

SQLの実行，ストアドプロシジャの制御などを同期アクセスで実行します。

アプリケーション，DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表から要求を受けるごとに処理を実行し，アプリケーションなどに結果を返す処理を同期アクセス処理といいます。同期アクセス処理の場合，アプリケーションなどでは，結果が返ってくるまで（サーバでの処理が終了するまで）次の要求（又は別の操作）ができません。同期アクセス処理は，アプリケーション，DBPARTNER，HITSENSER5，DBPARTNER Library，及びXDM/RD外部表のどれからも要求できます。通常，DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表では同期アクセス処理になります。

2.2.2　非同期アクセス処理

SQLの実行，ストアドプロシジャの制御などを非同期アクセスで実行します。

アプリケーションからの要求を受けると，先にアプリケーションに対して要求を受け付けたことを通知し，その後処理を実行します。アプリケーションでは，処理の結果を待たずに（サーバでの処理の終了を待たずに）次の要求（又は別の操作）ができます。アプリケーションから結果の確認要求があった場合，アプリケーションに対する処理結果を通知します。この処理を非同期アクセス処理といいます。なお，非同期アクセス処理は，アプリケーションから要求された場合だけ実行します。

2.2.3　分散トランザクション処理

TPBrokerのOTS機能，又はJava JTS機能を提供するトランザクションマネージャ(Java TM)を使って，TPBrokerやJava TMにトランザクションの制御を任せることで，DABrokerのデータベースアクセス処理と，TPBrokerやJava TMと連携する他製品のリソースアクセス処理とを，一つのグローバルトランザクションとして同期制御できるようになります。

ワークフローを実現するアプリケーションを考えた場合，案件の詳細を登録するデータベースと，案件の流れを記録するメッセージキューが必要です。しかし，案件の詳細を登録するデータベースへのアクセスにはDABrokerを利用していて，メッセージキューへのアクセスにはTPBrokerと連携する他製品を利用していたとします。この場合でも，TPBrokerのOTS機能を両方のリソースアクセス処理で利用することで，二つのリソースアクセス処理を同期させることができます。

2.3　DABrokerとの接続

DABroker関連製品を使用して開発するアプリケーション，DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表と，DABrokerとの接続について説明します。

図2‒6　DABrokerとの接続

2.3.1　アプリケーションとDABrokerとの接続

アプリケーションとDABrokerとの接続（通信）処理は，APIによって異なります。

DABroker for Java

DABroker for Javaで開発したアプリケーションとDABrokerの通信は，Java標準API（java.netクラスライブラリ），Java RMI（Java Remote Method Invocation）などを使用して実現します。DABroker for JavaでAppletを開発した場合は，DABrokerとの通信トレースを取得できます。

図2-7に，DABroker for Javaを使用した場合の通信処理について示します。

図2‒7　DABroker for Javaでの通信処理

DABroker for ODBC

DABroker for ODBCで開発したアプリケーションとDABrokerの通信は，ODBCインタフェースを使用して実現します。DABroker for ODBCでLAN接続用のサーバアプリケーションを開発した場合は，DABrokerとの通信トレースを取得できます。

図2-8に，DABroker for ODBCを使用した場合の通信処理について示します。

図2‒8　DABroker for ODBCでの通信処理

2.3.2　DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表とDABrokerとの接続

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表との通信時，DABrokerはTCP/IPを使用してコネクションの確立と解放を次のように処理します。

同期アクセスの場合

クライアントからの要求に応じてコネクションを確立，解放します。コネクションの確立中にサーバはクライアントからのデータベースアクセス要求を受け付けます。解放したコネクションを再び確立するには，クライアントを再起動する，又はクライアントから再度，コネクションの確立を要求します。

3　DABrokerの環境設定と運用（UNIX）

この章では，UNIXでDABrokerを使用するための環境設定の方法，及び運用の方法について説明します。

3.1　環境設定の手順

ここでは，DABrokerを使用する環境の設定手順について説明します。なお，説明は，次のことを前提にしています。

DBMSを使用できる環境が既に構築されていること

開発アプリケーション，及びDABrokerを組み込むマシンをネットワーク上で使用できる環境が既に構築されていること

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表からのアクセスを利用する場合は，DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を組み込むマシンをネットワーク上で使用できる環境が既に構築されていること

DABrokerの環境設定の操作手順を，DABroker関連製品を使用する場合とDBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合に分けて説明します。なお，この章以降DABrokerと直接のインタフェースを持つプログラムのことをクライアント，DABrokerを組み込むマシンをサーバと呼びます。

3.1.1　DABroker関連製品を使用する場合の環境設定

DABroker関連製品を使用する場合の環境設定の手順を図3-1に示します。

図3-1では，環境設定完了後，最初にDABrokerを運用するまでの操作を示しています。

図3‒1　DABroker関連製品を使用する場合の環境設定の手順

3.1.2　DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合の環境設定

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合は，図3-2に示す手順でDABrokerの環境を設定してください。

ただし，(3)の「ネットワーク環境の設定」については，使用する環境によって設定が必要かどうかが異なります。

図3-2では，環境設定完了後，最初にDABrokerを運用するまでの操作を示しています。

図3‒2　DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合の環境設定の手順

3.2　DABrokerのインストールとセットアップ

ここでは，DABrokerのインストールとインストール後に実行するセットアップ操作について説明します。

3.2.1　DABrokerをインストールするマシン

使用するデータベースによって，DABrokerをインストールできるマシンが決まります。DABrokerをインストールするマシンについて，使用するデータベースごとに説明します。

HiRDB又はORACLEにアクセスする場合

DABrokerは，DBMSのサーバプログラム又はDBMSのクライアントプログラムがインストールされたマシンにインストールしてください。なお，「1.2　DABrokerの使用環境」では，DABrokerをDBMSのサーバプログラムがインストールされたマシンにインストールする形態を示しています。

3.2.2　DABrokerのインストール

DABrokerのインストールは，標準インストーラ機能（Hitachi PP Installer）を使用して実行します。インストール先ディレクトリは，/opt/DABrokerです。

表3-1に，DABrokerのインストール時に作成されるファイル及びディレクトリの中で，DABrokerの関連製品で開発するアプリケーションからデータベースにアクセスする場合に必要なファイルとディレクトリを示します。

表3‒1　DABrokerのインストール時に作成されるディレクトリとファイル

インストール時に作成される

ディレクトリとファイル

説　　明

/opt/DABroker

−

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

/bin

−

<実行コマンド格納ディレクトリ>

/dabsetup

　DABrokerセットアップコマンド

/dabstart

　DABrokerの起動

/dabstop

　DABrokerの終了

/dabstat

　DABrokerの動作状態の表示

/dabcltrc

　クライアントとの通信トレースの表示

/dabdbtrc

　データベースアクセストレースの表示

/dabcmstart

　コネクションマルチ機能の起動

/dabcmstop

　コネクションマルチ機能の終了

/dabcmstat

　コネクションマルチ機能の動作状態の表示

/lib

<ライブラリ格納ディレクトリ>

　ネイティブライブラリ（libdaJavaC.sl）など

/obj

<オブジェクトファイル用ディレクトリ>

/AGT

<エージェント処理用ディレクトリ>

/AGTGRP

<グループ管理用ディレクトリ>

/msg

<メッセージ用ディレクトリ>

/sample

−

<サンプル格納ディレクトリ>

/dasysconf

　DABroker動作環境定義ファイルのサンプル

/dadbenv

　接続先データベース定義ファイルのサンプル

/damconenv

　コネクションマルチ定義ファイルのサンプル

/conf

<DABroker動作環境定義ファイルなどの格納ディレクトリ>

/spool

<DABrokerスプール情報格納ディレクトリ>

/patch_dab

<修正パッチ履歴ディレクトリ>

/.dabrokerenv

<DABrokerの運用情報ファイル>

/.HTC_2340.inf

<DABrokerトラブルシュート取得情報ファイル>

3.2.3　DABrokerのセットアップ

インストール後，次の操作を実行します。

DABrokerセットアップコマンドの実行

DABrokerをインストール後，DABrokerセットアップコマンド（dabsetupコマンド）を実行し，DABrokerを運用するディレクトリ及び管理ユーザを設定します。DABrokerセットアップコマンドの実行方法については，「3.2.3(1)　セットアップコマンドの実行手順」を参照してください。「DABroker運用ディレクトリ」とは，DABrokerが提供するファイル及びディレクトリを格納し，DABrokerを実行するディレクトリのことです。

なお，DABrokerセットアップコマンド実行後にDABroker関連製品をインストールした場合は，DABroker関連製品で提供するセットアップコマンドを実行してください。 DABroker関連製品で提供するセットアップコマンドについては，DABroker関連製品の各マニュアルを参照してください。

ライブラリ格納ディレクトリの登録

HP-UXの場合：SHLIB_PATH（OSの環境変数）への登録

DABrokerで提供する，ライブラリ格納ディレクトリ「DABroker運用ディレクトリ/lib」をSHLIB_PATHに登録し，DABrokerを運用できる状態にしてください。

また，HiRDBを使用する場合はHiRDBライブラリのパス名（標準値：/opt/HiRDB_P/client/lib），ORACLEを使用する場合はORACLEクライアントライブラリ（64ビット）（libclntsh.sl）のパス名もSHLIB_PATHに登録してください。

AIXの場合：LD_LIBRARY_PATH，及びLIBPATH（OSの環境変数）への登録

DABrokerで提供する，ライブラリ格納ディレクトリ「DABroker運用ディレクトリ/lib」をLD_LIBRARY_PATH，及びLIBPATHに登録し，DABrokerを運用できる状態にしてください。

また，HiRDBを使用する場合はHiRDBライブラリのパス名（標準値：/opt/HiRDB_P/client/lib），ORACLEを使用する場合はORACLEクライアントライブラリ（64ビット）（libclntsh.a）のパス名もLD_LIBRARY_PATH，及びLIBPATHに登録してください。

Red Hat Linuxの場合：LD_LIBRARY_PATH（OSの環境変数）への登録

DABrokerで提供する，ライブラリ格納ディレクトリ「DABroker運用ディレクトリ/lib」をLD_LIBRARY_PATHに登録し，DABrokerを運用できる状態にしてください。

(1)　セットアップコマンドの実行手順

DABrokerセットアップコマンドの実行手順について次に示します。

DABrokerを管理するユーザ（UNIXログインユーザ）をOSに登録する。ユーザID登録後，パスワードも登録する。

登録方法は，使用するOSのマニュアルを参照してください。

ここで登録したユーザでログインするユーザは，「DABrokerの管理ユーザ」と呼びます。DABroker管理ユーザに与えられる権限は次のとおりです。

DABrokerで提供するファイル及びディレクトリの所有者としてのアクセス権

DABrokerの運用コマンドの実行権

＜注意＞

ORACLEにアクセスする場合は，ユーザIDを「3」以上にしてください。

DABrokerインストール先ディレクトリのグループ／ユーザを，DABrokerの管理グループ／ユーザに変更する。

DABrokerインストール先ディレクトリのアクセス権を確認し，DABrokerの管理グループ／ユーザに変更しておいてください。

DABrokerセットアップコマンド（dabsetup）を実行する。

dabsetupコマンドによって，DABroker運用ディレクトリがセットアップされます。

セットアップ後，DABroker運用ディレクトリ，およびDABroker運用ディレクトリにあるディレクトリやファイルの所有者は，DABrokerの管理グループ／ユーザになります。

また，dabsetupコマンドの引数にパスを指定することで，DABroker運用ディレクトリを任意の場所に変更することもできます。

dabsetupコマンドの実行方法については，「3.2.3(1)(a)　DABrokerセットアップコマンド」を参照してください。

なお，DABrokerインストール直後のDABroker運用ディレクトリは，インストール先ディレクトリ（/opt/DABroker）に設定されています。

(a)　DABrokerセットアップコマンド

次に，dabsetupコマンドの使用方法を示します。

形　式

# dabsetup [-d | パス名]

機能

dabsetupコマンドは，DABrokerの運用ディレクトリを指定するコマンドです。

dabsetupコマンドは，インストール先ディレクトリにインストールされたディレクトリ及びファイルを，指定された運用ディレクトリに移動します。

また，dabsetupコマンドは，運用ディレクトリの削除も実行します。

使用できるユーザ

OSのスーパーユーザ

指定値

パス名

DABroker運用ディレクトリを変更する場合に指定します。

dabsetupコマンドは，ここで指定された場所にDABroker運用ディレクトリを作成します。パス名はフルパスで指定してください。

また，パス名に次の場所を指定することはできません。

リモートファイルシステム上のディレクトリ

リモートファイルシステム

ローカルファイルとリンクしたディレクトリ

なお，パス名の指定を省略した場合，既に設定されているDABroker運用ディレクトリに再作成します。

-d

DABroker運用ディレクトリを削除する場合に指定します。再度DABrokerを使用する場合は，DABrokerを再インストールしてください。

注意事項

dabsetupコマンドを使用して，DABroker運用ディレクトリをインストール先ディレクトリ（/opt/DABroker）以外の場所に変更すると，パス名に指定された場所に「DABroker」ディレクトリを作成し，DABrokerの実行に必要なディレクトリやファイルをインストール先ディレクトリ（/opt/DABroker）からコピーします。dabsetupコマンド実行後，インストール先ディレクトリ（/opt/DABroker）には，DABrokerの実行に必要なディレクトリやファイルが残ったままになります。

dabsetupコマンドは，DABrokerが停止中に実行してください。

dabsetupコマンドでDABrokerを再度セットアップする場合，運用ディレクトリでのDABrokerの動作状態を初期状態にします。ただし，ユーザが作成したDABroker動作環境定義ファイル，ログファイル及びトレースファイルなどはセットアップしません。

コマンド実行時の注意事項

運用ディレクトリとして指定するパスが，ファイルとして存在する場合は，dabsetupコマンドの実行を中止します。

運用ディレクトリとして指定するパスに，DABrokerが提供するディレクトリと同一名称のファイル，又はDABrokerが提供するファイルと同一名称のディレクトリが存在する場合は，dabsetupコマンドの実行を中止します。

運用ディレクトリとして指定したディレクトリが既に存在する場合は，上書きするかどうかをコマンド実行者に確認します。なお，上書きを指定した場合，指定したディレクトリに存在する，DABrokerがセットアップしないファイル（DABroker動作環境定義ファイルなど）は保証されます。

コマンドの実行が失敗した場合の注意事項

dabsetupコマンドの実行が失敗した場合は，DABrokerは，dabsetupコマンドの実行を終了し，dabsetupコマンドを実行する前の状態に戻します。dabsetupコマンドの実行が完了する前に，DABroker関連製品のセットアップコマンドを実行しないでください。

DABroker関連製品のセットアップコマンドの実行が失敗した場合は， DABrokerは，dabsetupコマンドを実行する前の状態に戻します。したがって，DABrokerのセットアップ（dabsetupコマンドの実行）からやり直してください。

DABroker関連製品をセットアップする場合の注意事項

dabsetupコマンド実行後にDABroker関連製品をインストールした場合は，DABroker関連製品で提供するセットアップコマンドを実行してください。

なお，dabsetupコマンド実行前に，DABroker関連製品をインストールした場合は，dabsetupコマンドでDABroker関連製品のセットアップも実行しますので，DABroker関連製品で提供するセットアップコマンドを実行する必要はありません。

DABroker運用ディレクトリを削除する場合の注意事項

dabsetupコマンドでの運用ディレクトリの削除に失敗した場合は，残ったディレクトリ及びファイルをOSのrmコマンドで削除してください。

dabsetupコマンドでの運用ディレクトリの削除に成功した場合も，インストール先ディレクトリにdabsetupコマンドなどのシステムで必要なファイルが残ります。インストール先ディレクトリに残ったファイルは，インストーラで削除してください（アンインストールしてください）。

ユーザが作成したDABroker動作環境定義ファイルは，dabsetupコマンドの実行で削除されません。必要に応じて削除してください。

3.3　ネットワーク環境の設定

ここでは，DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合に，/etc/servicesファイルに設定するDABrokerのサービス名及びポート番号について説明します。

また，Database Connection Serverとの接続にサービス名を使用する場合の，/etc/servicesファイルでの設定方法について説明します。

3.3.1　DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合，/etc/servicesファイルに，TCP/IP環境でのDABrokerのサービス名及びポート番号として，次の記述をファイルの行末に追加してください。

DABROKER_SV　XXXXX/tcp

DABROKER_SV：DABrokerのサービス名です。

XXXXX：ポート番号です。

tcp：プロトコル名です。TCP/IPを使用することを表します。

注意事項

XXXXXにはDABrokerがオープンするポート番号を指定します。推奨値は40179です。オペレーティングシステムによっては推奨値がエフェメラルポートの範囲に当たるので，その場合は別のポート番号を指定してください。このポート番号とクライアント側のポート番号には同じ値を指定します

NIS（Network Information Service）を使用している場合，ネットワーク環境をNISのサーバで設定してください。NISのサーバを使用している場合，ネットワーク環境の設定は，NISのサーバでの設定が有効になります。

クライアント側では，使用する通信ドライバに，DABrokerの組み込まれたサーバのホスト名，IPアドレス及びポート番号を登録してください。

3.3.2　Database Connection Serverを経由してメインフレーム系データベースにアクセスする場合

Database Connection Serverとの接続には，DABrokerでは，Database Connection Serverのポート番号又はサービス名を指定します。ポート番号又はサービス名は，コネクションマルチ定義ファイル（「3.9　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」参照），又はDABroker動作環境定義ファイルのDAB_DBS_PORT（「3.5.1　共通項目」参照）で指定します。このとき，サービス名を指定する場合は，/etc/servicesファイルに，サービス名とそれに対応するポート番号を設定してください。Database Connection Serverとの接続にポート番号を使用する場合は，ここでの設定は不要です。

例えば，ポート番号（接続するDatabase Connection Serverのサーバ空間のポート番号(サーバスケジュール番号)）が40179に対して，サービス名：DBCSVを設定する場合は，次の記述をファイルの行末に追加します。

DBCSV　40179/tcp

注意事項

サービス名には，任意の名称が設定できます。

ここで設定したサービス名を，コネクションマルチ定義ファイル（「3.9　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」参照），及びDABroker動作環境定義ファイルのDAB_DBS_PORT（「3.5.1　共通項目」参照）で指定してください。

ポート番号は，Database Connection Serverのサーバ空間のポート番号(サーバスケジュール番号)にしてください。

3.4　DABrokerの動作環境の設定

DABrokerの動作環境を，システム構成に合わせて設定する必要があります。

DABrokerが動作するために必要な項目（環境変数）とその値を，DABroker動作環境定義ファイルに記述します。設定する項目については，「3.5　DABrokerの動作環境の設定項目」を参照ください。

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合，DABrokerの起動時にこのファイルの内容が有効になります。

なお，DABroker動作環境定義ファイルに記述する項目を，シェルの環境変数として設定することもできます。シェルの環境変数として設定した場合は，DABroker動作環境定義ファイルで設定した値よりもシェルで設定した値を有効とします。

3.4.1　DABroker動作環境定義ファイルの作成

DABrokerでは，DABroker動作環境定義ファイルに，DABrokerの動作に関する情報を定義します。DABroker動作環境定義ファイルは，インストール時に提供されるサンプルを使用して作成します。

表3-2に，使用するファイルとファイルの格納先を示します。

表3‒2　DABroker動作環境定義ファイルのファイル名

使用するサンプルファイル

DABroker動作環境定義ファイル格納先

/opt/DABroker/sample/dasysconf

DABroker運用ディレクトリ/conf

DABroker動作環境定義ファイルの作成手順を次に示します。

サンプルファイルを，表3-2に示したDABroker動作環境定義ファイルの格納先へコピーする。

コピー先ファイルの設定項目の標準値を必要に応じて変更する。また，値が設定されていない項目には値を入力する。

ファイルを保存する。

(1)　ファイルの構成内容

提供するサンプルファイルにあるように，DABroker動作環境定義ファイルは，「DAB」ブロックと「OTHERS」ブロックで構成されます。

「DAB」ブロック

DABrokerの動作環境の設定項目を指定します。

DABrokerでは，設定項目のチェックを実行し，不正な名称などを指定した場合はエラーになります。

なお，ここで指定する項目については，「3.5.1　共通項目」を参照してください。

「OTHERS」ブロック

DBMSなどの設定項目を指定します。

DABrokerでは，設定項目のチェックを実行しません。このセクションに指定されたすべての項目を有効とします。

なお，ここで指定する項目については，「3.5.3　HiRDBの設定」及び「3.5.4　ORACLEの設定」を参照してください。

(2)　ファイル作成時の注意事項

値を変更しない設定項目は削除しないでください。

設定項目のexportは不要です。

「＝」の前後に空白文字，又はタブコードを入れないでください。入れた場合はエラーとなります。

（エラーの例）DABTMP = /tmp/dab

設定値に半角空白文字を使用する場合は，「‘（シングル引用符）」で設定値を囲んで指定してください。

（指定例）DABTMP='/tmp/da b'

設定値の後ろに半角空白文字，タブコード，「＃」以外の文字を記載した場合は，エラーとなります。

（エラーの例）DABTMP = /tmp/dab;

「＃」以降は，コメントとして扱います。

設定値には，値だけを指定します。「$設定項目」で指定する値を引き継ぐことはできません。

(3)　作成したファイルの変更

作成したDABroker動作環境定義ファイルの内容の変更は，DABrokerが起動していない時に行ってください。

3.5　DABrokerの動作環境の設定項目

DABrokerの動作環境を設定する項目には，次の種類があります。

共通項目

DABroker関連製品で開発したアプリケーション，又はリモートアクセスのどの方法でデータベースにアクセスする場合にも設定します。

DABroker for Java Version 2からDABrokerにローカルアクセスする場合は，リモートアクセス設定項目で設定する次の項目についても有効になります。

DABORADBA_LONGBUFSIZE

DABHIRDBA_BLOBBUFSIZE

DABDBSDBA_BLOBBUFSIZE

これらの項目の設定方法については，「3.5.2　リモートアクセス設定項目」を参照してください。

リモートアクセス設定項目

リモートアクセス使用時に設定します。

リモートアクセスについては，「1.2　DABrokerの使用環境」を参照してください。

HiRDBの設定項目

接続するデータベースにHiRDBを使用する場合に設定します。

ORACLEの設定項目

接続するデータベースにORACLEを使用する場合に設定します。

Database Connection Server接続設定項目

Database Connection Serverを経由して，ホストのデータベースを使用する場合に設定します。

3.5.1　共通項目

DABrokerの動作環境での共通項目について説明します。

標準値はDABroker動作環境定義ファイルのサンプルファイルにあらかじめ設定されている値です。

共通項目の一覧を，表3-3に示します。

表3‒3　共通項目の一覧

設定項目

説明

標準値

指定範囲

DAB_LANG

LANG環境変数

HP-UXの場合

ja_JP.SJIS

AIXまたはRed Hat Linuxの場合

C

詳細は「3.5.1(1)　DAB_LANG（LANG環境変数）」参照。

DABTMP

作業ディレクトリ指定

/tmp

任意ディレクトリ

※1

DABSQL_TRCSIZE※2

データベースアクセストレースの取得

-1

0又は-1

DABSELECTCOLCNT

表検索カラム数

0

0,1〜2147483647

DABSELECTINFCNT

更新・検索項目数

0

0,1〜2147483647

DABORACLE_TYPE

使用するORACLEのバージョン

101

詳細は「3.5.1(6)　DABORACLE_TYPE（使用するORACLEのバージョン）」参照。

DABSQL_HiRDB_

DICTIONARY_

DATATYPE

HiRDBでのディクショナリ表のデータ属性

C

M又はC

DABSVLOGSIZE

DABrokerのログ取得ファイルサイズ

64

(キロバイト)

0,

64〜32767

(キロバイト)

DABXA_LOG_ERROR

XAトレースを取得する

ON

ON又はOFF

DABEXSQL_TRC_LINE

拡張データベースアクセストレースを取得する

-1

-1，0，又は1024〜32767(行)

DAB_HIRDB_DBINF_ESC

HiRDB環境変数区切り文字

@

@　!　$　%　&　*　+　-　/　:　?　¥　|

注※1

DABrokerの管理ユーザにREAD／WRITE権限がある任意のディレクトリです。ただし，パーティションを圧迫しないところです。

注※2

DABroker稼働時でも，シェルの環境変数で設定された値が有効になります。

(1)　DAB_LANG（LANG環境変数）

標準値

HP-UXの場合

ja_JP.SJIS

AIXの場合

C

Red Hat Linuxの場合

C

指定範囲

HP-UXの場合

ja_JP.SJIS：SJISモード

ja_JP.EUC，ja_JP.UJIS，又はja_JP.eucJP：EUCモード

C：ASCIIモード

UTF-8：UTF-8モード

AIXの場合

Ja_JP，Ja_JP.IBM-932，又はJa_JP.IBM-943：SJISモード

ja_JP，又はja_JP.IBM-eucJP：EUCモード

C：ASCIIモード

UTF-8：UTF-8モード

Red Hat Linuxの場合

ja_JP，ja_JP.ujis，japanese，japanese.euc，ja_JP.eucjp，又はJa_JP：EUCモード

C：ASCIIモード

UTF-8：UTF-8モード

説明

使用する母国語（日本語，英語など）及び文字コード（SJISコードなど）を設定します。

表3‒4　各言語モードで操作できるデータベース

データベース

DABrokerでの設定

SJISモード

日本語EUC

モード

ASCIIモード

UTF-8モード

HiRDB

○

○

○

○

ORACLE

○

○

○

○

VOS3 XDM/RD

○

×

○

×

VOS3 XDM/SD

○

×

○

×

VOSK SQL/K

○

×

○

×

VOS1 RDB1 E2

○

×

○

×

VOS1 PDM II E2

○

×

○

×

VOSK スプールファイル

○

×

○

×

凡例

○：操作できる

×：操作できない

各データベースで使用する言語モードは，必ずDABrokerの言語モードと合わせてください。データベースとDABrokerの言語モードが異なっている場合は動作を保証しません。

クライアントがDABroker for Javaの場合は，DAB_LANGの指定がJDBCの文字エンコーディングに影響します。詳細については，マニュアル「DABroker for JavaTM Version 2　DABroker Driver for JavaTM Technology」の「接続するデータベースの指定」のENCODELANGの説明を参照してください。

DABrokerを日本語EUCモード，ASCIIモード，又はUTF-8モードで動作させた場合，メッセージは英文で出力されます。メッセージの詳細については，「7.　メッセージ(共通)」を参照してください。

(2)　DABTMP（DABroker作業ディレクトリ）

標準値

/tmp

指定範囲

DABrokerの管理ユーザにREAD／WRITE権限がある任意のディレクトリ（ただし，パーティションを圧迫しないところ）

説明

DABrokerの作業ディレクトリを指定します。このディレクトリは，処理途中で作成される一時ファイルの格納などに使用されます。

なお，ここで/tmpを指定した場合は，OSの再起動時に，/tmpディレクトリ下に作成されたすべてのファイルは削除されます。

(3)　DABSQL_TRCSIZE（データベースアクセストレースの取得）

標準値

-1

指定範囲

0又は-1

説明

データベースアクセストレース（dabdbtrcコマンドで表示）を取得するかどうかを設定します。

0を設定した場合

すべてのアクセストレースを取得するファイルが，［DABroker運用ディレクトリ/spool/db_access］の下に作成されます。ファイル名は，次のとおりです（XXXXXはシステム任意の番号）。

db_XXXXX

ただし，ハードディスクの空き容量がなくなった場合，それ以降のアクセストレースは取得しません。なお，格納する領域のサイズは設定できません。アプリケーション，又はクライアントからの要求量が多ければ，トレースのファイル容量も多くなるため，ハードディスクの容量に余裕をもたせておいてください。必要容量の概算方法は，「6.4.2　データベースアクセストレースの表示」を参照してください。また，アプリケーション，又はクライアントからの要求量が多ければ，DABrokerを終了するまでにも時間がかかります。御注意ください。

-1を設定した場合

データベースアクセストレースを取得しません。

(4)　DABSELECTCOLCNT（表検索カラム数）

標準値

0

指定範囲

0，又は1〜2147483647

説明

表検索用の領域として確保する表カラムの個数を指定します。

0を設定した場合

DBMSに対して表カラムの個数を要求するSQLを発行します。DBMSから返された結果を基に，表検索用の領域を確保します。

1〜2147483647を設定した場合

表カラムの個数が指定した値より少ない場合，DBMSに対して表カラムの個数を要求するSQLを発行しません。このため，SQLを発行する場合より処理性能が向上します。ただし，検索を実行するたびに次に示す大きさのメモリが必要になるため，動作環境を考慮して値を設定してください。よく検索する表のカラム数を大きく超える値を設定した場合，性能劣化の原因になることがあります。

HiRDB，ORACLEの場合：1カラム当たり128バイト

上記以外のDBMSの場合：0だけしか有効となりません（項目の個数は設定できますが，無条件で0となります）。

表カラムの個数が指定した値より多い場合，DBMSに対して表カラムの個数を要求するSQLを発行します。DBMSから返された結果を基に，表検索用の領域を確保します。

(5)　DABSELECTINFCNT（更新・検索項目数）

標準値

0

指定範囲

0，又は1〜2147483647

説明

表の更新・検索用の領域として確保する，入力項目（パラメタ）の個数を指定します。

0を設定した場合

DBMSに対して入力項目の個数を要求するSQLを発行します。DBMSから返された結果を基に，表の更新・検索用の領域を確保します。

1〜2147483647を設定した場合

入力項目の個数が指定した値より少ない場合，DBMSに対して入力項目の個数を要求するSQLを発行しません。このため，SQLを発行する場合より処理性能が向上します。ただし，更新・検索を実行するたびに次に示す大きさのメモリが必要になるため，動作環境を考慮して値を設定してください。よく更新・検索する表の入力項目の個数を大きく超える値を設定した場合，性能劣化の原因になることがあります。

HiRDB，ORACLEの場合：1カラム当たり128バイト

上記以外のDBMSの場合：0だけしか有効となりません（項目の個数は設定できますが，無条件で0となります）。

入力項目の個数が指定した値より多い場合，DBMSに対して入力項目の個数を要求するSQLを発行します。DBMSから返された結果を基に，表の更新・検索用の領域を確保します。

(6)　DABORACLE_TYPE（使用するORACLEのバージョン）

標準値

101

指定範囲

101，111，121又は190

説明

使用するORACLEのバージョンを設定します。

101：Oracle10g R10.1.0またはOracle10g R10.2.0

111：Oracle11g R11.1.0またはOracle11g R11.2.0

121：Oracle12c R12.1.0またはOracle12c R12.2.0

190：Oracle19c R19.0.0以降

(7)　DABSQL_HiRDB_DICTIONARY_DATATYPE（HiRDBでのディクショナリ表のデータ属性）

標準値

C

指定範囲

M又はC

説明

HiRDBのディクショナリ表の列属性を指定します。

Mを設定した場合

混在文字データ（MVARCHAR）として処理します。

Cを設定した場合

文字データ（VARCHAR）として処理します。

注意事項

ここでの指定とHiRDBで使用されているディクショナリ表のデータ属性が異なる場合は，結果不正やSQLエラーになる場合があります。

(8)　DABSVLOGSIZE（DABrokerのログ取得ファイルサイズ）

標準値

64（キロバイト）

指定範囲

0，又は64〜32767（キロバイト）

説明

DABrokerの処理のログを取得するファイルの容量を設定します。ログを［DABroker運用ディレクトリ/spool/dabsv.log］，および［DABroker運用ディレクトリ/spool/dabsvdemon.log］に取得します。

0を設定した場合

ファイルの容量は，無限大となります。

64〜32767を設定した場合

ファイルの容量は，設定した数値分となります。

注意事項

ログファイルが満杯になったらラップアラウンドでログを取得します。ラップアラウンドで取得した場合は，１世代前のバックアップファイル（dabsv.logold，dabsvdemon.logold）を作成し，常に１世代だけを管理します。

(9)　DABXA_LOG_ERROR（XAトレースを取得する）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

XAインタフェースでエラーを検知した場合，エラートレースを取得するかどうかを設定します。

XAトレースは，DABroker運用ディレクトリ下のspoolディレクトリにdb_xainfo.logというファイル名で取得されます。XAトレースファイル(db_xainfo.log)はテキスト形式なので，任意のテキストエディタで参照してください。

XAトレースファイルは，運用期間に応じてファイルサイズが増加するため，定期的に削除する必要があります。

(10)　DABEXSQL_TRC_LINE（拡張データベースアクセストレースを取得する）

標準値

-1（トレースを取得しません）

指定範囲

-1（トレースを取得しません），0（トレース取得行数を無限大にします），又は1024〜32767（行）

説明

拡張データベースアクセストレースを取得するかどうかを設定します。

-1を設定した場合

拡張データベースアクセストレースを取得しません。

0を設定した場合

拡張データベースアクセストレースを取得します。出力行数は，無限大となります。

1024〜32767を設定した場合

拡張データベースアクセストレースを取得します。出力行数は，設定した数値分となります。

拡張データベースアクセストレースのファイルは，1行に134バイトまで出力されます。拡張データベースアクセストレースのファイルの出力行数は，ここでの設定値に従います。ただし，ヘッダは行数に含まれません。

拡張データベースアクセストレースの詳細については，「6.4.3　拡張データベースアクセストレース機能」を参照してください。

(11)　DAB_HIRDB_DBINF_ESC（HiRDB環境変数区切り文字）

標準値

@

指定範囲

@　!　$　%　&　*　+　-　/　:　?　¥　|

説明

HiRDB環境変数区切り文字を指定します。

注意事項

特に問題がない場合，区切り文字には@を使用してください。

区切り文字は必ず半角1文字で指定してください。全角文字は指定できません。

DABroker for JavaからHiRDBクライアント環境変数グループを指定してデータベースと接続する場合は，標準値「@」を指定してください。

3.5.2　リモートアクセス設定項目

DABrokerの動作環境でのリモートアクセス設定項目について説明します。

標準値はDABroker動作環境定義ファイルのサンプルファイルにあらかじめ設定されている値です。

リモートアクセス設定項目の一覧を表3-5に示します。

表3‒5　リモートアクセス設定項目の一覧

設定項目

説明

標準値

指定範囲

DABCLIENT_TIMEOUT

クライアントからの要求待ちタイムアウト

3600(秒)

0，又は1〜65535

(秒)

DABDBA_TIMEOUT

データベースからの実行終了待ちタイムアウト

1800(秒)

0，又は1〜65535

(秒)

DABKEEPALIVE

TCP/IP通信時キープアライブ

OFF

ON又はOFF

DABTCP_TRCSIZE

通信トレースの取得

-1

0又は-1

DABMAXUSERS

最大接続ユーザ数

10

(ユーザ)

1〜100000

(ユーザ)

DABDBANUMBER

同時実行可能なデータベースアクセス数

20

(データベースアクセス数)

1〜100000

(データベースアクセス数)

DABMAXBLOCK

USERS

1プロセスあたりの実行ユーザ数

1

(ユーザ数)

1〜100

(ユーザ数)

DABMAXPROCESS

最大処理プロセス数

10

(プロセス数)

1〜1000

(プロセス数)

DABORADBA_

LONGBUFSIZE

ORACLEのLONG型及びLONGRAW型のデータの受け取りバッファサイズ

4096

(バイト)

0，1〜2147483647

(バイト)

DABHIRDBA_

BLOBBUFSIZE

HiRDBのBLOB型データ受取バッファサイズ

4096

(バイト)

0，1〜2147483647

(バイト)

DABDBSDBA_

BLOBBUFSIZE

Database Connection ServerのBLOB型データ受取バッファサイズ

4096

(バイト)

0，1〜2147483647

(バイト)

DABIPCONVERT

IPアドレスからホスト名への変換オプション

ON

ON又はOFF

注※

DABrokerの管理ユーザにREAD／WRITE権限がある任意のディレクトリです。ただし，パーティションを圧迫しないところです。

(1)　DABCLIENT_TIMEOUT（クライアントからの要求待ちタイムアウト）

標準値

3600（秒）

指定範囲

0，又は1〜65535（秒）

説明

1〜65535（秒）を設定した場合

DABrokerがアクセス要求に対する応答をクライアントに返してから，次のアクセス要求を受けるまでの時間を監視します。

ここで設定した時間を超えてクライアントからのアクセス要求がない場合，DABrokerは次の処理をします。

クライアントに対しては，クライアントからの要求待ちタイムアウトの発生を通知して，コネクションを解放します。処理を続ける場合，クライアントは一度終了して再起動する必要があります。

0を設定した場合

クライアントからの要求待ち時間を監視しません。

(2)　DABDBA_TIMEOUT（データベースからの実行終了待ちタイムアウト）

標準値

1800（秒）

指定範囲

0，又は1〜65535（秒）

説明

1〜65535（秒）を設定した場合

DABrokerがデータベースに処理を要求してから，実行が終了するまでの時間を監視します。

ここで設定した時間を超えてデータベースからの応答がない場合，DABrokerは次の処理をします。

クライアントに対しては，データベースからの実行終了待ちタイムアウトの発生を通知して，コネクションを解放します。処理を続ける場合，クライアントは一度終了して再起動する必要があります。

0を設定した場合

データベースからの実行終了待ち時間を監視しません。

この項目は，Database Connection Server使用時だけ有効です。

分散トランザクション連携機能使用時は，ここでの指定内容にかかわらず，0が設定されます。

(3)　DABKEEPALIVE（TCP/IP通信時キープアライブ）

標準値

OFF

指定範囲

ON又はOFF

説明

キープアライブによる監視を行うかどうかを設定します。キープアライブとは，クライアントとの通信経路が確立されているかどうかを常に監視するTCP/IPの機能です。

ONを設定した場合

キープアライブによる監視が行われます（クライアントとの通信径路を監視する）。

OFFを設定した場合

キープアライブによる監視は行われません（クライアントとの通信径路を監視しない）。

(4)　DABTCP_TRCSIZE（通信トレースの取得）

標準値

-1

指定範囲

0又は-1

説明

クライアントとの通信トレース（dabcltrcコマンドで表示）を取得するかどうかを設定します。コマンドについては，「3.8.2　クライアントとの通信トレースの表示」を参照してください。

0を設定した場合

すべての通信トレースを蓄積するファイルが［DABroker運用ディレクトリ　/spool/dabcltrc］の下に作成されます。ファイル名は，次のとおりです（XXXXXは接続元のクライアントのIPアドレス，AAAAAは任意の名称）。

trs2340_tcXXX.XXX.XXX.XXX（DBPARTNER/Clientを使用する場合）

trs2340_tcXXX.XXX.XXX.XXXAAAAA（DBPARTNER/Client以外の場合）

ただし，ハードディスクの空き容量がなくなった場合，それ以降の通信トレースは取得しません。また，クライアントからの要求量が多ければ，トレースファイル容量も多くなるため，ハードディスクの容量に余裕をもたせておいてください。必要容量の概算方法は，「3.8.2 クライアントとの通信トレースの表示」を参照してください。また，クライアントからの要求量が多ければ，DABrokerを終了するまでに時間がかかります。御注意ください。

-1を設定した場合

クライアントとの通信トレースを取得しません。

(5)　DABMAXUSERS（最大接続ユーザ数）

標準値

10（ユーザ）

指定範囲

1〜100000（ユーザ）

説明

コネクションを確立できる最大ユーザ数を設定します。ここで設定した値を超えるユーザが接続しようとした場合は，クライアントにエラーメッセージを返し，接続しません。

(6)　DABDBANUMBER（同時実行可能なデータベースアクセス数）

標準値

20（データベースアクセス数）

指定範囲

1〜100000（データベースアクセス数）

説明

DABrokerが一度に受け付けられる，複数のクライアントからのデータベースアクセス処理要求の合計数を設定します。ここで設定した値を超える要求が行われた場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

(7)　DABMAXBLOCKUSERS（1プロセスあたりの実行ユーザ数）

標準値

1（ユーザ数）

指定範囲

1〜100（ユーザ数）

ORACLEを使用する場合は1を指定してください。

説明

一つのプロセスで処理する最大ユーザ数を設定します。ここで設定した値を超えた場合は，処理を受け付けません。

ORACLEを使用する場合は，必ず1を指定してください。1以外を指定した場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

注意事項

DABrokerのデーモンプロセスが，サーバのメモリ又はキャッシュメモリ上で動作するように適切な値を設定してください。

(8)　DABMAXPROCESS（最大処理プロセス数）

標準値

10（プロセス数）

指定範囲

1〜1000（プロセス数）

説明

DABrokerで起動する最大プロセス数を設定します。ここで設定した値を超えた場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

注意事項

不要なデーモンプロセスの起動を制限するために適切な値を設定してください。

(9)　DABORADBA_LONGBUFSIZE（ORACLEのLONG型及びLONGRAW型のデータの受け取りバッファサイズ）

標準値

4096（バイト）

指定範囲

0，又は1〜2147483647（バイト）

説明

ORACLEから，LONG型又はLONGROW型を持つデータを抽出する場合の受け取りサイズを指定します。

これらのデータ型の場合，ORACLEでは最大2147483647バイトのデータの存在が考えられますが，DABrokerでは，ここで指定した値までのデータを受け取り，以降のデータは切り捨てます。

0を指定した場合，DBMSの定義長分の領域長を仮定します。ただし，実際に格納されているデータの大きさにかかわらず，無条件に定義長分の領域が確保されるため，メモリ効率が悪くなることがあります。格納されているデータの最大長が分かっている場合は，その値を指定することをお勧めします。

この項目は，DABroker for Java Version 2でDABrokerにローカルアクセスした場合にも有効になります。

また，DABroker for Java Version 2でデータベース種別にOracle8iを設定している場合にも設定しません。

(10)　DABHIRDBA_BLOBBUFSIZE（HiRDBのBLOB型データ受取バッファサイズ）

標準値

4096（バイト）

指定範囲

0，又は1〜2147483647（バイト）

説明

HiRDBからBLOB型データを抽出する場合の受け取りサイズを指定します。

このデータ型の場合，HiRDBでは最大2147483647バイトのデータの存在が考えられますが，DABrokerではここで指定した値までのデータを受け取り，以降のデータは切り捨てます。

0を指定した場合，DBMSの定義長分の領域長を仮定します。ただし，実際に格納されているデータの大きさにかかわらず，無条件に定義長分の領域が確保されるため，メモリ効率が悪くなることがあります。格納されているデータの最大長が分かっている場合は，その値を指定することをお勧めします。

この項目は，DABroker for Java Version 2でDABrokerにローカルアクセスした場合にも有効になります。

(11)　DABDBSDBA_BLOBBUFSIZE（Database Connection ServerのBLOB型データ受取バッファサイズ）

標準値

4096（バイト）

指定範囲

0，又は1〜2147483647（バイト）

説明

Database Connection ServerからBLOB型データを抽出する場合の受け取りサイズを指定します。

このデータ型の場合，最大2147483647バイトのデータの存在が考えられますが，DABrokerではここで指定した値までのデータを受け取り，以降のデータは切り捨てます。

0を指定した場合，DBMSの定義長分の領域長を仮定します。ただし，実際に格納されているデータの大きさにかかわらず，無条件に定義長分の領域が確保されるため，メモリ効率が悪くなることがあります。格納されているデータの最大長が分かっている場合は，その値を指定することをお勧めします。

この項目は，DABroker for Java Version 2でDABrokerにローカルアクセスした場合にも有効になります。

(12)　DABIPCONVERT（IPアドレスからホスト名への変換オプション）

標準値

ON

指定範囲

ON又はOFF

説明

メッセージ，及びDABrokerの処理内容を表示するコマンドで表示されるIPアドレスをホスト名に変換するかどうかを設定します。DABrokerの処理内容を表示するコマンドについては「3.8　DABrokerの処理内容の表示」を参照してください。

ONを設定した場合

表示されるIPアドレスをホスト名に変換します。

動作環境によってこの変換処理に時間がかかり，接続処理が遅くなることがあります。

OFFを設定した場合

表示されるIPアドレスをホスト名に変換しません。

3.5.3　HiRDBの設定

HiRDBを使用する場合の設定項目を次に示します。HiRDBのバージョンによっては，必要な設定項目が異なることがありますのでご注意ください。

PDHOSTとPDNAMEPORTの値は，HiRDBの環境で設定されている値を指定してください。そのほかの設定項目では，DABrokerで設定した値が有効になります。各設定項目については，各バージョンのマニュアル「HiRDB UAP開発ガイド」を参照してください。

PDCLTPATH

トレースファイル格納ディレクトリ

PDHOST

ホスト名

注

ここで設定した値と異なるホスト名でアプリケーションが接続を要求した場合は，アプリケーションで指定されたホスト名が有効になります。

PDNAMEPORT

HiRDBのシステムポート番号

注

ここで設定した値と異なるポート番号でアプリケーションが接続を要求した場合は，アプリケーションで指定されたポート番号が有効になります。

PDSWAITTIME

サーバ最大待ち時間

PDSQLTRACE

SQLトレースファイルのサイズ

PDUAPERLOG

エラーログファイルのサイズ

3.5.4　ORACLEの設定

ORACLEを使用する場合の設定項目を次に示します。

各設定項目には，ORACLEの環境で設定されている値を指定してください。各設定項目については，ORACLEのマニュアルを参照してください。

ORACLE_HOME

ORACLEのホームディレクトリ

ORACLE_SID

ORACLEのデータベース識別子

＜注意＞

ここで設定した値と異なるデータベース識別子でアプリケーションが接続を要求した場合は，アプリケーションで指定されたデータベース識別子が有効になります。

NLS_LANG

母国語指定

3.5.5　Database Connection Server接続設定項目

DABrokerの動作環境でのDatabase Connection Server接続設定項目について説明します。

標準値はDABroker動作環境定義ファイルのサンプルファイルにあらかじめ設定されている値です。

Database Connection Server接続設定項目の一覧を表3-6に示します。

表3‒6　Database Connection Server接続設定項目の一覧

設定項目

説明

標準値

指定範囲

DAB_DBS_HOST

接続するDatabase Connection Serverのホスト名，又はIPアドレス

localhost

ホスト名，又はIPアドレス

DAB_DBS_PORT

接続するDatabase Connection Serverのサービス名，又はポート番号

40179

サービス名，又はポート番号

DAB_DBS_SEND_BUFFER_SIZE

Database Connection Serverに送信するときの最大バッファサイズ

64

(キロバイト)

64〜2097151

(キロバイト)

DAB_DBS_RECEIVE_BUFFER_SIZE

Database Connection Serverから受信するときの最大バッファサイズ

64

(キロバイト)

64〜2097151

(キロバイト)

(1)　DAB_DBS_HOST（接続するDatabase Connection Serverのホスト名，又はIPアドレス）

標準値

localhost

指定範囲

ホスト名，又はIPアドレス

説明

Database Connection Server使用時，接続先のDatabase Connection Serverのホスト名，又はIPアドレスを指定します。

(2)　DAB_DBS_PORT（接続するDatabase Connection Serverのサービス名，又はポート番号）

標準値

40179

指定範囲

サービス名，又はポート番号

説明

Database Connection Server使用時，接続先のDatabase Connection Serverのサービス名，又はポート番号を指定します。

(3)　DAB_DBS_SEND_BUFFER_SIZE（Database Connection Serverに送信するときの最大バッファサイズ）

標準値

64（キロバイト）

指定範囲

64〜2097151（キロバイト）

説明

Database Connection Server使用時，Database Connection Serverにデータを送信する場合の最大バッファサイズを指定します。

(4)　DAB_DBS_RECEIVE_BUFFER_SIZE（Database Connection Serverに受信するときの最大バッファサイズ）

標準値

64（キロバイト）

指定範囲

64〜2097151（キロバイト）

説明

Database Connection Server使用時，Database Connection Serverからデータを受信する場合の最大バッファサイズを指定します。

3.5.6　その他の設定

(1)　DAB_DEMON_LOG_MODE（デーモンの生成・消滅・クリーンアップ実行結果ログ抑止）

標準値

なし

指定範囲

LIMITED

説明

デーモンの生成・消滅・クリーンアップ実行結果ログの出力によりディスクを圧迫したくない場合に指定します。

デーモンの生成・消滅・クリーンアップ実行結果ログは，本指定をしない限り，標準で出力されます。

デーモンの生成・消滅・クリーンアップ実行結果ログについては，「6.3.2　デーモンの生成・消滅・クリーンアップ実行結果ログ（共通）」を参照してください。

(2)　DABPTHREAD_STACK_SIZE（スレッドスタックサイズ変更機能）

標準値

システムデフォルトのスレッドスタックサイズ

指定範囲

0〜1024（キロバイト）

説明

スレッドスタックサイズを変更する場合に指定します。

指定された数値がシステムの最小値より下回っている場合には，システムの最小値まで切り上げ，指定された値が1024を超えたときは1024になります。システムの最小値はプラットフォームによって異なります。

なお，本機能はプラットフォームがHP-UXの場合のみ有効となります。

3.6　DABroker接続先データベースの定義

接続先データベース定義ファイルは，アプリケーションから接続するデータベース種別，ホスト名，ポート番号などを定義するファイルです。DABroker for ODBCで開発するアプリケーションは，接続先データベース定義ファイルに定義されたデータベース種別名，及びデータベース名を使用してデータベースにアクセスします。また，DBPARTNER，及びDABroker for Javaでも，Database Connection Server経由でデータベースにアクセスする場合は，接続先データベース定義ファイルで設定した情報を使用してDatabase Connection Serverに接続します。

アプリケーションでは，データベース種別名及びデータベース名を指定するため，アプリケーションを変更することなく，接続するデータベースの変更ができます。ただし，OTS機能，又はJava JTS機能を使用する場合は，接続先データベース定義ファイルで設定した情報を使用できません。

ここでは，接続先データベース定義ファイルの作成方法について説明します。

3.6.1　接続先データベース定義ファイルの作成

接続先データベース定義ファイルは，「3.6.1(2)　ファイルでの指定形式」で示す形式で作成します。また，インストール時に提供されるサンプルを使用して作成することもできます。サンプルファイルを使う作成方法については，「3.6.1(4)　サンプルファイルを使用した作成方法」を参照してください。

(1)　作成するファイルの名称及び格納先

次に，接続先データベース定義ファイルのファイル名及び格納先を示します。

作成するファイルの名称

dadbenv

ファイルの格納先

DABroker運用ディレクトリ/conf

(2)　ファイルでの指定形式

接続先データベース定義ファイルでは，データベースに接続するための情報を次に示すような形式で指定します。データベース種別ごとにデータベース名を指定し，データベース名には，ホスト名，ポート番号などの情報を対応させます。

なお，ファイル内で複数のデータベース種別の指定ができます。また，一つのデータベース種別に対して，複数のデータベース名を指定できます。

(3)　ファイル作成時の注意事項

ファイル内では，大文字，小文字を区別します。

「＃」以降は，コメントとして扱います。

「＝」の前後に空白文字，又はタブコードなどの不要な文字を入れないでください。入れた場合はエラーとなります。

(4)　サンプルファイルを使用した作成方法

提供するサンプルファイル（/opt/DABroker/sample/dadbenv）を使用して作成することもできます。次に，作成手順を示します。

サンプルファイルを「DABroker運用ディレクトリ/conf」にコピーする。

コピー先ファイルの設定項目の標準値を必要に応じて変更する。また，値が設定されていない項目には値を入力する。

ファイルを保存する。

3.6.2　接続先データベース定義ファイルでの設定項目

ファイルには，データベース種別定義ブロックがあり，データベース種別定義ブロックの中で，データベース名定義ブロックを指定します。

(1)　データベース種別定義ブロック

データベース種別，及びデータベース名定義ブロックを設定します。

次に，データベース種別を設定する項目について説明します。データベース名定義ブロックについては，「3.6.2(1)(a)　データベース名定義ブロック」を参照してください。

データベース種別名（指定必須）

データベース種別を指定するブロックの名称です。アプリケーションでは，データベースに接続時にこの名称を使用します。

データベース種別名には，ファイル内でユニークな名称を付けてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

DBTYPE=データベース種別（指定必須）

データベース種別を指定します。

データベース種別

次の文字列を指定してください。

使用するデータベース

指定内容

HiRDBにアクセスする場合

HIRDB

Oracleにアクセスする場合

ORACLE7

Database Connection Server経由で

メインフレーム系データベースにアクセスする場合

DBCONNECTSVR

(a)　データベース名定義ブロック

このブロックで指定する項目は，データベース種別によって異なります。

Database Connection Server経由でデータベースにアクセスする場合は，ここでデータベース種別を指定します。

次に，データベース名定義ブロックで設定できる項目について説明します。

データベース名

接続先データベースごとに指定する，データベースの接続情報（ホスト名，ポート番号など）を指定するブロックの名称です。アプリケーションでは，データベース接続時にこの名称を指定します。

データベース名には，データベース種別定義ブロック内でユニークな名称を付けてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

◆HiRDBを使用する場合

HiRDBを使用する場合，DBHOST及びDBNAMEは必ず指定してください。

DBHOST=データベースのホスト名

接続するHiRDBが存在するホスト名称を指定します。指定を省略する場合は，HiRDBの環境変数PDHOSTで指定した値になります。

HiRDBクライアント環境変数使用時，及びHiRDB環境変数グループ使用時は次のように設定してください。

HiRDBクライアント環境変数使用時

DBHOST=区切り文字+HiRDBクライアント環境変数=値+区切り文字+HiRDBクライアント環境変数＝値

HiRDBクライアント環境定義の環境変数を指定するとき区切り文字としてDABroker環境変数DAB_HIRDB_DBINF_ESCで指定した1バイトが区切り文字となります。

DAB_HIRDB_DBINF_ESCの指定がない場合は@が区切り文字となります。

@を区切り文字としたときの例を次に示します。

DBHOST=@PDHOST=host@PDNAMEPORT=20000

注意事項

HiRDBで指定できる環境変数以外を指定した場合の動作は保証しません。

環境変数の指定値はDABrokerではエラーチェックを行わないため，環境変数に誤りがある場合はHiRDBのエラーとなります。

この機能を使用する場合，従来DABrokerで設定していた，PDUSER，PDCLTAPNAME，PDHOST，PDNAMEPORTは設定されません。

指定値の中の空白　#　"　'　はサポートしていません。指定した場合の動作は保証しません。

HiRDB環境変数グループ使用時

DBHOST=区切り文字+DABENVGRP=HiRDB環境変数グループ

DABroker環境変数DAB_HIRDB_DBINF_ESC環境変数で指定した１バイトが区切り文字となります。DAB_HIRDB_DBINF_ESCの指定がない場合は＠が区切り文字となります。

＠を区切り文字としたときの例を次に示します。

DBHOST=＠DABENVGRP=XXXX

接続時にHiRDB環境変数グループ識別子XXXXを指定します。

注意事項

HiRDB環境変数グループの指定値はDABrokerではエラーチェックを行わないため，HiRDB環境変数グループに誤りがある場合はHiRDBのエラーとなります。

この機能を使用する場合，従来DABrokerで設定していた，PDUSER，PDCLTAPNAME，PDHOST，PDNAMEPORTは設定されません。

指定値の中の空白　#　"　'　はサポートしていません。指定した場合の動作は保証しません。

DBHOST=＠DABENVGRP=XXXX以外を指定しないでください。

DBNAME=データベースのポート番号

接続するHiRDBが使用するポート番号を指定します。指定を省略する場合は，HiRDBの環境変数PDNAMEPORTで指定した値になります。

DBHOSTとしてHiRDBクライアント環境変数，又はHiRDB環境変数グループ使用時の設定をした場合は，次のように設定してください。

DBNAME=DAB_HIRDBENV

USRID=ユーザID

データベースにアクセスするユーザIDを指定します。

アプリケーションでユーザIDの指定が省略された場合，ここで指定したユーザIDでデータベースにアクセスします。

なお，指定できる文字列の規則については，使用するデータベースのマニュアルを参照してください。

PASSWD=パスワード

データベースにアクセスするユーザIDのパスワードを指定します。

アプリケーションでパスワードの指定が省略された場合，ここで指定したパスワードでデータベースにアクセスします。

なお，指定できる文字列の規則については，使用するデータベースのマニュアルを参照してください。

◆ORACLEを使用する場合

DBNAME=ORACLEのリスナー名

SQL*NET経由で接続するORACLEのリスナー名称を指定します。

リモートアクセスをしない場合はここでの指定を省略してください。

USRID=ユーザID

データベースにアクセスするユーザIDを指定します。

アプリケーションでユーザIDの指定が省略された場合，ここで指定したユーザIDでデータベースにアクセスします。

なお，指定できる文字列の規則については，使用するデータベースのマニュアルを参照してください。

PASSWD=パスワード

データベースにアクセスするユーザIDのパスワードを指定します。

アプリケーションでパスワードの指定が省略された場合，ここで指定したパスワードでデータベースにアクセスします。

なお，指定できる文字列の規則については，使用するデータベースのマニュアルを参照してください。

◆Database Connection Server経由でメインフレーム系データベースを使用する場合

DBTYPE=データベース種別（指定必須）

データベース種別を指定します。

データベース種別

次の文字列を指定してください。

使用するデータベース

指定内容

VOS3 XDM/RDにアクセスする場合

XDMRD

VOS3 XDM/SDにアクセスする場合

XDMSD

VOSK SQL/Kにアクセスする場合

SQLK

VOS1 PDM II E2にアクセスする場合

VOS1PDM

VOS1 RDB1 E2にアクセスする場合

RDB1

VOSK スプールファイルにアクセスする場合

VOSKSPOOL

DBNAME=Database Connection Serverのデータベース識別子

接続するDatabase Connection Serverのデータベース識別子(RDノード名称)を指定します。

DBHOST=コネクションマルチ名

USERIDのユーザが使用する，コネクションマルチ定義に設定したコネクションマルチ名を指定します。

SNDBUF=送信するデータバッファのサイズ

Database Connection Server側へ送信するデータバッファのサイズを指定します。

指定できる範囲は，64〜2097151(キロバイト)です。

RCVBUF=受信するデータバッファのサイズ

Database Connection Server側から受信するデータバッファのサイズを指定します。

指定できる範囲は，64〜2097151(キロバイト)です。

USRID=ユーザID

データベースにアクセスするユーザIDを指定します。

アプリケーションでユーザIDの指定が省略された場合，ここで指定したユーザIDでデータベースにアクセスします。

なお，指定できる文字列の規則については，使用するデータベースのマニュアルを参照してください。

PASSWD=パスワード

データベースにアクセスするユーザIDのパスワードを指定します。

アプリケーションでパスワードの指定が省略された場合，ここで指定したパスワードでデータベースにアクセスします。

なお，指定できる文字列の規則については，使用するデータベースのマニュアルを参照してください。

3.6.3　接続先データベース定義ファイルの作成例

(1)　HiRDBとXDM/RDの場合の指定例

HiRDB及びVOS3 XDM/RDを使用する場合の指定例を次に示します。使用するHiRDBには2種類あり，次のような指定値を使用します。また，ここでは，DBTIMER，PASSWDの指定を省略しています。

（指定値）

HiRDBのデータベース種別名：DBDEF_HIR1

・一つ目のHiRDBのデータベース名：CNDEF_HIRSV1

・二つ目のHiRDBのデータベース名：CNDEF_HIRSV2

Database Connection Serverのデータベース種別名：DBDEF_DBS

・VOS3 XDM/RDのデータベース名：CNDEF_XDM

（作成例）

(2)　同時に接続できない例

接続先データベース定義ファイル内で複数定義したデータベース種別名がユニークでも，実際のデータベース種別が同じ場合，同じプログラムから同時に接続できません。

次のような例では，HiRDB1とHiRDB2の両方を同時に接続できません。HiRDB1とORACLE1，又はHiRDB1のTable1とTable2は同時に接続できます。

HiRDB1{
         DBTYPE=HIRDB
         Table1{
                  DBHOST='ITEMS'
                  DBNAME='22200'
         }
         Table2{
                  DBHOST='STOCK'
                  DBNAME='22200'
         }
}
HiRDB2{
         DBTYPE=HIRDB
         database2{
                  DBHOST='EMPLOYEE'
                  DBNAME='22200'
         }
}
ORACLE1{
         DBTYPE=ORACLE7
         DB1{
                  DBHOST='CUSTOMERS'
         }
}

3.7　DABrokerの起動と終了

ここでは，DABrokerの起動と終了について説明します。DABrokerと同じマシンでサーバアプリケーションを実行するような場合，DABrokerを起動する必要はありません。しかし，次のような場合は，DABrokerを起動する必要があります。

DBPARTNER，又はHITSENSER5を使用してデータベースにアクセスする場合

DBPARTNER Library，又はXDM/RD外部表を使用してデータベースにアクセスする場合

DABroker for Javaを使用してWWW環境でデータベースにアクセスする場合

DABroker for ODBCを使用してリモート接続でデータベースにアクセスする場合

DABrokerで提供するコマンドは，「DABroker運用ディレクトリ/bin」に格納されています。

DABrokerが実際に起動・終了されるのは，起動・終了コマンドの実行と同時ではありません。このため，起動・終了の各コマンドの実行が完了しても，しばらくDABrokerの起動・終了は動作します。

DABrokerの運用前の設定については，「5.　DABrokerの運用（共通）」を参照してください。

3.7.1　DABrokerの起動

DABrokerを起動するには，起動コマンドを入力します。また，DABrokerをインストールしたマシンの起動時に，自動的にDABrokerを起動する方法もあります。

(1)　起動コマンド

コマンド形式

# dabstart [-t]

機能

DABrokerを起動します。

使用できるユーザ

DABrokerの管理ユーザ

オプション

-t

クライアントとの通信にTCP/IPを使用することを指定します。なお，-tを省略しても標準値として-tが設定されます。

(2)　自動起動

自動起動とは，DABrokerをインストールした端末の電源を入れた時に，自動的にDABrokerを起動させることです。自動起動は，DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表からアクセスする場合だけ有効です。

自動起動の設定方法については，各UNIXのマニュアルを参照してください。

この記述は，UNIXが実行する起動シェルスクリプトの中では，TCP/IPの起動よりも後にDABrokerが起動するように追加してください。

3.7.2　DABrokerの終了

DABrokerを終了するには，終了コマンドを入力します。

クライアント及びDBMSは，それぞれの環境で終了してください。

オプションの指定で，次のどれかの終了方式が選べます。

通常の終了

接続中のクライアントが存在しない場合にだけ，DABrokerを終了します。それ以外の場合はエラーメッセージが表示され，終了できません。接続中のクライアントがあるかどうかは，dabstatコマンドで確認できます。dabstatコマンドについては，「3.8.1　動作状態の表示」を参照してください。

計画終了

サーバで実行中の処理が終わり，すべてのクライアントとのコネクションが解放された時点で，DABrokerを終了します。新しいクライアントからの接続要求，及び接続中のクライアントからの新しい処理要求は受け付けません。

強制終了

サーバで実行中の処理があってもすべて中断して，DABrokerを終了します。クライアントとのコネクションは解放し，データベースに対しては処理のロールバック要求と切り離しをします。

このほかに，DABrokerは終了しないで，サーバで実行中の特定のクライアントの処理だけを中断するオプションもあります。

(1)　終了コマンド

コマンド形式

# dabstop [-p|-f|-c IPアドレス又はホスト名]

機能

DABrokerを終了します。

使用できるユーザ

DABrokerの管理ユーザ

オプション

指定なし

通常の終了をします。

-p

DABrokerを計画終了します。

-f

DABrokerを強制終了します。

計画終了中に実行すると，計画終了から強制終了に切り替わります。

-c IPアドレス又はホスト名

指定したIPアドレス又はホスト上のクライアントから要求されている処理だけが強制的に中止さます。このとき，データベースの障害処理によってデータベースでの処理がロールバックされ，指定したクライアントとのコネクションは解放されます。この場合，DABrokerは終了しません。ほかのクライアントからの要求は引き続き受け付け，処理の中断を指定したクライアントも再起動すればコネクションを再び確立できます。

計画終了中に実行すると，指定したIPアドレス又はホスト上のクライアントの処理だけを中断し，その後は計画終了を続行します。

IPアドレス及びホスト名はdabstatコマンドで参照できます。dabstatコマンドについては，「3.8.1　動作状態の表示」を参照してください。

注意事項

設定項目DABTCP_TRCSIZE，又はDABSQL_TRCSIZEで0を設定し（通信トレース，又はSQLトレースを取得），クライアントからの要求量が多い場合，クライアント及びDABrokerを終了するまでに時間がかかります。

コマンドが終了しても，終了までに時間が掛かることがあります。このとき再起動しても，終了処理中のため起動できません。しばらく待ってから再起動してください。

3.8　DABrokerの処理内容の表示

ここでは，DABrokerの処理内容の表示に使うコマンドについて説明します。DABrokerの運用前の設定については，「5.　DABrokerの運用（共通）」を参照してください。

処理内容を表示するためのコマンドには次のものがあります。

dabstat（動作状態の表示）

dabcltrc（クライアントとの通信トレースの表示）

dabdbtrc（データベースアクセストレースの表示）

DABrokerで提供するコマンドは，「DABroker運用ディレクトリ/bin」に格納されています。

3.8.1　動作状態の表示

コマンド形式

$ dabstat

機能

DABrokerと各クライアントとの接続時間を表示します。

dabstatコマンドは，DABrokerの計画終了中にも実行できます。

使用できるユーザ

すべてのユーザ

出力例

STIME

そのクライアントからの最初の要求の受付開始日時（年/月/日 時:分:秒）

TIME

クライアントと接続している時間（時:分:秒）

CLIENT

クライアントのIPアドレス又はホスト名

hostsファイル又はネームサーバにホスト名が登録されている場合はホスト名が表示されます。それ以外の場合はIPアドレスが表示されます。

batchNo

実行中の予約処理の本数（64ビット版DABrokerでは表示されることはありません）。

association

クライアントとのコネクションの確立状態

*：コネクションを確立している。

空白：コネクションは解放している。

3.8.2　クライアントとの通信トレースの表示

コマンド形式

# dabcltrc [-c IPアドレス又はホスト名]

機能

DABrokerとクライアントとの間で行われた，データの送受信に関する情報（通信トレース）を表示します。

なお，通信トレースの取得は，クライアントからの要求受け付け直後，及びDABrokerからの結果送信直後に，DABrokerが行っています。

使用できるユーザ

DABrokerの管理ユーザ

オプション

指定なし

すべてのクライアントとの通信トレースを表示します。

-c IPアドレス又はホスト名

指定したIPアドレス又はホスト名のクライアントとの通信トレースだけを表示します。

出力例

IPADDR=XXXXXXXX

クライアントのIPアドレス又はホスト名

PROT=XXX

通信プロトコル。TCP：TCP/IP

PAP-NAME=XXXXXX

次のどれかが表示されます。

DABroker関連製品を使用した場合：アプリケーションで設定した名称

DBPARTNER/Client，DBPARTNER/Web，又はHITSENSER5からアクセスした場合：

DBPARTNER/Client，DBPARTNER/Web，又はHITSENSER5の識別情報

DBPARTNER Libraryからアクセスした場合：DBPARTNER Libraryの識別情報

XDM/RD外部表としてアクセスした場合：XDM/RDの識別情報

DATE

送受信の発生日付（年/月/日）

TIME

送受信の発生時刻（時:分:秒.n）

nはn/100秒を表します。

EVT

DABrokerでの事象区分

PUT：クライアントへの送信

GET：クライアントからの受信

SIZE

送受信データ長（バイト）

DATA

送受信データ種別

aa…aa <bb…bb>（cc…cc,dd…dd）の形式で出力されます。

aa…aa：オペレーション種別

表示されるオペレーション種別とその意味を次に示します。

オペレーション種別

意　　味

Connect（Database）

データベースとの接続要求

Disconnect（Database）

データベースとの切り離し要求

Disconnect（Connection）

コネクションの解放要求

Commit

トランザクションのコミット要求

Rollback

トランザクションのロールバック要求

LIST（Table）

表一覧取得要求

LIST（Column）

列一覧取得要求

LIST（Index）

索引一覧取得要求

LIST（Table Privileges）

表権限一覧取得要求

LIST（Column Privileges）

列権限一覧取得要求

LIST（PrimaryKey）

プライマリキー一覧取得要求

EXT-CMD

SQL文の実行要求

DataDivision（Fetch）

データ分割取得

Cancel

DBMSに対する処理の中断要求

Illegal Request

不正要求

Connection

コネクション確立応答

Result

正常応答

Error

異常応答

Result（Cancel）

正常応答（DBMSに対する処理の中断要求時）

Error（Cancel）

異常応答（DBMSに対する処理の中断要求時）

SQL Fetch Option

SQL実行オプション実行

File Delete

SQL実行結果格納ファイル削除

Procedure（List Prepare Procedure）

ストアドプロシジャ一覧取得準備要求

Procedure（List Fetch Procedure）

ストアドプロシジャ一覧取得要求

Procedure（List Close Procedure）

ストアドプロシジャ一覧取得後の処理要求

Procedure（List Prepare Column）

ストアドプロシジャ列一覧取得準備要求

Procedure（List Fetch Column）

ストアドプロシジャ列一覧取得要求

Procedure（List Close Column）

ストアドプロシジャ列一覧取得後の処理要求

Procedure（Parameter Get）

ストアドプロシジャ定義情報取得要求

Procedure（Prepare）

ストアドプロシジャ実行準備要求

Procedure（Execute）

ストアドプロシジャ実行要求

Procedure（Resume）

ストアドプロシジャResume実行

bb…bb：付加情報

オペレーション種別が，LIST（xxxxx）及びEXT-CMDの場合に表示されます。

cc…cc：リターンコード

dd…dd：詳細コード

注意事項

クライアントからの要求量が多いほど，クライアントとの通信トレースのファイル容量も多くなります。通信トレースのファイル容量の目安として，概算式を次に示します。

（概算式）

80（ヘッダ情報長） + クライアントからの要求数 * 2（PUT及びGET分） * 36（PUT及びGET情報長）〔バイト〕

あらかじめ，この概算式で計算したサイズ以上のハードディスク容量を用意しておいてください。また，クライアントからの要求量が多いほど，トレース表示が終わるまでにも時間がかかります。御注意ください。

3.9　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)

Database Connection Serverを経由してメインフレーム系データベースにアクセスする場合，アプリケーション，又はDBPARTNERは，接続先データベースの定義（「3.6　DABroker接続先データベースの定義」参照）で定義したコネクションマルチ名を使用してアクセスします。コネクションマルチ名とは，接続するDatabase Connection Serverのポート番号やホスト名などを定義した集まりに対して付ける任意名称です。コネクションマルチ名は，コネクションマルチ定義ファイルで定義します。ここでは，コネクションマルチ名の定義方法について説明します。

3.9.1　コネクションマルチ定義ファイルの作成

Database Connection Server経由でメインフレーム系データベースに接続する場合，コネクションマルチ定義ファイルで，コネクションマルチ名を定義します。コネクションマルチ定義ファイルは，インストール時に提供されるサンプルを使用して作成します。

表3-7に，使用するファイルとファイルの格納先を示します。

表3‒7　DABroker動作環境定義ファイルのファイル名

使用するサンプルファイル

コネクションマルチ定義ファイル格納先

/opt/DABroker/sample/damconenv

DABroker運用ディレクトリ/conf

コネクションマルチ定義ファイルの作成手順を次に示します。

サンプルファイルを，表3-7に示したコネクションマルチ定義ファイルの格納先へコピーする。

コピー先ファイルの設定項目の標準値を必要に応じて変更する。また，値が設定されていない項目には値を入力する。

ファイルを保存する。

(1)　ファイル作成時の注意事項

大文字と小文字は区別します。

定義名称は，255文字まで指定できます。

定義名称に2バイト文字，及び半角の片仮名は使用しないでください。

「＝」の前後に空白文字，又はタブコードを入れないでください。入れた場合はエラーとなります。

（エラーの例）

DABTMP = /tmp/dab

「＃」以降は，コメントとして扱います。

(2)　作成したファイルの変更

作成したコネクションマルチ定義ファイルの内容の変更は，DABroker，及びコネクションマルチ機能が起動していない時に行ってください。

3.9.2　コネクションマルチ名の設定

一つのコネクションマルチ名には，次の内容を定義します。

Database Connection Serverのホスト名，又はIPアドレス（DBSHOST）

Database Connection Serverのサービス名，又はポート番号（DBSPORT）

Database Connection Serverからの応答監視時間（DBSTIMER）

最大仮想コネクション数（MCONMAX）

通信処理プロセス数（MCONPROC）

プールコネクション数（MCONPOOL）

予約プールコネクション数（MRSVPOOL）

図3-3に「コネクションマルチ名」とDBSHOST，DBSPORTの指定内容の関係を示します。

図3‒3　指定内容の関係

図3-3で示すように，Database Connection Serverのホスト名（DBSHOST）には，Database Connection Server，及びアクセスするメインフレーム系データベースが存在するホスト名を指定します。Database Connection Serverのポート番号又はサービス名には，Database Connection Serverのサーバ空間※に割り当てられているサーバスケジュール番号（マニュアル「Database Connection Server」参照）を設定します。この例ではポート番号を指定していますが，サービス名を指定することもできます。サービス名を指定するときは，/etc/servicesファイルに，サービス名とそれに対応するポート番号を設定してください（「3.3　ネットワーク環境の設定」参照）。

注※　プロセスに相当するメインフレーム側の処理単位です。

3.9.3　最大仮想コネクション数などを設定するときのガイドライン

最大仮想コネクション数（MCONMAX），通信処理プロセス数（MCONPROC），プールコネクション数（MCONPOOL），予約プールコネクション数（MRSVPOOL）は，使用環境に合わせた適切な値を設定する必要があります。ここでは，設定するときのガイドラインを説明します。

(1)　DABrokerとDatabase Connection Serverの接続の仕組み

DABrokerとDatabase Connection Serverの接続時，Database Connection Serverでは，TCP/IPコネクションを確立します。1ユーザからのアクセス要求に対して一つのTCP/IPコネクションを確立します（図3-4参照）。

図3‒4　DABrokerとDatabase Connection Serverの接続イメージ(1)

この場合，1TCP/IPコネクションを1ユーザからのアクセス要求だけで使用でき，レスポンス性能が良くなりますが，同時アクセスユーザ数が増えると，TCP/IPコネクションの確立数も多くなりDatabase Connection Serverのメインフレーム側及びDABroker側でのリソース消費量が多くなってしまいます。

そのため，DABrokerでは，一つのTCP/IPコネクションを複数ユーザからのアクセス要求で共有できるように，一つのTCP/IPコネクションの中で複数のDABroker用のコネクションを確立できるようにしています。一つのTCP/IPコネクションに対して確立するDABroker用のコネクションを仮想コネクションと呼びます。一つのTCP/IPコネクションの中で複数の仮想コネクションを確立するときには，DABrokerでは，通信処理プロセスを起動します。通信処理プロセスは，TCP/IPコネクションごとに起動します。

1TCP/IPコネクションを複数ユーザからのアクセス要求で共有する場合，DABrokerでは，1通信処理プロセス当たりで（＝一つのTCP/IPコネクションに対して）同時に確立できる仮想コネクション数（=最大仮想コネクション数），及びDABroker内で同時に起動できる通信処理プロセス数（=通信処理プロセス数）を決めて運用します。

図3-5に，1TCP/IPコネクションを2ユーザからのアクセス要求で共有する場合（1通信処理プロセス当たりで二つの仮想コネクションを確立する場合）の，DABrokerとDatabase Connection Serverの接続イメージを示します。ここでは，アプリケーション及びDBPARTNERから同時に四つのアクセス要求があり，二つのTCP/IPコネクションで対応しています。DABrokerでは，二つの通信処理プロセスを起動し，それぞれの通信処理プロセスで二つの仮想コネクションを確立しています。このとき，四つのTCP/IPコネクションを使用した場合に比べ，メインフレーム側及びDABroker側の両方でリソース消費量を少なくできます。

DABrokerは，次のタイミングでDatabase Connection Serverに対してTCP/IPコネクションを確立します。

「予約プールコネクション数(MRSVPOOL)」が設定されている（>0）場合

DABrokerコネクションマルチ機能起動時に確立します。

「予約プールコネクション数(MRSVPOOL)」が設定されていない（=0）場合

最初のユーザアクセス要求時に確立します。

起動中の通信処理プロセスで実行できるユーザ数(「最大仮想コネクション数(MCONMAX)」)を超えたユーザアクセスが要求された場合

通信処理プロセスを新しく起動して確立します。

(ただし，「通信処理プロセス数(MCONPROC)」の範囲内)

そして，これらのTCP/IPコネクションを確立する際に，1TCP/IPコネクション上に「最大仮想コネクション数(MCONMAX)」に設定された数だけ仮想コネクションを予約します。

図3‒5　DABrokerとDatabase Connection Serverの接続イメージ(2)

なお，一つのTCP/IPコネクションに対して一つの仮想コネクションを確立する形態をシングルコネクション（図3-4参照）と呼び，一つのTCP/IPコネクションに対して複数の仮想コネクションを確立する形態をコネクションマルチ（図3-5参照）と呼びます。

(2)　最大仮想コネクション数と通信処理プロセス数の決定

最大仮想コネクション数（MCONMAX）

次のどちらかの値を設定します。

1TCP/IPコネクションを1ユーザからのアクセス要求だけで使用する場合（シングルコネクション）

最大仮想コネクション数を「1」に設定します。この場合，TCP/IPコネクションを1ユーザからのアクセス要求だけで使用できるためレスポンス性能が良いのですが，複数ユーザからの同時アクセス要求があるときには同時アクセス要求数分のTCP/IPコネクションを確立し，DABroker及びメインフレームでのリソース消費量が多くなります。

1TCP/IPコネクションを複数ユーザからのアクセス要求で共有する場合（コネクションマルチ）

「2以上の値」で，1通信処理プロセス当たりで同時に確立できる仮想コネクション数を設定します。設定値については，下記を参照してください。なお，この場合は，運用時に，コネクションマルチ機能起動コマンド（「3.10.1(1)　コネクションマルチ機能起動コマンド（dabcmstart）」参照）を実行してください。

通信処理プロセス数（MCONPROC）

DABrokerで同時に起動できる通信処理プロセス数の最大値を設定します。設定値については，下記を参照してください。なお，最大仮想コネクション数が「1」の場合は，設定する必要はありません。

1TCP/IPコネクションを複数ユーザからのアクセス要求で共有する場合，これらの値は，次の手順で決定してください。

DABrokerのシステム全体で同時にアクセスするユーザ数（要求数）の最大値を見積もる

この最大値は，アクセス対象となるDatabase Connection Serverの空間起動制御文で設定された「サーバユーザ数」以内となるようにしてください。サーバユーザ数の設定方法については，マニュアル「Database Connection Server」を参照してください。

「1で見積もった最大値≦最大仮想コネクション数 * 通信処理プロセス数」となるような最大仮想コネクション数と最大通信処理プロセス数の組み合わせを決定する

このとき，次の2点を考慮し，使用環境に合わせた適切な数値を検討してください。

レスポンス性能

DABrokerが組み込まれたサーバで消費するリソース量，及びDatabase Connection Serverが組み込まれたメインフレームで消費するリソース量

レスポンス性能は，1通信処理プロセス当たりの仮想コネクション数を少なくすればするほど向上し，最大仮想コネクション数を1にする（シングルコネクション）とレスポンスが早くなります。しかし，同時アクセスユーザ数が多い場合に，TCP/IPコネクションも増えるため，メインフレーム側でリソース消費量が多くなります。このため，使用環境に合わせた適切な数値を検討してください。

なお，最大仮想コネクション数は，接続するDatabase Connection Serverの空間起動制御文で設定された「ユーザ数(仮想ユーザ空間数など)÷TCPコネクション数」の倍数となるように設定してください。

(3)　プールコネクション数と予約プールコネクション数の決定（仮想コネクションのプーリング機能の使用）

最大仮想コネクション数を2以上にした場合，次の2種類の機能が使用できます。この2種類は併用できます。

一度確立した仮想コネクションをプールする

この機能を使用すると，コネクション確立のためのオーバーヘッドを削減し，Database Connection Serverとの接続時間の短縮が図れます。この機能を使用するときは，プールコネクション数（MCONPOOL）を設定してください。

コネクションマルチ機能の起動時に，指定された数の仮想コネクションを確立しておく

この機能を使用すると，通信処理プロセスの起動のためのオーバヘッドを削減し，Database Connection Serverとの接続時間を短縮できます。この機能を使用するときは，予約プールコネクション数（MRSVPOOL）を設定してください。

仮想コネクションのプーリング機能を使用するときは，次に示す値を設定してください。

プールコネクション数（MCONPOOL）

DABrokerのシステム全体でプールする仮想コネクション数を設定します。プールした仮想コネクションに対応するTCP/IPコネクションのためのリソースをDatabase Connection Server（メインフレーム）側で占有してしまうため，メインフレーム側でのリソース消費量を考慮して使用環境に合わせた値を設定してください。なお，リソースは，1通信処理プロセスごと，1TCP/IPコネクションごとに消費されるため，「最大仮想コネクション数」で設定した値の倍数をプールコネクション数に設定することをお勧めします。

予約プールコネクション数（MRSVPOOL）

DABrokerのシステム全体でコネクションマルチ機能起動時に確立しておく仮想コネクション数を設定します。コネクションマルチ機能起動時にアクセス要求がなくても仮想コネクションを確立してしまうことになるため，DABrokerを組み込んだサーバで確立した分のリソースを占有してしまいます。したがって，DABroker側のリソース消費量を考慮して使用環境に合わせた値を設定してください。なお，リソースは，1通信処理プロセスごと，1TCP/IPコネクションごとに消費されるため，「最大仮想コネクション数(MCONMAX)」で設定した値の倍数を予約プールコネクション数に設定することをお勧めします。

プールコネクション数及び予約プールコネクション数の両方に値を設定する場合は，「プールコネクション数≧予約プールコネクション数」となるように設定してください。

3.9.4　コネクションマルチ定義ファイルでの設定項目

コネクションマルチ定義ファイルでは，次の項目を設定します。

コネクションマルチ名

接続するDatabase Connection Serverに付ける任意名称を設定します。

<設定規則>DABrokerのシステム内でユニークな名称にしてください。最大255文字まで指定できます。2バイト文字，半角カタカナは使用しないでください。

DBSHOST=Database Connection Serverのホスト名又はIPアドレス

接続するDatabase Connection Serverが存在するホスト名，又はIPアドレスを設定します。

ここでの指定を省略した場合は，DABroker動作環境定義ファイルのDAB_DBS_HOST(接続するホスト名，又はIPアドレス)に指定された値を仮定します。

DBSPORT=Database Connection Serverのポート番号又はサービス名

接続するDatabase Connection Serverのポート番号（Database Connection Serverではサーバスケジュール番号と呼ぶ）又はサービス名（ユーザの任意設定名称）を設定します。

ここで，サービス名を指定した場合は，/etc/servicesファイルにサービス名と対応するポート番号を設定してください（「3.3　ネットワーク環境の設定」参照）。

ここでの指定を省略した場合は，DABroker動作環境定義ファイルのDAB_DBS_PORT(接続するサービス名，又はポート番号)に指定された値を仮定します。

DBSTIMER=Database Connection Serverからの応答監視時間

Database Connection Serverからの処理結果の応答待ち時間を設定します。

指定範囲：0，1〜65535（秒）

0を指定した場合：応答待ち時間を監視しません。

MCONMAX=最大仮想コネクション数

1通信処理プロセス当たりで同時に確立できる仮想コネクション数の最大値を設定します。ここで設定した値を超えるユーザからの要求があった場合は，別の通信処理プロセスを起動し，仮想コネクションを確立してDatabase Connection Serverに接続します。なお，データベースには，「最大仮想コネクション数 * 通信処理プロセス数」で算出される数のユーザが同時にアクセスできます。

指定範囲：1〜100

1を設定した場合

シングルコネクションとなります。

2以上を設定した場合

1通信処理プロセスにつき2以上の仮想コネクションを同時に確立できるマルチコネクション（コネクションマルチ）となります。このとき，「通信処理プロセス数(MCONPROC)」も設定してください。なお，この場合は，運用時に，コネクションマルチ機能起動コマンド（「3.10.1(1)　コネクションマルチ機能起動コマンド（dabcmstart）」参照）を実行してください。

MCONPROC=通信処理プロセス数

最大仮想コネクション数を2以上の値にした場合に必ず設定する項目です。

Database Connection Serverと接続するときに起動する最大通信処理プロセス数を設定します。ここで設定した値を超えた場合は，アプリケーション，又はDBPARTNERにエラーメッセージを返し，処理を受け付けません。

指定範囲：0，1〜1000

指定を省略した場合又は0を指定した場合

シングルコネクション（1通信処理プロセス当たり1仮想コネクション）となります。

MCONPOOL=プールコネクション数

最大仮想コネクション数を2以上の値にした場合に設定できる項目です。

Database Connection Serverに接続するときに確立する仮想コネクションを，データベースアクセスが終了しても，確立されたままの状態でプールしておく数を設定します。確立済みの仮想コネクションをプールしておくことで，Database Connection Serverと接続するときの仮想コネクション確立時間を短縮できます。

指定範囲：0，1〜32767

指定を省略した場合又は0を指定した場合：プール機能を使用できません。

MRSVPOOL=予約プールコネクション数

最大仮想コネクション数を2以上の値にした場合に設定できる項目です。

DABroker起動時に仮想コネクションを確立しておく数を設定します。DABroker起動時に仮想コネクションが確立されていると，Database Connection Serverと接続するときの仮想コネクション確立時間を短縮できます。

指定範囲：0，1〜32767

指定を省略した場合又は0を指定した場合：予約プール機能を使用できません。

注意

「最大仮想コネクション数 * 通信処理プロセス数(下記参照)」で算出される値以上の数を設定できません。設定した場合は，コネクションマルチ機能の運用を開始した時点で，通信処理プロセスの起動エラーとなります。

プールコネクション数も設定した場合，予約プールコネクション数では，プールコネクション数より大きな値を設定できません。

3.9.5　コネクションマルチ定義ファイルの作成例

コネクションマルチ定義ファイルの作成例を次に示します。

コネクションマルチ名dbs01はコネクションマルチ機能を使用する例，コネクションマルチ名dbs02はコネクションマルチ機能を使用しない例です。

dbs01{
         DBSHOST='host01'
         DBSPORT='5001'
         DBSTIMER=180
         MCONMAX=2
         MCONPROC=10
         MCONPOOL=5
         MRSVPOOL=3
}
dbs02{
         DBSHOST='host02'
         DBSPORT='5002'
         DBSTIMER=180
         MCONMAX=1
}

3.10　コネクションマルチ機能の使用

コネクションマルチ定義ファイルで，「最大仮想コネクション数(MCONMAX)」を2以上に設定した場合は，コネクションマルチ機能起動コマンドを実行してください。この場合は，コネクションマルチ運用ユティリティを使って，Database Connection ServerとDABrokerとの接続状態を確認できます。

ここでは，コネクションマルチ機能の運用開始と終了方法，コネクションマルチ運用ユティリティについて説明します。

DABrokerで提供するコマンドは，「DABroker運用ディレクトリ/bin」に格納されています。

Red Hat Linuxの場合，コネクションマルチ機能は使用できません。

3.10.1　コネクションマルチ機能の運用開始と終了

コネクションマルチ機能の運用開始方法と終了方法について説明します。

注意事項

コネクションマルチ機能が実際に起動・終了されるのは，起動・終了コマンドの実行と同時ではありません。このため，起動・終了の各コマンドの実行が完了しても，しばらくコネクションマルチ機能の起動・終了は動作します。

複数の仮想コネクション下に接続し，Database Connection Server側のタイマ監視などによって，Database Connection Server側で仮想コネクションが切断された場合，DABrokerを使用しているクライアントからDisconnectを発行して処理を終了させないと，仮想コネクションは切断されません。

(1)　コネクションマルチ機能起動コマンド(dabcmstart)

コマンド形式

# dabcmstart

機能

コネクションマルチ機能を起動します。

使用できるユーザ

DABrokerの管理ユーザ

注意事項

コネクションマルチ機能は，二つ以上同時に起動できません。

(2)　コネクションマルチ機能終了コマンド(dabcmstop)

コマンド形式

# dabcmstop 　[-f | -p]

機能

コネクションマルチ機能を終了します。

使用できるユーザ

DABrokerの管理ユーザ

オプション

dabcmstopでは次のオプションが指定できます。ただし，複数のオプションを同時に指定できません。

-f

起動中の処理すべてを強制終了します(強制終了)。

サーバプロセスは，接続中のユーザに強制終了を受信したことを通知して終了します。

データベースにアクセス中の処理は，この通知を受けた時点で処理を終了します。

計画終了中でも強制終了は実行できます。

-p

新しいユーザからの要求を受け付けないようにして，接続中のユーザの処理がすべて終了した時点で終了します(計画終了)。

計画終了の解除はできません。

省略

接続中のユーザがいない場合だけ，終了します(正常終了)。

それ以外の場合はメッセージを出力し，終了コマンドが無効になります。

3.10.2　コネクションマルチ運用ユティリティ

コネクションマルチ運用ユティリティには次の機能があります。

コネクションマルチ機能の運用状態の表示

接続ユーザIDからのアクセス要求に対応する仮想コネクションIDごとの，DABrokerとDatabase Connection Serverとの接続時間を表示します。

(1)　ステータス表示コマンド(dabcmstat)

コマンド形式

$ dabcmstat

機能

コネクションマルチ機能の動作状態（ステータス）を表示します。

使用できるユーザ

すべてのユーザ

出力例

CONNTIME：接続開始時間

USERTIME：ユーザ開始時間※

USERID：接続ユーザID※

STATUS：仮想コネクションの状態

USE：仮想コネクションの使用中

POOL：仮想コネクションのプール待機中

VCONID：仮想コネクションID

DMNID：通信デーモンID

SVPROCID：サーバプロセスID

CMNAME：コネクションマルチ名

注※　仮想コネクションの状態が「USE（ユーザ使用中）」の場合だけ表示されます。

3.11　ORACLEアクセスライブラリ再作成方法

DABrokerでは，ORACLEをアクセスするためのライブラリとしてORACLEアクセスライブラリを提供しています。ORACLEアクセスライブラリは，ORACLEのOCIプログラムです。OCIプログラムは，ORACLEのインストール状況によって，その作成方法（make方法）が異なる場合があります。ORACLEのインストールの状況によっては，DABrokerが提供しているORACLEアクセスライブラリではORACLEにアクセスできず，ユーザの環境に合わせたORACLEアクセスライブラリの再作成が必要になります※。

ここでは，ORACLEアクセスライブラリを作成する機能について，UNIXの種類ごとに説明します。

注※

Oracle12c以降のバージョンの場合はアクセスライブラリの再作成が必要になることはありません。Oracle12c以降のバージョンのサンプルメイクファイルは提供していません。

3.11.1　HP-UXの場合

HP-UX使用時のORACLEアクセスライブラリ再作成方法について説明します。

(1)　適用範囲

ORACLEアクセスライブラリを作成する機能は，次のORACLEシステムを運用している場合に適用してください。

DABrokerを動作させた時，次のメッセージでORACLEの関数名，又はライブラリ名が出力された場合

DABroker出力メッセージ

KFDB005MM-E システムコールでエラーが発生しました。

[dlopen(/opt/DABroker/lib/libdaO7101.sl※) errno=ld.sl.1:

重大なエラー:再配置エラー:ファイル /opt/DABroker/lib/libdaO7101.sl※:

シンボル（ORACLEの関数）:参照されたシンボルがありません]

注※

Oracle10g R10.1.0またはR10.2.0を使用している場合：libdaO7101.slと表示されます。

Oracle11g R11.1.0またはR11.2.0を使用している場合：libdaO7111.slと表示されます。

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0またはR10.2.0を使用している場合：libdaO8101.slと表示されます。

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle11g R11.1.0またはR11.2.0を使用している場合：libdaO8111.slと表示されます。

(2)　ORACLEアクセスライブラリ再作成の手順

ORACLEアクセスライブラリを再作成する手順を次に説明します。

次の手順は，必ず，運用ディレクトリが/opt/DABrokerの環境で実行してください。

DABrokerの運用ディレクトリを/opt/DABroker以外に設定している場合は，いったん，DABrokerのセットアップコマンドで運用ディレクトリを/opt/DABrokerに戻してから実行してください。

DABroker既存ライブラリのバックアップ

DABrokerの既存ライブラリのバックアップを次のように取得してください。

cd　/opt/DABroker/lib

Oracle10g R10.1.0またはR10.2.0を使用している場合：libdaO7101.slと表示されます。

Oracle11g R11.1.0またはR11.2.0を使用している場合：libdaO7111.slと表示されます。

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0またはR10.2.0を使用している場合：libdaO8101.slと表示されます。

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle11g R11.1.0またはR11.2.0を使用している場合：libdaO8111.slと表示されます。

提供サンプルメイクファイルの修正

DABrokerでは，表3-8〜11に示す，各ORACLEアクセスライブラリのサンプルメイクファイルを提供しています。使用している環境に合わせて，修正して使用してください。

なお，表中の番号は，次の内容を示しています。

1：DABrokerアクセスライブラリ名称

修正しないでください。

2：DABroker共用ライブラリ

修正しないでください。

3：ORACLEクライアントライブラリ，及びOS提供ライブラリ

DABrokerのORACLEアクセスライブラリは，ORACLEのOCIプログラムです。ORACLEのマニュアルを参照し，OCIプログラム作成時に必要なORACLEクライアントライブラリ，及びOS提供ライブラリを確認の上，使用している環境に合わせて修正してください。

4：DABroker共用オブジェクトファイル

修正しないでください。

5：リンケージパラメタ

修正しないでください。

Oracle 10g R10.1.0またはR10.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake7101

表3‒8　Oracle 10g R10.1.0またはR10.2.0サンプルメイクファイル

番号

定義文

1

PROGRAM　= libdaO7101.sl

2

LIBS　　　　= -L /opt/DABroker/lib -ldacommon

3

LIBS1　　　 = -l:libcl.sl -lpthread

3

ORALIB　　 = -L $(ORACLE_HOME)/lib -l:libclntsh.sl

3

LDFLAGS　　= -b +s

4

OBJS　　　　= $(DABDIR)/obj/dacdcntl.o　$(DABDIR)/obj/daO7101.a

5

all:　　　　　　$(PROGRAM)

5

$(PROGRAM):　$(OBJS)

echo "Linking $(PROGRAM) ..."

$(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥

$(ORALIB)

echo "done

Oracle 11g R11.1.0またはR11.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake7111

表3‒9　Oracle 11g R11.1.0またはR11.2.0サンプルメイクファイル

番号

定義文

1

PROGRAM　= libdaO7111.sl

2

LIBS　　　　= -L /opt/DABroker/lib -ldacommon

3

LIBS1　　　 = -l:libcl.sl -lpthread

3

ORALIB　　 = -L $(ORACLE_HOME)/lib -l:libclntsh.sl

3

LDFLAGS　　= -b +s

4

OBJS　　　　= $(DABDIR)/obj/dacdcntl.o　$(DABDIR)/obj/daO7111.a

5

all:　　　　　　$(PROGRAM)

5

$(PROGRAM):　$(OBJS)

echo "Linking $(PROGRAM) ..."

$(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥

$(ORALIB)

echo "done"

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake8101

表3‒10　Oracle 10g R10.1.0またはR10.2.0サンプルメイクファイル(DABroker for Javaのデータベース種別にOracle8iを指定時)

番号

定義文

1

PROGRAM　= libdaO8101.sl

2

LIBS　　　　= -L /opt/DABroker/lib -ldacommon

3

LIBS1　　　 = -l:libcl.sl -lpthread

3

ORALIB　　 = -L $(ORACLE_HOME)/lib -l:libclntsh.sl

3

LDFLAGS　　= -b +s

4

OBJS　　　　= $(DABDIR)/obj/dacd8101.o　$(DABDIR)/obj/daO8101.a

5

all:　　　　　　$(PROGRAM)

5

$(PROGRAM):　$(OBJS)

echo "Linking $(PROGRAM) ..."

$(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥

$(ORALIB)

echo "done"

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake8111

表3‒11　Oracle 11g R11.1.0またはR11.2.0サンプルメイクファイル(DABroker for Javaのデータベース種別にOracle8iを指定時)

番号

定義文

1

PROGRAM　= libdaO8111.sl

2

LIBS　　　 = -L /opt/DABroker/lib -ldacommon

3

LIBS1　　　= -l:libcl.sl -lpthread

3

ORALIB　　= -L $(ORACLE_HOME)/lib -l:libclntsh.sl

3

LDFLAGS　 = -b +s

4

OBJS　　　 = $(DABDIR)/obj/dacd8111.o　$(DABDIR)/obj/daO8111.a

5

all:　　　　　 $(PROGRAM)

5

$(PROGRAM):　$(OBJS)

echo "Linking $(PROGRAM) ..."

$(LD) -o $(PROGRAM) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥

$(ORALIB)

echo "done"

DABroker ORACLEアクセスライブラリの再作成

サンプルメイクファイルを修正後，次の環境変数を入力し，makeコマンドを実行してください。

（メイクファイル実行手順　Bシェルを使用の場合）

ORACLE_HOME＝ORACLE HOMEディレクトリ

export　ORACLE_HOME

DABDIR＝/opt/DABroker

export　DABDIR

Oracle 10g R10.1.0またはR10.2.0を使用している場合

make -f Oramake7101（修正後のメイクファイルを実行する）

Oracle 11g R11.1.0またはR11.2.0を使用している場合

make -f Oramake7111（修正後のメイクファイルを実行する）

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

make -f Oramake8101（修正後のメイクファイルを実行する）

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

make -f Oramake8111（修正後のメイクファイルを実行する）

再作成後のORACLEアクセスライブラリをDABrokerのライブラリ格納用ディレクトリにコピーする

makeコマンドを実行したディレクトリ環境下で再作成したORACLEアクセスライブラリを次のようにコピーしてください。

再作成したORACLEアクセスライブラリは，makeコマンドを実行したカレントディレクトリに作成されます。

Oracle 10g R10.1.0またはR10.2.0を使用している場合

cp libdaO7101.sl /opt/DABroker/lib/libdaO7101.sl

Oracle 11g R11.1.0またはR11.2.0を使用している場合

cp libdaO7111.sl /opt/DABroker/lib/libdaO7111.sl

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

cp libdaO8101.sl /opt/DABroker/lib/libdaO8101.sl

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

cp libdaO8111.sl /opt/DABroker/lib/libdaO8111.sl

DABrokerの再セットアップ

作成したORACLEアクセスライブラリを/opt/DABroker/libにコピーした後，再度，DABrokerのセットアップコマンドを実行してください。

3.11.2　AIXの場合

AIX使用時のORACLEアクセスライブラリ再作成方法について説明します。

(1)　適用範囲

ORACLEアクセスライブラリを作成する機能は，次のORACLEシステムを運用している場合に適用してください。

DABrokerを動作させた時，次のメッセージでORACLEの関数名，またはライブラリ名が出力された場合

DABroker出力メッセージ

KFDB005MM-E システムコールでエラーが発生しました。

[dlopen(/opt/DABroker/lib/libdaO7101.sl※) errno=ld.sl.1:

重大なエラー:再配置エラー:ファイル /opt/DABroker/lib/libdaO7101.sl※:

シンボル（ORACLEの関数）:参照されたシンボルがありません]

注※

Oracle10g R10.1.0またはR10.2.0を使用している場合：libdaO7101.slと表示されます。

Oracle11g R11.1.0またはR11.2.0を使用している場合：libdaO7111.slと表示されます。

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0またはR10.2.0を使用している場合：libdaO8101.slと表示されます。

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle11g R11.1.0またはR11.2.0を使用している場合：libdaO8111.slと表示されます。

(2)　ORACLEアクセスライブラリ再作成の手順

ORACLEアクセスライブラリを再作成する手順を次に説明します。

次の手順は，必ず，運用ディレクトリが/opt/DABrokerの環境で実行してください。

DABrokerの運用ディレクトリを/opt/DABroker以外に設定している場合は，いったん，DABrokerのセットアップコマンドで運用ディレクトリを/opt/DABrokerに戻してから実行してください。

DABroker既存ライブラリのバックアップ

DABrokerの既存ライブラリのバックアップを次のように取得してください。

cd　/opt/DABroker/lib

Oracle10g R10.1.0またはR10.2.0を使用している場合

mv　libdaO7101.a　　libdaO7101.a_bk

Oracle11g R11.1.0またはR11.2.0を使用している場合

mv　libdaO7111.a　　libdaO7111.a_bk

DABrokerのデータベース種別にORACLE8iを指定して，Oracle10g R10.1.0またはR10.2.0を使用している場合

mv　libdaO8101.a　　libdaO8101.a_bk

DABrokerのデータベース種別にORACLE8iを指定して，Oracle11g R11.1.0またはR11.2.0を使用している場合

mv　libdaO8111.a　　libdaO8111.a_bk

提供サンプルメイクファイルの修正

DABrokerでは，表3-12〜15に示す，ORACLEアクセスライブラリのサンプルメイクファイルを提供しています。使用している環境に合わせて，修正して使用してください。

なお，表中の番号は，次の内容を示しています。

1：DABrokerアクセスライブラリ名称

修正しないでください。

2：DABroker共用ライブラリ

修正しないでください。

3：ORACLEクライアントライブラリ，及びOS提供ライブラリ

DABrokerのORACLEアクセスライブラリは，ORACLEのOCIプログラムです。ORACLEのマニュアルを参照し，OCIプログラム作成時に必要なORACLEクライアントライブラリ，及びOS提供ライブラリを確認の上，使用している環境に合わせて修正してください。

4：DABroker共用オブジェクトファイル

修正しないでください。

5：リンケージパラメタ

修正しないでください。

Oracle 10g R10.1.0またはR10.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake7101

表3‒12　Oracle 10g R10.1.0またはR10.2.0サンプルメイクファイル

番号

定義文

1

PROGRAM　　 = libdaO7101.a

1

PROGRAM1　　= libdaO7101.o

2

LIBS　　　　　　= -L /opt/DABroker/lib -ldacommon

3

LIBS1　　　　　 = -lpthreads -bglink:/lib/glink.o -bM:SRE -bexpall ¥

3

　　　　　　　　　　-bnoentry -lm -lc_r

3

ORALIB　　　　= -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS　　　= -G

4

OBJS　　　　　= /opt/DABroker/obj/dacdcntl.o ¥

4

　　　　　　　　　/opt/DABroker/obj/daO7101.a

5

all:　　　　　　　$(PROGRAM)

5

$(PROGRAM):　$(OBJS)

echo "Linking $(PROGRAM) ..."

ld -o $(PROGRAM1) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥

　　　$(ORALIB)

ar rv $(PROGRAM) $(PROGRAM1)

rm -f $(PROGRAM1)

echo "done"

Oracle 11g R11.1.0またはR11.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake7111

表3‒13　Oracle 11g R11.1.0またはR11.2.0サンプルメイクファイル

番号

定義文

1

PROGRAM　　 = libdaO7111.a

1

PROGRAM1　　= libdaO7111.o

2

LIBS　　　　　　= -L /opt/DABroker/lib -ldacommon

3

LIBS1　　　　　 = -lpthreads -bglink:/lib/glink.o -bM:SRE -bexpall ¥

3

　　　　　　　　　　-bnoentry -lm -lc_r

3

ORALIB　　　　= -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS　　　= -G

4

OBJS　　　　　= /opt/DABroker/obj/dacdcntl.o ¥

4

　　　　　　　　　/opt/DABroker/obj/daO7111.a

5

all:　　　　　　　$(PROGRAM)

5

$(PROGRAM):　$(OBJS)

echo "Linking $(PROGRAM) ..."

ld -o $(PROGRAM1) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥

　　　$(ORALIB)

ar rv $(PROGRAM) $(PROGRAM1)

rm -f $(PROGRAM1)

echo "done"

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake8101

表3‒14　Oracle 10g R10.1.0またはR10.2.0サンプルメイクファイル(DABroker for Javaのデータベース種別にOracle8iを指定時)

番号

定義文

1

PROGRAM　　 = libdaO8101.a

1

PROGRAM1　　= libdaO8101.o

2

LIBS　　　　　　= -L /opt/DABroker/lib -ldacommon

3

LIBS1　　　　　 = -lpthreads -bglink:/lib/glink.o -bM:SRE -bexpall ¥

3

　　　　　　　　　　-bnoentry -lm -lc_r

3

ORALIB　　　　= -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS　　　= -G

4

OBJS　　　　　= /opt/DABroker/obj/dacd8101.o ¥

4

　　　　　　　　　/opt/DABroker/obj/daO8101.a

5

all:　　　　　　　$(PROGRAM)

5

$(PROGRAM):　$(OBJS)

echo "Linking $(PROGRAM) ..."

ld -o $(PROGRAM1) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥

　　　$(ORALIB)

ar rv $(PROGRAM) $(PROGRAM1)

rm -f $(PROGRAM1)

echo "done"

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake8111

表3‒15　Oracle 11g R11.1.0またはR11.2.0サンプルメイクファイル(DABroker for Javaのデータベース種別にOracle8iを指定時)

番号

定義文

1

PROGRAM　　 = libdaO8111.a

1

PROGRAM1　　= libdaO8111.o

2

LIBS　　　　　　= -L /opt/DABroker/lib -ldacommon

3

LIBS1　　　　　= -lpthreads -bglink:/lib/glink.o -bM:SRE -bexpall ¥

3

　　　　　　　　　　-bnoentry -lm -lc_r

3

ORALIB　　　　= -L $(ORACLE_HOME)/lib -lclntsh

3

LDFLAGS　　　= -G

4

OBJS　　　　　= /opt/DABroker/obj/dacd8111.o ¥

4

　　　　　　　　　/opt/DABroker/obj/daO8111.a

5

all:　　　　　　　$(PROGRAM)

5

$(PROGRAM):　$(OBJS)

echo "Linking $(PROGRAM) ..."

ld -o $(PROGRAM1) $(OBJS) $(LIBS) $(LIBS1) $(LDFLAGS) ¥

　　　$(ORALIB)

ar rv $(PROGRAM) $(PROGRAM1)

rm -f $(PROGRAM1)

echo "done"

DABroker ORACLEアクセスライブラリの再作成

サンプルメイクファイルを修正後，次の環境変数を入力し，makeコマンドを実行してください。

（メイクファイル実行手順　Bシェルを使用の場合）

ORACLE_HOME＝ORACLE HOMEディレクトリ

export　ORACLE_HOME

DABDIR＝/opt/DABroker

export　DABDIR

Oracle 10g R10.1.0またはR10.2.0を使用している場合

make -f Oramake7101（修正後のメイクファイルを実行する）

Oracle 11g R11.1.0またはR11.2.0を使用している場合

make -f Oramake7111（修正後のメイクファイルを実行する）

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

make -f Oramake8101（修正後のメイクファイルを実行する）

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

make -f Oramake8111（修正後のメイクファイルを実行する）

再作成後のORACLEアクセスライブラリをDABrokerのライブラリ格納用ディレクトリにコピーする

makeコマンドを実行したディレクトリ環境下で再作成したORACLEアクセスライブラリを次のようにコピーしてください。

再作成したORACLEアクセスライブラリは，makeコマンドを実行したカレントディレクトリに作成されます。

Oracle 10g R10.1.0またはR10.2.0を使用している場合

cp libdaO7101.sl /opt/DABroker/lib/libdaO7101.sl

Oracle 11g R11.1.0またはR11.2.0を使用している場合

cp libdaO7111.sl /opt/DABroker/lib/libdaO7111.sl

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

cp libdaO8101.sl /opt/DABroker/lib/libdaO8101.sl

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

cp libdaO8111.sl /opt/DABroker/lib/libdaO8111.sl

DABrokerの再セットアップ

作成したORACLEアクセスライブラリを/opt/DABroker/libにコピーした後，再度，DABrokerのセットアップコマンドを実行してください。

3.11.3　Red Hat Linuxの場合

(1)　適用範囲

ORACLEアクセスライブラリを作成する機能は，次のORACLEシステムを運用している場合に適用してください。

DABrokerを動作させた時，次のメッセージでORACLEの関数名，またはライブラリ名が出力された場合

DABroker出力メッセージ

KFDB005MM-Eシステムコールでエラーが発生しました。

[dlopen(/opt/DABroker/lib/libdaO7101.sl※) errno=ld.sl.1：

重大なエラー：再配置エラー：ファイル /opt/DABroker/lib/libdaO7101.sl※:

シンボル（ORACLEの関数）：参照されたシンボルがありません]

注※

Oracle10g R10.1.0またはR10.2.0を使用している場合：libdaO7101.slと表示されます。

Oracle11g R11.1.0またはR11.2.0を使用している場合：libdaO7111.slと表示されます。

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle10g R10.1.0またはR10.2.0を使用している場合：libdaO8101.slと表示されます。

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle11g R11.1.0またはR11.2.0 を使用している場合：libdaO8111.slと表示されます。

(2)　ORACLEアクセスライブラリの作成手順

ORACLEアクセスライブラリを再作成する手順を次に示します。

次の手順は，必ず，運用ディレクトリが/opt/DABrokerの環境で実行してください。

DABrokerの運用ディレクトリを/opt/DABroker以外に設定している場合は，いったん，DABrokerのセットアップコマンドで運用ディレクトリを/opt/DABrokerに戻してから実行してください。

DABroker既存ライブラリのバックアップ

DABrokerの既存ライブラリのバックアップを次のように取得してください。

cd /opt/DABroker/lib

Oracle 10g R10.1.0またはR10.2.0を使用している場合

mv libdaO7101.a libdaO7101.a_bk

Oracle 11g R11.1.0またはR11.2.0を使用している場合

mv libdaO7111a libdaO7111.a_bk

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

mv libdaO8101.a libdaO8101.a_bk

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

mv libdaO8111.a libdaO8111.a_bk

提供サンプルメイクファイルの修正

DABrokerでは，表3-16〜19に示すORACLEアクセスライブラリのサンプルメイクファイルを提供しています。使用している環境に合わせて，修正して使用してください。

なお，表中の番号は，次の内容を示しています。

1：DABrokerのアクセスライブラリ名称

修正しないでください。

2：DABroker共用ライブラリ

修正しないでください。

3：ORACLEクライアントライブラリ，およびOS提供ライブラリ

DABrokerのORACLEアクセスライブラリは，ORACLEのOCIプログラムです。ORACLEのマニュアルを参照し，OCIプログラム作成時に必要なORACLEクライアントライブラリ，およびOS提供ライブラリを確認の上，使用している環境に合わせて修正してください。

4：DABroker共用オブジェクトファイル

修正しないでください。

5：リンケージパラメタ

修正しないでください。

Oracle 10g R10.1.0またはR10.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake7101

表3‒16　Oracle 10g R10.1.0またはR10.2.0サンプルメイクファイル

番号

定義文

1

PROGRAM　　= libdaO7101.so

2

LIBS　　　　　 = -L $(DABDIR)/lib -ldacommon

3

ORALIB　　　　=-L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS　　　= -ldl -lnsl -lpthread -G

4

OBJS　　　　　= $(DABDIR)/obj/dacdcntl.o $(DABDIR)/obj/daO7101.a

5

all:　　　　　　　　$(PROGRAM)

5

$(PROGRAM):　 $(OBJS)

echo "Linking $(PROGRAM) ..."

ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)

echo "done"

Oracle 11g R11.1.0またはR11.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake7111

表3‒17　Oracle 11g R11.1.0またはR11.2.0サンプルメイクファイル

番号

定義文

1

PROGRAM　　= libdaO7111.so

2

LIBS　　　　　 = -L $(DABDIR)/lib -ldacommon

3

ORALIB　　　　= -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS　　　= -ldl -lnsl -lpthread -G

4

OBJS　　　　　= $(DABDIR)/obj/dacdcntl.o $(DABDIR)/obj/daO7111.a

5

all:　　　　　　　　$(PROGRAM)

5

$(PROGRAM):　 $(OBJS)

echo "Linking $(PROGRAM) ..."

ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)

echo "done"

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake8101

表3‒18　Oracle 10g R10.1.0またはR10.2.0サンプルメイクファイル(DABroker for Javaのデータベース種別にOracle8iを指定時)

番号

定義文

1

PROGRAM　　= libdaO8101.so

2

LIBS　　　　　 = -L $(DABDIR)/lib -ldacommon

3

ORALIB　　　　= -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS　　　= -ldl -lnsl -lpthread -G

4

OBJS　　　　　= $(DABDIR)/obj/dacd8101.o $(DABDIR)/obj/daO8101.a

5

all:　　　　　　　　$(PROGRAM)

5

$(PROGRAM):　 $(OBJS)

echo "Linking $(PROGRAM) ..."

ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)

echo "done"

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

ファイル名：/opt/DABroker/sample/oramake8111

表3‒19　Oracle 11g R11.1.0またはR11.2.0サンプルメイクファイル(DABroker for Javaのデータベース種別にOracle8iを指定時)

番号

定義文

1

PROGRAM　　= libdaO8111.so

2

LIBS　　　　　 = -L $(DABDIR)/lib -ldacommon

3

ORALIB　　　　= -L$(ORACLE_HOME)/lib -L$(ORACLE_HOME)/rdbms/lib -lclntsh

3

LDFLAGS　　　= -ldl -lnsl -lpthread -G

4

OBJS　　　　　= $(DABDIR)/obj/dacd8111.o $(DABDIR)/obj/daO8111.a

5

all:　　　　　　　　$(PROGRAM)

5

$(PROGRAM):　 $(OBJS)

echo "Linking $(PROGRAM) ..."

ld -o $(PROGRAM) $(OBJS) $(LIBS) $(ORALIB) $(LDFLAGS)

echo "done"

DABroker ORACLEアクセスライブラリの再作成

サンプルメイクファイルを修正後，次の環境変数を入力し，makeコマンドを実行してください。

（メイクファイル実行手順　Bシェルを使用の場合）

ORACLE_HOME＝ORACLE HOMEディレクトリ

export ORACLE_HOME

DABDIR = /opt/DABroker

export DABDIR

Oracle 10g R10.1.0またはR10.2.0を使用している場合

make -f Oramake7101（修正後のメイクファイルを実行する）

Oracle 11g R11.1.0またはR11.2.0を使用している場合

make -f Oramake7111（修正後のメイクファイルを実行する）

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

make -f Oramake8101（修正後のメイクファイルを実行する）

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

make -f Oramake8111（修正後のメイクファイルを実行する）

再作成のORACLEアクセスライブラリをDABrokerのライブラリ格納用ディレクトリにコピーする

makeコマンドを実行したディレクトリ環境下で再作成した，ORACLEアクセスライブラリを次のようにコピーしてください。

再作成したORACLEアクセスライブラリは，makeコマンドを実行したカレントディレクトリに作成されます。

Oracle 10g R10.1.0またはR10.2.0を使用している場合

cp libdaO7101.sl /opt/DABroker/lib/libdaO7101.sl

Oracle 11g R11.1.0またはR11.2.0を使用している場合

cp libdaO7111.sl /opt/DABroker/lib/libdaO7111.sl

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 10g R10.1.0またはR10.2.0を使用している場合

cp libdaO8101.sl /opt/DABroker/lib/libdaO8101.sl

DABroker for Javaのデータベース種別にOracle8iを指定して，Oracle 11g R11.1.0またはR11.2.0を使用している場合

cp libdaO8111.sl /opt/DABroker/lib/libdaO8111.sl

DABrokerの再セットアップ

作成したORACLEアクセスライブラリを/opt/DABroker/libにコピーしたあと，再度，DABrokerのセットアップコマンドを実行してください。

3.11.4　Oracle9i又はOracle10gで追加されたデータ型への対応状況

Oracle9i，又はOracle10gで追加されたデータ型に対するDABrokerの対応状況を表3-20と表3-21に示します。

表3‒20　Oracle9iで追加されたデータ型

データ型

DABrokerでのサポート状況

TIMESTAMP(fractional_seconds_precision)

未サポート

TIMESTAMP(fractional_seconds_precision) WITH TIME ZONE

未サポート

TIMESTAMP(fractional_seconds_precision) WITH LOCAL TIME ZONE

未サポート

INTERVAL YEAR(year_precision) TO MONTH

未サポート

INTERVAL DAY(day_precision) TO SECOND (fractional_seconds_precision)

未サポート

表3‒21　Oracle10gで追加されたデータ型

データ型

DABrokerでのサポート状況

BINARY_FLOAT

未サポート

BINARY_DOUBLE

未サポート

4　DABrokerの環境設定と運用（Windows）

この章では，WindowsでのDABrokerの環境設定，及び運用の方法について説明します。

4.1　環境設定の手順

ここでは，DABrokerを使用する環境の設定手順について説明します。なお，説明は，次のことを前提にしています。

DBMSを使用できる環境が既に構築されていること

開発アプリケーション，DBPARTNER，又はHITSENSER5を組み込むマシン，DBPARTNER Library，又はXDM/RD外部表を組み込むマシンをネットワーク上で使用できる環境が既に構築されていること

Database Connection Server経由でメインフレーム系データベースにアクセスする場合，Database Connection Serverが接続先のメインフレームに組み込まれていること

DABrokerの環境設定の操作手順を，DABroker関連製品を使用する場合とDBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合に分けて説明します。

4.1.1　DABroker関連製品を使用する場合の環境設定

DABroker関連製品を使用する場合の環境設定の手順を図4-1に示します。

図4-1では，環境設定完了後，最初にDABrokerを運用するまでの操作を示しています。

図4‒1　DABroker関連製品を使用する場合の環境設定の手順

4.1.2　DBPARTNER，HITSENSER5，DBPARTNER Library，XDM/RD外部表を使用する場合の環境設定

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合は，図4-2に示す手順でDABrokerの環境を設定してください。

ただし，(2)の「ネットワーク環境の設定」については，使用する環境によって設定が必要かどうかが異なります。

図4-2では，環境設定完了後，最初にDABrokerを運用するまでの操作を示しています。

図4‒2　DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合の環境設定の手順

4.1.3　環境設定方法

環境設定はDABrokerが提供するユティリティを使用します。環境設定で使用するユティリティは，環境設定ユティリティ，接続先データベース定義ユティリティ，及びコネクションマルチ定義ユティリティです。

これらユティリティの詳細については，「4.4　DABroker環境設定」，「4.5　DABroker環境設定項目」，「4.6　DABroker接続先データベース定義」，及び「4.7　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」を参照してください。

4.2　DABrokerのインストール

ここでは，DABrokerのインストール操作について説明します。

4.2.1　DABrokerをインストールするマシン

使用するデータベースによって，DABrokerをインストールできるマシンが決まります。DABrokerをインストールするマシンについて，使用するデータベースごとに説明します。

HiRDB，ORACLEなどにアクセスする場合

HiRDB，ORACLE，又はSQL Serverにアクセスする場合，DABrokerは，DBMSのサーバプログラム，又はDBMSのクライアントプログラムがインストールされたマシンにインストールしてください。なお，「1.2　DABrokerの使用環境」では，DABrokerをDBMSのサーバプログラムがインストールされたマシンにインストールする形態を示しています。

Database Connection Serverを使ってメインフレーム系データベースにアクセスする場合

DABrokerは，任意のサーバマシン（Windowsで動作しているパーソナルコンピュータ）にインストールしてください。

4.2.2　インストール

DABrokerのインストールは，日立総合インストーラを使用して行います。

インストールを実行すると，ダイアログボックスが表示されますので，ガイダンスに従ってください。

Administratorsグループのメンバーであるユーザアカウントでログオンする。

日立総合インストーラを使用して，DABrokerのインストールを開始する。

［ようこそ］ダイアログボックスが表示されるので，［次へ］を選択します。

ユーザ情報を設定する。

［ユーザの情報］ダイアログボックスでインストールするユーザの個人名と会社名を入力します。

インストール先ディレクトリを指定する。

［インストール先のディレクトリ］ダイアログボックスでインストール先ディレクトリを指定します。標準のインストールディレクトリは

＜システムドライブ＞：¥Program Files¥HITACHI¥DABrokerです。ここにインストールしない場合は，参照ボタンをクリックしてインストール先ディレクトリを指定してください。ただし，ネットワークドライブにはDABrokerを組み込めません。インストール先ディレクトリがない場合，ディレクトリを作成するかどうかのダイアログボックスが表示されます。

インストールを完了する。

［完了］ボタンをクリックしてインストールを完了します。なお，システムファイルを上書きする場合，即時にシステムを再起動するかを問い合わせます。再起動しなかった場合は，DABrokerの動作を保証できませんので，必ず再起動してから使用してください。

環境変数を設定する。

DABrokerをインストール後，システム環境変数のPathに”DABrokerインストールディレクトリ¥lib”を必ず設定してください。設定しなかった場合は，各ユティリティが使用できません。

4.2.3　DABrokerのファイル

(1)　インストール時に作成されるディレクトリ

DABrokerのインストール時に，指定したディレクトリに作成されるディレクトリを表4-1に示します。

なお，インストール先に指定したディレクトリをこれ以降，DABroker運用ディレクトリと呼びます。

表4‒1　DABrokerのディレクトリ

ディレクトリ

説　　明

DABroker

−

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

¥bin

実行ファイル格納ディレクトリ

¥lib

ライブラリ格納用ディレクトリ

¥AGT

エージェント処理用ディレクトリ

¥AGTGRP

グループ管理用ディレクトリ

¥msg

メッセージ用ディレクトリ

¥conf

DABroker動作環境定義ファイル格納ディレクトリ

¥spool

DABrokerスプールディレクトリ

¥tmp

DABroker標準作業ディレクトリ

¥patch_dab

修正パッチ格納ディレクトリ

4.3　ネットワーク環境の設定

ここでは，DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合に，[Windowsインストールディレクトリ]¥SYSTEM32¥DRIVERS¥ETC¥SERVICESファイルに設定するDABrokerのサービス名及びポート番号について説明します。

また，Database Connection Serverとの接続にサービス名を使用する場合の，[Windowsインストールディレクトリ]¥SYSTEM32¥DRIVERS¥ETC¥SERVICESファイルでの設定方法について説明します。

4.3.1　DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合，[Windowsインストールディレクトリ]¥SYSTEM32¥DRIVERS¥ETC¥SERVICESファイルに，TCP/IP環境でのDABrokerのサービス名及びポート番号として，次の記述をファイルの行末に追加してください。

DABROKER_SV　XXXXX/tcp

DABROKER_SV：DABrokerのサービス名です。

XXXXX：ポート番号です。

tcp：プロトコル名です。TCP/IPを使用することを表します。

注意事項

XXXXXにはDABrokerがオープンするポート番号を指定します。推奨値は40179です。オペレーティングシステムによっては推奨値がエフェメラルポートの範囲にあたるので，問題がある場合は別のポート番号を指定してください。このポート番号とクライアント側のポート番号には同じ値を指定します。

NIS（Network Information Service）を使用している場合，ネットワーク環境をNISのサーバで設定してください。NISのサーバを使用している場合，ネットワーク環境の設定は，NISのサーバでの設定が有効になります。

クライアント側では，使用する通信ドライバに，DABrokerの組み込まれたサーバのホスト名，IPアドレス及びポート番号を登録してください。

Windowsファイアウォールが有効になっていないか確認し，有効になっている場合はDABrokerを使用する前に，DABrokerのサービスポートをWindowsファイアウォールの例外に登録してください。

また，[Windowsインストールディレクトリ]¥SYSTEM32¥DRIVERS¥ETC¥HOSTSファイルにはクライアント側のPC台数分のIPアドレスとホスト名を記述してください。HOSTSファイルはIPアドレスからホスト名への変換オプションが有効な場合（DABroker環境設定項目のDABIPCONVERTにONを指定した場合）に参照します。HOSTSファイルについては，Windowsのマニュアルを参照してください。

4.3.2　Database Connection Serverを経由してメインフレーム系データベースにアクセスする場合

Database Connection Serverとの接続には，DABrokerでは，Database Connection Serverのポート番号又はサービス名を指定します。ポート番号又はサービス名は，コネクションマルチ定義（「4.7　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」参照）又は環境設定のDatabase Connection Server接続設定（「4.5.3　Database Connection Server接続設定」参照）で指定します。このとき，サービス名を指定する場合は，[Windowsインストールディレクトリ]¥SYSTEM32¥DRIVERS¥ETC¥SERVICESファイルに，サービス名とそれに対応するポート番号を設定してください。Database Connection Serverとの接続にポート番号を使用する場合は，ここでの設定は不要です。

例えば，ポート番号（接続するDatabase Connection Serverのサーバ空間のポート番号(サーバスケジュール番号)）が40179に対して，サービス名：DBCSVを設定する場合は，次の記述をファイルの行末に追加します。

DBCSV　40179/tcp

注意事項

サービス名には，任意の名称が設定できます。

ここで設定したサービス名を，DABroker動作環境定義（「4.5.3　Database Connection Server接続設定」参照），コネクションマルチ定義（「4.7　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」参照）で指定してください。

ポート番号は，Database Connection Serverのサーバ空間のポート番号(サーバスケジュール番号)にしてください。

Windowsファイアウォールが有効になっていないか確認し，有効になっている場合はDABrokerを使用する前に，DABrokerのサービスポートをWindowsファイアウォールの例外に登録してください。

また，[Windowsインストールディレクトリ]¥SYSTEM32¥DRIVERS¥ETC¥HOSTSファイルには接続するDatabase Connection ServerのIPアドレスとホスト名を記述してください。HOSTSファイルはIPアドレスからホスト名への変換オプションが有効な場合（DABroker環境設定項目のDABIPCONVERTにONを指定した場合）に参照します。HOSTSファイルについては，Windowsのマニュアルを参照してください。

4.4　DABroker環境設定

システム構成に合わせたDABrokerの動作環境を，環境設定ユティリティを使って設定してください。環境設定ユティリティは，DABroker動作環境定義ファイル：［DABroker運用ディレクトリ¥conf］にdasysconfを作成します。ここでは，環境設定ユティリティの操作方法について説明します。

4.4.1　環境設定ユティリティの操作

環境設定ユティリティは，プログラムフォルダに登録された［DABroker環境設定］から起動します。

(1)　操作できるユーザ

環境設定ユティリティを実行して，DABroker動作環境定義ファイルを操作できるのは，WindowsのAdministratorsグループに属するユーザだけです。

(2)　操作方法

環境設定ユティリティは，DABrokerが終了している状態で使用します。次回起動時に，変更したDABroker動作環境定義ファイルの内容が有効になります。

操作方法を次に示します。

プログラムフォルダに登録された［環境設定］を起動する。

環境設定ユティリティが起動し，［DABroker動作環境設定］ダイアログボックスが表示されます。

項目を設定する。

設定する項目については，「4.5　DABroker環境設定項目」を参照してください。

設定内容を確認して［OK］ボタンを選択する。

変更した内容が有効になり，環境設定ユティリティは終了します。

4.5　DABroker環境設定項目

環境設定ユティリティで操作できる項目には次の種類があります。

共通設定の項目

リモートアクセス，ローカルアクセスのどちらでデータベースにアクセスする場合でも共通に設定する項目です。

DABroker for Java Version 2からDABrokerにローカルアクセスする場合は，リモートアクセス設定で設定する次の項目についても有効になります。

HiRDBのBLOB型データ受取バッファサイズ

ORACLEのLONG型データ受取バッファサイズ

ODBC3.0のLONG型データ受取バッファサイズ

Database Connection ServerのBLOB型データ受取バッファサイズ

これらの項目の設定方法については，「4.5.2　リモートアクセス設定」を参照してください。

リモートアクセス設定の項目

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合に，［共通設定］タブで設定した項目以外に設定できる項目です。

Database Connection Server接続設定

Database Connection Serverを経由してメインフレーム系データベースにアクセスする場合に設定する項目です。

ここで示す標準値は，DABroker環境設定ユティリティ起動時に，あらかじめ表示されている値です。

4.5.1　共通設定の項目

(1)　作業ディレクトリ名（DABTMP）

標準値

DABroker運用ディレクトリ¥tmp

指定範囲

任意のディレクトリ（ただし，パーティションを圧迫しないところ）。ただし，ネットワークドライブ上のディレクトリは指定できません。また，指定したディレクトリのアクセス権限として，システムにフルコントロールを指定してください。

説明

DABrokerの作業ディレクトリを指定します。このディレクトリは，予約処理用のSQLの格納や，処理途中で作成される一時ファイルの格納などに使用されます。

［...］ボタンを押すと，［ディレクトリ選択］ダイアログボックスが表示されます。

(2)　データベースアクセス処理終了待ちタイムアウト（DABDBA_TIMEOUT）

標準値

1800（秒）

指定範囲

0，又は1〜65535（秒）

説明

データベースアクセス処理の終了待ちタイムアウトを監視するかどうかを設定します。Database Connection Serverにアクセスする場合だけ有効です。

1〜65535（秒）を設定した場合

DABrokerがデータベースアクセス処理を開始してから終了するまでの時間を監視します。

ここで設定した時間を超えてもデータベースアクセス処理が終了しない場合，DABrokerは次の処理をします。

クライアントに対しては，終了待ちタイムアウトの発生を通知して，コネクションを解放します。処理を続ける場合，クライアントは一度終了して再起動する必要があります。

データベースに対しては，データベースを切り離します。データベースでの処理はDBMSによってロールバックされます。

0を設定した場合

データベースアクセス処理の終了待ちタイムアウトを監視しません。

(3)　表検索カラム数（DABSELECTCOLCNT）

標準値

0

指定範囲

0，又は1〜2147483647

説明

表検索用の領域として確保する表カラムの個数を指定します。

0を設定した場合

DBMSに対して表カラムの個数を要求するSQLを発行します。DBMSから返された結果を基に，表検索用の領域を確保します。SQL Anywhere使用時は常に0を仮定します。

1〜2147483647を設定した場合

表カラムの個数が指定した値より少ない場合，DBMSに対して表カラムの個数を要求するSQLを発行しません。このため，SQLを発行する場合より処理性能が向上します。ただし，検索を実行するたびに次に示す大きさのメモリが必要になるため，動作環境を考慮して値を設定してください。よく検索する表のカラム数を大きく超える値を設定した場合，性能劣化の原因になることがあります。

HiRDB，ORACLEの場合：1カラム当たり128バイト

表カラムの個数が指定した値より多い場合，DBMSに対して表カラムの個数を要求するSQLを発行します。DBMSから返された結果を基に，表検索用の領域を確保します。

(4)　更新・検索項目数（DABSELECTINFCNT）

標準値

0

指定範囲

0，又は1〜2147483647

説明

表の更新・検索用の領域として確保する，入力項目（パラメタ）の個数を指定します。

0を設定した場合

DBMSに対して入力項目の個数を要求するSQLを発行します。DBMSから返された結果を基に，表の更新・検索用の領域を確保します。SQL Anywhere使用時は常に0を仮定します。

1〜2147483647を設定した場合

入力項目の個数が指定した値より少ない場合，DBMSに対して入力項目の個数を要求するSQLを発行しません。このため，SQLを発行する場合より処理性能が向上します。ただし，更新・検索を実行するたびに次に示す大きさのメモリが必要になるため，動作環境を考慮して値を設定してください。よく更新・検索する表の入力項目の個数を大きく超える値を設定した場合，性能劣化の原因になることがあります。

HiRDB，ORACLEの場合：1カラム当たり128バイト

入力項目の個数が指定した値より多い場合，DBMSに対して入力項目の個数を要求するSQLを発行します。DBMSから返された結果を基に，表の更新・検索用の領域を確保します。

(5)　ログファイルサイズ［dabsv.log］（DABSVLOGSIZE）

標準値

64（キロバイト）

指定範囲

0，又は64〜32767（キロバイト）

説明

DABrokerのログを取得するファイルの容量を設定します。ログはDABroker運用ディレクトリ¥spool¥dabsv.log，および¥spool¥dabsvdemon.logに取得されます。

0を設定した場合

ファイルの容量は無限大になります。

64〜32767を設定した場合

設定した値がファイルの容量になります。

注意事項

ログファイルが満杯になったら，ラップアラウンドでログを取得します。ラップアラウンドした場合，１世代前のバックアップファイル（dabsv.logold,dabsvdemon.logold）を作成し，１世代だけを管理します。

(6)　使用するORACLEのバージョン（DABORACLE_TYPE）

標準値

ORACLE10g

指定範囲

ORACLE10g，ORACLE11g，ORACLE12c又はORACLE19c

説明

使用するORACLEのバージョンを設定します。

(7)　HiRDBのディクショナリ表のデータ属性（DABSQL_HiRDB_DICTIONARY_DATATYPE）

標準値

C：VARCHAR

指定範囲

M又はC

説明

HiRDBのディクショナリ表の列属性を指定します。

Mを設定した場合

混在文字データ（MVARCHAR）として処理します。

Cを設定した場合

文字データ（VARCHAR）として処理します。

注意事項

ここでの指定とHiRDBで使用されているディクショナリ表のデータ属性が異なる場合は，結果不正やSQLエラーになる場合があります。

(8)　HiRDB環境変数区切り文字（DAB_HIRDB_DBINF_ESC）

標準値

@

指定範囲

@　!　$　%　&　*　+　-　/　:　?　¥　|

説明

HiRDB環境変数区切り文字を指定します。

注意事項

特に問題がない場合，区切り文字には@を使用してください。

区切り文字は必ず半角1文字で指定してください。全角文字は指定できません。

DABroker for JavaからHiRDBクライアント環境変数グループを指定してデータベースと接続する場合は，@を使用してください。

(9)　データベースアクセストレースの取得（DABSQL_TRCSIZE）

標準値

取得しない

指定範囲

取得しない又は取得する

説明

データベースアクセストレースを取得するかどうかを設定します。アクセストレースの出力については，「4.9.2　DABrokerトレース出力ユティリティの実行」を参照してください。

［データベースアクセストレース設定］ボタンを押すと［アクセストレース設定］ダイアログボックスが表示され，アクセストレースで出力する項目を選択できます。出力できる項目の詳細については，「6.5.1　アクセストレース設定」を参照してください。

取得するを設定した場合

次に示すファイル名ですべてのアクセストレースを取得するファイルが，DABroker運用ディレクトリ¥spool¥db_accessの下に作成されます（データベースアクセストレースはDABrokerトレース出力ユティリティで出力します）。

db_XXXXX

XXXXX：システム任意の番号。

ハードディスクの空き容量がなくなった場合，それ以降のアクセストレースは取得しません。なお，格納する領域のサイズは設定できません。

クライアントからの要求量が多い場合は，トレースのファイル容量も多く必要です。ハードディスクの容量に余裕をもたせてください。必要容量の概算方法については，「4.9.2(3)　データベースアクセストレースの出力方法」のデータベースアクセストレースの出力の注意事項を参照してください。また，クライアントからの要求量が多ければ，DABrokerを終了するまでに時間がかかります。御注意ください。

取得しないを設定した場合

データベースアクセストレースを取得しません。

(10)　拡張データベースアクセストレースを取得する（DABEXSQL_TRC_LINE）

標準値

OFF（取得しません）

指定範囲

OFF（チェックなし）又はON（チェックあり）

（OFF：取得しません　ON：取得します）

説明

拡張データベースアクセストレースを取得するかどうかを設定します。

OFF（チェックなし）を設定した場合

拡張データベースアクセストレースを取得しません。

ON（チェックあり）を設定した場合

拡張データベースアクセストレースを取得します。出力行数の指定については，「4.5.1(11)　トレースファイルサイズ」を参照してください。

拡張データベースアクセストレースの詳細については，「6.5.2　拡張データベースアクセストレース機能」を参照してください。

(11)　トレースファイルサイズ

標準値

1024（行）

指定範囲

0（トレース取得行数を無限大にします），又は1024〜32767（行）

説明

「4.5.1(10)　拡張データベースアクセストレースを取得する（DABEXSQL_TRC_LINE）」でONを設定した場合に，拡張データベースアクセストレースのトレースファイルサイズを指定します。

0を設定した場合

出力行数は，無限大となります。

1024〜32767を設定した場合

拡張データベースアクセストレースを取得します。出力行数は，設定した数値分となります。

拡張データベースアクセストレースのファイルは，1行に134バイトまで出力されます。拡張データベースアクセストレースのファイルの出力行数は，ここでの設定値に従います。ただし，ヘッダは行数に含まれません。

拡張データベースアクセストレースの詳細については，「6.5.2　拡張データベースアクセストレース機能」を参照してください。

(12)　XAトレースを取得する（DABXA_LOG_ERROR）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

XAインタフェースでエラーを検知した場合，エラートレースを取得するかどうかを設定します。

XAトレースは，DABroker運用ディレクトリ下のspoolディレクトリにdb_xainfo.logというファイル名で取得されます。XAトレースファイル(db_xainfo.log)はテキスト形式なので，任意のテキストエディタで参照してください。

XAトレースファイルは，運用期間に応じてファイルサイズが増加するため，定期的に削除する必要があります。

4.5.2　リモートアクセス設定

(1)　クライアントからの要求待ちタイムアウト（DABCLIENT_TIMEOUT）

標準値　

3600（秒）

指定範囲

0，又は1〜65535（秒）

説明

クライアントからの要求待ちタイムアウトを監視するかどうかを設定します。

1〜65535（秒）を設定した場合

DABrokerがアクセス要求に対する応答をクライアントに返してから，次のアクセス要求を受けるまでの時間を監視します。

ここで設定した時間を超えてクライアントからのアクセス要求がない場合，DABrokerは次の処理をします。

クライアントに対しては，要求待ちタイムアウトの発生を通知して，コネクションを解放します。処理を続ける場合，クライアントは一度終了して再起動する必要があります。

データベースに対しては，このタイムアウトが発生したクライアントの処理がデータベースで実行中の場合は，トランザクションのロールバックを要求し，データベースを切り離します。

0を設定した場合

クライアントからの要求待ちタイムアウトを監視しません。

(2)　最大接続ユーザ数（DABMAXUSERS）

標準値

10（ユーザ）

指定範囲

1〜100000（ユーザ）

説明

コネクションを確立できる最大ユーザ数を設定します。ここで設定した値を超えるユーザが接続しようとした場合，DABrokerは，クライアントにエラーメッセージを返してコネクションを確立しません。

(3)　同時実行可能なデータベースアクセス数（DABDBANUMBER）

標準値

20（データベース接続数）

指定範囲

1〜100000（データベース接続数）

説明

DABrokerが一度に受け付けられる，複数のクライアントからのデータベースアクセス要求の合計数を設定します。ここで設定した値を超える要求があった場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

(4)　1プロセスあたりの実行ユーザ数（DABMAXBLOCKUSERS）

標準値

1（ユーザ数）

指定範囲

1〜100（ユーザ数）

ORACLEを使用する場合は1を指定してください。

説明

一つのプロセスで処理する最大ユーザ数を設定します。ここで設定した値を超えた場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

ORACLEを使用する場合は，必ず1を指定してください。1以外を指定した場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

Database Connection Serverにアクセスする場合，接続先データベース定義のデータベース種別を複数使用するときは，必ず1を指定してください。

注意事項

DABrokerのデーモンプロセスが，サーバのメモリ又はキャッシュメモリ上で動作するように適切な値を設定してください。

(5)　最大処理プロセス数（DABMAXPROCESS）

標準値

10（プロセス数）

指定範囲

1〜1000（プロセス数）

説明

DABrokerで起動する最大プロセス数を設定します。ここで設定した値を超えた場合は，クライアントにエラーメッセージを返し，処理を受け付けません。

注意事項

不要なデーモンプロセスの起動を制限するために適切な値を設定してください。

(6)　HiRDBのBLOB型データ受取バッファサイズ（DABHIRDBA_BLOBBUFSIZE）

標準値

4096（バイト）

指定範囲

0，又は1〜2147483647（バイト）

説明

HiRDBからBLOB型データを抽出する場合の受け取りサイズを指定します。

このデータ型の場合，HiRDBでは最大2147483647バイトのデータの存在が考えられますが，DABrokerではここで指定した値までのデータを受け取り，以降のデータは切り捨てます。

0を指定した場合，DBMSの定義長分の領域長を仮定します。ただし，実際に格納されているデータの大きさにかかわらず，無条件に定義長分の領域が確保されるため，メモリ効率が悪くなることがあります。格納されているデータの最大長が分かっている場合は，その値を指定することをお勧めします。

この項目は，DABroker for Java Version 2でDABrokerにローカルアクセスした場合にも有効となります。

(7)　ORACLEのLONG型データ受取バッファサイズ（DABORADBA_LONGBUFSIZE）

標準値

4096（バイト）

指定範囲

0，又は1〜2147483647（バイト）

説明

ORACLEから，LONG型データを抽出する場合の受け取りサイズを指定します。

このデータ型の場合，ORACLEでは最大2147483647バイトのデータの存在が考えられますが，DABrokerではここで指定した値までのデータを受け取り，以降のデータは切り捨てます。

0を指定した場合，DBMSの定義長分の領域長を仮定します。ただし，実際に格納されているデータの大きさにかかわらず，無条件に定義長分の領域が確保されるため，メモリ効率が悪くなることがあります。格納されているデータの最大長が分かっている場合は，その値を指定することをお勧めします。

この項目は，DABroker for Java Version 2でDABrokerにローカルアクセスした場合にも有効となります。

この項目は，DABroker for Java Version 2でデータベース種別にOracle8iを設定している場合は設定しません。

(8)　ODBC3.0のLONG型データ受取バッファサイズ（DABODBC30_LONGBUFSIZE）

標準値

4096（バイト）

指定範囲

0，又は1〜2147483647（バイト）

説明

ODBC3.0で接続したデータベースからLONG型データを抽出する場合の受け取りサイズを指定します。

このデータ型の場合，最大2147483647バイトのデータの存在が考えられますが，DABrokerではここで指定した値までのデータを受け取り，以降のデータは切り捨てます。

0を指定した場合，DBMSの定義長分の領域長を仮定します。ただし，実際に格納されているデータの大きさにかかわらず，無条件に定義長分の領域が確保されるため，メモリ効率が悪くなることがあります。格納されているデータの最大長が分かっている場合は，その値を指定することをお勧めします。

この項目は，DABroker for Java Version 2でDABrokerにローカルアクセスした場合にも有効となります。

(9)　Database Connection ServerのBLOB型データ受取バッファサイズ（DABDBSDBA_BLOBBUFSIZE）

標準値

4096（バイト）

指定範囲

0，又は1〜2147483647（バイト）

説明

Database Connection Serverで接続したデータベースからBLOB型データを抽出する場合の受け取りサイズを指定します。

このデータ型の場合，最大2147483647バイトのデータの存在が考えられますが，DABrokerではここで指定した値までのデータを受け取り，以降のデータは切り捨てます。

0を指定した場合，DBMSの定義長分の領域長を仮定します。ただし，実際に格納されているデータの大きさにかかわらず，無条件に定義長分の領域が確保されるため，メモリ効率が悪くなることがあります。格納されているデータの最大長が分かっている場合は，その値を指定することをお勧めします。

この項目は，DABroker for Java Version 2でDABrokerにローカルアクセスした場合にも有効となります。

(10)　漢字コードセット（DABLANGMODE）

標準値

SJIS（シフトJISモード）

指定範囲

SJIS（シフトJISモード），EUC（日本語EUCモード），ASCII（ASCIIモード），又はUTF-8（UTF-8モード）

説明

DABrokerが稼働する言語モードを設定します。

各言語モードで操作できるデータベースを表4-2に示します。

表4‒2　各言語モードで操作できるデータベース

データベース

DABrokerでの設定

シフトJISモード

日本語EUC

モード

ASCIIモード

UTF-8モード

HiRDB

○

○

○

○

ORACLE

○

○

○

○

SQL Server

○

×

○

×

VOS3 XDM/RD

○

×

○

×

VOS3 XDM/SD

○

×

○

×

VOS1 RDB1 E2

○

×

○

×

VOSK SQL/K

○

×

○

×

VOS1 PDMII E2

○

×

○

×

VOSK スプールファイル

○

×

○

×

凡例

○：操作できる

×：操作できない

各データベースで使用する言語モードは，必ずDABrokerの言語モードと合わせてください。データベースとDABrokerの言語モードが異なっている場合は動作を保証しません。

クライアントがDABroker for Javaの場合は，DAB_LANGの指定がJDBCの文字エンコーディングに影響します。詳細については，マニュアル「DABroker for JavaTM Version 2　DABroker Driver for JavaTM Technology」の「接続するデータベースの指定」のENCODELANGの説明を参照してください。

DABrokerを日本語EUCモード，ASCIIモード，又はUTF-8モードで動作させた場合，メッセージは英文で出力されます。メッセージの詳細については，「7.　メッセージ（共通）」を参照してください。

(11)　TCP/IP通信時キープアライブ（DABKEEPALIVE）

標準値

OFF

指定範囲

ON又はOFF（ON：キープアライブによる監視を行います

OFF：キープアライブによる監視を行いません）

説明

キープアライブによる監視を行うかどうかを設定します。キープアライブとは，クライアントとの通信経路が確立されているかどうかを常に監視するTCP/IPの機能です。

ONを設定した場合

キープアライブによる監視が行われます（クライアントとの通信径路を監視する）。

OFFを設定した場合

キープアライブによる監視は行われません（クライアントとの通信径路を監視しない）。

(12)　IPアドレスからホスト名への変換オプション（DABIPCONVERT）

標準値

ON

指定範囲

ON又はOFF

説明

メッセージ及びユティリティで表示されるIPアドレスをホスト名に変換するかどうかを設定します。

ONを設定した場合

表示されるIPアドレスをホスト名に変換します。

動作環境によってこの変換処理に時間がかかり，接続処理が遅くなることがあります。

OFFを設定した場合

表示されるIPアドレスをホスト名に変換しません。

(13)　通信トレースの取得（DABTCP_TRCSIZE）

標準値

取得しない

指定範囲

取得しない又は取得する

説明

クライアントとの通信トレースを取得するかどうかを設定します。通信トレースの出力については，「4.9.2　DABrokerトレース出力ユティリティの実行」を参照してください。

「取得する」を設定した場合

次に示すファイル名ですべての通信トレースを取得するファイルがDABroker運用ディレクトリ¥spool¥dabcltrcの下に作成されます（通信トレースはDABrokerトレース出力ユティリティで出力します）。

XXXXXXXX.cmt

XXXXXXXX.cmt_AA〜AA

XXXXXXXX：任意の文字列。

AA〜AA：任意の文字列。

ハードディスクの空き容量がなくなった場合，それ以降の通信トレースは取得しません。なお，格納するファイルサイズは設定できません。

クライアントからの要求量が多い場合は，トレースのファイルの容量も多く必要です。ハードディスクの容量は余裕を持たせてください。必要容量の概算方法については「4.9.2(2)　クライアントとの通信トレースの出力方法」で通信トレースの出力の注意事項を参照してください。また，クライアントからの要求量が多ければ，DABrokerを終了するまでに時間がかかります。御注意ください。

取得しないを設定した場合

クライアントとの通信トレースを取得しません。

4.5.3　Database Connection Server接続設定

ここでは，Database Connection Serverに接続するときの接続情報の指定を，接続先データベース定義，コネクションマルチ定義で省略した場合に仮定される値を設定します。

(1)　接続先ホスト名またはIPアドレス（DAB_DBS_HOST）

標準値

localhost

説明

接続するDatabase Connection Serverのホスト名，又はIPアドレスを設定します。

(2)　接続先サービス名またはポート番号（DAB_DBS_PORT）

標準値

0

説明

接続するDatabase Connection Serverのサービス名又はポート番号を設定します。

サービス名を指定する場合は，[Windowsインストールディレクトリ]¥SYSTEM32¥DRIVERS¥ETC¥SERVICESファイルにサービス名とそれに対応するポート番号を設定してください（「4.3.2　Database Connection Serverを経由してメインフレーム系データベースにアクセスする場合」参照）。

(3)　送信バッファサイズ（DAB_DBS_SEND_BUFFER_SIZE）

標準値

64（キロバイト）

指定範囲

64〜2097151（キロバイト）

説明

Database Connection Serverに送信するときの最大バッファサイズを設定します。

(4)　受信バッファサイズ（DAB_DBS_RECEIVE_BUFFER_SIZE）

標準値

64（キロバイト）

指定範囲

64〜2097151（キロバイト）

説明

Database Connection Serverから受信するときの最大バッファサイズを設定します。

4.5.4　その他の設定

その他の設定は，DABroker動作環境定義のOTHERS節に指定します。

DABroker動作環境定義ファイル（dasysconf）はDABroker運用ディレクトリ¥confに格納されています。

(1)　DAB_DEMON_LOG_MODE（デーモンの生成・消滅・クリーンアップ実行結果ログ抑止）

標準値

なし

指定範囲

LIMITED

説明

デーモンの生成・消滅・クリーンアップ実行結果ログの出力によりディスクを圧迫したくない場合に指定します。

デーモンの生成・消滅・クリーンアップ実行結果ログは，本指定をしない限り，標準で出力されます。

デーモンの生成・消滅・クリーンアップ実行結果ログについては，「6.3.2　デーモンの生成・消滅・クリーンアップ実行結果ログ（共通）」を参照してください。

4.6　DABroker接続先データベース定義

DABroker for ODBCで開発するアプリケーションは，接続先データベース定義ユティリティで設定したデータベース種別名，及びデータベース名を使用してデータベースにアクセスします。また，DBPARTNER，及びDABroker for Javaでも，Database Connection Server経由でデータベースにアクセスする場合は，接続先データベース定義ユティリティで設定した情報を使用してDatabase Connection Serverに接続します。接続先データベース定義ユティリティで設定した情報を使用すると，接続条件などが変更されてもアプリケーションを変更する必要がありません。ただし，OTS機能，又はJava JTS機能を使用する場合は，接続先データベース定義ユティリティで設定した情報を使用できません。

4.6.1　接続先データベース定義ユティリティの操作

接続先データベース定義ユティリティは，プログラムフォルダに登録された［DABroker接続先データベース定義］から起動します。

接続先データベース定義ユティリティで設定した内容は，接続先データベース定義ファイル：[DABroker運用ディレクトリ¥conf¥dabenv]に出力されます。

(1)　操作できるユーザ

Administratorsグループに属するユーザ

(2)　操作方法

プログラムフォルダに登録された［接続先データベース定義］を起動する。

DABroker接続先データベース定義ユティリティが起動し，［接続先データベース定義］ダイアログボックスが表示されます。

使用するデータベースの製品名が記載されたタブを選択し，接続情報を設定する。

次の情報を定義します。

データベース種別名：使用するデータベースに対して付ける任意名称

データベース名：データベースごとに異なる情報の集まりに対して付ける任意名称

データベース名のグループに定義する情報：データベース名のグループに定義する情報は，データベースごとに異なります。定義項目については，「4.6.2　設定する項目」を参照してください。

これらの情報は，次のような親子関係になります。

例）

この例で示すように，データベース名は，同一データベース種別名に対して，複数定義できます。例えば，ホスト名が異なる二つのHiRDBを，一つのデータベース種別として定義し，アプリケーションでは，データベース名でホストの異なるHiRDBを使い分けられます。

<設定方法>

データベース種別名，データベース名を新規登録する場合

設定後，［追加］ボタンを選択します。

同一データベース種別名に対して，別のデータベース名を登録する場合

設定後，［追加］ボタンを選択します。

登録されている情報を変更する場合

登録内容を変更した後，［追加］ボタンを選択します。

データベース種別名又はデータベース名を削除する場合

削除するデータベース種別又はデータベース名を選択して［削除］ボタンを選択してください。

4.6.2　設定する項目

データベースごとに設定する項目について説明します。

(1)　HiRDBを使用する場合

設定項目名

指定内容

データベース種別名

使用するデータベースに対して付ける任意名称

<設定規則>

接続先データベース定義ユティリティ内でユニークな名称にしてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

データベース名

データベースごとに異なる情報の集まりに対して付ける任意名称

<設定規則>

同一データベース種別名内でユニークな名称にしてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

接続先ホスト名

(DBHOST)

HiRDBのホスト名

接続先ポート番号

(DBNAME)

ポート番号

ユーザID(USERID)

接続ユーザID※

パスワード(PASSWD)

パスワード※

環境変数

HiRDBクライアントへ渡す環境変数を，下のテキストボックスに指定します。

HiRDB使用時に指定できる環境変数の詳細については，HiRDBのマニュアルを参照してください。

<設定規則>

1024文字まで指定できます。

2バイト文字，及び半角の片仮名は使用しないでください。

各環境変数の先頭に，必ず区切り文字（@）を記述してください。

PDHOST（ホスト名称，又はIPアドレス），及びPDNAMEPORT（接続するポート番号）は，先頭か末尾で必ず指定します。

PDHOST，及びPDNAMEPORTは，重複して指定しないでください。

PDHOST，及びPDNAMEPORT以外の環境変数は，DABrokerで設定した値をそのまま使えます。

DABrokerでは，指定した環境変数の妥当性はチェックしません。

環境変数グループ

HiRDBクライアントへ渡す環境変数グループ名を，下のテキストボックスで指定します。

環境変数グループの名称や，環境変数グループで指定できる内容の詳細については，HiRDBのマニュアルを参照してください。

<設定規則>

30文字まで指定できます。

2バイト文字，及び半角の片仮名は使用しないでください。

DABrokerでは，指定した環境変数グループが有効かどうかはチェックしません。

注※

アプリケーションでユーザID，パスワードの指定のない場合にここで指定されたユーザID，パスワードを使用してデータベースにアクセスします。また，DABrokerでは，接続先データベース定義ファイル出力時にパスワードを暗号化しないため，必要がない場合，パスワードはアプリケーション側で指定してください。

(2)　ORACLEを使用する場合

設定項目名

指定内容

データベース種別名

使用するデータベースに対して付ける任意名称

<設定規則>

接続先データベース定義ユティリティ内でユニークな名称にしてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

データベース名

データベースごとに異なる情報の集まりに対して付ける任意名称

<設定規則>

同一データベース種別名内でユニークな名称にしてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

リスナー名

(DBNAME)

SQL*NET経由でアクセスするORACLEのリスナー名称

ただし，リモートアクセスしない場合は省略します。

ユーザID(USERID)

接続ユーザID※

パスワード(PASSWD)

パスワード※

注※

アプリケーションでユーザID，パスワードの指定のない場合にここで指定されたユーザID，パスワードを使用してデータベースにアクセスします。また，DABrokerでは接続先データベース定義ファイル出力時にパスワードを暗号化しないため，必要がない場合はパスワードはアプリケーション側で指定してください。

(3)　ODBC3.0を使用する場合

設定項目名

指定内容

データベース種別名

使用するデータベースに対して付ける任意名称

<設定規則>

接続先データベース定義ユティリティ内でユニークな名称にしてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

データベース名

データベースごとに異なる情報の集まりに対して付ける任意名称

<設定規則>

同一データベース種別名内でユニークな名称にしてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

データベース

SQLServer：SQL Server

接続情報(DBHOST)

ODBC3.0に渡す接続情報

接続情報のキーワードは ;（セミコロン）で区切ります。

ODBCのデータソース名(DBNAME)

ODBC3.0のデータソース名

ユーザID(USERID)

接続ユーザID※

パスワード(PASSWD)

パスワード※

注※

アプリケーションでユーザID，パスワードの指定のない場合にここで指定されたユーザID，パスワードを使用してデータベースにアクセスします。また，DABrokerでは接続先データベース定義ファイル出力時にパスワードを暗号化しないため，必要がない場合はパスワードはアプリケーション側で指定してください。

(4)　Database Connection Server経由でメインフレーム系データベースを使用する場合

設定項目名

指定内容

データベース種別名

使用するデータベースに対して付ける任意名称

<設定規則>

接続先データベース定義ユティリティ内でユニークな名称にしてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

データベース名

データベースごとに異なる情報の集まりに対して付ける任意名称

<設定規則>

同一データベース種別名内でユニークな名称にしてください。23文字まで指定できます。2バイト文字，半角カタカナ文字は使用しないでください。

データベース

次のどれかを選択します。

XDM/RD：VOS3 XDM/RD

XDM/SD：VOS3 XDM/SD

SQL/K：VOSK SQL/K

VOSKSPOOL：VOSK スプールファイル

RDB1：VOS1 RDB1 E2

VOS1PDM2：VOS1 PDMII E2

使用するアプリケーション開発用インタフェースによって，アクセスできるデータベースが異なります。詳細については，各DABroker関連製品，又はDBPARTNERのマニュアルを参照してください。

コネクションマルチ名

(DBHOST)

コネクションマルチ名

コネクションマルチ定義ユティリティ（「4.7　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」参照）で設定したコネクションマルチ名を指定してください。

分散定義名(DBNAME)

分散定義名称

接続するDatabase Connection Serverのデータベース識別子（RDノード名称）

ユーザID(USERID)

接続ユーザID※

パスワード(PASSWD)

パスワード※

送信バッファサイズ

(SNDBUF)

Database Connection Server側へ送信するデータバッファのサイズ(64〜2097151キロバイト)

なお，ここでの指定を省略した場合又はコネクションマルチ機能（「4.7　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」参照）を使用する場合は，DABroker環境設定ユティリティで設定した値が有効になります。

受信バッファサイズ

(RCVBUF)

Database Connection Server側から受信するデータバッファのサイズ(64〜2097151キロバイト)

なお，ここでの指定を省略した場合又はコネクションマルチ機能（「4.7　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」参照）を使用する場合は，DABroker環境設定ユティリティで設定した値が有効になります。

注※

アプリケーションでユーザID，パスワードの指定のない場合にここで指定されたユーザID，パスワードを使用してデータベースにアクセスします。また，DABrokerでは接続先データベース定義ファイル出力時にパスワードを暗号化しないため，必要がない場合はパスワードはアプリケーション側で指定してください。

(5)　注意事項

接続先データベース定義ユティリティで複数定義したデータベース種別名がユニークでも，実際のデータベース種別が同じ場合，同じプログラムから同時に接続できません。

4.7　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)

Database Connection Serverを経由してメインフレーム系データベースにアクセスする場合，アプリケーション又はDBPARTNERは，接続先データベース定義ユティリティ（「4.6　DABroker接続先データベース定義」参照）に定義されたコネクションマルチ名を使用してアクセスします。コネクションマルチ名とは，接続するDatabase Connection Serverのポート番号やホスト名などを定義した集まりに対して付ける任意名称で，コネクションマルチ定義ユティリティで設定します。

コネクションマルチ定義ユティリティで変更した内容は，DABrokerの場合，コネクションマルチを再起動することで有効になります。アプリケーションの場合は，プロセスを再起動することで有効になります。

ここでは，コネクションマルチ定義ユティリティを使ったコネクションマルチ名の設定方法について説明します。

4.7.1　コネクションマルチ名の設定

一つのコネクションマルチ名には，次の内容を定義します。

Database Connection Serverのホスト名（1）

Database Connection Serverのポート番号又はサービス名（2）

Database Connection Serverからの応答監視時間（3）

最大仮想コネクション数（4）

通信処理プロセス数（5）

プールコネクション数（6）

予約プールコネクション数（7）

図4-3に「コネクションマルチ名」と(1)(2)の指定内容の関係を示します。

図4‒3　指定内容の関係

図4-3で示すように，Database Connection Serverのホスト名（1）には，Database Connection Server及びアクセスするメインフレーム系データベースが存在するホスト名を指定します。この例ではホスト名を指定していますが，IPアドレスを指定することもできます。Database Connection Serverのポート番号又はサービス名には，Database Connection Serverのサーバ空間※に割り当てられているサーバスケジュール番号（マニュアル「Database Connection Server」参照）を設定します。この例ではポート番号を指定していますが，サービス名を指定することもできます。サービス名を指定するときは，[Windowsインストールディレクトリ]¥SYSTEM32¥DRIVERS¥ETC¥SERVICESファイルに，サービス名とそれに対応するポート番号を設定してください（「4.3　ネットワーク環境の設定」参照）。

注※　プロセスに相当するメインフレーム側の処理単位です。

4.7.2　最大仮想コネクション数などを設定するときのガイドライン

最大仮想コネクション数（4），通信処理プロセス数（5），プールコネクション数（6），予約プールコネクション数（7）は，使用環境に合わせた適切な値を設定する必要があります。ここでは，設定するときのガイドラインを説明します。

(1)　DABrokerとDatabase Connection Serverの接続の仕組み

DABrokerとDatabase Connection Serverの接続時，Database Connection Serverでは，TCP/IPコネクションを確立します。1ユーザからのアクセス要求に対して一つのTCP/IPコネクションを確立します（図4-4参照）。

図4‒4　DABrokerとDatabase Connection Serverの接続イメージ(1)

この場合，1TCP/IPコネクションを1ユーザからのアクセス要求だけで使用でき，レスポンス性能が良くなりますが，同時アクセスユーザ数が増えると，TCP/IPコネクションの確立数も多くなりDatabase Connection Serverのメインフレーム側及びDABroker側でのリソース消費量が多くなってしまいます。

そのため，DABrokerでは，一つのTCP/IPコネクションを複数ユーザからのアクセス要求で共有できるように，一つのTCP/IPコネクションのなかで複数のDABroker用のコネクションを確立できるようにしています。一つのTCP/IPコネクションに対して確立するDABroker用のコネクションを仮想コネクションと呼びます。一つのTCP/IPコネクションの中で複数の仮想コネクションを確立するときには，DABrokerでは，通信処理プロセスを起動します。通信処理プロセスは，TCP/IPコネクションごとに起動します。

1TCP/IPコネクションを複数ユーザからのアクセス要求で共有する場合，DABrokerでは，1通信処理プロセス当たりで（＝一つのTCP/IPコネクションに対して）同時に確立できる仮想コネクション数（=最大仮想コネクション数），及びDABroker内で同時に起動できる通信処理プロセス数（=通信処理プロセス数）を決めて運用します。

図4-5に，1TCP/IPコネクションを2ユーザからのアクセス要求で共有する場合（1通信処理プロセス当たりで二つの仮想コネクションを確立する場合）の，DABrokerとDatabase Connection Serverの接続イメージを示します。ここでは，アプリケーション及びDBPARTNERから同時に四つのアクセス要求があり，二つのTCP/IPコネクションで対応しています。DABrokerでは，二つの通信処理プロセスを起動し，それぞれの通信処理プロセスで二つの仮想コネクションを確立しています。このとき，四つのTCP/IPコネクションを使用した場合に比べ，メインフレーム側及びDABroker側の両方でリソース消費量を少なくできます。

DABrokerは，次のタイミングでDatabase Connection Serverに対してTCP/IPコネクションを確立します。

「予約プールコネクション数」が設定されている（>0）場合

DABrokerコネクションマルチ機能起動時に確立します。

「予約プールコネクション数」が設定されていない（=0）場合

最初のユーザアクセス要求時に確立します。

起動中の通信処理プロセスで実行できるユーザ数(「最大仮想コネクション数」)を超えたユーザアクセスが要求された場合

通信処理プロセスを新しく起動して確立します。

(ただし，「通信処理プロセス数」の範囲内)

そして，これらのTCP/IPコネクションを確立する際に，1TCP/IPコネクション上に「最大仮想コネクション数」に設定された数だけ仮想コネクションを予約します。

図4‒5　DABrokerとDatabase Connection Serverの接続イメージ(2)

なお，一つのTCP/IPコネクションに対して一つの仮想コネクションを確立する形態をシングルコネクション（図4-4参照）と呼び，一つのTCP/IPコネクションに対して複数の仮想コネクションを確立する形態をコネクションマルチ（図4-5参照）と呼びます。

(2)　最大仮想コネクション数と通信処理プロセス数の決定

最大仮想コネクション数（4）

次のどちらかの値を設定します。

1TCP/IPコネクションを1ユーザからのアクセス要求だけで使用する場合（シングルコネクション）

最大仮想コネクション数を「1」に設定します。この場合，TCP/IPコネクションを1ユーザからのアクセス要求だけで使用できるためレスポンス性能が良いのですが，複数ユーザからの同時アクセス要求があるときには同時アクセス要求数分のTCP/IPコネクションを確立し，DABroker及びメインフレームでのリソース消費量が多くなります。

1TCP/IPコネクションを複数ユーザからのアクセス要求で共有する場合（コネクションマルチ）

「2以上の値」で，1通信処理プロセス当たりで同時に確立できる仮想コネクション数を設定します。設定値については，下記を参照してください。なお，この場合は，運用時に，コネクションマルチ機能の運用開始ユティリティ（「4.10　コネクションマルチ機能の使用」参照）を実行してください。

通信処理プロセス数（5）

DABrokerで同時に起動できる通信処理プロセス数の最大値を設定します。設定値については，下記を参照してください。なお，最大仮想コネクション数が「1」の場合は，設定する必要はありません。

1TCP/IPコネクションを複数ユーザからのアクセス要求で共有する場合，これらの値は，次の手順で決定してください。

DABrokerのシステム全体で同時にアクセスするユーザ数（要求数）の最大値を見積もる

この最大値は，アクセス対象となるDatabase Connection Serverの空間起動制御文で設定された「サーバユーザ数」以内となるようにしてください。サーバユーザ数の設定方法については，マニュアル「Database Connection Server」を参照してください。

「1で見積もった最大値≦最大仮想コネクション数 * 通信処理プロセス数」となるような最大仮想コネクション数と最大通信処理プロセス数の組み合わせを決定する

このとき，次の2点を考慮し，使用環境に合わせた適切な数値を検討してください。

レスポンス性能

DABrokerが組み込まれたサーバで消費するリソース量，及びDatabase Connection Serverが組み込まれたメインフレームで消費するリソース量

レスポンス性能は，1通信処理プロセス当たりの仮想コネクション数を少なくすればするほど向上し，最大仮想コネクション数を1にする（シングルコネクション）とレスポンスが早くなります。しかし，同時アクセスユーザ数が多い場合に，TCP/IPコネクションも増えるため，メインフレーム側でリソース消費量が多くなります。このため，使用環境に合わせた適切な数値を検討してください。

なお，最大仮想コネクション数は，接続するDatabase Connection Serverの空間起動制御文で設定された「ユーザ数(仮想ユーザ空間数など)÷TCPコネクション数」の倍数となるように設定してください。

(3)　プールコネクション数と予約プールコネクション数の決定（仮想コネクションのプーリング機能の使用）

最大仮想コネクション数を2以上にした場合，次の2種類の機能が使用できます。この2種類は併用できます。

一度確立した仮想コネクションをプールする

この機能を使用すると，コネクション確立のためのオーバーヘッドを削減し，Database Connection Serverとの接続時間の短縮が図れます。この機能を使用するときは，プールコネクション数（6）を設定してください。

コネクションマルチ機能の起動時に指定された数の仮想コネクションを確立しておく

この機能を使用すると，通信処理プロセスの起動のためのオーバヘッドを削減し，Database Connection Serverとの接続時間を短縮できます。この機能を使用するときは，予約プールコネクション数（7）を設定してください。

仮想コネクションのプーリング機能を使用するときは，次に示す値を設定してください。

プールコネクション数（6）

DABrokerのシステム全体でプールする仮想コネクション数を設定します。プールした仮想コネクションに対応するTCP/IPコネクションのためのリソースをDatabase Connection Server（メインフレーム）側で占有してしまうため，メインフレーム側でのリソース消費量を考慮して使用環境に合わせた値を設定してください。なお，リソースは，1通信処理プロセスごと，1TCP/IPコネクションごとに消費されるため，「最大仮想コネクション数」で設定した値の倍数をプールコネクション数に設定することをお勧めします。

予約プールコネクション数（7）

DABrokerのシステム全体でコネクションマルチ機能起動時に確立しておく仮想コネクション数を設定します。コネクションマルチ機能起動時にアクセス要求がなくても仮想コネクションを確立してしまうことになるため，DABrokerを組み込んだサーバで確立した分のリソースを占有してしまいます。したがって，DABroker側のリソース消費量を考慮して使用環境に合わせた値を設定してください。なお，リソースは，1通信処理プロセスごと，1TCP/IPコネクションごとに消費されるため，「最大仮想コネクション数」で設定した値の倍数を予約プールコネクション数に設定することをお勧めします。

プールコネクション数及び予約プールコネクション数の両方に値を設定する場合は，「プールコネクション数≧予約プールコネクション数」となるように設定してください。

4.7.3　コネクションマルチ定義ユティリティの操作

コネクションマルチ定義ユティリティは，プログラムフォルダに登録された［コネクションマルチ定義］から起動します。

コネクションマルチ定義ユティリティで設定した内容は，コネクションマルチ定義ファイル：[DABroker運用ディレクトリ¥conf¥damconenv]に出力されます。

(1)　操作できるユーザ

すべてのユーザ

(2)　操作方法

プログラムフォルダに登録された［コネクションマルチ定義］を起動する。

コネクションマルチ定義ユティリティが起動し，［コネクションマルチ定義］ダイアログボックスが表示されます。

コネクションマルチ名，及びコネクションマルチ名に対する接続情報を定義する。

設定内容については，「4.7.4　設定する項目」を参照してください。

<設定方法>

コネクションマルチ名を新規登録する場合

［コネクションマルチ名］のテキストボックスに新しいコネクションマルチ名を定義します。既に登録されているコネクションマルチ名がある場合は，［追加］ボタンを選択してからコネクションマルチ名を定義します。

既にあるコネクションマルチ名の内容をコピーして新規登録する場合

コネクションマルチ名一覧からコピー元のコネクションマルチ名を選択します。コピー元の内容を表示してから［コピー］ボタンを選択します。次に［コネクションマルチ名］のテキストボックスに新しいコネクションマルチ名を定義します。

登録されているコネクションマルチ名の定義を変更する場合

コネクションマルチ名一覧から変更するコネクションマルチ名を選択します。

内容を変更後，［適用］ボタンを選択すると，編集した内容が保存されます。［戻す］ボタンを選択すると，編集前の状態に戻ります。

コネクションマルチ名を削除する場合

コネクションマルチ名一覧から削除するコネクションマルチ名を選択して［削除］ボタンを選択してください。

4.7.4　設定する項目

コネクションマルチ定義ユティリティでは，次の項目を設定します。

設定項目名

指定内容

コネクションマルチ名

接続するDatabase Connection Serverに付ける任意名称を設定します。

<設定規則>DABrokerのシステム内でユニークな名称にしてください。最大255文字まで指定できます。2バイト文字，半角カタカナは使用しないでください。

Database Connection Server

のホスト名

接続するDatabase Connection Serverが存在するホスト名を設定します。

ここでの指定を省略した場合は，DABroker環境設定ユティリティのDatabase Connection Server接続設定(接続先ホスト名またはIPアドレス：DAB_DBS_HOST)に指定された値を仮定します。

Database Connection Server

のポート番号又はサービス名

接続するDatabase Connection Serverのポート番号（Database Connection Serverではサーバスケジュール番号と呼ぶ）又はサービス名（ユーザの任意設定名称）を設定します。

ここで，サービス名を指定した場合は，[Windowsインストールディレクトリ]¥SYSTEM32¥DRIVERS¥ETC¥SERVICESファイルにサービス名と対応するポート番号を設定してください（「4.3　ネットワーク環境の設定」参照）。

ここでの指定を省略した場合は，DABroker環境設定ユティリティのDatabase Connection Server接続設定(接続先サービス名またはポート番号：DAB_DBS_PORT)に指定された値を仮定します。

Database Connection Server

からの応答監視時間

Database Connection Serverからの処理結果の応答待ち時間を設定します。

指定範囲：0，1〜65535（秒）

　0を指定した場合：応答待ち時間を監視しません。

最大仮想コネクション数

1通信処理プロセス当たりで同時に確立できる仮想コネクション数の最大値を設定します。ここで設定した値を超えるユーザからの要求があった場合は，別の通信処理プロセスを起動し，仮想コネクションを確立してDatabase Connection Serverに接続します。なお，データベースには，「最大仮想コネクション数 × 通信処理プロセス数」で算出される数のユーザが同時にアクセスできます。

指定範囲：1〜100

1を設定した場合：

シングルコネクションとなります。

2以上を設定した場合：

1通信処理プロセスにつき2以上の仮想コネクションを同時に確立できるマルチコネクション（コネクションマルチ）となります。このとき，「通信処理プロセス数」も設定してください。運用時は，コネクションマルチ機能の運用開始ユティリティを実行してください。実行方法については，「4.10　コネクションマルチ機能の使用」を参照してください。

通信処理プロセス数

−最大仮想コネクション数を2以上の値にした場合に必ず設定する項目です。

Database Connection Serverと接続するときに起動する最大通信処理プロセス数を設定します。ここで設定した値を超えた場合は，アプリケーション又はDBPARTNERにエラーメッセージを返し，処理を受け付けません。

指定範囲：0，1〜1000

　指定を省略した場合又は0を指定した場合：シングルコネクション（1通信処理プロセス当たり1仮想コネクション）となります。

プールコネクション数

−最大仮想コネクション数を2以上の値にした場合に設定できる項目です。

Database Connection Serverに接続するときに確立する仮想コネクションを，データベースアクセスが終了しても，確立されたままの状態でプールしておく数を設定します。確立済みの仮想コネクションをプールしておくことで，Database Connection Serverと接続するときの仮想コネクション確立時間を短縮できます。

指定範囲：0，1〜32767

　指定を省略した場合又は0を指定した場合：プール機能を使用できません。

予約プールコネクション数

−最大仮想コネクション数を2以上の値にした場合に設定できる項目です。

DABroker起動時に仮想コネクションを確立しておく数を設定します。DABroker起動時に仮想コネクションが確立されていると，Database Connection Serverと接続するときの仮想コネクション確立時間を短縮できます。

指定範囲：0，1〜32767

　指定を省略した場合又は0を指定した場合：予約プール機能を使用できません。

注意：

「最大仮想コネクション数 × 通信処理プロセス数」で算出される値以上の数を設定できません。設定した場合は，コネクションマルチ機能の運用を開始した時点で，通信処理プロセスの起動エラーとなります。

プールコネクション数も設定した場合，予約プールコネクション数では，プールコネクション数より大きな値を設定できません。

4.8　DABrokerの起動と終了

DABrokerの起動と終了方法について説明します

4.8.1　起動

(1)　操作できるユーザ

WindowsのAdministratorsグループに属するユーザ

(2)　起動順序

DABrokerを起動するときは次の順序で各プログラムを起動してください。

接続するデータベースのDBMS

DABroker

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表（それぞれの製品を使用している場合です）

1.と2.の順序は前後してもかまいません。

(3)　起動方法

次のどちらかの方法で起動できます。

(a)　プログラムフォルダからの起動

［スタート］−［プログラム］で表示されるフォルダ［DABroker］から［起動］を選択してください。

(b)　サービスの開始による起動

［コントロールパネル］ダイアログボックスで［サービス］を選択します。［サービス］ダイアログボックスで［DABroker］を選択し，［開始］ボタンをクリックしてください。

［スタートアップの種別］を［自動］にすると，Windowsの起動と同時にDABrokerを起動できます。

4.8.2　終了

(1)　操作できるユーザ

WindowsのAdministratorsグループに属するユーザ

(2)　終了順序

DABrokerを終了するときは次の順序で各プログラムを終了してください。

DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表（それぞれの製品を使用している場合です）

DABroker

接続するデータベースのDBMS

(3)　終了形態

DABrokerの終了形態には次の三つがあります。

通常の終了

クライアントが存在しない場合，DABrokerを終了できます。

この条件を満たさない場合はエラーメッセージが表示され，終了できません。

接続中のクライアントがあるかどうかは，DABroker管理ユティリティで確認できます。

計画終了

接続中のクライアントが存在する場合，これらのすべての処理の終了を待ってDABrokerを終了します。新たなクライアントからの接続要求は受け付けません。

強制終了

接続中のクライアントが存在しても，これらの処理を中断してDABrokerを強制的に終了します。

計画終了中に［DABroker終了］ダイアログボックスからこの強制終了を実行すると，計画終了を強制終了に変更できます。

(4)　終了方法

起動方法にかかわらず，次のどちらかの方法で終了できます。

(a)　プログラムフォルダからの終了

［スタート］−［プログラム］で表示されるフォルダ［DABroker］から［終了］を選択してください。［DABroker終了］ダイアログボックスが表示されるので，終了形態を選択し，［実行］ボタンをクリックします。

その後，確認のためのダイアログボックスが表示されます。［はい］を選択してDABrokerを終了します。

(b)　サービスの停止による終了

［コントロールパネル］ダイアログボックスで［サービス］を選択します。［サービス］ダイアログボックスで［DABroker］を選択し，［停止］ボタンをクリックしてください。

ただし，この場合は強制終了になります。

4.9　DABrokerの処理内容の表示

DABrokerでは，次の情報を取得できます。

4.9.1　DABroker管理ユティリティの実行

DABroker管理ユティリティには次の二つの機能があります。

DABrokerの動作状態の表示

各クライアントとの接続時間を表示します。

特定のクライアント（特定のIPアドレス又はホスト名）の処理の中断

指定したクライアントとのコネクションを解放し，実行中の処理を中断します。このとき，DABrokerはデータベースに要求した処理のロールバックを要求します。また，そのクライアントが要求した予約処理をすべて取り消します。

(1)　操作できるユーザとユティリティの起動・終了方法

操作できるユーザ

Administratorsグループに属するユーザ

ユティリティの起動と終了方法

起動

DABroker管理ユティリティは，プログラムフォルダに登録された［DABroker］から［DABroker管理］を選択して起動します。DABrokerが起動中に実行してください。

終了

［DABroker管理］ダイアログボックスを閉じるとDABroker管理ユティリティは終了します。

(2)　動作状態の表示方法

DABroker管理ユティリティを起動すると，次に示す［管理］ダイアログボックスが表示されます。ダイアログボックスに表示されている内容が，DABrokerの動作状態です。

ここでは，表示されている内容について説明します。

IPアドレス

接続しているクライアントのIPアドレス。

接続時刻

クライアントと接続した日時（年／月／日 時：分：秒）

接続時間

接続してからの経過時間（時：分：秒）

予約

実行中の予約処理数（64ビット版DABrokerでは表示されることはありません）。

状態

クライアントとのコネクションの確立状態。

「接続中」と表示されている場合は，クライアントとのコネクションが確立中であることを示します。

ホスト名

接続しているクライアントのホスト名。

次のフォルダのhostsファイルにホスト名を登録している場合，ホスト名が表示されます。

[Windowsをインストールしたフォルダ]¥SYSTEM32¥DRIVERS¥ETC

ホスト名の長さによっては，ホスト名の後方が表示できない場合があります。

[図データ] アイコンについて

[図データ] アイコンをクリックすると最新の動作状態が表示されます。

(3)　特定のクライアントの処理の中断方法

特定のクライアントの処理を中断したい場合は，DABrokerの動作状態を表示し（「4.9.1(2)動作状態の表示方法」参照），次に示す手順を実行してください。

［DABroker管理］ダイアログボックスでクライアントを選択する。

動作状態を表示し，その中から処理を中断するクライアントを選択して[図データ]アイコンをクリックします。

［はい］ボタンを選択する。

確認のダイアログボックスが表示されるので，［はい］ボタンを選択すると，DABrokerは選択したクライアントとのコネクションを解放します。

［いいえ］ボタンについて

［いいえ］ボタンを選択すると，クライアントの処理の中断はキャンセルされます。

4.9.2　DABrokerトレース出力ユティリティの実行

DABrokerトレース出力ユティリティでは，次の二つのトレースを出力できます。

通信トレース

DABrokerとクライアント間のデータの送受信に関する情報（通信トレース）を出力します。通信トレースはクライアントからの要求受付直後，及びDABrokerからの結果送信直後にDABrokerが取得します。出力されたトレースは，DABroker運用ディレクトリ¥spool¥dabcltrcの下に格納されます。

データベースアクセストレース

DABrokerがデータベースに要求した処理，及びその処理に対するデータベースからの応答（アクセストレース）を表示します。アクセストレースは，DBMSに要求を出す直前及びDBMSから応答が返ってきた直後に，DABrokerが取得します。出力されたトレースは，DABroker運用ディレクトリ¥spool¥db_accessの下に格納されます。

また，DABrokerでは，拡張データベースアクセストレース機能でデータベースアクセストレースを出力することもできます。拡張データベースアクセストレース機能の詳細については，「6.5.2　拡張データベースアクセストレース機能」を参照してください。

(1)　操作できるユーザとユティリティの起動・終了方法

操作できるユーザ

すべてのユーザがDABrokerトレース出力ユティリティを実行できます。

ユティリティの起動と終了方法

起動

DABrokerトレース出力ユティリティは，プログラムフォルダに登録された［DABroker］から［トレース出力］を選択して起動します。DABroker起動中に実行してください。

起動すると次のダイアログが表示されます。

終了

［DABrokerトレース出力］ダイアログボックスを閉じるとDABrokerトレース出力ユティリティは終了します。

(2)　クライアントとの通信トレースの出力方法

［DABrokerトレース出力］ユティリティを起動して表示されたダイアログで，次に示す手順を実行してください。

［通信トレースを出力する］チェックボックスをチェックする。

取得する通信トレースを指定する。

すべての通信トレースを取得する場合

［IPアドレスまたはホスト名］を空白にしてください。

特定のIPアドレスまたはホスト名の通信トレースを取得する

［IPアドレスまたはホスト名］に通信トレースを出力するIPアドレス又はホスト名を指定してください。

通信トレースの出力先を指定する。

［出力先］ボタンをクリックすると，出力先のファイルを指定するダイアログボックスが表示されます。出力先のファイルを指定します。省略した場合は，DABroker運用ディレクトリ¥spool¥DABTT.TXTに通信トレースが出力されます。

［実行］ボタンを選択する。

［実行］ボタンを選択すると指定した出力先に通信トレースが出力されます。

なお，データベースアクセストレースの出力設定（設定方法は，「4.9.2(3)　データベースアクセストレースの出力方法」参照）もしてから［実行］ボタンを押すと，両方のトレースが出力できます。

出力例

IPADDR=XXXXXXXX

クライアントのIPアドレス又はホスト名。

PROT=XXX

通信プロトコル。TCP：TCP/IP。

PAP-NAME=XXXXXX

次のどれかが表示されます。

DABroker関連製品を使用した場合：アプリケーションで設定した名称

DBPARTNER/Client又はDBPARTNER/Webからアクセスした場合：

DBPARTNER/Client又はDBPARTNER/Webの識別情報

DBPARTNER Libraryからアクセスした場合：DBPARTNER Libraryの識別情報

XDM/RD外部表としてアクセスした場合：XDM/RDの識別情報

DATE

送受信の発生日付（年/月/日）。

TIME

送受信の発生時刻（時:分:秒.n）。nはn/100秒を表します。

EVT

DABrokerでの事象区分。

PUT：クライアントへの送信

GET：クライアントからの受信

SIZE

送受信データ長（バイト）。

DATA

送受信データ種別。

aa…aa <bb…bb>（cc…cc,dd…dd）の形式で出力されます。

aa…aa：オペレーション種別

表示されるオペレーション種別とその意味について，次に示します。

オペレーション種別

意　　味

Connect（Database）

データベースとの接続要求

Disconnect（Database）

データベースとの切り離し要求

Disconnect（Connection）

コネクションの解放要求

Commit

トランザクションのコミット要求

Rollback

トランザクションのロールバック要求

LIST（Table）

表一覧取得要求

LIST（Column）

列一覧取得要求

LIST（Index）

索引一覧取得要求

LIST（Table Privileges）

表権限一覧取得要求

LIST（Column Privileges）

列権限一覧取得要求

EXT-CMD

SQL文の実行要求

SQL Fetch Option

SQL実行オプション実行

File Delete

SQL実行結果格納ファイル削除

Cancel

DBMSに対する処理の中断要求

Illegal Request

不正要求

Connection

コネクション確立応答

Result

正常応答

Error

異常応答

Result（Cancel）

正常応答（DBMSに対する処理の中断要求時）

Error（Cancel）

異常応答（DBMSに対する処理の中断要求時）

Procedure(List Prepare Procedure)

ストアドプロシジャ一覧取得準備要求

Procedure(List Fetch Procedure)

ストアドプロシジャ一覧取得要求

Procedure(List Close Procedure)

ストアドプロシジャ一覧取得後の処理要求

Procedure(List Prepare Column)

ストアドプロシジャ列一覧取得準備要求

Procedure(List Fetch Column)

ストアドプロシジャ列一覧取得要求

Procedure(List Close Column)

ストアドプロシジャ列一覧取得後の処理要求

Procedure(Parameter Get)

ストアドプロシジャ定義情報取得要求

Procedure(Prepare)

ストアドプロシジャ実行準備要求

Procedure(Execute)

ストアドプロシジャ実行要求

Procedure(Extended Execute)

ストアドプロシジャ拡張実行要求

AUTO Commit OFF

トランザクションのAUTO COMMITモード解除要求

AUTO Commit ON

トランザクションのAUTO COMMITモード設定要求

bb…bb：付加情報。

オペレーション種別が，LIST（xxxxx）及びEXT-CMDの場合に表示されます。

cc…cc：リターンコード。

dd…dd：詳細コード。

注意事項

クライアントからの要求量が多いほど，クライアントとの通信トレースのファイル容量も多くなります。通信トレースのファイル容量の目安として，概算式を次に示します。

（概算式）

80（ヘッダ情報長） + クライアントからの要求数 * 2 （PUT及びGET分） * 36（PUT及びGET情報長）〔バイト〕

あらかじめ，この概算式で計算したサイズ以上のハードディスク容量を用意しておいてください。また，クライアントからの要求量が多いほど，トレース出力が終わるまで時間がかかります。御注意ください。

(3)　データベースアクセストレースの出力方法

［DABrokerトレース出力］ユティリティを起動して表示されたダイアログで，次に示す手順を実行してください。

［アクセストレースを出力する］チェックボックスをチェックする。

取得するアクセストレースを指定する。

すべてのアクセストレースを取得する場合

［UAP名］，［ユーザID］を空白にしてください。

特定のアプリケーションのアクセストレースを取得する

［UAP名］にアクセストレースを出力するUAP名を指定してください。

指定できる文字列は次のとおりです。

アプリケーションの種類

指定する名称

DABroker関連製品で開発したアプリケーションからアクセスする場合

アプリケーションで設定した名称

(各DABroker関連マニュアル参照)

DBPARTNER/Client又は

DBPARTNER/Webからアクセスする場合

DBPARTNER/Client又はDBPARTNER/Webの識別情報

特定のユーザIDのアクセストレースを取得する場合

［ユーザID］にアクセストレースを出力するユーザIDを指定してください。

特定のクライアントの特定のユーザIDのアクセストレースを取得する場合

［UAP名］にアクセストレースを出力するUAP名を指定し，［ユーザID］にアクセストレースを出力するユーザIDを指定してください。

アクセストレースの出力先を指定する。

［出力先］ボタンをクリックすると，出力先のファイルを指定するダイアログボックスが表示されます。出力先のファイルを指定します。省略した場合は，DABroker運用ディレクトリ¥spool¥DABDT.TXTにアクセストレースが出力されます。

［実行］ボタンを選択する。

［実行］ボタンを選択すると指定した出力先にアクセストレースが出力されます。

すべてのクライアントから要求されたデータベースアクセストレースを出力します。

出力例

UID=XXXXXXXX

ユーザID。

PAPNAME=XXXXXXX

アプリケーションを識別するための文字列が表示されます。表示される文字列は，[UAP名]で指定できる名称です。

DBNAME=XXXXXXX

接続先データベース名。次のどれかが出力されます。

HiRDB：HiRDB Version 7，HiRDB Version 8，HiRDB Version 9，又はHiRDB Version 10

ORACLE7：Oracle10g，Oracle11g，もしくはOracle12cでOracle Call Interface 7を使用している場合，又はOracle19cでOracle Call Interface 8iを使用している場合。

ORACLE8i：Oracle10g，Oracle11g，Oracle12c，又はOracle19cでOracle Call Interface 8iを使用している場合。

ODBC3.0：SQL Server

DBCSV：Database Connection Server

DATE

アクセスの発生日（年/月/日）。

TIME

アクセスの発生時刻（時:分:秒.n）。nはn/100秒を表します。

EVT

DABrokerがデータベースに要求した処理の内容。次のどれかが表示されます。

EVTの表示

処　理　内　容

CONNECT

データベースと接続します

PREPARE

SQLの前処理をします

DESCRIBE

前処理したSQLの情報を返します

DECLARE

前処理したSELECTに対してカーソルを宣言します

OPEN

カーソルを位置付けます

FETCH

行を読み込んでカーソルを進めます

CLOSE

カーソルを閉じます

EXECUTE

前処理したSQLを実行します

COMMIT

トランザクションを正常終了，更新を有効にします

ROLLBACK

トランザクションを取り消し，更新を無効にします

DISCONNECT

トランザクションを正常終了，切り離します

CANCEL

DBMSに対し，処理の中断します

LOGGING

DBMSに対し，ログ取得要求します

ただし，DBMSがHiRDBの場合だけです

LOGLESS

DBMSに対し，ログレス要求します

ただし，DBMSがHiRDBの場合だけです

AUTOCOMOFF

トランザクションのAUTO COMMITモードを解除します

AUTOCOMON

トランザクションのAUTO COMMITモードを設定します

データベースアクセストレースの取得内容は任意に選択できます。環境設定ユティリティの［アクセストレースの種類］で選択します。アクセストレースの種類については，「4.5.1(9)　データベースアクセストレースの取得（DABSQL_TRCSIZE）」を参照してください。

RETCODE

DABrokerが要求した処理に対して，DBMSから返されるリターンコード。

0：正常終了。

0以外：異常終了又はメッセージ付きの正常終了。

DABrokerからDBMSへの要求の送信を表示している行は，RETCODEは空白になります。

INFORMATION

FETCH時の行取得要求数及び取得結果の情報。

ORACLEの場合は，「BLOCK COUNT（XXX）」の形式で出力されます。

(SQL)

クライアントから要求のあったSQLの内容。この項目は，必要に応じて表示されます。

SQL Server使用時，EVTがPREPAREの場合は，次の情報が出力されます。

表示内容

説明

(SQL) ODBC:{SQLTables}

テーブル一覧情報

(SQL) ODBC:{SQLColums}

カラム一覧情報

(SQL) ODBC:{SQLTablePrivileges}

テーブル権限一覧情報

(SQL) ODBC:{SQLColumnPrivileges}

カラム権限一覧情報

(SQL) ODBC:{SQLStatistics}

インデクス一覧情報

(SQL) ODBC:{SQLProcedures}

プロシジャ一覧情報

(SQL) ODBC:{SQLProcedureColumns}

プロシジャ列一覧情報

(SQL) ODBC:{SQLPrimaryKeys}

プライマリキー一覧情報

Database Connection Server使用時，EVTがPREPAREの場合は次の情報が出力されます。

表示内容

説明

(SQL) DBCSV:{SQLTable}

テーブル一覧情報

(SQL) DBCSV:{SQLColumns}

カラム一覧情報

(SQL) DBCSV:{SQLTablePrivileges}

テーブル権限一覧情報

(SQL) DBCSV:{SQLColumnsPrivileges}

カラム権限一覧情報

(SQL) DBCSV:{SQLStatistics}

インデクス一覧情報

(SQL) DBCSV:{ProcedureList}※

外部プロシジャ一覧

(SQL) DBCSV:{ProcedureColumns}※

外部プロシジャ列一覧

注※

Database Connection Server経由でXDM/RDの外部プロシジャ機能を使用している場合に出力されます。

注意事項

クライアントからの要求量（SQL文）が多いほど，データベースアクセストレースのファイル容量も多くなります。トレースは，1レコード80バイトで表示されます。クライアントからの要求（SQL文）が多い場合は，折り返して表示します。データベースアクセストレースのファイル容量の目安として，概算式を次に示します。

（概算式）

{(クライアントからの要求（SQL長など）* 2) + 2 [ +↓(クライアントからの要求SQL長/73)↓-1] } * 80〔バイト〕

注　下線は，SQL長が73バイト以上の場合です。

あらかじめ，この概算式で計算したサイズ以上のハードディスク容量を用意しておいてください。また，クライアントからの要求量が多いほど，トレース表示が終わるまで時間がかかります。御注意ください。

4.10　コネクションマルチ機能の使用

コネクションマルチ定義ユティリティで，「最大仮想コネクション数」を2以上に設定した場合は，コネクションマルチ機能の運用開始ユティリティを実行してください。この場合は，コネクションマルチ管理ユティリティを使って，Database Connection ServerとDABrokerとの接続状態を確認できます。

ここでは，コネクションマルチ機能の運用開始と終了方法，コネクションマルチ管理ユティリティの操作方法について説明します。

4.10.1　コネクションマルチ機能の運用開始と終了

コネクションマルチ機能の運用開始方法と終了方法について説明します

(1)　運用開始

(a)　操作できるユーザ

WindowsのAdministratorsグループに属するユーザ

(b)　起動方法

次のどちらかの方法で起動できます。

プログラムフォルダからの起動

［スタート］−［プログラム］で表示されるフォルダ［DABroker］から［コネクションマルチ起動］を選択してください。

サービスの開始による起動

［コントロールパネル］ダイアログボックスで［サービス］を選択します。［サービス］ダイアログボックスで［DABroker Connection Multi］を選択し，［開始］ボタンをクリックしてください。

［スタートアップの種別］を［自動］にすると，Windowsの起動と同時にコネクションマルチ機能を運用開始できます。

(2)　終了

(a)　操作できるユーザ

WindowsのAdministratorsグループに属するユーザ

(b)　終了形態

コネクションマルチ機能の運用の終了形態には次の三つがあります。

通常の終了

次の場合にコネクションマルチ機能の運用を終了できます。

Database Connection Serverと接続中のコネクションが存在しない場合

この条件を満たさない場合はエラーメッセージが表示され，終了できません。

接続中のクライアントがあるかどうかは，DABrokerコネクションマルチ管理ユティリティで確認できます。

計画終了

Database Connection Serverと使用中のコネクションが存在する場合，これらのすべての処理の終了を待ってコネクションマルチ機能の運用を終了します。新たなコネクションを作成しません。

強制終了

Database Connection Serverと接続中のコネクションが存在しても，これらの処理を中断してコネクションマルチ機能の運用を強制的に終了します。

計画終了中に［DABrokerコネクションマルチ終了］ダイアログボックスからこの強制終了を実行すると，計画終了を強制終了に変更できます。

(c)　終了方法

起動方法にかかわらず，次のどちらかの方法で終了できます。

プログラムフォルダからの終了

［スタート］−［プログラム］で表示されるフォルダ［DABroker］から［DABrokerコネクションマルチ終了］を選択してください。［DABrokerコネクションマルチ終了］ダイアログボックスが表示されるので，終了形態を選択し，［実行］ボタンをクリックします。

その後，確認のためのダイアログボックスが表示されます。［はい］を選択してDABrokerを終了します。

サービスの停止による終了

［コントロールパネル］ダイアログボックスで［サービス］を選択します。［サービス］ダイアログボックスで［DABroker Connection Multi］を選択し，［停止］ボタンをクリックしてください。ただし，この場合は強制終了になります。

4.10.2　コネクションマルチ管理ユティリティ

コネクションマルチ管理ユティリティには次の二つの機能があります。

コネクションマルチ機能の運用状態の表示

接続ユーザIDからのアクセス要求に対応する仮想コネクションIDごとの，DABrokerとDatabase Connection Serverとの接続時間を表示します。

コネクションマルチ機能運用中の特定のクライアントの処理の中断

特定の接続ユーザIDからのアクセス要求に対して確立した仮想コネクションを解放し，実行中の処理を中断します。このとき，DABrokerはデータベースに要求した処理のロールバックを要求します。

(1)　操作できるユーザとユティリティの起動・終了方法

操作できるユーザ

Administratorsグループに属するユーザ

ユティリティの起動と終了方法

起動

DABroker管理ユティリティは，プログラムフォルダに登録された［DABroker］から［コネクションマルチ管理］を選択して起動します。DABrokerが起動中に実行してください。

終了

［コネクションマルチ管理］ダイアログボックスを閉じるとDABroker管理ユティリティは終了します。

(2)　コネクションマルチ機能の運用状態の表示方法

コネクションマルチ管理ユティリティを起動すると，次に示す［DABrokerコネクションマルチ管理］ダイアログボックスが表示されます。ダイアログボックスに表示されている内容が，コネクションマルチ機能の運用状態です。

ここでは，表示されている内容について説明します。

接続開始時間

Database Connection ServerのTCP/IPコネクションが確立された日時（年／月／日 時：分：秒）。

ユーザ開始時間

ユーザからのアクセス要求に対して仮想コネクションの使用を開始した日時（年／月／日 時：分：秒）。

接続ユーザID

データベースに接続するときに使用したユーザID（データベースのログインユーザID）。

仮想コネクションの状態

仮想コネクションの状態を次のどちらかで示します。

USE：仮想コネクションの使用中

POOL：仮想コネクションのプール待機中

仮想コネクションID

サーバプロセスID

デーモンID

仮想コネクションID，サーバプロセスID，デーモンIDのそれぞれは，DABrokerが付与するユニークなID。

コネクションマルチ名

接続しているDatabase Connection Serverのコネクションマルチ名（「4.7　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」参照）。

[図データ] アイコンについて

[図データ] アイコンをクリックすると最新の運用状態が表示されます。

5　DABrokerの運用（共通）

この章では，DABrokerの運用方法について説明します。

5.1　DABrokerを運用する前に

ここでは，データベースをアクセスする前に設定及び確認しておく項目について説明します。

5.1.1　データベースにアクセスするユーザIDの設定

データベースをアクセスする時のユーザID及びパスワードを設定してください。ユーザID及びパスワードは，DBMSに設定します。

5.1.2　クライアントからの接続先の指定

(1)　DABroker関連製品を使用する場合

アプリケーションは接続先データベース定義ファイルを使用して，データベースにアクセスします。接続先データベース定義ファイルについては，次の箇所を参照してください。

UNIXの場合：「3.6　DABroker接続先データベースの定義」

Windowsの場合：「4.6　DABroker接続先データベース定義」

なお，アプリケーションでの接続先データベースの指定方法については，各DABroker関連製品のマニュアルを参照してください。

(2)　DBPARTNER，HITSENSER5，DBPARTNER Library，又はXDM/RD外部表を使用する場合

クライアントからデータベースのアクセスを要求する場合は，使用するDABrokerやデータベースのネットワーク上での位置を指定する必要があります。どこで指定するかを次に示します。

サーバ（DABrokerが組み込まれたマシン）のホスト名

クライアントで指定します。

使用するデータベース

クライアント，又はデータベースの定義で指定します。

ただし，UNIXで，HiRDB又はORACLEにアクセスする場合は，DABrokerの動作環境定義ファイルで各データベースの設定項目を一つ指定します。クライアントでデータベースの指定が省略された場合は，ここで指定されたデータベースにアクセスします。なお，DABroker動作環境定義ファイルで指定したデータベースとクライアントで指定されたデータベースとが異なる場合は，クライアントで指定されたデータベースにアクセスします。

各データベースの設定項目については，次の箇所を参照してください。

HiRDBの場合：「3.5.3　HiRDBの設定」

ORACLEの場合：「3.5.4　ORACLEの設定」

(3)　Database Connection Serverを使用する場合

Database Connection Serverを使ってデータベースにアクセスするには，接続先データベース定義ファイルとコネクションマルチ定義ファイルに，接続条件などを定義しておく必要があります。接続先データベース定義ファイルについては次の箇所を参照してください。

UNIXの場合：「3.6　DABroker接続先データベースの定義」

Windowsの場合：「4.6　DABroker接続先データベース定義」

コネクションマルチ定義ファイルについては次の箇所を参照してください。

UNIXの場合：「3.9　DABrokerコネクションマルチ定義(Database Connection Server経由のDBアクセス定義)」

Windowsの場合：「4.7　DABrokerコネクションマルチ定義（Database Connection Server経由のDBアクセス定義）」

(4)　SQL Server(ODBC3.0)を使用する場合(Windows限定)

SQL Server(ODBC3.0)を使ってデータベースにアクセスするには，アクセス対象のデータベースのODBCデータソースを設定しておく必要があります。設定したデータソース名をDABrokerの接続先データベース定義，又はDBPARTNERの接続情報に設定することで，データベースにアクセスできます。

DBPARTNERからアクセスする場合には，アクセス対象のデータベースのデータソース名を，DABrokerがインストールされているマシンのシステムデータソースに設定してください。

DBPARTNERの接続情報の設定については，各製品のマニュアルを参照してください。

5.2　DBPARTNERを使用する場合のスレッドのチューニング

DABrokerは，マルチスレッドに対応しています。DBPARTNERを使用する場合は，マルチスレッドの性能をチューニングする必要があります。

DBPARTNERを使用する場合，DABrokerは，接続ユーザ（データベースにアクセスする処理）ごとにスレッドを生成します。接続ユーザ数とスレッドの対応については，「2.1.2　DBPARTNERから実行するマルチスレッド」を参照してください。

チューニングは，接続ユーザ数を考慮してDABroker動作環境定義ファイルで次に示す項目に適切な値を指定してください。

最大処理プロセス数（DABMAXPROCESS）

1プロセスあたりの実行ユーザ数（DABBLOCKUSERS）

最大接続ユーザ数（DABMAXUSERS）

また，最大接続ユーザ数に設定する値は次の計算式の範囲にしてください。

（計算式）

最大接続ユーザ数≦最大処理プロセス数×1プロセス当たりの最大接続ユーザ数

DABroker動作環境定義ファイルについては，次の箇所を参照してください。

UNIXの場合：「3.4　DABrokerの動作環境の設定」

Windowsの場合：「4.4　DABroker環境設定」

6　DABrokerの障害対策（共通）

この章では，DABrokerでの障害が発生したときの対処方法，及びタイマー監視について説明します。

UNIXを使用する環境とWindowsを使用する環境で共通の内容です。

6.1　障害対策

DABrokerの運用中にエラーが発生した場合，エラーメッセージが出力されます。「7.　メッセージ（共通）」を参考にしてエラー原因を取り除いてください。

ここでは，エラー時にDABrokerが実行する処理内容，及び保守員への連絡時に取得する障害情報について説明します。なお，このマニュアルでの保守員とは，システム管理者がご購入契約に基づくお問い合わせ窓口のことです。

6.1.1　エラー時にDABrokerが実行する処理

システムで次のようなエラーが発生した場合，DABrokerは，データベースを切り離します。

DABrokerが異常終了した場合

データベースでの実行中の処理はロールバックされます。

DBMSが異常終了した場合

データベースでの処理はDBMSに任せます。

通常，クライアントからの要求でデータベースを切り離しますが，これらのエラーの場合及びDABrokerを強制終了する場合は，DABrokerが判断してデータベースを切り離します。

6.1.2　障害情報の取得

次のような場合は，システム管理者が保守員に連絡してください。

メッセージの対処に，「保守員に連絡してください。」と記載されている場合

障害の要因が分からない場合

メッセージの内容で対処できない場合

保守員に連絡する場合は，次に示す障害情報をコピーして保存してください。

UNIXの場合は，DABroker運用ディレクトリにある.HTC_2340.infについても取得してください。

(1)　DABrokerのトラブルシュート情報

(a)　スプール情報

DABroker運用ディレクトリのspoolディレクトリ下のすべてのファイルをコピーして保存してください。

メッセージログ

UNIX：

DABroker運用ディレクトリ/spool/dabsv.log，及びdabsv.logold

Windows：

DABroker運用ディレクトリ¥spool¥dabsv.log，及びdabsv.logold

データベースアクセストレース，拡張データベースアクセストレース

UNIX：

DABroker運用ディレクトリ/spool/db_access下のファイル

Windows：

DABroker運用ディレクトリ¥spool¥db_access下のファイル

通信トレース

UNIX：

DABroker運用ディレクトリ/spool/dabcltrc

Windows：

DABroker運用ディレクトリ¥spool¥dabcltrc

XAトレース

UNIX：

DABroker運用ディレクトリ/spool/db_xainfo.log

Windows：

DABroker運用ディレクトリ¥spool¥db_xainfo.log

デーモンの生成・消滅・クリーンアップ実行結果ログ

UNIX：

DABroker運用ディレクトリ/spool/dabsvdemon.log

Windows：

DABroker運用ディレクトリ¥spool¥dabsvdemon.log

エラートレース

UNIX：

DABroker運用ディレクトリ/spool/dabevttrcerr1，及びdabevttrcerr2

Windows：

DABroker運用ディレクトリ¥spool¥dabevttrcerr1，及びdabevttrcerr2

注意事項

各ログファイルの最大容量を次に示します。

UNIX：2GB

Windows：4GB

ログファイルを単調増加に設定している場合は，定期的に削除してください。ログファイルが最大容量を超えるとファイルの書き込みエラーで業務が停止する場合があります。

(b)　DABrokerの定義ファイル

次のファイルをコピーして保存してください。

DABroker動作環境定義ファイル

UNIX：

DABroker運用ディレクトリ/conf/dasysconf

Windows：

DABroker運用ディレクトリ¥conf¥dasysconf

接続先データベース定義ファイル

障害対策用として保存するファイルには，パスワードなどの公開できない情報は削除しておくことをお勧めします。

UNIX：

DABroker運用ディレクトリ/conf/dadbenv

Windows：

DABroker運用ディレクトリ¥conf¥dadbenv

運用情報ファイル（UNIX）

/opt/DABroker/.dabrokerenv

コネクションマルチ定義ファイル

UNIX：

DABroker運用ディレクトリ/conf/damconenv

Windows：

DABroker運用ディレクトリ¥conf¥damconenv

(c)　トレースを取得している場合

トレースの取得を設定している場合は，データベースアクセストレース，通信トレースをファイルに出力して保存してください。

データベースのアクセストレースの出力方法

UNIXの場合

dabdbtrcコマンドを使用します。dabdbtrcコマンドについては「6.4.2　データベースアクセストレースの表示」を参照してください。

Windowsの場合

DABrokerトレース出力ユティリティを使用します。ユティリティについては，「4.9.2(3)データベースアクセストレースの出力方法」を参照してください。

通信トレースの出力方法

UNIXの場合

dabcltrcコマンドを使用します。dabcltrcコマンドについては「3.8.2　クライアントとの通信トレースの表示」を参照してください。

Windowsの場合

DABrokerトレース出力ユティリティを使用します。ユティリティについては，「4.9.2(2)　クライアントとの通信トレースの出力方法」を参照してください。

(2)　システムのトラブルシュート情報

(a)　UNIXの場合

システムログファイル

システムログファイルをコピーして保存してください。

HP-UX：

/var/adm/syslog/syslog.log

Linux：

/var/log

AIX：

/var/adm/ras

システムダンプ

DABrokerの異常終了時の情報がcoreファイルに格納されています。この情報をコピーして保存してください。標準では，開発したアプリケーションを起動したディレクトリに格納されますが，格納先はアプリケーションに依存します。

(b)　Windowsの場合

イベントログ

イベントログをファイルに取得してください。取得方法は次のとおりです。

Windowsの［管理ツール］から［イベントビューア］を開く。

［ログ］メニューの［アプリケーション］を選択し，表示をアプリケーションに変更する。

［ログ］メニューの［名前をつけて保存］を選択し，ログをファイルに保存する。

(3)　XAインタフェースでのトラブルシュート情報

XAインタフェースでのトラブルシュート情報は，XAトレースファイルとして取得します。

XAトレースファイルは次のファイルに取得されます。

UNIX：DABroker運用ディレクトリ/spool/db_xainfo.log

Windows：DABroker運用ディレクトリ¥spool¥db_xainfo.log

XAトレースの取得方法については，次の箇所を参照してください。

UNIXの場合：「3.4　DABrokerの動作環境の設定」

Windowsの場合：「4.4　DABroker環境設定」

XAトレースの取得形式については，「6.3.1　XAトレースの取得形式（共通）」を参照してください。

6.2　DABrokerでのタイマー監視

DABrokerでは，タイマー監視を実行しています。

6.2.1　DBPARTNERとDABrokerの接続時のタイマー監視

DABrokerは，DBPARTNERとのコネクションが確立されている間，DBPARTNERからの要求待ちタイムアウトを監視します。このタイムアウトが発生するのは，DABrokerがDBPARTNERからの要求に対して応答を返してから，一定時間DBPARTNERからの要求がない場合です。

DBPARTNERからの要求待ちタイムアウトが発生した場合，DABrokerはDBPARTNERとのコネクションを解放します。データベースにはロールバックを要求して，データベースを切り離します。

6.2.2　Database Connection Server接続時のタイマー監視

DABrokerは，Database Connection ServerとのTCP/IPコネクションが確立されている間，Database Connection Serverからの処理結果応答待ちタイムアウトを監視します。指定した時間内にDatabase Connection Serverから応答がない場合，DABrokerはDatabase Connection ServerとのTCP/IPコネクションを解放します。

6.3　トレースの取得形式（共通）

6.3.1　XAトレースの取得形式（共通）

XAインタフェースでのトラブルシュート情報は，XAトレースファイルとして取得されます。

XAトレースファイルは次のファイルに取得されます。

UNIX：DABroker運用ディレクトリ/spool/db_xainfo.log

Windows：DABroker運用ディレクトリ¥spool¥db_xainfo.log

XAトレースの取得方法については，次の箇所を参照してください。

UNIXの場合：「3.4　DABrokerの動作環境の設定」

Windowsの場合：「4.4　DABroker環境設定」

XAトレースファイルの取得例を次に示します。

取得例

XXXX/XX/XX

取得年月日

XX:XX:XX.XXXXXX

取得時間

[XXX:XXX]

プロセスID：スレッドID

[XXXX:FFFF]

XXXX：イペント種別

"call"：関数呼び出し

"end"：関数リターン

FFFF：XA関数名

rmid=rrrr

RMID

flags=ffff

フラグパラメタ

RMName="nnnn"

RM名称

xa_info="iiii"

XA文字列

xa_open()，又はxa_close()関数の場合だけ，出力されます。

xid=[ffff:gggg:bbbb:dddd]

XID

ffff：フォーマットID

gggg：グローバルトランザクションID長

bbbb：ブランチ修飾子長

dddd：XIDデータ

xa_open()，又はxa_close()関数以外の場合だけ，出力されます。

count=cccc

リカバリ情報取得カウント

xa_recover()関数の場合だけ，出力されます。

return code = rrrr

XA関数の戻り値

イベント種別が"end"の場合だけ，出力されます。

6.3.2　デーモンの生成・消滅・クリーンアップ実行結果ログ（共通）

障害発生からある一定の時間までをさかのぼって，共有メモリがどういう状態であったかを示す情報が次のログファイルに取得されます。

UNIX：DABroker運用ディレクトリ/spool/dabsvdemon.log

Windows：DABroker運用ディレクトリ¥spool¥dabsvdemon.log

ログファイルの大きさは，環境変数DABSVLOGSIZEで指定します。指定方法は「3.5　DABrokerの動作環境の設定項目（UNIX）」または，「4.5　DABroker環境設定項目（Windows）」参照してください。

メッセージは次の形式で出力されます。

次にデーモンの生成・消滅・クリーンアップ実行結果ログの出力例を以下に示します。

出力されるメッセージ内容を以下に示します。

出力プログラム

DABroker

メッセージID

KFDB301YM-I

メッセージ

Clean up. {xxx,yyy,zzz} , {sss}

内容

クライアントとの通信サーバデーモンのクリーンアップを実行しました。

xxx：クリーンアップ前のデーモン数。

yyy：クリーンアップしたデーモン数。

zzz：クリーンアップ実行後のデーモン数。

sss：DABrokerの状態。

0：正常実行中。

1：正常終了中。

2：計画終了中。

3：強制終了中。

出力プログラム

DABroker

メッセージID

KFDB302YM-I

メッセージ

dabtcpdmn {xxx} start. [yyyy]

内容

クライアントとの通信サーバデーモンを起動しました。

xxx：dabtcpdmnの引数

yyyy：起動したプロセスID

出力プログラム

DABroker

メッセージID

KFDB303YM-I

メッセージ

dabtcpdmn end. [xxxx]

内容

クライアントとの通信サーバデーモンを終了しました。

yyyy：起動したプロセスID

注意事項

DABroker動作環境定義のDABMAXBLOCKUSERSに2以上の値が設定されている場合，DABrokerは1つのプロセスで複数のユーザとの接続を実現しているため，クライアントが接続していない状態でも，クリーンアップの対象ログ（KFDB301YM-Iメッセージ）が出力されます。

本ログ出力によりディスクを圧迫したくない場合は，DABroker動作環境定義ファイル（dasysconf）のOTHERS節に，DAB_DEMON_LOG_MODE=LIMITEDの定義を追加することにより抑止することができます。

DAB_DEMON_LOG_MODEの設定方法については「3.5.6　その他の設定（UNIX）」または，「4.5.4　その他の設定（Windows）」を参照してください。

6.4　データベースアクセストレース（UNIX）

ここでは，UNIXの場合のデータベースアクセストレースについて説明します。

6.4.1　データベースアクセストレース選択オプション

ここでは，データベースアクセストレース情報を任意に選択して出力する場合に設定する項目について示します。

データベースアクセストレース情報を任意に選択して出力する機能を，データベースアクセストレース選択オプションといいます。

データベースアクセストレース選択オプションは，DABrokerの動作環境の基本項目で設定します。設定した項目は，「3.5.1(3)　DABSQL_TRCSIZE（データベースアクセストレースの取得）」の設定項目の値を「0」と指定した場合に有効になります。

拡張データベースアクセストレース機能使用時に出力できる項目については，「3.5.1(10)　DABEXSQL_TRC_LINE（拡張データベースアクセストレースを取得する）」に0，又は1024〜32767を設定しておく必要があります。

データベースアクセストレース選択オプション使用時の注意事項

データベースアクセストレース選択オプションでは，すべての設定項目の値を指定する必要はありません。指定を省略すると，標準値「ON」が仮定されます。

すべての設定項目の値を「OFF」にし，「3.5.1(3)　DABSQL_TRCSIZE（データベースアクセストレースの取得）」の設定項目の値を「0」と指定した場合も文法エラーにはなりません。この場合，データベースアクセストレースは取得しません。

「ON」が指定された設定項目に該当する，すべてのデータベースへの要求がなかった場合，データベースアクセストレースにはヘッダ（出力項目名）だけが出力されます。

(1)　DABSQL_TRC_CONNECT（CONNECT情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，データベースヘの接続要求の情報を取得するかどうかを設定します。

(2)　DABSQL_TRC_DISCONNECT（DISCONNECT情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，トランザクションの正常終了と切り離し要求の情報を取得するかどうかを設定します。

(3)　DABSQL_TRC_COMMIT（COMMIT情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，トランザクションの正常終了と更新の情報を取得するかどうかを設定します。

(4)　DABSQL_TRC_ROLLBACK（ROLLBACK情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，トランザクションを取り消し，更新を無効にする要求の情報を取得するかどうかを設定します。

(5)　DABSQL_TRC_PREPARE（PREPARE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，SQLの前処理要求の情報を取得するかどうかを設定します。

(6)　DABSQL_TRC_DESCRIBE（DESCRIBE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，前処理したSQLの情報を取得する要求の情報を取得するかどうかを設定します。

注意事項

前処理したSQLの情報には，入力情報（DESC_IN）と出力情報（DESC_OUT）があります。どちらか一方だけの出力設定はできません。

(7)　DABSQL_TRC_DECLARE（DECLARE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，前処理したSELECTに対してカーソルを宣言する要求の情報を取得するかどうかを設定します。

(8)　DABSQL_TRC_OPEN（OPEN情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，カーソルの位置付け要求の情報を取得するかどうかを設定します。

(9)　DABSQL_TRC_FETCH（FETCH情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，行を読み込んでカーソルを進める要求の情報を取得するかどうかを設定します。

(10)　DABSQL_TRC_EXECUTE（EXECUTE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，前処理したSQLの実行要求の情報を取得するかどうかを設定します。

(11)　DABSQL_TRC_CLOSE（CLOSE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，カーソルを閉じる要求の情報を取得するかどうかを設定します。

(12)　DABSQL_TRC_CANCEL（CANCEL情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，データベースに対する処理中断要求の情報を取得するかどうかを設定します。

(13)　DABSQL_TRC_LOGGING（LOGGING情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースにLOGGING要求の情報を取得するかどうかを設定します。

(14)　DABSQL_TRC_LOGLESS（LOGLESS情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースにLOGLESS要求の情報を取得するかどうかを設定します。

(15)　DABSQL_TRC_ATTACH（ATTACH情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，サーバとのアクセスパス作成要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(16)　DABSQL_TRC_ATTRGET（ATTRGET情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ハンドルの属性取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(17)　DABSQL_TRC_ATTRSET（ATTRSET情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ハンドルの属性設定要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(18)　DABSQL_TRC_BIND（BIND情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，パラメタのバインド要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(19)　DABSQL_TRC_CHARFORM（CHARFORM情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，キャラクタセットフォームの取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(20)　DABSQL_TRC_CHARID（CHARID情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，キャラクタセットIDの取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(21)　DABSQL_TRC_DEFINE（DEFINE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，パラメタの定義要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(22)　DABSQL_TRC_DESALLOC（DESALLOC情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，記述子の領域確保の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(23)　DABSQL_TRC_DESCANY（DESCANY情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，オブジェクトの記述要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(24)　DABSQL_TRC_DESFREE（DESFREE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，記述子の領域解放の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(25)　DABSQL_TRC_DETACH（DETACH情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，サーバとのアクセスパス削除要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(26)　DABSQL_TRC_ENVCREATE（ENVCREATE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，環境作成要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(27)　DABSQL_TRC_ERRGET（ERRGET情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，エラー情報取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(28)　DABSQL_TRC_GETPIECE（GETPIECE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ピース情報取得要求の情報を取得するかどうかを設定します。

HiRDB以外に接続している場合

この設定項目は，DABroker for Javaからデータベースの機能を使用する場合だけ有効です。

トレースに，ピース情報取得要求の情報を取得するかどうかを設定します。

HiRDBに接続している場合

スカラ関数POSITION実行要求の情報を取得するかどうかを設定します。

この情報は，クライアントがDABroker for Javaで次の条件すべてを満たす場合に有効になります。

接続しているデータベースがHiRDBで，HiRDBのサーバとクライアントのバージョンが共に07-01以上

DABroker for Javaのバージョンが02-12以上

DABrokerが暗黙的に次のSQLを実行した場合

SET文を実行し，代入値にスカラ関数POSITIONを使用します。

(29)　DABSQL_TRC_HDLALLOC（HDLALLOC情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ハンドルの領域確保の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(30)　DABSQL_TRC_HDLFREE（HDLFREE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ハンドルの領域解放の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(31)　DABSQL_TRC_LOBCLOSE（LOBCLOSE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，BFILEデータのクローズ要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(32)　DABSQL_TRC_LOBLEN（LOBLEN情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，LOBデータの長さ取得要求の情報を取得するかどうかを設定します。

HiRDB以外に接続している場合

この設定項目は，DABroker for Javaからデータベースの機能を使用する場合だけ有効です。

トレースに，LOBデータの長さ取得要求の情報を取得するかどうかを設定します。

HiRDBに接続している場合

スカラ関数LENGTH実行要求の情報を取得するかどうかを設定します。

この情報は，クライアントがDABroker for Javaで次の条件すべてに一致する場合に有効になります。

接続しているデータベースがHiRDBで，HiRDBのサーバとクライアントのバージョンが共に07-01以上

DABroker for Javaのバージョンが02-12以上

DABrokerが暗黙的に次のSQLを実行した場合

SET文を実行し，代入値にスカラ関数LENGTHを使用します。

(33)　DABSQL_TRC_LOBOPEN（LOBOPEN情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，BFILEデータのオープン要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(34)　DABSQL_TRC_LOBREAD（LOBREAD情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，LOBデータの読み込み要求の情報を取得するかどうかを設定します。

HiRDB以外に接続している場合

この設定項目は，DABroker for Javaからデータベースの機能を使用する場合だけ有効です。

トレースに，LOBデータの読み込み要求の情報を取得するかどうかを設定します。

HiRDBに接続している場合

スカラ関数SUBSTR実行要求の情報を取得するかどうかを設定します。

この情報は，クライアントがDABroker for Javaで，次の条件すべてに一致する場合に有効になります。

接続しているデータベースがHiRDBで，HiRDBのサーバとクライアントのバージョンが共に07-01以上

DABroker for Javaのバージョンが02-12以上

DABrokerが暗黙的に下記SQLを実行した場合

SET文を実行し，代入値にスカラ関数SUBSTRを使用します。

(35)　DABSQL_TRC_LOBWRITE（LOBWRITE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，LOBデータの書き込み要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(36)　DABSQL_TRC_PARAMGET（PARAMGET情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，パラメタ情報取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(37)　DABSQL_TRC_SESBEGIN（SESBEGIN情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，セッション開始要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(38)　DABSQL_TRC_SESEND（SESEND情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，セッション終了要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(39)　DABSQL_TRC_SETPIECE（SETPIECE情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ピース情報設定要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(40)　DABSQL_TRC_GETDIAG（GETDIAG情報出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，エラー情報取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(41)　DABSQL_TRC_AUTO_COMMIT_OFF（AUTO COMMIT OFF出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，AUTO COMMIT OFF設定要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(42)　DABSQL_TRC_AUTO_COMMIT_ON（AUTO COMMIT ON出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，AUTO COMMIT ON設定要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(43)　DABSQL_TRC_GET_INFO（GET INFO出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，接続後の動作情報取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(44)　DABSQL_TRC_SET_INFO（SET INFO出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，接続後の動作情報設定要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(45)　DABSQL_TRC_EXECUTE_DIRECT（EXECUTE DIRECT出力要求）

標準値

ON

指定範囲

ON又はOFF（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，SQLの前処理後に実行する要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

6.4.2　データベースアクセストレースの表示

コマンド形式

# dabdbtrc [-u ユーザID] [-p アプリケーションの名称]

機能

DABrokerがデータベースに要求した処理，及びその処理に対するデータベースからの応答（アクセストレース）を表示します。

なお，アクセストレースの取得は，DBMSに要求を出す直前及びDBMSから応答が返ってきた直後に，DABrokerが行っています。

使用できるユーザ

DABrokerの管理ユーザ

オプション

指定なし

すべてのアプリケーションからの要求に対して行ったデータベースアクセストレースを表示します。

-u ユーザID

指定したユーザIDを持つアプリケーションからの要求で行った，データベースアクセストレースを表示します。

-p アプリケーションの名称

指定した名称のアプリケーションからの要求で行った，データベースアクセストレースを表示します。指定できる名称は次のとおりです。

アプリケーションの種類

指定する名称

DABroker関連製品で開発したアプリケーションからアクセスする場合

アプリケーションで設定した名称

(各DABroker関連マニュアル参照)

DBPARTNER/Client又は

DBPARTNER/Webからアクセスする場合

DBPARTNER/Client又はDBPARTNER/Webの識別情報

ここで入力した名称は，PAPNAMEに出力されます。

出力例

UID=XXXXXXXX

ユーザID

PAPNAME=XXXXXXX

アプリケーションを識別するための文字列が表示されます。表示される文字列は，-pオプションで指定できる名称です。

DBNAME=XXXXXXX

接続先データベース

次のどれかが表示されます。

HiRDB：HiRDB Version 7，HiRDB Version 8，HiRDB Version 9，又はHiRDB Version 10

ORACLE7：Oracle10g，Oracle11g，もしくはOracle12cでOracle Call Interface 7を使用している場合，又はOracle19cでOracle Call Interface 8iを使用している場合。

ORACLE8i：Oracle10g，Oracle11g，Oracle12c，又はOracle19cでOracle Call Interface 8iを使用している場合。

DBCSV：Database Connection Server

DATE

アクセスの発生日（年/月/日）

TIME

アクセスの発生時刻（時:分:秒.n）

nはn/100秒を表します。

EVT

DABrokerがデータベースに要求した処理の内容

次のどれかが表示されます。

EVTの表示

処　理　内　容

CONNECT

データベースと接続します。

分散トランザクション連携機能使用時は，データベースに対するアクセス要求ではなく，アプリケーションからのCONNECT要求に対応したイベントになります。

PREPARE

SQLの前処理をします。

DESCRIBE

前処理したSQLの情報を返します。

DECLARE

前処理したSELECTに対してカーソルを宣言します。

OPEN

カーソルを位置付けます。

FETCH

行を読み込んでカーソルを進めます。

CLOSE

カーソルを閉じます。

EXECUTE

前処理したSQLを実行します。

COMMIT

トランザクションを正常終了，更新を有効にします。

ROLLBACK

トランザクションを取り消し，更新を無効にします。

DISCONNECT

トランザクションを正常終了，切り離します。

分散トランザクション連携機能使用時は，データベースに対するアクセス要求ではなく，アプリケーションからのDISCONNECT要求に対応したイベントになります。

CANCEL

DBMSに対し，処理を中断します。

データベースアクセストレース情報を任意に選択して出力することもできます。任意に選択して出力する場合は，DABroker動作環境定義ファイルに，データベースアクセストレース選択オプションの項目を設定する必要があります。データベースアクセストレース選択オプションについては，「6.4.1　データベースアクセストレース選択オプション」を参照してください。

RETCODE

DABrokerが要求した処理に対して，DBMSから返されるリターンコード

0：正常終了

0以外：異常終了又はメッセージ付きの正常終了

なお，DABrokerからDBMSへの要求の送信を表す行では，RETCODEは空白になります。また，RDA Link for Gatewayの場合は，RETCODEは空白になります。

INFORMATION

Fetch時の行取得要求数及び取得結果の情報

「BLOCK COUNT（XXX）」の形式で出力されます。

(SQL)

アプリケーションから要求のあったSQLの内容。この項目は，必要に応じて表示されます。

注意事項

アプリケーションからの要求量（SQL文）が多いほど，データベースアクセストレースのファイル容量も多くなります。トレースは，1レコード80バイトで表示されます。アプリケーションからの要求（SQL文）が多い場合は，折り返して表示します。データベースアクセストレースのファイル容量の目安として，概算式を次に示します。

（概算式）

{(アプリケーションからの要求（SQL長など）* 2) + 2 [ +↓(アプリケーションからの要求SQL長/73)↓-1] } * 80〔バイト〕

注　下線は，SQL長が73バイト以上の場合です。

あらかじめ，この概算式で計算したサイズ以上のハードディスク容量を用意しておいてください。また，アプリケーションからの要求量が多いほど，トレース表示が終わるまでにも時間がかかります。御注意ください。

6.4.3　拡張データベースアクセストレース機能

(1)　機能概要

拡張データベースアクセストレースでは，従来のDABrokerのデータベースアクセストレースと比較して，次の機能が拡張されています。

データベースへの接続ごと（接続から切断まで）にトレースを取得できます。

データベース接続中でも，トレースファイルの参照やコピーができます。

マルチスレッドでアプリケーションが動作している場合，データベースアクセスを実行したスレッドを特定できます。

DABroker動作環境定義ファイルの設定によって，出力するイベントの種類を選択できます。

DABroker動作環境定義ファイルの設定によって，ファイルの最大容量を設定できます。トレース情報が最大容量を超える場合，最大2世代で取得ファイルを切り替えてトレースを取得できます。

(2)　適用範囲

拡張データベースアクセストレース機能は，次のような場合に有効です。

データベースのアクセス中に障害が発生した場合，迅速に障害を切り分ける必要がある。

24時間稼働などのために，稼働中のアプリケーションを終了しないで障害を調査する必要がある。

マルチスレッド環境でアプリケーションが動作していて，スレッドごとのデータベースアクセス履歴を取得したい。

コネクションプーリングなどを使用していて，データベースへの接続ごとのデータベースアクセス履歴を取得する必要がある。

障害の再現調査ができないため，常時トレースを取得する必要がある。

(3)　DABroker動作環境定義

拡張データベースアクセストレースを取得する設定は，DABroker動作環境定義ファイルで設定します。

DABroker動作環境定義ファイルでの設定方法については，「3.5　DABrokerの動作環境の設定項目」を参照してください。

(4)　出力形式

拡張データベースアクセストレースのファイル出力形式を次に示します。

Oracle19cでOracle7接続の場合，Oracle12c以前とは出力するイベントが変わるなど，出力内容が異なります。

ヘッダ情報

*-------------------------------------------------------*
*- DataBase Access Information (DRV)                   -*
*- Date  YYYY/MM/DD hh:mm:ss.nnnnnn                    -*
*-------------------------------------------------------*
DABroker Connect ID    : AAAAA(BBBBB)
Process ID             : CCCCC
UserID                 : DDDDD
Client Name            : EEEEE
(DB別出力情報)
Lang Mode              : GGGGG

個々のトレース情報

THREAD-ID  CID   EVT   START-TIME   END-TIME   RETCODE
BLOCKCNT  HiRDB_CONNECTION_ID (SQL)SS…SS

DRV

DABrokerのデータベースアクセスドライバの種別に従い，次の識別子が出力されます。

HiRDB接続の場合

HiRDB Driver

Oracle8i接続の場合

ORACLE8i Driver※（Oracle Call Interface 8iを使用）

Oracle7接続の場合

ORACLE7 Driver（Oracle19c以外でOracle Call Interface 7を使用している場合，又はOracle19cでOracle Call Interface 8iを使用している場合）

Database Connection Server経由メインフレーム系データベース接続の場合

DBS

注※

DABroker for JavaからOracle8iの機能を使用する場合だけ出力されます。

Date

ファイル作成日時（YYYY/MM/DD hh:mm:ss.nnnnnn）が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

DABroker Connect ID

データベース接続識別子が出力されます。

Process ID

実行プロセスIDが出力されます。

UserID

接続ユーザIDが出力されます。

DABroker for JavaでORACLEのOS認証機能を使用した場合は，「OS authority」となります。

Client Name

UAP名称が出力されます。名称が設定されていない場合は空白になります。

(DB別出力情報)

接続データベースによって異なる情報が出力されます。出力内容について，表6-1に示します。

表6‒1　接続データベースごとのトレース出力内容

接続データベース

出力内容

説明

HiRDB

PDHOST：

HiRDB接続時のPDHOSTの設定内容です。未設定の場合は，"Not Indicator"が出力されます。

PDNAMEPORT：

HiRDB接続時のPDNAMEPORTの設定内容です。未設定の場合は，"Not Indicator"が出力されます。

Oracle

SQLNET：

Oracleリスナー名が出力されます。未設定の場合は，"Not Indicator"が出力されます。

Databease Connction Server

Access DataBase：

接続しているホストDB名称が出力されます。

VOS3 XDM RD E2接続の場合：VOS3 XDM/RD E2

VOS3 XDM SD E2接続の場合：VOS3 XDM/SD E2

VOS1 RDB1 E2接続の場合：VOS1 RDB1 E2

VOS1 PDMII E2接続の場合：VOS1 PDM2 E2

VOSK SQL/K接続の場合：VOSK SQL/K

VOSKスプールファイル接続の場合：VOSK SPOOL

未設定の場合：Unknown DBMS

Node Name：

データベース識別子の情報が出力されます。未設定の場合は，"Not Indicator"が出力されます。

Lang Mode

実行言語モードが出力されます。

THREAD-ID

実行スレッドIDが出力されます。

CID

カーソル番号が出力されます。

EVT

DABrokerがデータベースに要求した処理の内容です。

出力するイベントの種類は任意に選択できます。

選択できるイベントについては，「6.4.1　データベースアクセストレース選択オプション」を参照してください。

また，拡張データベースアクセストレースで出力イベントの種類を変更すると,従来のデータベースアクセストレースの出力イベントの種類も変更されます。

すべてのイベント出力をOFFにした場合はヘッダだけが出力されます。

次のイベントは，既存のデータベースアクセストレースにはありません。また，イベント出力を一つでもONにした場合，GET_DIAGイベントの出力を抑止できません。

ATTACH：サーバとのアクセスパス作成要求を実行します。

ATTRGET：ハンドル属性の取得要求を実行します。

ATTRSET：ハンドル属性の設定要求を実行します。

AUTOCOMOFF：AUTO COMMITモードの解除要求を実行します。

AUTOCOMON：AUTO COMMITモードの設定要求を実行します。

BIND：パラメタのバインド要求を実行します。

CHARFORM：キャラクタセットフォームの取得要求を実行します。

CHARID：キャラクタセットIDの取得要求を実行します。

DEFINE：パラメタの定義要求を実行します。

DESALLOC：記述子の領域確保を実行します。

DESC_OUT：前処理したSQLの出力情報を返します。

DESC_IN ：前処理したSQLの入力情報を返します。

DESCANY：オブジェクトの記述要求を実行します。

DESFREE：記述子の領域解放を実行します。

DETACH：データベースアクセスパス削除要求を実行します。

ENVCREATE：環境作成要求を実行します。

ERRGET：エラー情報取得要求を実行します。

EXECDIRECT：SQLの前処理後の実行処理です。

GET_DIAG：エラー詳細情報の取得処理を実行します。

GETINFO：接続後の動作情報の取得要求を実行します。

GETPIECE：ピース情報の取得要求を実行します。

HDLALLOC：ハンドルの領域確保を実行します。

HDLFREE：ハンドルの領域解放を実行します。

LOBCLOSE：BFILEデータのクローズ要求を実行します。

LOBLEN：LOBデータの長さ取得要求を実行します。

LOBOPEN：BFILEデータのオープン要求を実行します。

LOBREAD：LOBデータの読み込み要求を実行します。

LOBWRITE：LOBデータの書き込み要求を実行します。

PARAMGET：パラメタ情報の取得要求を実行します。

SESBEGIN：セション開始要求を実行します。

SESEND：セション終了要求を実行します。

SETINFO：接続後の動作情報の設定要求を実行します。

SETPIECE：ピース情報の設定要求を実行します。

START-TIME

アクセス開始日時（YYYY/MM/DD hh:mm:ss.nnnnnn）が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

END-TIME

アクセス終了日時（YYYY/MM/DD hh:mm:ss.nnnnnn）が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

RETCODE

データベースから返されるリターンコードが出力されます。

BLOCKCNT

FETCH時の行取得件数が出力されます。

HiRDB_CONNECTION_ID

(a)HiRDBサーバに接続する場合

コネクションID（aaaa：bbbbb：cccc）が出力されます。

aaaa：フロントエンドサーバ名（HiRDB/Paraller Server使用時），又はシングルサーバ（HiRDB/Single Server使用時）

bbbbb：aaaaで示すサーバの接続通番

cccc：aaaaで示すサーバのプロセスID，及びコネクションIDプロセスIDとコネクションIDは，HiRDBクライアントのバージョンが07-01以降で，サーバがHiRDBの場合だけ出力されます。HiRDBクライアントのバージョンが07-01未満で，サーバがHiRDBの場合は，ヘッダ（HiRDB_CONNECTION_ID）だけが出力され，コネクションIDは出力されません。なお，この情報は，CONNECT，COMMIT，ROLLBACK，PREPARE，EXECUTE，又はDIRECTを実行したときに，最新の情報に更新されます。

(b)HiRDBクライアント経由でXDM/RD E2に接続する場合

コネクションID（aaaa：bbbbb：cccc）が出力されます。

aaaa：JOB名称

bbbbb：コネクト通番

cccc：サーバユーザ番号

この情報は，HiRDBクライアントのバージョンが07-02以降で，サーバがXDM/RD E2 11-00以降，かつ，Database Connection Server05-00以降の場合のみ出力されます。

この条件に満たない場合，ヘッダ（HiRDB_CONNECTION_ID）だけが出力され，コネクションIDは出力されません。なお，この情報は，CONNECT，COMMIT，ROLLBACK，PREPARE，EXECUTE，又はDIRECTを実行したときに，最新の情報に更新されます。

(SQL)

クライアントから要求のあったSQLの内容が出力されます。この項目は，必要に応じて出力されます。

(5)　ファイル名称

拡張データベースアクセストレースのファイルは，次のディレクトリに作成されます。

DABroker運用ディレクトリ/spool/db_access

拡張データベースアクセストレースのファイル名称は，次の規則に従います。

spdb_XXXXXXXX_YYYYYYYY_＊＊＊＊ZZZZZ.IIIIII

＊＊＊＊：接続データベース名称

HiRDBの場合

HiRDB

Oracle8i接続の場合

Oracle8i※

Oracle7の場合

Oracle7

Database Connection Server経由メインフレーム系データベースの場合

DBS

注※

DABroker for JavaからOracle8iの機能を使用する場合だけ出力されます。

XXXXXXXX：実行プロセスID

YYYYYYYY：データベース接続識別子

ZZZZZ：識別順序番号

同じプロセスIDで，かつ同じデータベース接続識別子のファイルがある場合に，00000から32767までの番号を付加します。

IIIIII：ファイル拡張子

log：最新のトレースファイル

logold：1世代前のトレースファイル

(6)　ファイルの運用方法

拡張データベースアクセストレースは，DABroker動作環境定義ファイルで設定した行数を超える出力があった場合，現在のトレースファイルをバックアップファイルとして別名で保存します(バックアップファイルの名称については，「6.4.3(5)　ファイル名称」参照)。トレース内容は，トレースファイルの先頭から再び出力します。

バックアップファイルは1世代前までしか残しません。このため，既にバックアップファイルがあり，現在のトレースファイルが設定した行数を超えると, バックアップファイルを上書きします。バックアップファイルを保存する必要がある場合は，あらかじめ別のディレクトリに退避してください。

トレースファイルは実行しているコネクションの数だけ作成されます。

トレースファイルは自動的に削除されません。ユーザが不要になった時点で削除してください。

ハードディスクの空き容量が十分でない場合，トレースの出力が停止されることがあります。

6.5　データベースアクセストレース（Windows）

ここでは，Windowsの場合のデータベースアクセストレースについて説明します。

6.5.1　アクセストレース設定

アクセストレースに取得する情報の種類を選択するには，［DABroker動作環境設定］ダイアログボックスの［共通設定］タブから，［アクセストレース］ボタンを押して，［アクセストレース設定］ダイアログボックスを表示します。アクセストレースを取得する場合は，［アクセストレース設定］ダイアログボックスで，取得する情報の種類を必ず一つ以上ON（チェックあり）にしてください。

拡張データベースアクセストレース機能使用時に出力できる項目については，「4.5.1(10)　拡張データベースアクセストレースを取得する（DABEXSQL_TRC_LINE）」をON（チェックあり）にしておく必要があります。

取得できる情報の種類は次のとおりです。すべての情報の初期値はON（チェックあり）です。

(1)　CANCEL（DABSQL_TRC_CANCEL）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，DBMSに対する処理中断要求の情報を取得するかどうかを設定します。

(2)　CLOSE（DABSQL_TRC_CLOSE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，カーソルを閉じる要求の情報を取得するかどうかを設定します。

(3)　COMMIT（DABSQL_TRC_COMMIT）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，トランザクションの正常終了，更新を有効にする要求の情報を取得するかどうかを設定します。

(4)　CONNECT（DABSQL_TRC_CONNECT）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，データベースとの接続要求の情報を取得するかどうかを設定します。

(5)　DECLARE（DABSQL_TRC_DECLARE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，前処理したSELECTに対してカーソルを宣言する要求の情報を取得するかどうかを設定します。

(6)　DESCRIBE（DABSQL_TRC_DESCRIBE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，前処理したSQLの情報を取得する要求の情報を取得するかどうかを設定します。

(7)　DISCONNECT（DABSQL_TRC_DISCONNECT）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，トランザクションを正常終了，切り離し要求の情報を取得するかどうかを設定します。

(8)　EXECUTE（DABSQL_TRC_EXECUTE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，前処理したSQLの実行要求の情報を取得するかどうかを設定します。

(9)　FETCH（DABSQL_TRC_FETCH）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，行を読み込んでカーソルを進める要求の情報を取得するかどうかを設定します。

(10)　LOGGING（DABSQL_TRC_LOGGING）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースにLOGGING要求の情報を取得するかどうかを設定します。

(11)　LOGLESS（DABSQL_TRC_LOGLESS）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースにLOGLESS要求の情報を取得するかどうかを設定します。

(12)　PREPARE（DABSQL_TRC_PREPARE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，SQLの前処理要求の情報を取得するかどうかを設定します。

(13)　ROLLBACK（DABSQL_TRC_ROLLBACK）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，トランザクションを取り消し，更新を無効にする要求の情報を取得するかどうかを設定します。

(14)　OPEN（DABSQL_TRC_OPEN）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，カーソルの位置付け要求の情報を取得するかどうかを設定します。

(15)　ATTACH（DABSQL_TRC_ATTACH）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，サーバとのアクセスパス作成要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(16)　ATTRGET（DABSQL_TRC_ATTRGET）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ハンドルの属性取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(17)　ATTRSET（DABSQL_TRC_ATTRSET）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ハンドルの属性設定要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(18)　BIND（DABSQL_TRC_BIND）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，パラメタのバインド要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(19)　CHARFORM（DABSQL_TRC_CHARFORM）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，キャラクタセットフォームの取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(20)　CHARID（DABSQL_TRC_CHARID）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，キャラクタセットIDの取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(21)　DEFINE（DABSQL_TRC_DEFINE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，パラメタの定義要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(22)　DESALLOC（DABSQL_TRC_DESALLOC）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，記述子の領域確保の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(23)　DESCANY（DABSQL_TRC_DESCANY）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，オブジェクトの記述要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(24)　DESFREE（DABSQL_TRC_DESFREE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，記述子の領域解放の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(25)　DETACH（DABSQL_TRC_DETACH）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，サーバとのアクセスパス削除要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(26)　ENVCREATE（DABSQL_TRC_ENVCREATE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，環境作成要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(27)　ERRGET（DABSQL_TRC_ERRGET）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，エラー情報取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(28)　GETPIECE（DABSQL_TRC_GETPIECE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ピース情報取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

HiRDB以外に接続している場合

この設定項目は，DABroker for Javaからデータベースの機能を使用する場合だけ有効です。

トレースに，ピース情報取得要求の情報を取得するかどうかを設定します。

HiRDBに接続している場合

スカラ関数POSITION実行要求の情報を取得するかどうかを設定します。

この情報は，クライアントがDABroker for Javaで次の条件すべてを満たす場合に有効になります。

接続しているデータベースがHiRDBで，HiRDBのサーバとクライアントのバージョンが共に07-01以上

DABroker for Javaのバージョンが02-12以上

DABrokerが暗黙的に次のSQLを実行した場合

SET文を実行し，代入値にスカラ関数POSITIONを使用します。

(29)　HDLALLOC（DABSQL_TRC_HDLALLOC）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ハンドルの領域確保の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(30)　HDLFREE（DABSQL_TRC_HDLFREE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ハンドルの領域解放の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(31)　LOBCLOSE（DABSQL_TRC_LOBCLOSE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，BFILEデータのクローズ要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(32)　LOBLEN（DABSQL_TRC_LOBLEN）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，LOBデータの長さ取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

HiRDB以外に接続している場合

この設定項目は，DABroker for Javaからデータベースの機能を使用する場合だけ有効です。

トレースに，LOBデータの長さ取得要求の情報を取得するかどうかを設定します。

HiRDBに接続している場合

スカラ関数LENGTH実行要求の情報を取得するかどうかを設定します。

この情報は，クライアントがDABroker for Javaで次の条件すべてに一致する場合に有効になります。

接続しているデータベースがHiRDBで，HiRDBのサーバとクライアントのバージョンが共に07-01以上

DABroker for Javaのバージョンが02-12以上

DABrokerが暗黙的に次のSQLを実行した場合

SET文を実行し，代入値にスカラ関数LENGTHを使用します。

(33)　LOBOPEN（DABSQL_TRC_LOBOPEN）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，BFILEデータのオープン要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(34)　LOBREAD（DABSQL_TRC_LOBREAD）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，LOBデータの読み込み要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

HiRDB以外に接続している場合

この設定項目は，DABroker for Javaからデータベースの機能を使用する場合だけ有効です。

トレースに，LOBデータの読み込み要求の情報を取得するかどうかを設定します。

HiRDBに接続している場合

スカラ関数SUBSTR実行要求の情報を取得するかどうかを設定します。

この情報は，クライアントがDABroker for Javaで，次の条件すべてに一致する場合に有効になります。

接続しているデータベースがHiRDBで，HiRDBのサーバとクライアントのバージョンが共に07-01以上

DABroker for Javaのバージョンが02-12以上

DABrokerが暗黙的に下記SQLを実行した場合

SET文を実行し，代入値にスカラ関数SUBSTRを使用します。

(35)　LOBWRIT（DABSQL_TRC_LOBWRITE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，LOBデータの書き込み要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(36)　PARAMGET（DABSQL_TRC_PARAMGET）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，パラメタ情報取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(37)　SESBEGIN（DABSQL_TRC_SESBEGIN）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，セッション開始要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(38)　SESEND（DABSQL_TRC_SESEND）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，セッション終了要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(39)　SETPIECE（DABSQL_TRC_SETPIECE）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，ピース情報設定要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

この設定項目は，DABroker for JavaからOracle8iの機能を使用する場合だけ有効です。

(40)　GETDIAG（DABSQL_TRC_GETDIAG）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，エラー情報取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(41)　AUTO COMMIT OFF（DABSQL_TRC_AUTO_COMMIT_OFF）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，AUTO COMMITモード解除要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(42)　AUTO COMMIT ON（DABSQL_TRC_AUTO_COMMIT_ON）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，AUTO COMMITモード設定要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(43)　GET INFO（DABSQL_TRC_GET_INFO）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，接続後の動作情報取得要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(44)　SET INFO（DABSQL_TRC_SET_INFO）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，接続後の動作情報設定要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

(45)　EXECUTE DIRECT（DABSQL_TRC_EXECUTE_DIRECT）

標準値

ON（チェックあり）

指定範囲

ON（チェックあり）又はOFF（チェックなし）

（ON：取得します　OFF：取得しません）

説明

データベースアクセストレースに，SQLの前処理後に実行する要求の情報を取得するかどうかを設定します。

この設定項目は，拡張データベースアクセストレース機能使用時だけ有効です。

6.5.2　拡張データベースアクセストレース機能

(1)　機能概要

拡張データベースアクセストレースでは，従来のDABrokerのデータベースアクセストレースと比較して，次の機能が拡張されています。

データベースへの接続ごと（接続から切断まで）にトレースを取得できます。

データベース接続中でも，トレースファイルの参照やコピーができます。

マルチスレッドでアプリケーションが動作している場合，データベースアクセスを実行したスレッドを特定できます。

DABroker動作環境定義ファイルの設定によって，出力するイベントの種類を選択できます。

DABroker動作環境定義ファイルの設定によって，ファイルの最大容量を設定できます。トレース情報が最大容量を超える場合，最大2世代で取得ファイルを切り替えてトレースを取得できます。

(2)　適用範囲

拡張データベースアクセストレース機能は，次のような場合に有効です。

データベースのアクセス中に障害が発生した場合，迅速に障害を切り分ける必要がある場合

24時間稼働などのために，稼働中のアプリケーションを終了しないで障害を調査する必要がある場合

マルチスレッド環境でアプリケーションが動作していて，スレッドごとのデータベースアクセス履歴を取得したい場合

コネクションプーリングなどを使用していて，データベースへの接続ごとのデータベースアクセス履歴を取得する必要がある場合

障害の再現調査ができないため，常時トレースを取得する必要がある場合

(3)　DABroker動作環境定義

拡張データベースアクセストレースを取得する設定は，DABroker動作環境定義ファイルで設定します。

DABroker動作環境定義ファイルでの設定方法については，「4.5　DABroker環境設定項目」を参照してください。

(4)　出力形式

拡張データベースアクセストレースのファイル出力形式を次に示します。

Oracle19cでOracle7接続の場合，Oracle12c以前とは出力するイベントが変わるなど，出力内容が異なります。

ヘッダ情報

*-------------------------------------------------------*
*- DataBase Access Information (DRV)                   -*
*- Date  YYYY/MM/DD hh:mm:ss.nnnnnn                    -*
*-------------------------------------------------------*
DABroker Connect ID    : AAAAA(BBBBB)
Process ID             : CCCCC
UserID                 : DDDDD
Client Name            : EEEEE
(DB別出力情報)
Lang Mode              : GGGGG

個々のトレース情報

THREAD-ID  CID   EVT   START-TIME   END-TIME   RETCODE
BLOCKCNT  HiRDB_CONNECTION_ID (SQL)SS…SS

DRV

DABrokerのデータベースアクセスドライバの種別に従い，次の識別子が出力されます。

HiRDB接続の場合

HiRDB Driver

Oracle8i接続の場合

ORACLE8i Driver※（Oracle Call Interface 8iを使用）

Oracle7接続の場合

ORACLE7 Driver（Oracle19c以外でOracle Call Interface 7を使用している場合，又はOracle19cでOracle Call Interface 8iを使用している場合）

ODBC3.0接続の場合

ODBC30

Database Connection Server経由メインフレーム系データベース接続の場合

DBS

注※

DABroker for JavaからOracle8iの機能を使用する場合だけ出力されます。

Date

ファイル作成日時（YYYY/MM/DD hh:mm:ss.nnnnnn）が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

DABroker Connect ID

データベース接続識別子が出力されます。

Process ID

実行プロセスIDが出力されます。

UserID

接続ユーザIDが出力されます。

DABroker for JavaでORACLEのOS認証機能を使用した場合は，「OS authority」となります。

Client Name

UAP名称が出力されます。名称が設定されていない場合は空白になります。

(DB別出力情報)

接続データベースによって異なる情報が出力されます。出力内容について，表6-2に示します。

表6‒2　接続データベースごとのトレース出力内容

接続データベース

出力内容

説明

HiRDB

PDHOST：

HiRDB接続時のPDHOSTの設定内容です。未設定の場合は，"Not Indicator"が出力されます。

PDNAMEPORT：

HiRDB接続時のPDNAMEPORTの設定内容です。未設定の場合は，"Not Indicator"が出力されます。

Oracle

SQLNET：

Oracleリスナー名が出力されます。未設定の場合は，"Not Indicator"が出力されます。

ODBC3.0

ODBC Data Source：

ODBC設定のデータソース名が出力されます。未設定の場合は，"Not Indicator"が出力されます。

ODBC Key Word：

ODBC設定の接続情報が出力されます。未設定の場合は，"Not Indicator"が出力されます。

Databease Connction Server

Access DataBase：

接続しているホストDB名称が出力されます。

VOS3 XDM RD E2接続の場合：VOS3 XDM/RD E2

VOS3 XDM SD E2接続の場合：VOS3 XDM/SD E2

VOS1 RDB1 E2接続の場合：VOS1 RDB1 E2

VOS1 PDMII E2接続の場合：VOS1 PDM2 E2

VOSK SQL/K接続の場合：VOSK SQL/K

VOSKスプールファイル接続の場合：VOSK SPOOL

未設定の場合：Unknown DBMS

Node Name：

データベース識別子の情報が出力されます。未設定の場合は，"Not Indicator"が出力されます。

Lang Mode

実行言語モードが出力されます。

THREAD-ID

実行スレッドIDが出力されます。

CID

カーソル番号が出力されます。

EVT

DABrokerがデータベースに要求した処理の内容です。

出力するイベントの種類は任意に選択できます。

選択できるイベントについては，「4.5.1(9)　データベースアクセストレースの取得（DABSQL_TRCSIZE）」を参照してください。ただし，データベースアクセストレースを取得していない場合は，DABroker動作環境定義ファイルを直接編集します。また，拡張データベースアクセストレースで出力イベントの種類を変更すると,従来のデータベースアクセストレースの出力イベントの種類も変更されます。

すべてのイベント出力をOFFにした場合はヘッダだけが出力されます。

次のイベントは，既存のデータベースアクセストレースにはありません。また，イベント出力を一つでもONにした場合，GET_DIAGイベントの出力を抑止できません。

ATTACH：サーバとのアクセスパス作成要求を実行します。

ATTRGET：ハンドル属性の取得要求を実行します。

ATTRSET：ハンドル属性の設定要求を実行します。

AUTOCOMOFF：AUTO COMMITモードの解除要求を実行します。

AUTOCOMON：AUTO COMMITモードの設定要求を実行します。

BIND：パラメタのバインド要求を実行します。

CHARFORM：キャラクタセットフォームの取得要求を実行します。

CHARID：キャラクタセットIDの取得要求を実行します。

DEFINE：パラメタの定義要求を実行します。

DESALLOC：記述子の領域確保を実行します。

DESC_OUT：前処理したSQLの出力情報を返します。

DESC_IN ：前処理したSQLの入力情報を返します。

DESCANY：オブジェクトの記述要求を実行します。

DESFREE：記述子の領域解放を実行します。

DETACH：データベースアクセスパス削除要求を実行します。

ENVCREATE：環境作成要求を実行します。

ERRGET：エラー情報取得要求を実行します。

EXECDIRECT：SQLの前処理後の実行処理です。

GET_DIAG：エラー詳細情報の取得処理を実行します。

GETINFO：接続後の動作情報の取得要求を実行します。

GETPIECE：ピース情報の取得要求を実行します。

HDLALLOC：ハンドルの領域確保を実行します。

HDLFREE：ハンドルの領域解放を実行します。

LOBCLOSE：BFILEデータのクローズ要求を実行します。

LOBLEN：LOBデータの長さ取得要求を実行します。

LOBOPEN：BFILEデータのオープン要求を実行します。

LOBREAD：LOBデータの読み込み要求を実行します。

LOBWRITE：LOBデータの書き込み要求を実行します。

PARAMGET：パラメタ情報の取得要求を実行します。

SESBEGIN：セション開始要求を実行します。

SESEND：セション終了要求を実行します。

SETINFO：接続後の動作情報の設定要求を実行します。

SETPIECE：ピース情報の設定要求を実行します。

START-TIME

アクセス開始日時（YYYY/MM/DD hh:mm:ss.nnnnnn）が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

END-TIME

アクセス終了日時（YYYY/MM/DD hh:mm:ss.nnnnnn）が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，nnnnnn：マイクロ秒

RETCODE

データベースから返されるリターンコードが出力されます。

BLOCKCNT

FETCH時の行取得件数が出力されます。

HiRDB_CONNECTION_ID

コネクションID（aaaa：bbbb：cccc）が出力されます。

aaaa：フロントエンドサーバ名（HiRDB/Parallel Server使用時），又はシングルサーバ（HiRDB/Single Server使用時）

bbbb：aaaaで示すサーバの接続通番

cccc：aaaaで示すサーバのプロセスID，及びコネクションID

プロセスIDとコネクションIDは，HiRDBクライアントのバージョンが07-01以降で，サーバがHiRDBの場合だけ出力されます。HiRDBクライアントのバージョンが07-01未満で，サーバがHiRDBの場合は，ヘッダ（HiRDB_CONNECTION_ID）だけが出力され，コネクションIDは出力されません。また，サーバがXDM/RDの場合は，ヘッダ（HiRDB_CONNECTION_ID），及びコネクションIDは出力されません。なお，この情報は，CONNECT，COMMIT，ROLLBACK，PREPARE，EXECUTE，又はDIRECTを実行したときに，最新の情報に更新されます。

(SQL)

クライアントから要求のあったSQLの内容が出力されます。この項目は，必要に応じて出力されます。

(Windows QueryPerformance Counter)

高分解パフォーマンス情報が表示されます。

(5)　ファイル名称

拡張データベースアクセストレースのファイルは，次のディレクトリに作成されます。

DABroker運用ディレクトリ¥spool¥db_access

拡張データベースアクセストレースのファイル名称は，次の規則に従います。

spdb_XXXXXXXX_YYYYYYYY_＊＊＊＊ZZZZZ.IIIIII

＊＊＊＊：接続データベース名称

HiRDBの場合

HiRDB

Oracle8i接続の場合

Oracle8i※

Oracle7の場合

Oracle7

ODBC3.0の場合

ODBC30

Database Connection Server経由メインフレーム系データベースの場合

DBS

注※

DABroker for JavaからOracle8iの機能を使用する場合だけ出力されます。

XXXXXXXX：実行プロセスID

YYYYYYYY：データベース接続識別子

ZZZZZ：識別順序番号

同じプロセスIDで，かつ同じデータベース接続識別子のファイルがある場合に，00000から32767までの番号を付加します。

IIIIII：ファイル拡張子

log：最新のトレースファイル

logold：1世代前のトレースファイル

(6)　ファイルの運用方法

拡張データベースアクセストレースは，DABroker動作環境定義ファイルで設定した行数を超える出力があった場合，現在のトレースファイルをバックアップファイルとして別名で保存します(バックアップファイルの名称については，「6.5.2(5)ファイル名称」参照)。トレース内容は，トレースファイルの先頭から再び出力します。

バックアップファイルは1世代前までしか残しません。このため，既にバックアップファイルがあり，現在のトレースファイルが設定した行数を超えると, バックアップファイルを上書きします。バックアップファイルを保存する必要がある場合は，あらかじめ別のディレクトリに退避してください。

トレースファイルは実行しているコネクションの数だけ作成されます。

トレースファイルは自動的に削除されません。ユーザが不要になった時点で削除してください。

ハードディスクの空き容量が十分でない場合，トレースの出力が停止されることがあります。

6.6　エラートレース機能

6.6.1　機能概要

エラートレース機能は，次の場合にDABrokerのエラー情報をログファイルに出力します。

リモートアクセス時にエラーが発生した場合

DABroker Driver for Java Technologyを使用したアクセス時にエラーが発生した場合

エラートレース機能で出力する情報を次に示します。

エラーメッセージ

データベース接続情報

エラーが発生する前に要求を受けた情報

前回コミット，又はロールバックを実行した時間

SQL文の実行要求処理中の場合は，実行中のカーソルでの要求ごとの履歴情報

6.6.2　適用範囲

エラートレース機能は，エラー発生時の原因調査をするような場合に有効です。

6.6.3　出力形式

DABrokerエラーログのファイル出力形式を次に示します。

履歴情報は，エラー発生時に履歴が存在する情報だけ出力されます。

(1)　エラー事象

出力形式

YYYY/MM/DD hh:mm:ss.ssssss TID=AAAA SS..SS

YYYY/MM/DD hh:mm:ss.ssssss

エラー発生日時が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，ssssss：マイクロ秒

AAAA

エラー発生スレッドID（16進数値）が出力されます。

SS...SS

エラーメッセージが出力されます。

(2)　データベース接続情報

出力形式

YYYY/MM/DD hh:mm:ss.ssssss PID=BBBB InitID=CCCC ConID=DDDD CName=EEEE DBID=FFFF CID=GGGG(HHHH,IIII)

YYYY/MM/DD hh:mm:ss.ssssss

データベース接続日時が出力されます。ただし，データベースと接続していない場合は，"----/--/-- --:--:--.------"が出力されます。

YYYY：西暦年，MM：月，DD：日

hh：時，mm：分，ss：秒，ssssssマイクロ秒

BBBB

プロセスID（10進数値）が出力されます。

CCCC

DABroker接続ID（16進数値）が出力されます。

DDDD

データベース接続識別子（16進数値）が出力されます。

EEEE

UAP名称が出力されます。ただし，名称なしの場合は空白となります。

FFFF

データベースID（10進数値）が出力されます。

出力されるデータベースIDを次に示します。

1：HiRDB

2：Oracle7

4：VOS3 XDM/RD

5：VOS1 RDB1 E2

6：VOSK SQL/K

7：Oracle8i

68：VOS3 XDM/RD※

69：VOS1 RDB1 E2※

70：VOSK SQL/K※

74：VOS3 XDM/SD※

75：VOS1 PDM II E2※

76：VOSK スプールファイル※

注※

Database Connection Server経由

GGGG

実行中カーソルID（10進数値）が出力されます。

HHHH,IIII

保守用情報が出力されます。

(3)　履歴情報

出力形式

START-TIME                 EXEC-TIME      TID      COUNT    REQ-CODE  DATA
YYYY/MM/DD hh:mm:ss.ssssss mmmm:ss.ssssss JJJJJJJJ KKKKKKKK LLLL MMMM NNNNNNNN OOOOOOOO PP..PP

履歴情報は，履歴種別によって出力される情報の意味が変わります。履歴種別を次に示します。

履歴種別（MMMM）

大きくわけて次の3種類に分類されます。

共通履歴情報

NOW：実行中の情報

OLD：一つ前の要求の情報

SQL文の実行要求時に指定されたカーソルの履歴情報

PRE：SQL PREPARE処理

EXE：SQL EXECUTE処理

FET1：SQL FETCH処理初回

FET：SQL FETCH処理

CLS：SQL CLOSE処理

コミット/ロールバック情報

CMT：コミット処理

RBK：ロールバック処理

共通情報

START-TIME：要求開始日時

EXEC-TIME：要求実行時間

FET1の場合は，最初の1件を検索した時間

FETの場合は，FETCH処理の累計実行時間

TID：要求実行スレッドID（16進数値）

CMT，RBKの場合は，空欄

COUNT：コネクト要求からの累計要求カウント数（16進数値）

FETの場合は，SQL文実行時のFETの要求回数

0xFFFFFFFFを超えた場合は，0から循環します。

REQ-CODE：

LLLL：要求コード（10進数値）

「7.5.2　要求コード/応答コード」を参照してください。

MMMM：履歴種別

DATA：

NNNNNNNN：情報1（16進数値）

OOOOOOOO：情報2（16進数値）

PP..PP：詳細情報（任意文字列）

詳細を表6-3に示します。

表6‒3　各履歴種別によるDATA内容

履歴種別(MMMM)

情報１(NNNNNNN)

情報２(OOOOOOO)

詳細情報(P..PP)

PRE

検索カラム数

?パラメタ定義数

SQLの先頭16バイト（マルチバイト文字コードの途中の場合はその文字は出力しません）

EXE

SQL実行件数※

?パラメタ指定数

非表示

FET1

要求時検索件数

最大検索件数

非表示

FET

累計検索件数

要求時検索件数

非表示

CLS

0固定

0固定

非表示

CMT

非表示

RBK

非表示

NOW

今回の要求コードで取得した情報

OLD

前回の要求コードで取得した情報

注※

INSERT，UPDATE，DELETE実行時の件数

6.6.4　出力例

(1)　コネクト時にエラーになった場合

2004/05/07 13:30:09.555000 TID=4040 KFPA11561-E Specified authorization identifier has no connect privilege
----/--/-- --:--:--.------ PID=1296 InitID=701 ConID=0 CName=DABLIBAP DBID=1 CID=0(0,0)
START-TIME                 EXEC-TIME      TID      COUNT    REQ-CODE  DATA
2004/05/07 13:30:09.195000    0:00.350000  4040           1 1002 NOW  00000000 00000000

(2)　最初のSQL文の実行要求時にエラーになった場合

2004/05/07 13:30:25.478000 TID=1812 KFPA11204-E Table/index HS5."A" not found in system
2004/05/07 13:30:21.232000 PID=1752 InitID=701 ConID=10701 CName=DABLIBAP DBID=1 CID=1(0,0)
START-TIME                 EXEC-TIME      TID      COUNT    REQ-CODE  DATA
2004/05/07 13:30:25.438000    0:00.040000  1812    FFFFFFFF 1021 NOW  00000000 00000000
select * from a2004/05/07 13:30:21.232000    0:00.280000  1812           1 1002 OLD  00000000 00000000

(3)　FETCH要求が2回以上となるSQL文を実行した後にエラーとなった場合

2004/05/07 13:31:04.324000 TID=1812 KFPA11204-E Table/index HS5."B" not found in system
2004/05/07 13:30:21.232000 PID=1752 InitID=701 ConID=10701 CName=DABLIBAP DBID=1 CID=1(0,0)
START-TIME                 EXEC-TIME      TID      COUNT    REQ-CODE  DATA
2004/05/07 13:31:04.304000    0:00.010000  1812           e 1021 NOW  00000000 00000000select * from b
2004/05/07 13:30:57.745000    0:00.040000  1812           d 1004 OLD  00000000 00000000
2004/05/07 13:30:41.892000    0:00.040000  1812           8 1021 PRE  00000009 00000000
SELECT * FROM "H
2004/05/07 13:30:41.942000    0:00.020000  1812           9 1022 EXE  00000000 00000000
2004/05/07 13:30:42.022000    0:00.140000  1812           a 1023 FET1 00006eb3 00000000
2004/05/07 13:30:50.905000    0:06.549000  1812           2 1023 FET  0000c350 0000549d
2004/05/07 13:30:57.745000    0:00.000000  1812           c 1024 CLS  00000000 00000000
2004/05/07 13:30:57.745000    0:00.040000                 d 1004 CMT
2004/05/07 13:30:25.488000    0:00.040000                 3 1005 RBK

(4)　FETCH要求が1回で終了するSQL文を実行した後にエラーとなった場合

2004/05/07 13:31:25.645000 TID=1812 KFPA11204-E Table/index HS5."C" not found in system
2004/05/07 13:30:21.232000 PID=1752 InitID=701 ConID=10701 CName=DABLIBAP DBID=1 CID=1(0,0)
START-TIME                 EXEC-TIME      TID      COUNT    REQ-CODE  DATA
2004/05/07 13:31:25.635000    0:00.010000  1812          19 1021 NOW  00000000 00000000
select * from c
2004/05/07 13:31:19.015000    0:00.010000  1812          18 1004 OLD  00000000 00000000
2004/05/07 13:31:18.815000    0:00.020000  1812          14 1021 PRE  00000009 00000000
SELECT * FROM "H
2004/05/07 13:31:18.835000    0:00.020000  1812          15 1022 EXE  00000000 00000000
2004/05/07 13:31:18.895000    0:00.050000  1812          16 1023 FET1 0000014d 00000000
2004/05/07 13:31:18.875000    0:00.070000  1812           1 1023 FET  0000014d 0000014d
2004/05/07 13:31:19.015000    0:00.000000  1812          17 1024 CLS  00000000 00000000
2004/05/07 13:31:19.015000    0:00.010000                18 1004 CMT
2004/05/07 13:31:04.324000    0:00.010000                 f 1005 RBK

(5)　INSERT文実行時?パラメタの数がアンマッチとなった場合（EXECUTE複数回実行後）

2004/05/07 15:37:16.773000 TID=1712 KFPA11313-E Number of variables not equal to number of parameters
2004/05/07 15:35:48.966000 PID=584 InitID=701 ConID=10701 CName=Select_load DBID=1 CID=1(1,0)
START-TIME             000 EXEC-TIME      TID      COUNT    REQ-CODE  DATA
2004/05/07 15:37:16.733000    0:00.030000  1712           7 1022 NOW  00000000 00000001
2004/05/07 15:36:18.369000    0:00.000000  1712           6 1022 OLD  00000001 00000002
2004/05/07 15:35:59.191000    0:00.281000  1712           2 1021 PRE  00000000 00000002
INSERT INTO "HS・
2004/05/07 15:36:18.369000    0:00.000000  1712           6 1022 EXE  00000001 00000002

(6)　CLOSE要求を2回連続して発行した場合

2004/05/07 16:00:39.720000 TID=1040 KFDB010TD-E 要求コードのシーケンスエラーが発生しました。[RequestCode=1024-1024]
2004/05/07 15:58:25.727000 PID=4164 InitID=701 ConID=10701 CName=Select_load DBID=1 CID=1(4,0)
START-TIME                 EXEC-TIME      TID      COUNT    REQ-CODE  DATA
2004/05/07 16:00:39.700000    0:00.020000  1040           6 1024 NOW  00000000 00000000
2004/05/07 15:58:30.755000    0:00.000000  1040           5 1024 OLD  00000000 00000000
2004/05/07 15:58:26.749000    0:00.000000  1040           2 1021 PRE  00000009 00000000
SELECT * FROM "H2004/05/07 15:58:26.749000    0:00.000000  1040           3 1022 EXE  00000000 00000000
2004/05/07 15:58:26.759000    0:00.030000  1040           4 1023 FET1 0000014d 00000000
2004/05/07 15:58:26.759000    0:00.030000  1040           1 1023 FET  0000014d 0000014d
2004/05/07 15:58:30.755000    0:00.000000  1040           5 1024 CLS  00000000 00000000

6.6.5　ファイル名称

エラートレースファイルは，次のディレクトリに作成されます。

DABroker運用ディレクトリ/spool

DABrokerエラーログのファイル名称は，次のようになります。

dabevttrcerr1：ログ出力用ファイル

dabevttrcerr2：バックアップ用ファイル

dabevttrcerr1.lock：ワークファイル

6.6.6　ファイルの運用方法

dabevttrcerr1ファイルのサイズが512キロバイトを超えている場合にログを出力すると，dabevttrcerr1ファイルをバックアップ用ファイル（dabevttrcerr2）に名称を変更した後，新規作成したdabevttrcerr1ファイルにログを出力します。

バックアップ用ファイルは1世代前までだけ残せます。バックアップファイルを保存する必要がある場合は，あらかじめ別のディスクに退避してください。

ハードディスクの空き容量が十分でない場合，ログの出力を停止します。

7　メッセージ（共通）

この章では，DABrokerが出力するメッセージの要因，システムでの処理，及びユーザが取る対処を説明します。

7.1　メッセージの出力先

DABrokerが発行するメッセージは，次のどれかに出力されます。

UNIXの場合

サーバの標準エラー出力

クライアント

コンソール（/dev/console）

Linuxの場合のシステムログ（/var/log）

HP-UXの場合のシステムログ（/var/adm/syslog/syslog.log）

AIXの場合のシステムログ（/var/adm/ras）

メッセージログ（DABroker運用ディレクトリ/spool/dabsv.log，及びdabsv.logold）

Windowsの場合

クライアント

メッセージダイアログボックス

イベントログ（Windowsのイベントビューア）

メッセージログ（DABroker運用ディレクトリ¥spool¥dabsv.log，及びdabsv.logold）

このメッセージログは，イベントログビューア（プログラムフォルダに登録された[DABroker]から[イベントログビューア]を選択して起動すると表示されるダイアログボックス）で参照できます。

出力されたメッセージの要因，システムでの処理，及びユーザが取る対処を知る場合は，「7.3　メッセージ一覧」で該当するメッセージを探してください。「7.3　メッセージ一覧」では，DABrokerが発行するメッセージを，メッセージIDによって昇順に記載しています。

7.2　メッセージの形式及び注意事項

7.2.1　メッセージの形式

このマニュアルでは，メッセージを次の形式で説明します。

「KFDBnnnnn−m：メッセージテキスト」

KFDBnnnnn−m

メッセージID

KFDB

DABrokerのメッセージであることを示します。

nnnnn

メッセージの通し番号を示します。

ｍ

メッセージの種別を示します。

Ｅ：エラー

DABrokerが正常に動作できないような障害の発生を通知するメッセージです。

Ｉ：インフォメーション

DABrokerの動作を報告するメッセージです。

Ｗ：ワーニング

DABrokerの処理で，ユーザに警告が必要な事象が発生したことを通知するメッセージです。

Q：クエスチョン

ユーザに応答を求めるメッセージです。

メッセージテキスト

メッセージの内容です。出力先に出力されるのは，メッセージIDと，このメッセージテキストです。メッセージテキストは，上段に日本語，中段に02-01以前で出力される英語，下段に02-02以降で出力される英語を併記しています。

要因：メッセージが出力された原因を示します。

処理：メッセージが出力されたときにシステムの処理を示します。

対処：メッセージが出力されたときにユーザが取るべき処置を示します。

7.2.2　注意事項

コンソールやメッセージログファイルには，サーバ又はクライアントの標準エラー出力に出力されないメッセージも出力されます。ただし，コンソールやメッセージログファイルには出力されずに，サーバ又はクライアントの標準エラー出力にだけ出力されるメッセージもあります。

「保守員に連絡してください」とは，システム管理者が，ご購入契約に基づくお問い合わせ窓口に連絡することを示します。保守員に連絡する場合，「6.　DABrokerの障害対策（共通）」に示した手順で，障害情報を取得してください。

「保守用情報」，「エラー番号」及び「シグナル番号」は，保守員が使用するコードです。

データベース側で発行されたメッセージについては，各DBMSのマニュアルを参照してください。

可変情報に表示する情報がない場合「*」を表示することがあります。

ファイル名など，可変情報に表示する情報が長い場合，先頭79バイトだけを表示し，残りは切り捨てます。

7.2.3　Windowsを使用している場合の注意事項

(1)　環境変数

出力されたメッセージの内容に「DABroker動作環境定義ファイルの環境変数」といった記述がある場合は，Windows環境では，環境設定ユティリティで設定する項目を指します。環境変数と環境設定ユティリティの対応を表7-1に示します。

環境設定ユティリティ及び項目の詳細については，「4.4　DABroker環境設定」及び「4.5　DABroker環境設定項目」を参照してください。

表7‒1　環境変数と環境設定ユティリティの項目の対応表

環境変数名

環境設定ユティリティで対応する項目

DABTMP

作業ディレクトリ

DABSVLOGSIZE

ログファイルサイズ［dabsv.log］

DABDBA_TIMEOUT

データベースアクセス処理終了待ちタイムアウト

DABSELECTCOLCNT

表検索カラム数

DABSELECTINFCNT

更新・検索条件カラム数

DABORACLE_TYPE

使用するORACLEのバージョン

DABSQL_HiRDB_DICTIONARY_DATATYPE

HiRDBのディクショナリ表のデータ属性

DAB_HIRDB_DBINF_ESC

HiRDB環境変数区切り文字

DABSQL_TRCSIZE

アクセストレースを取得する

DABSQL_TRC_CANCEL

CANCEL（アクセストレースの種類）

DABSQL_TRC_CLOSE

CLOSE（アクセストレースの種類）

DABSQL_TRC_COMMIT

COMMIT（アクセストレースの種類）

DABSQL_TRC_CONNECT

CONNECT（アクセストレースの種類）

DABSQL_TRC_DECLARE

DECLARE（アクセストレースの種類）

DABSQL_TRC_DESCRIBE

DESCRIBE（アクセストレースの種類）

DABSQL_TRC_DISCONNECT

DISCONNECT（アクセストレースの種類）

DABSQL_TRC_EXECUTE

EXECUTE（アクセストレースの種類）

DABSQL_TRC_FETCH

FETCH（アクセストレースの種類）

DABSQL_TRC_LOGGING

LOGGING（アクセストレースの種類）

DABSQL_TRC_LOGLESS

LOGLESS（アクセストレースの種類）

DABSQL_TRC_PREPARE

PREPARE（アクセストレースの種類）

DABSQL_TRC_ROLLBACK

ROLLBACK（アクセストレースの種類）

DABSQL_TRC_OPEN

OPEN（アクセストレースの種類）

DABSQL_TRC_ATTACH

ATTACH（アクセストレースの種類）

DABSQL_TRC_ATTRGET

ATTRGET（アクセストレースの種類）

DABSQL_TRC_ATTRSET

ATTRSET（アクセストレースの種類）

DABSQL_TRC_BIND

BIND（アクセストレースの種類）

DABSQL_TRC_CHARFORM

CHARFORM（アクセストレースの種類）

DABSQL_TRC_CHARID

CHARID（アクセストレースの種類）

DABSQL_TRC_DEFINE

DEFINE（アクセストレースの種類）

DABSQL_TRC_DESALLOC

DESALLOC（アクセストレースの種類）

DABSQL_TRC_DESCANY

DESCANY（アクセストレースの種類）

DABSQL_TRC_DESFREE

DESFREE（アクセストレースの種類）

DABSQL_TRC_DETACH

DETACH（アクセストレースの種類）

DABSQL_TRC_ENVCREATE

ENVCREATE（アクセストレースの種類）

DABSQL_TRC_ERRGET

ERRGET（アクセストレースの種類）

DABSQL_TRC_GETPIECE

GETPIECE（アクセストレースの種類）

DABSQL_TRC_HDLALLOC

HDLALLOC（アクセストレースの種類）

DABSQL_TRC_HDLFREE

HDLFREE（アクセストレースの種類）

DABSQL_TRC_LOBCLOSE

LOBCLOSE（アクセストレースの種類）

DABSQL_TRC_LOBLEN

LOBLEN（アクセストレースの種類）

DABSQL_TRC_LOBOPEN

LOBOPEN（アクセストレースの種類）

DABSQL_TRC_LOBREAD

LOBREAD（アクセストレースの種類）

DABSQL_TRC_LOBWRITE

LOBWRITE（アクセストレースの種類）

DABSQL_TRC_PARAMGET

PARAMGET（アクセストレースの種類）

DABSQL_TRC_SESBEGIN

SESBEGIN（アクセストレースの種類）

DABSQL_TRC_SESEND

SESEND（アクセストレースの種類）

DABSQL_TRC_SETPIECE

SETPIECE（アクセストレースの種類）

DABSQL_TRC_GETDIAG

GETDIAG（アクセストレースの種類）

DABSQL_TRC_AUTO_COMMIT_OFF

AUTO_COMMIT_OFF（アクセストレースの種類）

DABSQL_TRC_AUTO_COMMIT_ON

AUTO_COMMIT_ON（アクセストレースの種類）

DABSQL_TRC_GET_INFO

GET_INFO（アクセストレースの種類）

DABSQL_TRC_SET_INFO

SET_INFO（アクセストレースの種類）

DABSQL_TRC_EXECUTE_DIRECT

EXECUTE_DIRECT（アクセストレースの種類）

DABCLIENT_TIMEOUT

クライアントからの要求待ちタイムアウト

DABMAXUSERS

最大接続ユーザ数

DABDBANUMBER

同時実行可能なデータベースアクセス数

DABMAXBLOCKUSERS

１プロセスあたりの実行ユーザ数

DABMAXPROCESS

最大処理プロセス数

DABHIRDBA_BLOBBUFSIZE

BLOB型データ受取バッファサイズ(HiRDB)

DABORADBA_LONGBUFSIZE

LONG型データ受取バッファサイズ(ORACLE)

DABODBC30_LONGBUFSIZE

LONG型データ受取バッファサイズ(ODBC3.0)

DABDBSDBA_BLOBBUFSIZE

BLOB型データ受取バッファサイズ(Database Connection Server)

DABLANGMODE

漢字コードセット

DABKEEPALIVE

TCP/IP通信時キープアライブを監視する

DABIPCONVERT

IPアドレスからホスト名へ変換する

DABTCP_TRCSIZE

通信トレースを取得する

DAB_DBS_HOST

接続先ホスト名またはIPアドレス(Database Connection Server接続設定)

DAB_DBS_PORT

接続先サービス名またはポート番号(Database Connection Server接続設定)

DAB_DBS_SEND_BUFFER_SIZE

送信バッファサイズ(Database Connection Server接続設定)

DAB_DBS_RECEIVE_BUFFER_SIZE

受信バッファサイズ(Database Connection Server接続設定)

DAB_XA_ERROR

XAトレースを取得する

(2)　接続先データベース定義

出力されたメッセージの内容に「接続先データベース定義ファイルの設定」といった記述がある場合は，接続先データベース定義ユティリティで設定することを指します。

接続先データベース定義ユティリティ，及び項目の詳細については，「4.6　DABroker接続先データベース定義」を参照してください。

(3)　コネクションマルチ定義

出力されたメッセージの内容に「コネクションマルチ定義ファイルの設定」といった記述がある場合は，コネクションマルチ定義ユティリティで設定することを指します。

コネクションマルチ定義ユティリティ，及び項目の詳細については，「4.7　DABrokerコネクションマルチ定義（Database Connection Server経由のDBアクセス定義）」を参照してください。

7.3　メッセージ一覧

KFDB001CM-E

メモリが不足しているため，処理に必要な領域が確保できません。[errno=XXXX]

Cannot allocate memory area because of insufficient memory. [errno=XXXX]

XXXX:エラー番号

要因

メモリ不足が発生しました。

処理

コネクションマルチ通信処理プロセスを終了します。

対処

DABrokerで実行中のほかの処理が終了してから，再実行してください。

KFDB002CM-E

システムコールでエラーが発生しました。[XXXX() errno= YYYY]

An error occurred in a system call. [XXXX() errno=YYYY]

XXXX：システムコール関数名

YYYY：エラー番号

要因

OSのシステムコール関数でエラーが発生しました。

処理

コネクションマルチ通信処理プロセスを終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB003CM-E

コネクションマルチ機能のソケット作成でエラーが発生しました。

An error occurred during the making of a socket for the Connection-Multi function.

要因

コネクションマルチ機能で使用するソケットを作成するOSのシステムコール関数(socket)でエラーが発生しました。

処理

コネクションマルチ通信処理プロセスを終了します。

対処

メインフレーム側の通信プログラムを起動していない場合にこのエラーが発生します。コネクションマルチ機能を使用する前にメインフレーム側の通信プログラムを起動しておいてください。

KFDB004CM-E

コネクションマルチ通信処理スレッドの起動でエラーが発生しました。[errno=XXXX]

An error occurred during the start of a Connection-Multi communication thread. [errno=XXXX]

XXXX:エラー番号

要因

コネクションマルチ機能で使用する通信スレッドの起動に失敗しました。

処理

コネクションマルチ通信処理プロセスを終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB005CM-E

プロセスの初期化でエラーが発生しました。[damcInitProc() errno=XXXX]

An error occurred during process initialization. [damcInitProc() errno=XXXX]

XXXX:エラー番号

要因

コネクションマルチ通信処理プロセスの初期化に失敗しました。

処理

コネクションマルチ通信処理プロセスを終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB006CM-E

名前付きパイプのオープンでエラーが発生しました。[errno=XXXX]

An error occurred during the opening of a named pipe. [errno=XXXX]

XXXX: エラー番号

要因

名前付きパイプのオープンに失敗しました。

処理

コネクションマルチ通信処理プロセスを終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB007CM-E

名前付きパイプのクローズでエラーが発生しました。[errno=XXXX]

An error occurred during the closing of a named pipe. [errno=XXXX]

XXXX: エラー番号

要因

名前付きパイプのクローズに失敗しました。

処理

コネクションマルチ通信処理プロセスを終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB008CM-E

名前付きパイプの通信でエラーが発生しました。[errno=XXXX]

An error occurred during communication of a named pipe. [errno=XXXX]

XXXX: エラー番号

要因

名前付きパイプでの通信に失敗しました。

処理

コネクションマルチ通信処理プロセスを終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB009CM-I

コネクションマルチ通信処理スレッドを終了します。要因：[XXXX]

The Connection-Multi communication thread will terminate. Cause:[XXXX]

XXXX:終了要因

CANCEL_REQUEST：ユーザキャンセル要求

TERM_REQUEST ：強制終了要求

要因

強制終了，又はユーザキャンセル要求によりコネクションマルチ機能の通信処理スレッドが終了しました。

処理

コネクションマルチ通信処理スレッドを終了します。

対処

システム管理者が強制終了，又はユーザキャンセル要求を行っていないか確認してください。

KFDB010CM-E

コネクションマルチ通信処理プロセスを終了します。

The Connection-Multi communication process will terminate.

要因

コネクションマルチ機能の通信処理プロセスが異常終了しました。

処理

コネクションマルチ機能のコネクションを解放します。以降のクライアントからの要求を受け付けません。

対処

killコマンドなどを入力していないか，又はシステムに負荷が掛かり過ぎていないか確認してください。エラーの原因が分からない場合は，保守員に連絡してください。

KFDB011CM-E

コネクションマルチ受信処理スレッドの起動でエラーが発生しました。[XXXX]

An error occurred during the start of a Connection-Multi receive thread. [XXXX]

XXXX:エラー情報

要因

コネクションマルチ機能で使用する受信処理スレッドの起動に失敗しました。

処理

コネクションマルチ通信処理プロセスを終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB012CM-E

接続したサーバシステムでシステムエラーが発生しました。[XXXX]

A system error occurred in the connected server system. [XXXX]

XXXX:保守用情報

要因

接続したサーバシステムでエラーが発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続したDBMSを見直し，指定し直してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB013CM-E

コネクションマルチ通信処理でシステムエラーが発生しました。[XXXX]

A system error occurred during Connection-Multi communication processing. [XXXX]

XXXX:保守用情報

要因

コネクションマルチ機能の通信処理でエラーが発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続したDBMS及びコネクションマルチ機能の設定を見直し，再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB001CS-E

コマンドの引数に誤りがあります。使用法：dabcmstart

Invalid argument. Usage:dabcmstart

要因

dabcmstartコマンドのオプションに誤りがあります。

処理

処理を終了します。

対処

コマンドを正しく指定して，再実行してください。

KFDB002CS-E

有効な定義がありません。DABrokerコネクションマルチ機能を終了します。

A valid definition does not exist. The DABroker Connection-Multi function will terminate.

要因

コネクションマルチ機能を使用するための，有効なDABrokerコネクションマルチ定義がありません。

処理

処理を終了します。

対処

DABrokerコネクションマルチ定義で，最大仮想コネクション数（MCONMAX）を２以上及び通信処理プロセス数（MCONPROC）に１以上の値を指定してください。

KFDB003CS-I

DABrokerコネクションマルチ機能の初期化処理が完了しました。

Initialization processing of the DABroker Connection-Multi function has finished.

要因

DABrokerコネクションマルチ機能の起動要求※を受け付け，初期化処理が完了しました。

処理

DABrokerコネクションマルチ機能を起動し，ユーザからのアクセス要求を受け付けます。

注※

Windows対応のDABrokerの場合は，プログラムフォルダに登録された[コネクションマルチ起動]を選択，又はサービスの開始を実行したときです。UNIX対応のDABrokerの場合は，dabcmstartコマンドを実行したときです。

KFDB004CS-I

DABrokerコネクションマルチ機能の終了処理を開始しました。mode=NORMAL

Termination processing of the DABroker Connection-Multi function has started. mode=NORMAL

要因

DABrokerコネクションマルチ機能の通常終了処理※を開始しました。

処理

DABrokerコネクションマルチ機能を終了します。

注※

Windows対応のDABrokerの場合は，プログラムフォルダに登録された[コネクションマルチ終了]を選択し，通常終了を実行したときです。UNIX対応のDABrokerの場合は，dabcmstopコマンドをオプション指定なしで実行したときです。

KFDB005CS-I

DABrokerコネクションマルチ機能の終了処理を開始しました。mode=FORCED

Termination processing of the DABroker Connection-Multi function has started. mode=FORCED

要因

DABrokerコネクションマルチ機能の強制終了処理※を開始しました。

処理

DABrokerコネクションマルチ機能を終了します。

注※

Windows対応のDABrokerの場合は，[コネクションマルチ終了]ダイアログボックスで強制終了を選択したとき，又はサービスを停止させたときです。UNIX対応のDABrokerの場合は，dabcmstopコマンドを-f オプションを指定して実行したときです。

KFDB006CS-I

DABrokerコネクションマルチ機能の終了処理を開始しました。mode=PLANNED

Termination processing of the DABroker Connection-Multi function has started. mode=PLANNED

要因

DABrokerコネクションマルチ機能の計画終了処理※を開始しました。

処理

DABrokerコネクションマルチ機能を終了します。

注※

Windows対応のDABrokerの場合は，[コネクションマルチ終了]ダイアログボックスで計画終了を選択したときです。UNIX対応のDABrokerの場合は，dabcmstopコマンドを-p オプションを指定して実行したときです。

KFDB007CS-E

DABrokerコネクションマルチ機能は計画終了中です。接続できません。

The DABroker Connection-Multi function is terminating in the planned termination mode. Connection is not possible.

要因

Database Connection Server経由でアクセスするデータベースに接続しようとしましたが，DABrokerコネクションマルチ機能が計画終了中です。計画終了中は，新たなユーザからの接続要求は受け付けません。

処理

ユーザからの要求を受け付けません。

対処

DABrokerコネクションマルチ機能の計画終了が終わってから，DABrokerコネクションマルチ機能を再起動してください。その後，Databse Connection Server経由でアクセスするデータベースへの接続を再実行してください。

KFDB008CS-E

接続できる最大仮想コネクション数を超えました。接続できません。

[XXXX][MCONMAX=YYYY,MCONPROC=ZZZZ]

The number of virtual connections exceeds the maximum that can be connected. Connection is not possible.

[XXXX] [MCONMAX=YYYY,MCONPROC=ZZZZ]

XXXX:コネクションマルチ名

YYYY:１通信プロセス当たりで同時に確立できる最大仮想コネクション数

ZZZZ:通信処理プロセス数

要因

接続可能な最大仮想コネクション数(DABrokerコネクションマルチ定義で設定したMCONMAX*MCONPROC)を超えて，ユーザからの接続要求が発生しました。

処理

ユーザからの要求を受け付けません。

対処

ほかのユーザが終了するのを待ってから，再実行してください。または，DABrokerコネクションマルチ定義のMCONMAXまたは，MCONPROCの値を大きくしてから，再実行してください。

KFDB009CS-E

DABrokerコネクションマルチ機能は既に起動しています。

The DABroker Connection-Multi function is already running.

要因

DABrokerコネクションマルチ機能が既に起動されているマシン上で，DABrokerコネクションマルチ機能の起動要求※を受け付けました。

処理

処理を終了します。

対処

一つのマシン上では，複数のDABrokerコネクションマルチ機能は起動できません。

注※

Windows対応のDABrokerの場合は，プログラムフォルダに登録された[コネクションマルチ起動]を選択，又はサービスの開始を実行したときです。UNIX対応のDABrokerの場合は，dabcmstartコマンドを実行したときです。

KFDB010CS-E

DABrokerコネクションマルチ機能のロードモジュールに実行権限がありません。ロードモジュール名:[XXXX]

The user does not have authorization to execute the load module of the DABroker Connection-Multi function. Name:[XXXX]

XXXX:エラーとなったロードモジュールのファイル名称

要因

DABrokerコネクションマルチ機能のロードモジュールに実行権限がないため，ユーザからの要求を処理できません。

処理

ユーザからの要求を受け付けません。

対処

DABrokerを組み込み直してください。UNIX対応DABrokerの場合は，その後dabsetupコマンドでDABrokerのセットアップを実行してください。

KFDB011CS-E

シンボリックリンクが多過ぎるため，DABrokerコネクションマルチ機能を実行できません。ロードモジュール名:[XXXX]

The DABroker Connection-Multi function cannot start because there are too many symbolic links. Name:[XXXX]

XXXX:エラーとなったロードモジュールのファイル名称

要因

DABroker組み込み先ディレクトリのシンボリックリンクが多過ぎるため，ユーザからの要求を処理できません。

処理

ユーザからの要求を受け付けません。

対処

システム管理者に連絡し，シンボリックリンクの少ないディレクトリにDABrokerを組み込み直してもらってください。

KFDB012CS-E

DABroker コネクションマルチ機能のロードモジュールがありません。ロードモジュール名:[XXXX]

A load module of the DABroker Connection-Multi function was not found. Name:[XXXX]

XXXX:エラーとなったロードモジュールのファイル名称

要因

DABrokerの環境が破壊されているため，ユーザからの要求を処理できません。

処理

ユーザからの要求を受け付けません。

対処

DABrokerを組み込み直してください。UNIX対応DABrokerの場合は，その後dabsetupコマンドでDABrokerのセットアップを実行してください。

KFDB013CS-E

メモリ不足のため，DABrokerコネクションマルチ機能を実行できません。ロードモジュール名:[XXXX]

The DABroker Connection-Multi function cannot start because of insufficient memory. Name:[XXXX]

XXXX:エラーとなったロードモジュールのファイル名称

要因

DABrokerコネクションマルチ機能の動作に必要なメモリが不足しています。

処理

ユーザからの要求を受け付けません。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB014CS-E

DABrokerコネクションマルチ機能を起動する権限がありません。

The user does not have authority to execute the DABroker Connection-Multi function.

要因

DABrokerコネクションマルチ機能を起動しようとしたユーザが，DABrokerの管理者ユーザ※ではないため，DABrokerコネクションマルチ機能を起動できません。

処理

処理を終了します。

対処

DABrokerコネクションマルチ機能の起動は，DABrokerの管理者ユーザが実行してください。

注※

Windows対応のDABrokerの場合は，Administratorsグループに属しているユーザ

UNIX対応のDABrokerの場合は，DABrokerの管理ユーザ

KFDB015CS-E

コネクションマルチ通信プロセスが異常終了しました。要因:XXXX

The Connection-Multi communication processing terminated abnormally. Cause:XXXX

XXXX:終了要因（保守用情報）

要因

コネクションマルチ通信プロセスが異常終了しました。

処理

コネクションを解放します。処理を続行します。

対処

killコマンドなどを入力していないか，又はシステムに負荷が掛かり過ぎていないか確認してください。エラーの原因が分からない場合は，保守員に連絡してください。

KFDB016CS-E

DABroker コネクションマルチ機能が異常終了しました。要因:XXXX

The DABroker Connection-Multi function terminated abnormally. Cause:XXXX

XXXX:終了要因（保守用情報）

要因

killコマンドを入力したか，又はシステムに負荷が掛かり過ぎて，DABrokerコネクションマルチ機能が異常終了しました。

処理

DABrokerコネクションマルチ機能を終了します。

対処

DABrokerコネクションマルチ機能を再起動する場合は，強制終了を実行後，再起動してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。UNIX対応のDABrokerで保守員に連絡する場合は，以下のファイルを退避しておいてください。

$DABROKER/spool 以下のファイル($DABROKER：DABrokerインストールディレクトリ)

システムダンプ(DABrokerを起動したカレントディレクトリ下の "core" ファイル)

KFDB018CS-W

実行可能な最大ユーザ処理プロセス数を超えました。[XXXX][MCONMAX=AAAA,MCONPROC=BBBB,MCONPOOL=CCCC,MRSVPOOL=DDDD]

The number of users exceeds the maximum that can be executed.

[XXXX][MCONMAX=AAAA,MCONPROC=BBBB,MCONPOOL=CCCC,MRSVPOOL=DDDD]

XXXX:コネクションマルチ名

AAAA:１通信プロセス当たりで同時に確立できる最大仮想コネクション数

BBBB:通信処理プロセス数

CCCC:プールコネクション数

DDDD:予約プールコネクション数

要因

DABrokerコネクションマルチ定義の予約プールコネクション数に指定した値が，接続可能な最大仮想コネクション数(DABrokerコネクションマルチ定義で設定したMCONMAX*MCONPROC)を超えています。

処理

接続可能な最大仮想コネクション数分だけプールし，処理を続行します。

対処

DABrokerコネクションマルチ定義の予約プールコネクション数が，最大仮想コネクション数以下になるようにしてください。

KFDB020CS-E

DABroker コネクションマルチ機能を起動できません。

The DABroker Connection-Multi function cannot start.

要因

DABrokerコネクションマルチ機能の起動に失敗しました。

処理

DABrokerコネクションマルチ機能を終了します。

対処

直前に出力されたメッセージの指示に従って対策してください。対策後，DABrokerコネクションマルチ機能を再起動してください。

KFDB022CS-I

DABroker コネクションマルチ機能の終了処理が完了しました。

Termination processing of the DABroker Connection-Multi function has finished.

要因

DABrokerコネクションマルチ機能が終了しました。

KFDB023CS-E

コネクションマルチ通信プロセスを起動できません。

The Connection-Multi communication process cannot start.

要因

コネクションマルチ通信プロセスの起動に失敗しました。

処理

処理を続行します。

対処

直前に出力されたメッセージに対する指示に従ってください。

KFDB024CS-E

DABrokerコネクションマルチ機能は起動中です。接続できません。

The DABroker Connection-Multi function is starting. Connection is not possible.

要因

Database Connection Server経由でアクセスするデータベースに接続しようとしましたが，DABrokerコネクションマルチ機能が起動中です。起動中は，ユーザからの接続要求は受け付けません。

処理

ユーザからの要求を受け付けません。

対処

しばらく時間を空けてから，Database Connection Server経由でアクセスするデータベースへの接続を再実行してください。

KFDB025CS-E

DABrokerコネクションマルチ機能は終了中です。接続できません。

The DABroker Connection-Multi function is terminating. Connection is not possible.

要因

Database Connection Server経由でアクセスするデータベースに接続しようとしましたが，DABrokerコネクションマルチ機能が終了処理中です。終了処理中は，ユーザからの接続要求は受け付けません。

処理

ユーザからの要求を受け付けません。

対処

DABrokerコネクションマルチ機能の終了処理が終わってから，DABrokerコネクションマルチ機能を再起動してください。その後，Database Connection Server経由でアクセスするデータベースへの接続を再実行してください。

KFDB026CS-E

DABrokerコネクションマルチ機能は強制終了中です。接続できません。

The DABroker Connection-Multi function is terminating in the forced termination mode. Connection is not possible.

要因

Database Connection Server経由でアクセスするデータベースに接続しようとしましたが，DABrokerコネクションマルチ機能が強制終了中です。強制終了中は，ユーザからの接続要求は受け付けません。

処理

ユーザからの要求を受け付けません。

対処

DABrokerコネクションマルチ機能の強制終了処理が終わってから，DABrokerコネクションマルチ機能を再起動してください。その後，Database Connection Server経由でアクセスするデータベースへの接続を再実行してください。

KFDB027CS-E

DABrokerコネクションマルチ機能は起動していません。接続できません。

The DABroker Connection-Multi function is not running. Connection is not possible.

要因

Database Connection Server経由でアクセスするデータベースに接続しようとしましたが，DABrokerコネクションマルチ機能が起動されていません。

処理

ユーザからの要求を受け付けません。

対処

DABrokerコネクションマルチ機能を起動してください。その後，Database Connection Server経由でアクセスするデータベースへの接続を再実行してください。

KFDB028CS-E

コネクションマルチ通信処理プロセスを起動できません。接続できません。

The DABroker Connection-Multi function communication process cannot start. Connection is not possible.

要因

Database Connection Server経由でアクセスするデータベースに接続しようとしましたが，コネクションマルチ機能の通信処理プロセスを起動できませんでした。そのため，ユーザからの接続要求を受け付けられません。

処理

ユーザからの要求を受け付けません。

対処

直前に出力されたメッセージに対する指示に従ってください。その後，Database Connection Server経由でアクセスするデータベースへの接続を再実行してください。

KFDB029CS-E

仮想コネクションの割り当てに失敗しました。接続できません。

The virtual connection-allocation failed. Connection is not possible.

要因

Database Connection Server経由でアクセスするデータベースに接続しようとしましたが，仮想コネクションの割り当てに失敗したため，ユーザからの接続要求を受け付けられません。

処理

ユーザからの要求を受け付けません。

対処

直前に出力されたメッセージに対する指示に従ってください。その後，Database Connection Server経由でアクセスするデータベースへの接続を再実行してください。

KFDB100CS-E

システムコールでエラーが発生しました。(XXXX() errno=YYYY)

An error occurred in a system call. (XXXX() errno=YYYY)

XXXX:関数名称(保守用情報)

YYYY:エラー番号(保守用情報)

要因

OSのシステムコール関数，又はDABrokerの共通関数でエラーが発生しました。

処理

処理を終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB101CS-E

メモリを確保できません。

Required memory cannot be obtained.

要因

DABrokerコネクションマルチ機能の動作に必要なメモリが不足しています。

処理

DABrokerコネクションマルチ機能を終了します。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB210CS-E

不正なデータを受信しました。[XXXX] エラーコード=YYYY

Invalid data was received. [XXXX] Error code=YYYY

XXXX:コネクションマルチ名

YYYY:保守用情報

要因

ユーザから不正な通信データを受信しました。

処理

ユーザからの要求を無視します。

対処

保守員に連絡してください。

KFDB211CS-E

無効なコネクションマルチ名を指定したため，処理要求を受け付けられません。[XXXX]

The processing request cannot be accepted because a specified Connection-Multi-name is invalid. [XXXX]

XXXX:コネクションマルチ名

要因

コネクションマルチ機能対象外のコネクションマルチ名か，未定義のコネクションマルチ名が指定されました。

処理

処理要求を受け付けません。

対処

有効なコネクションマルチ名を指定して再実行してください。DABrokerコネクションマルチ定義の，最大仮想コネクション数を2以上に，通信処理プロセス数を1以上に設定してください。

KFDB213CS-E

DABroker コネクションマルチ機能が計画終了中のため，処理要求を受け付けられません。[XXXX]

The processing request cannot be accepted because the DABroker Connection-Multi function is terminating in the planned termination mode. [XXXX]

XXXX:コネクションマルチ名

要因

データベースと接続しようとしましたが，DABrokerコネクションマルチ機能が計画終了中です。計画終了中は，新たなユーザからの処理要求を受け付けません。

処理

ユーザからの要求を無視します。

対処

DABrokerコネクションマルチ機能の計画終了が終わってから，DABrokerコネクションマルチ機能を再起動してください。その後，データベースへの接続を再実行してください。

KFDB300CS-W

servicesファイルに，サービス名とポート番号が登録されていません。[XXXX][DBSPORT=YYYY]

The services name and port number are not listed in the "services" file. [XXXX][DBSPORT=YYYY]

XXXX:コネクションマルチ名

YYYY:サービス名

要因

コネクションマルチ定義に設定したサービス名がservicesファイルに登録されていません。

処理

ユーザからの要求を受け付けません。

対処

コネクションマルチ定義を確認し，再実行してください。

KFDB301CS-W

hostsファイルに，ホスト名とIPアドレスが登録されていません。[XXXX][DBSHOST=YYYY]

The host name and IP address are not listed in the "hosts" file. [XXXX][DBSHOST=YYYY]

XXXX:コネクションマルチ名

YYYY:ホスト名

要因

コネクションマルチ定義に設定したホスト名がhostsファイルに登録されていません。

処理

ユーザからの要求を受け付けません。

対処

コネクションマルチ定義を確認し，再実行してください。

KFDB001DB-E

Required memory cannot be obtained. ErrInfo［XXXX］

XXXX：保守用情報

要因

処理に必要な領域の確保時，メモリ不足が発生しました。

処理

処理を終了します。

対処

実行中の不要なプログラムを終了してから，再実行してください。なお，このメッセージが繰り返し発生する場合は，実メモリ，又は仮想メモリの設定を見直してください。

KFDB002DB-E

RDBMSに対する要求シーケンスが不正です。ErrInfo［XXXX］

The request sequence for the RDBMS is invalid. ErrInfo[XXXX]

XXXX：保守用情報

要因

ユーザからRDBMSに対する要求シーケンスが誤っています。

処理

ユーザからの要求を受け付けません。

対処

RDBMSに対する要求シーケンスを見直してください。

KFDB003DB-E

システムコールでエラーが発生しました。ErrInfo［XXXX() errno=YYYY］

An error occurred in a system call. ErrInfo[XXXX() errno=YYYY]

XXXX：システムコール名称

YYYY：エラー番号

要因

OSのシステムコール関数でエラーが発生しました。

処理

処理を終了します。

対処

使用するOSのマニュアルを参照しエラー原因を取り除いてから，再実行してください。なお，代表的なシステムコールのエラー番号については，「7.5.3　システムコールのエラー番号」を参照してください。

KFDB004DB-I

DBMSに対する処理を中断しました。

DBMS processing was canceled.

要因

DBMSに対する処理を中断しました。

処理

DBMSに対する処理を中断します。

対処

必要に応じて再実行してください。

KFDB005DB-E

DABrokerでサポートされていないデータ属性がありました。［XXXX］

A data attribute that is not supported by DABroker was found. [XXXX]

XXXX：サポートされていない列属性コード(16進表示)

要因

指定した表列属性(XXXX)は，DABrokerでサポートしていません。

処理

ユーザからの要求を受け付けません。

対処

列属性，又はDABrokerのバージョンを見直してください。また，列属性コードについては接続先のデータベースのマニュアルを参照してください。

KFDB006DB-E

指定したDBMSと接続したDBMSが異なります。user DBMS=XXXX system DBMS=YYYY nodename=ZZZZ

The specified DBMS differs from the connected DBMS.

user DBMS=XXXX system DBMS=YYYY nodename=ZZZZ

XXXX：ユーザが指定したDBMS

YYYY：DABrokerが接続したDBMS

ZZZZ：RDノード名称

要因

ユーザが指定したDBMSと接続したDBMSが異なります。

処理

ユーザの要求を受け付けません。

対処

接続するDBMSを見直し，指定し直してください。

KFDB007DB-E

DABrokerでは，繰り返し列，及び配列列を含む表はサポートしていません。

DABroker does not support tables containing multivalue columns and array columns.

要因

DABrokerでは繰り返し列，及び配列列を含む表はサポートしていません。

処理

ユーザからの要求を受け付けません。

対処

列属性を修正し，ユーザからの要求を再実行してください。

KFDB011DB-E

接続しているDBMSでエラーが発生しました。nodename=XXXX SQLCODE=YYYY Info=[ZZZZ]

An error occurred in the connected DBMS. nodename=XXXX SQLCODE=YYYY Info=[ZZZZ]

XXXX：RDノード名称

YYYY：接続しているDBMSのSQLコード

ZZZZ：接続しているDBMSのSQLコードに対する付加情報（付加情報がない場合は出力されません。）

要因

接続しているDBMSでエラーが発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続しているDBMSのマニュアルを参照してください。

KFDB012DB-E

接続しているDBMSでエラーが発生しました。

nodename=XXXX SQLCODE=YYYY IPADDR=ZZZZ

An error occurred in the connected DBMS. nodename=XXXX SQLCODE=YYYY IPADDR=ZZZZ

XXXX：RDノード名称

YYYY：接続しているDBMSのSQLコード

ZZZZ：IPアドレス又はホスト名

要因

接続しているDBMSでエラーが発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続しているDBMSのマニュアルを参照してください。

KFDB013DB-E

ユーザが指定した，認可識別子，パスワード，又はDBMS情報のどれかが32バイトを超えています。

The permission identifier, password or DBMS information specified by the user exceeded 32 bytes.

要因

ユーザが指定した，認可識別子，パスワード，又はDBMS情報のどれかが32バイトを超えています。

処理

ユーザからの要求を受け付けません。

対処

認可識別子，パスワード，又はDBMS情報の文字列の長さを確認し，制限バイト以内になるように指定し直してください。

KFDB017DB-E

表属性の指定が誤っています。ErrInfo［XXXX］

The specified table attribute is incorrect. ErrInfo[XXXX]

XXXX：エラーコード

要因

表属性の指定が誤っています。

処理

ユーザからの要求を受け付けません。

対処

表属性を正しく指定してから，再実行してください。

なお，出力されたエラーコードによって次の内容を見直してください。

エラーコードが1の場合

表属性の前後が`で囲まれているか確認してください。

エラーコードが2の場合

指定されている表属性が誤っていないか確認してください。

エラーコードが3の場合

複数の表属性を指定した場合の区切り文字を確認してください。

KFDB018DB-E

入力パラメタの指定が誤っています。ErrInfo［XXXX，YYYY，ZZZZ］

The specified input parameter is incorrect. ErrInfo［XXXX，YYYY，ZZZZ］

XXXX：入力パラメタの行番号

YYYY：入力パラメタの列番号

ZZZZ：エラー項目名

要因

入力パラメタの指定が誤っています。

処理

ユーザからの要求を受け付けません。

対処

入力パラメタを正しく指定してから，再実行してください。

KFDB019DB-E

出力パラメタの指定が誤っています。ErrInfo［XXXX，YYYY］

The specified output parameter is incorrect. ErrInfo[XXXX, YYYY]

XXXX：出力パラメタの列番号

YYYY：エラー項目名

要因

出力パラメタの指定が誤っています。

処理

ユーザからの要求を受け付けません。

対処

出力パラメタを正しく指定してから，再実行してください。

KFDB020DB-E

DBMSのバージョンが違います。ErrInfo［XXXX］

Incorrect version of the DBMS. ErrInfo[XXXX]

XXXX：保守用情報

要因

DBMSは接続できるバージョンではありません。

処理

ユーザからの要求を受け付けません。

対処

システム管理者にDBMSのバージョンを確認してください。

KFDB021DB-E

複数SQL実行の指定が誤っています。ErrInfo［XXXX，YYYY］

The specified multiple SQL execution is incorrect. ErrInfo[XXXX,YYYY]

XXXX： SQL番号

YYYY： 詳細コード

要因

複数SQL実行の指定が誤っています。

処理

ユーザからの要求を受け付けません。

対処

複数SQL実行を正しく指定してから，再実行してください。

KFDB024DB-E

接続しているDBMSの制限のため，？パラメタでNULLを指定できません。［XXXX］

You cannot specify NULL in the ? parameter because of a limit of the connected DBMS. [XXXX]

XXXX：NULLが指定された？パラメタの位置

要因

？パラメタにNULLが指定されました。

処理

ユーザからの要求を受け付けません。

対処

？パラメタを見直して再実行してください。

KFDB025DB-E

HiRDB または ORACLEに対する接続環境が整っていません。エラーコード=XXXX

Not prepared to connect to HiRDB or ORACLE. Error code=XXXX

XXXX：エラーが発生したOCI関数を示すエラーコード

エラーコードに対応するOCI関数名を次に示します。

-1：xaoEnv

-2：xaoSvcCtx

-3：OCIHandleAlloc

-4：OCISvcCtxToLda

要因

次のどちらかの要因が考えられます。

OTSの初期化が完了していない。

HiRDBがTPBroker(OTS)に登録されていない。

処理

ユーザからの要求を受け付けません。

対処

OTSの初期化完了前にDABrokerにアクセスを要求している可能性があります。アプリケーションを確認してください。OTSの初期化については，接続するデータベースのマニュアルを参照してください。

TPBrokerにHiRDBを登録しているかを確認してください。TPBrokerへのHiRDBの登録については，TPBroker，およびHiRDBのマニュアルを参照してください。

KFDB026DB-E

KFDB026DB-EORACLEのOCI関数でエラーが発生しました。関数名=XXXX リターンコード=YYYY

The error occurred by the OCI function of ORACLE.Function name=XXXX return code=YYYY

XXXX：OCI関数名

YYYY：OCI関数のリターンコード

要因

OCI関数XXXXでエラーが発生しました。

処理

ユーザからの要求を受け付けません。

対処

Oracle Call Interfaceのマニュアルを参照してください。

KFDB027DB-E

LONG型またはLONG RAW型のデータサイズが大きすぎるため，メモリを確保できません。ErrInfo[XXXX]

Required memory cannot be obtained because the data size of the LONG type or LONG RAW type is too large. ErrInfo[XXXX]

XXXX：保守情報

要因

処理に必要な領域の確保時，メモリ不足が発生しました。

処理

ユーザからの要求を受け付けません。

対処

実行中の不要なプログラムを終了してから，再実行してください。

一度に検索するレコード数を少なくしてください。

なお，このメッセージが繰り返し発生する場合は，LONG型またはLONG RAW型を持つデータのサイズを確認して，実メモリ，または仮想メモリの設定を見直してください。

KFDB030DB-E

ODBC接続でエラーが発生しました。

DATASOURCE NAME=WWWW　SQL CODE=XXXX SQLSTATE=YYYY　MESSAGE TEXT=ZZZZ

An error occurred in an ODBC access. DATASOURCE NAME=WWWW SQL CODE=XXXX SQLSTATE=YYYY MESSAGE TEXT=ZZZZ

WWWW：接続データソース名

XXXX：SQLコード，又はDABrokerの保守用情報

YYYY：SQLSTATE

ZZZZ：メッセージテキスト(エラー発生システムのエラーメッセージ)

要因

ODBCで障害が発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続しているDBMSのマニュアルを参照してください。

KFDB031DB-E

ODBC接続でエラーが発生しました。

SQL CODE=XXXX　SQLSTATE=YYYY　MESSAGE TEXT=ZZZZ

An error occurred in an ODBC access.

SQL CODE=XXXX SQLSTATE=YYYY MESSAGE TEXT=ZZZZ

XXXX：SQLコード，又はDABrokerの保守用情報

YYYY：SQLSTATE

ZZZZ：メッセージテキスト(エラー発生システムのエラーメッセージ)

要因

ODBCで障害が発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続しているDBMSのマニュアルを参照してください。

KFDB032DB-E

ODBC接続で要求パラメタが不正です。ErrInfo=XXXX

A request parameter is invalid for ODBC access. ErrInfo=XXXX

XXXX：保守用情報

要因

ODBCでパラメタが誤っています。

処理

ユーザからの要求を受け付けません。

対処

保守員に連絡してください。

KFDB040DB-E

DABroker ODBC接続でエラーが発生しました。

DATASOURCE NAME=WWWW SQL CODE=XXXX SQLSTATE=YYYY

MESSAGE TEXT=ZZZZ

An error occurred in a DABroker ODBC access.

DATASOURCE NAME=WWWW SQL CODE=XXXX SQLSTATE=YYYY

MESSAGE TEXT=ZZZZ

WWWW：接続データソース名

XXXX：SQLコード，又はDABrokerの保守用情報

YYYY：SQLSTATE

ZZZZ：メッセージテキスト(エラー発生システムのエラーメッセージ)

要因

DABroker ODBCで障害が発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続しているDBMSのマニュアルを参照してください。

KFDB041DB-E

DABroker ODBC接続でエラーが発生しました。

SQL CODE=XXXX SQLSTATE=YYYY MESSAGE TEXT=ZZZZ

An error occurred in a DABroker ODBC access.

SQL CODE=XXXX SQLSTATE=YYYY MESSAGE TEXT=ZZZZ

XXXX：SQLコード，又はDABrokerの保守用情報

YYYY：SQLSTATE

ZZZZ：メッセージテキスト(エラー発生システムのエラーメッセージ)

要因

DABroker ODBCで障害が発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続しているDBMSのマニュアルを参照してください。

KFDB042DB-E

DABroker　ODBC接続で要求パラメタが不正です。

ErrInfo=XXXX

A request parameter is invalid for DABroker ODBC access.

ErrInfo=XXXX

XXXX：保守用情報

要因

DABroker ODBC接続でパラメタが誤っています。

処理

ユーザからの要求を受け付けません。

対処

保守員に連絡してください。

KFDB043DB-E

接続した ODBC Driverのバージョンは未サポートです。[XXXX]

DABroker does not support the ODBC Driver version.[XXXX]

XXXX:ODBC Driverのバージョン

要因

接続したODBC Driverはサポートされていないバージョンです。

処理

ユーザからの要求を受け付けません。

対処

ODBC Driverのバージョンを確認してください。

KFDB044DB-E

接続したDBMSは未サポートです。[XXXX]

DABroker does not support the DBMS. [XXXX]

XXXX：保守用情報

要因

接続したDBMSはサポートしていません。

処理

ユーザからの要求を受け付けません。

対処

接続したDBMSを見直し，指定し直してください。

KFDB045DB-E

指定したDBMSと接続したDBMSが異なります。

user DBMS=XXXX system DBMS=YYYY

The specified DBMS differs from the connected DBMS.

user DBMS=XXXX system DBMS=YYYY

XXXX：ユーザが指定したDBMS

YYYY：DABrokerが接続したDBMS

要因

ユーザが指定したDBMSと接続したDBMSが異なります。

処理

ユーザからの要求を受け付けません。

対処

接続するDBMSを見直し，指定し直してください。

KFDB050DB-E

[DABroker.libdaTCPS]で Loadingエラーが発生しました。ErrInfo[XXXX]

A loading error occurred in [libdaTCPS]. ErrInfo[XXXX]

XXXX：保守用情報

要因

Database Connection Serverアクセスで必要なライブラリの処理でエラーが発生しました。

処理

ユーザからの要求を受け付けません。

対処

DABrokerを組み込み直してください。

KFDB051DB-E

接続したサーバーシステムはサポートしていません。[XXXX,YYYY]

DABroker does not support the connected server system. [XXXX,YYYY]

XXXX：接続サーバ名

YYYY：保守用情報

要因

接続しようとしたサーバシステムはサポートしていません。

処理

ユーザからの要求を受け付けません。

対処

接続するDBMSを見直し，指定し直してください。

KFDB052DB-E

接続したサーバーシステムでシステムエラーが発生しました。[XXXX]

A system error occurred in the connected server system. [XXXX]

XXXX：保守用情報

要因

接続したサーバーシステムでエラーが発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続したDBMSを見直し，指定し直してください。

KFDB053DB-E

DABroker DBMSドライバでシステムエラーが発生しました。[XXXX]

A system error occurred in the DABroker DBMS driver. [XXXX]

XXXX：保守用情報

要因

DBMSドライバでエラーが発生しました。

処理

ユーザからの要求を受け付けません。

対処

接続するDBMSを見直し，指定し直してください。

KFDB054DB-E

タイムオーバのため処理を中断しました。

Processing was canceled because a timeover occurred.

要因

タイムアウトが発生しました。

処理

ユーザからの要求を受け付けません。

対処

再度実行してください。なお，このエラーが繰り返し発生する場合は，応答監視時間(DBSTIMER，又はDABDBA_TIMEOUT)の値を大きくしてください。

KFDB060DB-E

XA要求でエラーが発生しました。[XXXX]

An XA request error occurred. [XXXX]

XXXX：保守用情報

要因

XA要求でエラーが発生しました。

処理

ユーザからの要求を受け付けません。

対処

「7.5.4　XA要求時のエラー要因」を参照してください。

KFDB070DB-E

配列の要素に，異なるデータ型があります。[XXXX]

There is a data type which is different in element of arrangement.[XXXX]

XXXX：エラーの原因となったパラメタインデックス

要因

HiRDBの配列インサート機能使用時，配列に指定するデータ型が一致していません。

処理

ユーザからの要求を受け付けません。

対処

配列に指定するデータ型をすべて同じにして，再度実行してください。

KFDB071DB-E

セットされたデータのサイズが，文字データ型の有効範囲を越えています。[XXXX]

The size of data is over the effective range of character data. [XXXX]

XXXX：エラーの原因となったパラメタインデックス

要因

？パラメタにセットされた文字データのサイズが，文字データ型サイズの有効範囲を越えています。

処理

クライアントからの要求を受け付けません。

対処

？パラメタにセットしたデータのサイズを確認し，再度実行してください。

KFDB101DB-E

メモリが不足しているため，処理に必要な領域を確保できません。

Memory is insufficient for processing.

要因

処理に必要な領域の確保時に，メモリ不足が発生しました。

処理

処理を終了します。

対処

実行中のほかの処理を終了してから，再実行してください。

KFDB001EC-E

コマンドの引数に誤りがあります。使用法：dabstop［-p | -f | -c IPアドレス又はホスト名］

Invalid argument. Usage:dabstop[-p | -f | -c IP-address_or_host-name]

要因

dabstopコマンドのオプションに誤りがあります。

処理

処理を終了します。

対処

コマンドを正しく指定して，再実行してください。

KFDB002EC-E

DABrokerは起動していません。

DABroker is not running.

要因

DABrokerを終了しようとしましたが，起動していません。

処理

処理を終了します。

KFDB003EC-E

DABrokerは起動処理中です。コマンドを取り消します。

DABroker is starting. The command is canceled.

要因

dabstopコマンドを実行しましたが，DABrokerの起動処理が完了していません。

処理

処理を終了します。

対処

しばらく時間を空けてから，再実行してください。

KFDB004EC-E

DABrokerは終了処理中です。コマンドを取り消します。

DABroker is terminating. The command is canceled.

要因

dabstopコマンドを実行しましたが，DABrokerは終了処理中です。

処理

処理を終了します。

KFDB005EC-E

DABrokerは計画終了処理中です。コマンドを取り消します。

DABroker is terminating in the planned termination mode. The command is canceled.

要因

dabstopコマンドを実行しましたが，DABrokerは計画終了処理中です。

処理

処理を終了します。

KFDB006EC-E

DABrokerは強制終了処理中です。コマンドを取り消します。

DABroker is terminating in the forced termination mode. The command is canceled.

要因

dabstopコマンドを実行しましたが，DABrokerは強制終了処理中です。

処理

処理を終了します。

KFDB007EC-E

ほかの端末からdabstopコマンドが実行されています。

dabstop has been executed from another terminal.

要因

dabstopコマンドは既にほかの端末から実行されています。

処理

処理を終了します。

KFDB008EC-E

DABrokerを終了する権限がありません。

The user does not have authorization to stop DABroker.

要因

DABrokerを終了しようとしたユーザがAdministratorsグループに属していないため，終了できません。

処理

処理を終了します。

対処

DABrokerはAdministratorsグループに属しているユーザで終了してください。

KFDB009EC-E

実行中の処理があるため，終了できません。コマンドを取り消します。

DABroker cannot terminate because of current processing. The command is canceled.

要因

dabstopコマンドをオプションなしで指定しましたが，接続中のクライアント，実行中の予約処理，又は実行中のエージェント処理があるため，DABrokerを終了できません。

処理

処理を終了します。

対処

実行中の処理及びすべてのクライアントが終了してから，再実行してください。

強制終了する場合はオプション-fを，計画終了する場合はオプション-Pを指定して再実行してください。

KFDB010EC-E

-cオプションで指定したクライアントの処理はありません。

The client processing specified by the -c option was not found.

要因

dabstopコマンドに-cオプションを付け，指定したクライアントの処理を中断しようとしましたが，該当する処理はありませんでした。

処理

処理を終了します。

対処

dabstatコマンドで，実行中の処理を確認してください。

KFDB011EC-E

-cオプションで指定したIPアドレス又はホスト名に誤りがあります。

An incorrect IP address or host name is specified with the -c option.

要因

IPアドレス又はホスト名に誤りがあります。

処理

処理を終了します。

対処

IPアドレス又はホスト名を正しく指定して，再実行してください。

KFDB012EC-E

DABrokerは起動処理中です。

DABroker is starting.

要因

DABrokerを終了しようとしましたが，起動処理が完了していません。

処理

処理を終了します。

対処

しばらく時間を空けてから，再実行してください。

KFDB013EC-E

DABrokerは終了処理中です。

DABroker is terminating.

要因

DABrokerを終了しようとしましたが，終了処理中です。

処理

処理を終了します。

KFDB014EC-E

DABrokerは計画終了処理中です。

DABroker is terminating in the planned termination mode.

要因

DABrokerを終了しようとしましたが，計画終了処理中です。

処理

処理を終了します。

KFDB015EC-E

DABrokerは強制終了処理中です。

DABroker is terminating in the forced termination mode.

要因

DABrokerを終了しようとしましたが，強制終了処理中です。

処理

処理を終了します。

KFDB016EC-E

実行中の処理があるため，終了できません。

DABroker cannot terminate because of current processing.

要因

DABrokerを通常終了※１しようとしましたが，接続中のクライアント，実行中の予約処理，又は実行中のエージェント処理があるため，DABrokerを終了できません。

処理

処理を終了します。

対処

実行中の処理，及びすべてのクライアントが終了してから，再実行してください。

強制終了※２，又は計画終了※３を選択してください。

注※1

［DABroker終了］ダイアログボックスで通常終了を選択します。

注※2

［DABroker終了］ダイアログボックスで強制終了を選択します。または，サービスを停止させます。

注※3

[DABroker終了］ダイアログボックスで計画終了選択します。

KFDB017EC-E

指定したクライアントの処理はありません。

The specified client processing was not found.

要因

クライアントの処理を中断しようとしましたが，該当する処理※１はありませんでした。

処理

処理を終了します。

対処

クライアントの処理状態※２を確認してください。

注※1

［DABroker管理］ウィンドウで選択されたクライアントの処理です。

注※2

DABroker管理ユティリティを使用して確認してください。

KFDB101EC-E

コマンドの引数に誤りがあります。使用法: dabcmstop [-p | -f]

Invalid argument. Usage:dabcmstop [-p | -f]

要因

dabcmstopコマンドのオプションに誤りがあります。

処理

処理を終了します。

対処

コマンドを正しく指定して，再実行してください。

KFDB102EC-E

DABrokerコネクションマルチ機能は起動していません。

The DABroker Connection-Multi function is not running.

要因

DABrokerコネクションマルチ機能を終了しようとしましたが，起動していません。

処理

処理を終了します。

KFDB103EC-E

DABrokerコネクションマルチ機能は起動処理中です。コマンドを取り消します。

The DABroker Connection-Multi function is starting. The command is canceled.

要因

dabcmstopコマンドを実行しましたが，DABrokerコネクションマルチ機能の起動処理が完了していません。

処理

処理を終了します。

対処

しばらく時間を空けてから，再実行してください。

KFDB104EC-E

DABrokerコネクションマルチ機能は終了処理中です。コマンドを取り消します。

The DABroker Connection-Multi function is terminating. The command is canceled.

要因

dabcmstopコマンドを実行しましたが，DABrokerコネクションマルチ機能は終了処理中です。

処理

処理を終了します。

対処

しばらく時間を空けてから，再実行してください。

KFDB105EC-E

DABrokerコネクションマルチ機能は計画終了処理中です。コマンドを取り消します。

The DABroker Connection-Multi function is terminating in the planned termination mode. The command is canceled.

要因

dabcmstopコマンドを実行しましたが，DABrokerコネクションマルチ機能は計画終了処理中です。

処理

処理を終了します。

KFDB106EC-E

DABrokerコネクションマルチ機能は強制終了処理中です。コマンドを取り消します。

The DABroker Connection-Multi function is terminating in the forced termination mode. The command is canceled.

要因

dabcmstopコマンドを実行しましたが，DABrokerコネクションマルチ機能は強制終了処理中です。

処理

処理を終了します。

KFDB107EC-E

ほかの端末からdabcmstopコマンドが実行されています。

dabcmstop has been executed from another terminal.

要因

dabmcstopコマンドは既にほかの端末から実行されています。

処理

処理を終了します。

KFDB108EC-E

DABrokerコネクションマルチ機能を終了する権限がありません。

The user does not have authorization to stop the DABroker Connection-Multi function.

要因

DABrokerコネクションマルチ機能を終了しようとしたユーザがAdministratorsグループに属していないため，終了できません。

処理

処理を終了します。

対処

DABrokerコネクションマルチ機能はAdministratorsグループに属しているユーザが終了してください。

KFDB109EC-E

実行中の処理があるため，終了できません。コマンドを取り消します。

The DABroker Connection-Multi function cannot terminate because of current processing. The command is canceled.

要因

dabcmstopコマンドをオプションなしで指定しましたが，接続中のユーザがあるため，DABrokerコネクションマルチ機能を終了できません。

処理

処理を終了します。

対処

実行中の処理が終了してから，再実行してください。

強制終了する場合はオプション-fを，計画終了する場合はオプション-pを指定して，再実行してください。

KFDB110EC-E

-cオプションで指定した仮想コネクションはありません。

This virtual connection is not specified with the -c option.

要因

dabcmstopコマンドに-cオプションを付け，指定した仮想コネクションを中断しようとしましたが，該当する処理はありませんでした。

処理

処理を終了します。

対処

dabcmstatコマンドで，実行中の処理を確認してください。

KFDB111EC-E

-dオプションで指定した通信デーモンに対応する処理はありません。

This communication demon is not specified with the -d option.

要因

dabcmstopコマンドに-dオプションを付け，指定した通信デーモンに対応した処理を中断しようとしましたが，該当する処理はありませんでした。

処理

処理を終了します。

対処

dabcmstatコマンドで，実行中の処理を確認してください。

KFDB112EC-E

DABrokerコネクションマルチ機能は起動処理中です。

The DABroker Connection-Multi function is starting.

要因

DABrokerコネクションマルチ機能を終了しようとしましたが，起動処理が完了していません。

処理

処理を終了します。

対処

しばらく時間を空けてから，再実行してください。

KFDB113EC-E

DABrokerコネクションマルチ機能は終了処理中です。

The DABroker Connection-Multi function is terminating.

要因

DABrokerコネクションマルチ機能を終了しようとしましたが，終了処理中です。

処理

処理を終了します。

KFDB114EC-E

DABrokerコネクションマルチ機能は計画終了処理中です。

The DABroker Connection-Multi function is terminating in the planned termination mode.

要因

DABrokerコネクションマルチ機能を終了しようとしましたが，計画終了処理中です。

処理

処理を終了します。

KFDB115EC-E

DABrokerコネクションマルチ機能は強制終了処理中です。

The DABroker Connection-Multi function is terminating in the forced termination mode.

要因

DABrokerコネクションマルチ機能を終了しようとしましたが，強制終了処理中です。

処理

処理を終了します。

KFDB116EC-E

実行中の処理があるため，終了できません。

The DABroker Connection-Multi function cannot terminate because of current processing.

要因

DABrokerコネクションマルチ機能を通常終了しようとしましたが，接続中のユーザ処理があるため，DABrokerコネクションマルチ機能を終了できません。

処理

処理を終了します。

対処

実行中の処理が終了してから，再実行してください。

強制終了又は計画終了を選択してください。終了形態については，「4.10　コネクションマルチ機能の使用」を参照してください。

KFDB117EC-E

指定した仮想コネクションはありません。

This specified virtual connection does not exist.

要因

処理を中断しようとしましたが，（[DABrokerコネクションマルチ機能管理]ダイアログボックスで）選択された仮想コネクションはありませんでした。

処理

処理を終了します。

対処

DABrokerコネクションマルチ機能管理ユティリティを使用して仮想コネクションの状態を確認してください。

KFDB002LC-E

コマンドの引数に誤りがあります。使用法:dabcltrc［-c IPアドレス又はホスト名］

Invalid argument. Usage:dabcltrc [-c IP-address_or_host-name]

要因

dabcltrcコマンドのオプションに誤りがあります。

処理

処理を終了します。

対処

コマンドを正しく指定して，再実行してください。

KFDB003LC-E

ユティリティの実行中にメモリ不足が発生しました。

Memory became insufficient during execution of a utility program.

要因

ユティリティの実行中にメモリ不足が発生しました。

処理

処理を終了します。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB004LC-E

DABrokerは動作していません。

DABroker is not starting.

要因

コマンドを実行しましたが，DABrokerが動作していない状態でした。

処理

処理を終了します。

対処

DABrokerが動作しているかどうか確認してください。DABrokerが動作している状態でこのメッセージが出力された場合は，保守員に連絡してください。

KFDB005LC-E

指定されたIPアドレス又はホスト名のクライアントとの通信トレースは見つかりません。

Communication information with the specified IP address or host name cannot be traced.

要因

指定したIPアドレス，又はホスト名のクライアントとの通信トレースが見つかりません。

処理

処理を終了します。

対処

指定したIPアドレス又はホスト名を確認してください。

KFDB001LM-E

システムコールでエラーが発生しました。［XXXX()error=YYYY］

An error occurred in a system call. [XXXX() errno=YYYY]

XXXX：システムコール名称

YYYY：エラー番号

要因

OSのシステムコール関数でエラーが発生しました。

処理

処理を終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB001MM-E

動作環境定義ファイルが存在しません。［XXXX］

The DABroker environment definition file was not found. [XXXX]

XXXX：DABroker動作環境定義ファイル名称

要因

DABroker動作環境定義ファイルが，DABroker運用ディレクトリ/confに存在しません。

処理

DABrokerを終了します。

対処

DABroker動作環境定義ファイルを作成してください。

KFDB002MM-E

動作環境定義に誤りがあります。［XXXX］

The environment definition is incorrect. [XXXX]

XXXX：環境変数名

要因

DABroker動作環境定義ファイルに設定した環境変数の値に誤りがあります。

ユーザが設定した環境変数の値に誤りがあります。

処理

処理を終了します。

対処

テキストエディタを使用して，DABroker動作環境定義ファイルの環境変数の値を修正してください。

ユーザが設定した環境変数の値を修正してください。

KFDB003MM-E

動作環境定義に誤りがあります。LINE=XXXX［YYYY］

The environment definition is incorrect. LINE=XXXX [YYYY]

XXXX：エラー発生行

YYYY：エラー発生定義

要因

DABroker動作環境定義ファイルの構文に誤りがあります。

DABroker動作環境定義ファイルに設定した環境変数の値に誤りがあります。

処理

処理を終了します。

対処

テキストエディタを使用して，DABroker動作環境定義ファイルを修正してください。

KFDB004MM-E

DABroker is not installed.

要因

DABrokerがインストールされていません。DABrokerのインストール環境が不正です。

処理

処理を中断します。

対処

DABrokerを再インストールしてください。

KFDB005MM-E

システムコールでエラーが発生しました。［XXXX errno=YYYY］

An error occurred in a system call. [XXXX errno=YYYY]

XXXX：エラー発生関数の名称

YYYY：エラー番号

要因

XXXX関数でエラーが発生しました。

処理

処理を中断します。

対処

使用するOSのマニュアルを参照しエラー原因を取り除いてから，再実行してください。なお，代表的なシステムコールのエラー番号については，「7.5.3　システムコールのエラー番号」を参照してください。

KFDB006MM-E

System call error occured. [XXXX errno=YYYY]

XXXX：エラー発生関数の名称

YYYY：エラー番号

要因

XXXX関数でエラーが発生しました。

処理

処理を終了します。

対処

使用するOSのマニュアルを参照しエラー原因を取り除いてから，再実行してください。なお，代表的なシステムコールのエラー番号については，「7.5.3　システムコールのエラー番号」を参照してください。

KFDB007MM-E

The message file could not be opened. [XXXX errno=YYYY]

XXXX：メッセージファイル名称

YYYY：エラー番号

要因

DABrokerのメッセージファイルがオープンできません。

処理

処理を続行します。このメッセージ出力以降は，メッセージIDだけを出力します。セットアップコマンドの場合は，処理を中止します。

対処

使用するOSのマニュアルを参照しエラー原因を取り除いてから，再実行してください。DABroker動作環境の設定項目のLANG環境変数（DAB_LANG）にCを設定し，OSのlocaleをCで稼働した場合，このメッセージが出力されたときは，AIX 5Lの環境設定のLC_FASTMSGとしてfalseが設定されているかどうかを確認してください。なお，再実行しても繰り返し発生する場合は，DABrokerの動作環境が破壊されていますので，DABrokerを組み込み直してください。

KFDB008MM-E

An error occurred in a system call during output of XXXX. [YYYY errno=ZZZZ]

XXXX：メッセージログファイル名称

YYYY：エラー発生関数名称

ZZZZ：エラー番号

要因

メッセージログ出力中にシステムコールエラーが発生しました。

処理

処理を続行します。メッセージを syslogに出力します。

対処

使用するOSのマニュアルを参照しエラー原因を取り除いてから，再実行してください。なお，代表的なシステムコールのエラー番号については，「7.5.3　システムコールのエラー番号」を参照してください。

KFDB009MM-E

メモリを確保できませんでした。XXXX

Required memory cannot be obtained. XXXX

XXXX：確保しようとしたメモリのサイズ，又はメモリ不足でエラーとなったシステムコール名称

要因

DABrokerの動作に必要なメモリが不足しています。

処理

DABrokerを終了します。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB010MM-E

接続先データベース定義に誤りがあります。LINE=XXXX［YYYY］

The connection database definition is incorrect. LINE=XXXX [YYYY]

XXXX：エラー発生行

YYYY：エラー発生定義

要因

接続先データベース定義ファイルの構文に誤りがあります。

接続先データベース定義ファイルに設定した値に誤りがあります。

処理

処理を終了します。

対処

テキストエディタを使用して，接続先データベース定義ファイルを修正してください。

KFDB011MM-E

動作環境定義ファイルに対するアクセス権限が有りません。［XXXX］

The user does not have authority to access the environment definition file. [XXXX]

XXXX：DABroker動作環境定義ファイル名称

要因

DABroker動作環境定義ファイルに対するアクセス権限がありません。

処理

処理を終了します。

対処

DABroker動作環境定義ファイルに読み込み権限があるかどうか調べてください。読み込み権限がなければ，読み込み権限を付加してください。

KFDB012MM-E

接続先データベース定義ファイルに対するアクセス権限が有りません。［XXXX］

DABroker does not have authority to access the connection database definition file. [XXXX]

XXXX：接続先データベース定義ファイル名称

要因

接続先データベース定義ファイルに対するアクセス権限がありません。

処理

処理を終了します。

対処

接続先データベース定義ファイルに読み込み権限があるかどうか調べてください。読み込み権限がなければ，読み込み権限を付加してください。

KFDB013MM-E

データベース種別名が重複しています。LINE=XXXX［YYYY］

The database-type-name is duplicated. LINE=XXXX [YYYY]

XXXX：エラー発生行

YYYY：エラー発生ブロック名称

要因

接続先データベース定義ファイル中のデータベース種別名が重複しています。

処理

処理を終了します。

対処

テキストエディタを使用して，接続先データベース定義ファイルの値を修正してください。

KFDB014MM-E

データベース名が重複しています。LINE=XXXX［YYYY］

The database name is duplicated. LINE=XXXX [YYYY]

XXXX：エラー発生行

YYYY：エラー発生ブロック名称

要因

接続先データベース定義ファイル中のデータベース名が重複しています。

処理

処理を終了します。

対処

テキストエディタを使用して，接続先データベース定義ファイルの値を修正してください。

KFDB015MM-E

XXXXを定義していません。［YYYY］

The [XXXX] was not found. [YYYY]

XXXX：必須定義名称

YYYY：定義ブロック名称

要因

接続先データベース定義ファイルのブロック中に必須定義がありません。

処理

処理を終了します。

対処

テキストエディタを使用して，接続先データベース定義ファイルの値を修正してください。

KFDB016MM-E

コネクションマルチ定義に誤りがあります。LINE=XXXX［YYYY］

The Connection-Multi definition is incorrect. LINE=XXXX [YYYY]

XXXX:エラー発生行

YYYY:エラー発生定義

要因

コネクションマルチ定義ファイルの構文に誤りがあります。

コネクションマルチ定義ファイルに設定した定義値に誤りがあります。

処理

処理を終了します。

対処

テキストエディタなどを使用して，コネクションマルチ定義ファイルを修正し てください。

KFDB017MM-E

コネクションマルチ定義ファイルに対するアクセス権限が有りません。［XXXX］

The user does not have authority to access the Connection-Multi definition file. [XXXX]

XXXX：コネクションマルチ定義ファイル名称

要因

コネクションマルチ定義ファイルに対するアクセス権限がありません。

処理

処理を終了します。

対処

DABrokerコネクションマルチ定義ファイルに対するアクセス権限があるかどうか調べてください。アクセス権が無ければ，アクセス権限を付加してください。

なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB018MM-E

コネクションマルチ名が重複しています。LINE=XXXX [YYYY]

The Connection-Multi-name is duplicated. LINE=XXXX [YYYY]

XXXX:エラー発生行

YYYY:エラー発生ブロック名称

要因

コネクションマルチ定義ファイル中のコネクションマルチ名が重複しています。

処理

処理を終了します。

対処

テキストエディタなどを使用して，コネクションマルチ定義ファイルの値を修正してください。

KFDB019MM-E

ディレクトリが存在しません。ディフォルトディレクトリを使用します。［XXXX］

The directory was not found. DABroker will use the default directory. [XXXX]

XXXX：環境変数名

要因

DABroker動作環境定義ファイルで環境変数に設定したディレクトリが存在しないか，使用できません。

ユーザが環境変数に設定したディレクトリが存在しないか，使用できません。

処理

環境変数に指定したディレクトリを無視して，デフォルトのディレクトリを使用します。

対処

環境変数に設定したディレクトリを作成してください。

テキストエディタなどを使用して，DABroker動作環境定義ファイルの環境変数の値を修正してください。

ユーザが設定した環境変数の値を修正してください。

DABroker環境設定ユティリティを使用して，正しいディレクトリを指定してください。

KFDB020MM-E

ディレクトリが存在しません。［XXXX］

The directory was not found. [XXXX]

XXXX：環境変数名

要因

DABroker動作環境定義ファイルで環境変数に設定したディレクトリが存在しないか，使用できません。

ユーザが環境変数に設定したディレクトリが存在しないか，使用できません。

処理

処理を終了します。

対策

環境変数に設定したディレクトリを作成してください。

テキストエディタなどを使用して，DABroker動作環境定義ファイルの環境変数の値を修正してください。

ユーザが設定した環境変数の値を修正してください。

KFDB001NM-E

システムコールでエラーが発生しました。（エラー関数：XXXX，エラーコード：YYYY）

An error occurred in a system call. (Error function:XXXX, error code:YYYY)

XXXX：エラー発生関数名

YYYY：GetLastError関数で返ってきたエラーコード

要因

システムコールでエラーが発生しました。

処理

処理を終了します。

対処

Windowsをシャットダウンさせて再実行してください。なお，このエラーが繰り返し発生する場合は，保守員に連絡してください。

KFDB002NM-E

DABrokerの実行中に異常が発生しました。DABrokerを終了します。(ファイル名：XXXX，行番号：YYYY）

An abnormality occurred during DABroker processing. DABroker terminates.

(File name:XXXX, Line number:YYYY)

XXXX：エラーが発生したソースファイル

YYYY：エラーが発生した行番号

要因

DABroker実行中に異常が発生しました。

処理

処理を終了します。

対処

保守員に連絡してください。

KFDB003NM-E

DABrokerの実行中にメモリ不足が発生しました。

Memory became insufficient during DABroker processing.

要因

DABrokerの実行中にメモリ不足が発生しました。

処理

処理を終了します。

対処

ほかのアプリケーションプログラムを終了して，再実行してください。

KFDB004NM-E

動作環境が不正です。DABrokerをインストールし直してください。

The environment is incorrect. Re-install DABroker.

要因

次の原因が考えられます。

インストールが正しく完了していない。

環境変数（レジストリ）が不正である。

DABrokerのファイルがないか，又は破壊されている。

処理

処理を終了します。

対処

イベントログ（アプリケーション）にほかのメッセージが出力されている場合は，出力されているエラーメッセージを参照してください。

DABrokerをインストールし直して，再実行してください。

KFDB005NM-E

DABrokerの初期化中にエラーが発生しました。

An error occurred during DABroker initialization processing.

要因

DABrokerの初期化処理でエラーが発生しました。

処理

処理を終了します。

対処

イベントログ（アプリケーション）にほかのメッセージが出力されている場合は，出力されているエラーメッセージを参照してください。

ログファイル(dabsv.log)にほかのメッセージが出力されている場合は，出力されているエラーメッセージを参照してください。

定義エラーに対処できない場合は，該当する定義ファイルを削除してください。

KFDB101NM-E

サービス制御処理中にエラーが発生しました。（エラーコード１：XXXX，エラーコード２：YYYY）

An error occurred during service controlled processing. (Error code 1:XXXX, error code 2:YYYY)

XXXX：エラー発生関数種別

YYYY：GetLastErrorで返ってきたエラーコード

要因

サービス制御処理中にエラーが発生しました。

処理

処理を終了します。

対処

イベントログ（アプリケーション），又はメッセージログにほかのメッセージが出力されている場合は，出力されているエラーメッセージを参照してください。

定義エラーに対処できない場合は，該当する定義ファイルを削除してください。

DABrokerをインストールし直して，再実行してください。

1から３の方法で対処できない場合は，Windowsをシャットダウンさせて再実行してください。なお，このエラーが繰り返し発生する場合は，保守員に連絡してください。

KFDB102NM-E

サービス制御処理中にメモリ不足が発生しました。

Memory became insufficient during service controlled processing.

要因

サービス制御処理中にメモリ不足が発生しました。

処理

DABrokerのサービス制御処理を終了します。

対処

ほかのアプリケーションプログラムの終了などによって，動作環境のメモリを確保してから，再実行してください。

KFDB103NM-I

DABrokerサービスを開始しました。

DABroker service has started.

要因

DABrokerサービスを開始し，DABrokerを起動しました。

処理

DABrokerサービスを起動しました。

KFDB104NM-Q

DABrokerサービスを停止してもよろしいですか？

Do you want to terminate the DABroker service?

要因

DABrokerサービスを停止し，DABrokerを終了しようとしました。

処理

ユーザの応答を待ちます。

対処

DABrokerを停止する場合は［はい］を，停止しない場合は［いいえ］ボタンを選択してください。

KFDB105NM-E

DABrokerサービスの情報が誤っているため起動できません。（エラーコード：XXXX）

DABroker cannot start because a DABroker service parameter is invalid. (Error code:XXXX)

XXXX：GetLastError関数で返ってきたエラーコード

要因

DABrokerサービスを開始しようとしましたが，DABrokerサービスの情報が誤っていたためエラーが発生しました。

処理

処理を終了します。

対処

DABrokerをインストールし直してください。その後，再実行してください。

KFDB151NM-E

サービス制御処理中にエラーが発生しました。（エラーコード１：XXXX，エラーコード２：YYYY）

An error occurred during service controlled processing. (Error code 1:XXXX, error code 2:YYYY)

XXXX：エラー発生関数種別

YYYY：GetLastErrorで返ってきたエラーコード

要因

DABrokerコネクションマルチ機能のサービス制御処理中にエラーが発生しました。

処理

処理を終了します。

対処

イベントログ（アプリケーション），又はメッセージログにほかのメッセージが出力されている場合は，出力されているエラーメッセージを参照してください。

定義エラーを対処できない場合は，該当する定義ファイルを削除してください。

DABrokerをインストールし直して，再実行してください。

１から３の方法で対処できない場合は，Windowsをシャットダウンさせて再実行してください。なお，このエラーが繰り返し発生する場合は，保守員に連絡してください。

KFDB152NM-E

サービス制御処理中にメモリ不足が発生しました。

Memory became insufficient during service controlled processing.

要因

DABrokerコネクションマルチ機能のサービス制御処理中にメモリ不足が発生しました。

処理

DABrokerコネクションマルチ機能のサービス制御処理を終了します。

対処

ほかのアプリケーションプログラムの終了などによって，動作環境のメモリを確保してから，再実行してください。

KFDB153NM-I

DABrokerコネクションマルチ機能サービスを開始しました。

The DABroker Connection-Multi function service has started.

要因

DABrokerコネクションマルチ機能サービスを開始し， DABrokerコネクションマルチ機能を起動しました。

処理

DABrokerコネクションマルチ機能サービスを起動しました。

KFDB154NM-Q

DABrokerコネクションマルチ機能サービスを停止してもよろしいですか？

Do you want to terminate the DABroker Connection-Multi function service?

要因

DABrokerコネクションマルチ機能サービスを停止し， DABrokerコネクションマルチ機能を終了しようとしました。

処理

ユーザの応答を待ちます。

対処

DABrokerコネクションマルチ機能を停止する場合は［はい］を，停止しない場合は［いいえ］ボタンを選択してください。

KFDB155NM-E

DABrokerコネクションマルチ機能サービスの情報が誤っているため起動できません。（エラーコード：XXXX）

The DABroker Connection-Multi function cannot start because a DABroker service parameter is invalid. (Error code:XXXX)

XXXX：GetLastError関数で返ってきたエラーコード

要因

DABrokerサービスを開始しようとしましたが，DABrokerサービスの情報が誤っていたためエラーが発生しました。

処理

処理を終了します。

対処

DABrokerをインストールし直してください。その後，再実行してください。

KFDB201NM-E

ディレクトリが正しくありません。

The directory is invalid.

要因

次の原因が考えられます。

ディレクトリ名の指定に誤りがある

存在しないディレクトリが指定されている

処理

処理を終了します。

対処

ディレクトリ名を正しく指定して，再実行してください。

KFDB202NM-E

範囲外の数値データが入力されました。

The entered numerical data is outside the range.

要因

次の原因が考えられます。

数値データ以外の文字が入力された

全角文字が入力された

指定できる範囲外の数値データ入力された

処理

処理を終了します。

対処

指定できるデータの範囲を確認してから，データを再入力してください。

KFDB203NM-Q

クライアントの処理を中断します。IPアドレス：XXXX，ホスト名：YYYY

The client processing was canceled. IP address:XXXX host name:YYYY

XXXX：中断するクライアント処理のIPアドレス

YYYY：中断するクライアント処理のホスト名

要因

クライアントプロセスを管理ユティリティで中断しようとしました。

処理

ユーザの応答を待ちます。

対処

クライアントプロセスを中断する場合は［はい］を，中断しない場合は［いいえ］ボタンを選択してください。

KFDB204NM-E

レジストリ名XXXXの値が長過ぎます。

The registry name XXXX is too long.

XXXX：レジストリの値の名前

要因

レジストリ名XXXXの値の文字列長が1,024バイトを超えました。

処理

処理を終了します。

対処

レジストリエディタで，レジストリ名XXXXの値の文字列を1,024バイト以下に設定してください。

KFDB205NM-E

レジストリ名XXXXで，DABrokerがサポートしているデータタイプと異なるデータタイプが取得されました。

DABroker found a non-supported data type in the registry name XXXX.

XXXX：レジストリの値の名前

要因

レジストリ名XXXXにDABrokerがサポートしているデータタイプと異なるデータタイプが指定されました。

処理

処理を終了します。

対処

レジストリエディタでデータを修正してください。

KFDB206NM-E

レジストリ名XXXXの値の取得に失敗しました。（エラー関数：YYYY，エラーコード：ZZZZ）

DABroker failed to get the value of registry name XXXX.

(Error function:YYYY, error code:ZZZZ)

XXXX：レジストリの値の名前

YYYY：エラー関数名

ZZZZ：GetLastError関数に返されたエラーコード

要因

次の原因が考えられます。

レジストリが破壊された

DABroker，又はユティリティの稼働環境が不安定になった

DABroker，又はユティリティが破壊された

レジストリの読み取り権限がない

処理

処理を終了します。

対処

DABroker，又はユティリティを一度終了して，操作を再実行してください。

レジストリに読み取り権限を付与してください。

1，及び2の方法で対処できない場合は，Windowsを再起動するか，又はDABrokerをインストールし直してください。

KFDB207NM-E

レジストリ名XXXXの値の更新に失敗しました。（エラー関数：YYYY，エラーコード：ZZZZ）

DABroker failed to update the value of registry name XXXX. (Error function:YYYY, error code:ZZZZ)

XXXX：レジストリの値の名前

YYYY：エラー関数名

ZZZZ：GetLastError関数に返されたエラーコード

要因

次の原因が考えられます。

レジストリが破壊された

DABroker，又はユティリティの稼働環境が不安定になった

DABroker，又はユティリティが破壊された

レジストリに書き込み権限がない

処理

処理を続行します。

対処

DABroker，又はユティリティを一度終了して，操作を再実行してください。

レジストリに書き込み権限を付与してください。

1，及び2の方法で対処できない場合は，Windowsを再起動するか，又はDABrokerをインストールし直してください。

KFDB211NM-E

DABrokerが起動中のため，動作環境定義の更新はできません。

An environment definition cannot be updated because DABroker is running.

要因

環境設定ユティリティで，DABrokerの動作環境を更新しようとしましたが，DABrokerが起動中のためできませんでした。

処理

処理を終了します。

対処

DABrokerを終了してから，再実行してください。

KFDB213NM-E

環境設定ユティリティを実行する権限がありません。

The user does not have authority to execute the environment setting utility.

要因

環境設定ユティリティを実行したユーザがAdministratorsグループに属していないため，実行できません。

処理

処理を終了します。

対処

環境設定ユティリティは，Administratorsグループに属しているユーザが実行してください。

KFDB214NM-E

取得する情報の種類が指定されていません。

The type of information to be acquired is not specified.

要因

データベースアクセストレースの取得が指示されたにもかかわらず，取得する情報の種類が一つも指定されていません。

処理

［設定値変更］ダイアログボックスを再表示し，ユーザの操作を待ちます。

対処

取得する情報の種類を一つ以上指定するか，［アクセストレースを取得する］テェックボックスをオフにして，再実行してください。

KFDB215NM-E

DABrokerが起動中のため，更新できません。

Cannot update because DABroker is running.

要因

DABrokerの定義を更新しようとしましたが，DABrokerが起動中のため更新できませんでした。

処理

処理を終了します。

対処

DABrokerを終了してから，再実行してください。

KFDB216NM-W

DABrokerが起動中のため，更新できません。

Cannot update because DABroker is running.

要因

DABrokerの定義を更新しようとしましたが，DABrokerが起動中のためできませんでした。

処理

読み取り専用モードで実行します。

対処

DABrokerを終了してから，再実行してください。

KFDB217NM-W

DABrokerコネクションマルチ機能が起動中のため，更新できません。

Cannot update because the DABroker Connection-Multi function is running.

要因

DABrokerの定義を更新しようとしましたが，DABrokerコネクションマルチ機能が起動中のためできませんでした。

処理

読み取り専用モードで実行します。

対処

DABrokerコネクションマルチ機能を終了してから，再実行してください。

KFDB250NM-I

トレースを出力しました。

The trace has been output.

要因

トレース出力ユティリティで指定したファイルにトレースを出力しました。

処理

処理を続行します。

KFDB251NM-I

出力するトレースがありません。

The trace to be output was not found.

要因

出力を要求された種別のトレースが1件も取得されていません。

処理

処理を続行します。

KFDB252NM-E

通信トレースの出力処理中にエラーが発生しました。

An error occurred during output processing for the communication-trace.

要因

次の原因が考えられます。

出力先のディスクに十分な容量がない

出力先のディスクに書き込む権限がない

出力先のディスクが書き込み禁止である

出力先のファイル指定に誤りがある

処理

処理を終了します。

対処

出力先のディスク，ファイル，及びファイルの指定を確認し，再実行してください。

KFDB253NM-E

アクセストレースの出力処理中にエラーが発生しました。

An error occurred during output processing for the access-trace.

要因

次の原因が考えられます。

出力先のディスクに十分な容量がない

出力先のディスクに書き込む権限がない

出力先のディスクが書き込み禁止である

処理

処理を終了します。

対処

出力先のディスク，又はファイルを確認し，再実行してください。

KFDB302NM-E

接続できないデータベース種別が指定されています。

You specified an invalid database type.

要因

クライアントからデータベースへの接続が要求されましたが，サポートしていないデータベース種別のため，処理できません。

処理

データベースとの接続を中止し，コネクションを解放します。

対処

接続できるデータベース種別を指定してください。

KFDB002RC-E

コマンドの引数に誤りがあります。使用法:dabdbtrc [-u ユーザID] [-pプログラム名]

Invalid argument. Usage:dabdbtrc [-u user-ID][-p program-name]

要因

dabdbtrcコマンドに指定したオプションに誤りがあります。

処理

処理を終了します。

対処

コマンドを正しく指定して，再実行してください。

KFDB003RC-E

ユティリティの実行中にメモリ不足が発生しました。

Memory became insufficient during execution of a utility program.

要因

ユティリティの実行中にメモリ不足が発生しました。

処理

処理を終了します。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB001RM-E

システムコールでエラーが発生しました。［XXXX()error=YYYY］

An error occurred in a system call. [XXXX() errno=YYYY]

XXXX：システムコール名称

YYYY：エラー番号

要因

OSのシステムコール関数でエラーが発生しました。

処理

処理を終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB001RR-E

指定されたユーザIDのデータベースとのアクセストレースは見つかりません。

The access-trace for the database that has the specified user ID could not be found.

要因

指定したユーザIDの，データベースアクセストレースが見つかりません。

処理

処理を終了します。

対処

指定したユーザIDを確認してください。

KFDB002RR-E

指定されたプログラム名のデータベースとのアクセストレースは見つかりません。

The access-trace for the database that has the specified program name could not be found.

要因

指定したクライアントのプログラム名の，データベースアクセストレースが見つかりません。

処理

処理を終了します。

対処

指定したクライアントのプログラム名を確認してください。

KFDB003RR-E

指定されたユーザID，又はプログラム名のデータベースとのアクセストレースは見つかりません。

The access-trace for the database that has the specified user ID or program name could not be found.

要因

指定したユーザID，又はクライアントのプログラム名の，データベースアクセストレースが見つかりません。

処理

処理を終了します。

対処

指定したユーザID，又はクライアントのプログラム名を確認してください。

KFDB001SC-E

コマンドの引数に誤りがあります。使用法:dabstat

Invalid argument. Usage:dabstat

要因

dabstatコマンドのオプションに誤りがあります。

処理

処理を終了します。

対処

コマンドを正しく指定して，再実行してください。

KFDB002SC-E

DABrokerは起動していません。

DABroker is not running.

要因

DABrokerの動作状態を表示※しようとしましたが，DABrokerは起動していません。

処理

処理を終了します。

注※

Windows対応のDABrokerの場合は，管理ユティリティを実行したときです。UNIX対応のDABrokerの場合は，dabstatコマンドを実行したときです。

KFDB003SC-E

DABrokerは起動処理中です。コマンドを取り消します。

DABroker is starting. The command is canceled.

要因

dabstatコマンドを実行しましたが，DABrokerの起動処理が完了していません。

処理

処理を終了します。

対処

しばらく時間を空けて，再実行してください。

KFDB004SC-E

DABrokerは終了処理中です。コマンドを取り消します。

DABroker is terminating. The command is canceled.

要因

dabstatコマンドを実行しましたが，DABrokerは終了処理中です。

処理

処理を終了します。

KFDB005SC-I

DABrokerは計画終了処理中です。

DABroker is terminating in the planned termination mode.

要因

DABrokerの動作状態を表示※しようとしましたが，DABrokerは計画終了処理中です。

処理

DABrokerの動作状態を表示し，計画終了を続行します。

注※

Windows対応のDABrokerの場合は，管理ユティリティを実行したときです。UNIX対応のDABrokerの場合は，dabstatコマンドを実行したときです。

KFDB006SC-E

DABrokerは強制終了処理中です。コマンドを取り消します。

DABroker is terminating in the forced termination mode. The command is canceled.

要因

dabstatコマンドを実行しましたが，DABrokerは強制終了処理中です。

処理

処理を終了します。

KFDB007SC-E

DABrokerは起動処理中です。

DABroker is starting.

要因

DABroker管理ユティリティを実行しましたが，DABrokerの起動処理が完了していません。

処理

処理を終了します。

対処

しばらく時間を空けて，再実行してください。

KFDB008SC-E

DABrokerは終了処理中です。

DABroker is terminating.

要因

DABroker管理ユティリティを実行しましたが，DABrokerは終了処理中です。

処理

処理を終了します。

KFDB009SC-E

DABrokerは強制終了処理中です。

DABroker is terminating in the forced termination mode.

要因

DABroker管理ユティリティを実行しましたが，DABrokerは強制終了処理中です。

処理

処理を終了します。

KFDB101SC-E

コマンドの引数に誤りがあります。使用法：dabcmstat

Invalid argument. Usage:dabcmstat

要因

dabcmstatコマンドのオプションに誤りがあります。

処理

処理を終了します。

対処

コマンドを正しく指定して，再実行してください。

KFDB102SC-E

DABrokerコネクションマルチ機能は起動していません。

The DABroker Connection-Multi function is not running.

要因

DABrokerコネクションマルチ機能の動作状態を表示※しようとしましたが，DABrokerコネクションマルチ機能は起動していません。

処理

処理を終了します。

注※

Windows対応のDABrokerの場合は，プログラムフォルダに登録された[DABrokerコネクションマルチ機能管理]を選択したときです。UNIX対応のDABrokerの場合は，dabcmstatコマンドを実行したときです。

KFDB103SC-E

DABrokerコネクションマルチ機能は起動処理中です。コマンドを取り消します。

The DABroker Connection-Multi function is starting. The command is canceled.

要因

dabcmstatコマンド実行しましたが，DABrokerコネクションマルチ機能の起動処理が完了していません。

処理

処理を終了します。

対処

しばらく時間を空けて，再実行してください。

KFDB104SC-E

DABrokerコネクションマルチ機能は終了処理中です。コマンドを取り消します。

The DABroker Connection-Multi function is terminating. The command is canceled.

要因

dabcmstatコマンドを実行しましたが，DABrokerコネクションマルチ機能は終了処理中です。

処理

処理を終了します。

KFDB105SC-I

DABrokerコネクションマルチ機能は計画終了処理中です。

The DABroker Connection-Multi function is terminating in the planned termination mode.

要因

DABrokerコネクションマルチ機能の動作状態を表示※しようとしましたが，DABrokerコネクションマルチ機能は計画終了処理中です。

処理

DABrokerコネクションマルチ機能の動作状態を表示し，計画終了を続行します。

注※

Windows対応のDABrokerの場合は，プログラムフォルダに登録された[DABrokerコネクションマルチ機能管理]を選択したときです。UNIX対応のDABrokerの場合は，dabcmstatコマンドを実行したときです。

KFDB106SC-E

DABrokerコネクションマルチ機能は強制終了処理中です。コマンドを取り消します。

The DABroker Connection-Multi function is terminating in the forced termination mode. The command is canceled.

要因

dabcmstatコマンドを実行しましたが，DABrokerコネクションマルチ機能は強制終了処理中です。

処理

処理を終了します。

KFDB107SC-E

DABrokerコネクションマルチ機能は起動処理中です。

The DABroker Connection-Multi function is starting.

要因

DABrokerコネクションマルチ機能管理ユティリティを実行しましたが， DABrokerコネクションマルチ機能の起動処理が完了していません。

処理

処理を終了します。

対処

しばらく時間を空けて，再実行してください。

KFDB108SC-E

DABrokerコネクションマルチ機能は終了処理中です。

The DABroker Connection-Multi function is terminating.

要因

DABrokerコネクションマルチ機能管理ユティリティを実行しましたが，DABrokerコネクションマルチ機能は終了処理中です。

処理

処理を終了します。

KFDB109SC-E

DABrokerコネクションマルチ機能は強制終了処理中です。

The DABroker Connection-Multi function is terminating in the forced termination mode.

要因

DABrokerコネクションマルチ機能管理ユティリティを実行しましたが，DABrokerコネクションマルチ機能は強制終了処理中です。

処理

処理を終了します。

KFDB001SM-E

システムコールでエラーが発生しました。［XXXX()errno=YYYY］

An error occurred in a system call. [XXXX() errno=YYYY]

XXXX：システムコール名称

YYYY：エラー番号

要因

OSのシステムコール関数でエラーが発生しました。

処理

処理を終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB002SM-E

共有メモリを取得できませんでした。［shmget()errno=XXXX］

Shared memory cannot be obtained. [shmget() errno=XXXX]

XXXX：エラー番号

要因

OSのシステムコール関数(shmget)でエラーが発生しました。

処理

処理を終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB003SM-E

共有メモリを削除できませんでした。［shmctl()errno=XXXX］

Shared memory cannot be deleted. [shmctl() errno=XXXX]

XXXX：エラー番号

要因

OSのシステムコール関数(shmctl)でエラーが発生しました。

処理

処理を続行します。

対処

このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB004SM-E

セマフォを取得できませんでした。［semget()errno=XXXX］

The semaphore cannot be obtained. [semget() errno=XXXX]

XXXX：エラー番号

要因

OSのシステムコール関数(semget)でエラーが発生しました。

処理

処理を終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB005SM-E

セマフォを削除できませんでした。［semctl()errno=XXXX］

The semaphore cannot be deleted. [semctl() errno=XXXX]

XXXX：エラー番号

要因

OSのシステムコール関数(semctl)でエラーが発生しました。

処理

処理を続行します。

対処

このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB006SM-E

ユティリティの実行中にメモリ不足が発生しました。

Memory is insufficient during execution of a utility program.

要因

ユティリティの実行中にメモリ不足が発生しました。

処理

処理を終了します。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB001TD-E

システムコールでエラーが発生しました。[XXXX errno=YYYY]

An error occurred in a system call. [XXXX errno=YYYY]

XXXX：システムコール名称

YYYY：システムコールのエラー番号

要因

XXXXシステムコールでエラーが発生しました。

処理

クライアントからの要求を受け付けません。

対処

使用するOSのマニュアルを参照しエラー原因を取り除いてから，再実行してください。なお，代表的なシステムコールのエラー番号については，「7.5.3　システムコールのエラー番号」を参照してください。

KFDB002TD-E

メモリ不足が発生しました。

Memory is insufficient.

要因

メモリ不足が発生しました。

処理

クライアントからの要求を受け付けません。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，実メモリ，又は仮想メモリの設定を見直してください。

KFDB003TD-E

指定されたカーソルは使用中，又は初期化処理がされていません。［CursorId=XXXX］

The specified cursor is being used, or it is not initialized. [CursorId=XXXX]

XXXX：カーソル番号

要因

指定されたカーソルは，他の処理で使用中です。または，初期化処理がされていません。

処理

クライアントからの要求を受け付けません。

対処

未使用のカーソルを使用して，再実行してください。または，初期化処理をしてください。

KFDB004TD-E

カーソルの値が不正です。［CursorId=XXXX］

The cursor value is invalid. [CursorId=XXXX]

XXXX：カーソルの値

要因

指定されたカーソルの値が不正です。

処理

クライアントからの要求を受け付けません。

対処

カーソルは1から64の値を指定してください。

KFDB005TD-E

不正なデータを受信しました。［ErrorCode=XXXX］

Invalid data was received. [ErrorCode=XXXX]

XXXX：保守用情報

要因

クライアントから不正なデータを受信しました。

処理

クライアントからの要求を受け付けません。

対処

クライアントのバージョン，又はDABrokerのバージョンを確認してください。

KFDB006TD-E

必要なパラメタがありません。または，パラメタの値が不正です。［XXXX］

The required parameter was not found, or the parameter value is invalid. [XXXX]

XXXX：パラメタ名

USER ID：ユーザID

RD NODE NAME：RDノード名称

TABLE TYPE：表属性

ABSTRACT KIND：データベース種別名

ABSTRACT NAME：データベース名

DATASOURCE：ODBC3.0のデータソース名

要因

パラメタがありません。または，パラメタの値が不正です。

処理

クライアントからの要求を受け付けません。

対処

パラメタを正しく設定して，再実行してください。

KFDB007TD-E

指定された機能はサポートしていません。［RequestCode=XXXX］

DABroker does not support the specified function. [RequestCode=XXXX]

XXXX：保守用情報

要因

クライアントのバージョンが新しいため，サポートしていない機能を要求しました。又は，クライアントが不正なデータを送信しました。

処理

クライアントからの要求を受け付けません。

対処

クライアントのバージョン，又はDABrokerのバージョンを確認してください。なお，クライアントからの要求コードについては，「7.5.2　要求コード/応答コード」を参照してください。

KFDB008TD-E

システムでエラーが発生しました。［ErrorCode=XXXX］

An error occurred in the system. [ErrorCode=XXXX]

XXXX：保守用情報

要因

DABrokerシステム内でエラーが発生しました。

処理

クライアントからの要求を受け付けません。

対処

保守員に連絡してください。

KFDB009TD-E

返信データの要求サイズが不正です。［ResponseSize=XXXX］

The request size of reply data is invalid. [ResponseSize=XXXX]

XXXX：保守用情報

要因

クライアントが要求した返信データのサイズが不正です。

処理

クライアントからの要求を受け付けません。

対処

保守員に連絡してください。

KFDB010TD-E

要求コードのシーケンスエラーが発生しました。[RequestCode=XXXX-YYYY]

A sequence error of the request code occurred. [RequestCode=XXXX-YYYY]

XXXX：前回の要求コード

YYYY：今回の要求コード

要因

クライアントからの要求コードのシーケンスエラーが発生しました。

処理

クライアントからの要求を受け付けません。

対処

出力された要求コードを基に要求シーケンスを見直してください。なお，要求コードについては，「7.5.2　要求コード/応答コード」を参照してください。

KFDB011TD-E

指定されたデータベースは未サポートです。

DABroker does not support the specified database.

要因

クライアントのバージョンが新しいため，サポートしていないデータベースを指定しました。または，クライアントが不正なデータを送信しました。

処理

クライアントからの要求を受け付けません。

対処

接続先のデータベースを見直してください。

KFDB012TD-E

指定されたSQLに誤りがあります。

The specified SQL is incorrect.

要因

クライアントが指定したSQLに次に示す誤りがあります。

「:」の使用方法が不正です。

処理

クライアントからの要求を受け付けません。

対処

SQLの誤りを修正し，再実行してください。

KFDB013TD-E

データベースアクセスライブラリでエラーが発生しました。［ErrorCode=XXXX］

An error occurred in the database access library. [ErrorCode=XXXX]

XXXX：詳細コード

要因

データベースアクセスライブラリでエラーが発生しました。

処理

クライアントからの要求を受け付けません。

対処

詳細コードを参照しエラー原因を取り除いてから，再実行してください。なお，詳細コードについては，「7.5.1　DABroker詳細コード」を参照してください。

KFDB015TD-E

タイムオーバのため処理を中断しました。

要因

タイムアウトが発生しました。

処理

クライアントからの要求を受け付けません。

対処

クライアントを再起動してから，操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB016TD-E

データベースアクセスでエラーが発生しました。［ErrorCode=XXXX］

A database access error occurred. [ErrorCode=XXXX]

XXXX：DBMSのエラーコード

要因

データベースアクセスでエラーが発生しました。

処理

クライアントからの要求を受け付けません。

対処

DBMSのマニュアルを参照してエラーとなる原因を取り除き，操作を再実行してください。

KFDB030TD-Ｗ

キャンセルされたため，処理を中断しました。

Processing was canceled.

要因

キャンセルされたため，処理を中断しました。

処理

処理を終了します。

KFDB031TD-Ｗ

処理が終了したため，キャンセルできません。

Processing cannot be canceled because it has already ended

要因

処理をキャンセルしようとしましたが，処理が終了したため，キャンセルできませんでした。

処理

キャンセル処理を終了します。

KFDB032TD-E

クライアントでサポートされていないデータ型があります。(DataType=XXXX)

A data type that the client does not support was found. (DataType=XXXX)

XXXX：データ属性コード

要因

クライアントでサポートされていないデータ型があります。

処理

処理を終了します。

対処

表の定義，又はDABrokerのバージョンを見直してください。また，データ属性コードについては，接続先のデータベースのマニュアルを参照してください。

KFDB033TD-E

データベースに接続されていません。

Not connected to the database.

要因

データベースに接続されていません。

処理

処理を終了します。

対処

データベースの接続を行ってから，処理を再実行してください。

KFDB034TD-E

指定されたファイルを削除する権限がありません。

ファイル名：XXXX

The user does not have authorization to delete the specified file. File:XXXX

XXXX：ファイル名

要因

指定されたファイルを削除する権限がありません。

処理

処理を終了します。

対処

ファイルの権限を確認し，再実行してください。

KFDB035TD-E

指定されたファイルがありません。ファイル名：XXXX

The specified file was not found. File:XXXX

XXXX：ファイル名

要因

指定されたファイルが見つかりません。

処理

処理を終了します。

対処

ファイルの名を確認し，再実行してください。

KFDB036TD-E

指定されたファイルの削除に失敗しました。ファイル名：XXXX［unlink（）errno＝YYYY］

DABroker failed to delete the specified file. File:XXXX [unlink() errno=YYYY]

XXXX：ファイル名

YYYY：unlink()のエラー番号

要因

指定されたファイルの削除に失敗しました。

処理

処理を終了します。

対処

unlink()のエラー番号を参照してエラーとなる原因を取り除いてください。なお，unlink()のエラー番号については，「7.5.3　システムコールのエラー番号」を参照してください。

KFDB037TD-E

クライアントへの情報の送信に使用する領域が不足しました。要因＝XXXX

The area for sending information to the client was insufficient. Cause=XXXX

XXXX：処理種別

要因

クライアントへの情報の送信に使用する領域が不足しました。

処理

クライアントからの要求を受け付け，処理を行いました。

対処

クライアントプログラムで設定した受信データ領域長を見直してください。データベースに対して更新，又は表の定義を要求した場合，データベースにアクセスし，処理が正しく実行されているか確認してください。

なお，出力された処理種別によって次の計算式を使用して必要な受信データ領域長を算出し，受信データ領域長を見直してください。ただし，対策後もこのエラーが繰り返し発生する場合，及びこのほかの処理種別が出力された場合は，保守員に連絡してください。

処理種別が EXT-CMD <Prepare> の場合

処理種別が EXT-CMD <Fetch> の場合

検索する1レコードの長さ＋4＊検索する列数 バイト

処理種別が PROCEDURE PREPARE の場合

処理種別が PROCEDURE EXECUTE の場合

処理種別が PROCEDURE-PARAMETER の場合

処理種別が PROCEDURE-RESULT の場合

処理種別が EXT-CMD <EXECUTE> の場合

52+4＊設定された可変値データのうち実行されたレコード数 バイト

KFDB040TD-E

指定されたデータベース種別定義がありません。データベース種別名：XXXX

The specified database type definition was not found. Database-type-name:XXXX

XXXX：データベース種別名

要因

指定されたデータベース種別名が見つかりません。

処理

クライアントからの要求を受け付けません。

対処

接続先データベース定義で指定したデータベース種別名を確認し，再実行してください。

KFDB041TD-E

指定されたデータベース名定義がありません。データベース種別名：XXXX，データベース名：YYYY

The specified database definition name was not found. Database-type-name:XXXX database-name:YYYY

XXXX：データベース種別名

YYYY：データベース名

要因

指定されたデータベース名が見つかりません。

処理

クライアントからの要求を受け付けません。

対処

接続先データベース定義で指定したデータベース名を確認し，再実行してください。

KFDB042TD-E

指定されたコネクションマルチ定義がありません。データベース種別名：XXXX，データベース名：YYYY

The specified Connection-Multi definition name was not found.

Database-type-name:XXXX database-name:YYYY

XXXX：データベース種別名

YYYY：データベース名

要因

指定されたコネクションマルチ名が見つかりません。

処理

クライアントからの要求を受け付けません。

対処

接続先データベース定義に指定したコネクションマルチ名を確認し，再実行してください。

KFDB043TD-E

指定されたデータベース名定義に分散定義名称がありません。データベース種別名：XXXX，データベース名：YYYY

The distributed-definition-name was not found in the specified database name definition.

Database-type-name:XXXX database-name:YYYY

XXXX：データベース種別名

YYYY：データベース名

要因

指定されたデータベース名定義に分散定義名称が定義されていません。

処理

クライアントからの要求を受け付けません。

対処

接続先データベース定義を確認し，再実行してください。

KFDB044TD-E

指定されたコネクションマルチ定義にホスト名，又はIPアドレスがありません。

データベース種別名：XXXX，データベース名：YYYY

The host name or the IP address was not found in the specified Connection-Multi definition. Database-type-name:XXXX database-name:YYYY

XXXX：データベース種別名

YYYY：データベース名

要因

指定されたコネクションマルチ定義にホスト名，又はIPアドレスが定義されていません。

処理

クライアントからの要求を受け付けません。

対処

接続先データベース定義，及びコネクションマルチ定義を確認し，再実行してください。

KFDB045TD-E

指定されたコネクションマルチ定義にサービス名，又はポート番号がありません。

データベース種別名：XXXX，データベース名：YYYY

The service name or port number not was found in the specified Connection-Multi definition. Database-type-name:XXXX database-name:YYYY

XXXX：データベース種別名

YYYY：データベース名

要因

指定されたコネクションマルチ定義にサービス名，又はポート番号が定義されていません。

処理

クライアントからの要求を受け付けません。

対処

接続先データベース定義，及びコネクションマルチ定義を確認し，再実行してください。

KFDB046TD-E

指定されたデータベース名定義にコネクションマルチ名がありません。

データベース種別名：XXXX，データベース名：YYYY

The Connection-Multi name was not found in the specified database name definition.

Database-type-name:XXXX database-name:YYYY

XXXX：データベース種別名

YYYY：データベース名

要因

指定されたデータベース名定義にコネクションマルチ名が定義されていません。

処理

クライアントからの要求を受け付けません。

対処

接続先データベース定義を確認し，再実行してください。

KFDB047TD-E

データベース種別定義に定義したデータベース種別と，クライアントから接続要求したデータベース種別が異なります。

データベース種別名：XXXX，データベース名：YYYY

The specified database type in the database type definition differs from the database type in the connection request from the client. Database-type-name:XXXX database-name:YYYY

XXXX：データベース種別名

YYYY：データベース名

要因

データベース種別定義に定義したデータベース種別とクライアントから接続要求したデータベース種別が異なります。

処理

クライアントからの要求を受け付けません。

対処

接続先データベース定義，及びクライアントの設定を確認し，再実行してください。

KFDB048TD-E

指定されたデータベース名定義にユーザIDがありません。

データベース種別名：XXXX，データベース名：YYYY

The user ID was not found in the specified database name definition. Database-type-name:XXXX database-name:YYYY

XXXX：データベース種別名

YYYY：データベース名

要因

指定されたデータベース名定義にユーザIDが定義されていません。

処理

クライアントからの要求を受け付けません。

対処

接続先データベース定義を確認し，再実行してください。

KFDB049TD-E

データ処理中にメモリ不足が発生しました。 ErrInfo[XXXX]

Memory is insufficient during data processing. ErrInfo[XXXX]

XXXX：保守用情報

要因

処理に必要な領域を確保しようとした時，メモリ不足が発生しました。

処理

処理を終了します。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，実メモリ，又は仮想メモリの設定を見直してください。

KFDB001TJ-E

JNI function (XXXX) failed. LINE：YYYY

XXXX：JNI関数名称

YYYY：保守用情報

要因

JNI関数でエラーが発生しました。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB002TJ-E

Handle of dayd_Control is NULL. LINE：XXXX

XXXX：保守用情報

要因

内部関数(dayd_Control())で使うハンドルがNULLです。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB003TJ-E

Invalid handle. LINE：XXXX

XXXX：保守用情報

要因

Java I/F関数に指定するハンドルに不正があります。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB004TJ-E

Local storage allocation failed.

要因

メモリの確保ができません。

処理

当メッセージをThrowします。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，実メモリ，又は仮想メモリの設定を見直してください。

KFDB005TJ-E

Invalid argument. LINE：XXXX

XXXX：保守用情報

要因

Java I/F関数に指定する引数に不正があります。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB006TJ-E

Invalid calling sequence. LINE：XXXX

XXXX：保守用情報

要因

Java I/F関数の呼び出し順序が不正です。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB007TJ-E

Storage allocation failed.

要因

メモリの確保ができないのでDBMS側が処理できません。

処理

当メッセージをThrowします。

対処

メモリの確保ができる状態にしてください。

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，実メモリ，又は仮想メモリの設定を見直してください。

KFDB008TJ-E

jbyteArray of send data is NULL. LINE：XXXX

XXXX：保守用情報

要因

Java I/F関数に渡された送信データがNULLです。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB009TJ-E

Size of receive buffer is under 0. LINE：XXXX

XXXX：保守用情報

要因

Java I/F関数に渡された受信データバッファサイズが負の数です。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB010TJ-E

The size of the received data is over the buffer size. LINE:XXXX

XXXX：保守用情報

要因

Java I/F関数に渡された受信バッファサイズを受信データのサイズが超えました。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB011TJ-E

jbyteArray of receive buffer is NULL. LINE：XXXX

XXXX：保守用情報

要因

Java I/F関数に渡された受信バッファアドレスがNULLです。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB012TJ-E

Invalid response information. LINE：XXXX

XXXX：保守用情報

要因

ハンドル毎に保持している応答情報に不正があります。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB013TJ-E

Invalid status. LINE：XXXX

XXXX：保守用情報

要因

Java I/F関数の状態不正です。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB014TJ-E

Error outbreak. LINE：XXXX

XXXX：保守用情報

要因

Java I/F関数がエラー発生中です。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB015TJ-E

Invalid response information status. LINE：XXXX

XXXX：保守用情報

要因

Java I/F関数でハンドル毎に保持している応答データ情報状態が不正です。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB016TJ-E

dayd_Control failed. LINE：XXXX

XXXX：保守用情報

要因

dayd_Control関数が予期しないreturn値で失敗しました。

処理

当メッセージをThrowします。

対処

保守員に連絡してください。

KFDB017TJ-E

Invalid environment. XXXX

XXXX：Java I/F関数

要因

DABrokerの動作環境が不正です。

処理

当メッセージをThrowします。

対処

DABrokerの動作環境を見直してください。

KFDB001TM-E

servicesファイルに，DABrokerのサービス名とポート番号(DABROKER_SV)が登録されていません。

The services name and port number(DABROKER_SV) of DABroker are not listed in the "services" file.

要因

システムのservicesファイルに，DABrokerのサービス名とポート番号が登録されていません。

処理

処理を終了します。

対処

servicesファイルに，次の記述を追加してください。

DABROKER_SV XXXXX/tcp

XXXXXにはDABrokerがオープンするポート番号を指定します。推奨値は40179です。

NISを使用している場合は，NISのサーバに追加してください。

KFDB002TM-E

ソケットをオープンできません。［socket() errno=XXXX］

The socket cannot be opened. [socket() errno=XXXX]

XXXX：エラー番号

要因

OSのシステムコール関数(socket)でエラーが発生しました。

処理

処理を終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB003TM-E

ソケットへのアドレスの割り付けができません。［bind() errno=XXXX］

The address cannot be allocated to the socket. [bind() errno=XXXX]

XXXX：エラー番号

要因

OSのシステムコール関数(bind)でエラーが発生しました。DABrokerの強制終了時に，LAN上に通信データが残った可能性があります。

処理

処理を終了します。

対処

しばらく時間を空けてから，DABrokerを再起動してください。

KFDB004TM-E

コネクション要求の受付開始時にエラーが発生しました。［listen() errno=XXXX］

An error occurred when a requested connection was accepted. [listen() errno=XXXX]

XXXX：エラー番号

要因

OSのシステムコール関数(listen)でエラーが発生しました。

処理

処理を終了します。

対処

保守員に連絡してください。

KFDB005TM-E

コネクションの確立時にエラーが発生しました。［accept() errno=XXXX］

An error occurred when a connection was established. [accept() errno=XXXX]

XXXX：エラー番号

要因

OSのシステムコール関数(accept)でエラーが発生しました。

処理

処理を終了します。

対処

システムに負荷が掛かっていることが考えられます。時間を空けてから，再度処理を実行してください。なお，システムが出力するメッセージなどで対処できず，このエラーが繰り返し発生する場合は，保守員に連絡してください。

KFDB006TM-I

コネクションを確立します。［XXXX］

A connection is established. [XXXX]

XXXX：クライアントのIPアドレス又はホスト名

要因

クライアントとの接続を開始しました。

処理

処理を続行します。

KFDB007TM-I

コネクションを解放します。［XXXX］

A connection is released. [XXXX]

XXXX：クライアントのIPアドレス又はホスト名

要因

クライアントとの接続を終了しました。

対処

処理を続行します。

KFDB008TM-E

クライアントプログラムのバージョンが違います。

Incorrect version of the client program.

要因

クライアントプログラムは接続できるバージョンではありません。

処理

クライアントからの要求を受け付けません。

対処

クライアントプログラムのバージョンを確認してください。

KFDB009TM-E

メモリ不足が発生したため，データベースに接続できません。IPADDR=XXXX

Cannot connect the database because of insufficient memory. IPADDR=XXXX

XXXX：IPアドレス又はホスト名　クライアントには「IPADDR=XXXX」は表示されません。

要因

メモリ不足が発生したため，データベースに接続できません。

処理

データベースとの接続を中止し，コネクションを解放します。

対処

DABrokerで実行中のほかの処理が終了してから，再実行してください。

KFDB010TM-E

不正なデータを受信しました。エラーコード=XXXX，IPADDR=YYYY

Invalid data was received. Error code=XXXX IPADDR=YYYY

XXXX：保守用情報

YYYY：IPアドレス又はホスト名　クライアントには「IPADDR=YYYY」は表示されません。

要因

クライアントから不正なデータを受信しました。

処理

クライアントからの要求を無視します。または，処理を終了します。

対処

保守員に連絡してください。

KFDB011TM-E

通信処理でエラーが発生しました。エラーコード=XXXX，IPADDR=YYYY

An error occurred during communication processing. Error code=XXXX IPADDR=YYYY

XXXX：保守用情報

YYYY：IPアドレス又はホスト名　クライアントには「IPADDR=YYYY」は表示されません。

要因

データの送信時，通信管理プログラムでエラーが発生しました。

処理

処理を終了します。

対処

システム管理者に連絡してください。

KFDB012TM-E

データの送受信中にシーケンスエラーが発生しました。エラーコード=XXXX　IPADDR=YYYY

A sequence error occurred during sending or receiving of data.

Error code=XXXX IPADDR=YYYY

XXXX：保守用情報

YYYY：IPアドレス又はホスト名　クライアントには「IPADDR=YYYY」は表示されません。

要因

クライアントから不正なシーケンスでデータを受信しました。

処理

クライアントからの要求を無視します。または，処理を終了します。

対処

保守員に連絡してください。

KFDB013TM-E

DABrokerが計画終了中のため，処理要求を受け付けられません。IPADDR=XXXX

The processing request cannot be accepted because DABroker is terminating in the planned termination mode. IPADDR=XXXX

XXXX：IPアドレス又はホスト名　クライアントには「IPADDR=XXXX」は表示されません。

要因

データベースと接続しようとしましたが，DABrokerが計画終了中です。計画終了中は，新たなクライアントからの処理要求を受け付けません。

処理

クライアントからの要求を無視します。

対処

DABrokerの計画終了が終わってから，DABrokerを再起動してください。その後，DABroker及びデータベースへの接続を再実行してください。

KFDB014TM-I

TCP/IP通信処理スレッドを終了します。要因：［XXXX］，IPADDR=YYYY

The TCP/IP communication thread is terminated. Cause:[XXXX] IPADDR=YYYY

XXXX：終了要因

CANCEL_REQUEST：ユーザキャンセル要求

TERM_REQUEST：強制終了要求

YYYY：IPアドレス又はホスト名。クライアントには「IPADDR=XXXX」は表示されません。

要因

強制終了※１，又はユーザキャンセル※２要求によりTCP/IP通信用の処理スレッドが終了しました。

処理

トランザクションのロールバック及びデータベースとの切り離しを行い，コネクションを解放します。

対処

システム管理者が強制終了，又はユーザキャンセル要求を行っていないか確認してください。

注※１

Windows対応のDABrokerの場合は，［DABroker終了］ダイアログボックスで強制終了を選択，又はサービスを停止させたときです。UNIX対応のDABrokerの場合は，-fオプションを指定したdabstopコマンドを実行したときです。

注※２

Windows対応のDABrokerの場合は，［DABroker管理］ウィンドウで選択されたククライアントの処理を中断したときです。UNIX対応のDABrokerの場合は，-cオプションで指定されたホスト名，又はIPアドレスに対応したクライアントの処理をdabstopコマンドで中断したときです。

KFDB016TM-E

クライアントからの要求待ちタイムアウトが発生しました。コネクションを解放します。IPADDR=XXXX

A timeout occurred during the wait for the request from the client.

DABroker releases the connection. IPADDR=XXXX

XXXX：IPアドレス又はホスト名　クライアントには「IPADDR=XXXX」は表示されません。

要因

DABroker動作環境定義ファイルでDABCLIENT_TIMEOUTに指定した値以内に，クライアントからの要求がありませんでした。

処理

トランザクションのロールバック及びデータベースとの切り離しを行い，コネクションを解放します。

対処

クライアントを再起動してから，操作を再実行してください。なお，このエラーが繰り返し発生する場合は，DABCLIENT_TIMEOUTの値を大きくしてください。

KFDB017TM-E

データベースアクセス処理終了待ちタイムアウトが発生しました。コネクションを解放します。IPADDR=XXXX

A timeout occurred during the wait for termination of the database access.

DABroker releases the connection. IPADDR=XXXX

XXXX：IPアドレス又はホスト名　クライアントには「IPADDR=XXXX」は表示されません。

要因

DABroker動作環境定義ファイルでDABDBA_TIMEOUTに指定した値以内に，データベースアクセス処理が終了しませんでした。

処理

実行中の処理を中断し，コネクションを解放します。

対処

クライアントを再起動してから，操作を再実行してください。なお，このエラーが繰り返し発生する場合は，DABDBA_TIMEOUTの値を大きくしてください。

KFDB018TM-E

コネクションが強制解放されました。IPADDR=XXXX

The connection was forcibly released. IPADDR=XXXX

XXXX：IPアドレス又はホスト名　クライアントには「IPADDR=XXXX」は表示されません。

要因

クライアントシステムが原因で，コネクションを強制解放しました。

処理

トランザクションのロールバック及びデータベースとの切り離しを行い，コネクションを解放します。

対処

クライアントでシステムダウンやタイムアウトなどが発生していないかどうか調査してください。また，ケーブルの接続や電源の状態などを確認してください。

KFDB019TM-E

コネクションが強制解放されました。IPADDR=XXXX

The connection was forcibly released. IPADDR=XXXX

XXXX：IPアドレス又はホスト名　クライアントには「IPADDR=XXXX」は表示されません。

要因

TCP/IP通信時のキープアライブ機能によって，障害が検知されました。

処理

トランザクションのロールバック及びデータベースとの切り離しを行い，コネクションを解放します。

対処

クライアントシステム又はクライアント通信システムが障害を起こしていないか確認してください。

回線の接続状態を調査してください。

KFDB020TM-E

データベースアクセス処理が異常終了しました。エラーコード=XXXX　IPADDR=YYYY

The database access process terminated abnormally. Error code=XXXX IPADDR=YYYY

XXXX：保守用情報

YYYY：IPアドレス又はホスト名　クライアントには「IPADDR=YYYY」は表示されません。

要因

システムに負荷が掛かり過ぎているか，又は他の障害によって，データベースアクセス処理が異常終了しました。

処理

コネクションを解放します。

対処

システムに負荷が掛かり過ぎていないか，又は他の障害が発生していないか確認してください。エラーの原因が分からない場合は，保守員に連絡してください。

KFDB021TM-E

TCP/IP通信処理プロセスを終了します。要因：[XXXX]

The TCP/IP communication process terminated. Cause:[XXXX]

XXXX：終了要因（保守用情報）

要因

TCP/IP通信処理プロセスが異常終了しました。

処理

コネクションを解放します。

以降のクライアントからの要求を受け付けません。

対処

killコマンドなどを入力していないか，又はシステムに負荷が掛かり過ぎていないか確認してください。エラーの原因が分からない場合は，保守員に連絡してください。

KFDB022TM-W

キャンセル処理要求を受け付けられる状態ではありません。［XXXX］　IPADDR=YYYY

The cancel processing request cannot be accepted. [XXXX] IPADDR=YYYY

XXXX：保守用情報

YYYY：IPアドレス又はホスト名　クライアントには「IPADDR=YYYY」は表示されません。

要因

DABrokerは，非同期キャンセル要求を受け付けましたが，キャンセル処理を実行できる状態ではありません。

処理

キャンセル処理を実行しませんでした。

対処

必要ならば，再度，キャンセル要求を実行してください。

KFDB023TM-E

指定されたDBMSに対する環境変数に誤りがあります。［XXXX=YYYY］IPADDR=ZZZZ

The specified DBMS environment variable is incorrect. [XXXX] IPADDR=YYYY

XXXX：環境変数名

YYYY：環境変数の値

ZZZZ：IPアドレス又はホスト名　クライアントには「IPADDR=ZZZZ」は表示されません。

要因

指定されたDBMSに対して，動作環境定義ファイルに設定した環境変数の値に誤りがあります。

処理

クライアントからの要求を無視します。

対処

動作環境定義ファイルの環境変数の値を修正してください。

KFDB001TR-E

クライアントとの通信トレースの取得中に，メモリ不足が発生しました。

Memory became insufficient during collection of a trace of communication with a client.

要因

クライアントとの通信トレースの取得に必要なメモリが不足しました。

処理

処理を続行します。ただし，このエラーが発生したクライアントとの通信トレースは取得しません。

対処

このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB002TR-E

クライアントとの通信トレースの取得中に，ディスクの容量不足が発生しました。

Disk space became insufficient during collection of a trace of communication with a client.

要因

クライアントとの通信トレースの取得中に，ディスクの容量不足が発生しました。

処理

処理を続行します。ただし，このエラーが発生したクライアントとの通信トレースは取得しません。

対処

通信トレースを取得するディレクトリ下の不要なファイルを削除してください。

KFDB003TR-E

クライアントとの通信トレースの取得中に，システムコールでエラーが発生しました。

［XXXX()errno=YYYY］

An error occurred in a system call during collection of a trace of communication with a client.

[XXXX() errno=YYYY]

XXXX：システムコール名称

YYYY：エラー番号

要因

OSのシステムコール関数，あるいはDABrokerの共通関数でエラーが発生しました。

処理

処理を続行します。ただし，このエラーが発生したクライアントとの通信トレースは取得しません。

対処

このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB001YM-E

コマンドの引数に誤りがあります。使用法：dabstart [-t] [-a]

Invalid argument. Usage:dabstart [-t] [-a]

要因

dabstartコマンドのオプションに誤りがあります。

処理

DABrokerを終了します。

対処

コマンドを正しく指定して，再実行してください。

KFDB003YM-I

DABrokerの初期化処理が完了しました。

DABroker initialization processing has finished.

要因

DABrokerの起動要求※を受け付け，初期化処理が完了しました。

処理

DABrokerを起動し，クライアントからのアクセス要求の受け付けを開始します。

注※

Windows対応のDABrokerの場合は，［DABroker起動］アイコンをダブルクリック，又はサービスを開始したときです。UNIX対応のDABrokerの場合は，dabstartコマンドを実行したときです。

KFDB004YM-I

DABrokerの終了処理を開始しました。mode=NORMAL

DABroker termination processing has started. mode=NORMAL

要因

DABrokerの通常終了※処理を開始しました。

処理

DABrokerを終了します。

注※

Windows対応のDABrokerの場合は，［DABroker終了］ダイアログボックスで通常終了を選択したときです。UNIX対応のDABrokerの場合は，オプションを指定しないでdabstopコマンドを実行したときです。

KFDB005YM-I

DABrokerの終了処理を開始しました。mode=FORCED

DABroker termination processing has started. mode=FORCED

要因

DABrokerの強制終了※処理を開始しました。

処理

データベースへのアクセスを中断します。実行中の処理のロールバック及びデータベースとの切り離しを行い，コネクションを解放します。

注※

Windows対応のDABrokerの場合は，［DABroker終了］ダイアログボックスで強制終了を選択，又はサービスの停止を実行したときです。UNIX対応のDABrokerの場合は，-fオプションを指定したdabstopコマンドを実行したときです。

KFDB006YM-I

DABrokerの終了処理を開始しました。mode=PLANNED

DABroker termination processing has started. mode=PLANNED

要因

DABrokerの計画終了※処理を開始しました。

処理

実行中のデータベースへのアクセス処理が終了し，接続中のクライアントがすべて終了した時点でDABrokerを終了します。計画終了中は，クライアントからの処理要求や，新たなクライアントからの接続要求は受け付けません。

注※

Windows対応のDABrokerの場合は，［DABroker終了］ダイアログボックスで計画終了を選択したときです。UNIX対応のDABrokerの場合は，-pオプションを指定したdabstopコマンドを実行したときです。

KFDB007YM-E

DABrokerは計画終了中です。クライアントは接続できません。

DABroker is terminating in the planned termination mode. A client cannot be connected.

要因

DABrokerに接続しようとしましたが，DABrokerが計画終了中です。計画終了中は，新たなクライアントからの接続要求は受け付けません。

処理

クライアントからの要求を受け付けません。

対処

DABrokerの計画終了が終わってから，DABrokerを再起動してください。その後，DABrokerへの接続を再実行してください。

KFDB008YM-E

接続できる最大クライアント数を超えました。クライアントは接続できません。

［DABMAXUSERS=XXX］

The number of clients exceeds the maximum that can be connected.

A client cannot be connected. [DABMAXUSERS=XXXX]

XXX：接続できる最大クライアント数

要因

DABroker動作環境定義ファイルでDABMAXUSERSに設定した値を超えて，クライアントからの接続要求が発生しました。

処理

クライアントからの要求を受け付けません。

対処

ほかのクライアントが終了するまで待って，DABrokerへの接続を再実行してください。または，DABroker動作環境定義ファイルのDABMAXUSERSの値を大きくしてから，再実行してください。

KFDB009YM-E

DABrokerは既に起動しています。

DABroker is already running.

要因

DABrokerが既に起動されているマシン上で，DABrokerの起動要求※を受け付けました。

処理

処理を終了します。

対処

一つのマシン上では，複数のDABrokerは起動できません。

注※

Windows対応のDABrokerの場合は，［DABroker起動］アイコンをダブルクリック，又はサービスの開始を実行したときです。UNIX対応のDABrokerの場合は，dabstartコマンドを実行したときです。

KFDB010YM-E

DABrokerのロードモジュールに実行権限がありません。

ロードモジュール名：[XXXX]

The user does not have authority to execute the load module of DABroker. Name:[XXXX]

XXXX：エラーとなったロードモジュールのファイル名称

要因

DABrokerのロードモジュールに実行権限がないため，クライアントからの要求を処理できません。

処理

クライアントからの要求を受け付けません。

対処

DABrokerを組み込み直してください。UNIX対応DABrokerの場合は，その後dabsetupコマンドでDABrokerのセットアップを実行してください。

KFDB011YM-E

シンボリックリンクが多過ぎるため，DABrokerを実行できません。

ロードモジュール名：[XXXX]

DABroker cannot start because there are too many symbolic links. Name:[XXXX]

XXXX：エラーとなったロードモジュールのファイル名称

要因

DABroker組み込み先ディレクトリのシンボリックリンクが多過ぎるため，クライアントからの要求を処理できません。

処理

クライアントからの要求を受け付けません。

対処

データベース接続時に発生した場合は，DBMSライブラリの組み込み先ディレクトリのシンボリックリンクが多過ぎることが考えられます。DBMSライブラリの組み込み環境を確認してください。

それ以外の場合は，システム管理者に連絡し，シンボリックリンクの少ないディレクトリにDABrokerを組み込み直してもらってください。

KFDB012YM-E

DABrokerのロードモジュールがありません。

ロードモジュール名：[XXXX]

A load module of DABroker was not found. Name:[XXXX]

XXXX：エラーとなったロードモジュールのファイル名称

要因

DABrokerの動作環境が正しく設定されていないため，クライアントからの要求を処理できません。

処理

クライアントからの要求を受け付けません。

対処

DABrokerを組み込み直してください。

データベースのクライアント製品が正しくセットアップされているか確認してください。

UNIX対応のDABrokerの場合は，その後dabsetupコマンドでDABrokerのセットアップを実行してください。

HiRDBと接続する場合は，DABrokerとHiRDBの双方が64ビット版であること，又は双方が32ビット版であることを確認してください。

KFDB013YM-E

メモリ不足のため，DABrokerを実行できません。

ロードモジュール名：[XXXX]

DABroker cannot start because of insufficient memory. Name:[XXXX]

XXXX：エラーとなったロードモジュールのファイル名称

要因

DABrokerの動作に必要なメモリが不足しています。

処理

クライアントからの要求を受け付けません。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB014YM-E

DABrokerを起動する権限がありません。

The user does not have authority to execute DABroker.

要因

DABrokerを起動しようとしたユーザが，DABrokerの管理者ユーザ※ではないため，DABrokerを起動できません。

処理

処理を終了します。

対処

DABrokerの起動は，DABrokerの管理ユーザが入力してください。

注※

Windows対応のDABrokerの場合は，Administratorsグループに属しているユーザ

UNIX対応のDABrokerの場合は，DABrokerの管理ユーザ

KFDB015YM-E

TCP/IP通信処理プロセスが異常終了しました。要因：［XXXX］

The TCP/IP communication process terminated abnormally. Cause:[XXXX]

XXXX：終了要因（保守用情報）

要因

TCP/IP通信処理プロセスが異常終了しました。

処理

コネクションを解放します。以降のクライアントからの要求を受け付けません。

対処

killコマンドなどを入力していないか，又はシステムに負荷が掛かり過ぎていないか確認してください。エラーの原因が分からない場合は，システム管理者に連絡してください。

KFDB016YM-E

DABrokerが異常終了しました。要因：[XXXX]

DABroker terminated abnormally. Cause:[XXXX]

XXXX：終了要因（保守用情報）

要因

killコマンドを入力したか，又はシステムに負荷が掛かり過ぎて，DABrokerが異常終了しました。

処理

DABrokerを終了します。

対処

DABrokerを再起動する場合は，強制終了を実行後，再起動してください。

このエラーが繰り返し発生する場合は，システム管理者に連絡してください。UNIX対応のDABrokerの場合，保守員に連絡する場合は，次のファイルを退避しておいてください。

$DABROKER/spool以下のファイル（$DABROKER：DABroker運用ディレクトリ）

システムダンプ（(DABrokerを起動したカレントディレクトリ下のcoreファイル）

KFDB019YM-E

実行可能な最大ユーザ処理プロセス数を超えました。クライアントは接続できません。

[DABMAXPROCESS=XXXX]

The number of users exceeds the maximum that can be executed.

A client cannot be connected. [DABMAXPROCESS=XXXX]

XXXX：DABrokerが実行できる最大処理プロセス数

要因

DABroker動作環境定義ファイルでDABMAXPROCESSに設定した値を超えて，クライアントからの接続要求が発生しました。

処理

クライアントからの要求を受け付けません。

対処

他のクライアントが終了するまで待って，DABrokerへの接続を再実行してください。または，DABroker動作環境定義ファイルのDABMAXPROCESSの値を大きくしてから，再実行してください。

KFDB020YM-E

DABrokerを起動できません。

DABroker cannot start.

要因

DABrokerの起動に失敗しました。

処理

DABrokerを終了します。

対処

直前に出力されたメッセージの指示に従って対処してください。対処後，DABrokerを再起動してください。

KFDB021YM-E

同時実行可能な最大データベースアクセス数を超えました。データベースアクセスできません。

［DABDBANUMBER=XXX］

The number of database accesses exceeds the maximum that can be executed. Database access is not possible. [DABDBANUMBER=XXXX]

XXX：同時実行可能なデータベースアクセス数

要因

DABroker動作環境定義ファイルでDABDBANUMBERに設定した値を超えて，データベースアクセス要求を受け付けました。

処理

クライアントからの要求を受け付けません。

対処

他のデータベースアクセスが終了するまで待って，再実行してください。または，DABroker動作環境定義ファイルのDABDBANUMBERの値を大きくしてから，再実行してください。

KFDB022YM-I

DABrokerの終了処理が完了しました。

DABroker has terminated.

要因

DABrokerが終了しました。

KFDB023YM-E

TCP/IP通信処理プロセスを起動できません。

The TCP/IP communication process cannot start.

要因

TCP/IP通信処理プロセスの起動に失敗しました。

処理

DABroker初期化処理を続行します。

対処

DABrokerを終了させ，直前に出力されたメッセージに対する指示に従ってください。

KFDB100YM-E

システムコールでエラーが発生しました。［XXXX() errno=YYYY］

An error occurred in a system call. [XXXX() errno=YYYY]

XXXX：関数名称(保守用情報)

YYYY：エラー番号(保守用情報)

要因

OSのシステムコール関数，又はDABrokerの共通関数でエラーが発生しました。

処理

処理を終了します。

対処

操作を再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

KFDB301YM-I

Clean up. {xxx,yyy,zzz}, {sss}

要因

クライアントとの通信サーバデーモンのクリーンアップを実行しました。

処理

クライアントとの通信サーバデーモンのクリーンアップを実行した。

対処

なし

備考

xxx：クリーンアップ前のデーモンを数。

yyy：クリーンアップしたデーモンを数。

zzz：クリーンアップ実行後のデーモンを数。

sss：DABrokerの状態。

0：正常実行中。

1：正常終了中。

2：計画終了中。

3：強制終了中。

KFDB302YM-I

dabtcpdmn {xxx} start. [yyyy]

要因

クライアントとの通信サーバデーモンを起動しました。

処理

クライアントとの通信サーバデーモンを起動した。

対処

なし

備考

xxx：dabtcpdmnの引数。

yyyy：起動したプロセスID。

KFDB303YM-I

dabtcpdmn end. [xxxx]

要因

クライアントとの通信サーバデーモンを終了しました。

処理

クライアントとの通信サーバデーモンを終了した。

対処

なし

備考

yyyy：起動したしたプロセスID。

KFDB310YM-I

Thread stack size = xxxx（yyyy）

要因

スレッドのスタックサイズを設定した。

処理

スレッドのスタックサイズをxxxxバイトに設定した。

対処

なし

備考

xxx：スレッドのスタックサイズ。

yyyy：環境変数で指定されたスレッドのスタックサイズ。

DABPTHREAD_STACK_SIZE is undefined.：

環境変数DABPTHREAD_STACK_SIZEが定義されていない。

DABPTHREAD_STACK_SIZE=aaa：

aaa：環境変数

　　DABPTHREAD_STACK_SIZE

　　に指定されている値。

　　（最大55バイト）

KFDB0101YM-E

メモリを確保できません。

Required memory cannot be obtained.

要因

DABrokerの動作に必要なメモリが不足しています。

処理

DABrokerを終了します。

対処

しばらく時間を空けてから，再実行してください。なお，このエラーが繰り返し発生する場合は，システム管理者に連絡してください。

7.4　エラーコードとメッセージの対応

DABroker関連製品で開発するアプリケーションに，DABrokerのメッセージIDと対応するエラーコードを返す場合があります。アプリケーションに返すエラーコードとDABrokerのメッセージIDの対応を次に示します。メッセージの詳細は，「7.3　メッセージ一覧」を参照してください。

KFDBxxxyz-E → aabbxxx

aa

メッセージIDのyの桁を表7-2の変換表により変換したyの変換結果の値です。

bb

メッセージIDのzの桁を表7-2の変換表により変換したzの変換結果の値です。

xxx

メッセージIDのxxx

（例）

KFDB001DB-E → 402001

表7‒2　メッセージIDの変換表

メッセージIDのコード

yの変換結果

zの変換結果

A

1

01

B

2

02

C

3

03

D

4

04

E

5

05

F

6

06

G

7

07

H

8

08

I

9

09

J

10

10

K

11

11

L

12

12

M

13

13

N

14

14

O

15

15

P

16

16

Q

17

17

R

18

18

S

19

19

T

20

20

U

21

21

V

22

22

W

23

23

X

24

24

Y

25

25

Z

26

26

7.5　メッセージ中に出力されるコード

ここでは，メッセージ中に出力される詳細コードなどについて説明します。

7.5.1　DABroker詳細コード

DABrokerが出力するエラーメッセージの詳細コードを表7-3に示します

表7‒3　DABroker詳細コード

詳細コード

要因

対策

-12001

本タイミングではCANCEL要求は受け付けられません。

CANCEL要求が受け付けられるタイミングになってから，要求してください。CANCEL要求が受け付けられるのは，データベース接続完了から，データベース切り離し要求受け付けまでです。

-16002

本バージョン，又はDBMSでサポートされていない要求を受け付けました。

DABroker，又は接続先のDBMSを確認してください。

-16004

DABrokerが動作できる環境ではありません。

DABrokerをインストールした環境を見直して，エラー要因を取り除いてください。

その他負のコード

DABrokerシステムで異常が発生しました。

保守員に連絡してください。

その他正のコード

DABrokerでエラーが発生しました。

コードの詳細については，「7.4　エラーコードとメッセージの対応」を参照し，対策してください。

7.5.2　要求コード/応答コード

クライアントからの要求コードと応答コードを表7-4に示します。

表7‒4　要求コードと応答コード

要求コード/応答コード

種別

1001

コネクション解放

1002

データベース接続

1003

データベース切り離し

1004

Commit

1005

Rollback

1006

表一覧取得準備

1007

表一覧取得

1008

表一覧取得後処理

1009

列一覧取得準備

1010

列一覧取得

1011

列一覧取得後処理

1012

索引一覧取得準備

1013

索引一覧取得

1014

索引一覧取得後処理

1015

表権限一覧取得準備

1016

表権限一覧取得

1017

表権限一覧取得後処理

1018

列権限一覧取得準備

1019

列権限一覧取得

1020

列権限一覧取得後処理

1021

SQL実行準備

1022

SQL実行

1023

SQL実行結果取得

1024

SQL実行後処理

1035

SQL実行結果取得オプション

1036

BLOBファイル削除

1037

プライマリキー一覧取得準備

1038

プライマリキー一覧取得

1039

プライマリキー一覧取得後処理

1040

BLOB，CLOB，及びBFILE分割取得

1041

自動Commit設定

1042

自動Commit解除

1050

XAトランザクション制御

1501

ストアドプロシジャ一覧取得準備

1502

ストアドプロシジャ一覧取得

1503

ストアドプロシジャ一覧取得後処理

1504

ストアドプロシジャ列一覧取得準備

1505

ストアドプロシジャ列一覧取得

1506

ストアドプロシジャ列一覧取得後処理

1507

ストアドプロシジャパラメタ定義情報取得

1508

ストアドプロシジャ実行準備

1509

ストアドプロシジャ実行

1510

ストアドプロシジャ拡張実行

2001

正常応答

2002

異常応答

7.5.3　システムコールのエラー番号

代表的なシステムコールのエラー番号に対する原因と対策を表7-5に示します。表7-5にないエラーについては，使用しているOSのマニュアルを参照してください。

ここでは，主なシステムコールについてだけ記述しています。さらに，詳細に調べる場合は，メッセージで表示されたシステムコールのエラー番号の値に該当するニモニックを，使用しているOSのerrno定義ファイルで調べてください。そして，該当するニモニックのエラーが返った原因を，OSのマニュアルで特定してください。

表7‒5　システムコールのエラー番号に対する原因と対策

システムコール

errno

ニモニック

考えられる主な原因

対策

dlopen

2

ENOENT

DABrokerのライブラリ格納ディレクトリの設定が漏れているいる可能性があります。

DABrokerのライブラリ格納ディレクトリの設定を確認してください。

dup

23

ENFILE

オープンできるファイルの最大数に達しました。

不要なファイルをクローズしてください。

24

EMFILE

オープンできるファイルの最大数に達しました。

不要なファイルをクローズしてください。

fcntl

23

ENFILE

オープンできるファイルの最大数に達しました。

不要なファイルをクローズしてください。

24

EMFILE

オープンできるファイルの最大数に達しました。

不要なファイルをクローズしてください。

fork

11

EAGAIN

プロセスの数が多過ぎるか，一時的なメモリ不足が発生しています。

再度実行しても繰り返し発生する場合は，不要なプロセスを停止させてください。

12

ENOMEM

次のどちらかの要因が考えられます。

仮想メモリ不足のため，プロセスを新しく生成できません。

プロセスの数が多過ぎるか，又は一部のプロセスが大量のメモリを消費しています。

仮想メモリが足りない場合は，拡張してください。これらを拡張できない場合は，不要なプロセスを停止させてください。

一部のプロセスが大量のメモリを消費している場合は，該当するプロセスをいったん停止できないか検討してください。

malloc

12

ENOMEM

次のどちらかの要因が考えられます。

仮想メモリ不足のため，プロセスを新しく生成できません。

プロセスの数が多過ぎるか，又は一部のプロセスが大量のメモリを消費しています。

仮想メモリが足りない場合は，拡張してください。これらを拡張できない場合は，不要なプロセスを停止させてください。

一部のプロセスが大量のメモリを消費している場合は，該当するプロセスをいったん停止できないか検討してください。

mkdir

13

EACCESS

アクセス権限が不正です。

DABroker運用ディレクトリ下の，ディレクトリに対するアクセス権限が正しいか確認してください。

28

ENOSPC

ファイルシステムに十分な領域がありません。

ファイルシステム内の不要なファイルを削除してください。

open

2

ENOENT

ファイル，又はディレクトリが見付かりません。

環境変数が正しく設定されているかどうかを見直してください。

13

EACCES

ファイルに対するアクセス権がありません。

ファイルに対するアクセス権を確認してください。

17

EEXIST

作成しようとしたファイルは既に存在します。

ファイル名を変更して再度実行するか，既存のファイルが不要であれば，削除してから再度実行してください。

23

ENFILE

オープンできるファイルの最大数に達しました。

不要なファイルをクローズしてください。

24

EMFILE

オープンできるファイルの最大数に達しました。

不要なファイルをクローズしてください。

semget

28

ENOSPC

セマフォ識別子を生成しようとしたが，システムの上限値を超えました。

すべてのプログラムの所要量を見積り，設定値を変更した後に，マシンを再起動してください。

semop

22

EINVAL

DABroker稼働中に，DABrokerのインストールディレクトリ下の作業ファイルを削除した可能性があります。

DABrokerを強制終了してください。その後，DABrokerのサービスを再起動してください。

shl_load

8

ENOEXEC

DBMSの設定が誤っている可能性があります。

DBMSの設定を確認してください。

shmat

22

EINVAL

DABroker稼働中に，DABrokerのインストールディレクトリ下の作業ファイルを削除した可能性があります。または，DABrokerの起動が完了していない状態でコマンドを実行したことが考えられます。

DABrokerが起動完了していない場合は，DABrokerの起動が完了してからコマンドを実行してください。DABrokerが異常終了していなければ，強制終了してください。その後，DABrokerのサービスを再起動してください。

shmget

22

EINVAL

DABroker稼働中に，DABrokerのインストールディレクトリ下の作業ファイルを削除した可能性があります。

DABrokerを強制終了してください。その後，DABrokerのサービスを再起動してください。

28

ENOSPC

ディスクの容量が不足しています。

ディスクに，共用メモリサイズ以上の空き容量を確保してください。

write

5

EIO

入出力エラーが発生しました。

OSやハードウェアの情報に従って対策してください。

14

EFAULT

アクセスできない領域に書き込みしようとしました。書き込みしようとしたディスクが切り離された可能性があります。

保守員に連絡してください。

27

EFBIG

ファイルの大きさがシステムの制限値を超えました。

DABroker管理ユーザでのファイルサイズの制限値をDABrokerで使用するファイルより大きくするか，無制限に変更してください。または，使用するファイルサイズを小さくしてください。

28

ENOSPC

ファイルシステムに十分な領域がありません。

ファイルシステム内の不要なファイルを削除するか，領域に余裕のあるファイルシステムに移行してください。

chmod,

closecreat,

dup,

execv,

fork,

gethostbyaddr,

gethostbyname,

lseek,

lockf,

open,

read,

select,

semctl,

semget,

semop,

shmat,

shmctl,

shmdt,

shmget,

signal,

sigsetmask,

stat,

writeなど

22

EINVAL

メモリ不足が考えられます。

システムの仮想メモリの初期サイズと最大サイズを同じ値（固定値）にしてください。

7.5.4　ＸＡ要求時のエラー要因

ＸＡ要求時のエラー要因を表7-6に示します。

表7‒6　ＸＡ要求時のエラー要因

項番

設定値

要因

対処

1

LoadLibrary(pdtxa_switch_y) errno=XXXX

dlopen，LoadLibrary，又はshl_findsymでエラーが発生しました。

XXXX：dlopen，LoadLibrary，又はshl_findsymのエラー番号

使用するOSのマニュアルを参照し，エラー原因を取り除いてから，再実行してください。

2

GetProcAddress(pdtxa_switch_y) errno=XXXX

dlsym，又はGetProcAddressでエラーが発生しました。

XXXX：dlsym，又はGetProcAddressのエラー番号

使用するOSのマニュアルを参照し，エラー原因を取り除いてから，再実行してください。

3

XXXX rtncode=YYYY

XA関連要求でエラーが発生しました。

XXXX："xa_open"

　　　　"xa_close"

　　　　"xa_start"

　　　　"xa_end"

　　　　"xa_prepare"

　　　　"xa_commit"

　　　　"xa_rollback"

　　　　"xa_forget"

　　　　"xa_recover"

YYYY：リターン値

接続しているDBMSのマニュアルを参照し，エラー原因を取り除いてから，再実行してください。

4

LoadLibrary(xaosw) errno=XXXX

dlopen，LoadLibrary，又はshl_findsymでエラーが発生しました。

XXXX：dlopen，LoadLibrary，又はshl_findsymのエラー番号

使用するOSのマニュアルを参照し，エラー原因を取り除いてから，再実行してください。

5

GetProcAddress(xaosw) errno=XXXX

dlsym，又はGetProcAddressでエラーが発生しました。

XXXX：dlsym，又はGetProcAddressのエラー番号

使用するOSのマニュアルを参照し，エラー原因を取り除いてから，再実行してください。

付録

付録A　用語解説（共通）

（英字）

API（Application Programming Interface）

このマニュアルでは，DABroker関連製品で提供するインタフェースを指します。

BLOB

バイナリ長大オブジェクト(Binary Large Object)を指します。LOB(Large Object)データの一種で，画像，音声などのマルチメディアデータ，UDTなどの長大なバイナリデータの固まりです。このマニュアルでは，ORACLEのLONG系バイナリ型，ODBCの長大バイナリ型もBLOBと呼んでいます。

CORBA（Common Object Request Broker Architecture）

分散オブジェクト環境での，分散オブジェクト間の通信などを規定したインタフェースのことです。OMG（Object Management Group）によって提唱されたインタフェースです。CORBAには，主に次の機能があります。

ORB（Object Request Broker）機能

分散オブジェクト環境でのオブジェクトの管理，ネットワーク上のオブジェクトの相互作用（オブジェクト間の通信など）の管理をします。

IIOP（Internet Inter-ORB Protcol）

インターネット上での，分散オブジェクト環境の通信プロトコルです。

OTS（Object Transaction Service）機能

分散オブジェクト環境でのトランザクションを制御します。

Database Connection Server

メインフレーム系データベースにアクセスする場合に必要なプログラムです。Database Connection Serverを使うと，クライアントからサーバ上のDABrokerを介して，メインフレーム系データベース（VOS3 XDM/RD，VOS3 XDM/SD，VOSK SQL/K，VOS1 PDMII E2，VOSK スプールファイル）にアクセスできます。

DBMS（Data Base Management System）

データベースを管理するソフトウェアです。このマニュアルでは，HiRDB，ORACLE，SQL Anywhere，SQL Server，又はメインフレーム系データベース（VOS3 XDM/RD，VOS1 RDB1 E2，VOSK SQL/K，VOS3 XDM/SD，VOS1 PDMII E2，VOSK スプールファイル，VOS1 RDB1 E2）を指します。

DBPARTNER/Client

パーソナルコンピュータに組み込んで使用し，ワークステーションに組み込んだDABrokerとともにクライアント/サーバシステムを構成するプログラムです。データベースのデータの抽出，更新，及びデータベースへの表定義を行うGUIプログラムです。

DBPARTNER/Web

インターネット又はイントラネット上でDABrokerを介してデータベースにアクセスするために必要なプログラムです。

DBPARTNER Mobile

モバイル環境下でDABrokerを介してデータベースにアクセスするために必要なプログラムです。このマニュアルでは，DBPARTNER Mobile-Client，及びDBPARTNER Mobile-Serverを総称してDBPARTNER Mobileと呼びます。

DTPモデル（Distributed Transaction Processing）

オープンシステムの標準化を目的とした団体であるX/Openが規定する，分散処理システムモデルのことです。DTPモデルは，トランザクション処理を管理，実行するトランザクションマネジャ（TM：Transaction Manager），各種資源を管理するリソースマネジャ（RM：Resource Manager），及び業務処理をするUAP（AP：Application Program）から構成されます。

HITSENSER5 for Cosmicube

Cosmicubeで構築した多次元データベースのデータを検索し，分析ができるMOLAPツールです。

HITSENSER5 for RDB

リレーショナルデータベースで構築したデータベースのデータを検索し，分析ができるROLAPツールです。

HITSENSER5 Professional

HITSENSER5動作環境などを管理するシステム管理者が使います。「マネージャ」と「アナライザ」の二つが含まれています。「マネージャ」は，HITSENSER5の動作環境の設定，ユーザ管理，分析情報ファイルの管理などをするためのツールです。「アナライザ」は，データベースから表やグラフを作成して，分析作業をするためのツールです。

HITSENSER5 Standard

HITSENSER5を使って多次元分析をする分析者，及び分析者が登録した分析状態を参照するユーザが使います。「アナライザ」だけが含まれています。「アナライザ」は，データベースから表やグラフを作成して，分析作業をするためのツールです。

IPアドレス

データを転送する経路を確立するためのアドレスです。

JDBCインタフェース

Javaの標準的なデータベースアクセスインタフェースのことです。

JDBCドライバ

DABroker for Javaで提供するクラスライブラリです。JDBCインタフェースに従って開発したプログラムからの要求をDABrokerに転送します。常に，JDBCインタフェースで開発したプログラムと同一マシンに組み込んで使用します。

ODBC

Open DataBase Connectivityの略で，米国Microsoft Corp.が提唱するデータベースアクセス機構です。ODBCが規定するAPIを使ったアプリケーションからは，OS，DBMS，ネットワークなどの違いを意識せずにデータベースにアクセスできます。アクセスする相手のDBMSも，ODBCドライバと呼ばれるソフトウェアドライバに対応している必要があります。

OTS

CORBA上のオブジェクトに対して，トランザクション処理をするサービスです。

TCP/IP（Transmission Control Protocol/Internet Protocol）

米国国防省（DOD）のネットワーク（ARPANET）用に開発された通信プロトコル（ネットワーク上で通信を行う場合の規約）です。クライアントとのデータ交換は，TCP/IPのライブラリを用いて行われます。

TPBroker

CORBAインタフェースに対応し，分散オブジェクト環境でのオブジェクトの管理，オブジェクト間の通信の管理（ORB機能），及びトランザクションの制御（OTS機能）をするためのプログラムです。DABrokerでは，DABroker for ORBで提供するオブジェクトを呼び出すためにTPBrokerを利用します。

Web Page Generator

CORBAインタフェースを含むHTMLファイルを動的に生成するプログラムです。CORBAインタフェースを記述できるため，分散オブジェクトに対応します。

X/Open DTPモデルXAインタフェース

X/Open XAインタフェースは，分散トランザクション処理（DTP：Distributed Transaction Processing）システムでのトランザクションマネジャ（TM：Transaction Manager）とリソースマネジャ（RM：Resource Manager）の接続インタフェースを規定したX/Openの標準仕様です。XAインタフェースを使用すると，リソースマネジャのトランザクション処理をトランザクションマネジャで制御できます。

（ア行）

アクセストレース

DABrokerからデータベースにアクセスした内容についての情報です。Windowsの場合は[DABrokerトレース出力]ユティリティを，UNIXの場合はdabdbtrcコマンドを使用して取得できます。アクセストレースの種類は任意に選択できます。

アプリケーション

このマニュアルでは，DABroker関連製品で提供するインタフェースを使用して開発するユーザアプリケーションプログラム（UAP）のことです。

（カ行）

コネクションの解放

コネクションの解放では，TCP/IP通信メインプロセス又はスレッドを終了し，クライアントとの通信路を解放します。コネクションが解放されるのは，次のような場合です。

クライアントからのコネクション解放要求時

サーバの強制終了時

サーバの異常終了時

通信エラー発生時

タイムアウト発生時

DBMSの異常終了時

コネクションの確立

コネクションの確立では，クライアントとの通信路を確立し，TCP/IP通信メインプロセス又はスレッドを生成，起動します。コネクションが確立されるのは，クライアントからデータベースの最初のアクセスが発生した時です。

コミット

トランザクションによって発生した更新をデータベースに反映することです。

（サ行）

サーバ

使用するDBMS及びDABrokerを組み込んだマシンを指します。ネットワーク上では，データベースにアクセスし，クライアントから要求された処理を実行する側です。

（ナ行）

ネイティブライブラリ

DABrokerが提供するライブラリです。サーバで動作するJava ApplicationからDABrokerに接続するときに使用します。ネイティブライブラリは，Javaの標準インタフェースであるJNI（Java Native Interface）を使用し，JNIの引数にプロトコルデータを渡して，Java ApplicationとDABrokerを接続します。

（ハ行）

分散オブジェクト技術

複数の分散オブジェクトを組み合わせてシステムを構築する技術のことです。

この技術を利用すると，既存システムに付加価値サービスを追加した新規システムを，既存システムを変更することなく構築できます。分散オブジェクト間のインタフェースには，CORBAインタフェースを使用します。

分散オブジェクト

分散オブジェクトとは，ネットワーク上に分散していて，ネットワーク上のどこからでも利用できるオブジェクトのことです。なお，オブジェクトとは，データ，アプリケーション，プロセスなどを部品化したものです。

分散オブジェクト環境

分散オブジェクト環境は，複数のオブジェクト（分散オブジェクト）を組み合わせて構築する環境のことです。

（ラ行）

ロールバック

トランザクションによって発生したデータベースの更新を無効にすることです。

索引

記号

［DABroker動作環境設定］ダイアログボックス[1]

［アクセストレース設定］ダイアログボックス[1]

数字

1プロセスあたりの実行ユーザ数[1]、[2]

A

API[1]

Applet[1]

ASPファイル[1]

ATTACH[1]

ATTACH情報出力要求[1]

ATTRGET[1]

ATTRGET情報出力要求[1]

ATTRSET[1]

ATTRSET情報出力要求[1]

AUTO COMMIT OFF[1]

AUTO COMMIT ON[1]

AUTO COMMIT ON出力要求[1]

B

BIND[1]

BIND情報出力要求[1]

BLOB[1]

C

CANCEL[1]

CANCEL情報出力要求[1]

CHARFORM[1]

CHARFORM情報出力要求[1]

CHARID[1]

CHARID情報出力要求[1]

CLOSE[1]

CLOSE情報出力要求[1]

COMMIT[1]

COMMIT情報出力要求[1]

CONNECT[1]

CONNECT情報出力要求[1]

CORBA[1]

D

DAB_DBS_HOST[1]

DAB_DBS_PORT[1]

DAB_DBS_RECEIVE_BUFFER_SIZE[1]

DAB_DBS_SEND_BUFFER_SIZE[1]

DAB_HIRDB_DBINF_ESC[1]

DAB_LANG[1]

DABCLIENT_TIMEOUT[1]

dabcltrc[1]

dabcmstart[1]

dabcmstat[1]

dabcmstop[1]

DABDBA_TIMEOUT[1]

DABDBANUMBER[1]

DABDBSDBA_BLOBBUFSIZE[1]

dabdbtrc[1]

DABEXSQL_TRC_LINE[1]、[2]

DABHIRDBA_BLOBBUFSIZE[1]

DABIPCONVERT[1]

DABKEEPALIVE[1]

DABMAXBLOCKUSERS[1]

DABMAXPROCESS[1]

DABMAXUSERS[1]

DABORACLE_TYPE[1]

DABORADBA_LONGBUFSIZE[1]

DABroker[1]

DABroker for Javaで開発するアプリケーション[1]

DABroker for ODBCで開発するアプリケーション[1]

DABroker運用ディレクトリ[1]

DABroker環境設定[1]

DABroker管理ユティリティの実行[1]

DABroker関連製品を使用する場合の環境設定[1]、[2]

DABrokerコネクションマルチ定義[1]、[2]

DABroker作業ディレクトリ[1]

DABroker接続先データベース定義[1]

DABroker接続先データベースの定義[1]

DABrokerセットアップコマンド[1]

DABroker動作環境定義ファイル[1]

DABroker動作環境定義ファイルの作成[1]

DABrokerとの接続[1]

DABrokerトレース出力ユティリティの実行[1]

DABrokerのインストール[1]、[2]

DABrokerのインストールとセットアップ[1]

DABrokerの管理ユーザ[1]

DABrokerの起動と終了[1]、[2]

DABrokerの終了[1]

DABrokerの処理内容の表示[1]

DABrokerのセットアップ[1]

DABrokerの動作環境の設定[1]

DABrokerの動作環境の設定項目[1]

DABrokerのログ取得ファイルサイズ[1]

DABrokerをインストールするマシン[1]、[2]

DABrokerを運用する前に[1]

DABSELECTCOLCNT[1]

DABSELECTINFCNT[1]

dabsetup[1]

DABSQL_HiRDB_DICTIONARY_DATATYPE[1]

DABSQL_TRC_ATTACH[1]

DABSQL_TRC_ATTRGET[1]

DABSQL_TRC_ATTRSET[1]

DABSQL_TRC_AUTO_COMMIT_OFF[1]

DABSQL_TRC_AUTO_COMMIT_ON[1]

DABSQL_TRC_BIND[1]

DABSQL_TRC_CANCEL[1]

DABSQL_TRC_CHARFORM[1]

DABSQL_TRC_CHARID[1]

DABSQL_TRC_CLOSE[1]

DABSQL_TRC_COMMIT[1]

DABSQL_TRC_CONNECT[1]

DABSQL_TRC_DECLARE[1]

DABSQL_TRC_DEFINE[1]

DABSQL_TRC_DESALLOC[1]

DABSQL_TRC_DESCANY[1]

DABSQL_TRC_DESCRIBE[1]

DABSQL_TRC_DESFREE[1]

DABSQL_TRC_DETACH[1]

DABSQL_TRC_DISCONNECT[1]

DABSQL_TRC_ENVCREATE[1]

DABSQL_TRC_ERRGET[1]

DABSQL_TRC_EXECUTE[1]

DABSQL_TRC_EXECUTE_DIRECT[1]

DABSQL_TRC_FETCH[1]

DABSQL_TRC_GET_INFO[1]

DABSQL_TRC_GETDIAG[1]

DABSQL_TRC_GETPIECE[1]

DABSQL_TRC_HDLALLOC[1]

DABSQL_TRC_HDLFREE[1]

DABSQL_TRC_LOBCLOSE[1]

DABSQL_TRC_LOBLEN[1]

DABSQL_TRC_LOBOPEN[1]

DABSQL_TRC_LOBREAD[1]

DABSQL_TRC_LOBWRITE[1]

DABSQL_TRC_LOGGING[1]

DABSQL_TRC_LOGLESS[1]

DABSQL_TRC_OPEN[1]

DABSQL_TRC_PARAMGET[1]

DABSQL_TRC_PREPARE[1]

DABSQL_TRC_ROLLBACK[1]

DABSQL_TRC_SESBEGIN[1]

DABSQL_TRC_SESEND[1]

DABSQL_TRC_SET_INFO[1]

DABSQL_TRC_SETPIECE[1]

DABSQL_TRCSIZE[1]

dabstart[1]

dabstat[1]

dabstop[1]

DABSVLOGSIZE[1]

DABTCP_TRCSIZE[1]

DABTMP[1]

DABXA_LOG_ERROR[1]

dasysconf[1]

Database Connection Server[1]

Database Connection Serverからの応答監視時間[1]

Database Connection Server接続時のタイマー監視[1]

Database Connection Server接続設定[1]

Database Connection Server接続設定項目[1]

Database Connection Serverに受信するときの最大バッファサイズ[1]

Database Connection Serverに送信するときの最大バッファサイズ[1]

Database Connection ServerのBLOB型データ受取バッファサイズ[1]

Database Connection ServerのBLOB型データ受取バッファサイズ[1]

Database Connection Serverのデータベース識別子[1]

Database Connection Serverのポート番号又はサービス名[1]

Database Connection Serverのホスト名又はIPアドレス[1]

DBHOST[1]

DBMS[1]

DBNAME[1]、[2]、[3]

DBPARTNER[1]、[2]、[3]

DBPARTNER〔環境設定〕[1]、[2]

DBPARTNER/Client[1]、[2]

DBPARTNER/Web[1]、[2]

DBPARTNER Library[1]、[2]、[3]

DBPARTNER Library〔環境設定〕[1]、[2]

DBPARTNER Mobile[1]

DBPARTNERから実行するマルチスレッド[1]

DBPARTNERとDABrokerの接続時のタイマー監視[1]

DBSHOST[1]

DBSPORT[1]

DBSTIMER[1]

DECLARE[1]

DECLARE情報出力要求[1]

DEFINE[1]

DEFINE情報出力要求[1]

DESALLOC[1]

DESALLOC情報出力要求[1]

DESCANY[1]

DESCANY情報出力要求[1]

DESCRIBE[1]

DESCRIBE情報出力要求[1]

DESFREE[1]

DESFREE情報出力要求[1]

DETACH[1]

DETACH情報出力要求[1]

DISCONNECT[1]

DISCONNECT情報出力要求[1]

DTPモデル[1]

E

ENVCREATE[1]

ENVCREATE情報出力要求[1]

ERRGET[1]

ERRGET情報出力要求[1]

EXECUTE[1]

EXECUTE DIRECT[1]

EXECUTE DIRECT出力要求[1]

EXECUTE情報出力要求[1]

F

FETCH[1]

FETCH情報出力要求[1]

G

GETDIAG[1]

GETDIAG情報出力要求[1]

GET INFO[1]

GET INFO出力要求[1]

GETPIECE[1]

GETPIECE情報出力要求[1]

H

HDLALLOC[1]

HDLALLOC情報出力要求[1]

HDLFREE[1]

HDLFREE情報出力要求[1]

HiRDB環境変数区切り文字[1]

HiRDB環境変数区切り文字〔UNIX〕[1]

HiRDBでのディクショナリ表のデータ属性[1]

HiRDBのBLOB型データ受取バッファサイズ[1]

HiRDBのBLOB型データ受取バッファサイズ[1]

HiRDBの設定[1]

HiRDBのディクショナリ表のデータ属性[1]

HITSENSER5[1]、[2]、[3]、[4]

HITSENSER5〔環境設定〕[1]、[2]

HITSENSER5 for Cosmicube[1]

HITSENSER5 for RDB[1]

HITSENSER5 Professional[1]

HITSENSER5 Standard[1]

HITSENSER5 Web[1]

I

IPアドレス[1]、[2]

IPアドレスからホスト名への変換オプション[1]、[2]

J

Java JTSを使った分散トランザクション処理[1]

Java JTSを利用するまでの手順[1]

Java TM[1]、[2]

JDBCインタフェース[1]

JDBCドライバ[1]

L

LANG環境変数[1]

LOBCLOSE[1]

LOBCLOSE情報出力要求[1]

LOBLEN[1]

LOBLEN情報出力要求[1]

LOBOPEN[1]

LOBOPEN情報出力要求[1]

LOBREAD[1]

LOBREAD情報出力要求[1]

LOBWRIT[1]

LOBWRITE情報出力要求[1]

LOGGING[1]

LOGGING情報出力要求[1]

LOGLESS[1]

LOGLESS情報出力要求[1]

M

MCONMAX[1]

MCONPOOL[1]

MCONPROC[1]

MRSVPOOL[1]

N

NLS_LANG[1]

O

ODBC[1]

ODBC3.0のLONG型データ受取バッファサイズ[1]

OPEN[1]

OPEN情報出力要求[1]

ORACLE_HOME[1]

ORACLE_SID[1]

ORACLEアクセスライブラリ再作成方法[1]

ORACLEのLONG型及びLONGRAW型のデータの受け取りバッファサイズ[1]

ORACLEのLONG型データ受取バッファサイズ[1]

ORACLEの設定[1]

ORACLEのリスナー名[1]

OTS[1]、[2]

P

PARAMGET[1]

PARAMGET情報出力要求[1]

PDCLTPATH[1]

PDHOST[1]

PDNAMEPORT[1]

PDSQLTRACE[1]

PDSWAITTIME[1]

PDUAPERLOG[1]

PREPARE[1]

PREPARE情報出力要求[1]

R

ROLLBACK[1]

ROLLBACK情報出力要求[1]

S

services[1]

SESBEGIN[1]

SESBEGIN情報出力要求[1]

SESEND[1]

SESEND情報出力要求[1]

SET INFO[1]

SET INFO出力要求[1]

SETPIECE[1]

SETPIECE情報出力要求[1]

T

TCP/IP[1]

TCP/IP通信時キープアライブ[1]、[2]

TPBroker[1]

W

Web Page Generator[1]

WWW環境[1]

X

X/Open DTPモデルXAインタフェース[1]

XAトレースの取得形式[1]

XAトレースを取得する[1]

XAトレースを取得する〔UNIX〕[1]

XDM/RD E2の外部表[1]

XDM/RD外部表[1]、[2]

XDM/RD外部表〔環境設定〕[1]、[2]

あ

アクセストレース[1]

アクセストレース設定[1]

アプリケーション[1]

アプリケーション開発用インタフェース[1]、[2]

アプリケーションから実行するマルチスレッド[1]

アプリケーションとDABrokerとの接続[1]

い

インストール[1]

え

エラーコードとメッセージの対応[1]

エラー時にDABrokerが実行する処理[1]

エラートレース機能[1]

か

拡張データベースアクセストレース機能[1]、[2]

拡張データベースアクセストレースを取得する〔UNIX〕[1]

拡張データベースアクセストレースを取得する〔Windows〕[1]

仮想コネクション[1]

環境設定の手順[1]、[2]

環境設定方法[1]

環境設定ユティリティ[1]

漢字コードセット[1]

き

起動[1]

強制終了[1]、[2]、[3]

共通項目[1]

共通設定〔Windows〕[1]

く

クライアント／サーバ環境[1]

クライアントアプリケーション[1]

クライアントからの要求待ちタイムアウト[1]、[2]

クライアントとの通信トレースの表示[1]

け

計画終了[1]、[2]、[3]

こ

更新・検索項目数[1]、[2]

コネクションの解放[1]

コネクションの確立[1]

コネクションマルチ[1]

コネクションマルチ運用ユティリティ[1]

コネクションマルチ機能起動コマンド[1]

コネクションマルチ機能終了コマンド[1]

コネクションマルチ機能の使用[1]、[2]

コネクションマルチ定義ファイル[1]

コネクションマルチ定義ファイルの作成[1]

コネクションマルチ定義ユティリティ[1]

コネクションマルチ名[1]、[2]、[3]

コミット[1]

さ

サーバ[1]

サーバアプリケーション[1]

サービス名[1]

最大仮想コネクション数[1]、[2]、[3]

最大仮想コネクション数と通信処理プロセス数の決定[1]、[2]

最大処理プロセス数[1]、[2]

最大接続ユーザ数[1]、[2]

作業ディレクトリ名[1]

し

システムリソース消費量の比較[1]

自動起動[1]

終了[1]、[2]

受信バッファサイズ[1]

障害情報の取得[1]

障害対策[1]

使用するORACLEのバージョン[1]、[2]

処理時間の比較[1]

シングルコネクション[1]

シングルスレッド[1]

す

ステータス表示コマンド[1]

スレッドの生成例[1]

スレッドのチューニング[1]

せ

正常終了[1]

接続先サービス名[1]

接続先データベース定義ファイル[1]

接続先データベース定義ファイルの作成[1]

接続先データベース定義ファイルの作成例[1]

接続先データベース定義ユティリティ[1]

接続先の指定[1]

接続先ホスト名[1]

接続するDatabase Connection Serverのサービス名，又はポート番号[1]

接続するDatabase Connection Serverのホスト名，又はIPアドレス[1]

セットアップコマンドの実行手順[1]

そ

送信バッファサイズ[1]

その他の設定[1]、[2]

た

タイマー監視[1]

つ

通常の終了[1]、[2]

通信処理プロセス数[1]、[2]、[3]

通信トレース[1]

通信トレースの取得[1]、[2]

て

データベースアクセス[1]

データベースアクセス処理終了待ちタイムアウト[1]

データベースアクセストレース[1]

データベースアクセストレース（UNIX）[1]

データベースアクセストレース（Windows）[1]

データベースアクセストレース選択オプション[1]

データベースアクセストレースの取得[1]、[2]

データベースアクセストレースの表示[1]

データベースアクセストレースのファイル容量の目安[1]

データベースからの実行終了待ちタイムアウト[1]

データベース種別定義ブロック[1]

データベース種別名[1]

データベースの種類[1]

データベースのポート番号[1]

データベースのホスト名[1]

データベース名[1]

データベース名定義ブロック[1]

デーモンの生成・消滅・クリーンアップ実行結果ログ（共通）[1]

と

同期アクセス処理[1]

動作状態の表示[1]

同時実行可能なデータベースアクセス数[1]、[2]

トラブルシュート情報[1]、[2]、[3]

トレースの取得形式[1]

トレースファイルサイズ[1]

ね

ネイティブライブラリ[1]

ネイティブライブラリ（libdaJavaC.sl）[1]

ネットワーク環境の設定[1]、[2]

ひ

非同期アクセス処理[1]

表検索カラム数[1]、[2]

ふ

ファイルの運用方法〔データベースアクセストレース〕[1]

プールコネクション数[1]、[2]、[3]

複数DBMSでの共通インタフェース[1]

分散オブジェクト技術[1]

分散トランザクション処理[1]、[2]

ほ

ポート番号[1]、[2]

ま

マルチスレッド[1]、[2]

マルチスレッドの実行[1]

め

メインフレーム系データベース[1]

メッセージ[1]

メッセージ一覧[1]

メッセージ中に出力されるコード[1]

メッセージの形式[1]

メッセージの出力先[1]

も

モバイル環境[1]

ゆ

ユーザIDの設定[1]

よ

予約プールコネクション数[1]、[2]、[3]

り

リモートアクセス[1]

リモートアクセス設定〔Windows〕[1]

リモートアクセス設定項目[1]

ろ

ローカルアクセス[1]

ロールバック[1]

ログファイルサイズ[1]