HiRDB Dataextractorをインストールする前に，次に示す作業が必要になります。

• 稼働環境の確認
• ユーザ権限の確認

(a)　稼働環境の確認

次に示す内容を確認してください。

• HiRDB Dataextractorをインストールするマシンのディスクの空き容量が十分にあることを確認してください。
• HiRDB Dataextractorが動作するのに必要な製品がインストールされていることを確認してください。HiRDB Dataextractorが動作するのに必要な製品については，「2.1　ソフトウェア構成」を参照してください。

(b)　ユーザ権限の確認

インストールを実行する利用者がスーパユーザであることを確認してください。

HiRDB Dataextractorをインストールするホストを，次の表に示します。

表2-2　HiRDB Dataextractorをインストールするホスト

注※1

OSIプロトコルの場合には，インストールするホストとXDM/XT間とは，OSIプロトコルで接続されている必要があります。

注※2

データの転送先のサーバのあるホストとXDM/XT間とは，OSIプロトコルで接続されている必要があります。システムマネジャのあるホストとXDM/XT間のOSIプロトコルでの接続は任意です。

注※3

データをフロントエンドサーバに転送する場合は，フロントエンドサーバのどれかのあるホスト（データを転送するホスト）になります。

RDエリア単位の格納の場合で，バックエンドサーバにデータを直接転送するときは，転送先のバックエンドサーバのあるホストになります。

「2.1　ソフトウェア構成」を参照して，HiRDB Dataextractorを使うために必要な製品をインストールしてください。HiRDB Dataextractorのインストールは，日立PPインストーラで行います。

HiRDBとHiRDB Dataextractorのどちらを先にインストールしてもかまいませんが，HiRDB Dataextractorの環境変数を設定するときは，同じサーバマシンにHiRDBがインストールされていることが前提です。

HiRDB Dataextractorのアンインストールは，日立PPインストーラで実施してください。

HiRDB Dataextractorが作成するディレクトリおよびファイルを，次の表に示します。

HiRDB Dataextractorが作成するディレクトリおよびファイルは，インストールしたホストに作成されます。なお，インストールするホストにHiRDB Dataextractorが作成するファイルと同一のファイルがある場合は，リネームなどでそのファイルを退避させてください。

表2-3　HiRDB Dataextractorが作成するディレクトリおよびファイル

（凡例）

○：作成します。

−：作成しません。

△：出力ファイルを作成しないで反映する場合に，一時的に作成されます。処理終了後に削除されます。

□：xtrepコマンドで−oオプションを指定している場合は，処理終了後も削除されません。−oオプションを指定していない場合は，処理終了後に削除されます。ただし，反映処理でエラーとなった場合は，削除されません。

TCP：TCP/IPプロトコル使用時に作成します。

OSI ：OSIプロトコル使用時に作成します。

抽出：抽出側

反映：反映側

作成：ファイル作成側

注※1

/opt/HIRDBXT/spool/下には，HiRDB Dataextractorが稼働中に動的に作成するファイルがあります。/opt/HIRDBXT/spool/は削除しないでください。

また，/opt/HIRDBXT/spool/下のファイルは，HiRDB Dataextractorの稼働中には参照および削除しないでください。これらのファイルは，HiRDB Dataextractorの停止中に，定期的に削除してください。

注※2

このファイルは，パラメタ解析中にエラーが発生した場合には作成されません。この場合には，エラーメッセージは標準出力にだけ出力されます。xtrepコマンドの−eオプションでファイル名を指定して，任意のファイルに出力できます。−eオプションの指定を省略した場合は，HiRDB Dataextractorが一意になるようにファイル名を設定します。

環境変数XTTEMPNAMの指定によって，日時またはtempnam関数を使用した名称が設定できます。

注※3

ファイル名は，HiRDB Dataextractorが一意になるように設定します。

環境変数XTTEMPNAMの指定によって，日時またはtempnam関数を使用した名称が設定できます。

注※4

xtrepコマンドで−oオプションまたは−Oオプションを指定している場合に作成されます。

注※5

抽出したデータにLOBデータがある場合に作成されます。xtrepコマンドで−oオプションを指定している場合は，処理終了後も削除されません。−oオプションを指定していない場合は，処理終了後に削除されます。

注※6

/opt/HIRDBXT/dumpの下のファイルは，HiRDB Dataextractorの停止中に，定期的に削除してください。

環境変数XTTRCDIRで，ディレクトリ名を指定できます。

HiRDB Dataextractorが作成する次のファイルの，ファイル名の決定方法について説明します。

• 出力ファイル
• LOB入力ファイル格納用ディレクトリ
• LOB入力ファイル

(a)　出力ファイル

出力ファイルの名称は，次の指定によって決定します。

• xtrepコマンドの−oオプションまたは−Oオプションの指定
• 環境変数XTTMPDIRの指定
• 環境変数XTTEMPNAMの指定

また，xtrepコマンドの−oオプションまたは−Oオプションの指定，環境変数XTFILESIZEの指定によって，複数のファイルに分割して出力できます。

出力ファイルの名称を，次の表に示します。

なお，出力ファイルのファイルモードは環境変数XTFPERMITで指定できます。

表2-4　出力ファイルの名称

（凡例）

〜：適用OSによって異なります。

• HP-UX，Solaris，Linux，およびAIXの場合：/opt/HIRDBXT
• Windowsの場合：インストールディレクトリ

○：指定あり

×：指定なし

―：該当しない

指定値：−oまたは−Oオプションで指定された名称

$XTTMPDIR：環境変数XTTMPDIRでの指定値を示します。

注※1

環境変数XTSQL=0または省略時：抽出表名

環境変数XTSQL=1：xtof-プロセスID

注※2

環境変数XTTEMPNAMに0が指定されている場合は，「-年.月.日-時.分.秒」の部分はtempnam関数で作成された値になります。

出力ファイルの作成例1

ファイルだけを作成する場合で，出力ファイルを一意の名称で作成します。

指定値なしで−oオプションを指定することによって，HiRDB Dataextractorが一意な名称を決定します。ファイルの作成先は，環境変数XTTMPDIRで指定したディレクトリ下になります。

環境変数

　
XTFILESIZE：なし
XTTMPDIR：/tmp
　

xtrepコマンド

　
xtrep -R -o TBL_NAME
　

ファイル名

　
/tmp/TBL_NAME-99.06.11-10.00.00
　

出力ファイルの作成例2

HiRDBの表に反映する場合で，同じパーティションにファイルを分割して作成します。

環境変数XTFILESIZEを指定してファイルを分割します。環境変数XTTMPDIRを指定していないため，ファイルの作成先は〜/spool下になります。

環境変数

　
XTFILESIZE：100000
XTTMPDIR：なし
　

xtrepコマンド

　
xtrep -o TBL_NAME
　

ファイル名

　
〜/spool/TBL_NAME-99.06.11-10.00.00-1
〜/spool/TBL_NAME-99.06.11-10.00.00-2
                  ：
                  ：
〜/spool/TBL_NAME-99.06.11-10.00.00-n

100,000バイト単位でファイル分割しますが，ファイル間でレコードまたがりはしないため，ファイルの最大長は次のようになります。

 
ファイルの最大長＝↓100000/L↓×L
　
　L：レコード長
　

出力ファイルの作成例3

ファイルだけを作成する場合で，別のパーティションにDAT形式のファイルを分割して作成します。

−oオプションで複数のパーティションを指定することによって，別のパーティションにファイルを作成します。環境変数XTFILESIZEを指定していないため，パーティションの空き容量をすべて使用して空きがなくなった時点で，別のパーティションにファイルを作成します。

HP-UXの場合

・環境変数

　
XTFILESIZE：なし
XTTMPDIR：/
　

・xtrepコマンド

　
xtrep -R dat -o HD000/, HD001/ TBL_NAME
　

・ファイル名

　
/HD000/TBL_NAME-99.06.11-10.00.00
/HD001/TBL_NAME-99.06.11-10.00.00
　

/HD000がいっぱいになったら，/HD001に作成します。

　

Windowsの場合

・環境変数

　
XTFILESIZE：なし
XTTMPDIR：\
　

・xtrepコマンド

　
xtrep -R dat -o C:\DATA\,D:\DATA\ TBL_NAME
　

・ファイル名

　
C:\DATA\TBL_NAME-99.06.11-10.00.00
D:\DATA\TBL_NAME-99.06.11-10.00.00

　

C:\DATAがいっぱいになったら，D:\DATAに作成します。

(b)　LOB入力ファイル格納用ディレクトリ

抽出したデータ中にBLOB列があった場合，HiRDB DataextractorはLOBデータ単位にLOB入力ファイルを作成します。このLOB入力ファイルを格納するディレクトリがLOB入力ファイル格納用ディレクトリです。

LOB入力ファイル格納用ディレクトリの名称は，次の指定によって決定します。

• xtrepコマンドの−bオプションの指定
• 環境変数XTTMPDIRの指定
• 環境変数XTTEMPNAMの指定

LOB入力ファイル格納用ディレクトリの名称を，次の表に示します。

なお，環境変数XTLOBKINDの指定によって，LOB入力ファイルを作成しないで，BLOB列のデータをBLOB列以外のデータと同一の出力ファイルに格納することもできます。また，環境変数XTDPERMITの指定によって，LOB入力ファイル格納用ディレクトリに対して，ファイルモードが指定できます。

表2-5　LOB入力ファイル格納用ディレクトリの名称

（凡例）

〜：適用OSによって異なります。

• HP-UX，Solaris，Linux，およびAIXの場合：/opt/HIRDBXT
• Windowsの場合：インストールディレクトリ

○：指定あり

×：指定なし

$XTTMPDIR：環境変数XTTMPDIRでの指定値を示します。

注※

環境変数XTTEMPNAMに0が指定されている場合は，「-年.月.日-時.分.秒-プロセスID」の部分はtempnam関数で作成された値になります。

(c)　LOB入力ファイル

HiRDB Dataextractorは，LOB入力ファイル格納用ディレクトリ下に，LOBデータ単位に一意の名称のLOB入力ファイルを作成します。

LOB入力ファイルの名称設定方法を次に示します。

 
ｘｔｌｂｆ−データ件数通番−ＢＬＯＢ列通番
 

（凡例）

データ件数通番 ：1からの連番（1〜2³²）

BLOB列通番：1からの連番（１〜2³²）

なお，LOB入力ファイルのファイルモードは環境変数XTFPERMITで指定できます。