データベース抽出・反映サービス機能　HiRDB Dataextractor Version 10

解説・手引・操作書

3020-6-575

前書き

対象製品

●適用OS：HP-UX 11i V3(IPF)

P-1J62-4JA1 HiRDB Dataextractor Version 10 10-00

●適用OS：AIX V7.1，AIX V7.2

P-1M62-4JA1 HiRDB Dataextractor Version 10 10-00

●適用OS：Red Hat Enterprise Linux 6 (64-bit x86_64)，Red Hat Enterprise Linux 7 (64-bit x86_64)

P-8462-2JA1 HiRDB Dataextractor Version 10 10-00

●適用OS：Windows Server 2012，Windows Server 2012 R2，Windows Server 2016，Windows 7 Professional (x64)，Windows 7 Enterprise (x64)，Windows 7 Ultimate (x64)，Windows 8.1 Pro (x64)，Windows 8.1 Enterprise (x64)，Windows 10 Pro (x64)，Windows 10 Enterprise (x64)

P-2962-1JA4 HiRDB Dataextractor Version 10 10-00

これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。

輸出時の注意

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

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

商標類

HITACHI，HiRDB，Cosminexus，HAモニタ，JP1，OpenTP1，TPBroker，uCosminexus，VOS3/LS，VOS3/US，VOS3/XS，XDMは，株式会社 日立製作所の商標または登録商標です。

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

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

AMDは，Advanced Micro Devices, Inc.の商標です。

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

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

IBM，DataStage, MetaBroker, MetaStageおよびQualityStageは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Itaniumは，アメリカ合衆国および / またはその他の国における Intel Corporation の商標です。

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

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

Microsoft .NET は，お客様，情報，システムおよびデバイスを繋ぐソフトウェアです。

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

Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。

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

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

Veritas、Veritasロゴは、米国およびその他の国におけるVeritas Technologies LLCまたはその関連会社の商標または登録商標です。

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

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

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

発行

2018年10月　3020-6-575

著作権

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

変更内容

変更内容（3020-6-575）　HiRDB Dataextractor Version 10 10-00

追加・変更内容

変更個所

マニュアルの体裁を変更しました。

−

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

変更内容（3020-6-362-30）　HiRDB Dataextractor Version 8　08-04

追加・変更内容

1章の説明を変更しました。

UTF-16で表データの文字コード変換をできるようにしました。また，文字集合UTF-16で表データのデータ連携をできるようにしました。

これに伴い，次の環境変数を追加しました。

XTDATALOCALE

XTDATAUNDEF

XTCSETUSE

XTORANCSET

XTSQLNCSET

また，次の環境変数の説明を変更しました。

XTLOCALE

XTUNDEF

XTUTF8UCS4CHK

XTENDSPACE

DATファイル作成時に，セパレータ文字，囲み文字，および改行文字を変更できるようにしました。

これに伴い，次の環境変数を追加しました。

XTDATSEPARATER

XTDATENCLOSE

XTDATCRLF

また，-Rオプションに説明を追加しました。

次のメッセージを追加しました。

JXU7219I

また，次のメッセージを変更しました。

JXU7211E，JXU7212E，JXU7215E，JXU7230I，JXU7230E

Oracle Database 11gに対応しました。

変更内容（3020-6-362-20）　HiRDB Dataextractor Version 8　08-03

追加・変更内容

サポートする他社DBMSに，SQL Serverを追加しました。

これに伴い，次の環境変数を追加しました。

SQL Server環境変数

XTSQLDSN

XTSQLUSER

また，次の環境変数を変更しました。

XTLOBBUFSIZE

XTLOBKIND

XTSQL

SHLIB_PATH

LD_LIBRARY_PATH

LIBPATH

抽出時のバッファサイズを指定できるようにしました。

これに伴い，次の環境変数を追加しました。

XTXBUFKIND

XTENDSPACE

また，環境変数XTLOCALEを変更しました。

列定義で文字集合EBCDIKを指定できるようにしました。

-Iオプションに注意事項を追加しました。

DECIMAL型の精度を拡張し，38けたまで定義できるようになりました。

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

JXU7005I，JXU7200E，JXU7300E

HiRDB Dataextractorの稼働プラットフォームにWindows Server 2008を追加しました。

変更内容（3020-6-362-10）　HiRDB Dataextractor Version 8　08-02

追加・変更内容

抽出および反映対象にできる抽象データ型に，次のデータ型を追加しました。

XML型

FREEWORD型

これに伴い，次に示すメッセージの説明を変更しました。

JXU7003E

HiRDB Dataextractorをインストールする方法についての記述を追加しました。

UTF-8からSJISまたはEUCに文字コード変換をする際に，4バイト以上の文字コードをチェックし，処理をスキップできるようにしました。

これに伴い，次の環境変数を追加しました。

XTUTF8UCS4CHK

XTCCNVDMPSIZE

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

JXU7230I，JXU7230E

HiRDB Dataextractorのサポートプラットフォームに，Windows Vistaを追加しました。

はじめに

このマニュアルは，HiRDB Dataextractorを利用した，HiRDB間および異なるデータベースシステム間でのデータベース抽出・反映サービス機能の概要，HiRDB Dataextractorを使用する場合の環境設定などについて説明したものです。

対象読者

このマニュアルは，HiRDB Dataextractorを利用してデータ連携をするシステム管理者およびシステム設計者を対象としています。なお，このマニュアルを読み進めていく上では，次の知識があることを前提としています。

HiRDB Dataextractorの適用OSの基本的な知識

HiRDBの基本的な知識

XDM E2系の基本的な知識（XDMとデータ連携する場合）

XDM/XTの基本的な知識（XDM/XTを使用してメインフレーム側のデータベースとデータ連携する場合）

関連マニュアル

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

HiRDB（Windows用マニュアル）

HiRDB Version 10 システム導入・設計ガイド（Windows(R)用）（3020-6-553）

HiRDB Version 10 システム定義（Windows(R)用）（3020-6-555）

HiRDB Version 10 システム運用ガイド（Windows(R)用）（3020-6-557）

HiRDB Version 10 コマンドリファレンス（Windows(R)用）（3020-6-559）

HiRDB（UNIX用マニュアル）

HiRDB Version 10 システム導入・設計ガイド（UNIX(R)用）（3020-6-552）

HiRDB Version 10 システム定義（UNIX(R)用）（3020-6-554）

HiRDB Version 10 システム運用ガイド（UNIX(R)用）（3020-6-556）

HiRDB Version 10 コマンドリファレンス（UNIX(R)用）（3020-6-558）

インナレプリカ機能 HiRDB Staticizer Option Version 10（3020-6-563）

HiRDB Version 10 ディザスタリカバリシステム　構築・運用ガイド（3020-6-564）

HiRDB（Windows，UNIX共通マニュアル）

HiRDB Version 10 解説（3020-6-551）

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

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

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

HiRDB Version 10 XDM/RD E2接続機能（3020-6-565）

HiRDB Version 10 バッチ高速化機能（3020-6-567）

HiRDB データ連動機能 HiRDB Datareplicator Version 10（3020-6-573）

HiRDB データ連動拡張機能 HiRDB Datareplicator Extension Version 10（3020-6-574）

HiRDB 全文検索プラグイン HiRDB Text Search Plug-in Version 9（3020-6-481-30）

HiRDB XML拡張機能 HiRDB XML Extension Version 9（3020-6-480-30）

なお，本文中で使用しているHiRDB Version 10のマニュアル名は，Version 10，（UNIX(R)用），（Windows(R)用）を省略して表記しています。使用しているプラットフォームに応じてUNIX用またはWindows用のマニュアルを参照してください。

VOS3

VOS3 データマネジメントシステム　XDM E2系　概説（6190-6-601）

VOS3 データマネジメントシステム　XDM E2系　解説（6190-6-620）

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

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

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

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

VOS3 データベース抽出プログラム　XDM/XT（6190-6-641）

VOS3 XDMデータ連動機能　XDM/DS　解説・定義（6190-6-642）

VOS3 XDMデータ連動機能　XDM/DS　運用（6190-6-658）

通信管理　XNF E2　ネットワーク定義（6190-3-593）

XNF TCP/IP 接続機能　XNF/TCP　解説（6190-3-581）

XNF TCP/IP 接続機能　XNF/TCP　使用の手引（6190-3-582）

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

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

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

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

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

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

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

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

VOS3 Database Connection Server（6190-6-648）

利用者ごとの関連マニュアル

HiRDBのマニュアルをご利用になる場合，利用者ごとに次のようにお読みください。

また，より理解を深めるために，左側のマニュアルから順にお読みいただくことをお勧めします。

このマニュアルでの表記

このマニュアルでは製品名称および名称について次のように表記しています。ただし，それぞれのプログラムについての表記が必要な場合はそのまま表記しています。

製品名

表　記

HiRDB Server Version 10

HiRDB/シングルサーバ

HiRDBまたはHiRDBサーバ

HiRDB/パラレルサーバ

HiRDB/Developer's Kit Version 10

HiRDB/Developer's Kit

HiRDBクライアント

HiRDB/Developer's Kit Version 10(64)

HiRDB/Run Time Version 10

HiRDB/Run Time

HiRDB/Run Time Version 10(64)

HiRDB Datareplicator Version 10

HiRDB Datareplicator

HiRDB Dataextractor Version 10

HiRDB Dataextractor

HiRDB Text Search Plug-in Version 9

HiRDB Text Search Plug-in

HiRDB XML Extension Version 9

HiRDB XML Extension

XDM/RD E2

XDM/RD

XDM/RD

Oracle 8

ORACLE

Oracle 8i

Oracle 9i

Oracle 10g

Oracle Database 11g

AIX V7.1

AIX

AIX V7.2

HP-UX 11i V3(IPF)

HP-UXまたはHP-UX (IPF)

Linux(R)

Linux

Red Hat Enterprise Linux(R) 6 (64-bit x86_64)

Linux 6

Linux

Red Hat Enterprise Linux(R) 7 (64-bit x86_64)

Linux 7

Red Hat Enterprise Linux(R) 6 (64-bit x86_64)

Linux (EM64T)

Red Hat Enterprise Linux(R) 7 (64-bit x86_64)

Red Hat Enterprise Linux(R) 6 (64-bit x86_64)

Linux 6 (64-bit x86_64)

Linux 6

Red Hat Enterprise Linux(R) 7 (64-bit x86_64)

Linux 7 (64-bit x86_64)

Linux 7

Microsoft(R) Windows Server(R) 2012 Standard

Windows Server 2012

Microsoft(R) Windows Server(R) 2012 Datacenter

Microsoft(R) Windows Server(R) 2012 R2 Standard

Windows Server 2012 R2

Microsoft(R) Windows Server(R) 2012 R2 Datacenter

Microsoft(R) Windows Server(R) 2016 Standard

Windows Server 2016 Standard

Windows Server 2016

Microsoft(R) Windows Server(R) 2016 Datacenter

Windows Server 2016 Datacenter

Microsoft(R) Windows(R) 7 Professional

Windows 7 Professional

Windows 7

Microsoft(R) Windows(R) 7 Enterprise

Windows 7 Enterprise

Microsoft(R) Windows(R) 7 Ultimate

Windows 7 Ultimate

Microsoft(R) Windows(R) 7 Professional (x64)

Windows 7 (x64)

Microsoft(R) Windows(R) 7 Enterprise (x64)

Microsoft(R) Windows(R) 7 Ultimate (x64)

Microsoft(R) Windows(R) 7 Professional (x64)

Windows 7 Professional (x64)

Microsoft(R) Windows(R) 7 Enterprise (x64)

Windows 7 Enterprise (x64)

Microsoft(R) Windows(R) 7 Ultimate (x64)

Windows 7 Ultimate (x64)

Windows(R) 8.1 (Core Edition)

Windows 8.1 (Core Edition)

Windows 8.1

Windows(R) 8.1 Pro

Windows 8.1 Pro

Windows(R) 8.1 Enterprise

Windows 8.1 Enterprise

Windows(R) 8.1 (Core Edition) (x64)

Windows 8.1 (Core Edition) (x64)

Windows(R) 8.1 Pro (x64)

Windows 8.1 Pro (x64)

Windows(R) 8.1 Enterprise (x64)

Windows 8.1 Enterprise (x64)

Windows(R) 10 Home

Windows 10 Home

Windows 10

Windows(R) 10 Pro

Windows 10 Pro

Windows(R) 10 Enterprise

Windows 10 Enterprise

Windows(R) 10 Home (x64)

Windows 10 Home (x64)

Windows(R) 10 Pro (x64)

Windows 10 Pro (x64)

Windows(R) 10 Enterprise (x64)

Windows 10 Enterprise (x64)

Microsoft(R) SQL Server

SQL Server

Windows Server 2012，およびWindows Server 2016を総称してWindows Serverと表記します。また，Windows Server，Windows 7，Windows 8.1，およびWindows 10を総称してWindowsと表記します。

HP-UX，AIX，およびLinuxを総称してUNIXと表記します。

特に断らない場合，xtrepOまたはxtrepSコマンドをxtrepコマンドとして表記します。

特に断らない場合，ORACLEの下記属性はBLOBとして表記します。

　LONG，LONG RAW，BLOB，CLOB，NCLOB，およびBFILE

このマニュアルで使用する略語

このマニュアルで使用する英略語の一覧を次に示します。

英略語

英字の表記

ADM

Adaptable Data Manager

ADT

Abstract Data Type

BES

Back End Server

BLOB

Binary Large Object

CLOB

Character Large Object

CSMA/CD

Carrier Sense Multiple Access with Collision Detection

CSV

Comma Separated Values

DB

Database

DTD

Document Type Definition

EOF

End Of File

EUC

Extended UNIX Code

FES

Front End Server

FQDN

Fully Qualified Domain Name

FTP

File Transfer Protocol

ID

Identification number

IEEE

Institute of Electrical and Electronics Engineers

IP

Internet Protocol

IPF

Itanium(R) Processor Family

JIS

Japanese Industrial Standard

LAN

Local Area Network

LOB

Large Object

MGR

System Manager

ODBC

Open Database Connectivity

OS

Operating System

OSI

Open Systems Interconnection

PC

Personal Computer

PR

Protected Retrieve

RD

Relational Database

SDS

Single Database Server

SGML

Standard Generalized Markup Language

SJIS

Shift JIS

SQL

Structured Query Language

SR

Shared Retrieve

TCP/IP

Transmission Control Protocol / Internet Protocol

TLI

Transport Layer Interface

UAP

User Application Program

VOS3

Virtual-storage Operating System 3

WS

Workstation

XDM

Extensible Data Manager

XDM/DS

Extensible Data Manager / Data Spreader

XDM/RD

Extensible Data Manager / Relational Database

XDM/SD

Extensible Data Manager / Structured Database

XDM/XT

Extensible Data Manager / Data Extract

XNF

Extended HNA based communication Networking Facility

ログの表記

●Windows版の場合

Windowsのイベントビューアで表示されるアプリケーションログをイベントログと表記します。イベントログは，次の方法で参照できます。

〈手順〉

1.［スタート］−［プログラム］−［管理ツール（共通）］−［イベントビューア］を選択します。

2.［ログ］−［アプリケーション］を選択します。

3.アプリケーションログが表示されます。「ソース」の列が「HiRDB Dataextractor」になっているのがHiRDB Dataextractorが出力したメッセージです。

●UNIX版の場合

OSのログをsyslogfileと表記します。syslogfileは，/etc/syslog.confでログ出力先に指定しているファイルです。一般的には，次のファイルがsyslogfileとなります。

OS

ファイル

HP-UX

/var/adm/syslog/syslog.log

AIX

/var/adm/ras/syslog

Linux

/var/log/messages

Windowsの操作説明で使う表記

Windowsの操作説明で使う記号を次に示します。

記　号

意　味

［　］

ボタンやテキストボックスなど，画面に表示されている要素を示します。

［　］−［　］

画面に表示されるメニューやアイコンなどを選択する操作を示します。

Windowsの用語「ディレクトリ」と「フォルダ」は，「ディレクトリ」に統一して表記しています。また，パス名の区切りは，「／」で表記している個所があります。

図中で使用する記号

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

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

形式および説明で使用する記号を次に示します。ここで説明する文法記述記号は，説明のための記号なので実際には記述しないでください。

文法記述記号

意味

｛　　｝

この記号で囲まれている複数の項目の中から一つを選択することを示します。

（例）

NAME =｛A｜B｜C｝

これは，設定値として，Ａ，Ｂ，およびCから選択できることを示します。

〔　　〕

この記号で囲まれた項目は省略できることを示します。

（例）

xtrep〔−d〕

これは，xtrepコマンドで，−ｄオプションを省略できることを示します。

｜（ストローク）

記号｛　　｝で囲まれた複数の項目を一つずつの項目に区切ることを示します。

（例）

PDPRMTRC=｛YES｜NO｝

これは，PDPRMTRCオペランドの設定値としてYESとNOの項目に区切ることを示します。

　（下線）

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

（例）

PDPRMTRC=｛YES｜NO｝

これは，PDPRMTRCオペランドを省略したときにPDPRMTRC=NOと仮定されることを示します。

〜

この記号のあとにユーザ指定値の属性を示します。

《　　》

ユーザが指定しなかった場合に仮定される値を示します。

<　　>

ユーザ指定値の構文要素を示します。

((　　))

ユーザ指定値の指定範囲を示します。

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

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

構文要素記号

意味

<英字>

アルファベット（A〜Z，a〜z），＿（下線），−（ハイフン）

<英字記号>

アルファベット（A〜Z，a〜z），#，@，¥

<英数字>

<英字>，数字（0〜9）

<英数字記号>

<英字記号>，数字（0〜9）

<16進数字>

数字（0〜9），A〜F，a〜f

<符号なし整数>

数字（0〜9）

<識別子>

先頭がアルファベット（A〜Z，a〜z）の英数字列

<記号名称>

先頭が<英字記号>の<英数字記号>

<文字列>

任意の文字の配列

<パス名>

/または¥と記号名称の並び

<ファイル名>

アルファベット（A〜Z，a〜z），数字（0〜9），．（ピリオド），＿（下線），−（ハイフン），および＠で構成される文字列（最大30文字）

注

すべて半角文字を使用してください。また，英字の大文字と小文字は区別されます。さらに，パス名は使用しているOSに依存します。

このマニュアルで使用する計算式の記号

このマニュアルで使用する計算式の記号の意味を次に示します。

記号

意味

↑　↑

計算結果の値を小数点以下で切り上げることを意味します。

（例）↑34÷3↑の計算結果は，12となります。

↓　↓

計算結果の値を小数点以下で切り捨てることを意味します。

（例）↓34÷3↓の計算結果は，11となります。

(nnnn)₁₆

16進数字を意味します。

（例）(12AB)₁₆は，16進数字の12ABを意味します。

HiRDBのデータベース言語の出典

このマニュアルで記述するリレーショナルデータベースの言語仕様は，次に示す規格を基に日立製作所独自の解釈と仕様を追加したものです。原開発者に謝意を表するとともに，仕様の出典を示します。

HiRDBのリレーショナルデータベース

(1) JIS：X3005-1997　データベース言語SQL

(2) IS：ISO9075-1992　Information processing systems-Database Language SQL

(3) ANS：X3.135-1986　information systems-database language-SQL

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

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

HiRDB Version 9とHiRDB Version 10の製品体系の違い

HiRDB Version 10では，製品体系を次のように変更しました。

HiRDB Server with Additional Functionを廃止し，HiRDB Server with Additional Functionの機能をHiRDB Serverに統合しました。

HiRDB Version 9とHiRDB Version 10の製品体系の違いを次に示します。

1　HiRDB Dataextractorの概要

HiRDB Dataextractorの目的，機能，およびデータ連携の概要について説明します。

1.1　HiRDB Dataextractorとは

近年，企業活動で発生する基幹系業務のデータを，意思決定支援などの情報系業務で統合的に活用することが求められています。しかし，基幹系業務のDBには高い性能や格納効率が要求されるため，情報系業務のDBとしては操作性が劣っている場合や，目的に適していない場合があります。HiRDB Dataextractorは，このような問題を解決することを目的に開発されました。

HiRDB Dataextractorを使用すると，基幹系業務のDBから必要なデータを抽出して，目的や用途に応じた目的別DBを作成できます。例えば，全社DBからサーバごとの部門別DBを作成したり，あるサーバのDBのバックアップを別のサーバに初期作成したりできます。

XDM/XTと組み合わせて使用すると，メインフレーム側のDBとの間でデータの抽出・反映ができます。

また，抽出したデータでDBへの入力用のファイルを作成することもできます。

HiRDB Dataextractorを使用することによって，必要な情報を必要な場所で効率的に利用できるDBシステムが構築できます。

参考

HiRDB Datareplicatorとの違い

HiRDB Dataextractorは，DBから大量のデータを一括で抽出し，ほかのDBへ一括で反映するソフトウェアです。ほかのシステムのDBを目的や用途に応じて初期作成・再作成するのに適しています。

一方，HiRDB Datareplicatorとは，事前に定義された表の更新情報だけを抽出し，ほかのDBに一定の時間間隔で反映するソフトウェアです。あるDBの最新の更新情報をほかのシステムのDBで利用したり，最新のバックアップとして利用したりするのに適しています。

HiRDB Dataextractorで初期データ作成を行い，その後はHiRDB Datareplicatorで日々のデータ反映を行うといった使い方ができます。

1.2　HiRDB Dataextractorの機能

HiRDB Dataextractorを使用して，ほかのシステムのDBとデータを抽出・反映することをデータ連携と呼びます。

データ連携の概要を次の図に示します。なお，データ抽出を実行する側のシステムを，抽出側と呼びます。データ反映を実行する側のシステムを，反映側と呼びます。

図1‒1　データ連携の概要

データ連携を実現するために，HiRDB Dataextractorは次の機能を提供します。

データ抽出機能

データ抽出機能は，抽出対象のDBからデータを抽出し，抽出したデータを反映側のシステムに送信する機能です。このとき，ユーザは抽出するデータを選択したり，抽出したデータに任意の列を追加したりできます。

データ反映機能

データ反映機能は，抽出側から送信されたデータを受信し，反映対象の表に反映する機能です。

データ反映機能では，HiRDBのデータベース作成ユティリティ（pdload）を使用して，HiRDBの表にデータを反映します。

HiRDBのデータベース作成ユティリティ（pdload）については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

ファイル作成機能

ファイル作成機能は，抽出側から送信されたデータを受信し，ファイルに格納する機能です。

ファイル作成機能で作成したファイルを利用することによって，HiRDB以外のDBシステムともデータ連携が実現できます。

ファイル作成機能の概要を次の図に示します。なお，ファイル作成機能を実行する側のシステムを，ファイル作成側と呼びます。

図1‒2　ファイル作成機能の概要

1.3　HiRDB Dataextractorのデータ連携

HiRDB Dataextractorが実現するデータ連携について説明します。

1.3.1　データ連携できるシステム

HiRDB Dataextractorを使用してデータ連携できるシステムを，次の表に示します。

表1‒1　HiRDB Dataextractorを使用してデータ連携できるシステム

抽出側（適用OS）

反映・ファイル作成側（適用OS）

HiRDB（HP-UX，Solaris，AIX，Linux，Windows）

HiRDB（HP-UX，Solaris，AIX，Linux，Windows）

任意のDBシステム

（HP-UX，Solaris，AIX，Linux，Windows）※1

XDM/RD（VOS3）

メインフレームの任意のDBシステム（VOS3）※2

ORACLE（HP-UX，Solaris，AIX，Linux，Windows）

HiRDB（HP-UX，Solaris，AIX，Linux，Windows）

任意のDBシステム

（HP-UX，Solaris，AIX，Linux，Windows）※1

メインフレームの任意のDBシステム（VOS3）※2

SQL Server（Windows）

HiRDB（HP-UX，Solaris，AIX，Linux，Windows）

任意のDBシステム

（HP-UX，Solaris，AIX，Linux，Windows）※1

XDM/RD（VOS3）

HiRDB（HP-UX，Solaris，AIX，Linux，Windows）

任意のDBシステム

（HP-UX，Solaris，AIX，Linux，Windows）※1

順編成データセット（VOS3）※3

HiRDB（HP-UX，Solaris，AIX，Linux，Windows）

任意のDBシステム

（HP-UX，Solaris，AIX，Linux，Windows）※1

注※1

HiRDB Dataextractorが作成する入力用ファイルを利用します。

注※2

XDM/XTが使用する抽出データセットとして使用できます。また，作成するデータセットはVOS3の順編成データセットの形式であるため，HiRDB DataextractorとXDM/XTの組み合わせで反映できないDBシステムにも利用できます。

注※3

XDM/XTが作成する抽出データセットが使用できます。これによって，XDM/SD　E2，ADMのDBのデータを，HiRDBや任意のDBシステムに反映できます。また，XDM/XTが作成したデータセット以外でも，VOS3の順編成データセットの形式であれば使用できるため，XDM/XTでは抽出できないDBシステムの場合にも利用できます。

1.3.2　データ連携の仕組み

ここでは，HiRDB Dataextractorを使用した，代表的なデータ連携の仕組みについて説明します。

(1)　HiRDB間のデータの抽出・反映

HiRDBのDBからデータを抽出して，HiRDBのDBヘ反映できます。HiRDB間のデータの抽出・反映の概要を次の図に示します。

図1‒3　HiRDB間のデータの抽出・反映の概要

また，HiRDBのDBから抽出したデータをファイルに出力し，このファイルからHiRDBのDBヘ反映することもできます。

詳細については，「3.1　データの抽出（HiRDB）」を参照してください。

(2)　ORACLE，またはSQL Serverのデータの抽出

ORACLE，またはSQL ServerのDBからデータを抽出して，HiRDBのDBヘ反映できます。ORACLE，またはSQL Serverへのデータの反映はできません。ORACLE，またはSQL Serverのデータの抽出の概要を次の図に示します。

図1‒4　ORACLE，またはSQL Serverのデータの抽出の概要

また，ORACLE，またはSQL ServerのDBから抽出したデータをファイルに出力し，このファイルからHiRDBのDBヘ反映することもできます。

詳細については，「3.2　データの抽出（ORACLE）」，「3.3　データの抽出（SQL Server）」を参照してください。

(3)　メインフレーム側のDBとHiRDB間のデータの抽出・反映

メインフレーム側のDBからデータを抽出して，HiRDBのDBヘ反映できます。また，その逆もできます。メインフレーム側のDBとHiRDB間のデータの抽出・反映の概要を次の図に示します。

図1‒5　メインフレーム側のDBとHiRDB間のデータの抽出・反映の概要

HiRDB Dataextractorは，メインフレーム側のデータベース抽出プログラムであるXDM/XTと組み合わせて使用することによって，メインフレーム側のDBとデータ連携できます。

また，HiRDBのDBからVOS3の順編成データセットを作成できます。これによって，メインフレーム側のDBのデータを，ユーザが容易に利用できます。

メインフレーム側のDBとのデータの抽出，反映，および順編成データセットを作成する場合，データの抽出，反映，および順編成データセット作成方法はXDM/XT実行時に指定します。詳細は，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

(4)　ORACLEからメインフレーム側のDBへのデータの反映

ORACLEのDBからデータを抽出して，メインフレーム側のDBへ反映できます。ORACLEからメインフレーム側のDBへのデータの反映の概要を次の図に示します。

図1‒6　ORACLEからメインフレーム側のDBへのデータの反映の概要

メインフレーム側のデータベース抽出プログラムであるXDM/XTはVOS3の順編成データセットを作成します。これによって，HiRDB Dataextractorはメインフレーム側のDBとデータ連携できます。

メインフレーム側のDBへのデータの抽出，反映，および順編成データセット作成の場合，データの抽出，反映，および順編成データセット作成方法はXDM/XT実行時に指定します。詳細は，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

(5)　ORACLE，またはSQL Serverへのデータの反映

HiRDBのDBからデータを抽出して，DBシステムへの入力用ファイルを作成すると，ORACLE，またはSQL ServerのDBへ反映できます。ORACLE，またはSQL Serverへのデータの反映の概要を次の図に示します。

図1‒7　ORACLE，またはSQL Serverへのデータの反映の概要

入力用ファイルは，抽出側のDBのバックアップとしても利用でき，ユーザの任意のタイミングで反映側のDBへ反映できます。詳細については，「3.5　ファイルの作成」を参照してください。

また，XDM/XTと組み合わせて使用することによって，メインフレーム側のDBのデータでも，DBシステムへの入力用ファイルを作成できます。メインフレーム側のDBのデータからファイルを作成する場合，データの抽出およびファイルの作成方法はXDM/XT実行時に指定します。詳細は，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

2　HiRDB Dataextractorの環境設定

HiRDB Dataextractorのソフトウェア構成，環境の設定方法，および実行前の準備について説明します。

2.1　ソフトウェア構成

HiRDB Dataextractorを使用するために必要なソフトウェア構成について説明します。

HiRDB Dataextractorを使用するときに関連するプログラムプロダクトを，次の表に示します。

表2‒1　関連するプログラムプロダクト

プログラムプロダクト

必要性

備考

HP-UX

Windows

Solaris

Linux

AIX

○

−

HiRDB

△

次の場合に必要です。

HiRDBに対してデータの抽出または反映をする場合

HiRDBのXML型を使用してデータの抽出または反映をする場合

HiRDB Text Search Plug-in

△

HiRDBのSGMLTEXT型，FREEWORD型の列を使用する場合に必要です。

HiRDB XML Extension

△

HiRDBのXML型を使用してデータの抽出または反映をする場合に必要です。

XNF/H/BASE

△

適用OSがHP-UXの場合で，OSIプロトコルを使用する場合に必要です。

XNF/S/BASE-E2

△

XNF/W/BASE-E2

△

XNF/H/ACONARC

△

XDM/RD

△

次の場合に必要です。

XDM/RDに対してデータの抽出または反映をする場合

XDM/RDからのファイル作成の場合

XDM/XT

△

次の場合に必要です。

XDM/RDからデータを抽出して，HiRDBへ反映またはファイルを作成する場合

順編成データセットからデータを抽出して，HiRDBへ反映またはファイルを作成する場合

HiRDBからデータを抽出して，XDM/RDへ反映または順編成データセットを作成する場合

ORACLEからデータを抽出して，XDM/RDへ反映または順編成データセットを作成する場合

ORACLE

△

ORACLEに対してデータの抽出をする場合に必要です。

SQL Server

△

SQL Serverに対してデータの抽出をする場合に必要です。

ODBC

（凡例）

○：どれか一つが必要です。

△：条件によって必要です。

−：特にありません。

2.2　環境の設定方法

HiRDB Dataextractorを使用するための環境の設定方法について説明します。

2.2.1　環境の設定手順

HiRDB Dataextractorを使用するための環境の設定手順を，次の図に示します。

図2‒1　環境の設定手順

2.2.2　HiRDB Dataextractorのインストール

HiRDB Dataextractorをインストールする方法について説明します。

(1)　インストール前の準備

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

稼働環境の確認

ユーザ権限の確認

(a)　稼働環境の確認

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

HiRDB Dataextractorをインストールするマシンのディスクの空き容量が十分にあることを確認してください。

HiRDB Dataextractorが動作するのに必要な製品がインストールされていることを確認してください。HiRDB Dataextractorが動作するのに必要な製品については，「2.1　ソフトウェア構成」を参照してください。

(b)　ユーザ権限の確認

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

(2)　HiRDB Dataextractorをインストールするホスト

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

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

種別

抽出側

反映側

ファイル作成側

インストールするホスト※1

HiRDB/シングルサーバの場合

シングルサーバのあるホスト

HiRDB/シングルサーバの場合

シングルサーバのあるホスト

ファイルを作成するホスト

HiRDB/パラレルサーバの場合

次のどれかのサーバのあるホスト

システムマネジャ

フロントエンドサーバ

バックエンドサーバ

ディクショナリサーバ

HiRDB/パラレルサーバの場合

次のサーバのあるホスト※2

システムマネジャのあるホスト

データの転送先のサーバのあるホスト※3

ORACLEの場合

ORACLEのあるホスト

SQL Serverの場合

SQL Serverのあるホスト

注※1

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

注※2

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

注※3

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

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

(3)　インストールの実行

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

HiRDBとHiRDB Dataextractorのどちらを先にインストールしてもかまいません。

(4)　HiRDB Dataextractorのアンインストール

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

(5)　HiRDB Dataextractorが作成するディレクトリおよびファイル

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

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

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

ディレクトリおよび

ファイル名

作成時期

内容

種別

抽出

反映

作成

/opt/HIRDBXT/

インストール時

HiRDB HiRDB Dataextractorの各種ディレクトリおよびファイルを格納するディレクトリ

○

○

○

/opt/HIRDBXT/bin

HiRDB Dataextractorの実行ファイルを格納するディレクトリ（このディレクトリ下にHiRDB Dataextractorのロードモジュールおよびコマンドを格納する）

○

○

○

/opt/HIRDBXT/bin/xtrep

HiRDB Dataextractorのxtrepコマンドのファイル

○

○

○

/opt/HIRDBXT/bin/xtstart

HiRDB Dataextractorのxtstartコマンドのファイル

○

○

○

/opt/HIRDBXT/bin/xtmsgtext

HiRDB Dataextractorのメッセージ出力用テキストファイル

○

○

○

/opt/HIRDBXT/obj

オブジェクト格納ディレクトリ

○

○

○

/opt/HIRDBXT/obj/pxto8160.o

ORACLE抽出用オブジェクト

○

○

○

/opt/HIRDBXT/lib

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

○

○

○

/opt/HIRDBXT/lib/maptable/euc2jis.map

文字コード変換用マッピングテーブル（EUCからSJISへの変換）

○

○

○

/opt/HIRDBXT/lib/maptable/eucg2jis.map

/opt/HIRDBXT/lib/maptable/euc2ucs2.map

文字コード変換用マッピングテーブル（EUCからUCS-2への変換）

○

○

○

/opt/HIRDBXT/lib/maptable/eucg2u.map

/opt/HIRDBXT/lib/maptable/jis2euc.map

文字コード変換用マッピングテーブル（SJISからEUCへの変換）

○

○

○

/opt/HIRDBXT/lib/maptable/jis2ucs2.map

文字コード変換用マッピングテーブル（SJISからUCS-2への変換）

○

○

○

/opt/HIRDBXT/lib/maptable/ucs22euc.map

文字コード変換用マッピングテーブル（UCS-2からEUCへの変換）

○

○

○

/opt/HIRDBXT/lib/maptable/ucs22jis.map

文字コード変換用マッピングテーブル（UCS-2からSJISへの変換）

○

○

○

/opt/HIRDBXT/lib/usermap

xtccnvedtコマンドによるマッピングテーブル更新時

ユーザの文字コード変換用マッピングテーブルを格納するディレクトリ

−

○

○

/opt/HIRDBXT/lib/pxtora01.sl

Windows版，AIX版の場合：

インストール時

HP-UX版，Linux版，Solaris版の場合：

ユーザ環境でのmake時

ORACLE抽出用ライブラリ

○

−

○

/opt/HIRDBXT/spool/※1

インストール時

HiRDB Dataextractorが稼働中に出力するファイルを格納するディレクトリ

○

○

○

/opt/HIRDBXT/spool/xter

HiRDB Dataextractor

稼働時

TCP/IP使用時のHiRDB Dataextractorのエラーログファイル

TCP

※2

TCP

※3

TCP

※3

/opt/HIRDBXT/spool/xtlog...

OSI使用時のHiRDB Dataextractorのエラーログファイル

OSI

※3

OSI

※3

OSI

※3

/opt/HIRDBXT/spool/pder...

HiRDBデータベース作成ユティリティのエラーファイル

−

○

※3

−

/opt/HIRDBXT/spool/.xtpc...

HiRDBデータベース作成ユティリティの一時エラーファイル

−

△

※3

−

/opt/HIRDBXT/spool/pdin...または/opt/HIRDBXT/spool/.pdin...

HiRDBデータベース作成ユティリティの入力データファイル

−

△

※3

−

/opt/HIRDBXT/spool/pdcf...

HiRDBデータベース作成ユティリティの制御情報ファイル

−

□

※3

−

/opt/HIRDBXT/spool/pdnf...

HiRDBデータベース作成ユティリティのナル値情報ファイル

−

□

※3

−

$XTTMPDIR/...

出力ファイル

設定されるファイル名の詳細については，「(6)(a)出力ファイル」を参照してください。

−

□

※4

○

/opt/HIRDBXT/spool/...

/opt/HIRDBXT/spool/.pden...

HiRDBデータベース作成ユティリティへのEOF通知ファイル

−

△

※3

−

$XTTMPDIR/...

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

設定されるファイル名の詳細については，「(6)(b)LOB入力ファイル格納用ディレクトリ」を参照してください。

−

○

※5

※7

○

※5

※7

/opt/HIRDBXT/spool/...

$XTTMPDIR/.../xtlbf...

LOB入力ファイル

設定されるファイル名の詳細については，「(6)(c)LOB入力ファイル」を参照してください。

−

○

※5

○

※5

/opt/HIRDBXT/spool/.../xtlbf...

/opt/HIRDBXT/dump※6

HiRDB Dataextractorが使用するモジュールトレースファイルを格納するディレクトリ

○

○

○

/opt/HIRDBXT/dump/xtmt...

障害時に出力されるモジュールトレースファイル

○

○

○

/opt/HIRDBXT/dump/プロセスID

各ロード単位にcoreファイルを格納するディレクトリ

○

○

○

/opt/HIRDBXT/dump/プロセスID/core

障害時に出力されるcoreファイル

○

○

○

（凡例）

○：作成します。

−：作成しません。

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

□：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で，ディレクトリ名を指定できます。

注※7

HiRDB Dataextractorの実行ユーザとHiRDBの管理者が異なり，かつファイルの作成に続いてHiRDBのDBへ反映する場合は，環境変数XTDPERMIT，XTFPERMITを指定してください。環境変数XTDPERMIT，XTFPERMITの詳細は，「2.2.3　環境変数の設定」を参照してください。

(6)　ファイル名の決定方法

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

出力ファイル

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

LOB入力ファイル

(a)　出力ファイル

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

xtrepコマンドの−oオプションまたは−Oオプションの指定

環境変数XTTMPDIRの指定

環境変数XTTEMPNAMの指定

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

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

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

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

指定内容

出力ファイルの名称

−oまたは−Oオプションの有無

−oまたは−Oオプションの指定値

環境変数

XTFILESIZE

環境変数

XTTMPDIR

○

ファイル一つ

○

○

$XTTMPDIR/指定値−通番

×

〜/spool/指定値−通番

×

○

$XTTMPDIR/指定値

×

〜/spool/指定値

ファイル複数

−

○

$XTTMPDIR/指定値×ファイル数

×

〜/spool/指定値×ファイル数

ディレクトリ一つ

○

○

$XTTMPDIR/指定値/ファイルプレフィクス※1-年.月.日-時.分.秒−通番

×

〜/spool/指定値/ファイルプレフィクス※1-年.月.日-時.分.秒−通番

×

○

$XTTMPDIR/指定値/ファイルプレフィクス※1-年.月.日-時.分.秒

×

〜/spool/指定値/ファイルプレフィクス※1-年.月.日-時.分.秒

ディレクトリ複数

−

○

$XTTMPDIR/指定値/ファイルプレフィクス※1-年.月.日-時.分.秒−通番×ディレクトリ数

×

〜/spool/指定値/ファイルプレフィクス※1-年.月.日-時.分.秒−通番×ディレクトリ数

指定値なし

○

○

$XTTMPDIR/ファイルプレフィクス※1-年.月.日-時.分.秒−通番

×

〜/spool/ファイルプレフィクス※1-年.月.日-時.分.秒−通番

×

○

$XTTMPDIR/ファイルプレフィクス※1-年.月.日-時.分.秒

×

〜/spool/ファイルプレフィクス※1-年.月.日-時.分.秒

×

指定値なし

−

−

〜spool/.pdin-年.月.日-時.分.秒※2

（凡例）

〜：適用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入力ファイル格納用ディレクトリの名称

指定内容

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

−bオプション

環境変数XTTMPDIR

○

○

$XTTMPDIR/−bオプション指定値

×

〜/spool/−bオプション指定値

×

○

$XTTMPDIR/xtlb-年.月.日-時.分.秒-プロセスID※

×

〜/spool/xtlb-年.月.日-時.分.秒-プロセスID※

（凡例）

〜：適用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で指定できます。

2.2.3　環境変数の設定

(1)　HiRDB Dataextractorを使用するために必要な環境変数

HiRDB Dataextractorを使用するために必要な環境変数の設定について説明します。

HiRDB Dataextractorの環境変数は，実行する機能によって，次のどちらかに設定します。

xtrepコマンド実行者の環境

HiRDB Dataextractorの環境変数情報設定ファイル

HiRDB Dataextractorの環境変数の設定先を，「表2-6　HiRDB Dataextractorの環境変数の設定先」に示します。

HiRDB Dataextractorを使用するために必要な環境変数を，「表2-7　HiRDB Dataextractorを使用するために必要な環境変数」に示します。

表2‒6　HiRDB Dataextractorの環境変数の設定先

種別

抽出側

反映側

ファイル作成側

抽出したデータを，HiRDBへ反映する場合およびファイル作成の場合

XDM/XTを使用した，XDM/RDへの反映および順編成データセットの作成の場合

環境変数の設定先

xtrepコマンド実行者の環境

HiRDB Dataextractorの環境変数情報設定ファイル

表2‒7　HiRDB Dataextractorを使用するために必要な環境変数

環境変数

種別

XDM/XT連携

HiRDB Dataextractor連携

抽出側

反映側

ファイル作成側

抽出側

反映側

ファイル作成側

抽1

抽2

抽1

抽2

抽3

XTHOST

−

−

−

−

△

△

△

−

−

XTXHOST

−

−

−

−

△

△

△

−

−

XTPORTNO

−

−

△

−

△

△

△

−

−

XTFESHOST

−

−

△

−

−

−

−

−

−

XTOPNWTIME

−

−

△

−

−

−

−

△

−

XTWRTWTIME

−

−

△

−

−

−

−

△

−

XTTCPWTIME

△

△

△

△

△

△

△

△

△

XTOSIWTIME

△

△

△

△

−

−

−

−

XTTMPDIR

−

−

△

△

−

−

−

△

△

XTDPERMIT

−

−

△

△

−

−

−

△

△

XTFPERMIT

−

−

△

△

−

−

−

△

△

XTSTRETRY

△※2

△※2

△※2

△※2

−

−

−

−

XTLOGNAME

△※2

△※2

△※2

△※2

△

△

△

△※2

△※2

XTLOGRETRY

△※2

△※2

△※2

△※2

△

△

△

△※2

△※2

XTTEMPNAM

△※2

△※2

△※2

△※2

△

△

−

△※2

△※2

XTLOBBUFSIZE

△

△

−

−

△

△

△

−

−

XTFILESIZE

−

−

−

−

△

△

△

−

−

XTLOBKIND

−

−

−

−

△

△

△

−

−

XTERRLEVEL

△

△

−

−

△

△

△

−

−

XTPDCFPATH

−

−

△

−

−

−

−

△

−

XTPDCFxxxx

−

−

△

−

−

−

−

△

−

XTARRAY

−

−

−

△

△

△

−

XTTRCDIR

△

△

△

△

△

△

△

△

△

XTCNDSKP

−

−

−

−

△

△

△

−

−

XTEXTRACTDB

△

○

−

−

−

−

−

−

−

XTNLDFLT

−

−

−

−

△

△

△

−

−

XTORAUSER

−

○

−

−

−

○

−

−

−

XTSQLDSN

−

−

−

−

−

−

○

−

−

XTSQLUSER

−

−

−

−

−

−

△

−

−

XTSQL

−

−

−

−

△

△

△

−

−

XTLOCALE

−

−

−

−

△

△

△

△

△

XTDATALOCALE

−

−

−

−

△

△

△

△

△

XTUNDEF

−

−

−

−

−

−

−

△

△

XTDATAUNDEF

−

−

−

−

−

−

−

△

△

XTDATSEPARATER

−

−

−

−

−

−

−

−

△

XTDATENCLOSE

−

−

−

−

−

−

−

−

△

XTDATCRLF

−

−

−

−

−

−

−

−

△

XTCSETUSE

−

−

−

−

△

−

−

−

−

XTORANCSET

−

−

−

−

−

△

−

−

−

XTSQLNCSET

−

−

−

−

−

−

△

−

−

XTUTF8UCS4CHK

−

−

−

−

−

−

−

△

△

XTCCNVDMPSIZE

−

−

−

−

−

−

−

△

△

XTCLMxxxx

△

△

−

−

−

−

−

−

−

XTWHExxxx

△

△

−

−

−

−

−

−

−

XTLCKxxxx

△

△

−

−

−

−

−

−

−

XTTBLxxxx

△

△

−

−

−

−

−

−

−

XTLPRMxxxx

△

−

−

−

−

△

−

XTPDSRxxxx

△

−

−

−

−

△

−

TZ

△※2

△※2

△※2

△※2

△

△

△

△※2

△※2

XTPCHKTIME

△※2

△※2

△※2

△※2

△

△

△

△※2

△※2

XTXBUFKIND

−

−

−

−

△

△

△

−

−

XTENDSPACE

−

−

−

−

△

△

△

−

−

PDDIR

○

−

○

−

○

−

−

○

−

PDCONFPATH

○

−

○

−

○

−

−

○

−

PDUSER※1

○

−

○

−

○

−

−

○

−

PDHOST※1

○

−

−

−

○

−

−

−

−

PDNAMEPORT※1

○

−

−

−

○

−

−

−

−

PDBLKF※1

△

−

−

−

△

−

−

−

−

PDFESHOST※1

△

−

−

−

△

−

−

−

−

PDSERVICEGRP※1

△

−

−

−

△

−

−

−

−

PDCLTPATH※1

△

−

−

−

△

−

−

−

−

PDSQLTRACE※1

△

−

−

−

△

−

−

−

−

ORACLE環境変数

−

○

−

−

−

○

−

−

−

SQL Server環境変数

−

−

−

−

−

−

△

−

−

PATH

−

−

−

−

○

○

−

−

−

SHLIB_PATH

−

−

−

−

△

△

△

−

−

LD_LIBRARY_PATH

△

−

△

−

△

−

−

△

−

LIBPATH

△

−

△

−

△

−

−

△

−

LANG

△

△

△

△

△

△

△

△

△

（凡例）

○：必ず指定します。

△：必要に応じて指定します。

−：該当しません。

XDM/XT連携：XDM/XTと連携してデータの抽出，反映をする場合

HiRDB Dataextractor連携：HiRDB Dataextractor間で連携してデータの抽出，反映をする場合

抽1：HiRDB抽出側

抽2：ORACLE抽出側

抽3：SQL Server抽出側

注※1

HiRDBのクライアントの環境変数。設定方法の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

注※2

この環境変数は，HiRDB Dataextractorの起動方法によって，指定方法が異なります。詳細については，「(4)通常とは異なる場合の環境変数の指定方法」を参照してください。

注※3

XDM/XTのJXUMCTL制御文RDBDEF文を指定している場合は必ず指定します。

(2)　環境変数の設定方法

環境変数の設定方法について説明します。

●ＸＴＨＯＳＴ

抽出側で，データの送信対象のホスト名を指定します。ホスト名の代わりにFQDNを指定することもできます。

次のコマンドの省略時解釈値になります。

xtrepコマンドの−hオプション

抽出したデータを表に反映する場合は，次のサーバのあるホスト名を指定します。

HiRDB/シングルサーバの場合

シングルサーバ（SDS）

HiRDB/パラレルサーバの場合

システムマネジャ（MGR）

抽出したデータからファイルを作成する場合は，ファイルの作成先のホスト名を指定します。

注意事項

抽出側のホストと反映側のホストが異なるLANで構成されている場合は，環境変数XTXHOSTを指定してください。この環境変数と環境変数XTXHOSTを同時に指定することはできません。

反映側HiRDBで系切り替え機能を使用する場合は，IPアドレスを引き継ぐホスト名を指定してください。

●ＸＴＸＨＯＳＴ

抽出側で，データの反映側のホスト名を指定します。ホスト名の代わりにFQDNを指定することもできます。

抽出側のホストと反映側のホストが異なるLANで構成されている場合には，この環境変数を指定してください。

次のコマンドの省略時解釈値になります。

xtrepコマンドの−Hオプション

データの反映側の，次のサーバがあるホスト名を指定します。

HiRDB/シングルサーバの場合

シングルサーバ（SDS）

HiRDB/パラレルサーバの場合

システムマネジャ（MGR），およびデータの転送先のサーバ（フロントエンドサーバ（FES）またはバックエンドサーバ（BES））

指定方法については，「4.2.2　xtrepコマンド」の−Hオプションを参照してください。

注意事項

この環境変数と環境変数XTHOSTを同時に指定することはできません。

反映側HiRDBで系切り替え機能を使用する場合は，IPアドレスを引き継ぐホスト名を指定してください。

●ＸＴＰＯＲＴＮＯ　〜＜符号なし整数＞((1025〜65535))

抽出側では，データの反映側またはファイルの作成側のHiRDB Dataextractorが使用するポート番号を指定します。

次のコマンドの省略時解釈値になります。

xtrepコマンドの−pオプション

反映側では，XDM/XTからOSIプロトコルを使用して任意のサーバを指定してデータを転送する場合に，反映側HiRDBのシステムマネジャが存在するホストで稼働するHiRDB Dataextractorのポート番号を指定します。指定するポート番号は，/etc/servicesでHiRDB Dataextractor用にユーザが割り当てたポート番号を指定してください。

●ＸＴＦＥＳＨＯＳＴ　〜｛ＳＴＡＮＤＡＲＤ｜ＨＩＲＤＢ｝

反映側で，HiRDBのサーバのホスト名（HiRDBシステム共通定義pdunit −xオプションで指定）の種類を指定します。この指定は，OSIプロトコル使用時で，データの転送先のサーバ（フロントエンドサーバまたはバックエンドサーバ）とXDM/XTとの間がOSIプロトコルで接続されていて，かつシステムマネジャとXDM/XTとの間がOSIプロトコルで接続されていない場合にだけ必要です。

ＳＴＡＮＤＡＲＤ：サーバのホスト名に標準ホスト名を使用する場合に指定します。

ＨＩＲＤＢ：サーバのホスト名に標準ホスト名以外を使用する場合に指定します。

●ＸＴＯＰＮＷＴＩＭＥ　〜＜符号なし整数＞((60〜65535))≪60≫

反映側で，入力ファイルへのデータの書き込み監視時間を秒単位で指定します。この環境変数で指定した時間は，次の処理の時間を監視するために使用されます。

HiRDB Dataextractorがpdloadを内部コールしてからpdloadがデータの入力を開始するまでの時間

監視時間は，HiRDBの排他待ち限界経過時間の指定値より大きい値を指定します。排他待ち限界経過時間については，マニュアル「HiRDB システム定義」を参照してください。なお，出力ファイルへのデータ出力時（xtrepコマンドで−oまたは−Oオプション指定時）には，時間監視はしません。

●ＸＴＷＲＴＷＴＩＭＥ　〜＜符号なし整数＞((600〜65535))≪600≫

反映側で，入力ファイルへのデータの書き込み監視時間を秒単位で指定します。この環境変数は，データを追加モードでHiRDBへ反映時，登録済みのデータ件数が多い場合などにHiRDB Dataextractorがタイムアウトでエラー終了するときに指定します。指定した時間は，次の処理時間を監視するために使用されます。

HiRDB Dataextractorが入力ファイルにデータを書き込んでからpdloadがデータを読み込むまでの時間

なお，出力ファイルへのデータ出力時（xtrepコマンドで−oまたは−Oオプション指定時）には，時間監視はしません。

●ＸＴＴＣＰＷＴＩＭＥ　〜＜符号なし整数＞((60〜65535))

TCP/IPプロトコル使用時に，データ送受信時の応答監視時間を秒単位で指定します。この環境変数を省略した場合は応答監視をしません。

注意事項

指定値が小さい場合には，通信障害が発生していないときであっても，障害とみなして処理を終了することがあります。

Windowsの場合，時間監視をデータ受信に対してだけ行い，データ送信に対しては行いません。

●ＸＴＯＳＩＷＴＩＭＥ　〜＜符号なし整数＞((60〜65535))≪3600≫

OSIプロトコル使用時に，データ送受信時の応答監視時間を秒単位で指定します。

注意事項

指定値が小さい場合には，通信障害が発生していないときであっても，障害とみなして処理を終了することがあります。

●ＸＴＴＭＰＤＩＲ

反映側およびファイル作成側で，出力ファイルを作成するディレクトリおよびLOB入力ファイル格納用ディレクトリのディレクトリ名を指定します。指定するディレクトリの絶対パス名を指定します。省略した場合は，"/opt/HIRDBXT/spool"を仮定します。

●ＸＴＤＰＥＲＭＩＴ　〜＜符号なし整数＞((1〜777))≪700≫

反映側およびファイル作成側で，LOB入力ファイル格納用ディレクトリのファイルモードを指定します。ファイルモードは8進数表現で指定します。

HiRDB Dataextractorの実行ユーザとHiRDBの管理者が異なり，かつファイルの作成に続いてHiRDBのDBへ反映する場合は，この環境変数を指定してください。

この指定がない場合は，HiRDB Dataextractorが呼び出すpdloadは作成したファイルの入力権限がないため，エラーで終了します。

注意事項

ファイルモードは，umask(2)が指定してあるとその指定によって実際の値が変わります。

●ＸＴＦＰＥＲＭＩＴ　〜＜符号なし整数＞((1〜777))≪600≫

反映側およびファイル作成側で，出力ファイルおよびLOB入力ファイルのファイルモードを指定します。ファイルモードは8進数表現で指定します。

HiRDB Dataextractorの実行ユーザとHiRDBの管理者が異なり，かつファイルの作成に続いてHiRDBのDBへ反映する場合は，この環境変数を指定してください。

指定がない場合は，HiRDB Dataextractorが呼び出すpdloadは作成したファイルの入力権限がないため，エラーで終了します。

注意事項

ファイルモードは，umask(2)が指定してあるとその指定によって実際の値が変わります。

●ＸＴＳＴＲＥＴＲＹ　〜＜符号なし整数＞((1〜360))

xtstartコマンド実行時に，OSI通信に必要なプログラム（XNF）が起動していない場合の再試行回数を指定します。この環境変数の指定がある場合，xtstartコマンドの実行時にXNFが起動していないときには，この環境変数での指定に従って，XNFが起動されるまでxtstartコマンドが再試行されます。1回の再試行間隔は10秒です。この環境変数を省略した場合は，xtstartコマンドは再試行されません。

●ＸＴＬＯＧＮＡＭＥ

ログメッセージを出力するファイル名を絶対パス名で指定します。

ファイル名称規則は，適用OSのマニュアルを参照してください。また，ファイル名称は引用符（"）で囲まないでください。

環境変数XTTEMPNAMが1のときだけ有効となります。

●ＸＴＬＯＧＲＥＴＲＹ　〜＜符号なし整数＞((0〜100))≪20≫

syslogへのメッセージ出力が失敗したときのリトライ回数を指定します。

●ＸＴＴＥＭＰＮＡＭ　〜｛０｜１｝

HiRDB Dataextractorが作成するファイル名称の決定方法を指定します。

０：ファイル名称を決定するとき，tempnam関数を使用します。

１：ファイル名称を決定するとき，日時を使用します。

この環境変数を省略した場合，1が仮定されます。

tempnam関数については，適用OSのマニュアルを参照してください。

●ＸＴＬＯＢＢＵＦＳＩＺＥ　〜＜符号なし整数＞((1〜2147483647))≪BLOB列定義長≫

抽出側で，BLOB，BINARY属性の列を抽出するとき，または，ORACLEもしくはSQL Serverから抽出したデータをBLOB，BINARY属性の列に反映するときに，使用するバッファのサイズを指定します。

定義長と実際のLOBデータの長さに差がある場合に，この環境変数に実データの長さを指定することによって，指定された長さのバッファを使用するためにバッファを節約できます。

BLOB，BINARY列定義長よりも大きな値を指定した場合は，この指定は無効になり，BLOB列定義長のバッファが使用されます。

この環境変数で指定した値は，抽出する表内のすべてのBLOB，BINARY列に対して有効になります。

注意事項

SGMLTEXT型またはXML型の列を抽出する場合には，この環境変数を必ず指定してください。省略された場合は，JXU7002Eメッセージを出力してリターンコード12で終了します。また，指定する値は抽出する原文書データ長の最大値にしてください。

ORACLEのLONG，LONG RAW，BLOB，CLOB，NCLOB，およびBFILEの列を抽出する場合には，この環境変数を必ず指定してください。省略された場合は，JXU7002Eのメッセージを出力してリターンコード12で終了するときがあります。また，指定する値は抽出する実データ長の最大値にしてください。

指定値を超える大きさのデータが抽出された場合，環境変数XTERRLEVELに従って，あとの処理が行われます。

実データのバッファサイズの求め方の例を次に示します。（HiRDBの場合）

この例では，出力ファイルsizeに実データの最大長が出力されます。

求め方の例

BLOB型の場合の列名記述ファイル（clm）

max(length(列名))

SGMLTEXT型の場合の列名記述ファイル（clm）

max(length(extracts(列名)))

xtrepコマンド

xtrep -R dat -o size -s clm 表名

環境変数XTLOBBUFSIZEの指定例

次のように定義されたデータがある場合に，バッファサイズを実データ長2,048バイトに指定するときの例を示します。

表定義

表A

列A1

列A2

列A3

BLOB（1K）

SGMLTEXT

BLOB（3K）

定義長

列A1：1,024バイト

列A2：2,147,483,647バイト

列A3：3,072バイト

環境変数指定

setenv XTLOBBUFSIZE=2048

バッファサイズ

上のように指定した場合，実際に確保されるバッファサイズは次のとおりです。

列A1：1,024バイト

列A2：2,048バイト

列A3：2,048バイト

注意事項

この状態で列A2，列A3に2,048バイト以上の実データが存在すると切り捨てが発生します。

●ＸＴＦＩＬＥＳＩＺＥ　〜＜符号なし整数＞((8192〜2147483647))

抽出側で，出力ファイルのサイズの最大長を指定します。

データ反映時にファイルを作成して反映する場合，またはファイルを作成する場合に，データ量が多く，一つのファイルに格納できないときに，この環境変数に出力ファイルの最大長を指定することによって複数の出力ファイルに分割して格納できます。なお，xtrepコマンドの−o，−Oオプションに複数のファイル名称を指定した場合も，複数の出力ファイルに分割して格納できます。

出力ファイルは，この指定値を超えない1行の末尾までが入るように分割して，作成されます。

この環境変数を指定したときの出力ファイルの名称については，「2.2.2(6)ファイル名の決定方法」を参照してください。

注意事項

この環境変数を省略した場合，出力ファイルのサイズが2GB（ギガバイト）を超えるか，またはファイルを作成しているパーティションがいっぱいになったときに，JXU7002Eメッセージ（ファイル書き込みエラー）を出力してエラーになります。

この環境変数には，抽出データ1行分のサイズ以上の値を指定してください。指定値よりも1行分のデータが大きい場合には，JXU7209Eメッセージ（ファイル書き込みエラー）を出力してエラーになります。

この環境変数は，反映側またはファイル作成側のHiRDB Dataextractorでもこの機能をサポートしている場合にだけ使用できます。サポートしていない場合には，反映側またはファイル作成側で，JXU7001Eメッセージを出力してエラーになります。

環境変数XTNLDFLTの指定により抽出データ１行分のサイズが異なるため注意してください。データ形式については，「4.2.4(4)出力ファイル」および「付録A　メモリ所要量とファイル所要量」を参照してください。

●ＸＴＬＯＢＫＩＮＤ　〜｛０｜１｝

抽出側で，HiRDBの表に反映する場合の，BLOB型の列のデータ（LOBデータ）の形式を指定します。この指定によって，BLOB型のLOBデータを，LOBデータ以外のデータと同一のファイルに格納してファイルのI/O回数を削減できるため，処理性能を向上できます。

環境変数XTNLDFLTに2を指定した場合，HiRDB反映またはバイナリ形式のファイル作成時はデータベース作成ユティリティ（pdload）の−Wオプション指定時の入力データ形式となるため，この環境変数の指定は無視されます。

０：BLOB型のLOBデータを，別ファイル（LOB入力ファイル）に出力します。

１：BLOB型のLOBデータを，BLOB型以外のデータと同一のファイルに出力します。

環境変数XTLOBKINDに0を指定した場合に作成されるデータの形式を「表2-8　環境変数XTLOBKINDに0を指定した場合に作成されるデータの形式」に，環境変数XTLOBKINDに1を指定した場合に作成されるデータの形式を「表2-9　環境変数XTLOBKINDに1を指定した場合に作成されるデータの形式」に示します。

表2‒8　環境変数XTLOBKINDに0を指定した場合に作成されるデータの形式

抽出側

反映側，ファイル作成側

列属性

BLOB属性のデータの形式

pdloadの−kオプション設定値

備考

ADT

BLOB型

ADT

BLOB型

HiRDB，ORACLE，またはSQL Server

HiRDBの表への反映

なし

なし

−

−

−

−

あり

−

1

f

あり

なし

2

−

v

あり

2

1

バイナリ形式のファイル作成

なし

なし

−

−

−

−

あり

−

1

あり

なし

1※1

−

−

※2

あり

1※1

1

DAT形式のファイル作成

なし

なし

−

−

−

−

あり

−

1

あり

なし

1

−

あり

1

1

（凡例）

ADT：抽象データ型

1：BLOB属性の列を別ファイルに作成します（入力ファイル，LOB入力ファイル）。

2：一つのファイルに作成します（入力ファイルだけ）。

−：該当しません。

注※1

反映情報ファイルにSGMLTEXTを指定すると「2」になります。

注※2

SGMLTEXTを含む表からデータを抽出しファイル作成を行う場合は反映情報ファイルでSGMLTEXTを指定し実行してください。指定を行わない場合，作成したファイルを使用してpdloadでHiRDBの表への反映を行った際の結果は保証しません。

表2‒9　環境変数XTLOBKINDに1を指定した場合に作成されるデータの形式

抽出側

反映側，ファイル作成側

列属性

BLOB属性のデータの形式

pdloadの−kオプション設定値

備考

ADT

BLOB型

ADT

BLOB型

HiRDB，ORACLE，またはSQL Server

HiRDBの表への反映

なし

なし

−

−

−

−

あり

−

2

d

あり

なし

2

−

あり

2

2

バイナリ形式のファイル作成

なし

なし

−

−

−

−

あり

−

2

あり

なし

2

−

−

※

あり

2

2

DAT形式のファイル作成

なし

なし

−

−

−

指定不可

あり

あり

なし

あり

（凡例）

ADT：抽象データ型

2：一つのファイルに作成します（入力ファイルだけ）。

−：該当しません。

注※

SGMLTEXTを含む表からデータを抽出しファイル作成を行う場合は反映情報ファイルでSGMLTEXTを指定し実行してください。指定を行わない場合，作成したファイルを使用してpdloadでHiRDBの表への反映を行った際の結果は保証しません。

環境変数XTLOBKIND指定値と作成するファイル数の関係

環境変数XTLOBKIND指定値と作成するファイル数の関係を，次の表に示します。

表2‒10　環境変数XTLOBKIND指定値と作成するファイル数の関係

指定値

ファイル分割※1

出力ファイル数（pdload入力ファイル）

データの状態例※2

入力ファイル

LOB入力ファイル

0

なし

一つ

データ件数

1.

あり

分割ファイル数

データ件数

2.

1

なし

一つ

0

3.

あり

分割ファイル数

0

4.

注※1

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

注※2

データの状態例を次に示します。

環境変数XTLOBKIND 1指定時のBLOB列のデータの形式

環境変数XTLOBKIND 1指定時のBLOB型（以降，BLOBと略記します），および抽象データ型のBLOB属性（以降，ADT（BLOB）と略記します）の列のデータの形式について，説明します。

BLOB，ADT（BLOB）の列のデータのサイズ部は，ほかの列とともに定義順に出力します。

ADT（BLOB）の列のデータ部は，定義順の行データの末尾に出力します。

BLOBのデータ部は，定義順の行データの末尾に出力します。

ただし，HiRDBへ反映する表にBLOBとADT（BLOB）が混在している場合は，ADT（BLOB）のデータ部よりもあとに出力します。

データがナル値の場合，BLOBおよびADT（BLOB）は，サイズ部に−1を設定して出力します。このときデータ部は出力しません。

0バイトデータの場合，BLOBおよびADT（BLOB）は，サイズ部に0を設定して出力します。このときデータ部は出力しません。

環境変数XTLOBKIND指定時のデータの作成例

環境変数XTLOBKIND指定時のデータの作成例を，次に示します。

●ＸＴＥＲＲＬＥＶＥＬ　〜｛０｜１｝

抽出側で，データの抽出時にエラーが発生したあとの，HiRDB Dataextractorの処理について指定します。

０：エラーが発生した場合，JXU7208Iメッセージを出力して処理を続行し，リターンコード4で終了します。

１：エラーが発生した場合，JXU7208Eメッセージを出力して，リターンコード12で終了します。

注意事項

この環境変数の対象になるエラーを次に示します。

・データの切り捨て

・オーバフロー

なお，オーバフローを検知するためには，HiRDBのシステム共通定義で，pd_overflow_suppressにYを指定する必要があります。

次の場合は，この環境変数に1を指定します。

・データ型がSGMLTEXT型またはXML型の列を抽出するとき

・切り捨てが発生する可能性のある表に対して反映するとき

●ＸＴＰＤＣＦＰＡＴＨ　〜＜パス名＞

反映側で，HiRDBのデータベース作成ユティリティ（pdload）のidxwork文，index文，lobmid文を記述した制御情報ファイルのファイル名を，絶対パス名で指定します。この環境変数の指定によって，HiRDBのデータベース作成ユティリティが作成するインデクス情報ファイルおよびLOB中間ファイルの作成先を指定できます。

注意事項

この環境変数および環境変数XTPDCFxxxxを省略した場合，pdloadはインデクス情報ファイル，LOB中間ファイルを/tmpの下に作成します。反映表にインデクス，BLOB型の列があるときには，データ量に比例して/tmpの下に一時ファイルが出力されます。/tmp下に十分な空き容量がない場合には，システム全体に悪影響を及ぼすことがあるため，注意が必要です。

反映表にインデクスがない場合にidxwork文またはindex文，反映表にBLOB型の列がない場合にlobmid文を記述した制御情報ファイルを指定したときは，pdloadでエラーになります。

このような場合には，環境変数XTPDCFxxxxを使用します。反映側の表ごとに，表の定義に合わせて制御情報ファイルを作成し，環境変数XTPDCFxxxxに設定します。HiRDB Dataextractorの実行時に，xtrepコマンドで反映する表に対応する環境変数XTPDCFxxxxを指定して，使用する制御情報ファイルを選択します。

指定例

環境変数情報設定ファイル

　　　　　　：
　　　　　　：
　set XTPDCFPATH=/HIRDBXT/conf/xtpdcf
　　　　　　：
　　　　　　：

/HIRDBXT/conf/xtpdcf

　idxwork /hd001/idxwork
　lobmid /hd002/tmp

●ＸＴＰＤＣＦｘｘｘｘ　〜＜パス名＞

反映側で，HiRDBのデータベース作成ユティリティ（pdload）のidxwork文，index文，lobmid文，option文を記述した制御情報ファイルのファイル名を，絶対パス名で指定します。この環境変数の指定によって，HiRDBのデータベース作成ユティリティが作成するインデクス情報ファイルおよびLOB中間ファイルの作成先を指定できます。

また，HiRDBのデータベース作成ユティリティのオプション機能を指定できます。

xxxxには任意の文字列（0〜4文字の英数字）を指定します。

xtrepコマンドの−Iオプションに，ここで指定した環境変数名を指定すると，pdloadはこの環境変数で指定された制御情報ファイルを使用してデータを格納します。

注意事項

idxwork文，index文，lobmid文

・この環境変数および環境変数XTPDCFPATHを省略した場合，pdloadはインデクス情報ファイル，LOB中間ファイルを/tmpの下に作成します。反映表にインデクス，BLOB型の列があるときには，データ量に比例して/tmpの下に一時ファイルが出力されます。/tmp下に十分な空き容量がない場合には，システム全体に悪影響を及ぼすことがあるため，注意が必要です。

・反映表にインデクスがない場合にidxwork文またはindex文，反映表にBLOB型の列がない場合にlobmid文を記述した制御情報ファイルを指定したときは，pdloadでエラーになります。

このような場合には，この環境変数を使用して，pdloadが使用する制御情報ファイルを指定します。反映側の表ごとに，表の定義に合わせて制御情報ファイルを作成し，この環境変数に設定します。HiRDB Dataextractorの実行時に，xtrepコマンドで反映する表に対応する環境変数XTPDCFxxxxを指定して，使用する制御情報ファイルを選択します。

option文

pdloadによるデータ反映の実行中に通信障害などが発生すると無応答になることがあります。pdloadが無応答になると反映側HiRDB Dataextractorも無応答となりJOB全体がハングアップするおそれがあります。option文exectimeに実行監視時間を指定することでpdloadプロセスを強制終了し，無応答を回避できます。このような場合には，監視したいJOBごとに制御情報ファイルを作成し，この環境変数に設定します。HiRDB Dataextractorの実行時に，xtrepコマンドで反映する表に対応する環境変数XTPDCFxxxxを指定して，使用する制御情報ファイルを選択します。

●ＸＴＡＲＲＡＹ　〜｛ＦＦ｜ＦＶ｜ＶＶ｝〔，｛Ｃ｜Ｅ｝〕

繰返し列をファイルに出力する場合の，データ形式（FF，FV，VV），およびナル値反映方法（C，E）について指定します。

この環境変数は，表単位にデータ形式，ナル値反映方法について設定する場合に指定します。列単位に設定する場合には，xtrepコマンドの−vオプションに指定するナル値情報ファイルで指定します。この環境変数と，ナル値情報ファイルでの指定とを同時に指定した場合には，ナル値情報ファイルでの指定が優先されます。

この環境変数を省略した場合は，VVおよびCを仮定します。

また，環境変数XTNLDFLTに2を指定した場合，HiRDB反映またはバイナリ形式のファイル作成時は，この環境変数の指定は無視され，VVおよびCとして処理されます。

繰返し列のデータ形式およびナル値反映方法の指定の詳細については，「3.1.1(6)繰返し列の抽出」を参照してください。

データ形式

ＦＦ：列の先頭に要素数がなく，列の要素すべてにデータがある形式

ＦＶ：列の先頭に要素数があり，列の要素すべてにデータがある形式

ＶＶ：列の先頭に要素数があり，要素数分のデータがある形式

ナル値反映方法

Ｃ：要素全体にデータがないとき，列全体をナル値として反映します。

Ｅ：要素全体にデータがないとき，各要素をナル値として反映します。

●ＸＴＴＲＣＤＩＲ　〜＜パス名＞

HiRDB Dataextractorが作成するモジュールトレースファイル，coreファイル用のディレクトリのディレクトリ名を絶対パスで指定します。この環境変数の対象になるファイル，ディレクトリを次に示します。

モジュールトレースファイル

core格納用ディレクトリ

この環境変数を省略した場合は，/opt/HIRDBXT/dumpを仮定します。

注意事項

/opt/HIRDBXT/dump下は定期的に削除してください。

HiRDB Dataextractorが停止中に削除してください。

●ＸＴＣＮＤＳＫＰ　　〜｛０｜１｝　

送受信データの圧縮を行うかどうかを指定します。

次のどちらかの条件を満たす場合，転送データを圧縮しない方がプロセスの実行時間を短縮できます。

マシン性能よりも通信性能の方が良い。

転送データの圧縮率が低い（同一コードがあまり連続しない）。

０：送受信データの圧縮を行います。

１：送受信データの圧縮を行いません。

●ＸＴＥＸＴＲＡＣＴＤＢ　

抽出対象となるDBの種別を指定します。

hirdb ：HiRDBからデータを抽出します。

oracle ：ORACLEからデータを抽出します。

●ＯＲＡＣＬＥ環境変数

ORACLE抽出を行うために必要となるORACLEの環境変数を定義します。

環境変数名および指定値については，ORACLEのマニュアルを参照してください。

●ＳＱＬ Ｓｅｒｖｅｒ環境変数

SQL Server抽出を行うために必要となるSQL Serverの環境変数を定義します。

環境変数名および指定値については，SQL Serverのマニュアルを参照してください。

●ＸＴＮＬＤＦＬＴ　〜｛０｜１｜２｝　

HiRDBまたはファイルへ反映する場合のナル値の反映方式を指定します。

０：

ナル値情報ファイルを省略（−ｖオプションを省略）した場合，またはナル値情報ファイルに指定しない列に対するナル既定値として仮定値を使用する場合に指定します。

この指定で仮定する値が実データとして使用されていない場合に指定します。

仮定するナル値の既定値については，「表4-13　ナル値情報ファイルの指定規則（HiRDBからのデータ抽出の場合）」を参照してください。

１：

ナル値情報ファイルを省略（−ｖオプションを省略）した場合，またはナル値情報ファイルに指定しない列に対するナル既定値として仮定値を使用する場合に指定します。

次に示すデータ型について，この環境変数の指定値が0の場合の仮定値が実データとして使用されている場合に指定します。

DECIMAL

DATE

INTERVAL YEAR TO DAY

TIME

INTERVAL HOUR TO SECOND

TIMESTAMP

仮定するナル値の既定値については，「表4-13　ナル値情報ファイルの指定規則（HiRDBからのデータ抽出の場合）」を参照してください。

２：

ナル既定値を使用しないで，ナル値として反映する場合に指定します。

環境変数XTNLDFLTに0または1を指定したときの仮定値と同じ値が実データとして使用されている場合に指定します。なお，環境変数XTNLDFLTに2を指定すると，環境変数XTLOBKINDの指定は無視されます。

注意事項

環境変数XTNLDFLTの指定と非ナル値制約指定（抽出表および反映表の列）の組み合わせを次に示します。

非ナル値制約指定

環境変数XTNLDFLT

抽出側

反映側

0

1

2※5

NULL

NULL

○※1

○※1

○

NOT NULL

○※2

×※3

×※4

NOT NULL

NULL

−

−

−

NOT NULL

−

−

−

（凡例）

○：指定できます。

×：指定できません（pdloadでデータ反映時，入力データ不正となります）。

−：指定する必要はありません（抽出側にナル値が存在しないため指定しても意味がありません）。

注※1

ナル既定値と同じ実データはナル値として反映されます。

注※2

ナル値の場合，ナル既定値が実データとして反映されます。

注※3

次に示すデータ型にナル値が存在する場合に入力データ不正となります。

なお，次に示すデータ型以外の場合，ナル値のときはナル既定値が実データとして反映されます。

・DECIMAL

・DATE

・INTERVAL YEAR TO DAY

・TIME

・INTERVAL HOUR TO SECOND

・TIMESTAP

注※4

抽出側にナル値が存在する場合に入力データ不正となります。

注※5

環境変数XTNLDFLTに2を指定すると，ナル値を判定するためのオフセット情報が付加されるため，ほかの指定と比べてデータ量が増加します。このため，抽出側のデータにナル既定値と同じ実データが存在しない場合に，この指定をするとデータ量が増加するだけでメリットはありません。

データ形式については，「4.2.4(4)出力ファイル」および「付録A　メモリ所要量とファイル所要量」を参照してください。

環境変数XTNLDFLTの指定によってHiRDB反映時，またはファイル作成時の出力データ形式が異なります。

環境変数XTNLDFLTの指定値と出力データ形式の関係を次に示します。

環境変数

XTNLDFLT

の指定値

出力データ形式

HiRDB反映

ファイル形式

バイナリ形式

DAT形式

0

HiRDBのデータベース作成ユティリティのバイナリ形式の入力ファイル形式

HiRDBのデータベース作成ユティリティのバイナリ形式の入力ファイル形式

HiRDBのデータベース作成ユティリティのDAT形式の入力ファイル形式

1

同上

同上

同上

2

HiRDBのデータベース作成ユティリティの−Wオプション指定時の入力ファイル形式※

HiRDBのデータベース作成ユティリティの−Wオプション指定時の入力ファイル形式※

同上

注※

環境変数XTLOBKINDの指定に関係なくBLOB型のLOBデータは，BLOB型以外のデータと同一のファイルに出力します。

環境変数XTNLDFLTに1を指定する場合の注意事項

この指定は，反映側HiRDBのバージョンが07-00-/J以降の場合だけ使用できます。条件を満たしていない場合，HiRDBのデータベース作成ユティリティ（pdload）がナル値情報ファイルの内容不正でエラーとなります。

この指定をしたファイル作成（バイナリ形式）機能では，抽出表にナル値が存在すると，ナル既定値をそのままデータとしてファイルに格納します。この場合，ナル既定値がデータ型と異なる形式（X'FF・・・FF'）となるため，作成したファイルを使用する際はその点を考慮する必要があります。

環境変数XTNLDFLTに2を指定する場合の注意事項

この指定は，反映側，またはファイル作成側のHiRDB Dataextractorでもこの機能をサポートしている場合にだけ使用できます。サポートしていない場合は反映側，またはファイル作成側で，JXU7017Eメッセージを出力してエラーとなります。

この指定でのFIX表への反映は意味がないため，2以外を指定して実行してください。この指定でFIX表への反映を行うとJXU7223Eメッセージを出力してエラーとなります。

●ＸＴＯＲＡＵＳＥＲ　

抽出側のORACLEに接続するユーザ名とパスワードを"ユーザ名"／"パスワード"の形式で指定します。

なお，指定するユーザは抽出する表に対してORACLEのSELECT権限またはSELECT ANY TABLE権限を持っている必要があります。また，抽出する表にLOCKを発行する場合は，LOCK ANY TABLEシステム権限またはオブジェクト権限を持っている必要があります。

●ＸＴＳＱＬＤＳＮ

SQL Serverに接続するためのDSN名（1〜31文字）を指定します。

●ＸＴＳＱＬＵＳＥＲ

抽出側のSQL Server接続ユーザIDとパスワードを，"SQL Server接続ユーザID"／"パスワード"の形式で指定します。

Windowsの認証メカニズムを使用している場合は，この環境変数を省略できます。省略した場合は，メッセージ中の認可識別子に'********'が表示される場合があります。

なお，ログインパスワードを設定していない場合は，／"パスワード"を省略してください。

SQL Server接続ユーザID　〜＜1〜8文字の識別子＞

SQL Server接続ユーザIDを指定します。ここで指定するユーザIDと，ログインユーザのID，およびデータベースユーザIDはすべて同一である必要があります。

XTSQLDSNでユーザIDが指定されていても，その情報は無視されます。

指定するユーザには，SQL Serverでリソースを作成できるDBA権限，または次の固定データベースロールを与えておく必要があります。

db_ddladmin

db_datareader

/パスワード　〜＜1〜8文字の記号名称＞

SQL Server接続ユーザIDのパスワードを指定します。

●ＸＴＳＱＬ　

HiRDB Dataextractor間で連携を行い，HiRDB，ORACLE，またはSQL Serverからデータを抽出するときに，ユーザ指定のSQLを指定するかどうかを選択します。コマンドの指定方法の詳細は，「4.2.3　データ抽出・反映の付加機能」を参照してください。

０：ユーザ指定のSQLを指定しない。

xtrepコマンドのコマンドラインに指定した表からデータを抽出します。

１：ユーザ指定のSQLを指定する。

表式記述ファイルで指定した表からデータを抽出します。

この環境変数に「１」を指定することで，データ抽出を実行するSELECT文のFROM句以降の表式（SQL構文）をユーザが表式記述ファイルに指定できます。

これをデータ抽出時のSQLユーザ指定機能と呼びます。この機能によって，複数の表を結合して抽出したデータを反映先の表へ格納するなど，柔軟にデータ抽出を実行できます。

注意事項

この環境変数に1を指定した場合，次のパラメタを指定してください。指定を省略した場合，JXU7307Eメッセージを出力してエラーになります。

・−ｇオプション

・−ｒオプションまたは−Ｒオプション

この環境変数に１を指定した場合，次のパラメタは指定しないでください。指定した場合，JXU7306Eメッセージを出力してエラーになります。

・−ｗオプション

この環境変数に1を指定した場合，コマンドラインに抽出表名の代わりに表式記述ファイル名を指定します。指定を省略した場合，JXU7300Eを出力してエラーになります。

●ＸＴＬＯＣＡＬＥ　〜｛ｓｊｉｓ｜ｅｕｃ｜ｕｔｆ−8｜ｕｎｋｎｏｗｎ｝　≪ｕｎｋｎｏｗｎ≫

文字コード変換機能を使う場合に，抽出側と反映側で，それぞれの文字コードを指定します。

ｓｊｉｓ：JIS8およびシフトJISコード体系

ｅｕｃ：EUCコード体系

ｕｔｆ−8：UTF-8コード体系

ｕｎｋｎｏｗｎ：コード変換しない

注意事項

OSでサポートされているロケールとこの環境変数の指定値のチェックは行いません。また，指定を誤った場合の動作は保証しません。

OSでサポートされていないロケールの日本語表名は，データ連携できません。

文字コードがUTF-8の場合は，コード変換の有無に関係なく，この環境変数にutf-8を必ず指定してください。

環境変数XTENDSPACEにnodataを指定する場合は，コード変換の有無に関係なく，この環境変数，または環境変数XTDATALOCALEに抽出側の文字コードを必ず指定してください。

●ＸＴＤＡＴＡＬＯＣＡＬＥ　〜｛ｓｊｉｓ｜ｅｕｃ｜ｕｔｆ−8｜ｕｔｆ−16ＢＥ｜ｕｔｆ−16ＬＥ｝

文字コード変換機能を使う場合に，抽出側と反映側で，それぞれの文字コードを指定します。

この環境変数はUTF-16と，UTF-16以外の文字コード間でデータ連携する場合に指定してください。文字コードにUTF-16を指定できるのは，変換対象が表データの場合だけです。表定義情報は変換対象となりません。表定義情報を変換するためには，必ず環境変数XTLOCALEも一緒に指定してください。

ｓｊｉｓ：JIS8およびシフトJISコード体系

ｅｕｃ：EUCコード体系

ｕｔｆ−8：UTF-8コード体系

ｕｔｆ−16ＢＥ：UTF-16コード体系（ビッグエンディアン）

ｕｔｆ−16ＬＥ：UTF-16コード体系（リトルエンディアン）

HiRDB Dataextractorで変換できる文字コードの組み合わせについては，「3.1.4(2)変換できる文字コード」を参照してください。

注意事項

実際のデータと異なる文字コードを指定した場合，動作は保証されません。

反映側のこの環境変数に，utf-16BE，またはutf-16LEを指定してDATファイルを作成する場合，出力ファイルの先頭にBOM（Byte Order Mark）は付きません。

この環境変数を省略した場合，環境変数XTLOCALEに従い文字コード変換します。

環境変数XTENDSPACEにnodataを指定する場合は，文字コード変換の有無に関係なく，この環境変数，または環境変数XTLOCALEに抽出側の文字コードを必ず指定してください。

●ＸＴＵＮＤＥＦ　〜｛ｓｐａｃｅ｜ｓｈａｒｐ｜16進数値文字列｝〔，打ち切り件数〕　≪ｓｐａｃｅ，１００≫

文字コード変換機能を使う場合に，反映側で，未定義コードを検出したときの処置を指定します。

環境変数XTDATAUNDEFも指定した場合，表定義情報中に未定義コードを検出したときに，この環境変数が有効となります。

ｓｐａｃｅ：半角空白（0x2020）に置き換えます。

ｓｈａｒｐ：全角＃に置き換えます。

16進数値文字列：指定された任意の2バイトコードに置き換えます。指定値は，0xで始め，0〜9，a〜fの値を4文字で指定してください。

打ち切り件数　〜＜符号なし整数＞((0〜10000))

変換エラーを検知したあと，処理を続行する場合の打ち切り件数をレコード単位で指定します。したがって，1レコード内で複数変換エラーを検知しても打ち切り件数のカウントは1となります。0を指定した場合，処理は打ち切りません。

次のどちらかの打ち切り件数に，先に到達した時点で処理を打ち切ります。

環境変数XTUTF8UCS4CHKの打ち切り件数

この環境変数の打ち切り件数

環境変数XTDATAUNDEFに打ち切り件数を指定した場合，この環境変数には打ち切り件数を指定できません。

注意事項

この環境変数でsharpを指定した場合，反映側の環境変数XTLOCALEの指定値によって，全角＃のコードは次のように異なります。

・sjisの場合：0x8194

・eucの場合：0xa1f4

・utf-8の場合：0xefbc83

環境変数XTLOCALEで，反映側またはファイル作成側のコード体系にUTF-8を指定した場合は，16進数値文字列にはUTF-8で出力したい値をUCS-2コードに置き換えた値で指定してください。

●ＸＴＤＡＴＡＵＮＤＥＦ　〜｛ｓｐａｃｅ｜ｓｈａｒｐ｜16進数値文字列｝〔，打ち切り件数〕　≪ｓｐａｃｅ≫

文字コード変換機能を使う場合に，反映側で，表データ中に未定義コードを検出したときの処置を指定します。この環境変数は，環境変数XTDATALOCALEを指定した場合に有効となります。

ｓｐａｃｅ：半角空白に置き換えます。

ｓｈａｒｐ：全角＃に置き換えます。

16進数値文字列：指定された任意の文字コードに置き換えます。指定値は，0xで始め，0〜9，a〜fの値を4文字で指定してください。

反映側の環境変数XTDATALOCALE，およびXTDATAUNDEFの指定値と，未定義コード検出時の文字コード変換後の値を次の表に示します。

表2‒11　反映側の環境変数XTDATALOCALE，およびXTDATAUNDEFの指定値と，未定義コード検出時の文字コード変換後の値

反映側XTDATALOCALEの指定値

XTDATAUNDEFの指定値

space

sharp

16進数値文字列

sjis

0x2020

0x8194

指定された任意の文字コード

euc

0x2020

0xa1f4

指定された任意の文字コード

utf-8

0x2020

0xefbc83

UTF-8で出力したい値をUCS-2コードに置き換えた値

utf-16BE

0x3000

0xff03

UTF-16で出力したい値をUCS-2コードに置き換えた値

utf-16LE

0x0030

0x03ff

UTF-16で出力したい値をUCS-2コードに置き換えた値

打ち切り件数　〜＜符号なし整数＞((0〜10000))　≪100≫

変換エラーを検知したあと，処理を続行する場合の打ち切り件数をレコード単位で指定します。したがって，1レコード内で複数変換エラーを検知しても打ち切り件数のカウントは1となります。0を指定した場合，処理は打ち切りません。

次のどちらかの打ち切り件数に，先に到達した時点で処理を打ち切ります。

環境変数XTUTF8UCS4CHKの打ち切り件数

この環境変数の打ち切り件数

この環境変数に打ち切り件数を指定した場合，環境変数XTUNDEFには打ち切り件数を指定できません。

●ＸＴＤＡＴＳＥＰＡＲＡＴＥＲ　〜16進数値文字列

DATファイル作成で，セパレータ文字を変更する場合に指定します。この環境変数に指定した値を，そのままDATファイルに出力します。

16進数値文字列：指定値は，0xで始め，0〜9，a〜fの値を1〜6バイトの範囲で指定してください。

この環境変数とxtrepコマンドの-Rオプションのセパレータ文字を同時に指定した場合は，この環境変数が有効となります。どちらも省略した場合は，次に示す値をDATファイルに出力します。

反映側XTDATALOCALEの指定値

DATファイル出力値

UTF-16BE

0x002c

UTF-16LE

0x2c00

上記以外

0x2c

注意事項

数値やアルファベットなどのデータと同じ値を指定しないでください。DATファイルを読み込むプログラムが誤動作するおそれがあります。

●ＸＴＤＡＴＥＮＣＬＯＳＥ　〜〔｛16進数値文字列｜ｎｏｎｅ｝〕〔，ｄｏｕｂｌｅ〕

DATファイル作成で，囲み文字を変更する場合に指定します。この環境変数に指定した値を，そのままDATファイルに出力します。

囲み文字を出力するデータ型については，「表4-17　列データの記述形式（DAT形式）」を参照してください。

16進数値文字列：指定値は，0xで始め，0〜9，a〜fの値を1〜6バイトの範囲で指定してください。

ｎｏｎｅ：囲み文字を出力しません。

ｄｏｕｂｌｅ：列データ中に囲み文字と同じデータがある場合，その囲み文字を2個連続で出力します。例えば，アポストロフィ（'）が囲み文字の場合は，「''」と2個連続で出力します。pdloadを使って出力ファイルを拡張DAT形式で入力する場合に指定してください。なお，noneを指定した場合，doubleは指定できません。

この環境変数を省略した場合は，次に示す値をDATファイルに出力します。

反映側XTDATALOCALEの指定値

DATファイル出力値

UTF-16BE

0x0022

UTF-16LE

0x2200

上記以外

0x22

注意事項

数値やアルファベットなどのデータと同じ値を指定しないでください。DATファイルを読み込むプログラムが誤動作するおそれがあります。

●ＸＴＤＡＴＣＲＬＦ　〜16進数値文字列

DATファイル作成で，改行文字を変更する場合に指定します。この環境変数に指定した値を，そのままDATファイルに出力します。

16進数値文字列：指定値は，0xで始め，0〜9，a〜fの値を1〜6バイトの範囲で指定してください。

この環境変数を省略した場合は，次に示す値をDATファイルに出力します。

反映側XTDATALOCALEの指定値

反映側OS

DATファイル出力値

UTF-16BE

Windows

0x000d000a

上記以外

0x000a

UTF-16LE

Windows

0x0d000a00

上記以外

0x0a00

上記以外

Windows

0x0d0a

上記以外

0x0a

注意事項

数値やアルファベットなどのデータと同じ値を指定しないでください。DATファイルを読み込むプログラムが誤動作するおそれがあります。

●ＸＴＣＳＥＴＵＳＥ　〜｛ｎｏ｜ｙｅｓ｝　≪ｎｏ≫

HiRDBの文字集合データを，そのままの文字コードで抽出するかどうかを指定します。

ｎｏ：文字集合データを，既定文字集合の文字コードで抽出します。

ｙｅｓ：文字集合データをそのままの文字コードで抽出します。文字集合UTF-16を定義した表を抽出・反映する場合に指定してください。抽出されるデータはUTF-16BEです。

●ＸＴＯＲＡＮＣＳＥＴ　〜｛ｄｅｆａｕｌｔ｜ｕｔｆ−16｝　≪ｄｅｆａｕｌｔ≫

ORACLEのNCHAR列を，UTF-16で抽出するかどうかを指定します。

ｄｅｆａｕｌｔ：NCHAR列を，ORACLE用環境変数のNLS_LANGに指定した値に従い抽出します。

ｕｔｆ−16：NCHAR列をUTF-16で抽出します。ORACLEのNCHAR列を，HiRDBの文字集合列（UTF-16）へ反映する場合に指定してください。抽出されるデータは，UTF-16BE，またはUTF-16LEです。HiRDBへ反映する場合はUTF-16BEです。

●ＸＴＳＱＬＮＣＳＥＴ　〜｛ｄｅｆａｕｌｔ｜ｕｔｆ−16｝　≪ｄｅｆａｕｌｔ≫

SQL ServerのNCHAR列を，UTF-16で抽出するかどうかを指定します。

ｄｅｆａｕｌｔ：NCHAR列をSJISで抽出します。

ｕｔｆ−16：NCHAR列をUTF-16で抽出します。SQL ServerのNCHAR列を，HiRDBの文字集合列（UTF-16）へ反映する場合に指定してください。抽出されるデータはUTF-16LEです。HiRDBへ反映する場合はUTF-16BEです。

●ＸＴＵＴＦ８ＵＣＳ４ＣＨＫ　〜｛ｕｎｄｅｆ｜ｓｋｉｐ｝〔，打ち切り件数〕

次の文字コード変換で，4バイト以上のUnicode（UCS-4）を検知したときの動作を指定します。

UTF-8からSJIS

UTF-8からEUC

UTF-16からSJIS

UTF-16からEUC

この環境変数を指定して該当コードを検知するとJXU7230IまたはJXU7230Eメッセージを出力します。出力メッセージは，1行中の該当コードを検知したすべての列の情報です。また，一つの列中に複数の該当コードを検知した場合，最初の文字のオフセット情報だけを出力します。

ｕｎｄｅｆ：該当コードを検知したとき，2バイトの未定義コードに変換し処理を続行します。

ｓｋｉｐ：該当コードを検知したとき，行レコードをスキップします。

打ち切り件数　〜＜符号なし整数＞((0〜10000))

該当コードを検知したときの打ち切り件数を指定します。打ち切り件数に到達しない場合は，JXU7230Iメッセージを出力して処理を実行し，リターンコード4で終了します。打ち切り件数に到達した場合は，JXU7230Eメッセージを出力して処理を中断しリターンコード12で終了します。0を指定した場合，処理は打ち切りません。

次のどちらかの打ち切り件数に，先に到達した時点で処理を打ち切ります。

環境変数XTUNDEFの打ち切り件数

この環境変数の打ち切り件数

●ＸＴＣＣＮＶＤＭＰＳＩＺＥ　〜<符号なし整数>((0〜2147483647)) ≪0≫

文字コード変換エラー発生時に出力されるJXU7230I，JXU7230Eメッセージの付加情報である，変換前の行データ（ダンプ形式）の出力サイズを指定します。この環境変数の指定値と変換前の行データのサイズのうち，小さい方が実際の出力サイズとなります。この環境変数を省略するか，または0を指定した場合は，変換前の行データをすべて（1行分）出力します。LOB型やBINARY型などの長大データ列を含む表の抽出・反映をする場合は，この環境変数を指定して行データの出力サイズを調整します。

●ＸＴＣＬＭｘｘｘｘ　（ｘｘｘｘ：任意文字列）　　〜＜パス名＞((1〜255けた))

抽出側で，列名記述ファイルの名称を絶対パスで指定します。

●ＸＴＷＨＥｘｘｘｘ　（ｘｘｘｘ：任意文字列）　　〜＜パス名＞((1〜255けた))

抽出側で，表式記述ファイルの名称を絶対パスで指定します。

●ＸＴＬＣＫｘｘｘｘ　（ｘｘｘｘ：任意文字列）　　〜＜パス名＞((1〜255けた))

抽出側で，排他情報ファイルの名称を絶対パスで指定します。

●ＸＴＴＢＬｘｘｘｘ　（ｘｘｘｘ：任意文字列）　　〜＜パス名＞((1〜255けた))

抽出側で，表名情報ファイルの名称を絶対パスで指定します。表名情報ファイルの詳細については，「2.2.4(7)表名情報ファイルの設定」を参照してください。

●ＸＴＬＰＲＭｘｘｘｘ　（ｘｘｘｘ：任意文字列）　　〜＜パス名＞((1〜255けた))

反映側で，pdloadコマンドライン情報を記述したファイルの名称を絶対パスで指定します。

ファイルの詳細については，「2.2.4(8)pdloadコマンドライン情報ファイルの設定」を参照してください。

●ＸＴＰＤＳＲｘｘｘｘ　（ｘｘｘｘ：任意文字列）　〜＜パス名＞((1〜255けた))

反映側で，pdload制御情報ファイルのsource文情報を記述したファイルの名称を絶対パスで指定します。

ファイルの詳細については，「2.2.4(9)pdload制御情報ファイルsource文情報ファイルの設定」を参照してください。

●ＴＺ　〜＜文字列＞

エラーログファイルに出力する日付・時刻情報のタイムゾーンを指定します。HiRDBとHiRDB Dataextractorでこの環境変数の設定を合わせてください。設定が異なると，エラーログファイルおよびsyslogに出力されるHiRDBとHiRDB Dataextractorのメッセージ時刻がずれることがあります。

この環境変数を省略すると，OSの設定値を仮定します。

●ＸＴＰＣＨＫＴＩＭＥ　〜＜符号なし整数＞((30〜600)) ≪180≫

指定値は，30の倍数で指定します。指定値が30の倍数でない場合は30の整数倍に切り上げた値を使用します。

実行する機能によって，次のどちらかの監視時間を指定します。

HiRDB Dataextractor連携の抽出機能の場合

相手システムに相手確認要求をしてから，相手システムの確認通知を取得するまで。

上記以外の場合

相手確認開始から，相手システムの確認通知を取得するまで。

●ＸＴＸＢＵＦＫＩＮＤ　〜｛０｜１｝

抽出時のバッファサイズの取得方式を指定します。

０：抽出時のバッファサイズを，反映する列の定義長で確保する場合に指定します。

0を指定すると，確保するバッファサイズを節約できます。

次の場合に，0を指定することをお勧めします。

抽出側定義長＞反映側定義長でかつ，文字コード変換をしない場合

抽出側定義長＞反映側定義長でかつ，文字コード変換後の文字列が長くなる場合

注意事項

上記以外の場合に0を指定すると，不要なバッファが確保されたり，抽出時に一部の文字列が切り捨てられたりするおそれがあります。

１：抽出時のバッファサイズを，抽出する列の定義長と，反映する列の定義長のうち，大きい方の定義長で確保する場合に指定します。

抽出側定義長＞反映側定義長でかつ，文字コード変換後の文字列が短くなる場合に，1を指定することをお勧めします。

注意事項

抽出側と反映側の両方にバージョン08-03以降のHiRDB Dataextractorがインストールされている場合だけ1を指定できます。それ以外の場合は，1を指定しても0を指定したとみなされます。

BLOB，BINARY属性の列へ反映する場合は，環境変数XTLOBBUFSIZEに指定した値でバッファサイズを確保します。なお，反映情報ファイルに個別にバッファサイズを指定した場合は，反映情報ファイルに指定した値が優先されます。

環境変数XTLOBBUFSIZEおよび反映情報ファイルにバッファサイズを指定しなかった場合は，反映する列の定義長をバッファサイズとして適用します。

文字コード変換をする場合で，変換後の文字列が短くなるときは，環境変数XTLOBBUFSIZEおよび反映情報ファイルに指定する値に，反映したいデータに対する文字コード変換前のサイズを指定してください。

HiRDB Dataextractorのバージョンが08-02以前の場合は，ユーザの操作に関係なく，0が仮定されたものとしてバッファサイズが取得されていましたが，HiRDB Dataextractorのバージョンが08-03以降の場合，指定を省略したときは，1が仮定されます。

●ＸＴＥＮＤＳＰＡＣＥ　〜｛ｄａｔａ｜ｎｏｄａｔａ｝

文字コード変換をしない場合の，固定長文字列データ型の空白の扱い方を指定します。

ｄａｔａ：切り捨てた文字がすべて空白の場合でも，切り捨ての発生として扱う場合に指定します。

ｎｏｄａｔａ：切り捨てた文字がすべて空白の場合は，切り捨ての発生として扱わない場合に指定します。

注意事項

nodataは，次の条件をすべて満たしたときだけ指定できます。

環境変数XTXBUFKINDに1を指定する

抽出側の環境変数XTLOCALE，またはXTDATALOCALEで文字コードを指定する

●ＰＤＤＩＲ

抽出側では，抽出側のHiRDBのHiRDB運用ディレクトリを絶対パス名で指定します。

反映側では，反映側のHiRDBのHiRDB運用ディレクトリを絶対パス名で指定します。

●ＰＤＣＯＮＦＰＡＴＨ

抽出側では，抽出側のHiRDBのHiRDBシステム定義ファイルを格納するディレクトリを絶対パス名で指定します。

反映側では，反映側のHiRDBのHiRDBシステム定義ファイルを格納するディレクトリを絶対パス名で指定します。

●ＰＤＵＳＥＲ

抽出側では，抽出側のHiRDBに接続するユーザ名とパスワードを"ユーザID"／"パスワード"の形式で指定します。

なお，指定するユーザは抽出する表に対してHiRDBのSELECT権限を持っている必要があります。

反映側では，反映側のHiRDBに接続するユーザ名とパスワードを"ユーザID"／"パスワード"の形式で指定します。

なお，指定するユーザは反映する表に対してHiRDBのINSERT権限を持っている必要があります。また，表のデータをいったん削除して反映する場合は，HiRDBのINSERT権限およびDELETE権限を持っている必要があります。

●ＰＤＨＯＳＴ

抽出側で，抽出側のHiRDBのシステムマネジャのホスト名を指定します。

●ＰＤＮＡＭＥＰＯＲＴ

抽出側で，抽出側のHiRDBシステムのポート番号を指定します。

●ＰＤＢＬＫＦ

抽出側で，ブロック転送の行数を指定します。

この環境変数の指定によりHiRDBからの抽出時間を短縮できる場合があります。詳細は，マニュアル「HiRDB UAP開発ガイド」を参照してください。

●ＰＤＦＥＳＨＯＳＴ

抽出側で，フロントエンドサーバのホスト名を指定します。

●ＰＤＳＥＲＶＩＣＥＧＲＰ

抽出側で，フロントエンドサーバのサーバ名を指定します。

●ＰＤＣＬＴＰＡＴＨ

抽出側で，HiRDBのSQLトレース情報を取得するSQLトレースファイルの，格納先ディレクトリを指定します。PDCLTPATHの指定がない場合は，カレントディレクトリの下に出力されます。

●ＰＤＳＱＬＴＲＡＣＥ

抽出側で，HiRDBのSQLトレース情報を取得する場合に指定します。SQLトレースファイルのサイズを指定します。HiRDBからのデータの抽出時，HiRDB DataextractorはHiRDBのSQL文を発行してデータを抽出します。このため， SQLトレース情報を取得しておくと，HiRDBでのデータの抽出エラー発生時に，障害対策に利用できます。SQLトレースファイルについては，マニュアル「HiRDB システム運用ガイド」を参照してください。

●ＰＡＴＨ

抽出側で，/opt/HIRDBXT/binを追加します。

●ＳＨＬＩＢ＿ＰＡＴＨ

抽出側のHiRDB，ORACLE，またはSQL Serverの共用ライブラリが格納されているディレクトリを絶対パスで，xtrepコマンドを投入するユーザ環境または環境変数情報設定ファイルに指定します。

なお，ORACLEからデータを抽出する場合は，32ビットのクライアントライブラリが格納された共用ライブラリのパスを指定してください。

この環境変数は，適用OSがSolaris，LinuxおよびAIXの場合は，値を指定しても無視されます。

●ＬＤ＿ＬＩＢＲＡＲＹ＿ＰＡＴＨ　〜＜パス名＞　

抽出側のHiRDB，ORACLE，またはSQL Serverの共用ライブラリが格納されているディレクトリを絶対パスで，xtrepコマンドを投入するユーザ環境または環境変数情報設定ファイルに指定します。

なお，ORACLEからデータを抽出する場合は，32ビットのクライアントライブラリが格納された共用ライブラリのパスを指定してください。

この環境変数は，適用OSがSolarisまたはLinuxの場合にだけ有効となります。

●ＬＩＢＰＡＴＨ　〜＜パス名＞

抽出側のHiRDB，ORACLE，またはSQL Serverの共用ライブラリが格納されているディレクトリを絶対パスで，xtrepコマンドを投入するユーザ環境または環境変数情報設定ファイルに指定します。

なお，ORACLEからデータを抽出する場合は，32ビットのクライアントライブラリが格納された共用ライブラリのパスを指定してください。

この環境変数は，適用OSがAIXの場合にだけ有効となります。

●ＬＡＮＧ

抽出側では，抽出側のHiRDBで各国文字を使用している場合に，使用している文字コードに合わせて指定します。

反映側では，反映側のHiRDBで各国文字を使用している場合に，使用している文字コードに合わせて指定します。メインフレーム側のDBのデータをXDM/XTを使用してHiRDBに反映する場合は，XDM/XTのJXUMCTL制御文のCONVERT文で指定された変換後の文字種別と同じでなければなりません。異なった文字種別を指定した場合，結果は保証されません。

ファイル作成側では，ファイル作成側で各国文字を使用している場合に，使用している文字コードに合わせて指定します。

省略時は，次のプロファイルで定義された文字種別を仮定します。

抽出側：コマンド実行ユーザのプロファイル

反映側：inetd定義中の実行ユーザのプロファイル

注意事項

LANG環境変数を指定しても，LC_ALLまたはLC_*環境変数の指定がある場合には，こちらの設定が有効となり，LC_ALLまたはLC_*環境変数の指定がない場合にLANG環境変数の設定が有効となります。

ただし，LC_ALLまたはLC_*環境変数については，システムによってデフォルト値が指定されている場合があります。

システムが指定したLC_ALLまたはLC_*環境変数の指定値を変更する必要がある場合は，LANG環境変数の代わりにLC_ALLまたはLC_*環境変数を指定してください。

LANG環境変数の設定が必要なコマンドについては，これらを考慮して実行するようにしてください。

適用OSがWindowsの場合は，LANG環境変数を指定しても無視されます。

(3)　HiRDB Dataextractorの環境変数情報設定ファイルでの環境変数の指定方法

HiRDB Dataextractorの環境変数情報設定ファイルでの環境変数の指定方法を次に示します。

形式

ｓｅｔ　環境変数＝環境変数設定値

記述規則

一つのset文は１行で記述します。

"＝"の前後には空白を入れないでください。

注釈は，"＃"以降その行の終わりまでとします。

記述例

set PDDIR=/HiRDB
set PDCONFPATH=/HiRDB/conf
set PDUSER="user01"/"user01"
set LANG=ja_JP.SJIS
set XTPORTNO=20052

(4)　通常とは異なる場合の環境変数の指定方法

ここでは，通常の指定方法とは異なる場合の，環境変数の指定方法について説明します。

通常とは異なる場合の環境変数の指定方法を，次の表に示します。

表2‒12　通常とは異なる場合の環境変数の指定方法

プロトコル

適用OS

HiRDB Dataextractorの起動方法

環境変数の指定方法

備考

TCP/IP

HP-UX

Solaris

Linux

AIX

inetdによる自動起動

inetd.confに指定します。

指定例1を参照してください。

Windows

サービスによる自動起動

hirdbxt.iniに指定します。

−

OSI

HP-UX

localrcまたはrcによる自動起動

localrcまたはrcに指定します。

指定例2を参照してください。

xtstartコマンドによる手動起動

実行するユーザ環境でsetenvを指定します。

指定例3を参照してください。

Windows

Solaris

Linux

AIX

−

−

−

（凡例）

−：指定は特にありません。

指定例1

/etc/inetd.confの設定例

hirdbxt stream tcp nowait user01 /bin/env env XTTEMPNAM=0
/opt/HIRDBXT/bin/pxtcntl /usr/home/user01/xtenv1

注　1行で指定します。

なお，環境変数を指定した場合は，pxtcntlは指定しません。

指定例2

/etc/localrcの設定例

/bin/env XTTEMPNAM=0 /opt/HIRDBXT/bin/xtstart
/opt/HIRDBXT/HIRDB_conf /opt/HIRDBXT/OSI_conf

注　1行で指定します。

指定例3

xtstartコマンドの設定例

setenv XTTEMPNAM=0
/opt/HIRDBXT/bin/xtstart /opt/HIRDBXT/HIRDB_conf /opt/HIRDBXT/OSI_conf

注　1行ごとに送信します。

（凡例）

＿（下線部分）：通常とは異なる場合の環境変数の指定方法を示します。

2.2.4　HiRDB Dataextractorを使用するために設定するファイル

HiRDB Dataextractorを使用するために設定するファイルについて，説明します。

設定するファイルは，実行する機能および使用するプロトコルによって異なります。

HiRDB Dataextractorを使用するために設定するファイルを，次の表に示します。

なお，ファイルを設定するホストはHiRDB Dataextractorをインストールするホストと同じです。詳細については，「表2-2　HiRDB Dataextractorをインストールするホスト」を参照してください。

表2‒13　HiRDB Dataextractorを使用するために設定するファイル

ファイル名

内容

種別

抽出側

反映側

ファイル作成側

Extractor

XDM/XT

Extractor

XDM/XT※1

HiRDB Dataextractorの環境変数情報設定ファイル

（任意のファイル名）

HiRDB Dataextractorの環境変数を指定します。

−

◎

◎

◎

◎

/etc/services※2

ポート番号を設定します。

−

◎ TCP

◎ TCP

◎ TCP

◎ TCP

/etc/inetd.conf※2

HiRDB Dataextractorの起動を設定します。

−

◎ TCP

◎ TCP

◎ TCP

◎ TCP

xtstartコマンド実行シェル（任意のファイル名）

HiRDB Dataextractorの起動を設定します。

−

○ OSI

−

○ OSI

○ OSI

通信構成定義情報ファイル

（任意のファイル名）

通信構成定義を設定します。

−

◎ OSI

−

◎ OSI

◎ OSI

/etc/hosts

反映先のホスト名を設定します。

◎ TCP

−

−

−

−

列名記述ファイル

表式記述ファイル

（任意のファイル名）

抽出条件を指定します。

詳細については，「4.2.2　xtrepコマンド」，「5.1.2　xtrepOコマンド」，または「6.1.2　xtrepSコマンド」を参照してください。

○

○

−

−

−

表名情報ファイル

（任意のファイル名）

SELECT文のWHERE句までの表式を指定します。

−

○

−

−

−

ナル値情報ファイル

（任意のファイル名）

ナル値の既定値を設定します。

詳細については，「4.2.2　xtrepコマンド」，「5.1.2　xtrepOコマンド」，または「6.1.2　xtrepSコマンド」を参照してください。

○

−

−

−

−

排他情報ファイル

（任意のファイル名）

データ抽出時の排他情報を設定します。

詳細については，「4.2.2　xtrepコマンド」，または「5.1.2　xtrepOコマンド」を参照してください。

○

○

−

−

−

反映情報ファイル

（任意のファイル名）

データ型を変換する列情報とデータ型を設定します。

詳細については，「4.2.2　xtrepコマンド」，「5.1.2　xtrepOコマンド」，または「6.1.2　xtrepSコマンド」を参照してください。

○

−

−

−

−

SQLトレースファイル

SQLトレース情報を取得します。

詳細については，「2.2.3　環境変数の設定」の環境変数PDCLTPATHを参照してください。

○

○

−

−

−

pdloadコマンドライン情報ファイル

（任意のファイル名）

HiRDBのデータベース作成ユティリティ（pdload）のコマンドラインパラメタを設定します。

−

−

○

○

−

pdload制御情報ファイルsource文情報ファイル

（任意のファイル名）

HiRDBのデータベース作成ユティリティ（pdload）のパラメタである制御情報ファイル中に記述するsource文を設定します。

−

−

○

○

−

（凡例）

◎：必要です。

○：任意です。

−：不要です。

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

OSI：OSIプロトコル使用時に設定します。

Extractor：HiRDB Dataextractorと連携して，データの抽出・反映をする場合

XDM/XT：XDM/XTを使用して，メインフレーム側DBとHiRDB間のデータの抽出，データの反映，および順編成データセットの作成をする場合

注※1

OSIプロトコル使用時で，データの転送先のサーバ（フロントエンドサーバまたはバックエンドサーバ）とXDM/XTとの間がOSIプロトコルで接続されていて，かつシステムマネジャとXDM/XTとの間がOSIプロトコルで接続されていない場合には，データの転送先のサーバとシステムマネジャ間はTCP/IPによって通信します。このためこの場合のシステムマネジャ側には，OSIプロトコル使用時であっても，TCP/IPで使用するファイル（/etc/services，/etc/inetd.conf）を設定します。OSIプロトコルで使用するファイル（/etc/localrc，通信構成定義情報ファイル）の設定は，システムマネジャ側には必要ありません。

注※2

適用OSがUNIXの場合のファイル名です。適用OSがWindowsの場合については，「付録B　Windowsの機能差異」を参照してください。

(1)　HiRDB Dataextractorの環境変数情報設定ファイルの設定

適用OSがUNIXの場合，HiRDB Dataextractorの環境変数情報設定ファイルに環境変数を指定します。詳細については，「2.2.3　環境変数の設定」を参照してください。

適用OSがWindowsの場合については，「付録B　Windowsの機能差異」を参照してください。

(2)　/etc/servicesの設定

適用OSがUNIXの場合，TCP/IPプロトコル使用時は，/etc/servicesにHiRDB Dataextractorのサービス名称とポート番号を設定する必要があります。

ポート番号にはネットワーク内で統一した値を指定してください。ただし，ほかのサービスで使用していない値を指定してください。

適用OSがWindowsの場合については，「付録B　Windowsの機能差異」を参照してください。

登録するエントリの例を次に示します。

/etc/services

# ＠(#) services  1.2  30/06/95
#
#UNIX specific services, Internet style
ftp   21/tcp
                ：
                ：
hirdbxt 20052/tcp  #HiRDB Dataextractor...追加

(3)　/etc/inetd.confの設定

適用OSがUNIXの場合，TCP/IPプロトコル使用時，HiRDB Dataextractorはコンフィギュレーションファイル/etc/inetd.confによって起動されます。このため，/etc/inetd.confにHiRDB Dataextractorについて設定する必要があります。

なお，/etc/inetd.confの内容を変更した場合には，マシンの再起動またはスーパユーザによるシグナルの発行が必要です。

適用OSがWindowsの場合，/etc/inetd.confの設定は必要ありません。

/etc/inetd.confに設定する内容を，次の表に示します。

表2‒14　/etc/inetd.confに設定する内容

フィールド名

設定内容

service name

/etc/servicesファイルに設定した，HiRDB

Dataextractorのサービス名を指定します。（任意）

socket type

stream（固定）

protocol

tcp（固定）

wait/nowait

nowait（固定）

user

UNIXのログインユーザ名を指定します。（任意）※

server program

/opt/HIRDBXT/bin/pxtcntl（固定）

server program arguments

第1引数：pxtcntl（固定）

第２引数：環境変数情報設定ファイル名を絶対パス名で指定します。

注※

指定したユーザでHiRDB Dataextractorが起動されます。次の点に注意してください。

スーパユーザ以外を指定した場合，HiRDB Dataextractorで障害が発生したときにcoreダンプが出力されません。

データを抽出してファイルを作成する場合，作成対象のファイル（LOB入力ファイルを含む）がすでに存在するときは，書き込み権限を持っている必要があります。なお，作成したファイルに対するファイルモードは，環境変数XTFPERMIT，XTDPERMITで指定できます。環境変数の設定方法については「2.2.3(2)環境変数の設定方法」を参照してください。

XDM/XTと連携してORACLEからデータを抽出する場合，ORACLEに登録されているユーザである必要があります。

/etc/inetd.confの設定例

hirdbxt stream tcp nowait user01
        /opt/HIRDBXT/bin/pxtcntl
        pxtcntl /usr/home/user01/xtenv1

注　1行で指定します。

/etc/inetd.conf変更時のシグナルの発行例

kill -HUP inetdのプロセスID

(4)　xtstartコマンド実行シェルの設定

OSIプロトコルを使用してHiRDB Dataextractorを自動開始するときは，xtstartコマンド実行シェルの設定が必要です。設定方法については，「7.2.2(1)(a)自動開始」を参照してください。

(5)　通信構成定義情報ファイルの設定

OSIプロトコル使用時には，通信するために必要な情報を通信構成定義情報ファイルに設定する必要があります。

設定の形式を次に示します。

形式

ｓｅｔ　Ｔ＿ｓｅｌｅｃｔｏｒ＝自ホストのＴセレクタ値

記述規則

一つのset文は1行で記述します。

1行にset文は1回しか指定できません。

"＝"の前後には空白を入れないでください。

注釈は，"＃"以降その行の終わりまでとします。

●Ｔ＿ｓｅｌｅｃｔｏｒ＝自ホストのＴセレクタ値　〜＜16進数＞((2〜64けた))

自システムのTセレクタ値を指定します。x’16進数’，またはX’16進数’の形で指定します。

XNFネットワーク定義との関係

通信構成定義とVOS3 XNF E2ネットワーク定義との関係について説明します。通信構成定義のset文のT_selectorオペランドで指定される自ホストのセレクタ値は，XNF E2ネットワーク定義のULE文のT_SELECTORオペランドのTセレクタ値に当たります。

VOS3　XNF E2ネットワーク定義の詳細については，マニュアル「XNF E2ネットワーク定義」を参照してください。

(6)　/etc/hostsの設定

適用OSがUNIXの場合，TCP/IPプロトコル使用時は，抽出側の/etc/hostsに，送信対象のホスト名を記述する必要があります。

抽出したデータを表に反映する場合は，次のサーバのあるホスト名を指定します。

HiRDB/シングルサーバの場合はシングルサーバ

HiRDB/パラレルサーバの場合はシステムマネジャ

抽出したデータからファイルを作成する場合は，ファイルの作成先のホスト名を指定します。

適用OSがWindowsの場合については，「付録B　Windowsの機能差異」を参照してください。

登録するエントリの例を次に示します。

/etc/hosts

       ：
       ：
160.16.150.120 HOST2
       ：
       ：

(7)　表名情報ファイルの設定

表名情報ファイルは，XDM/XTと連携してHiRDBからデータを抽出する際に，発行するSQLをユーザ任意に指定する機能を使う場合に，必要に応じて，抽出側に設定し，環境変数XTTBLxxxxにそのファイル名を指定します。

表名情報ファイルには，SELECT文のWHERE句までの表式を指定します。

SELECT文での表式の指定方法については，マニュアル「HiRDB SQLリファレンス」を参照してください。

(8)　pdloadコマンドライン情報ファイルの設定

pdloadコマンドライン情報ファイルは，HiRDBへデータを反映する場合に，HiRDBのデータベース作成ユティリティ（pdload）のパラメタをユーザ任意に指定する機能を使うとき，必要に応じて，反映側に設定し，環境変数XTLPRMxxxxにそのファイル名を指定します。

pdloadコマンドライン情報ファイルには，pdloadのコマンドラインパラメタを指定します。ただし，次のパラメタは指定しないでください。指定した場合，動作は保証されません。

反映表名（〔認可識別子.〕表識別子）

制御情報ファイル名

−ｂオプション（バイナリ形式データ入力）

−ｋオプション（BLOBデータ形式）

−ｖオプション（ナル値情報）

−Ｗオプション（データベース再編成ユティリティ生成バイナリ形式データ入力）

−ｃオプション（列構成情報ファイル情報）

コマンドラインパラメタの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(9)　pdload制御情報ファイルsource文情報ファイルの設定

pdload制御情報ファイルsource文情報ファイルは，HiRDBへデータを反映する際に，pdloadのパラメタをユーザ任意に指定する機能を使う場合に，必要に応じて，反映側に設定し，環境変数XTPDSRxxxxにそのファイル名を指定します。

pdload制御情報ファイルsource文情報ファイルには，pdloadのパラメタである制御情報ファイル中に記述するsource文を記述します。ただし，次のパラメタは指定しないでください。指定した場合，動作は保証されません。

RDエリア名

サーバ名，ホスト名

入力ファイル名

エラー情報ファイル名

2.2.5　ODBC環境の設定（SQL Serverを使用する場合）

ODBCドライバを使用してデータ連動する場合，HiRDB Dataextractorを実行する前に，ODBC環境を設定する必要があります。

ここでは，ODBCドライバの設定内容について説明します。

(1)　ODBCデータソースの作成

ODBCデータソースの作成手順を次に示します。

ODBCデータソースアドミニストレータを実行します。

Windows 2000，Windows Server 2003，Windows Server 2008の場合

「コントロールパネル」から［管理ツール］−［データソース(ODBC)］の順に選択します。

Windows XPの場合

「コントロールパネル」から［パフォーマンスとメンテナンス］−［管理ツール］−［データソース(ODBC)］の順に選択します。

クラシック［スタート］メニューをご利用の場合は，Windows 2000の場合と同じ順に選択します。

［システムDSN］タブを選択し，［追加...］ボタンをクリックします。

HiRDB Dataextractorで使うデータソース名称（DSN）を，システムDSNとして作成します。

SQL ServerのODBCドライバを選択し，［完了］ボタンをクリックします。

(2)　ODBCデータソースを作成するときの注意点

ODBCデータソースを作成するときは，次の点に注意してください。

［SQL Serverが，ログインIDの権限の確認を行う方法は？］で，次の各項目を選択した場合の処理を次に示します。

［ネットワークへのログインIDで，Windowsの認証メカニズムを使う］を選択した場合

SQL Server接続ユーザIDおよびパスワードは無視されます。

［ユーザーが入力するSQL Server用のログインIDとパスワードを使う］を選択した場合

SQL Server接続ユーザIDおよびパスワードを使用してSQL Serverにアクセスします。

接続対象にできるのは，［規定のデータベースを以下のものに変更する］で選択したデータベースに作成した表だけです。

2.3　実行前の準備

HiRDB Dataextractorを実行する前に必要な，表の準備，およびデータ転送の準備について説明します。

2.3.1　表の準備

HiRDB Dataextractorを実行する場合，抽出したデータを反映するためのHiRDBの表を用意しておく必要があります。用意する表には，次の定義が必要です。

CREATE SCHEMA（スキーマ定義）

CREATE TABLE（表定義）

CREATE INDEX（インデクス定義）

GRANT INSERT（INSERT権限定義）

GRANT DELETE（DELETE権限定義）

定義の詳細については，マニュアル「HiRDB SQLリファレンス」を参照してください。

表を定義するときには，HiRDB Dataextractorで抽出するデータの範囲や順序を意識する必要があります。また，反映側のHiRDBでのデータの操作内容なども考慮する必要があります。

2.3.2　データ転送の準備

(1)　HiRDB，ORACLE，またはSQL Serverからデータを抽出してHiRDBヘ反映する場合，およびHiRDB，ORACLE，またはSQL Serverからデータを抽出してファイルを作成する場合

HiRDB，ORACLE，またはSQL ServerのDBからデータを抽出してHiRDBのDBヘ反映する場合，およびHiRDB，ORACLE，またはSQL ServerのDBからデータを抽出してファイルを作成する場合は，TCP/IPの通信プロトコルを使用します。このため，次の指定が必要です。

反映先またはファイル作成先のホスト名の指定（抽出側の/etc/hostsに登録する）

反映側またはファイル作成側のHiRDB Dataextractorのポート番号の指定（反映側またはファイル作成側の/etc/servicesに登録する）

指定方法については，「2.2.4　HiRDB Dataextractorを使用するために設定するファイル」を参照してください。

(2)　XDM/XTを使用した，メインフレーム側のDBとHiRDB，ORACLE間の抽出・反映の場合，およびメインフレーム側のDBからファイルを作成する場合

次の場合には，XNFまたはXNF E2での通信環境の設定が必要です。詳細については，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

XDM/RDからデータを抽出して，HiRDBへ反映またはファイルを作成する場合

順編成データセットからデータを抽出して，HiRDBへ反映またはファイルを作成する場合

HiRDB，またはORACLEからデータを抽出して，XDM/RDへ反映または順編成データセットを作成する場合

3　データの抽出，反映，ファイルの作成

データの抽出，反映，およびファイルの作成について説明します。

3.1　データの抽出（HiRDB）

HiRDB Dataextractorのデータの抽出とは，DBからデータを抽出し，反映側システムへ送信するまでをいいます。そのときに，必要なデータだけを抽出したり，抽出したデータに任意のフィールドを追加したりできます。

ここでは，HiRDBのDBからデータを抽出して，HiRDBのDBヘデータを反映する場合について説明します。XDM/RDのDBからデータを抽出してHiRDBのDBヘデータを反映する場合，またはHiRDBのDBからデータを抽出してXDM/RDのDBヘデータを反映する場合については，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

データ抽出の流れを，次の図に示します。

図3‒1　データ抽出の流れ

3.1.1　必要なデータの抽出

HiRDBのDBからデータを抽出する場合は，xtrepコマンドを使用します。xtrepコマンドで，抽出する表の名称や抽出方法を指定して，必要なデータだけを抽出できます。

HiRDB Dataextractorは，抽出したデータを反映対象の表の左の列から順に対応づけて反映します。このため，抽出対象の表と反映対象の表とで表の形式（列数，列の並び順）が異なる場合は，xtrepコマンドを使用して反映対象の表の形式に合わせてデータを抽出する必要があります。

HiRDB Dataextractorでは次の抽出ができます。

表単位の抽出

抽出する列の選択，並べ替え

抽出する行の選択，並べ替え

行単位インタフェースでの抽出

ナル値の既定値の選択

繰返し列の抽出

抽象データ型の列の抽出

(1)　表単位の抽出

同一形式の表から，同一形式の表ヘ表単位に抽出できます。

例を次に示します。

（例）

抽出側の受注表を，反映側の受注表に反映します。

抽出側の表と反映側の表とは，形式，表名，列名などすべて同一です。

表単位の抽出例を次の図に示します。

図3‒2　表単位の抽出

(2)　抽出する列の選択，並べ替え

抽出する列を選択したり，並べ替えたりして抽出できます。

列の選択や並べ替えは，HiRDBの次のSQLで指定します。

SELECT文の選択式

xtrepコマンドでSELECT文の選択式を記述したファイルの名称を指定します。

このファイルを列名記述ファイルと呼びます。

例を次に示します。

（例）

受注表から次の列を選択し，並べ替えて反映します。

商品コード

受注量

伝票番号

抽出する列の選択や並べ替えの例を次の図に示します。

図3‒3　抽出する列の選択，並べ替え

(3)　抽出する行の選択，並べ替え

抽出する行を選択したり，任意の列のデータの昇順または降順に行を並べ替えたりして抽出できます。

行の選択や並べ替えは，HiRDBの次のSQLで指定します。

SELECT文のWHERE句，ORDER BY句

行を選択して抽出する場合は，SELECT文のWHERE句で選択する条件を指定します。行を並べ替えて抽出する場合は，SELECT文のORDER BY句でソートのキーや並べ替え方法を指定します。

xtrepコマンドでSELECT文のWHERE句，ORDER BY句を記述したファイルの名称を指定します。

このファイルを表式記述ファイルと呼びます。

例を次に示します。

（例）

受注表から次の行を選択し，並べ替えて反映します。

受注量が10以上の行を抽出します。

得意先コードの昇順に並べ替えます。

抽出する行の選択や並べ替えの例を次の図に示します。

図3‒4　抽出する行の選択，並べ替え

(4)　行単位インタフェースでの抽出

FIX属性の表から抽出する場合，行単位インタフェースで抽出できます。行単位インタフェースで抽出すると，列ごとに検索するオーバヘッドがなくなるため，処理性能を向上できます。

行単位インタフェースでの抽出は，HiRDBの次のSQLで指定します。

SELECT文の選択式（ROW指定）

xtrepコマンドでSELECT文の選択式を指定した列名記述ファイルの名称を指定します。

例を次に示します。

（例）

抽出側の受注表を，行単位インタフェースで反映側の受注表に反映します。

抽出側の表と反映側の表とは，形式，表名，列名などすべて同一です。

行単位インタフェースでの抽出例を次の図に示します。

図3‒5　行単位インタフェースでの抽出

(5)　ナル値の既定値の選択

データの抽出時，抽出したデータがナル値の場合は，HiRDB Dataextractorは抽出したデータにHiRDB Dataextractorのナル値の既定値を設定します。データの反映時は，HiRDB Dataextractorは抽出データとHiRDB Dataextractorのナル値の既定値とを比較して，一致した場合にナル値を設定します。該当する列に非ナル値制約がある場合は，ナル値の既定値をデータとして反映します。

このため，抽出するデータ中にHiRDB Dataextractorのナル値の既定値と同じ値がある場合は，ナル値の既定値を変更する必要があります。ナル値の既定値の変更は，xtrepコマンドの−vオプションのナル値情報ファイルに指定します。

HiRDB Dataextractorのナル値の既定値（−vオプション省略時のナル値の既定値），およびナル値情報ファイルでの指定によって設定されるナル値の既定値については，「表4-11　ナル値の既定値」を参照してください。

例を次に示します。

（例）

文字列データのナル値の既定値を変更します。

抽出対象の列CHAR01は，ナル値を既定値のまま使用します。この場合，データに’##…#’があるときは，その値にもナル値が設定されます。

抽出対象の列CHAR02は，ナル値の既定値を空白に変更します。この場合，データに空白があるときはその値にもナル値が設定されます。

抽出対象の列CHAR03は，ナル値の既定値を定数’FFFF’に変更します。この場合，データに定数で指定した値と同じ値があるときは，その値にもナル値が設定されます。

ナル値の既定値の変更例を次の図に示します。

図3‒6　ナル値の既定値の変更

HiRDB Dataextractorが仮定するナル既定値の省略時仮定値，およびナル値情報ファイルによるナル既定値の指定だけでは，抽出表の実データがナル既定値と同じ場合にナル値として反映されてしまいます。そこで，次のどちらかを実行することで，実データをナル値として反映することを防ぎます。

ナル値の既定値の省略仮定値変更

抽出データへのナル値判定情報の追加

(a)　ナル値の既定値の省略仮定値変更

次に示すデータ型（データとして指定できない範囲の値があるもの）については，HiRDB Dataextractorが仮定するナル既定値の省略時仮定値として，実データとして指定できない範囲の値を設定することによって，実データをナル値として反映することを防ぎます。

DECIMAL

DATE

INTERVAL YEAR TO DAY

TIME

INTERVAL HOUR TO SECOND

TIMESTAMP

なお，その他のデータ型についてはデータとして指定できない値がないため，従来通り運用上存在しない値をナル既定値として設定する必要があります。

(b)　抽出データへのナル値判定情報の追加

ナル既定値を使用しないで，抽出データにナル値を判定するための情報を追加することによって，実データがナル値として反映されることを防ぎます。

なお，抽出データにナル値判定情報を追加した場合のデータ形式はデータベース作成ユティリティ（pdload）の−Wオプション指定時の入力データ形式となります。

(6)　繰返し列の抽出

HiRDB Dataextractorでは，繰返し列を抽出および反映対象にできます。

繰返し列を使用する場合の，次の項目について説明します。

繰返し列がある場合の，抽出側と反映側との列の組み合わせ

繰返し列のデータ形式およびナル値反映方法の指定

データ形式およびナル値反映方法の指定時の注意事項

繰返し列のファイル出力時のデータ形式

(a)　繰返し列がある場合の，抽出側と反映側との列の組み合わせ

繰返し列がある場合の，抽出側と反映側との列の組み合わせの可否を，次の表に示します。

表3‒1　繰返し列がある場合の抽出側と反映側との列の組み合わせの可否

抽出側の列

反映側の列

要素数

対応

繰返し列以外

繰返し列以外

−

○

繰返し列

全要素

−

×

特定要素

−

−

繰返し列

全要素

繰返し列以外

−

×

繰返し列

全要素

抽出側＝反映側

○

抽出側＜反映側

×

抽出側＞反映側

×

特定要素

−

−

特定要素

繰返し列以外

−

○

繰返し列

全要素

−

×

特定要素

−

−

（凡例）

要素数：繰返し列の要素の数を示します。

対応：HiRDB Dataextractorのとる処置を示します。

○：正常に処理します。

×：処理を終了します。

−：該当しません。

(b)　繰返し列のデータ形式およびナル値反映方法の指定

繰返し列を使用する場合，次の指定によって，繰返し列をファイルに出力するときのデータ形式およびナル値反映方法を指定できます。

環境変数XTARRAY

ナル値情報ファイル（xtrepコマンドの−vオプションで指定）

環境変数XTARRAYは，表単位にデータ形式，ナル値反映方法について設定する場合に指定します。列単位に設定する場合には，xtrepコマンドの−vオプションに指定するナル値情報ファイルで指定します。環境変数XTARRAYと，ナル値情報ファイルでの指定とを同時に指定した場合には，ナル値情報ファイルでの指定が優先されます。環境変数XTARRAYを省略した場合は，VVおよびCが仮定されます。

また，環境変数XTNLDFLTに2を指定した場合，HiRDB反映またはバイナリ形式のファイル作成時は，この環境変数の指定は無視され，VVおよびCとして処理されます。

データ形式

繰返し列をファイルに出力する場合の，データの形式を指定します。

ＦＦ：列の先頭に要素数がなく，列の要素すべてにデータがある形式

ＦＶ：列の先頭に要素数があり，列の要素すべてにデータがある形式

ＶＶ：列の先頭に要素数があり，要素数分のデータがある形式

ナル値反映方法

繰返し列をHiRDBの表に反映する場合の，要素すべてがナル値のときのナル値の反映方法を指定します。ナル値反映方法は，HiRDBの表に反映する場合で，データ形式にFFを指定するときにだけ指定できます。

Ｃ：要素全体にデータがないとき，列全体をナル値として反映します。

Ｅ：要素全体にデータがないとき，各要素をナル値として反映します。

繰返し列のデータ形式とナル値反映方法の指定できる組み合わせを，次の表に示します。

表3‒2　繰返し列のデータ形式とナル値反映方法の指定の組み合わせ

実行する機能

指定値

指定可否

データ形式

ナル値反映方法

HiRDBの表に反映

FF

なし

○

C

E

FV

なし

○

C

×

E

VV

なし

○

C

×

E

ファイル作成

バイナリ形式

FF

なし

○

C

×

E

FV

なし

○

C

×

E

VV

なし

×

C

E

DAT形式

FF

なし

○

C

×

E

FV

なし

×

C

E

VV

なし

○

C

×

E

（凡例）

○：指定できます。

×：指定できません。

(c)　データ形式およびナル値反映方法の指定時の注意事項

データ形式およびナル値反映方法の指定時の注意事項を次に示します。

繰返し列以外に対して，データ形式およびナル値反映方法を指定することはできません。

DAT形式のファイルを作成する場合には，データ形式にFVは指定できません。

対象の表に可変長文字列を含む場合は，データ形式にFF，FVは指定できません。

ファイルだけを作成する場合は，ナル値反映方法は指定できません。

データ形式にFFを指定してナル値反映方法を指定した場合，ナル値を抽出したときに，HiRDBの表への反映時にナル値反映方法の指定値に統一されます。このために，列全体のナル値と要素全体のナル値の区別がつかなくなり，抽出側のデータと反映側のデータの状態が変わってしまうことがあるので注意が必要です。

（例）

同一のHiRDBシステムで，HiRDB DataextractorとHiRDB Datareplicatorを同時に使用している場合で，次の条件を満たしたときは，HiRDB Datareplicatorが反映処理時にエラーになります。

HiRDB Dataextractorで，データ形式にFF，ナル値反映方法にEを指定して，抽出側の列全体のナル値を要素全体のナル値として反映する。

1.のレコードに対して，UAPから更新（要素の追加）があり，それをHiRDB Datareplicatorで反映する。

(d)　繰返し列のファイル出力時のデータ形式

HiRDBの表への反映時の繰返し列のデータ形式（バイナリ形式）を，「表3-3　HiRDBの表への反映時の繰返し列のデータ形式（バイナリ形式）」に示します。

バイナリ形式のファイル作成時の繰返し列のデータ形式を，「表3-4　バイナリ形式のファイル作成時の繰返し列のデータ形式」に示します。

DAT形式のファイル作成時の繰返し列のデータ形式を，「表3-5　DAT形式のファイル作成時の繰返し列のデータ形式」に示します。

環境変数XTNLDFLTに2を指定した場合のHiRDBの表への反映時およびバイナリ形式のファイル作成時の繰返し列のデータ形式を，「表3-6　環境変数XTNLDFLTに2を指定した場合のHiRDBの表への反映時およびバイナリ形式のファイル作成時の繰返し列のデータ形式」に示します。

表3‒3　HiRDBの表への反映時の繰返し列のデータ形式（バイナリ形式）

抽出データ

繰返し列に対する指定値

出力データの内容※

反映データ

データ形式

ナル値反映方式

要素あり

すべてあり

FF

−

要素₁

…

要素N

すべてあり

FV

−

N

要素₁

…

要素N

VV

−

N

要素₁

…

要素N

途中まであり

FF

−

要素₁

…

要素n

…

ナル値N

途中まであり

FV

−

n

要素₁

…

要素n

…

ナル値N

VV

−

n

要素₁

…

要素n

すべての要素なし

列全体ナル値

FF

指定なし

ナル値₁

…

ナル値N

列全体ナル値

C

ナル値₁

…

ナル値N

E

ナル値₁

…

ナル値N

各要素ナル値

FV

−

0

ナル値₁

…

ナル値N

列全体ナル値

VV

−

0

全要素ナル値

FF

指定なし

ナル値₁

…

ナル値N

列全体ナル値

C

ナル値₁

…

ナル値N

E

ナル値₁

…

ナル値N

各要素ナル値

FV

−

N

ナル値₁

…

ナル値N

各要素ナル値

VV

−

N

ナル値₁

…

ナル値N

（凡例）

−：該当しません。

N：最大要素数

n：実要素数

要素x：x番目の要素を示します。

ナル値x：x番目のナル値を示します。

注※

出力データ中に設定される各要素の内容を，左から順番に示します。空欄は，要素がないことを示します。

表3‒4　バイナリ形式のファイル作成時の繰返し列のデータ形式

抽出データ

繰返し列に対する指定値

出力データの内容※

データ形式

ナル値反映方式

要素あり

すべてあり

FF

−

要素₁

…

要素N

FV

−

N

要素₁

…

要素N

VV

−

N

要素₁

…

要素N

途中まであり

FF

−

要素₁

…

要素n

…

ナル値N

FV

−

n

要素₁

…

要素n

…

ナル値N

VV

−

n

要素₁

…

要素n

すべての要素なし

列全体ナル値

FF

−

ナル値₁

…

ナル値N

FV

−

0

ナル値₁

…

ナル値N

VV

−

0

全要素ナル値

FF

−

ナル値₁

…

ナル値N

FV

−

N

ナル値₁

…

ナル値N

VV

−

N

ナル値₁

…

ナル値N

（凡例）

−：該当しません。

N：最大要素数

n：実要素数

要素x：x番目の要素を示します。

ナル値x：x番目のナル値を示します。

注※

出力データ中に設定される各要素の内容を，左から順番に示します。空欄は，要素がないことを示します。

表3‒5　DAT形式のファイル作成時の繰返し列のデータ形式

抽出データ

繰返し列に対する指定値

出力データの内容※

備考

データ形式

ナル値反映方式

要素あり

すべてあり

FF

−

要素₁，…，要素N

コンマ数＝N−1

FV

−

−

指定不可

VV

−

N，要素₁，…，要素N

コンマ数＝N

途中まであり

FF

−

要素₁，…，要素n，…，

コンマ数＝N−1

FV

−

−

指定不可

VV

−

n，要素₁，…，要素n

コンマ数＝n

すべての要素なし

列全体ナル値

FF

−

，…，

コンマ数＝N−1

FV

−

−

指定不可

VV

−

0

コンマ数＝0

全要素ナル値

FF

−

，…，

コンマ数＝N−1

FV

−

−

指定不可

VV

−

N，…，

コンマ数＝N

（凡例）

−：該当しません。

N：最大要素数

n：実要素数

要素x：x番目の要素を示します。

ナル値x：x番目のナル値を示します。

注※

出力データ中に設定される各要素の内容を，左から順番に示します。

表3‒6　環境変数XTNLDFLTに2を指定した場合のHiRDBの表への反映時およびバイナリ形式のファイル作成時の繰返し列のデータ形式

抽出データ

出力データの内容※1

反映データ※2

要素あり

すべてあり

N

ナル値フラグ1

要素₁

…

ナル値フラグN

要素N

要素あり

途中まであり

n

ナル値フラグ1

要素₁

…

ナル値フラグn

要素n

途中まであり

要素なし

列全体ナル値

（オフセットに0を設定し，列データは作成しない）

列全体ナル値

全要素ナル値

N

ナル値フラグ1

…

ナル値フラグN

全要素ナル値

（凡例）

N：最大要素数（2バイトの領域）

n：実要素数（2バイトの領域）

要素x：x番目の要素を示します。ナル値フラグが，1の場合には作成されません。

ナル値フラグx：x番目のナル値フラグ（1バイトの領域）を示します。

ナル値フラグの設定内容と要素の関係を次に示します。

抽出データ

ナル値フラグ

要素情報の作成有無

ナル値

1

作成しません。ナル値フラグだけとなります。

非ナル値

0

作成します。

注※1

出力データ中に設定される各要素の内容を左から順番に示します。空欄は，要素がないことを示します。

注※2

HiRDBの表への反映を行った場合の反映データの状態を示します。

(7)　抽象データ型の列の抽出

HiRDB Dataextractorは，抽象データ型（ADT：Abstract Data Type）の列を抽出および反映対象にできます。

(a)　SGMLTEXT型の列の抽出

SGMLTEXT型では，原文書をBLOB属性で定義しています。HiRDB Dataextractorは，この原文書を抽出します。

SGMLTEXT型については，マニュアル「HiRDB 全文検索プラグイン　HiRDB Text Search Plug-in」を参照してください。

ここでは，SGMLTEXT型のデータの抽出方法について説明します。

(i)環境変数の設定

SGMLTEXT型のデータを抽出するためには，次の環境変数の指定が必要です。

環境変数XTLOBBUFSIZEの指定

SGMLTEXT型のBLOB属性の列の，実データの最大長を指定します。

実データの最大長は，xtrepコマンドを使用して求められます。

列名記述ファイルに，抽象データ型関数extractsを使用して，抽出対象のSGMLTEXT型の列の最大長を求めるための選択式を記述し，xtrepコマンドを実行します。これによって求められた値を，環境変数XTLOBBUFSIZEに設定します。

環境変数XTERRLEVELでの1の指定

エラー発生時に，処理を中止することを指定します。

(ii)xtrepコマンドでの指定

SGMLTEXT型のデータを抽出するためには，xtrepコマンドに次の指定が必要です。

−sオプションでの列名記述ファイルの指定

列名記述ファイルに，抽象データ型関数のextractsを使用して抽出対象のSGMLTEXT型の列，およびその他の抽出対象列を指定し，xtrepコマンドを実行します。実行例については，「4.4.1(2)(f)例6」を参照してください。

(iii)注意事項

SGMLTEXT型のデータを抽出する場合は，次の条件を満たしている必要があります。

抽象データ型の定義（型名，属性数，属性データ型など）が，抽出側と反映側で一致している。

コンストラクタ関数名が抽象データ型名と一致している。

HiRDBプラグインの抽象データ型に対する固有の定義（SGMLTEXT型のときは，文書型定義）が，抽出側と反映側で一致している。

ファイルだけを作成する場合，SGMLTEXT型のBLOB属性の列のLOBデータが，LOBデータ単位にLOB入力ファイルとして作成され，LOB入力ファイル格納用ディレクトリ下に格納されます。ただし，反映情報ファイルにSGMLTEXT型を指定することで，このLOBデータを入力ファイルに格納できます。

(b)　XML型の列の抽出

XML型では，原文書をBINARY属性で定義しています。HiRDB Dataextractorは，この原文書を抽出します。

XML型については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

ここでは，XML型のデータの抽出方法について説明します。

(i)環境変数の設定

XML型のデータを抽出するためには，次の環境変数の指定が必要です。

環境変数XTLOBBUFSIZEの指定

XML型のBINARY属性の列の，実データの最大長を指定します。

実データの最大長は，xtrepコマンドを使用して求められます。

列名記述ファイルに，抽象データ型関数extractsを使用して，抽出対象のXML型の列の最大長を求めるための選択式を記述し，xtrepコマンドを実行します。これによって求められた値を，環境変数XTLOBBUFSIZEに設定します。

環境変数XTERRLEVELでの1の指定

エラー発生時に，処理を中止することを指定します。

(ii)xtrepコマンドでの指定

XML型のデータを抽出するためには，xtrepコマンドに次の指定が必要です。

−sオプションでの列名記述ファイルの指定

列名記述ファイルに，抽象データ型関数のextractsを使用して抽出対象のXML型の列，およびその他の抽出対象列を指定し，xtrepコマンドを実行します。

(iii)注意事項

XML型のデータを抽出する場合は，次の条件を満たしている必要があります。

抽象データ型の定義（型名，属性数，属性データ型など）が，抽出側と反映側で一致している。

コンストラクタ関数名が抽象データ型名と一致している。

HiRDBプラグインの抽象データ型に対する固有の定義（XML型のときは，文書型定義）が，抽出側と反映側で一致している。

ファイルだけを作成する場合，XML型のBINARY属性の列のLOBデータが，LOBデータ単位にLOB入力ファイルとして作成され，LOB入力ファイル格納用ディレクトリ下に格納されます。ただし，反映情報ファイルにXML型を指定することで，このLOBデータを入力ファイルに格納できます。

(c)　FREEWORD型の列の抽出

FREEWORD型では，原文書をVARCHAR属性で定義しています。HiRDB Dataextractorは，この原文書を抽出します。

FREEWORD型については，マニュアル「HiRDB 全文検索プラグイン　HiRDB Text Search Plug-in」を参照してください。

ここでは，FREEWORD型のデータの抽出方法について説明します。

(i)xtrepコマンドでの指定

FREEWORD型のデータを抽出するためには，xtrepコマンドに次の指定が必要です。

−sオプションでの列名記述ファイルの指定

列名記述ファイルに，抽象データ型関数のextractsを使用して抽出対象のFREEWORD型の列，およびその他の抽出対象列を指定し，xtrepコマンドを実行します。

(ii)注意事項

FREEWORD型のデータを抽出する場合は，次の条件を満たしている必要があります。

抽象データ型の定義（型名，属性数，属性データ型など）が，抽出側と反映側で一致している。

コンストラクタ関数名が抽象データ型名と一致している。

HiRDBプラグインの抽象データ型に対する固有の定義（FREEWORD型のときは，文字列型定義）が，抽出側と反映側で一致している。

3.1.2　抽出したデータヘの任意の列の追加

抽出したデータへ任意に列を追加し，その列に初期値を指定できます。

抽出対象の表の列数と反映対象の表の列数とが異なる場合に，この機能を使用して，反映対象の表にだけある列に設定する初期値を抽出データに追加します。

抽出したデータヘの列の追加は，HiRDBの次のSQLで指定します。

SELECT文の選択式

xtrepコマンドでSELECT文の選択式を記述した列名記述ファイルの名称を指定します。例を次に示します。

（例）

抽出側の受注表に次の列を追加し，反映側の受注表2に反映します。列の追加の例を次の図に示します。

受注日付（初期値として’960715’を設定する）

図3‒7　列（初期値）の追加

3.1.3　抽出したデータのデータ型変換

データを反映するときに変換できるデータ型，および抽出する行を選択するときに比較できるデータ型について説明します。

HiRDB Dataextractorで変換および比較できるデータ型を，「表3-7　HiRDB Dataextractorで変換および比較できるデータ型」に示します。

データを反映するとき，HiRDB Dataextractorは抽出対象の列と反映対象の列とを比較し，「表3-7　HiRDB Dataextractorで変換および比較できるデータ型」に示すデータ型の組み合わせであればデータ型を変換します。

また抽出する行を選択する場合，表式記述ファイルの条件の指定が「表3-7　HiRDB Dataextractorで変換および比較できるデータ型」に示すデータ型の組み合わせであれば，HiRDB Dataextractorは指定されたデータを比較します。

注意事項

データ型変換中のオーバフローエラー

データ型変換中にオーバフローエラーが発生した場合，HiRDBシステム共通定義のpd_overflow_suppressの設定によって，次の処理が行われます。

オーバフローエラー抑止が設定されている場合

オーバフローが発生した演算の結果をナル値として処理します。

オーバフローエラー抑止が設定されていない場合

エラーメッセージを出力して処理を終了します。

表3‒7　HiRDB Dataextractorで変換および比較できるデータ型

抽出側のデータ型

反映側のデータ型

数

文字，混在文字

※14

各国文字

※14

日付

時刻

日間隔

時間隔

時刻印

長大

※15

※20

抽象

S

X

F

数

INT

○

×

×

×

×

×※1

×※6

×

×

×

×

×

SMALLINT

DEC※14

FLOAT

SMALLFLT

文字※14

CHAR

×

○※11※21

○※13

×※2

×※7

×

×

×※17

×※19

×

×

×

VARCHAR

混在文字※14

MCHAR

×

○※11

○※13

×

×

×

×

×

×※19

×

×

×

MVARCHAR

各国文字※14

NCHAR

×

○※12

○※11

×

×

×

×

×

×

×

×

×

NVARCHAR

日付

DATE

×

×※3

×

○

×

×

×

×

×

×

×

×

時刻

TIME

×

×※8

×

×

○

×

×

×

×

×

×

×

日間隔

YEAR

×※4

×

×

×

×

○※5

×

×

×

×

×

×

時間隔

HOUR

×※9

×

×

×

×

×

○※10

×

×

×

×

×

時刻印

TIMESTAMP

×

×※16

×

×

×

×

×

○※18

×

×

×

×

長大※15，※20

BLOB

×

×

×

×

×

×

×

×

○

×

×

×

BINARY

抽象

SGMLTEXT

×

×

×

×

×

×

×

×

×

○

×

×

XML

×

×

×

×

×

×

×

×

×

×

○

×

FREEWORD

×

×

×

×

×

×

×

×

×

×

×

○

（凡例）

○：変換，比較できます。

×：変換，比較できません。

YEAR：INTERVAL YEAR TO DAY

HOUR：INTERVAL HOUR TO SECOND

S：SGMLTEXT

X：XML

F：FREEWORD

注※1

次に示すものは日間隔データとの比較および日間隔データへの変換ができます。

日間隔を10進数で表現した定数との比較

DECIMAL(8，0)データとの比較および変換

注※2

次に示すものは日付データとの比較ができます。

日付を文字で表現した定数との比較

CHARACTER(10)データとの比較

注※3

次に示すものは日付データとの比較および文字データへの変換ができます。

日付を文字で表現した定数との比較

CHARACTER(10)データとの比較

日付データを10バイト以上のCHARACTERまたはVARCHARデータへ変換

注※4

次に示すものは日間隔データとの比較および10進データへの変換ができます。

日間隔を10進数で表現した定数との比較

DECIMAL(8，0)データとの比較

日間隔データをDECIMAL(8，0)データへの変換

注※5

日間隔データ同士の比較は，年，月，日の順で比較します。

注※6

次に示すものは時間隔データとの比較および時間隔データへの変換ができます。

時間隔を10進数で表現した定数との比較

DECIMAL(6，0)に対応するデータとの比較および変換

注※7

次に示すものは時刻データとの比較ができます。

時刻を文字で表現した定数

CHARACTER(8)データとの比較

注※8

次に示すものは時刻データとの比較および文字データへの変換ができます。

時刻を文字で表現した定数との比較

CHARACTER(8) データとの比較

時刻データを8バイト以上のCHARACTERまたはVARCHARデータへの変換

注※9

次に示すものは時間隔データとの比較および10進データへの変換ができます。

時間隔を10進数で表現した定数との比較

DECIMAL(6，0)データとの比較

時間隔データをDECIMAL(6，0)データへの変換

注※10

時間隔データ同士の比較は，時，分，秒の順で比較します。

注※11

抽出側のデータ長＜反映側のデータ長の変換のときは後ろの部分に空白を設定します。

注※12

この組み合わせで実行する場合の注意を次に示します。

2×抽出側の文字数≦反映側のデータ長である必要があります。

抽出側のデータ長＜反映側データ長の場合，1バイトの空白を設定します。

抽出側のデータ内容を，そのまま反映側に格納します。

N(VAR)CHARの空白と，1バイトの空白が混在するような使い方をした場合，空白を含む比較などが意図したように実行できなくなるので注意してください。

注※13

この組み合わせで実行する場合の注意を次に示します。

抽出側のデータ長≦2×反映側の文字数である必要があります。

N(VAR)CHARで定義した列中に1バイトコードを代入しないでください。代入した場合，データ検索などが意図したように実行できなくなるので注意してください。

抽出側のデータ長＜反映側のデータ長の場合，1バイトの空白を設定します。

抽出側のデータ内容を，そのまま反映側に格納します。

注※14

次の場合は，データの切り捨てが発生するため注意してください。

ただし，環境変数XTERRLEVELに0以外を指定した場合は，指定に従って処理されます。

文字データ，混在文字データ，各国文字データの場合

抽出側のデータ長＞反映側のデータ長

DECの場合

抽出側の整数部のけた数＞反映側の整数部のけた数，または

抽出側の少数部のけた数＞反映側の少数部のけた数

注※15

次の場合は，データの変換，比較はできません。

ただし，環境変数XTLOBBUFSIZEが指定された場合は，環境変数XTERRLEVELの指定に従って処理されます。

抽出側のデータ長＞反映側のデータ長

注※16

次の場合は，時刻印データから文字データ（CHAR(n)，VARCHAR(n)）への変換ができます。

時刻印データの小数秒が0けたのとき，文字データ長≧19バイト

時刻印データの小数秒が2けたのとき，文字データ長≧22バイト

時刻印データの小数秒が4けたのとき，文字データ長≧24バイト

時刻印データの小数秒が6けたのとき，文字データ長≧26バイト

注※17

次の場合は，文字データ（CHAR(n)，VARCHAR(n)）から時刻印データへの変換ができます。

CHARACTERまたはVARCHARが時刻印データである。

列名記述ファイルでスカラ関数TIMESTAMP_FORMATを指定する。また，小数秒は反映側が短ければ切り捨てを行い，長ければ0x00を埋める。

注※18

小数秒けた数が不一致の場合，反映側が短ければ切り捨て，長ければ0x00を埋めます。

注※19

次の場合は変換ができます。

文字データまたは混在文字データからBINARYデータへ変換する。

16進定数を列名記述ファイルに指定し，BINARYデータに反映する。

注※20

長大データのBLOB型以外は使用できます。

注※21

反映側がCHAR，VARCHARの場合，環境変数XTCSETUSEにyesを指定して文字集合列を抽出・反映するときは，文字集合データをそのままのデータ型で抽出し，反映します。

3.1.4　抽出したデータの文字コード変換

異なる文字コードのシステム間でデータ抽出・反映する場合，抽出したデータの文字コードを反映側の文字コードに合わせて変換できます。

ここでは，変換できる文字コードについて説明します。この機能の使用方法については，「4.2.3　データ抽出・反映の付加機能」を参照してください。

(1)　文字コード変換の対象となるデータ型

文字コード変換の対象となる抽出データのデータ型を次に示します。

CHAR※1※2※3

VARCHAR※1※2※3

MCHAR※1※3

MVARCHAR※1※3

NCHAR※1

NVARCHAR※1

SGMLTEXT※1※4

FREEWORD※1

注※1

ナル値情報ファイルにNOCODECONVを指定した場合，列単位にコード変換の対象から外すことができます。ナル値情報ファイルの指定方法については，「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

注※2

次の場合での文字集合列への反映は，文字コード変換対象となりません。

環境変数XTCSETUSEにyesを指定した場合

環境変数XTORANCSET，またはXTSQLNCSETにutf-16を指定した場合

注※3

環境変数XTDATALOCALEにutf-16BE，またはutf-16LEを指定して文字コード変換する場合，データ長を偶数バイトにしてください。奇数バイトの場合，エラー終了します。

注※4

HiRDBに反映しないでファイルだけを作成する場合は，BLOB属性と解釈するためにコード変換の対象外となります。ただし，次のどちらかによってコード変換対象にすることができます。

ナル値情報ファイルでCODECONVを指定します。

指定方法については，「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

反映情報ファイルでSGMLTEXT型を指定します。

指定方法については，「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

なお，作成したファイルをpdloadの入力ファイルとして使用する場合は，この方法で変換対象としてください。

(2)　変換できる文字コード

HiRDB Dataextractorで変換できる文字コードの組み合わせを次に示します。

抽出側の文字コード

反映側の文字コード

SJIS

EUC

UTF-8

UTF-16BE※

UTF-16LE※

SJIS

−

○

○

○

○

EUC

○

−

○

○

○

UTF-8

○

○

−

○

○

UTF-16BE※

○

○

○

−

○

UTF-16LE※

○

○

○

○

−

（凡例）

○：文字コードを変換します。

−：文字コードを変換しません。

注※

文字コードにUTF-16BE，UTF-16LEを指定できるのは，変換対象が表データの場合だけです。表定義情報は変換対象となりません。

(3)　変換できる文字コードの範囲

変換できるSJIS文字コードの範囲を次の図に示します。

図3‒8　SJIS文字コードの範囲

注

拡張外字もコード領域の文字は変換対象外です。

変換できるEUC文字コードの範囲を次の図に示します。

図3‒9　EUC文字コードの範囲

注※

外字コードは，1バイト目が0x8Fで，2バイト目以降の範囲は，0xA1A1〜0xFEFEです。

変換できるUTF-8文字コードの範囲を次の表に示します。

表3‒8　UTF-8文字コードの範囲

第1バイト

第2バイト

第3バイト

変換規則

0x00〜0x7F

−

−

1バイトコードと認識し，対応するコードに変換

0x80〜0xBF

0x00〜0xFF

−

0x20に変換

−

−

0xC2〜0xDE

0x80〜0xFF

−

2バイトコードと認識し，対応するコードに変換

上記以外

−

環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

−

−

未完全コードと認識し，変換しないでスキップ

0xDF

0x80〜0xBF

−

2バイトコードと認識し，対応するコードに変換

上記以外

−

環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

−

−

未完全コードと認識し，変換しないでスキップ

0xE0

0xA0〜0xFF

0x80〜0xFF

3バイトコードと認識し，対応するコードに変換

上記以外

環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

−

未完全コードと認識し，変換しないでスキップ

上記以外

0x80〜0xFF

環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

上記以外

−

未完全コードと認識し，変換しないでスキップ

−

−

0xE1〜0xEE

0x80〜0xFF

0x80〜0xFF

3バイトコードと認識し，対応するコードに変換

上記以外

環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

−

未完全コードと認識し，変換しないでスキップ

上記以外

0x80〜0xFF

環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

−

未完全コードと認識し，変換しないでスキップ

−

−

0xEF

0x80〜0xBF

0x80〜0xBF

3バイトコードと認識し，対応するコードに変換

上記以外

環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

−

未完全コードと認識し，変換しないでスキップ

上記以外

0x80〜0xBF

環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

上記以外

−

未完全コードと認識し，変換しないでスキップ

−

−

0xF0〜0xED

−

−

環境変数XTUTF8UCS4CHKの指定に従って行データをスキップし，処理を中断

指定がない場合は環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

上記以外

−

−

環境変数XTUNDEF，またはXTDATAUNDEFの指定に従って変換

（凡例）

−：文字コードを変換しません。

変換できるUTF-16文字コードの範囲を次の図に示します。なお，UTF-16にはUTF-16BEコード体系（ビッグエンディアン），UTF-16LEコード体系（リトルエンディアン）があります。

図3‒10　UTF-16文字コードの範囲

(4)　SJISからEUCへの文字コード変換

(a)　1バイトコード

「図3-8　SJIS文字コードの範囲」の(1)〜(4)の文字コードは次のように変換します。

対応するEUCコードに変換します。

カナ文字はEUCコードでは1バイトコードになります。

空白文字（0x20）はそのまま空白文字（0x20）となります。

(b)　2バイトコード（SJIS標準漢字領域）

「図3-8　SJIS文字コードの範囲」の(6)，(7)の文字コードは，対応するEUC標準漢字領域のコードに変換します。

空白文字（0x8140）は空白文字（0xa1a1）に変換します。

(c)　2バイトコード（外字領域）

「図3-8　SJIS文字コードの範囲」の(8)の文字コードは次のように変換します。

文字コード変換用マッピングテーブルに従い，コード変換します。なお，文字コード変換用マッピングテ−ブルに対応するコードが定義されていない場合は未定義コードとして，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。文字コード変換用マッピングテーブルについては，「4.2.3　データ抽出・反映の付加機能」を参照してください。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(d)　2バイトコード（上記(b)(c)以外）

未定義コードとしてみなされ，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(5)　SJISからUTF-8への文字コード変換

(a)　1バイトコード

対応するUTF-8コードに変換します。

カナ文字はUTF-8コードでは3バイトコードになります。

空白文字（0x20）はそのまま空白文字（0x20）となります。

(b)　2バイトコード（標準文字セット）

対応するUTF-8の標準文字コードに変換します。

空白文字（0x8140）は空白文字（0xE38080）に変換します。

(c)　2バイトコード（外字コード）

文字コード変換用マッピングテーブルに従い，コード変換します。なお，文字コード変換用マッピングテ−ブルに対応するコードが定義されていない場合は未定義コードとして，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。文字コード変換用マッピングテーブルについては，「4.2.3　データ抽出・反映の付加機能」を参照してください。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(d)　2バイトコード（上記(b)(c)以外）

未定義コードとしてみなされ，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(6)　SJISからUTF-16への文字コード変換

(a)　1バイトコード

対応するUTF-16BE，またはUTF-16LEコードに変換します。

空白文字（0x20）は，バイトオーダによって異なります。

UTF-16BEの場合

空白文字（0x20）は，空白文字（0x0020）に変換します。

UTF-16LEの場合

空白文字（0x20）は，空白文字（0x2000）に変換します。

(b)　2バイトコード（標準文字セット）

対応するUTF-16BE，またはUTF-16LEコードに変換します。

空白文字（0x8140）は，バイトオーダによって異なります。

UTF-16BEの場合

空白文字（0x8140）は，空白文字（0x3000）に変換します。

UTF-16LEの場合

空白文字（0x8140）は，空白文字（0x0030）に変換します。

(c)　2バイトコード（外字コード）

文字コード変換用マッピングテーブルに従い，コード変換します。なお，文字コード変換用マッピングテ−ブルに対応するコードが定義されていない場合は未定義コードとして，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。文字コード変換用マッピングテーブルについては，「4.2.3　データ抽出・反映の付加機能」を参照してください。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(d)　2バイトコード（上記(b)(c)以外）

未定義コードとしてみなされ，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(7)　EUCからSJISへの文字コード変換

(a)　1バイトコード

「図3-9　EUC文字コードの範囲」の(1)〜(4)の文字コードは次のように変換します。

対応するSJISコードに変換します。

カナ文字はSJISコードでは1バイトコードになります。

空白文字（0x20）はそのまま空白文字（0x20）となります。

(b)　2バイトコード（標準漢字コード）

「図3-9　EUC文字コードの範囲」の(6)の文字コードは，対応するSJIS標準漢字領域のコードに変換します。

空白文字（0xa1a1）は空白文字（0x8140）に変換します。

(c)　2バイトコード（外字コード）

「図3-9　EUC文字コードの範囲」の(5)の文字コードは次のように変換します。

文字コード変換用マッピングテーブルに従いコード変換します。なお，文字コード変換用マッピングテーブルに対応するコードが定義されていない場合は未定義コードとして，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。文字コード変換用マッピングテーブルについては，「4.2.3　データ抽出・反映の付加機能」を参照してください。環境変数については，「2.2.3　環境変数の設定」を参照してください。

コードセット3はHiRDB反映時にエラーになる場合があります。

(d)　2バイトコード（上記(b)(c)以外）

未定義コードとしてみなされ，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(8)　EUCからUTF-8への文字コード変換

(a)　1バイトコード

対応するUTF-8コードに変換します。

空白文字（0x20）はそのまま空白文字（0x20）となります。

(b)　2バイトコード（標準文字セット）

対応するUTF-8の標準文字コードに変換します。

カナ文字はUTF-8コードでは3バイトコードになります。

空白文字（0xa1a1）は空白文字（0xE38080）に変換します。

(c)　3バイトコード（外字コード）

文字コード変換用マッピングテーブルに従い，コード変換します。なお，文字コード変換用マッピングテ−ブルに対応するコードが定義されていない場合は未定義コードとして，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。文字コード変換用マッピングテーブルについては，「4.2.3　データ抽出・反映の付加機能」を参照してください。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(d)　2バイトコードまたは3バイトコード（上記(b)(c)以外）

未定義コードとしてみなされ，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(9)　EUCからUTF-16への文字コード変換

(a)　1バイトコード

対応するUTF-16BE，またはUTF-16LEコードに変換します。

空白文字（0x20）は，バイトオーダによって異なります。

UTF-16BEの場合

空白文字（0x20）は，空白文字（0x0020）に変換します。

UTF-16LEの場合

空白文字（0x20）は，空白文字（0x2000）に変換します。

(b)　2バイトコード（標準文字セット）

対応するUTF-16BE，またはUTF-16LEコードに変換します。

空白文字（0xA1A1）は，バイトオーダによって異なります。

UTF-16BEの場合

空白文字（0xA1A1）は，空白文字（0x3000）に変換します。

UTF-16LEの場合

空白文字（0xA1A1）は，空白文字（0x0030）に変換します。

(c)　3バイトコード（外字コード）

文字コード変換用マッピングテーブルに従い，コード変換します。なお，文字コード変換用マッピングテ−ブルに対応するコードが定義されていない場合は未定義コードとして，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。文字コード変換用マッピングテーブルについては，「4.2.3　データ抽出・反映の付加機能」を参照してください。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(d)　2バイトコードまたは3バイトコード（上記(b)(c)以外）

未定義コードとしてみなされ，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(10)　UTF-8からSJISまたはEUCへの文字コード変換

(a)　1バイトコード

対応するコードに変換します。

空白文字（0x20）はそのまま空白文字（0x20）となります。

(b)　2バイトコードおよび3バイトコード（標準漢字コード）

対応する文字コードに変換します。

空白文字（0xE38080）は，対応する文字コードの種別によって異なります。

SJISの場合

空白文字（0xE38080）は，空白文字（0x8140）に変換します。

EUCの場合

空白文字（0xE38080）は，空白文字（0xa1a1）に変換します。

(c)　3バイトコード（外字コード）

文字コード変換用マッピングテーブルに従い，コード変換します。なお，文字コード変換用マッピングテ−ブルに対応するコードが定義されていない場合は未定義コードとして，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。文字コード変換用マッピングテーブルについては，「4.2.3　データ抽出・反映の付加機能」を参照してください。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(d)　2バイトコードまたは3バイトコード（上記(b)(c)以外）

未定義コードとしてみなされ，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(e)　4バイト以上のコード

UTF-8の4バイト以上の文字コードを検知した場合，環境変数XTUTF8UCS4CHKの指定に従って動作します。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(11)　UTF-8からUTF-16への文字コード変換

(a)　1バイトコード

対応するUTF-16BE，またはUTF-16LEコードに変換します。

空白文字（0x20）は，バイトオーダによって異なります。

UTF-16BEの場合

空白文字（0x20）は，空白文字（0x0020）に変換します。

UTF-16LEの場合

空白文字（0x20）は，空白文字（0x2000）に変換します。

(b)　2バイトコードおよび3バイトコード（標準漢字コード）

対応するUTF-16BE，またはUTF-16LEコードに変換します。

空白文字（0xE38080）は，バイトオーダによって異なります。

UTF-16BEの場合

空白文字（0xE38080）は，空白文字（0x3000）に変換します。

UTF-16LEの場合

空白文字（0xE38080）は，空白文字（0x0030）に変換します。

(c)　3バイトコード（外字コード）

UTF-8の外字コードは，UTF-8のデコード（UTF-8からUnicodeへ変換）規則と，UTF-16のエンコード（UnicodeからUTF-16へ変換）規則に従って，UTF-16の外字コードに変換します。

(d)　2バイトコードまたは3バイトコード（上記(b)(c)以外）

未定義コードとしてみなされ，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(12)　UTF-16からSJISへの文字コード変換

(a)　2バイトコード

対応するSJISコードに変換します。

空白文字は，バイトオーダによって異なります。

UTF-16BEの場合

空白文字（0x0020）は，空白文字（0x20）に変換します。

UTF-16LEの場合

空白文字（0x2000）は，空白文字（0x20）に変換します。

(b)　2バイトコード（外字コード）

文字コード変換用マッピングテーブルに従いコード変換します。なお，文字コード変換用マッピングテーブルに対応するコードが定義されていない場合は未定義コードとして，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。文字コード変換用マッピングテーブルについては，「4.2.3　データ抽出・反映の付加機能」を参照してください。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(c)　4バイトコード（補助多言語面）

環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。

(13)　UTF-16からEUCへの文字コード変換

(a)　2バイトコード

対応するEUCコードに変換します。

空白文字は，バイトオーダによって異なります。

UTF-16BEの場合

空白文字（0x0020）は，空白文字（0x20）に変換します。

UTF-16LEの場合

空白文字（0x2000）は，空白文字（0x20）に変換します。

(b)　2バイトコード（外字コード）

文字コード変換用マッピングテーブルに従い，コード変換します。なお，文字コード変換用マッピングテ−ブルに対応するコードが定義されていない場合は未定義コードとして，環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。文字コード変換用マッピングテーブルについては，「4.2.3　データ抽出・反映の付加機能」を参照してください。環境変数については，「2.2.3　環境変数の設定」を参照してください。

(c)　4バイトコード（補助多言語面）

環境変数XTUNDEF，またはXTDATAUNDEFに指定した値で変換します。

UTF-16に4バイトコードを検知した場合，環境変数XTUTF8UCS4CHKに指定した値でコード変換します。

(14)　UTF-16からUTF-8への文字コード変換

(a)　2バイトコード

対応するUTF-16BE，またはUTF-16LEコードに変換します。

空白文字は，バイトオーダによって異なります。

UTF-16BEの場合

空白文字（0x0020）は，空白文字（0x20）に変換します。

UTF-16LEの場合

空白文字（0x2000）は，空白文字（0x20）に変換します。

(b)　2バイトコード（外字コード）

UTF-16の外字コードは，UTF-16のデコード（UTF-16からUnicodeへ変換）規則と，UTF-8のエンコード（UnicodeからUTF-8へ変換）規則に従って，UTF-16の外字コードに変換します。

(c)　4バイトコード（補助多言語面）

対応するUTF-8コードに変換します。

(15)　文字コード変換後の値の求め方

ここでは，エンコード，およびデコードによる文字コード変換後の値の求め方について説明します。

(a)　UnicodeからUTF-8へのエンコード

UnicodeからUTF-8への変換後の値は，次の手順で求めます。

Unicodeの値を16進数から2進数に変換する

次に示す表に従い，vの部分に1.の値を当てはめる

2.の値を16進数に変換する

表3‒9　UnicodeとUTF-8の関係

Unicode

（16進数）

UTF-8

（2進数）

1バイト目

2バイト目

3バイト目

4バイト目

5バイト目

6バイト目

00000000〜0000007f

0vvvvvvv

−

−

−

−

−

00000080〜000007ff

110vvvvv

10vvvvvv

−

−

−

−

00000800〜0000ffff

1110vvvv

10vvvvvv

10vvvvvv

−

−

−

00010000〜001fffff

11110vvv

10vvvvvv

10vvvvvv

10vvvvvv

−

−

00200000〜03ffffff

111110vv

10vvvvvv

10vvvvvv

10vvvvvv

10vvvvvv

−

04000000〜7fffffff

1111110v

10vvvvvv

10vvvvvv

10vvvvvv

10vvvvvv

10vvvvvv

（凡例）

−：該当しません。

例

Unicode（E000）₁₆をUTF-8に変換します。

（E000）₁₆ = （1110000000000000）₂

（11101110 10000000 10000000）₂

（11101110 10000000 10000000）₂ =（EE8080）₁₆

よって，UTF-8への変換後の値は（EE8080）₁₆となります。

(b)　UTF-8からUnicodeへのデコード

UTF-8からUnicodeへの変換後の値は，UTF-8のエンコードと逆の手順で求めます。

UTF-8の値を2進数に変換する

表3-9に従い，1.の値を当てはめ，vの部分を取り除く

Unicodeの値を2進数から16進数に変換する

例

UTF-8（EE8080）₁₆をUnicodeに変換します。

（EE8080）₁₆ = （11101110 10000000 10000000）₂

（1110000000000000）₂

（1110000000000000）₂ = （E000）₁₆

よって，Unicodeへの変換後の値は（E000）₁₆となります。

(c)　UnicodeからUTF-16へのエンコード

UnicodeからUTF-16への変換後の値の求め方は，Unicodeの値の範囲によって異なります。

（0000）₁₆〜（FFFF）₁₆の範囲のUnicodeは，変換後もそのままUnicodeの値（2バイト）となります。なお，（D800）₁₆〜（DFFF）₁₆の範囲はサロゲート用で，単独のUnicode文字コードとしては使用できないため除きます。

（10000）₁₆以上のUnicodeは，変換後，サロゲートペア（4バイト）となります。（10000）₁₆以上のUnicodeからUTF-16への変換後の値は，次の手順で求めます。

Unicode値から（10000）₁₆を引く

1.の値を1024で割り，その商に（D800）₁₆を加える

上位サロゲート = （1.の値 ÷ 1024） + （D800）₁₆

1.の値を1024で割り，その余りに（DC00）₁₆を加える

下位サロゲート = （1.の値 % 1024） + （DC00）₁₆

例

Unicode（20B9F）₁₆をUTF-16に変換します。

（20B9F）₁₆ - （10000）₁₆ = （10B9F）₁₆

上位サロゲート = （（10B9F）₁₆ ÷ 1024） + （D800）₁₆ = （D842）₁₆

下位サロゲート = （（10B9F）₁₆ % 1024） + （DC00）₁₆ = （DF9F）₁₆

よって，UTF-16への変換後の値は（D842 DF9F）₁₆となります。

(d)　UTF-16からUnicodeへのデコード

UTF-16からUnicodeへの変換後の値の求め方は，UTF-16の値の範囲によって異なります。

上位サロゲートが次に示す範囲のUTF-16は，変換後もそのままUTF-16の値が使われます。

（0000）₁₆〜（D7FF）₁₆

（E000）₁₆〜（FFFF）₁₆

上位サロゲートが（D800）₁₆〜（DBFF）₁₆で，下位サロゲートが（DC00）₁₆〜（DFFF）₁₆の範囲のUTF-16の場合，Unicodeへの変換後の値は，次の手順で求めます。

上位サロゲートから（D800）₁₆を引く

Unicode上位値 = 上位サロゲート - （D800）₁₆

下位サロゲートから（DC00）₁₆を引く

Unicode下位値 = 下位サロゲート - （DC00）₁₆

1.の値に1024をかけ，2.の値，および（10000）₁₆を足す

例

Unicode（D842 DF9F）₁₆をUTF-16に変換します。

Unicode上位値 = （D842）₁₆ - （D800）16 = （42）₁₆

Unicode下位値 = （DF9F）₁₆ - （DC00）16 = （39F）₁₆

（42）₁₆ × 1024 + （39F）₁₆ + （10000）16 = （20B9F）₁₆

よって，Unicodeへの変換後の値は（20B9F）₁₆となります。

3.1.5　文字集合データの抽出，反映

HiRDBでデータ連携できる文字集合は，EBCDIKとUTF-16です。

(1)　文字集合EBCDIK

(a)　XDM/XT連携の場合

HiRDBとXDM/RD間で，文字集合EBCDIKが定義された表をデータ連携できます。ただし，必要に応じて次の条件を満たす必要があります。

抽出列と反映列の属性と定義長が一致している

文字集合列を抽出，反映するフィールドの文字コード変換を抑止する

文字集合定義列のデータが8ビットの単一バイト文字コードである

詳細については，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

(b)　HiRDB間連携の場合

HiRDB間で，文字集合EBCDIKが定義された表をデータ連携できます。ただし，必要に応じて次の条件を満たす必要があります。

抽出列と反映列の属性と定義長が一致している

文字集合列を抽出，反映するフィールドの文字コード変換を抑止する

文字集合定義列のデータが8ビットの単一バイト文字コードである

抽出列と反映列の文字集合が同じである

環境変数XTNLDFLTに2を指定して抽出，反映をする

DB破壊が起こるおそれがありますので，0および1は絶対に指定しないでください。

詳細については，マニュアル「HiRDB SQLリファレンス」を参照してください。

(2)　文字集合UTF-16

環境変数XTCSETUSEにyesを指定した場合，文字集合UTF-16が定義された表データをデータ連携できます。

このとき環境変数XTNLDFLTに2は指定できません。

環境変数XTCSETUSEを省略またはnoを指定した場合，DB破壊が起こるおそれがありますので，環境変数XTNLDFLTに0および1は絶対に指定しないでください。

(a)　HiRDB間連携の場合

HiRDB間で，文字集合UTF-16が定義された表データをデータ連携できます。ただし，次の条件を満たす必要があります。

抽出列と反映列の属性と定義長が一致している

抽出列と反映列の文字集合が同じである

(b)　バイナリファイル，およびDATファイルへの反映の場合

バイナリファイル，およびDATファイルへ反映する場合，文字集合UTF-16が定義された表データをデータ連携できます。ただし，反映情報ファイルを指定する場合，抽出列と反映列の属性と定義長が一致している必要があります。

文字集合以外の列は文字コード変換します。抽出側の環境変数XTDATALOCALEにutf-8，反映側の環境変数XTDATALOCALEにutf-16BE，またはutf-16LEを指定してください。

3.2　データの抽出（ORACLE）

HiRDB Dataextractorのデータの抽出とは，DBからデータを抽出し，反映側システムへ送信するまでをいいます。そのときに，必要なデータだけを抽出したり，抽出したデータに任意のフィールドを追加したりできます。

ここでは，ORACLEのDBからデータを抽出して，HiRDBのDBヘデータを反映する場合について説明します。

ORACLEのDBからデータを抽出してXDM/RDのDBヘデータを反映する場合については，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

ORACLEのDBからデータを抽出する場合，HiRDB Dataextractorが使用するORACLE抽出ライブラリを，プラットフォームやバージョンによっては，事前にユーザ環境で作成する必要があります。作成方法の詳細については，付属のドキュメントを参照してください。

3.2.1　必要なデータの抽出

ORACLEのDBからデータを抽出する場合はxtrepOを使用します。xtrepOコマンドで，抽出する表の名称や抽出方法を指定して，必要なデータだけを抽出できます。

HiRDB Dataextractorは，抽出したデータを反映対象の表の左の列から順に対応づけて反映します。このため，抽出対象の表と反映対象の表とで表の形式（列数，列の並び順）が異なる場合は，xtrepOコマンドを使用して反映対象の表の形式に合わせてデータを抽出する必要があります。

HiRDB Dataextractorでは次の抽出ができます。

表単位の抽出

抽出する列の選択，並べ替え

抽出する行の選択，並べ替え

ナル値の既定値の選択

詳しい内容については「3.1.1　必要なデータの抽出」を参照してください。ただし，xtrepコマンドはxtrepOコマンドとなります。

3.2.2　抽出したデータへの任意の列の追加

内容については「3.1.2　抽出したデータへの任意の列の追加」を参照してください。

ただし，xtrepコマンドはxtrepOコマンドとなります。

3.2.3　抽出したデータのデータ型変換

データを反映するときに変換できるデータ型について説明します。

HiRDB Dataextractorで変換できるデータ型を，「表3-10　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（1/2）」，「表3-11　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（2/2）」に示します。

データを反映するとき，HiRDB Dataextractorは抽出対象の列と反映対象の列とを比較し，「表3-10　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（1/2）」，「表3-11　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（2/2）」に示すデータ型の組み合わせであればデータ型を変換します。

また抽出する行を選択する場合，表式記述ファイルの条件の指定が「表3-10　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（1/2）」，「表3-11　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（2/2）」に示すデータ型の組み合わせであれば，HiRDB Dataextractorは指定されたデータを比較します。

表3‒10　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（1/2）

抽出側のデータ型(ORACLE内部データ型)

反映側（HiRDB）のデータ型

数データ※8

INT，SMALLINT，DECIMAL，FLOAT，SMALLFLT

文字データ，混在文字データ※5 ※7

CHAR，VARCHAR，MCHAR，MVARCHAR

各国文字データ※6 ※7

NCHAR，NVARCHAR

日付データ

DATE

時刻データ

TIME

NUMBER

○

○

×

×

×

CHAR

VARCHAR2

○※1

○※11

○

×

×

NCHAR

NVARCHAR2

×

○

○

×

×

DATE※4

×

○

×

○※2

○※3

LONG

×

×

×

×

×

LONG RAW

×

×

×

×

×

RAW

×

×

×

×

×

BLOB

CLOB

NCLOB

BFILE

×

×

×

×

×

表3‒11　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（2/2）

抽出側のデータ型(ORACLE内部データ型)

反映側（HiRDB）のデータ型

日間隔データ

YEAR

時間隔データ

HOUR

時刻印データ

TIMESTAMP

長大データ※9

BLOB，BINARY

抽象データ型

SGMLTEXT，XML，FREEWORD

NUMBER

×

×

×

×

×

CHAR

VARCHAR2

×

×

×

×

×

NCHAR

NVARCHAR2

×

×

×

×

×

DATE※4

○※2

○※3

○※10

×

×

LONG

×

×

×

○

×

LONG RAW

×

×

×

○

×

RAW

×

×

×

○

×

BLOB

CLOB

NCLOB

BFILE

×

×

×

○

×

（凡例）

○：変換できます。

×：変換できません。

注※1

文字属性を数データに変換する場合，文字属性のデータは1バイトコードの数値文字列である必要があります。

注※2

日付情報だけを取り出します。また，日付情報が紀元前の場合はエラーとし処理を中止します。

注※3

時刻情報だけを取り出します。

注※4

一つのDATE属性列を反映側の日付データと時刻データの2列に変換したい場合は，DATE属性列を2列分抽出する必要があります。

注※5

この組み合わせで実行する場合の注意を次に示します。

抽出側のデータ長＜反映側のデータ長の場合，1バイトの空白を設定します。

抽出側のデータ内容を，そのまま反映側に格納します。

注※6

この組み合わせで実行する場合の注意を次に示します。

抽出側のデータ長≦2×反映側の文字数である必要があります。

抽出側のデータ長＜反映側のデータ長の場合，2バイトの空白を設定します。

抽出側のデータ長が奇数バイトの場合，1バイトの空白を付加して偶数バイトに調整します。

注※7

次の場合は，データの切り捨てが発生するため注意してください。

ただし，環境変数XTERRLEVELに0以外を指定した場合は，指定に従って処理されます。

文字データ，混在文字データ，各国文字データの場合

抽出側のデータ長＞反映側のデータ長

注※8

次の場合は，データの切り捨てが発生するため注意してください。

DECの場合

抽出側の整数部のけた数＞反映側の整数部のけた数

注※9

次の場合は，データの変換はできません。

ただし，環境変数XTLOBBUFSIZEが指定された場合は，環境変数XTERRLEVELの指定に従って処理されます。

抽出側のデータ長＞反映側のデータ長

注※10

日付情報が紀元前の場合はエラーとなります。反映側に小数秒が定義されているとき（TIMESTAMP(0)以外），余った後ろに0x00を埋めます。

注※11

反映側が文字データの場合，環境変数XTORANCSETにutf-16を指定して文字集合列を抽出・反映するときの注意を次に示します。

2×抽出側NCHARの文字数=反映側CHARの文字数である必要があります。

2×抽出側NVARCHARの文字数=反映側VARCHARの文字数である必要があります。

3.2.4　抽出したデータの文字コード変換

異なる文字コードのシステム間でデータ抽出・反映する場合，環境変数の指定に従い，抽出したデータの文字コードを反映側の文字コードに合わせて変換できます。

ORACLEから抽出したデータを反映するときに，変換できる文字コードについては，「3.1.4　抽出したデータの文字コード変換」を参照してください。この機能の使用方法については，「5.1.3(3)文字コード変換機能」を参照してください。

3.2.5　文字集合データの抽出，反映

環境変数XTORANCSETにutf-16を指定した場合，文字集合UTF-16が定義された表データをデータ連携できます。

このとき環境変数XTNLDFLTに2は指定できません。

環境変数XTORANCSETを省略またはdefaultを指定した場合，DB破壊が起こるおそれがありますので，環境変数XTNLDFLTに0および1は絶対に指定しないでください。

(1)　HiRDBへの反映の場合

HiRDBへ反映する場合，文字集合UTF-16が定義された表データをデータ連携できます。ただし，次の条件を満たす必要があります。

NCHAR属性がUTF-16でセットアップされている

抽出列と反映列の属性が次の組み合わせで，かつデータ長が同じである

NCHAR，CHAR

NVARCHAR，VARCHAR

NCHAR属性以外の列，および文字集合以外の列は連携できません。

NCHAR属性以外の文字集合列は文字コード変換します。抽出側の環境変数XTDATALOCALEにORACLE用環境変数NLS_LANGと同じロケール，反映側の環境変数XTDATALOCALEにutf-8を指定してください。

(2)　バイナリファイル，およびDATファイルへの反映の場合

バイナリファイル，およびDATファイルへ反映する場合，文字集合UTF-16が定義された表データをデータ連携できます。ただし，次の条件を満たす必要があります。

NCHAR属性がUTF-16でセットアップされている

反映情報ファイルを指定する場合，属性と定義長が一致している

NCHAR属性以外の文字集合列は文字コード変換します。抽出側の環境変数XTDATALOCALEにNLS_LANGと同じロケール，反映側の環境変数XTDATALOCALEにutf-16BE，またはutf-16LEを指定してください。

3.3　データの抽出（SQL Server）

HiRDB Dataextractorのデータの抽出とは，DBからデータを抽出し，反映側システムへ送信するまでをいいます。そのときに，必要なデータだけを抽出したり，抽出したデータに任意のフィールドを追加したりできます。

SQL ServerのDBからデータを抽出して，HiRDBのDBヘデータを反映する場合について説明します。

SQL ServerのDBからデータを抽出する場合，HiRDB Dataextractorが使用するSQL Server抽出ライブラリを事前にユーザ環境で作成する必要があります。

3.3.1　必要なデータの抽出

SQL ServerのDBからデータを抽出する場合はxtrepSを使用します。xtrepSコマンドで，抽出する表の名称や抽出方法を指定して，必要なデータだけを抽出できます。

HiRDB Dataextractorは，抽出したデータを反映対象の表の左の列から順に対応づけて反映します。このため，抽出対象の表と反映対象の表とで表の形式（列数，列の並び順）が異なる場合は，xtrepSコマンドを使用して反映対象の表の形式に合わせてデータを抽出する必要があります。

HiRDB Dataextractorでは次の抽出ができます。

表単位の抽出

抽出する列の選択，並べ替え

抽出する行の選択，並べ替え

ナル値の既定値の選択

詳しい内容については「3.1.1　必要なデータの抽出」を参照してください。ただし，xtrepコマンドはxtrepSコマンドとなります。

3.3.2　抽出したデータへの任意の列の追加

内容については「3.1.2　抽出したデータへの任意の列の追加」を参照してください。

ただし，xtrepコマンドはxtrepSコマンドとなります。

3.3.3　抽出したデータのデータ型変換

HiRDB Dataextractorで変換および比較できるデータ型を，「表3-12　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（1/2）」，「表3-13　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（2/2）」に示します。

データを反映するとき，HiRDB Dataextractorは抽出対象の列と反映対象の列とを比較し，「表3-12　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（1/2）」，「表3-13　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（2/2）」に示すデータ型の組み合わせであればデータ型を変換します。

また抽出する行を選択する場合，表式記述ファイルの条件の指定が「表3-12　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（1/2）」，「表3-13　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（2/2）」に示すデータ型の組み合わせであれば，HiRDB Dataextractorは指定されたデータを比較します。

表3‒12　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（1/2）

抽出側のデータ型(SQL Server内部データ型)

反映側（HiRDB）のデータ型

数データ

INT，SMALLINT，FLOAT，SMALLFLT

数データ

DECIMAL

文字データ

CHAR※1※2

文字データ

VARCHAR※1※2

混在文字データ

MCHAR，MVARCHAR※1※2

bigint

○※7

×※8

○

○

○

int

smallint

tinyint

bit

decimal(p1,s1)

○※7

○※8

○

○

○

numeric(p1,s1)

money

smallmoney

float(f)

○※7

×※8

○

○

○

real

char(c1)

○※9

×※8

○

○

○

varchar(c1)

nchar(n1)

×

×

×※13

×※13

○

nvarchar(n1)

datetime※11

×

×

○

○

○

smalldatetime※11

binary(b1)

×

×

×

○※12

×

varbinary(b1)

sql_variant

表3‒13　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（2/2）

抽出側のデータ型(SQL Server内部データ型)

反映側（HiRDB）のデータ型

各国文字データ

NCHAR，NVARCHAR※2※3

日付データ，時刻データ

DATE，

TIME※4

日間隔データ，時間隔データ

YEAR，

HOUR※4

時刻印データ

TIMESTAMP※5

長大データBLOB，BINARY※6

抽象データ型

SGMLTEXT，XML，FREEWORD

bigint

×

×

×

×

×

×

int

smallint

tinyint

bit

decimal(p1,s1)

numeric(p1,s1)

money

smallmoney

float(f)

real

char(c1)

○

○※10

×

×

×

×

varchar(c1)

○

×

×

×

×

×

nchar(n1)

nvarchar(n1)

datetime※11

×

○

○

○

×

×

smalldatetime※11

binary(b1)

×

×

×

×

○

×

varbinary(b1)

sql_variant

×

×

×

×

×

×

ユーザ定義型の場合は，データベース型マッピングに従います。

（凡例）

○：変換できます。

×：変換できません。

注※1

この組み合わせで実行する場合の注意を次に示します。

抽出側のデータ長＜反映側のデータ長の場合，1バイトの空白が設定されます。

注※2

次の場合は，データの切り捨てが発生するため注意してください。

文字データ，混在文字データ，各国文字データの場合

抽出側のデータ長＞反映側のデータ長

切り捨てが発生した場合は，環境変数XTERRLEVELの指定に従って処理されます。

注※3

この組み合わせで実行する場合の注意を次に示します。

抽出側のデータ長≦2×反映側の文字数である必要があります。

抽出側のデータ長＜反映側のデータ長の場合，残りの領域に1バイトの空白が設定されます。

注※4

DATE，およびYEAR型に反映する場合は，日付情報だけが取り出されて反映されます。

TIME，およびHOUR型に反映する場合は，時刻情報だけが取り出されて反映されます。

datetime型からTIME，およびHOUR型に反映する場合，ミリ秒以下は切り捨てられますが，処理は続行されます。

注※5

datetime型からの反映時，TIMESTAMP型の小数けたが3けた未満の場合は切り捨てられます。長い場合は0x00が設定されます。

切り捨てが発生した場合は，環境変数XTERRLEVELの指定に従って処理されます。

smalldatetime型からの反映時，秒以下は0x00が設定されます。

注※6

次の場合は，データの切り捨てが発生するため注意してください。

抽出側のデータ長＞反映側のデータ長

ただし，環境変数XTLOBBUFSIZEが指定されている場合は，環境変数XTERRLEVELの指定に従って処理されます。

注※7

次の場合は，小数部データの切り捨てが発生するため注意してください。

抽出側の小数部のけた数＞反映側の小数部のけた数

JXU7210Iメッセージが出力されますが，処理は続行されます。

注※8

HiRDBのDECIMAL型へ反映する場合は属性（精度，および位取り）が一致している必要があります。属性が異なる場合は，JXU7211Eメッセージが出力され，エラーとなります。

money型は，DECIMAL（19,4）として，smallmoney型はDECIMAL（10,4）として扱われます。

属性が異なる場合で，HiRDBのDECIMAL型に反映したいときは，列名記述ファイルに，CAST関数で反映側のDECIMAL属性での抽出を指定してください。

抽出側がSQL Serverの表Sの列S1（NUMERIC（10,5））で，反映側がHiRDBの表Hの列H1（DECIMAL（20,5））の場合のコマンド指定例を示します。

コマンド指定例

xtrepS　-o　-s　C:¥win32app¥Hitachi¥hirdbxt¥conf¥clm　-r　表H　表S

C:¥win32app¥Hitachi¥hirdbxt¥conf¥clmの内容

cast(列S1 as decimal(20,5))

注※9

文字属性を数データに変換する場合，文字属性のデータは1バイトコードの数値文字列である必要があります。

注※10

次の形式のデータだけを抽出対象とします。それ以外の場合はエラーとなります。

抽出側（SQL Server）

反映側（HiRDB）

データ型

データ形式

データ型

CHAR(10)

"YYYY-MM-DD"

DATE

CHAR(8)

"HH:MM:SS"

TIME

注※11

一つのdatetime属性またはsmalldatetime属性の列を反映側の日付データと時刻データの2列に変換したい場合は，datetimeまたはsmalldatetime属性の列を2列分抽出する必要があります。

注※12

文字型で抽出します。そのため，binary型またはvarbinary型で登録したデータを抽出した場合，格納されているデータは16進数がそのまま文字に変換され抽出されます。

（例）

格納データが0x616263（"abc"）の場合，抽出データは0x363136323633（"616263"）になります。

binary形式で抽出したい場合は，CONVERT関数で該当する列をvarchar型にしてから抽出してください。抽出側がSQL Serverの表Sの列S1 sql_variantで，反映側がHiRDBの表Hの列H1 varchar（8000）の場合のコマンド指定例を次に示します。

コマンド指定例

xtrepS　-o　-s　C:¥win32app¥Hitachi¥hirdbxt¥conf¥clm　-r　表H　表S

C:¥win32app¥Hitachi¥hirdbxt¥conf¥clmの内容

convert(varchar,列S1)

注※13

反映側が文字データの場合，環境変数XTSQLNCSETにutf-16を指定して文字集合列を抽出・反映するときの注意を次に示します。

2×抽出側NCHARの文字数=反映側CHARの文字数である必要があります。

2×抽出側NVARCHARの文字数=反映側VARCHARの文字数である必要があります。

3.3.4　抽出したデータの文字コード変換

異なる文字コードのシステム間でデータ抽出・反映する場合，環境変数の指定に従い，抽出したデータの文字コードを反映側の文字コードに合わせて変換できます。

SQL Serverから抽出したデータを反映するときに，変換できる文字コードについては，「3.1.4　抽出したデータの文字コード変換」を参照してください。この機能の使用方法については，「6.1.3(3)文字コード変換機能」を参照してください。

3.3.5　文字集合データの抽出，反映

環境変数XTSQLNCSETにutf-16を指定した場合，文字集合UTF-16が定義された表データをデータ連携できます。

このとき環境変数XTNLDFLTに2は指定できません。

環境変数XTSQLNCSETを省略またはdefaultを指定した場合，DB破壊が起こるおそれがありますので，環境変数XTNLDFLTに0および1は絶対に指定しないでください。

(1)　HiRDBへの反映の場合

HiRDBへ反映する場合，文字集合UTF-16が定義された表データをデータ連携できます。ただし，次の条件を満たす必要があります。

抽出列と反映列が次の組み合わせで，かつデータ長が同じである

NCHAR，CHAR

NVARCHAR，VARCHAR

NCHAR属性以外の列，および文字集合以外の列は連携できません。

NCHAR属性以外の文字集合列は文字コード変換します。CHAR属性の文字集合列の場合，抽出側の環境変数XTDATALOCALEにsjis，反映側の環境変数XTDATALOCALEにutf-8を指定してください。

(2)　バイナリファイル，およびDATファイルへの反映の場合

バイナリファイル，およびDATファイルへ反映する場合，文字集合UTF-16が定義された表データをデータ連携できます。ただし，反映情報ファイルを指定する場合，抽出列と反映列の属性と定義長が一致している必要があります。

NCHAR属性以外の文字集合列は文字コード変換します。抽出側の環境変数XTDATALOCALEにsjis，反映側の環境変数XTDATALOCALEにutf-16BE，またはutf-16LEを指定してください。

3.4　データの反映

HiRDB Dataextractorのデータの反映とは，抽出側システムから送信されたデータを受信して，反映側のHiRDBのDBへ反映するまでをいいます。

ここでは，HiRDBのDBからデータを抽出して，HiRDBのDBヘデータを反映する場合について説明します。XDM/RDのDBまたは順編成データセットからデータを抽出してHiRDBのDBヘデータを反映する場合については，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

3.4.1　データの格納方法の指定

HiRDBの表に格納する方法には，次の2種類があります。

表単位の格納（xtrepコマンド−ｊオプション省略）

RDエリア単位の格納（xtrepコマンド−ｊオプション指定）

(1)　表単位の格納

HiRDBの表へ，表単位に格納する方法です。

xtrepコマンドで−ｊオプションを指定していない場合に，表単位の格納になります。

格納対象のHiRDBの表が横分割されている場合には，RDエリア単位の格納の方が，複数のRDエリアに対する格納処理を並列に実行できるため，格納時間を短縮できます。

(2)　RDエリア単位の格納

HiRDBの表へ，RDエリア単位に格納する方法です。

xtrepコマンドで−ｊオプションに格納対象のRDエリア名を指定した場合に，RDエリア単位の格納になります。HiRDBの表が横分割表の場合には，RDエリア単位の格納では，RDエリアごとにHiRDB Dataextractorを起動することによって格納処理を並列に実行できるため，表単位の格納に比較して格納時間を短縮できます。

RDエリア単位の格納は，次に示す横分割方法に対して有効となります。

キーレンジ分割

RDエリア単位の格納の概要を，次の図に示します。

図3‒11　RDエリア単位の格納の概要

RDエリア単位の格納での運用方法を，次の表に示します。

表3‒14　RDエリア単位の格納での運用方法

横分割方法

HiRDBのpdloadの処理

抽出時の運用方法

格納時の運用方法

キーレンジ分割

入力されたデータが，指定されたRDエリアの格納範囲のデータかどうかをチェックしてから格納します。格納範囲外のデータの場合は，エラーデータファイルの指定（xtrepコマンド−ｑオプション）があるときには，その行データをエラーデータファイルに出力します。

抽出時に抽出条件を指定して，格納するRDエリアの格納条件に合ったデータを抽出します。

サーバ内の横分割表の場合，非分割キーインデクスはデータの格納後にHiRDBの再編成ユティリティで作成することが必要です。「注意事項」を参照してください。

エラーデータファイルはpdloadの入力ファイルとして利用できます。エラーデータファイルに格納範囲外のデータが出力された場合は，出力されているデータを確認して，必要であればpdloadを使用して表に格納します。

注意事項

サーバ内の横分割表の場合の非分割キーインデクスの作成

サーバ内の横分割表の場合，RDエリア単位の格納では，xtrepコマンドの−ｉオプションでｃ（インデクスの一括作成）を指定しても，非分割キーインデクスについてはインデクス情報出力モードが仮定されます。この場合，データの格納後にHiRDBのデータベース再編成ユティリティ（pdrorg）を使用して，非分割キーインデクスを一括作成することが必要です（pdrorgの-kオプションにikmkを指定します）。

HiRDBのデータベース再編成ユティリティについては，マニュアル「HiRDB コマンドリファレンス」を参照してください。

なお，サーバ間の横分割表の場合は，xtrepコマンドの−ｉオプションでの指定に従ってインデクスが作成されます。

3.4.2　データの反映方法の指定

HiRDB Dataextractorは，データの反映時にHiRDBのデータベース作成ユティリティ（pdload）を使用します。

xtrepコマンドでのオプションの指定によって，次の反映方法が指定できます。

抽出データの格納方式（−dオプション）

抽出データの表への格納方式が指定できます。表の格納方式には，次の2種類があります。

表の既存のデータをすべて削除してから，抽出データを格納します。

表の既存のデータを残して，抽出データを追加します。

インデクス作成方法（−iオプション）

インデクス作成方法が指定できます。

インデクス作成方法には，次の4種類があります。

インデクス一括作成モード

表の作成処理に引き続き，インデクスを一括作成します。

インデクス情報出力モード

インデクス情報だけをインデクス情報ファイルに出力します。

インデクス更新モード

行を格納するたびにインデクスを更新します。

インデクス情報出力抑止モード

インデクスは更新しません。

pdloadコマンドのパラメタ指定（−Iオプション）

pdloadコマンドのパラメタをユーザ任意に指定できます。この機能の使用方法については，「4.2.3　データ抽出・反映の付加機能」，「5.1.3　データ抽出・反映の付加機能」または「6.1.3　データ抽出・反映の付加機能」を参照してください。

ログ取得方式（−lオプション）

ログの取得方法が選択できます。運用に応じて取得するログを選択することによって，ログ出力処理時間を短縮できます。

一括出力ページ数（−nオプション）

表に対して，一括して出力するページ数を指定できます。一括出力ページ数を指定すると，指定したページ数単位で一括出力をするので，反映処理の処理効率を向上できます。

長さ０のデータの格納（−zオプション）

長さ０の文字を格納する場合に指定します。

このオプションを指定した場合は，長さ０の文字が格納できます。

3.4.3　データ型の変換

データを反映する場合に，抽出側の表の列のデータ型と，反映側の表の列のデータ型とが異なるとき，変換できるデータ型ならばHiRDBの列のデータ型に変換して反映します。変換できるデータ型については，「3.1.3　抽出したデータのデータ型変換」，「3.2.3　抽出したデータのデータ型変換」または「3.3.3　抽出したデータのデータ型変換」を参照してください。

3.4.4　文字コードの変換

ORACLEとHiRDB間，SQL ServerとHiRDB間，またはHiRDB間でのデータ連携の場合，環境変数の指定に従い，文字コードを変換してデータを反映します。変換できる文字コードについては，「3.1.4　抽出したデータの文字コード変換」を参照してください。また，この機能の使用方法については，「4.2.3　データ抽出・反映の付加機能」，「5.1.3　データ抽出・反映の付加機能」または「6.1.3　データ抽出・反映の付加機能」を参照してください。

3.4.5　出力ファイルの作成

xtrepコマンドでのオプションの指定によって，pdloadを起動する前に抽出したデータをファイルに出力できます。このファイルを出力ファイルと呼びます。作成する出力ファイルの形式は，バイナリ形式です。バイナリ形式の詳細については，「表4-15　列データの記述形式（バイナリ形式）」を参照してください。

出力ファイルへの出力は，−oオプションまたは−Oオプションで指定します。表への格納後の出力ファイルの処理方法によって，−oオプションまたは−Oオプションのどちらかを指定します。出力ファイルの処理方法には，次の2種類があります。

表への格納後に出力ファイルを保存する（−oオプション）

反映処理終了後に出力ファイルを保存する場合は，−oオプションを指定します。この場合，作成した出力ファイルを反映処理終了後も削除しません。このため，作成した出力ファイルをバックアップとして利用できます。障害発生時などに，作成した出力ファイルを基にHiRDBの表を再作成したい場合は，HiRDBのデータベース作成ユティリティを使用してください。

表への格納後に出力ファイルを削除する（−Oオプション）

反映処理終了後に出力ファイルを削除したい場合は−Oオプションを指定します。

抽出した列にBLOB列がある場合は，出力ファイルとは別にLOB入力ファイルが作成されます。LOB入力ファイルはLOBデータ単位に作成されます。LOB入力ファイルを格納するためのディレクトリは，−bオプションで指定できます。反映処理終了後のLOB入力ファイルの処理方式も，−oオプションまたは−Oオプションで決定します。なお，環境変数XTLOBKINDの指定によって，LOB入力ファイルを作成しないで，BLOB列のデータをBLOB列以外のデータと同一の出力ファイルに格納することもできます。

出力ファイルおよびLOB入力ファイルの作成時に，すでに作成対象のファイルがある場合に上書きしてもよいかどうかを−yオプションで指定します。作成対象のファイルがすでに存在する場合，−yオプション指定時はすでにあるファイルを削除してからデータをファイルに出力します。−yオプション省略時はメッセージを出力して処理を終了します。

出力ファイルおよびLOB入力ファイルは，反映側HiRDBの次のサーバのホストに作成されます。

HiRDB/シングルサーバの場合

シングルサーバのあるサーバ

HiRDB/パラレルサーバの場合

−fオプション指定時

−fオプションで指定したフロントエンドサーバ（FES）またはバックエンドサーバ（BES）。

−fオプション省略時

表単位の格納の場合は，HiRDBのシステム共通定義（pdsys）のpdstartコマンドで指定した最初のFESのサーバ。

RDエリア単位の格納の場合は，データを格納するRDエリアのあるバックエンドサーバ（BES）。

3.4.6　データ反映時の注意事項

ログレスモード（−lオプションにｎを指定）でHiRDBへデータを反映すると，反映途中で障害が発生したとき元の状態に回復されません。

障害に備えて事前にバックアップを取得してください。

データの反映時にpdloadがエラーリターンするとpdloadが実行中に作成したファイルが残ることがあるため，不要であれば削除してください。作成されるファイルの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

HiRDB DataextractorではHiRDBのデータベース作成ユティリティ（pdload）を起動する際，pdloadの−xオプションを指定します。

このオプションが不要な場合は，ローダのパラメタユーザ任意指定機能を使用してください。機能の使用方法については，「4.2.3(2)ローダのパラメタユーザ任意指定機能」，「5.1.3(2)ローダのパラメタユーザ任意指定機能」または「6.1.3(2)ローダのパラメタユーザ任意指定機能」を参照してください。

反映表にクラスタキーが定義してあり，クラスタキー順にデータを反映させたい場合は，抽出表のクラスタキーに対応する列に対し，SELECT文のORDER BY句を列名記述ファイルに指定して抽出をしてください。なお，コード変換機能を使用すると，データ抽出後にコード変換を行うため昇順（降順）にならない場合があります。この場合は，データの反映後，HiRDBのデータベース再編成ユティリティで再編成をしてください。

3.5　ファイルの作成

HiRDB Dataextractorのファイルの作成とは，抽出側システムから送信されたデータを受信して，ファイルの作成先のホストのファイルに格納するまでをいいます。

HiRDBのDBからデータを抽出して，DBシステムへの入力用になるファイルを作成できます。また，XDM/XTと組み合わせて使用することによって，メインフレーム側のDBから送信されたデータで，DBシステムへの入力用になるファイルを作成できます。

ファイル作成機能で作成したファイルを利用することによって，HiRDB以外のDBシステムへも，抽出したデータを反映できます。

ここでは，HiRDB Dataextractorでデータを抽出して，ファイルの作成先のホストにファイルを作成する場合について説明します。メインフレーム側のDBからデータを抽出してファイルを作成する場合については，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

3.5.1　作成するファイルの形式

ファイルの作成は，xtrepコマンド，xtrepOコマンド，またはxtrepSコマンドの−Rオプションで指定します。

−Rオプションでの指定によって，作成するファイルの形式を選択できます。

ファイルの形式には，次の2種類があります。

バイナリ形式

バイナリ形式でファイルに格納します。バイナリ形式の詳細については，

「表4-15　列データの記述形式（バイナリ形式）」を参照してください。

DAT形式

DAT形式では，抽出したデータを数値データも文字に変換してファイルに格納します。DAT形式の詳細については，「表4-17　列データの記述形式（DAT形式）」を参照してください。

DAT形式は，一般にCSV形式と呼ばれる形式です。

DAT形式の場合は，ファイルの作成時に，セパレータ文字，囲み文字，および改行文字を変更できます。詳細については，「2.2.3　環境変数の設定」の環境変数XTDATSEPARATER，XTDATENCLOSE，またはXTDATCRLFを参照してください。また，セパレータ文字については，「4.2.2　xtrepコマンド」の-Rオプションを参照してください。

なお，作成したファイルを反映対象のDBシステムでの入力ファイルとして使用する場合は，反映対象のDBシステムでの規則に従ってセパレータ文字，囲み文字，および改行文字を指定することが必要です。

3.5.2　作成するファイルのデータ型

作成するファイルのデータ型は抽出するDBによって異なります。

HiRDBの場合

抽出したHiRDBと同一のデータ型を仮定します。ただし，次の抽象データ型を指定する場合，注意が必要です。

SGMLTEXT型は反映情報ファイルにSGMLTEXTデータ型を指定しない場合，BLOB型となります。

XML型は反映情報ファイルにXMLデータ型を指定しない場合，BINARY型になります。

FREEWORD型は反映情報ファイルにFREEWORDデータ型を指定しない場合，VARCHAR型になります。

ほかのデータ型も−Ｌオプションを指定することでデータ型を変更できます。

ORACLEまたはSQL Serverの場合

抽出したデータは， HiRDBへ反映することを前提としているためHiRDBのデータ型に変換します。変換するデータ型は，ORACLEまたはSQL Serverのデータ型によって仮定するデータ型が決まっていますが，−Lオプションで変更することもできます。

3.5.3　作成するファイルの文字コード

ORACLEとHiRDB間，SQL ServerとHiRDB間，またはHiRDB間でのデータ連携の場合，環境変数の指定に従い，文字コードを変換してファイルを作成します。変換できる文字コードについては，「3.1.4　抽出したデータの文字コード変換」を参照してください。また，この機能の使用方法については，「4.2.3　データ抽出・反映の付加機能」，「5.1.3　データ抽出・反映の付加機能」または「6.1.3　データ抽出・反映の付加機能」を参照してください。

3.5.4　作成するファイル名の指定

作成するファイルの名称は，−oオプションで指定します。このファイルを出力ファイルと呼びます。抽出した列にBLOB列がある場合は，出力ファイルとは別にLOB入力ファイルが作成されます。LOB入力ファイルはLOBデータ単位に作成されます。LOB入力ファイルを格納するためのディレクトリは，−bオプションで指定できます。なお，環境変数XTLOBKINDの指定によって，LOB入力ファイルを作成しないで，BLOB列のデータをBLOB列以外のデータと同一の出力ファイルに格納することもできます。

出力ファイルおよびLOB入力ファイルの作成時に，すでに作成対象のファイルがある場合に上書きしてもよいかどうかを−yオプションで指定します。作成対象のファイルがすでに存在する場合，−yオプション指定時はすでにあるファイルを削除してからデータをファイルに出力します。−yオプション省略時はメッセージを出力して処理を終了します。

出力ファイルおよびLOB入力ファイルは，次のファイル作成側のホストに作成されます。

−hオプション指定時は，−hオプションで指定したホスト

−hオプション省略時は，環境変数XTHOSTで指定したホスト

3.5.5　シェルスクリプトの実行

ファイル作成後に引き続いて，ユーザ任意の処理を実行したい場合は，実行するシェルスクリプトのファイル名を−xオプションで指定します。

シェルスクリプトのファイル名が指定されている場合，HiRDB Dataextractorはファイル作成後に，ユーザが作成したシェルスクリプトに制御を渡し，シェルスクリプトの実行完了を待ちます。シェルスクリプトの実行完了後，HiRDB Dataextractorに制御が戻り，HiRDB Dataextractorは処理を終了します。

4　HiRDBからのデータ抽出，HiRDBへのデータ反映

HiRDBのデータベースからの，データの抽出，HiRDBの表への反映，およびファイル作成時の指定方法について説明します。

4.1　抽出・反映時の規則

HiRDBのDBからデータを抽出するとき，および反映するときの規則について説明します。

4.1.1　抽出時の規則

データ抽出時のHiRDB Dataextractorの規則について説明します。

(1)　排他制御

HiRDB Dataextractorは，データ抽出時にxtrepコマンドの−gオプションの指定によって，表に排他を掛けることができます。排他を掛けると，排他制御処理時間を短縮できます。−gオプションの指定と排他制御モードの関連を，次の表に示します。

排他制御の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

表4‒1　−gオプションの指定と排他制御モードの関連

−gオプションの指定

資源

RDエリア

表

行

キー値

表用

インデクス用

あり

（LOCK文での排他制御をしない）

SR

SR

SR

PR

PR

なし

（LOCK文を発行して排他制御をする）

SR

−

PR

−

−

（凡例）

SR：意図共用モード

PR：共用モード

−：排他を掛けません。

4.1.2　反映時の規則

データ反映時のHiRDB Dataextractorの規則について説明します。

データの反映は，データを抽出したHiRDBシステムと同一のHiRDBシステムにも，異なるHiRDBシステムにもできます。

ただし，一つの表から抽出して，その同一の表へ反映することはできません。実行した場合，動作結果は保証されません。

4.2　コマンド

HiRDB Dataextractorを使用して，HiRDBのDBからデータを抽出してHiRDBのDBへデータを反映するとき，および抽出したデータをファイルへ格納するときには，HiRDB Dataextractorが提供するコマンドで操作します。

4.2.1　コマンドの記述形式

コマンドの記述形式について説明します。

コマンドの記述形式を次に示します。

記述形式

コマンド名　オプション　コマンド引数

(1)　コマンド名

コマンド名は，実行するコマンドのファイル名です。

コマンド実行者は，自分の環境にコマンドを実行するための環境変数を指定する必要があります。xtrepコマンドを実行するために必要な環境変数の設定方法については，「2.2.3　環境変数の設定」を参照してください。

(2)　オプション

オプションでは，次のどちらかについて指定します。

コマンドの操作そのものの修飾

操作の対象物の修飾

オプションの指定方法について説明します。

次の説明中に使用する$はシェルのプロンプト，cmdはコマンド名を示します。

オプションはマイナス記号（−）で始まる文字列です。フラグ引数は指定しないか，または1種類のフラグ引数を指定します。

オプションの記述形式を次に示します。

−オプションフラグ

または

−オプションフラグ　フラグ引数

（凡例）

オプションフラグ：１文字の英数字（英大文字と英小文字は区別されます）。

フラグ引数：オプションフラグに対する引数（コンマ（，）で区切って複数指定できます）。

フラグ引数を必要とするオプションフラグのフラグ引数は省略できません。

フラグ引数中に空白を含める場合で，シェルから入力するときには，前後を引用符（"）で囲んでください。

（例）

1　2を引数に持つオプションfは，次のように記述します。

$ cmd -f "1 2"

同じオプションフラグを2回以上指定することはできません。

オプションは，コマンド引数より前に指定してください。

(3)　コマンド引数

コマンド引数は，コマンド操作の直接の対象になるものを指定します。

4.2.2　xtrepコマンド

(1)　機能

指定された抽出対象の表のデータを抽出して，反映対象の表に反映します。

また，オペランドの指定によって，指定された抽出対象の表のデータを抽出して，ファイルを作成します。

(2)　実行者

特に制約はありませんが，環境変数PDUSERに指定するユーザには制約があります。詳細は「2.2.3(2)環境変数の設定方法」を参照してください。

また，反映側でHiRDB Dataextractorを起動するユーザにも制約があります。詳細は「2.2.4(3)/etc/inetd.confの設定」または「7.2.2　OSI使用時のHiRDB Dataextractorの開始と終了」を参照してください。

(3)　実行するサーバマシン

データ抽出の対象にするHiRDBのサーバマシンでコマンドを実行します。コマンドを実行するサーバマシンは，接続するHiRDBシステムがHiRDB/シングルサーバの場合とHiRDB/パラレルサーバの場合とで異なります。コマンドを実行するサーバマシンを次に示します。

HiRDB/シングルサーバの場合

シングルサーバのあるサーバマシン

HiRDB/パラレルサーバの場合

次のどれかのサーバのあるサーバマシン

システムマネジャ

フロントエンドサーバ

バックエンドサーバ

ディクショナリサーバ

(4)　形式

ｘｔｒｅｐ
　　　〔−ｒ　〔認可識別子．〕表識別子〕
　　　〔−Ｒ　〔｛ｂｉｎ｜ｄａｔ｝〕〔，セパレータ文字〕〕
　　　〔−ｏ　〔｛出力ファイル名｜出力ディレクトリ名｝
　　　　　　　　〔，｛出力ファイル名｜出力ディレクトリ名｝〕…〕〕
　　　〔−Ｏ　〔｛出力ファイル名｜出力ディレクトリ名｝
　　　　　　　　〔，｛出力ファイル名｜出力ディレクトリ名｝〕…〕〕
　　　〔−ｙ〕
　　　〔−ｊ　ＲＤエリア名〕
　　　〔−ｈ　反映先ホスト名〕
　　　〔−Ｈ　シングルサーバのホスト名またはシステムマネジャのホスト名
　　　　　〔，フロントエンドサーバのホスト名またはバックエンドサーバのホスト名〕〕
　　　〔−ｐ　ポート番号〕
　　　〔−ｆ　フロントエンドサーバ名またはバックエンドサーバ名〕
　　　〔−ｄ〕
　　　〔−ｉ　インデクス作成方法〕
　　　〔−Ｉ　〔ｐｄｌｏａｄ制御情報環境変数名〕
　　　　　　　〔，ｐｄｌｏａｄコマンドライン情報環境変数名〕
　　　　　　　〔，ｐｄｌｏａｄ制御情報ファイルｓｏｕｒｃｅ文情報環境変数名〕〕
　　　〔−ｌ　ログ取得方式〕
　　　〔−Ｌ　反映情報ファイル名〕
　　　〔−ｎ　一括出力ページ数〕
　　　〔−ｚ〕
　　　〔−ｅ　エラーログファイル名〕
　　　〔−ｍ　経過メッセージ出力間隔〕
　　　〔−ｇ　〔排他情報ファイル名〕〕
　　　〔−ｓ　列名記述ファイル名〕
　　　〔−ｗ　表式記述ファイル名〕
　　　〔−ｖ　ナル値情報ファイル名〕
　　　〔−ｂ　ＬＯＢ入力ファイル格納用ディレクトリ名〕
　　　〔−ｑ　エラーデータファイル名〔，出力行数〕〕
　　　〔−ｘ　シェルスクリプトファイル名〕
　　　｛〔認可識別子．〕表識別子｜表式記述ファイル名｝

(5)　オプション

OSがWindowsの場合は「付録B.5　コマンドの指定方法」も参照してください。

●−ｒ　〔認可識別子．〕表識別子

反映対象にする表名を指定します。−Rオプションを指定している場合は，−rオプションは指定できません。−Rオプションを指定していない場合に−rオプションを省略したとき，または認可識別子を省略したときは次のように仮定されます。

−rオプションを省略した場合

認可識別子：

抽出対象の表に認可識別子の指定あり

　抽出対象の表に指定した認可識別子が仮定されます。

抽出対象の表に認可識別子の指定なし

　データの反映側のHiRDB Dataextractorが使用する環境変数PDUSERの値が仮定されます。

表識別子：

抽出対象の表の表識別子が仮定されます。

認可識別子を省略した場合

データの反映側のHiRDB Dataextractorが使用する環境変数PDUSERの値が仮定されます。

注意事項

認可識別子および表識別子の英小文字はすべて英大文字として扱われます。

認可識別子および表識別子の英小文字と英大文字とを区別したい場合は，認可識別子および表識別子をそれぞれ引用符（"）で囲み，さらにアポストロフィ（’）で囲む必要があります。アポストロフィ（’）は，認可識別子および表識別子の全体またはそれぞれを囲んでください。

表識別子にスペースを含む場合は，引用符（"）で囲み，さらにアポストロフィ（’）で囲んでください。

指定例

次の指定の場合は，両方ともUSER01.TABLE01として扱う。

user01.table01

"user01"."table01"

次の指定の場合は，両方ともuser01.table01として扱う。

'"user01"."table01"'

'"user01"'.'"table01"'

●−Ｒ　〔｛ｂｉｎ｜ｄａｔ｝〕〔，セパレータ文字〕

データの抽出後にファイルだけを作成する場合に，作成するファイルの形式を指定します。このオプションの指定がある場合は，HiRDB Dataextractorは抽出したデータを反映対象の表には格納しません。抽出したデータを，HiRDB Dataextractorを使用して反映対象の表に格納する場合には，このオプションは省略してください。−Rオプションを指定している場合は，−rオプションは指定できません。

作成するファイルの名称は，−oオプションで指定します。ファイルの形式については，「4.2.4(4)出力ファイル」を参照してください。

ファイル作成後に，ユーザが作成したシェルスクリプトを実行する場合は，実行するシェルスクリプトのファイル名を−xオプションで指定します。

ｂｉｎ：バイナリ形式のファイルを作成します。

バイナリ形式では，抽出したデータをHiRDBのDBに格納されている形式のとおりにファイルに格納します。

ｄａｔ：DAT形式のファイルを作成します。

DAT形式では，抽出したデータを数値データも文字に変換してファイルに格納します。

一般にCSV形式と呼ばれる形式です。

セパレータ文字　〜＜文字列＞((1けた))≪コンマ（，）≫

dat指定時に，各データ間の区切りに使用するセパレータ文字を指定します。bin指定時は指定できません。

dat指定時にセパレータ文字を省略した場合は，コンマ（，）が仮定されます。

ストローク（｜）など，シェルが別の意味（パイプ）で使用している文字やスペースを指定する場合は，引用符（"）で囲んで指定してください。

なお，作成したファイルを反映対象のDBシステムでの入力ファイルとして使用する場合は，反映対象のDBシステムでの規則に従ってセパレータ文字を指定することが必要です。

注意事項

セパレータ文字を指定する場合は，コンマ（，）の前後にスペースを入れないでください。

指定例

正しい例

-R dat,","

誤りの例

-R dat , ","：コンマ（，）の前後にスペースがあります。
-R ,","     ：bin指定時，セパレータ文字は指定できません。

このオプションのセパレータ文字と，反映側の環境変数XTDATSEPARATERを同時に指定した場合，反映側の環境変数XTDATSEPARATERの値が有効となります。

●−ｏ　〔｛出力ファイル名｜出力ディレクトリ名｝〔，｛出力ファイル名｜出力ディレクトリ名｝〕…〕　〜＜パス名＞((（1≦一つの名称のけた数≦255）×ファイル数≦合計511けた))

抽出したデータの出力ファイルへの出力を指定します。出力先を，ファイル名またはディレクトリ名で指定します。

出力ファイル名：指定値の末尾に／以外を指定します。

出力ディレクトリ名：指定値の末尾に／を指定します。

ディレクトリ名が指定された場合は，HiRDB Dataextractorが一意になるようにファイル名を付けてファイルを作成します。

−Rオプションの指定によって，ファイル作成後に表に反映するかどうかが決定します。

−Rオプション指定時

−Rオプション指定時は，出力ファイルを作成し，反映対象の表には反映しません。作成する出力ファイルの形式は，−Rオプションで指定できます。出力ファイルは，次のファイル作成側のホストに作成されます。

−hオプション指定時は，−hオプションで指定したホスト

−hオプション省略時は，環境変数XTHOSTで指定したホスト

−Rオプション省略時

−Rオプション省略時は，出力ファイル作成後に，反映対象の表に反映します。作成する出力ファイルの形式は，バイナリ形式です。出力ファイルは，反映側HiRDBの次のサーバのホストに作成されます。

HiRDB/シングルサーバの場合はシングルサーバ

HiRDB/パラレルサーバの場合

−fオプション指定時：−fオプションで指定したFESまたはBES

−fオプション省略時：−fオプション省略時仮定値のFESまたはBES

−oオプション指定時は，作成した出力ファイルおよびHiRDBのデータベース初期作成ユティリティが作成したファイルは，反映処理終了後も削除しません。このため，作成した出力ファイルをバックアップとして利用できます。障害発生時などに，作成した出力ファイルを基にHiRDBの表を再作成したい場合は，HiRDBのデータベース作成ユティリティを使用してください。

反映処理終了後に出力ファイルを削除したい場合は−Oオプションを指定します。−oオプションと−Oオプションを同時に指定することはできません。

−oオプション指定時に，すでに出力ファイルが作成されている場合の処理方法は，−yオプションで指定します。

このオプションを省略した場合は， HiRDB Dataextractorが/opt/HIRDBXT/spoolディレクトリ下に一意な名称のファイルを作成します。詳細は，「表2-3　HiRDB Dataextractorが作成するディレクトリおよびファイル」を参照してください。

注意事項

環境変数XTTMPDIRと出力ファイルの名称の長さの合計は，255けた以内にしてください。

指定値に￥を含む場合は，引用符（"）で囲んで指定してください。

−oオプションでの複数ファイル名指定およびディレクトリ名指定は，反映側またはファイル作成側のHiRDB Dataextractorがこの機能をサポートしている場合にだけ使用できます。サポートしていない場合には，反映側またはファイル作成側で，JXU7001Eメッセージを出力してエラーになります。また，抽出側がこの機能をサポートしていない場合には，指定された複数ファイル名またはディレクトリ名を一つのファイルの名称とみなして処理します。

指定例

xtrep -o /hd001/,/hd002/ TBL_NAME

/hd001/，/hd002/の下に一意の名称のファイルを作成して，反映対象の表に反映します。

●−Ｏ　〔｛出力ファイル名｜出力ディレクトリ名｝〔，｛出力ファイル名｜出力ディレクトリ名｝〕…〕　〜＜パス名＞((（1≦一つの名称のけた数≦255）×ファイル数≦合計511けた))

抽出したデータの出力ファイルへの出力を指定します。出力先を，ファイル名またはディレクトリ名で指定します。出力ファイル作成後に反映対象の表に反映し，反映が終了すると作成した出力ファイルを自動的に削除します。

出力ファイル名：指定値の末尾に／以外を指定します。

出力ディレクトリ名：指定値の末尾に／を指定します。

ディレクトリ名が指定された場合は，HiRDB Dataextractorが一意になるようにファイル名を付けてファイルを作成します。

作成する出力ファイルの形式は，バイナリ形式です。出力ファイルは，反映側HiRDBの次のサーバのホストに作成されます。

HiRDB/シングルサーバの場合はシングルサーバ

HiRDB/パラレルサーバの場合

−fオプション指定時：−fオプションで指定したFESまたはBES

−fオプション省略時：−fオプション省略時仮定値のFESまたはBES

反映処理終了後に出力ファイルを削除しない場合は−oオプションを，削除する場合は−Oオプションを指定します。−oオプションと−Oオプションを同時に指定することはできません。また，−Rオプションを指定している場合は，−Oオプションは指定できません。

−Oオプション指定時に，すでにファイルが作成されている場合の処理方法は，−yオプションで指定します。

−Oオプション指定時に作成する出力ファイルの名称は，−oオプション指定時と同じです。

注意事項

環境変数XTTMPDIRと出力ファイルの名称の長さの合計は，255けた以内にしてください。

指定値に￥を含む場合は，引用符（"）で囲んで指定してください。

−Oオプションでの複数ファイル名指定およびディレクトリ名指定は，反映側またはファイル作成側のHiRDB Dataextractorがこの機能をサポートしている場合にだけ使用できます。サポートしていない場合には，反映側またはファイル作成側で，JXU7001Eメッセージを出力してエラーになります。また，抽出側がこの機能をサポートしていない場合には，指定された複数ファイル名またはディレクトリ名を一つのファイルの名称とみなして処理します。

●−ｙ

ファイルの作成時に，すでに作成対象のファイルがある場合に上書きしてもよいかどうかを指定します。作成対象のファイルがすでに存在する場合，−yオプション指定時はすでにあるファイルを削除してからデータをファイルに出力します。−yオプション省略時はメッセージを出力して処理を終了します。

このオプションは，−oオプション，−Oオプション，または−bオプションのどれかを指定しているときにだけ指定できます。

このオプションの処理の対象になるファイルを，次に示します。

出力ファイル（−oオプション，−Oオプション指定時に作成される）

LOB入力ファイル格納用ディレクトリおよびLOB入力ファイル（抽出対象の表にBLOB列のデータがある場合に作成される）

ただし，作成対象のファイルのファイルモードによっては，上書きできない場合があります。

●−ｊ　ＲＤエリア名　〜＜識別子＞((1〜30))

横分割表に対して，RDエリア単位にデータを格納する場合に，データを格納するRDエリアの名称を指定します。−Rオプションを指定している場合は，−jオプションは指定できません。このオプションを省略した場合は，表単位にデータを格納します。

注意事項

RDエリアの英小文字はすべて英大文字として扱われます。

RDエリアの英小文字と英大文字とを区別したい場合，およびRDエリアに空白が含まれる場合は，RDエリアを引用符（"）で囲み，さらにアポストロフィ（’）で囲みます。

このオプションは，反映側またはファイル作成側のHiRDB Dataextractorがこの機能をサポートしている場合にだけ使用できます。サポートしていない場合には，反映側またはファイル作成側で，JXU7001Eメッセージを出力してエラーになります。

●−ｈ　反映先ホスト名

抽出したデータの，送信対象のホスト名を指定します。ホスト名の代わりにFQDNを指定することもできます。

抽出したデータを表に反映する場合は，次のサーバがあるホスト名を指定します。

HiRDB/シングルサーバの場合

シングルサーバ（SDS）

HiRDB/パラレルサーバの場合

システムマネジャ（MGR）

ファイル作成時は，ファイルを作成するホストのホスト名を指定します。

−hオプション省略時は，環境変数XTHOSTが仮定されます。指定するホスト名は，データの抽出側の/etc/hostsに記述しておいてください。記述方法は，「2.2.4　HiRDB Dataextractorを使用するために設定するファイル」を参照してください。

注意事項

抽出側のホストと反映側のホストが異なるLANで構成されている場合，このオプションを指定してxtrepコマンドを実行すると，コネクション確立エラーになります。この場合は，−Hオプションを指定して再実行してください。−hオプションと−Hオプションを同時に指定することはできません。

システムマネジャのホストとデータの転送先のサーバ（フロントエンドサーバまたはバックエンドサーバ）のホストは，抽出側のホストからアクセス可能である必要があります。

反映側HiRDBで系切り替え機能を使用する場合は，IPアドレスを引き継ぐホスト名を指定してください。

●−Ｈ　シングルサーバのホスト名またはシステムマネジャのホスト名〔，フロントエンドサーバのホスト名またはバックエンドサーバのホスト名〕

抽出したデータの，反映対象のホスト名を指定します。ホスト名の代わりにFQDNを指定することもできます。

抽出側のホストと反映側のホストが異なるLANで構成されている場合には，このオプションを指定してください。

データの反映側の，次のサーバがあるホスト名を指定します。

HiRDB/シングルサーバの場合

シングルサーバ（SDS）

HiRDB/パラレルサーバの場合

システムマネジャ（MGR），およびデータの転送先のサーバ（フロントエンドサーバ（FES）またはバックエンドサーバ（BES））

FESまたはBESのホスト名を省略した場合は，MGRのホストにFESまたはBESがあると仮定して処理されます。

−Hオプション省略時は，環境変数XTXHOSTが仮定されます。指定するホスト名は，データの抽出側の/etc/hostsに記述しておいてください。記述方法は，「2.2.4　HiRDB Dataextractorを使用するために設定するファイル」を参照してください。

注意事項

このオプションで指定したFESまたはBESのホストには，次のFESまたはBESがなければいけません。

−fオプション指定時：−fオプションで指定したFESまたはBES

−fオプション省略時：−fオプション省略時仮定値のFESまたはBES

−hオプションと−Hオプションを同時に指定することはできません。

−Rオプションを指定している場合は，−Hオプションは指定できません。

MGRのホストとデータの転送先のサーバのホストは，抽出側のホストからアクセス可能である必要があります。

反映側HiRDBで系切り替え機能を使用する場合は，IPアドレスを引き継ぐホスト名を指定してください。

●−ｐ　ポート番号　〜＜符号なし整数＞((1025〜65535))

−hオプションまたは−Hオプションで指定した次のホストで稼働する，HiRDB Dataextractorのポート番号を指定します。

HiRDB/シングルサーバの場合：シングルサーバのホスト

HiRDB/パラレルサーバの場合：

システムマネジャおよびデータの転送先のサーバのホスト

ファイル作成の場合：ファイルを作成するホスト

−pオプション省略時は環境変数XTPORTNOの値が仮定されます。指定するポート番号は，反映側またはファイル作成側の/etc/servicesでHiRDB Dataextractor用に割り当てたポート番号を指定してください。指定方法は，「2.2.4　HiRDB Dataextractorを使用するために設定するファイル」を参照してください。

注意事項

システムマネジャと，データの転送先のサーバとが別のホストにある場合には，それぞれのホストで稼働するHiRDB Dataextractorのポート番号は同一にしてください。

●−ｆ　フロントエンドサーバまたはバックエンドサーバ名

HiRDBがパラレルサーバ名の場合に，データの転送先のフロントエンドサーバ（FES）またはバックエンドサーバ（BES）のサーバ名を指定します。

このオプションを省略した場合は，データの格納方法によって，次のどちらかのサーバ名が仮定されます。

表単位の格納

HiRDBのシステム共通定義（pdsys）のpdstartコマンドで指定した最初のFESのサーバ名が仮定されます。HiRDBのシステム共通定義については，マニュアル「HiRDB システム定義」を参照してください。

RDエリア単位の格納

データを格納するRDエリアのあるBESのサーバ名が仮定されます。

●−ｄ

抽出したデータを表へ反映するときの，格納方式を指定します。

このオプションを指定した場合は，表中にすでに格納されているデータをすべて削除してから，表に抽出データを格納します。

このオプションを省略した場合，表中にすでに格納されているデータがあるときはそのデータを削除しないで，表に抽出データを追加します。

このオプションの指定値は，HiRDB Dataextractorが起動するHiRDBのデータベース作成ユティリティの−dオプションの指定値になります。

なお，このオプションを省略したデータ反映で異常が発生した場合，−lオプションにaまたはpを指定していないときは元の状態に戻せないことがあるので，注意が必要です。

●−ｉ　インデクス作成方法

抽出したデータを表へ反映するときの，インデクス作成方法を指定します。このオプションを省略した場合は，cが仮定されます。

このオプションの指定値は，HiRDB Dataextractorが起動するHiRDBのデータベース作成ユティリティ（pdload）の−iオプションの指定値になります。

ｃ：インデクス一括作成モードを示します。表の作成処理に引き続き，インデクスを一括作成します。

ｎ：インデクス情報出力モードを示します。インデクス情報だけをインデクス情報ファイルに出力します。インデクス情報出力モードを指定した場合，HiRDBのデータベース再編成ユティリティでインデクスを再作成する必要があります。

ｓ：インデクス更新モードを示します。行を格納するたびにインデクスを更新します。

ｘ：インデクス情報出力抑止モードを示します。インデクスは更新しません。また，インデクス情報をインデクス情報ファイルに出力しません。

−iオプションにc指定時にインデクス一括作成でエラーとなった場合，および−iオプションにxを指定した場合，表の行データは正しいが，インデクスが不正（未作成）の状態になります。この場合は，インデクスを再作成する必要があります。再作成には，次の方法があります。

HiRDBのデータベース作成ユティリティで０件データをデータロードします。

−iオプションにcを指定して追加モードで実行します。

HiRDBのデータベース再編成ユティリティで再作成します。

−kオプションにikrcを指定して実行します。

●−Ｉ　〔ｐｄｌｏａｄ制御情報環境変数名〕〔，ｐｄｌｏａｄコマンドライン情報環境変数名〕〔，ｐｄｌｏａｄ制御情報ファイルｓｏｕｒｃｅ文情報環境変数名〕　〜((6〜10けた))

次の環境変数名から一つ以上を指定することによって，pdloadのバラメタをユーザが任意に指定できます。環境変数名は，コンマ（，）で区切り，順不同に指定できます。ただし，重複して指定することはできません。

pdload制御情報環境変数名（XTPDCFxxxx）

pdloadコマンドライン情報環境変数名（XTLPRMxxxx）

pdload制御情報ファイルsource文情報環境変数名（XTPDSRxxxx）

各環境変数の詳細については，「2.2.3(2)環境変数の設定方法」を参照してください。

注意事項

このオプションおよび環境変数XTPDCFPATHを省略した場合，pdloadはインデクス情報ファイル，LOB中間ファイルを/tmpの下に作成します。反映表にインデクス，BLOB型の列があるときには，データ量に比例して/tmpの下に一時ファイルが出力されます。/tmp下に十分な空き容量がない場合には，システム全体に悪影響を及ぼすことがあるため，注意が必要です。

このオプションは，次の要因でpdloadでエラーになった場合の対策として使用できます。

・反映表にインデクスがない場合にidxwork文またはindex文を記述した制御情報ファイルを指定したとき

・反映表にBLOB型の列がない場合にlobmid文を記述した制御情報ファイルを指定したとき

最初に，反映側の表ごとに，表の定義に合わせて制御情報ファイルを作成し，環境変数XTPDCFxxxxに設定しておきます。そのあと，HiRDB Dataextractorの実行時に，このオプションで，反映側の表に対応した制御情報ファイルを指定します。

このオプションは，反映側またはファイル作成側のHiRDB Dataextractorがこの機能をサポートしている場合にだけ使用できます。サポートしていない場合には，反映側またはファイル作成側で，JXU7001Eメッセージを出力してエラーになります。

このオプションにXTLPRMxxxxを指定した場合，次のオプションは指定できません。

・−ｄオプション

・−ｉオプション

・−ｌオプション

・−ｎオプション

・−ｚオプション

該当するpdloadのオプションを指定する場合の記述方法は，「2.2.4(8)　pdloadコマンドライン情報ファイルの設定」を参照してください。

●−ｌ　ログ取得方式

抽出したデータを表へ反映するときの，ログの取得方法を指定します。このオプションを省略した場合は，pが仮定されます。

このオプションの指定値は，HiRDB Dataextractorが起動するHiRDBのデータベース作成ユティリティの−lオプションの指定値になります。

ａ：ログ取得モードを示します。ロールバックおよびロールフォワードに必要なログを取得します。

ｐ：更新前ログ取得モードを示します。ロールバックに必要なログは取得しますが，ロールフォワードに必要なログは取得しません。

ｎ：ログレスモードを示します。ログを取得しません。

更新前ログ取得モードおよびログレスモードの運用方法については，マニュアル「HiRDB システム運用ガイド」を参照してください。

●−Ｌ　反映情報ファイル名　〜＜パス名＞((1〜255けた))

反映情報ファイルを，絶対パス名で指定します。次の場合は指定が必要です。

抽出したデータのデータ型を変換する場合

抽出したデータの長さを変更する場合

SGMLTEXT型，XML型，およびFREEWORD型を抽出してファイル作成を行う場合に，作成したファイルをpdloadで入力するとき

なお，反映情報ファイルでの指定方法については，「4.2.4(5)反映情報ファイル」を参照してください。

●−ｎ　一括出力ページ数　〜＜符号なし整数＞((8〜4096))≪10≫

抽出したデータを表へ反映するときの，表に対して一括して出力するページ数を指定します。

このオプションの指定値は，HiRDB Dataextractorが起動するHiRDBのデータベース作成ユティリティの−nオプションの指定値になります。

●−ｚ

抽出したデータを表へ反映するときに，可変長文字列，可変長各国文字列，および可変長混在文字列に対して，長さ０のデータを格納する場合に指定します。このオプションを省略した場合に，抽出したデータに長さ０のデータが含まれているときには，HiRDBのデータベース作成ユティリティ（pdload）は入力データ不正でエラーになります。

このオプションの指定値は，HiRDB Dataextractorが起動するHiRDBのデータベース作成ユティリティの−zオプションの指定値になります。

●−ｅ　エラーログファイル名

ログメッセージを出力するエラーログファイルのファイル名を，絶対パス名で指定します。指定したファイルがない場合は，HiRDB Dataextractorが作成するので事前にファイルを作成しておく必要はありません。

このオプションを省略した場合は，HiRDB Dataextractorが/opt/HIRDBXT/spoolディレクトリ下に一意な名称のファイルを作成します。詳細については，「表2-3　HiRDB Dataextractorが作成するディレクトリおよびファイル」を参照してください。

●−ｍ　経過メッセージ出力間隔　〜＜符号なし整数＞((1〜1000))≪10≫

データ抽出処理の実行状態を出力するメッセージの出力間隔を１千行単位で指定します。

このメッセージは，エラーログファイルおよび標準出力に出力されます。

●−ｇ〔排他情報ファイル名〕　〜＜パス名＞((1〜255けた))

排他制御方式を指定します。このオプション指定時は，LOCK文での排他制御をしません。このオプション省略時は，LOCK文を発行して排他制御をします。

−gオプションの指定と排他制御モードの関連については，「4.1.1　抽出時の規則」を参照してください。

排他制御方式を指定します。このオプションと排他情報ファイルの関係は次のようになります。

このオプションを省略した場合

LOCK文（「LOCK TABLE 表名 IN SHARE MODE WITH ROLLBACK」固定）での排他制御を行います。

このオプションだけを指定した場合

LOCK文を発行しません。

このオプションを指定し，かつ排他情報ファイルを指定した場合

LOCK文（排他情報ファイルに指定した内容）での排他制御を行います。

排他情報ファイルでの指定方法については，「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

注意事項

環境変数XTSQLが1の場合は指定が必須となります。

●−ｓ　列名記述ファイル名　〜＜パス名＞((1〜255けた))

列名記述ファイルを，絶対パス名で指定します。

次の場合は指定が必要です。

抽出する表と反映する表で構成列数が異なるとき

列の並べ替えをするとき

行単位インタフェースで抽出をするとき

SGMLTEXT型，XML型，またはFREEWORD型の列の抽出をするとき

列名記述ファイルでの指定方法については，「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

●−ｗ　表式記述ファイル名　〜＜パス名＞((1〜255けた))

環境変数XTSQLが0または省略時に次の条件でデータを抽出する場合，表式記述ファイルを，絶対パス名で指定します。

次の場合は指定が必要です。

条件を指定して抽出する行を選択するとき（WHERE句を指定）

抽出結果をソートするとき（ORDER BY句を指定）

表式記述ファイルでの指定方法については，「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

●−ｖ　ナル値情報ファイル名　〜＜パス名＞((1〜255けた))

ナル値情報ファイルを，絶対パス名で指定します。

ナル値情報ファイルは，次のときに指定します。

ナル値の既定値を変更するとき

繰返し列をファイルに出力する場合のデータ形式，およびナル値反映方法を指定するとき

このオプション省略時のナル値の既定値，およびナル値情報ファイルでの指定方法については，「4.2.4(3)ナル値情報ファイル」を参照してください。繰返し列のデータ形式およびナル値反映方法の指定の詳細については，「3.1.1(6)繰返し列の抽出」を参照してください。

●−ｂ　ＬＯＢ入力ファイル格納用ディレクトリ名　〜＜パス名＞((1〜70けた))

LOB入力ファイル格納用ディレクトリ名を指定します。

抽出したデータにLOBデータがあった場合に，データの反映側またはファイル作成側でLOBデータを処理するときに作成するLOB入力ファイルを格納するディレクトリの名称を指定します。なお，環境変数XTLOBKINDの指定によって，LOB入力ファイルを作成しないで，BLOB列のデータをBLOB列以外のデータと同一の出力ファイルに格納することもできます。

反映処理終了後にLOB入力ファイル格納用ディレクトリを削除しない場合は−oオプションを，削除する場合は−Oオプションを指定します。−oオプションと−Oオプションを同時に指定することはできません。

−oオプションまたは−Oオプション指定時に，すでにファイルが作成されている場合の処理方法は，−yオプションで指定します。

−Rオプションを指定している場合，LOB入力ファイル格納用ディレクトリは次のファイル作成側のホストに作成されます。

−hオプション指定時は，−hオプションで指定したホスト

−hオプション省略時は，環境変数XTHOSTで指定したホスト

−Rオプションを指定していない場合は，LOB入力ファイル格納用ディレクトリは反映側HiRDBの次のサーバのホストに作成されます。

HiRDB/シングルサーバの場合はシングルサーバのあるサーバ

HiRDB/パラレルサーバの場合

−fオプション指定時：−fオプションで指定したFESまたはBES

−fオプション省略時：−fオプション省略時仮定値のFESまたはBES

このオプションを省略した場合は， HiRDB Dataextractorが/opt/HIRDBXT/spoolディレクトリ下に一意な名称のファイルを作成します。詳細は，「表2-3　HiRDB Dataextractorが作成するディレクトリおよびファイル」を参照してください。

注意事項

指定値に￥を含む場合は，引用符（"）で囲んで指定してください。

●−ｑ　エラーデータファイル名〔，出力行数〕

不正となった行データをエラーデータファイルに出力する場合に，HiRDBのデータベース作成ユティリティ（pdload）が作成するエラーデータファイルを指定します。

エラーデータファイル名　〜＜パス名＞((1〜255けた))

エラーデータファイルのファイル名を指定します。

出力行数　〜＜符号なし整数＞((1〜4294967295))

エラーの行データの最大出力行数を指定します。出力行数を省略した場合は，pdloadが100を仮定します。

エラーデータファイルは，反映側HiRDBの次のサーバのホストに作成されます。

HiRDB/シングルサーバの場合はシングルサーバ

HiRDB/パラレルサーバの場合

−fオプション指定時：−fオプションで指定したFESまたはBES

−fオプション省略時：−fオプション省略時仮定値のFESまたはBES

作成したエラーデータファイルは，反映処理後も削除しません。このため，作成したエラーデータファイルに出力された行データを修正すれば，再度pdloadの入力データファイルとして使用できます。

このオプションを省略した場合は，エラーとなった行データは出力されません。

また，指定したエラーデータファイルがすでに存在する場合は，上書きして使用されます。

作成されるエラーデータファイルの名称は，このオプションおよび環境変数XTTMPDIRでの指定によって決定します。作成されるエラーデータファイルの名称を，次の表に示します。

表4‒2　作成されるエラーデータファイルの名称

−qオプション

XTTMPDIR

エラーデータファイルの名称

指定あり

指定あり

$XTTMPDIR/エラーデータファイル名

指定なし

/opt/HIRDBXT/spool/エラーデータファイル名

指定なし

−

−

（凡例）

−：ファイルを作成しないため該当しません。

注意事項

環境変数XTTMPDIRとファイルの名称の長さの合計は，255けた以内にしてください。

このオプションは，反映側またはファイル作成側のHiRDB Dataextractorがこの機能をサポートしている場合にだけ使用できます。サポートしていない場合には，反映側またはファイル作成側で，JXU7001Eメッセージを出力してエラーになります。

●−ｘ　シェルスクリプトファイル名　〜＜パス名＞((1〜255けた))

ファイル作成後に，ユーザが作成したシェルスクリプトを実行する場合に，シェルスクリプトのファイル名を絶対パス名で指定します。

このオプションは，−Rオプション指定時にだけ指定できます。

このオプションが指定されている場合は，シェルスプリクトの処理の完了までHiRDB Dataextractorの処理は待たされます。また，シェルスプリクトのexitのステータスが0でない場合，HiRDB DataextractorはエラーメッセージJXU7010Eを出力します。

指定するシェルスクリプトは，次の条件を満たすことが必要です。

ファイル作成側のサーバマシンに作成する。

ファイル作成側の/etc/inetd.confに指定したHiRDB Dataextractorの実行ユーザに対して実行権限がある。

シェルスクリプトのexitのステータスは，−128〜127の範囲で指定すること。

シェルスクリプトでは標準出力，標準エラーが使用できる。なお，標準入力は使用できない。

●｛〔認可識別子．〕表識別子｜表式記述ファイル名｝

環境変数XTSQLが0または省略時は抽出対象にする表を指定します。認可識別子省略時は，コマンド実行者の環境変数PDUSERの認可識別子が仮定されます。

環境変数XTSQLが1の場合は表式記述ファイル名を指定します。このファイルに記述するFROM句以降のSQL構文で抽出対象にする表を指定します。

xtrepコマンド内では次のとおりSELECT文を組み立てます。

SELECT〔列名記述ファイルの内容〕FROM〔表式記述ファイルの内容〕

注意事項

この指定は，xtrepコマンドの最後に指定します。

認可識別子および表識別子の英小文字はすべて英大文字として扱われます。

認可識別子および表識別子の英小文字と英大文字とを区別したい場合は，認可識別子および表識別子をそれぞれ引用符（"）で囲み，さらにアポストロフィ（’）で囲んでください。アポストロフィ（’）は，認可識別子および表識別子の全体またはそれぞれを囲んでください。

表識別子にスペースを含む場合は，引用符（"）で囲み，さらにアポストロフィ（’）で囲んでください。

指定例

次の指定の場合は，両方ともUSER01.TABLE01として扱う。

user01.table01

"user01"."table01"

次の指定の場合は，両方ともuser01.table01として扱う。

'"user01"."table01"'

'"user01"'.'"table01"'

(6)　xtrepコマンドのオプションの組み合わせ

xtrepコマンドのオプションは，データの抽出後に実行する機能によって，指定できるオプションが異なります。抽出したデータを表に反映する場合は−Rオプションを省略します。ファイルだけを作成して表に反映しない場合は−Rオプションを指定します。

xtrepコマンドのオプションの組み合わせを，次の表に示します。

表4‒3　xtrepコマンドのオプションの組み合わせ

オプション

実行する機能

指定形式

指定内容

反映機能

ファイル作成機能

−r

反映対象の表名

△

×

−R

ファイルの作成

−

●

−o

出力ファイル名またはディレクトリ名

（削除しない場合）

△

○

−O

出力ファイル名またはディレクトリ名

（削除する場合）

△

×

−y

上書きの可否

△

△

−ｊ

格納対象のRDエリア名

△

×

−h

処理対象のホスト名

△

△

−H

反映対象のホスト名（抽出側のホストと反映側のホストが異なるLANで構成されている場合）

△

×

−p

処理対象のポート番号

△

△

−f

転送先のFESまたはBES

△

×

−d

格納方式（pdloadの指定値）

△

×

−i

インデクス作成方式（pdloadの指定値）

△

×

−I

pdload制御情報環境変数名，pdloadコマンドライン情報環境変数名，pdload制御情報ファイルsource文情報環境変数名

（XTPDCFxxxxx，XTLPRMxxxxx，XTPDSRxxxxx）

△

×

−l

ログ取得方式（pdloadの指定値）

△

×

−L

反映情報ファイル名

△

△

−n

一括出力ページ数（pdloadの指定値）

△

×

−z

0バイト文字の格納（pdloadの指定値）

△

×

−e

エラーログファイル名

△

△

−m

経過メッセージ出力間隔

△

△

−g

排他制御方式

△

△

−s

列名記述ファイル名

△

△

−w

表式記述ファイル名

△

△

−v

ナル値情報ファイル名

△

△

−b

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

△

△

−q

エラーデータファイル名，出力行数

△

×

−x

シェルスクリプトファイル名

×

△

※

抽出対象の表名

○

○

（凡例）

●：このオプションの指定で実行する機能を選択します。

−：表への反映時には指定しません。−Ｒオプションを指定した場合は，ファイル作成機能を実行して，表には反映しません。

○：必ず指定します（省略すると，JXU7300Eメッセージを出力してエラーになります）。

△：省略できます。

×：指定できません（指定すると，JXU7306EまたはJXU7307Eメッセージを出力してエラーになります）。

注※

指定形式を次に示します。

環境変数XTSQLが0または省略時

〔認可識別子．〕表識別子

環境変数XTSQLが1の場合

表式記述ファイル名

4.2.3　データ抽出・反映の付加機能

ここでは，データ抽出・反映時の機能の中で，特に次の機能について説明します。

データ抽出時のSQLユーザ指定機能

ローダのパラメタユーザ任意指定機能

文字コード変換機能

(1)　データ抽出時のSQLユーザ指定機能

HiRDB Dataextractorでは，HiRDBからデータを抽出する際に発行する次のSQLに対して，ユーザ任意の指定を行うことができます。

LOCK TABLE文

SELECT文

この機能の適用範囲を次の表に示します。

表4‒4　データ抽出時のSQLユーザ指定機能の適用範囲

データ連携種別

抽出側

反映側

適用可否

XDM/XT連携

XDM/RD

HiRDB

−

順編成データセット

−

HiRDB

XDM/RD

○

順編成データセット

○

HiRDB Dataextractor連携

HiRDB

HiRDB

○

バイナリ形式ファイル

○

DAT形式ファイル

○

（凡例）

○：適用できます。

−：HiRDB Dataextractorでは対象外です。詳細は，マニュアル「VOS3 データベース抽出プログラム　XDM/XT」を参照してください。

(a)　XDM/XT連携での使用方法

XDM/XT連携でこの機能を使用する場合，指定が必要なものは次のとおりです。

XDM/XTのJXUMCTL制御文

RDBDEF文，EXTRACT文

HiRDB Dataextractorの環境変数情報設定ファイル（抽出側）

環境変数情報設定ファイルに指定する環境変数を次の表に示します。

表4‒5　SQLユーザ指定機能で設定する環境変数（XDM/XT連携の場合）

環境変数

環境変数の指定

PDHOST

△※

PDNAMEPORT

△※

XTEXTRACTDB

△

XTLCKxxxx

△

XTTBLxxxx

△

XTCLMxxxx

△

XTWHExxxx

△

（凡例）

△：必要に応じて指定します。

注※

XDM/XTのJXUMCTL制御文にRDBDEF文を指定した場合は必ず指定します。

各環境変数の詳細については，「2.2.3　環境変数の設定」を参照してください。

(b)　HiRDB Dataextractor連携での使用方法

HiRDB Dataextractor連携でこの機能を使用する場合，xtrepコマンドを実行します。

環境変数

この機能を使用する場合，抽出側に次の環境変数を必ず指定します。

XTSQL

環境変数の詳細については，「2.2.3　環境変数の設定」を参照してください。

コマンドオプション

この機能で指定が必要，不要となるオプションを次の表に示します。

表4‒6　データ抽出時のSQLユーザ指定機能使用時のxtrepコマンドオプションの指定

コマンド

オプション

指定値

HiRDB反映

バイナリ，DATファイル作成

XTSQL

XTSQL

0

1

0

1

xtrep

−g

−

△

○

△

○

排他情報ファイル

−r

〔認可識別子.〕表識別子

△

○

×

×

−R

−

×

×

○

○

{bin｜dat}

−s

列名記述ファイル名

△

△

△

△

−w

表式記述ファイル名

△

×

△

×

〔認可識別子.〕表識別子

−

○

×

○

×

表式記述ファイル名

−

×

○

×

○

（凡例）

○：必ず指定してください。

△：省略できます。

×：指定できません。

−：指定値はありません。

−ｇ　〔排他情報ファイル名〕

環境変数XTSQLとの組み合わせによってデータを抽出する表の排他制御を行います。環境変数XTSQLに１を指定した場合，このオプションを必ず指定します。

排他情報ファイルの詳細は次のとおりです。

XTSQL

−ｇオプション

動作

0

なし

−

コマンドラインの表名でLOCKTABLEを発行

あり

指定値なし

LOCK TABLEを発行しない

指定値あり

排他情報ファイルの内容でLOCK TABLEを発行

1

なし

−

エラー

あり

指定値なし

LOCK TABLEを発行しない

指定値あり

排他情報ファイルの内容でLOCK TABLEを発行

（凡例）

−：該当しません。

−ｒ　〔認可識別子.〕表識別子

環境変数XTSQLに1を指定した場合，このオプションまたは−Ｒオプションを必ず指定します。

−Ｒ　〔｛ｂｉｎ｜ｄａｔ｝〕

環境変数XTSQLに1を指定した場合，このオプションまたは−ｒオプションを必ず指定します。

−ｓ　列名記述ファイル名

必要に応じて列名記述ファイルの名称を絶対パスで指定します。

−ｗ　表式記述ファイル名

環境変数XTSQLに1を指定した場合，このオプションは指定できません。

〔認可識別子.〕表識別子

環境変数XTSQLを省略，または0を指定した場合に指定します。

表式記述ファイル名

環境変数XTSQLに１を指定した場合，このオプションを指定します。

各オプションの詳細については，「4.2.2　xtrepコマンド」を参照してください。

ファイルの指定方法

オプションで指定するファイルの指定方法について説明します。

排他情報ファイル

LOCK TABLE文の排他制御オプションを指定します。

環境変数XTSQLの指定によって，次のようにファイル内容を指定します。

XTSQL

指定内容

0

"LOCK TABLE 表名"以降の排他オプションを指定します。

1

"LOCK TABLE"以降の排他オプションを指定します。

表式記述ファイル

SELECT文の表式を指定します。

環境変数XTSQLの指定によって，次のようにファイル内容を指定します。

XTSQL

指定内容

0

SELECT文"FROM 表名"以降の表式を指定します。

1

SELECT文"FROM"以降の表式を指定します。

注意事項

環境変数XTSQLに1を指定した場合，ナル値情報ファイルに列名を指定できません。ナル既定値，繰返し列データ形式などを指定する場合，フィールド番号で指定してください。列名を指定した場合は，エラーになります。

(2)　ローダのパラメタユーザ任意指定機能

HiRDB Dataextractorでは，HiRDBへデータを反映する際，HiRDBのデータベース作成ユティリティ（pdload）を起動しています。ローダのパラメタユーザ任意指定機能では，pdloadのパラメタをユーザ任意に指定できます。

この機能の適用範囲を次の表に示します。

表4‒7　ローダのパラメタユーザ任意指定機能の適用範囲

データ連携種別

抽出側

反映側

適用可否

XDM/XT連携

XDM/RD

HiRDB

○

順編成データセット

○

HiRDB Dataextractor連携

HiRDB

HiRDB

○

（凡例）

○：適用できます。

(a)　XDM/XT連携での使用方法

XDM/XT連携でこの機能を使用する場合，指定が必要なものは次のとおりです。

XDM/XTのJXUMCTL制御文

HIRDDEF文PDLODPRMオペランド

LOAD文LPRMPATHオペランド，PDSRPATHオペランド

HiRDB Dataextractorの環境変数情報設定ファイル（反映側）

XTLPRMxxxx

XTPDSRxxxx

必要に応じて指定してください。環境変数の詳細については，「2.2.3　環境変数の設定」を参照してください。

(b)　HiRDB Dataextractor連携での使用方法

HiRDB Dataextractor連携でこの機能を使用する場合，xtrepコマンドを実行します。

環境変数

この機能を使用する場合，反映側の環境変数情報設定ファイルに次の環境変数を必要に応じて指定します。

XTLPRMxxxx

XTPDSRxxxx

各環境変数の詳細については，「2.2.3　環境変数の設定」を参照してください。

コマンドオプション

この機能で指定が必要，不要となるオプションを次の表に示します。

表4‒8　ローダのパラメタユーザ任意指定機能使用時のxtrepコマンドオプションの指定

コマンド

オプション

指定値

指定要否

xtrep

−d

−

1'

−f

サーバ名

△

−i

{c｜s｜n｜x}

1'

−I

XTPDCFxxxx

△

XTLPRMxxxx

○1

XTPDSRxxxx

○2

−j

RDエリア名

△

−l

{a｜p｜n}

1'

−n

バッファ面数

1'

−q

エラーデータファイル名，件数

2'

−v

ナル値情報ファイル

△

−z

−

1'

（凡例）

○：この機能を使用する場合，どちらかは必ず指定してください。

△：省略できます。

−：指定値はありません。

1，1'：1と1'は同時に指定できません。

2，2'：2と2'は同時に指定できません。

●−Ｉ　〔XTPDCFxxxx〕〔，XTLPRMxxxx〕〔，XTPDSRxxxx〕

指定値は一つ以上指定します。複数指定する場合は，コンマ（，）で区切り,順不同に指定できます。

XTPDCFxxxx（pdload制御情報環境変数名）

必要に応じて指定してください。この環境変数の詳細は，「2.2.3　環境変数の設定」を参照してください。

XTLPRMxxxx（pdloadコマンドライン情報環境変数名）

この機能を使用する場合は，XTLPRMxxxxとXTPDSRxxxxのどちらかの環境変数は必ず指定してください。

注意事項

この環境変数を指定する場合，次のオプションは指定できません。

−ｄオプション

−ｉオプション

−ｌオプション

−ｎオプション

−ｚオプション

この環境変数名を指定する場合，HiRDB Dataextractorはpdload起動時に表名，制御情報ファイル名，−ｂオプション，−ｋオプション，−ｖオプション，−Ｗオプション，−ｃオプション以外のパラメタを指定しないため，必要なオプションはすべてpdloadコマンドライン情報ファイルに指定します。

XTPDSRxxxx（pdload制御情報ファイルsource文情報環境変数名）

この機能を使用する場合は，XTLPRMxxxxとXTPDSRxxxxのどちらかの環境変数は必ず指定してください。

注意事項

この環境変数を指定する場合，−ｑオプションは指定できません。

(3)　文字コード変換機能

抽出データの文字コードを環境変数の指定に従って，文字コード変換して反映する機能です。

この機能の適用範囲を次の表に示します。

表4‒9　文字コード変換機能の適用範囲

データ連携種別

抽出側

反映側

適用可否

XDM/XT連携

XDM/RD

HiRDB

−

順編成データセット

−

HiRDB

XDM/RD

−

順編成データセット

−

HiRDB Dataextractor連携

HiRDB

HiRDB

○

バイナリ形式ファイル

○

DAT形式ファイル

○

（凡例）

−：HiRDB Dataextractorでは対象外です。詳細は，マニュアル「VOS3 データベース抽出プログラム　XDM/XT」を参照してください。

○：適用できます。

この機能で変換可能な文字コードについては，「3.1.4　抽出したデータの文字コード変換」を参照してください。

(a)　文字コード変換機能の使用方法

環境変数およびナル値情報ファイルを指定することによって，データ反映時に文字コードが変換されます。

環境変数

この機能を使用する場合に必要な環境変数について次の表に示します。

表4‒10　文字コード変換機能で設定が必要な環境変数

環境変数

抽出側

反映側

ファイル作成側

XTLOCALE

○

○

○

XTDATALOCALE

△

△

△

XTUNDEF

−

○

○

XTDATAUNDEF

−

▲

▲

（凡例）

○：指定します。

△：必要に応じて指定します。省略した場合，環境変数XTLOCALEに従います。

▲：環境変数XTDATALOCALEを指定した場合，指定します。

−：指定しません。

注

XTDATALOCALEを指定してUTF-16へ文字コード変換する場合，変換対象は表データだけとなります。表定義情報は変換対象となりません。表定義情報を変換するためには，必ず環境変数XTLOCALEを指定してください。

XTLOCALE

抽出側と反映側でそれぞれの文字コードを指定します。環境変数の指定値については，「2.2.3　環境変数の設定」を参照してください。

抽出側と反映側の環境変数の指定組み合わせを次に示します。

抽出側

反映側

sjis

euc

utf-8

unknown

sjis

−

○

○

−

euc

○

−

○

−

utf-8

○

○

−

−

unknown

−

−

−

−

（凡例）

○：抽出側で指定したコードから反映側で指定したコードに変換します。

−：コード変換しません。

XTDATALOCALE

抽出側と反映側でそれぞれの文字コードを指定します。この環境変数はUTF-16と，UTF-16以外の文字コード間でデータ連携する場合に指定してください。環境変数の指定値については，「2.2.3　環境変数の設定」を参照してください。

抽出側と反映側の環境変数の指定組み合わせを次に示します。

抽出側

反映側

sjis

euc

utf-8

utf-16BE

utf-16LE

sjis

−

○

○

○

○

euc

○

−

○

○

○

utf-8

○

○

−

○

○

utf-16BE

○

○

○

−

○

utf-16LE

○

○

○

○

−

（凡例）

○：抽出側で指定したコードから反映側で指定したコードに変換します。

−：コード変換しません。

XTUNDEF

未定義コードを検出した場合の処置を指定します。この環境変数の指定値については，「2.2.3　環境変数の設定」を参照してください。

XTDATAUNDEF

未定義コードを検出した場合の処置を指定します。この環境変数は，環境変数XTDATALOCALEを指定した場合に有効となります。この環境変数の指定値については，「2.2.3　環境変数の設定」を参照してください。

ナル値情報ファイル

列単位にコード変換の有無を指定する場合に，xtrepコマンドの−ｖオプションの指定値にナル値情報ファイルを指定します。

このファイルの指定方法については，「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

(b)　外字のコード変換

文字コードの外字を変換するには，文字コード変換用マッピングテーブルを使用します。変換に使用されるマッピングテーブルの基のテーブルは，HiRDB Dataextractorインストール時に自動的にインストールされます。ディレクトリ名およびファイル名については，「2.2.2(5)HiRDB Dataextractorが作成するディレクトリおよびファイル」を参照してください。

この基のマッピングテーブルは，初期状態では外字コードが定義されていません。コード変換で外字を扱う場合は，事前に文字コ−ド変換用マッピングテーブルを更新しておく必要があります。

なお，更新を行う場合は，整合性が取れるように，次の2種類のマッピングテーブルをそれぞれ更新してください。

抽出側コード体系から反映側コード体系へのマッピングテーブル

反映側コード体系から抽出側コード体系へのマッピングテーブル

文字コード変換用マッピングテーブルの編集・参照

文字コード変換用マッピングテーブルに外字コードを定義する場合，またはテーブル内容を参照する場合は，xtccnvedtコマンドを使用します。

なお，文字コード変換用マッピングテーブルの編集は，HiRDB Dataextractorが動作していない状態で実行してください。

機能

HiRDB Dataextractorインストール時に用意された文字コード変換用マッピングテーブルを基に，新たに次のディレクトリにマッピングテーブルを作成します。

/opt/HIRDBXT/lib/usermap/

すでに上記ディレクトリ下にマッピングテーブルが存在する場合は，上書きします。

実行環境

スーパーユーザを使用し，データ反映側のマシンで実行してください。

コマンド

マッピングテーブル更新時
ｘｔｃｃｎｖｅｄｔ　−ｗ
　　　　　　　　　　−ｆ　｛ｓｊｉｓ｜ｅｕｃ｜ｕｃｓ2｝
　　　　　　　　　　−ｔ　｛ｓｊｉｓ｜ｅｕｃ｜ｕｃｓ2｝
　　　　　　　　　　−ｄ　変換定義ファイル名

マッピングテーブル参照時
ｘｔｃｃｎｖｅｄｔ　−ｒ
　　　　　　　　　　−ｆ　｛ｓｊｉｓ｜ｅｕｃ｜ｕｃｓ2｝
　　　　　　　　　　−ｔ　｛ｓｊｉｓ｜ｅｕｃ｜ｕｃｓ2｝
　　　　　　　　　　−ｏ　出力ファイル名
　　　　　　　　　〔−ｓ　出力開始コード〕
　　　　　　　　　〔−ｅ　出力終了コード〕

オプション

マッピングテーブル更新時

●−ｗ

文字コード変換用マッピングテーブルを更新する場合に指定します。

●−ｆ　｛ｓｊｉｓ｜ｅｕｃ｜ｕｃｓ2｝

変換元のコードセットを指定します。

ｓｊｉｓ：SJIS文字コード

ｅｕｃ：EUC文字コード

ｕｃｓ2：UTF-8，またはUTF-16文字コード

●−ｔ　｛ｓｊｉｓ｜ｅｕｃ｜ｕｃｓ2｝

変換先のコードセットを指定します。

ｓｊｉｓ：SJIS文字コード

ｅｕｃ：EUC文字コード

ｕｃｓ2：UTF-8，またはUTF-16文字コード

●−ｄ　変換定義ファイル名

文字コード変換用マッピングテーブルの更新内容を定義した変換定義ファイル名を127文字以内で指定します。相対パス指定の場合は，カレントディレクトリからの相対パスとして認識します。

マッピングテーブル参照時

●−ｒ

文字コード変換用マッピングテーブルを参照する場合に指定します。

●−ｏ

文字コード変換用マッピングテーブルの参照結果を出力するファイル名を127文字以内で指定します。相対パス指定の場合は，カレントディレクトリからの相対パスとして認識します。

文字コード変換用マッピングテーブルの参照結果は，変換定義ファイルの定義フォーマットと同様の形式で1バイトコード文字列，2バイトコード文字列，3バイトコード文字列の順に変換元文字コードの昇順に出力します。

出力対象は変換先コードが定義されているコードだけとし，変換先が未定義のコードについては出力しません。

●−ｓ　出力開始コード

参照を開始する変換元文字コードを16進数値文字列で指定します。このオプションを省略した場合は，文字コード変換用マッピングテーブルの先頭から参照を開始します。

注意事項

出力開始コードは，次のように指定してください。

1バイトコードは2文字，2バイトコードは4文字，3バイトコードは6文字（変換元コードがEUC文字コードの場合だけ）で指定します。これ以外の文字数の場合はエラーとなります。

3バイトコードを指定する場合，先頭が8f以外のときはエラーとなります。

−ｅオプションで指定した出力終了コードよりも大きい値を指定した場合はエラーとなります。

●−ｅ　出力終了コード

参照を終了する変換元文字コードを16進数値文字列で指定します。このオプションを省略した場合は，文字コード変換用マッピングテーブルの終わりまで参照を行います。

注意事項

出力終了コードは次のように指定してください。

1バイトコードは2文字，2バイトコードは4文字，3バイトコードは6文字（変換元コードがEUC文字コードの場合だけ）で指定します。これ以外の文字数の場合はエラーとなります。

3バイトコードを指定する場合，先頭が8f以外のときはエラーとなります。

−ｓオプションで指定した出力開始コードよりも小さい値を指定した場合はエラーとなります。

注意事項

オプション−ｆと−ｔで指定できるコードセットの組み合わせを次に示します。

−ｆオプション

−ｔオプション

処理対象のマップファイル

sjis

euc

jis2euc.map

ucs2※

jis2ucs2.map

euc

sjis

euc2jis.map，eucg2j.map

ucs2※

euc2ucs2.map，eucg2u.map

ucs2※

sjis

ucs22jis.map

euc

ucs22euc.map

注

変換元と変換先に同じコードセットを指定した場合は，文字コード変換用マッピングテーブルの更新は行いません。

注※

文字コードセットがUTF-8の場合は，UCS-2コードセットを指定してください。

変換定義ファイル

変換定義ファイルには，文字コード変換用マッピングテーブル中の更新したい変換元文字コードと変換先文字コードを次のフォーマットで定義します。

変換元文字コード，変換先文字コード

記述規則

1行に1エントリで定義します。

変換元文字コード，変換先文字コードは16進数値文字列（a〜fについては大文字，小文字のどちらの指定も可）で指定します。

「#」以降は，コメントとみなされます。変換の定義のあとにコメントを記載する場合は，定義と「#」の間に一つ以上の空白文字またはタブを入れておく必要があります。

文字コードの指定は，1バイトコードは2文字，2バイトコードは4文字，3バイトコードは6文字（EUC文字コードの場合だけ）で行います。これ以外の文字数での指定がある場合はエラーとなります。

3バイトコードを指定する場合，先頭が8f以外のときはエラーとなります。

変換先文字コードの指定以降に出現する最初の空白文字以降は無視します。

各コードの前後にある空白文字およびタブは無視します。

(c)　コード変換エラー時の処理

コード変換エラー時の処理は，エラー要因によって，次のようになります。

（i）変換後データ長が受け取りエリアより長くなる場合

けたあふれしたデータを切り捨てて，設定します。

（例）

抽出側，反映側ともCHAR(3)の列で，データが「あ＋ア（半角カナ文字）」であるとき，SJISからEUCへコード変換を行うと，変換後データ長が4バイトとなるため，最後の文字は切り捨てます。

（ii）抽出データ（列単位）の末尾が2または3バイトコードの途中である場合

反映側の属性が固定長のとき

エラーデータの前までのデータを設定し，残りを空白（0x20）にします。

（例）

抽出側，反映側ともCHAR(3)の列で，データが「あ＋2バイトコードの先頭」であるとき，SJISからEUCへコード変換を行うと，最後の文字は切り捨て，残りに空白を設定します。

反映側の属性が可変長のとき

エラーデータの前までのデータを設定します。

（例）

抽出側，反映側ともVARCHAR(3)の列で，データが「あ＋2バイトコードの先頭」であるとき，SJISからEUCへコード変換を行うと，最後の文字は切り捨てます。

変換エラーを検知するとエラーメッセージ（JXU7230I）を出力して，エラーを検知した次の列から処理を続行します。変換エラーレコード件数が打ち切り件数に達したときに，エラーメッセージ（JXU7230E）を出力して処理を終了します。

4.2.4　xtrepコマンドで指定するファイルの内容

xtrepコマンドで指定する，次のファイルの内容について説明します。

列名記述ファイル

表式記述ファイル

ナル値情報ファイル

出力ファイル

反映情報ファイル

排他情報ファイル

(1)　列名記述ファイル

列名記述ファイルには，SELECT文の選択式を指定します。

SELECT文での選択式の指定方法については，マニュアル「HiRDB SQLリファレンス」を参照してください。

注意事項

列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲みます。

列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲みます。引用符（"）で囲まない場合は，すべて英大文字として扱われます。

SGMLTEXT型，XML型，またはFREEWORD型の列の抽出をする場合は，抽象データ型関数のextractsを指定してください。

抽象データ型関数extractsの指定形式を次に示します。

形式

ｅｘｔｒａｃｔｓ（列名）

(2)　表式記述ファイル

表式記述ファイルは，XTSQL環境変数の値によって指定できるSQL構文が変わります。

環境変数XTSQLが0または省略時，SELECT文の次の句を指定します。

・WHERE句

・ORDER BY句

環境変数XTSQLが1の場合，SELECT文のFROM句以降の構文を指定します。

SELECT文の指定方法については，マニュアル「HiRDB SQLリファレンス」を参照してください。

注意事項

表式の指定値にスペース，ハイフン（−）を含むときは，引用符（"）で囲みます。

表式の指定値の英小文字と英大文字とを区別したい場合は，引用符（"）で囲みます。引用符（"）で囲まない場合は，すべて英大文字として扱われます。

表式記述ファイルで指定可能なデータ型の組み合わせについては，「表3-7　HiRDB Dataextractorで変換および比較できるデータ型」を参照してください。

ORDER BY句を指定する場合，抽出時に属性，文字コード変換をすると，反映側システム上での並び順と異なることがあるため注意してください。

(3)　ナル値情報ファイル

ナル値情報ファイルは，次のときに指定します。

ナル値の既定値を変更するとき

反映対象の列にナル値を格納する場合に，ナル値とみなす値を変更したいときに指定します。抽出したデータと，ここでの指定で設定した値が同じ場合に，表の列にナル値が格納されます。

また，ファイル作成の場合には，抽出データのナル値をどのような既定値としてファイルに格納するかを指定します。

ナル値情報ファイルを省略（−vオプション省略）した場合のナル値の既定値，およびナル値情報ファイルの指定値によって設定されるナル値の既定値を，「表4-11　ナル値の既定値」に示します。

繰返し列をファイルに格納する場合のデータ形式およびナル値反映方法を指定するとき

繰返し列でのデータ形式およびナル値反映方法の指定の詳細については，「3.1.1(6)繰返し列の抽出」を参照してください。

形式

｛列名｜フィールド番号＝ＮＵＭ｝
　　〔＝｛ＨＩＧＨ｜ＬＯＷ｜ＺＥＲＯ｜ＳＰＡＣＥ｜（’定数値’）｜
　　　　　（X’１６進定数値’）｝〕
　　　〔，ＡＲＲＡＹ＝｛ＦＦ｜ＦＶ｜ＶＶ｝〔，ＮＵＬＬＥＬＭ＝｛Ｃ｜Ｅ｝〕〕
　　〔，｛ＮＯＣＯＤＥＣＯＮＶ｜ＣＯＤＥＣＯＮＶ｝〕

説明

●列名

ナル値の既定値を変更する列を指定します。

HiRDBの表に反映する場合

反映側の表の列名で指定してください。

ファイルだけを作成する場合

抽出側の表の列名で指定してください。

●フィールド番号＝NUM　

ナル値の既定値を変更する列の先頭からの通番を指定します。指定値範囲は1〜99,999です。

HiRDBの表に反映する場合

反映表の定義上の先頭からの通番を指定してください。

ファイルだけを作成する場合

−ｓオプション指定なし

抽出表の定義上の先頭からの通番を指定してください。

−ｓオプション指定あり

列名記述ファイルに指定した列名の先頭からの通番を指定してください。

●｛ＨＩＧＨ｜ＬＯＷ｜ＺＥＲＯ｜ＳＰＡＣＥ｜（’定数値’）｜（X’１６進定数値’）｝

ナル値の既定値を指定します。

ここでの指定によって設定される値については，「表4-11　ナル値の既定値」を参照してください。

●ＡＲＲＡＹ＝｛ＦＦ｜ＦＶ｜ＶＶ｝

繰返し列をファイルに格納する場合の，データの形式を指定します。

ARRAYとNULLELMの指定値の組み合わせ可否については，「表4-12　ARRAYとNULLELMの組み合わせ可否」を参照してください。

ＦＦ：列の先頭に要素数がなく，列の要素すべてにデータがある形式。

ＦＶ：列の先頭に要素数があり，列の要素すべてにデータがある形式。

ＶＶ：列の先頭に要素数があり，要素数分のデータがある形式。

●ＮＵＬＬＥＬＭ＝｛Ｃ｜Ｅ｝

繰返し列をファイルに格納する場合に，要素すべてがナル値のときのナル値の設定方法（ナル値反映方法）を指定します。

ARRAYとNULLELMの指定値の組み合わせ可否については，「表4-12　ARRAYとNULLELMの組み合わせ可否」を参照してください。

Ｃ：要素全体にデータがないとき，列全体をナル値として反映します。

Ｅ：要素全体にデータがないとき，各要素をナル値として反映します。

●｛ＮＯＣＯＤＥＣＯＮＶ｜ＣＯＤＥＣＯＮＶ｝

列単位にコード変換の有無を指定します。

ＮＯＣＯＤＥＣＯＮＶ：文字コード変換機能を使わない場合に指定します。この指定値は，環境変数XTLOCALE，またはXTDATALOCALEを指定してコード変換を行う場合だけ有効となります。

ＣＯＤＥＣＯＮＶ：文字コード変換機能を使う場合に指定します。この指定値は，環境変数XTLOCALE，またはXTDATALOCALEを指定してコード変換を行う場合だけ有効となります。

注意事項

次の条件をすべて満たす場合は，SGMLTEXT型の列に対して，必ずこの指定値を指定してください。指定しない場合は，SGMLTEXT型は文字コード変換対象となりません。

・文字コード変換を行う。

・データを抽出し，ファイルだけを作成する（HiRDBに反映しない）。

・抽出するデータにSGMLTEXT型が含まれる。

文字集合列で，かつ環境変数XTCSETUSEにyesを指定した場合，文字コード変換対象となりません。文字集合列を文字コード変換対象にするためには，次の条件をすべて満たす必要があります。

・すべての文字列が文字集合である。

・すべての文字列にCODECONVを指定する。

・抽出側の環境変数XTDATALOCALEにutf-16BEを指定する。

記述規則

1行に一つの列について記述します。複数列分記述したい場合は，複数行記述してください。

注釈は，"＃"以降その行の終わりまでとします。

列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲んでください。

列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲んでください。

引用符（"）で囲まない場合は，すべて英大文字として扱われます。

定数値を指定する場合は，255バイト以下で指定してください。

定数値中に「’）」は指定しないでください（アポストロフィ「’」と右括弧「）」は連続して指定しないでください）。

HiRDBの表へ反映する場合，反映側の列が非NULL属性のときは，ナル既定値がそのままデータとして格納されます。

ファイルの作成時，抽出側の列が非NULL属性のときは，指定を無視します。

抽象データ型の列は，列単位のコード変換の有無（NOCODECONVまたはCODECONV）以外は指定できません。

XML型の列にCODECONVは指定できません。

反映情報ファイルにXMLを指定した列には，CODECONVを指定できません。

繰返し列のデータ形式およびナル値反映方法の指定時の注意事項については，「3.1.1(6)繰返し列の抽出」を参照してください。

ナル既定値はコード変換を行わないため，バイナリファイル出力を行う場合は反映側の文字コードで定数を指定します。

次のデータ型の変換を行う場合，文字コード変換を行わないため，変換が必要なときは，CODECONVを指定します。

・(VAR)CHAR → BINARY

・M(VAR)CHAR → BINARY

数値属性に16進定数を指定する場合は，反映側のエンディアン表現で指定します。

FLT，SFLT属性に16進定数を指定する場合はIEEE浮動小数点規格の範囲で指定します。

DATファイルを作成する場合，ARRAYにFVは指定できません。

対象の表に可変長文字列を含む場合，この環境変数にFF，FVは指定できません。

バイナリファイル，DATファイルを作成する場合，NULLEMは指定できません。

通常列にARRAY，NULLEMを指定することはできません。

注意事項

FLT，SFLT属性に16進定数を指定した場合，ナル値を正しく反映させるため，HiRDB Dataextractorが値を補正するときがあります。

環境変数XTNLDFLTの指定によって，ナル値情報ファイルの指定規則が異なります。環境変数XTNLDFLTの指定によるナル値情報ファイルの指定規則については，「表4-13　ナル値情報ファイルの指定規則（HiRDBからのデータ抽出の場合）」を参照してください。また，環境変数XTNLDFLTの指定値と，仮定するナル既定値の関係については「表4-14　環境変数XTNLDFLTの指定値と仮定するナル既定値の関係」を参照してください。

記述例

CLM01=HIGH                        #INT
CLM02=LOW                         #DATE
CLM03=('FFFF')                    #CHAR(4)
CLM04=SPACE,ARRAY=FV,NULLELM=E    #CHAR(4)
CLM05, NOCODECONV
CLM06=(X'A4A2')

表4‒11　ナル値の既定値

データ型

−ｖオプション

省略時

−ｖオプションでの指定

HIGH

LOW

ZERO

SPACE

定数

16進定数

INTEGER

−2147483648

2147483647

−2147483648

0

−

−

X’16進定数値’（4バイト）

SMALLINT

−32768

32767

−32768

0

−

−

X’16進定数値’（2バイト）

DECIMAL(p, s)

−99…99

99…99

−99…99

0※1

−

−

X’16進定数値’((p+1)÷2バイト)

FLOAT

※2

※3

※2

0

−

−

X’16進定数値’（8バイト）

SMALLFLT

※4

※5

※4

0

−

−

X’16進定数値’（4バイト）

CHAR(n)

VARCHAR(n)

MCHAR(n)

MVARCHAR(n)

n＜4

nバイトの’#’（半角）

−

−

−

nバイトの空白

（半角）

定数値

（ｎバイト）

X’16進定数値’（nバイト）

n≧4

4バイトの’#’（半角）

−

−

−

4バイトの空白

（半角）

定数値

（MAX255バイト）

X’16進定数値’（MAX127バイト）

NCHAR(n)

NVARCHAR(n)

n＜2

(n=1)

2バイトの’＃’

（全角）※6

−

−

−

2バイトの空白（全角）※6

定数値

（2バイト）

X’16進定数値’（2nバイト）

n≧2

4バイトの’＃＃’

（全角）※6

−

−

−

4バイトの空白（全角）※6

定数値

（MAX254バイト）

X’16進定数値’（MAX127バイト）

DATE

0001年

01月01日

9999年

12月31日

0001年

01月01日

−

−

−

X’16進定数値’（4バイト）

INTERVAL YEAR TO DAY

−9999年

11月99日間

9999年

11月99日間

−9999年

11月99日間

0000年00月00日間

−

−

X’16進定数値’（5バイト）

TIME

00時00分00秒

23時59分59秒

00時00分00秒

−

−

−

X’16進定数値’（3バイト）

INTERVAL HOUR

TO SECOND

−99時間59分59秒間

99時間59分59秒間

−99時間59分59秒間

00時間00分00秒間

−

−

X’16進定数値’（4バイト）

BLOB

XTNL0

−

−

−

−

−

−

BINARY(n)

n＜128

X’00…00’

(nバイト)

X’FF…FF’(nバイト)

X’00…00’

(nバイト)

−

−

−

X’16進定数値’（nバイト）

n≧128

X’00…00’

(127バイト)

X’FF…FF’(127バイト)

X’00…00’

(127バイト)

−

−

−

X’16進定数値’（MAX127バイト）

TIMESTAMP(n)

0001年01月01日00時00分00.000000秒※7

9999年12月31日23時59分59.999999秒※7

0001年01月01日00時00分00.000000秒※7

−

−

−

X’16進定数値’（7＋(n÷2)バイト）

（凡例）

—：指定できません。

注※1

値0は，符号部（C：正符号）付きを示します。

注※2

−1.7976931348623157e＋308

注※3

1.7976931348623157e＋308

注※4

−3.4028234663852886e＋38

注※5

3.4028234663852886e＋38

注※6

文字コードにかかわらず，空白はX'8140'，’＃’はX'8194'とします。

注※7

小数けたは定義によって0〜6けたになります。

表4‒12　ARRAYとNULLELMの組み合わせ可否

機能

指定値

指定可否

処理

抽出側

反映側

ARRAY

NULLELM

HiRDB

HiRDB

FF

−

○

続行

C

E

FV

−

○

続行

C

×

エラー

E

VV

−

○

続行

C

×

エラー

E

バイナリファイル

FF

−

○

続行

C

×

エラー

E

FV

−

○

続行

C

×

エラー

E

VV

−

○

続行

C

×

エラー

E

DATファイル

FF

−

○

続行

C

×

エラー

E

FV

−

×

エラー

C

E

VV

−

○

続行

C

×

エラー

E

（凡例）

−：指定値はありません。

○：指定できます。

×：指定できません。

表4‒13　ナル値情報ファイルの指定規則（HiRDBからのデータ抽出の場合）

ナル値情報ファイル

指定内容

環境変数XTNLDFLTの指定値

0または1

2

HiRDB反映

ファイル作成

HiRDB反映

ファイル作成

バイナリ

形式

DAT形式

バイナリ

形式

DAT形式

列名｜フィールド番号=NUM

◎

◎

◎

◎

◎

◎

ナル値の既定値

○

○

○

×

×

×

ARRAY=

FF

○

○

○

×

×

○

FV

○

○

×

×

×

×

VV

○

○

○

×

×

○

NULLELM={C｜E}

○

×

×

×

×

×

NOCODECONV｜CODECONV

○

○

○

○

○

○

（凡例）

◎：必ず指定してください。

○：指定できます。

×：指定できません。

表4‒14　環境変数XTNLDFLTの指定値と仮定するナル既定値の関係

データ型

−vオプション省略時仮定値

環境変数XTNLDFLTの指定値

0

1

INTEGER

−2147483648

同左

SMALLINT

−32768

同左

DECIMAL

−99…99

X'FF…FF'

FLOAT

−1.7976931348623157e＋308

同左

SMALLFLT

−3.4028234663852886e＋38

同左

CHAR(n)

VARCHAR(n)

MCHAR(n)

MVARCHAR(n)

n≦4のとき

nバイトの‘#‘

n>4のとき

4バイトの‘#‘

同左

NCHAR(n)

NVARCHAR(n)

n≦2のとき

n文字の‘#‘（全角）

n>2のとき

2文字の‘#‘（全角）

同左

DATE

0001年01月01日

X'FFFFFFFF'

INTERVAL YEAR

TO DAY

−9999年11月99日間

X'FFFFFFFFFF'

TIME

00時00分00秒

X'FFFFFF'

INTERVAL HOUR

TO SECOND

−99時間59分59秒間

X'FFFFFFFF'

BLOB

XTNL0

同左

BINARY(n)

n＜128のとき

X'00…00'　(nバイト)

n≧128のとき

X'00…00'　(127バイト)

同左

TIMESTAMP(n)

0001年01月01日00時00分00.000000秒※

X'FF…FF'

(7＋(N)÷2バイト)

注※

小数けたは定義によって0〜6けたになります。

(4)　出力ファイル

出力ファイルは抽出したデータを格納するファイルです。

HiRDB Dataextractorが抽出したデータを出力ファイルへ格納するときの記述形式について説明します。出力ファイルでの記述形式は，HiRDBのデータベース作成ユティリティの入力ファイルの形式を基にしています。

出力ファイルには，次の二つの形式があります。

バイナリ形式

DAT形式

(a)　バイナリ形式の場合

バイナリ形式の場合，抽出したデータをHiRDBのDBに格納されている形式で記述します。環境変数XTNLDFLTの指定により，データ形式が異なります。

次に環境変数XTNLDFLTの指定によるデータ形式を示します。

(i) 環境変数XTNLDFLTを省略，または0か１を指定した場合

列データと列データの間は，空白を入れないで詰めます。

各データ型に対する，列データの記述形式（バイナリ形式）を，次の表に示します。

表4‒15　列データの記述形式（バイナリ形式）

データ型

列データ記述形式

数データ

INTEGER，SMALLINT

DECIMAL(m，n)

1≦m≦38

0≦n≦38

m≧n

FLOAT，SMALLFLT

文字データ，

各国文字データ，

混在文字データ

CHARACTER(n)，VARCHAR(n)，MCHAR(n)，MVARCHAR(n)

NCHAR(n)，NVARCHAR(n)

日付データ

DATE

日間隔データ

INTERVAL YEAR TO DAY

時刻データ

TIME

時刻印データ

TIMESTAMP(n)

n=0，2，4，6

時間隔データ

INTERVAL HOUR TO SECOND

長大データ

BLOB

BINARY(n)

1≦n≦2,147,483,647

抽象データ型

SGMLTEXT

XML

FREEWORD

注※

2進数で，実データ長を設定します。

長さ0のデータ（0バイト文字）の場合には，実データ長に0を設定し，実データ部がない形式で格納します。

(ii) 環境変数XTNLDFLTに2を指定した場合

次の図を参照してください。

図4‒1　環境変数XTNLDFLTに2を指定した場合のデータの記述形式（バイナリ形式）

（説明）

行長：4バイトの領域に先頭から最終列データの末尾までの長さを設定します。

オフセット：4バイトの領域に先頭から各列データの先頭までの長さを設定します。

ナル値のデータの場合は0を設定し，列データおよび長大/抽象データは作成しません。

列データ：各データ型に対する，列データの記述形式を「表4-16　列データの記述形式（環境変数XTNLDFLTに2を指定した場合）」に示します。

長大/抽象データ：データ型がXML，BINARY，SGMLTEXT，またはBLOBで，列データ部にサイズを格納し実データを末尾に格納します。実データを格納するときの優先順位は次のとおりです。同一データ型が複数存在する場合は定義順に格納します。

XML

BINARY

SGMLTEXT

BLOB

表4‒16　列データの記述形式（環境変数XTNLDFLTに2を指定した場合）

データ型

列データ記述形式

XML

BINARY

4バイトに2進数でBINARYデータの長さを格納し，BINARYデータはレコードの末尾に格納します。XML型の列が複数ある場合には，BINARYデータは列の並び順で格納されます。

SGMLTEXT

BLOB

先頭8バイトの末尾4バイトに2進数でLOBデータの長さを格納し，LOBデータはレコードの末尾に格納します。

上記以外

各データ型の記述形式は「表4-15　列データの記述形式（バイナリ形式）」を参照してください。ただし，繰返し列の場合に環境変数XTNLDFLTに2を指定したときのデータ形式が変更となります。詳細については，「表3-6　環境変数XTNLDFLTに2を指定した場合のHiRDBの表への反映時およびバイナリ形式のファイル作成時の繰返し列のデータ形式」を参照してください。

(b)　DAT形式の場合

DAT形式の場合，抽出したデータを文字データで記述します。記述方法を次に示します。

ファイルの1行に対して，表の1行のデータを記述します。行の終わりには改行文字を記述します。

列データと列データとの間は，セパレータ文字で区切ります。

セパレータ文字は，−Rオプションで指定できます。指定が省略された場合は，コンマ（，）を使用します。

列データがナル値の場合は，どのデータ型のときにも記述しません（データなしとして扱います）。

各データ型に対する，列データの記述形式（DAT形式）を，次の表に示します。

表4‒17　列データの記述形式（DAT形式）

データ型

列データ記述形式

数データ

INTEGER

数値を文字で記述します。

マイナスは，"−"符号を付けます。

小数点は，整数．小数で記述します。

浮動小数点は，仮数部ｅ指数部で記述します。

整数（例：−1234　…　0　…　1234）

小数点（例：−1.56　…　0　…　1.56）

浮動小数点（例：−2.4e＋9　…　0e0　…　2.4e＋9）

SMALLINT

DECIMAL

FLOAT

SMALLFLT

文字データ

CHARACTER

文字の前後を引用符（"）で囲んで記述します。

（例："abcd"や"ABCD"など）

可変長データ型で，長さ0の場合，""と記述します。

VARCHAR

各国文字データ

NCHAR

NVARCHAR

混在文字データ

MCHAR

MVARCHAR

日付データ

DATE

数値yyyy-mm-ddの形式で記述します。

yyyy：西暦　mm：月　dd：日

（例：1998年1月1日→1998-01-01）

日間隔データ

INTERVAL YEAR TO DAY

数値〔−〕yyyymmdd．の形式で記述します。マイナスは"−"符号を付けます。

（例：1111年1か月1日間→11110101．）

時刻データ

TIME

数値hh：mm：ssの形式で記述します。

hh：時　mm：分　ss：秒

（例：12時1分1秒→12：01：01）

時刻印データ

TIMESTAMP(n)

n=2, 4, 6

数値 YYYY-MM-DD_hh：mm：ss．nnnnnnの形式で記述します。

YYYY：西暦　MM：月　DD：日　hh：時　mm：分　

ss：秒　nnnnnn：小数秒（0〜6けた）　_：半角スペース

（例：1997年10月15日15時30分25.666666秒

　→1997-10-15 15：30：25．666666）

時間隔データ

INTERVAL HOUR TO SECOND

数値〔−〕hhmmss．の形式で記述します。マイナスは"−"符号を付けます。

（例：1時間1分1秒→010101．）

長大データ

BLOB

LOB入力ファイルの名称を絶対パス名で記述します。

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

BINARY(n)

1≦n≦2,147,483,647

データの前後を引用符（"）で囲んで記述します。

（例："abcdef"）

抽象データ型

SGMLTEXT

原文書ファイルの名称を絶対パス名で記述します。

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

XML

記述形式はありません。

ファイル作成時は，反映情報ファイルにXMLの指定がない場合，BINARY属性として扱われます。XMLの指定がある場合はDATファイルへの出力はできません。

FREEWORD

文字の前後を引用符（"）で囲んで記述します。

（例："abcdef"）

長さ0の場合，""と記述します。

(5)　反映情報ファイル

反映情報ファイルには，データ型を変換する列情報とデータ型を指定します。

反映情報ファイルは，次の場合に指定します。

抽出データをファイルにだけ格納する場合

指定したデータ型でデータをファイルに出力します。反映情報ファイルを省略（−Lオプション省略）した場合の列，およびデータ型を指定しない列に対しては，抽出列のデータ型を格納時のデータ型として仮定します。

次のデータ型を抽出し，反映またはファイルに格納する場合

BLOB

BINARY

SGMLTEXT

XML

列単位に最大データ長を指定します。これによって，指定された長さのバッファを使用するためにバッファを節約できます。反映情報ファイルを省略（−Lオプション省略），またはデータ型を指定しない列に対するバッファサイズは環境変数XTLOBBUFSIZEに従います。

形式

ＦＯＲＭＡＴ
　｛ＦＩＥＬＤ＿ＮＵＭ　フィールド番号｜ＦＩＥＬＤ＿ＮＡＭＥ　列名｝ＡＴＴＲ　データ型
　　　　〔｛ＦＩＥＬＤ＿ＮＵＭ　フィールド番号｜ＦＩＥＬＤ＿ＮＡＭＥ｝ＡＴＴＲ　データ型〕…

説明

●ＦＯＲＭＡＴ

データ型を変換することを示します。

●ＦＩＥＬＤ＿ＮＵＭ

データ型変換の対象とする抽出列の先頭からの通番を指定します。

−sオプション指定なしの場合

抽出表の定義上の先頭からの通番。

−sオプション指定ありの場合

列名記述ファイルに指定した列名の先頭からの通番。

指定値範囲は1〜99,999です。フィールド番号は重複して指定できません。

●ＦＩＥＬＤ＿ＮＡＭＥ

データ型変換の対象とする抽出列名を指定します。

−sオプション指定時は指定できないので，FIELD_NUMを指定してください。

列名は重複して指定できません。

●ＡＴＴＲ

データ型を指定します。

指定可能なデータ型を次の表に示します。

注意事項

1行に一つの列について記述してください。複数列分記述したい場合は，複数行記述してください。

注釈は，"#"以降から，その行の終わりまでとします。

列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲んでください。

列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲んでください。

引用符（"）で囲まない場合は，すべて英大文字として扱われます。

抽出データを反映する場合，反映情報ファイルでのバッファサイズが反映側のBLOBデータ型の定義長より大きいときは，この指定を無効とし，BLOB列定義長のバッファを使用します。

表4‒18　ATTRに指定できるデータ型

指定できるデータ型※1

対応するHiRDBのデータ型

ファイル作成

HiRDB反映

INT

INTEGER

○

×

SINT

SMALLINT

○

×

DEC(m,n)※2

DECIMAL(m,n)

○

×

FLT

FLOAT

○

×

SFLT

SMALLFLT

○

×

CHAR(n)※3※10

CHAR(n)

○

×

VARCHAR(n)※3※10

VARCHAR(n)

○

×

MCHAR(n)※3

MCHAR(n)

○

×

MVARCHAR(n)※3

MVARCHAR(n)

○

×

NCHAR(n)※4

NCHAR(n)

○

×

NVARCHAR(n)※4

NVARCHAR(n)

○

×

DATE

DATE

○

×

TIME

TIME

○

×

YEAR

INTERVAL YEAR TO DAY

○

×

HOUR

INTERVAL HOUR TO SECOND

○

×

BLOB(n〔{K｜M｜G}〕)※5

BLOB(n〔{K｜M｜G}〕)

○※6

○※7

SGMLTEXT(n〔{K｜M｜G}〕)※5

SGMLTEXT

○※6

○※6

XML(n〔{K｜M｜G}〕)※5

XML

○※6

○※6

FREEWORD(n)※3

FREEWORD

○

×

BINARY(n)※8

BINARY(n)

○※6

○※7

TIMESTAMP(n)※9

TIMESTAMP(n)

○

×

（凡例）

○：指定できます。

×：指定できません（指定を無視し，反映側のデータ型を仮定します）。

注※1

指定できるデータ型の組み合わせについては，「表3-7　HiRDB Dataextractorで変換および比較できるデータ型」を参照してください。

注※2

mおよびnは，1≦m≦38，0≦n≦38，m≧nです。

注※3

nは，バイト数を符号なし整数を指定します。指定値範囲は1≦n≦32,767です。

注※4

nは，文字数を符号なし整数を指定します。指定値範囲は1≦n≦16,383です。

注※5

この指定値長は，環境変数XTLOBBUFSIZEと同等の意味があり，環境変数XTLOBBUFSIZEの指定値よりも優先されます。また，指定値の指定範囲と実際の最大長を次に示します。

単位

nの指定範囲

実際のサイズ（バイト）

なし

1≦n≦2,147,483,647

同左

K

1≦n≦2,097,152

n×1,024

M

1≦n≦2,048

n×1,048,576

G

1≦n≦2

n×1,073,741,824

ただし，実際の最大長の計算結果が2,147,483,648の場合は，2,147,483,647になります。

注※6

環境変数XTLOBBUFSIZEを省略した場合は必ず指定します。指定がない場合，バッファが確保できずにエラー終了することがあります。

注※7

指定した長さが反映側のBLOBデータ型の定義長よりも長い場合，この指定は無効とし，定義長を仮定します。

注※8

nは，バイト数を符号なし整数を指定します。指定値範囲は1≦ｎ≦2,147,483,647です。

注※9

nは，0，2，4，6のどれかになります。

注※10

文字集合列，またはNCHAR属性の文字データをUTF-16で抽出する場合，サイズの変更はできません。

(6)　排他情報ファイル

排他情報ファイルには，データ抽出時の排他情報について指定します。

排他情報ファイルの指定内容を次に示します。

環境変数XTSQLが0または省略時

"LOCK TABLE 表名"以降のLOCK文を指定します。

形式

ＩＮ　ＥＸＣＬＵＳＩＶＥ　ＭＯＤＥ　ＮＯＷＡＩＴ

環境変数XTSQLが1の場合

"LOCK TABLE"以降のLOCK文を指定します。

形式

表名　ＩＮ　ＥＸＣＬＵＳＩＶＥ　ＭＯＤＥ　ＮＯＷＡＩＴ

実際に発行されるLOCK文

LOCK TABLE 表名 IN EXCLUSIVE MODE NOWAIT

LOCK文の指定方法については，マニュアル「HiRDB SQLリファレンス」を参照してください。

注意事項

指定値の末尾にセミコロン（；）は指定しないでください。

4.3　出力リストの形式

4.3.1　データの抽出時の出力リスト

データの抽出側のHiRDB Dataextractorを実行したときに出力されるリストの形式について，説明します。

データの抽出側のHiRDB Dataextractorの実行結果はエラーログファイルに出力されます。エラーログファイルの名称については，「表2-3　HiRDB Dataextractorが作成するディレクトリおよびファイル」を参照してください。

データの抽出側のHiRDB Dataextractor実行時に出力される出力リストの構成を「図4-2　データの抽出時の出力リストの構成」に，データの抽出側のHiRDB Dataextractor実行結果リスト例を，「図4-3　データの抽出側のHiRDB Dataextractor実行結果リスト」に示します。

図4‒2　データの抽出時の出力リストの構成

図4‒3　データの抽出側のHiRDB Dataextractor実行結果リスト

説明

番号は，図中の丸付き数字と対応しています。

プログラムプロダクトの形名

ロードモジュール名

バージョン番号

リビジョン番号

PXTCNTL（HiRDB Dataextractorの入口プログラム）を実行した日付

yy：年（西暦下2けた）

mm：月

dd：日

PXTCNTLを実行した時刻

hh：時

mm：分

ss：秒

メッセージ出力元プロセスのプロセスID

メッセージ出力時刻

HiRDB Dataextractorのメッセージ

4.3.2　データの反映時の出力リスト

データの反映側のHiRDB Dataextractorを実行したときに出力されるリストの形式について，説明します。

データの反映側のHiRDB Dataextractor実行時に出力される出力リストの構成を「図4-4　データの反映時の出力リストの構成」に，データの反映側のHiRDB Dataextractor実行結果リスト例を，「図4-5　データの反映側のHiRDB Dataextractor実行結果リスト」に示します。

図4‒4　データの反映時の出力リストの構成

1，2：データの反映側のHiRDB Dataextractorの制御プロセスおよび入力ファイル作成プロセスの実行結果です。それぞれ別のエラーログファイルに出力されます。エラーログファイルの名称については，「表2-3　HiRDB Dataextractorが作成するディレクトリおよびファイル」を参照してください。

出力リスト中には，データの抽出側のHiRDB Dataextractorのデータ抽出プロセスのプロセスIDが出力されます。このプロセスIDをキーにして，データの抽出側に対応する反映側のHiRDB Dataextractorの出力リストが検索できます。

なお，「1.」の中にはpdloadの実行結果のメッセージが出力されます。詳細については，マニュアル「HiRDB メッセージ」を参照してください。

図4‒5　データの反映側のHiRDB Dataextractor実行結果リスト

説明

番号は，図中の丸付き数字に対応しています。

プログラムプロダクトの形名

ロードモジュール名

バージョン番号

リビジョン番号

PXTCNTLを実行した日付

yy：年（西暦下2けた）

mm：月

dd：日

PXTCNTLを実行した時刻

hh：時

mm：分

ss：秒

データの抽出側のHiRDB Dataextractorのデータ抽出プロセスのプロセスID

コネクション確立処理中にエラーが発生した場合は出力されません。

HiRDB Dataextractorのプロセス種別

M：制御プロセス

F：入力ファイル作成プロセス

メッセージ出力元プロセスのプロセスID

メッセージ出力時刻

pdloadのメッセージ

HiRDB Dataextractorのメッセージ

4.4　実行例

4.4.1　実行例の詳細

HiRDB Dataextractorの実行例について説明します。

実行例のシステム構成を次の図に示します。

図4‒6　実行例のシステム構成

(1)　実行例の環境

(a)　データの抽出側（HOST1）の環境

表の定義

・認可識別子user01の表の定義

CREATE TABLE T01(C01 CHAR(10),C02 CHAR(40),C03 INT)
CREATE TABLE T02(C01 CHAR(10),C02 CHAR(40),C03 INT,C04 INT)
CREATE FIX TABLE T03(C01 CHAR(10), C02 CHAR(40),C03 INT)
CREATE TABLE T04
 (C01 INT,
  C02 MVARCHAR(32),
  C03 SGMLTEXT ALLOCATE (SGMLTEXT IN RDLOB01)
   PLUGIN '<TEXTTYPE>SGML</TEXTTYPE><DTD>文書定義</DTD>',
  C04 DATE)
CREATE INDEX TEXT_IDX USING TYPE NGRAM
  ON T04(C03) IN RDLOB02

環境変数の設定

$PDDIR       /HiRDB1
$PDCONFPATH  /HiRDB1/conf
$PDUSER      "user01"/"user01"
$PDNAMEPORT  20000
$SHLIB_PATH  /HiRDB1/lib: /HiRDB1/client/lib
$PATH        /opt/HIRDBXT/bin
$LANG        ja_JP.SJIS
$XTHOST      HOST2
$XTPORTNO    20052

/etc/hostsでの反映先ホストの設定

        ：
        ：
160.16.150.120  HOST2
160.16.150.121  HOST3
        ：
        ：

(b)　データの反映側（HOST2）の環境

表の定義

・認可識別子user01の表の定義

CREATE TABLE T01(C01 CHAR(10),C02 CHAR(40),C03 INT)
CREATE TABLE T02(C01 CHAR(10),C02 CHAR(40),C03 INT,C04 INT)
CREATE TABLE T04
 (C01 INT,
  C02 MVARCHAR(32),
  C03 SGMLTEXT ALLOCATE (SGMLTEXT IN RDLOB01)
   PLUGIN '<TEXTTYPE>SGML</TEXTTYPE><DTD>文書定義</DTD>',
  C04 DATE)
CREATE INDEX TEXT_IDX USING TYPE NGRAM
  ON T04(C03) IN RDLOB02

・認可識別子user02の表の定義

CREATE FIX TABLE T03(C01 CHAR(10),C02 CHAR(40),C03 INT)

/etc/servicesでのポートの定義

                      ：
                      ：
hirdbxt1 20052/tcp    # HiRDB Dataextractor
hirdbxt2 50000/tcp    # HiRDB Dataextractor
                      ：
                      ：

/etc/inetd.confでのHiRDB Dataextractor起動のための定義

                      ：
                      ：
hirdbxt1 stream tcp nowait user01
/opt/HIRDBXT/bin/pxtcntl pxtcntl /usr/home/user01/xtenv1
hirdbxt2 stream tcp nowait user02
/opt/HIRDBXT/bin/pxtcntl pxtcntl /usr/home/user02/xtenv2
                      ：
                      ：

環境変数情報設定ファイルでの環境変数の設定

・サービス名hirdbxt1，ポート番号20052の環境変数情報設定ファイル

（/usr/home/user01/xtenv1）

set PDDIR=/HiRDB2
set PDCONFPATH=/HiRDB2/conf
set PDUSER="user01"/"user01"
set LANG=ja_JP.SJIS

・サービス名hirdbxt2，ポート番号50000の環境変数情報設定ファイル

（/usr/home/user02/xtenv2）

set PDDIR=/HiRDB2
set PDCONFPATH=/HiRDB2/conf
set PDUSER="user02"/"user02"
set LANG=ja_JP.SJIS

(c)　ファイル作成側（HOST3）の環境

/etc/servicesでのポートの定義

                     ：
                     ：
hirdbxt 20052/tcp    # HiRDB Dataextractor
                     ：
                     ：

/etc/inetd.confでのHiRDB Dataextractor起動のための定義

                     ：
                     ：
hirdbxt stream tcp nowait user01
/opt/HIRDBXT/bin/pxtcntl pxtcntl /usr/home/user01/xtenv
                     ：
                     ：

環境変数情報設定ファイルでの環境変数の設定

・サービス名hirdbxt，ポート番号20052の環境変数情報設定ファイル

（/usr/home/user01/xtenv）

set XTTMPDIR=/usr/home/user01/data
set LANG=ja_JP.SJIS

(2)　指定するコマンドとオプション

データの抽出側で，xtrepコマンドを指定します。

(a)　例1

表user01.T01をHOST2の表T01に複写します。

指定するオプションは次のとおりです。

反映側のHiRDB Dataextractorが使用するポート番号は20052に設定します。

既存のデータは削除しないで，データを追加します。

更新前ログを取得します。

一括出力ページ数は10ページに設定します。

経過メッセージを1万行単位で出力します。

抽出対象の表に排他制御をします。

ナル値の既定値は変更しません。

コマンド指定例

xtrep T01

(b)　例2

表user01.T01をHOST2の表T02に複写します。

指定するオプションは次のとおりです。

反映側のHiRDB Dataextractorが使用するポート番号は20052に設定します。

既存のデータを削除してデータを追加します。

ログを取得しません。

一括出力ページ数は255ページに設定します。

経過メッセージを10万行単位で出力します。

抽出対象の表の排他制御はしません。

列C01の値が’0000010000’以下の行を抽出し，列C04には定数０を設定します。

列C01のナル値既定値を’FFFFFFFFFF’にします。

コマンド指定例

xtrep -r T02 -d -l n -n 255 -m 100 -g -s /usr/home/user01/clm
-v /usr/home/user01/null -w /usr/home/user01/whr T01

/usr/home/user01/clmの内容

C01,C02,C03,0

/usr/home/user01/whrの内容

WHERE C01<='0000010000'

/usr/home/user01/nullの内容

C01=('FFFFFFFFFF')

(c)　例3

表user01.T03をHOST2の表T03に複写します。

指定するオプションは次のとおりです。

HiRDB Dataextractorが使用するポート番号は50000に設定します。

既存のデータは削除します。

更新前ログを取得します。

一括出力ページ数は40ページに設定します。

実行結果を/tmp/xtrep_logに取得します。

経過メッセージを1万行単位で出力します。

抽出対象の表に排他制御をします。

行単位インタフェースで抽出します。

ナル値の既定値は変更しません。

コマンド指定例

xtrep -d -n 40 -p 50000 -e /tmp/xtrep_log -s /usr/home/user01/clm T03

/usr/home/user01/clmの内容

ROW

(d)　例4

表user01.T03をHOST3のファイルに出力します。

指定するオプションは次のとおりです。

DAT形式のファイルを作成します。

出力ファイル名は，/usr/home/user01/data/T03にします。

コマンド指定例

xtrep -R dat -o T03 -h HOST3 T03

(e)　例5

表user01.T01をHOST3のファイルに出力します。

指定するオプションは次のとおりです。

DAT形式のファイルを作成します。

出力ファイル名は，/usr/home/user01/data/T01にします。

経過メッセージを5万行単位で出力します。

列C01の値が’0000010000’以下の行を抽出し，四番目の列には定数0を設定します。

コマンド指定例

xtrep -R dat -o T01 -h HOST3 -m 50 -s /usr/home/user01/clm
-w /usr/home/user01/whr T01

/usr/home/user01/clmの内容

C01,C02,C03,0

/usr/home/user01/whrの内容

WHERE C01<='0000010000'

(f)　例6

SGMLTEXT型の列を含む表user01.T04を，HOST2の表T04に複写します。

シェルを作成してxtrepコマンドを実行します。

あらかじめ，SGMLTEXT型の列の原文書（実データ）の最大長を求めます。求めた最大長を，環境変数XTLOBBUFSIZEに設定します。

HOST2の/opt/HIRDBXT/spool/下のxt_file1ファイルに，10Mバイトまで書き込み，xt_file1ファイルがいっぱいになったらxt_file2ファイルにデータを書き込みます。

既存のデータを削除してデータを追加します。

シェル作成例

　　#!/bin/csh -f
　　#--------------------------------------------------------------
　　#SGMLTEXT列のMAXサイズ取得

1.　echo 'max(length(extracts(C03)))' > xt_clm
2.　xtrep -R dat -o size -s xt_clm -h `hostname` T04
　　rm -f xt_clm

　　#--------------------------------------------------------------
　　#xtrepパラメタ,コマンド作成

3.　echo 'C01,C02,extracts(C03),C04' > xt_clm

　　echo '#! /bin/csh -f'                              >　xt_exec
4.　echo 'setenv XTERRLEVEL 1'                         >> xt_exec
　　echo 'setenv XTHOST HOST2'                         >> xt_exec
　　echo 'setenv XTFILESIZE 10000000'                  >> xt_exec
5.　echo 'setenv XTLOBBUFSIZE ¥c'                      >> xt_exec
　　cat  /opt/HIRDBXT/spool/size | cut -c2-11          >> xt_exec
　　echo 'xtrep -d -o xt_file1,xt_file2 -s xt_clm T04' >> xt_exec
　　chmod 777 xt_exec

　　#--------------------------------------------------------------
　　#xtrepの実行

6.　xt_exec

　　rm -f /opt/HIRDBXT/spool/size
　　rm -f xt_clm
　　rm -f xt_exec

説明

抽出表user01.T04のSGMLTEXT型の列（C03）の実データの最大長を求めるために，列名記述ファイルxt_clmを作成します。

xtrepコマンドに「1.」で作成した列名記述ファイルxt_clmを指定して実行し，抽出表user01.T04のSGMLTEXT型の列（C03）の実データの最大長を，HOST1の/opt/HIRDBXT/spool/sizeに出力します。

抽出表user01.T04の抽出をするために，列名記述ファイルxt_clmを作成します。

xtrepコマンドが使用する環境変数，コマンドラインをxt_execに出力します。

環境変数XTLOBBUFSIZEに，/opt/HIRDBXT/spool/sizeに出力した実データの最大長を設定します。

xtrepコマンドに「3.」で作成した列名記述ファイルxt_clmを指定して実行し，抽出表user01.T04を反映表T04に反映します。

(g)　例7

表user01.T01と表user01.T02を結合して（SQLのJOINを使って）HOST3のファイルに出力します。

指定するオプションは次のとおりです。

バイナリ形式のファイルを作成します。

出力ファイル名は，/usr/home/user01/data/T01_T02にします。

抽出対象の表の排他制御はしません。

表user01.T01の列C01，列C02と表user01.T02の列C04を抽出対象にします。

表user01.T01の列C01の格納値と表user01.T02の列C01の格納値が一致するデータを抽出します。

コマンド指定例

xtrep -R bin -o T01_T02 -h HOST3 -g -s /usr/home/user01/retsu
/usr/home/user01/hyou

データの抽出側(HOST1)に追加する環境変数の設定

$XTSQL 1

/usr/home/user01/retsuの内容

T01.C01,T01.C02,T02.C04

/usr/home/user01/hyouの内容

T01 INNER JOIN T02 ON T01.C01=T02.C01 WHERE T01.C01<='0000010000'

5　ORACLEからのデータ抽出，HiRDBへのデータ反映

ORACLEのデータベースからの，データの抽出，HiRDBの表への反映，およびファイル作成時の指定方法について説明します。

5.1　コマンド

HiRDB Dataextractorを使用して，ORACLEのDBからデータを抽出してHiRDBのDBへデータを反映するとき，および抽出したデータをファイルへ格納するときには，HiRDB Dataextractorが提供するxtrepOコマンドで操作します。

5.1.1　コマンドの記述形式

内容については，「4.2.1　コマンドの記述形式」を参照してください。

ただし，xtrepコマンドはxtrepOコマンドとなります。

5.1.2　xtrepOコマンド

(1)　機能

指定された抽出対象の表のデータを抽出して，反映対象の表に反映します。

また，オペランドの指定によって，指定された抽出対象の表のデータを抽出して，ファイルを作成します。

(2)　実行者

ORACLEにユーザ登録されている必要があります。また，環境変数XTORAUSERに指定するユーザにも制約があります。詳細は「2.2.3(2)環境変数の設定方法」を参照してください。

また，反映側でHiRDB Dataextractorを起動するユーザにも制約があります。詳細は「2.2.4(3)/etc/inetd.confの設定」または「7.2.2　OSI使用時のHiRDB Dataextractorの開始と終了」を参照してください。

(3)　実行するサーバマシン

データ抽出の対象にするORACLEのサーバマシンでコマンドを実行します。

(4)　形式

ｘｔｒｅｐＯ　〔−ｒ　〔スキーマ名．〕表識別子〕
　　　　　　〔−Ｒ　〔｛ｂｉｎ｜ｄａｔ｝〕〔，セパレータ文字〕〕
　　　　　　〔−ｏ　〔｛出力ファイル名｜出力ディレクトリ名｝
　　　　　　　　　　　〔，｛出力ファイル名｜出力ディレクトリ名｝〕…〕〕
　　　　　　〔−Ｏ　〔｛出力ファイル名｜出力ディレクトリ名｝
　　　　　　　　　　　〔，｛出力ファイル名｜出力ディレクトリ名｝〕…〕〕
　　　　　　〔−ｙ〕
　　　　　　〔−ｊ　ＲＤエリア名〕
　　　　　　〔−ｈ　反映先ホスト名〕
　　　　　　〔−Ｈ　シングルサーバのホスト名またはシステムマネジャのホスト名
　　　　　　　　〔，フロントエンドサーバのホスト名またはバックエンドサーバのホスト名〕〕
　　　　　　〔−ｐ　ポート番号〕
　　　　　　〔−ｆ　フロントエンドサーバ名またはバックエンドサーバ名〕
　　　　　　〔−ｄ〕
　　　　　　〔−ｉ　インデクス作成方法〕
　　　　　　〔−Ｉ　〔ｐｄｌｏａｄ制御情報環境変数名〕
　　　　　　　　　　〔，ｐｄｌｏａｄコマンドライン情報環境変数名〕
　　　　　　　　　　〔，ｐｄｌｏａｄ制御情報ファイルｓｏｕｒｃｅ文情報環境変数名〕〕
　　　　　　〔−ｌ　ログ取得方式〕
　　　　　　〔−Ｌ　反映情報ファイル名〕
　　　　　　〔−ｎ　一括出力ページ数〕
　　　　　　〔−ｚ〕
　　　　　　〔−ｅ　エラーログファイル名〕
　　　　　　〔−ｍ　経過メッセージ出力間隔〕
　　　　　　〔−ｇ　〔排他情報ファイル名〕〕
　　　　　　〔−ｓ　列名記述ファイル名〕
　　　　　　〔−ｗ　表式記述ファイル名〕
　　　　　　〔−ｖ　ナル値情報ファイル名〕
　　　　　　〔−ｂ　ＬＯＢ入力ファイル格納用ディレクトリ名〕
　　　　　　〔−ｑ　エラーデータファイル名〔，出力行数〕〕
　　　　　　〔−ｘ　シェルスクリプトファイル名〕
　　　　　　｛〔スキーマ名．〕表識別子｜表式記述ファイル名｝

(5)　オプション

xtrepOコマンドのオプションは基本的にはxtrepコマンドと同じです。

ここでは，xtrepOコマンド固有のオプションと，意味が変わるものについて説明します。

その他のオプションについては「4.2.2(4)形式」を参照してください。

●−Ｌ　反映情報ファイル名　〜＜パス名＞((1〜255けた))

反映情報ファイルを，絶対パス名で指定します。

次の場合は指定が必要です。

抽出したデータのデータ型を変換する場合

抽出したデータの長さを変更する場合

反映情報ファイルでの指定方法については，「5.1.4(4)　反映情報ファイル」を参照してください。

●−ｇ　〔排他情報ファイル名〕　〜＜パス名＞((1〜255けた))

排他制御方式を指定します。このオプションと排他情報ファイルの関係は次のようになります。

このオプションを省略した場合

LOCK文（「LOCK TABLE 表名 IN SHARE MODE」固定）での排他制御を行います。

このオプションだけを指定した場合

LOCK文を発行しません。

このオプションを指定し，かつ排他情報ファイルを指定した場合

LOCK文（排他情報ファイルに指定した内容）での排他制御を行います。

排他情報ファイルでの指定方法については，「5.1.4(3)　排他情報ファイル」を参照してください。

(6)　xtrepOコマンドのオプション組み合わせ

xtrepOコマンドのオプションは，データの抽出後に実行する機能によって，指定できるオプションが異なります。抽出したデータを表に反映する場合は−Rオプションを省略します。ファイルだけを作成して表に反映しない場合は−Rオプションを指定します。

xtrepOコマンドのオプションの組み合わせを，次の表に示します。

表5‒1　xtrepOコマンドのオプションの組み合わせ

オプション

実行する機能

指定形式

指定内容

反映機能

ファイル作成機能

−r

反映対象の表名

△

×

−R

ファイルの作成

−

●

−o

出力ファイル名またはディレクトリ名

（削除しない場合）

△

○

−O

出力ファイル名またはディレクトリ名

（削除する場合）

△

×

−y

上書きの可否

△

△

−j

格納対象のRDエリア名

△

×

−h

処理対象のホスト名

△

△

−H

反映対象のホスト名（抽出側のホストと反映側のホストが異なるLANで構成されている場合）

△

×

−p

処理対象のポート番号

△

△

−f

転送先のFESまたはBES

△

×

−d

格納方式（pdloadの指定値）

△

×

−i

インデクス作成方式（pdloadの指定値）

△

×

−I

pdload制御情報環境変数名

pdloadコマンドライン情報環境変数名

pdload制御情報ファイルsource文情報環境変数名

△

×

−l

ログ取得方式（pdloadの指定値）

△

×

−L

反映情報ファイル名

△

△

−n

一括出力ページ数（pdloadの指定値）

△

×

−z

0バイト文字の格納（pdloadの指定値）

△

×

−e

エラーログファイル名

△

△

−m

経過メッセージ出力間隔

△

△

−g

排他制御方式

△

△

−s

列名記述ファイル名

△

△

−w

表式記述ファイル名

△

△

−v

ナル値情報ファイル名

△

△

−b

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

△

△

−q

エラーデータファイル名，出力行数

△

×

−x

シェルスクリプトファイル名

×

△

※

抽出対象の表名

○

○

（凡例）

●：このオプションの指定で実行する機能を選択します。

−：表への反映時には指定しません。−Rオプションを指定した場合は，ファイル作成機能を実行して，表には反映しません。

○：必ず指定します（省略すると，JXU7300Eメッセージを出力してエラーになります）。

△：省略できます。

×：指定できません（指定すると，JXU7306EまたはJXU7307Eメッセージを出力してエラーになります）。

注※

指定形式を次に示します。

環境変数XTSQLが0または省略時

〔スキーマ名.〕表識別子

環境変数XTSQLが1の場合

表式記述ファイル名

5.1.3　データ抽出・反映の付加機能

ここでは，ORACLEからのデータ抽出・HiRDBへのデータ反映時の機能の中で，特に次の機能について説明します。

データ抽出時のSQLユーザ指定機能

ローダのパラメタユーザ任意指定機能

文字コード変換機能

(1)　データ抽出時のSQLユーザ指定機能

HiRDB Dataextractorでは，ORACLEからデータを抽出する際に発行する次のSQLに対して，ユーザ任意の指定を行うことができます。

LOCK TABLE文

SELECT文

この機能の適用範囲を次の表に示します。

表5‒2　ORACLEデータ抽出時のSQLユーザ指定機能の適用範囲

データ連携種別

抽出側

反映側

適用可否

XDM/XT連携

XDM/RD

HiRDB

−

順編成データセット

−

ORACLE

XDM/RD

○

順編成データセット

○

HiRDB Dataextractor連携

ORACLE

HiRDB

○

バイナリ形式ファイル

○

DAT形式ファイル

○

（凡例）

○：適用できます。

−：HiRDB Dataextractorでは対象外です。

(a)　XDM/XT連携での使用方法

XDM/XT連携でORACLEからデータを抽出する場合にこの機能を使用するときは，次の指定が必要です。

XDM/XTのJXUMCTL制御文

RDBDEF文，EXTRACT文

HiRDB Dataextractorの環境変数情報設定ファイル（抽出側）

環境変数情報設定ファイルに指定する環境変数は次のとおりです。

環境変数

環境変数の指定

PDHOST

△※

PDNAMEPORT

△※

XTEXTRACTDB

○

XTLCKxxxx

△

XTTBLxxxx

△

XTCLMxxxx

△

XTWHExxxx

△

（凡例）

○：必ず指定します。

△：必要に応じて指定します。

注※

XDM/XTのJXUMCTL制御文にRDBDEF文を指定した場合は必ず指定します。

各環境変数の詳細については，「2.2.3　環境変数の設定」を参照してください。

(b)　HiRDB Dataextractor連携での使用方法

HiRDB Dataextractor連携でORACLEからデータ抽出する場合にこの機能を使用するときは，xtrepOコマンドを実行します。

環境変数

抽出側に，環境変数XTSQLを必ず指定します。

コマンドオプション

この機能で指定が必要，不要となるオプションを次に示します。

コマンド

オプション

指定値

HiRDB反映

バイナリ，DATファイル作成

XTSQL

XTSQL

0

1

0

1

xtrepO

−g

−

△

○

△

○

排他情報ファイル

−r

〔スキーマ名.〕表識別子

△

○

×

×

−R

−

×

×

○

○

{bin｜dat}

−s

列名記述ファイル名

△

△

△

△

−w

表式記述ファイル名

△

×

△

×

〔スキーマ名.〕表識別子

−

○

×

○

×

表式記述ファイル名

−

×

○

×

○

（凡例）

○：必ず指定してください。

△：省略できます。

×：指定できません。

−：指定値はありません。

−ｇ　〔排他情報ファイル名〕

環境変数XTSQLとの組み合わせによってデータを抽出する表の排他制御を行います。環境変数XTSQLに1を指定した場合，このオプションを必ず指定します。

排他情報ファイルの詳細は次のとおりです。

XTSQL

−ｇオプション

動作

0

なし

−

コマンドラインの表名でLOCKTABLEを発行

あり

指定値なし

LOCK TABLEを発行しない

指定値あり

排他情報ファイルの内容でLOCK TABLEを発行

1

なし

−

エラー

あり

指定値なし

LOCK TABLEを発行しない

指定値あり

排他情報ファイルの内容でLOCK TABLEを発行

（凡例）

−：該当しません。

−ｒ　〔スキーマ名.〕表識別子

環境変数XTSQLに1を指定した場合，このオプションまたは−Ｒオプションを必ず指定します。

−Ｒ　〔｛ｂｉｎ｜ｄａｔ｝〕

環境変数XTSQLに1を指定した場合，このオプションまたは−ｒオプションを必ず指定します。

−ｓ　列名記述ファイル名

必要に応じて列名記述ファイルの名称を絶対パスで指定します。

−ｗ　表式記述ファイル名

環境変数XTSQLに1を指定した場合，このオプションは指定できません。

〔スキーマ名.〕表識別子

環境変数XTSQLを省略，または0を指定した場合に指定します。

表式記述ファイル名

環境変数XTSQLに１を指定した場合，このオプションを指定します。

各オプションの詳細については，「5.1.2　xtrepOコマンド」を参照してください。

ファイルの指定方法

オプションで指定するファイルの指定方法について説明します。

排他情報ファイル

LOCK TABLE文の排他制御オプションを指定します。

環境変数XTSQLの指定によって，次のようにファイル内容を指定します。

XTSQL

指定内容

0

"LOCK TABLE 表名"以降の排他オプションを指定します。

1

"LOCK TABLE"以降の排他オプションを指定します。

表式記述ファイル

SELECT文の表式を指定します。

環境変数XTSQLの指定によって，次のようにファイル内容を指定します。

XTSQL

指定内容

0

SELECT文"FROM 表名"以降の表式を指定します。

1

SELECT文"FROM"以降の表式を指定します。

注意事項

環境変数XTSQLに1を指定した場合，ナル値情報ファイルに列名を指定できません。ナル既定値，繰返し列データ形式などを指定する場合，フィールド番号で指定してください。列名を指定した場合は，エラーになります。

(2)　ローダのパラメタユーザ任意指定機能

HiRDB Dataextractorでは，HiRDBへデータを反映する際，HiRDBのデータベース作成ユティリティ（pdload）を起動しています。ローダのパラメタユーザ任意指定機能では，pdloadのパラメタをユーザ任意に指定できます。

この機能の適用範囲を次の表に示します。

表5‒3　ローダのパラメタユーザ任意指定機能の適用範囲（ORACLEデータ抽出時）

データ連携種別

抽出側

反映側

適用可否

HiRDB Dataextracotr連携

ORACLE

HiRDB

○

（凡例）

○：適用できます。

(a)　使用方法

ORACLEからデータを抽出する場合に，この機能を使うときは，xtrepOコマンドを実行します。

環境変数

反映側に次の環境変数を必要に応じて指定します。

XTLPRMxxxx

XTPDSRxxxx

コマンドオプション

この機能で指定が必要，不要となるオプションを次に示します。

コマンド

オプション

指定値

指定要否

xtrepO

−d

−

1'

−f

サーバ名

△

−i

{c｜s｜n｜x}

1'

−I

XTPDCFxxxx

△

XTLPRMxxxx

○1

XTPDSRxxxx

○2

−j

RDエリア名

△

−l

{a｜p｜n}

1'

−n

バッファ面数

1'

−q

エラーデータファイル名，件数

2'

−v

ナル値情報ファイル

△

−z

−

1'

（凡例）

○：この機能を使用する場合，どちらかは必ず指定してください。

△：省略できます。

−：指定値はありません。

1，1'：1と1'は同時に指定できません。

2，2'：2と2'は同時に指定できません。

●−Ｉ　〔XTPDCFxxxx〕〔，XTLPRMxxxx〕〔，XTPDSRxxxx〕

指定値は一つ以上指定します。複数指定する場合は，コンマ（，）で区切り，順不同に指定できます。

XTPDCFxxxx（pdload制御情報環境変数名）

必要に応じて指定してください。この環境変数の詳細は，「2.2.3　環境変数の設定」を参照してください。

XTLPRMxxxx（pdloadコマンドライン情報環境変数名）

この機能を使用する場合は，XTLPRMxxxxとXTPDSRxxxxのどちらかの環境変数は必ず指定してください。

注意事項

この環境変数を指定する場合，次のオプションは指定しないでください。

・−ｄオプション

・−ｉオプション

・−ｌオプション

・−ｎオプション

・−ｚオプション

この環境変数名を指定する場合，HiRDB Dataextractorはpdload起動時に表名，制御情報ファイル名，−ｂオプション，−ｋオプション，−ｖオプション以外のパラメタを指定しないため，必要なオプションはすべてpdloadコマンドライン情報ファイルに指定してください。

XTPDSRxxxx（pdload制御情報ファイルsource文情報環境変数名）

この機能を使用する場合は，XTLPRMxxxxとXTPDSRxxxxのどちらかの環境変数は必ず指定してください。

注意事項

この環境変数を指定する場合，−ｑオプションは指定できません。

(3)　文字コード変換機能

ORACLEからの抽出データの文字コードを環境変数の指定に従って，文字コード変換して反映できます。

この機能の適用範囲を次の表に示します。

表5‒4　文字コード変換機能の適用範囲（ORACLEデータ抽出時）

データ連携種別

抽出側

反映側

適用可否

HiRDB Dataextractor連携

ORACLE

HiRDB

○

バイナリ形式ファイル

○

DAT形式ファイル

○

（凡例）

○：適用できます。

(a)　文字コード変換機能の使用方法

環境変数およびナル値情報ファイルを指定することによって，データ反映時に文字コードが変換されます。

環境変数の詳細については，「4.2.3(3)文字コード変換機能」を参照してください。また，ナル値情報ファイルについては，「5.1.4(5)ナル値情報ファイル」を参照してください。

外字のコード変換については，「4.2.3(3)文字コード変換機能」を参照してください。

5.1.4　xtrepOコマンドで指定するファイルの内容

xtrepOコマンドで指定するファイルのうち，次のファイルの内容について説明します。その他のファイルについては「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

列名記述ファイル

表式記述ファイル

排他情報ファイル

反映情報ファイル

ナル値情報ファイル

(1)　列名記述ファイル

列名記述ファイルには，SELECT文での抽出列情報について指定します。

HiRDB Dataextractorでは，列名記述ファイルの指定値を用いてSELECT文を組み立て，ORACLEからデータを抽出します。

select 列名記述ファイルの指定値 FROM 抽出表名

−sオプションを省略した場合，アスタリスク(*)を仮定します。

SELECT文での選択式の指定方法については，ORACLEマニュアルを参照してください。

(2)　表式記述ファイル

表式記述ファイルには，SELECT文での条件を指定します。

HiRDB Dataextractorでは，列名記述ファイルの指定値を用いてSELECT文を組み立て，ORACLEからデータを抽出します。

select 列名記述ファイルの指定値 FROM 抽出表名 表式記述ファイルの指定値

−wオプションを省略した場合，条件は使用しません。

SELECT文での条件の指定方法については，ORACLEマニュアルを参照してください。

注意事項

指定値の末尾にセミコロン（；）は指定しないでください。

(3)　排他情報ファイル

排他情報ファイルには，データ抽出時の排他情報について指定します。

排他情報ファイルの指定内容を次に示します。

環境変数XTSQLが0または省略時

"LOCK TABLE 表名"以降のLOCK文を指定します。

形式

ＩＮ　ＥＸＣＬＵＳＩＶＥ　ＭＯＤＥ　ＮＯＷＡＩＴ

環境変数XTSQLが1の場合

"LOCK TABLE"以降のLOCK文を指定します。

形式

表名　ＩＮ　ＥＸＣＬＵＳＩＶＥ　ＭＯＤＥ　ＮＯＷＡＩＴ

実際に発行されるLOCK文

LOCK TABLE 表名 IN EXCLUSIVE MODE NOWAIT

LOCK文の指定方法については，ORACLEマニュアルを参照してください。

注意事項

指定値の末尾にセミコロン（；）は指定しないでください。

(4)　反映情報ファイル

反映情報ファイルには，データ型を変換する列情報とデータ型を指定します。

反映情報ファイルは，次のときに指定します。

抽出データをファイルにだけ格納する場合

指定したデータ型でデータを抽出します。反映情報ファイルを省略（−Lオプション省略）した場合の列，およびデータ型を指定しない列に対する仮定値を，「表5-5　省略時に仮定するデータ型」に示します。

次のデータ型をHiRDBのBLOB，BINARY型で抽出し，反映またはファイルに格納する場合

LONG

LONG RAW

BLOB

BFILE

CLOB

NCLOB

列単位に最大データ長を指定します。これによって，指定された長さのバッファを使用するためにバッファを節約できます。反映情報ファイルを省略（−Lオプション省略），またはデータ型を指定しない列に対するバッファサイズは環境変数XTLOBBUFSIZEに従います。

形式

ＦＯＲＭＡＴ
　｛ＦＩＥＬＤ＿ＮＵＭ　フィールド番号｜ＦＩＥＬＤ＿ＮＡＭＥ　列名｝ＡＴＴＲ　データ型
　　　　〔｛ＦＩＥＬＤ＿ＮＵＭ　フィールド番号｜ＦＩＥＬＤ＿ＮＡＭＥ｝ＡＴＴＲ　データ型〕…

説明

●ＦＯＲＭＡＴ

データ型を変換することを示します。

●ＦＩＥＬＤ＿ＮＵＭ

データ型変換の対象とする抽出列の先頭からの通番を指定します。

−sオプション指定なしの場合

抽出表の定義上の先頭からの通番

−sオプション指定ありの場合

列名記述ファイルに指定した列名の先頭からの通番

指定値範囲は1〜99,999です。また，フィールド番号は重複して指定できません。

●ＦＩＥＬＤ＿ＮＡＭＥ

データ型変換の対象とする抽出列名を指定します。

−sオプション指定時は指定できないので，FIELD_NUMを指定してください。

列名は重複して指定できません。

●ＡＴＴＲ

データ型を指定します。

指定可能なデータ型を「表5-6　ATTRに指定できるデータ型」に示します。

注意事項

1行に一つの列について記述してください。複数列分記述したい場合は，複数行記述してください。

注釈は，"＃"以降その行の終わりまでとします。

列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲みます。

列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲みます。

引用符（"）で囲まない場合は，すべて英大文字として扱われます。

表5‒5　省略時に仮定するデータ型

ORACLEのデータ型

けた数

仮定するデータ型

CHAR(n)

VARCHAR2(n)

NCHAR(n)

NVARCHAR2(n)

−

MCHAR(x)※1

NUMBER

NUMBER(p)

または

NUMBER(p,0)

p＜5

SINT

p＜10

INT

9＜p＜30

DEC(p)

NUMBER(p,s)

かつ

s<>0

p＜30かつ0＜s≦p

DEC(p,s)

p＜sかつs＜30

DEC(s,s)

s＜0かつp+｜s｜＜30

DEC(p+｜s｜,0)

上記以外

FLT

DATE

−

DATE※2

LONG

−

BLOB(x)※3

LONG RAW

RAW

BLOB

CLOB

NCLOB

BFILE

（凡例）

−：特に指定はありません。

注※1

ORACLEのデータ型がNCHARまたはNVARCHAR2の場合，x＝n×2となり，その他はx＝nとなります。

注※2

日付情報だけ取り出します。また，データの内容が紀元前の場合，エラーで終了します。

注※3

xの値は，環境変数XTLOBBUFSIZEの指定に従います。

表5‒6　ATTRに指定できるデータ型

指定できるデータ型※1

対応するHiRDBのデータ型

ファイル作成

HiRDB反映

INT

INTEGER

○

△

SINT

SMALLINT

○

△

DEC(m,n)※2

DECIMAL(m,n)

○

△

FLT

FLOAT

○

△

SFLT

SMALLFLT

○

△

CHAR(n)※3※10

CHAR(n)

○

△

VARCHAR(n)※3※10

VARCHAR(n)

○

△

MCHAR(n)※3

MCHAR(n)

○

△

MVARCHAR(n)※3

MVARCHAR(n)

○

△

NCHAR(n)※4

NCHAR(n)

○

△

NVARCHAR(n)※4

NVARCHAR(n)

○

△

DATE

DATE

○

△

TIME

TIME

○

△

YEAR

INTERVAL YEAR TO DAY

○

△

HOUR

INTERVAL HOUR TO SECOND

○

△

BLOB(n〔{K｜M｜G}〕)※5

BLOB(n〔{K｜M｜G}〕)

○※6

○※7

SGMLTEXT(n〔{K｜M｜G}〕)※5

SGMLTEXT

×

×

XML(n〔{K｜M｜G}〕)※5

XML

×

×

FREEWORD(n)※3

FREEWORD

×

×

BINARY(n)※8

BINARY(n)

○※6

○※7

TIMESTAMP(n)※9

TIMESTAMP(n)

○

△

(凡例)

○：指定できます。

△：指定できません（指定を無視し，反映側のデータ型を仮定します）。

×：指定できません（エラーになります）。

注※1

ORACLEのデータ型と指定できるデータ型の組み合わせについては「表3-10　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（1/2）」，「表3-11　HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）（2/2）」を参照してください。

注※2

mおよびnは，1≦m≦38，0≦n≦38，m≧nです。

注※3

nは，バイト数を符号なし整数を指定します。指定値範囲は1≦n≦32,767です。

注※4

nは，文字数を符号なし整数を指定します。指定値範囲は1≦n≦16,383です。

注※5

この指定値長は，環境変数XTLOBBUFSIZEと同等の意味があり，環境変数XTLOBBUFSIZEの指定値よりも優先されます。また，指定値の指定範囲と実際の最大長を次に示します。

単位

nの指定範囲

実際のサイズ（バイト）

なし

1≦n≦2,147,483,647

同左

K

1≦n≦2,097,152

n×1,024

M

1≦n≦2,048

n×1,048,576

G

1≦n≦2

n×1,073,741,824

ただし，実際の最大長の計算結果が2,147,483,648の場合は，2,147,483,647になります。

注※6

環境変数XTLOBBUFSIZEを省略した場合は必ず指定します。指定がない場合，バッファが確保できずにエラー終了することがあります。

注※7

指定した長さが反映側のBLOBデータ型の定義長よりも長い場合，この指定は無効とし，定義長を仮定します。

注※8

nは，バイト数を符号なし整数で指定します。指定値範囲は，1≦n≦2,147,483,647です。

注※9

nは，0，2，4，6のどれかになります。

注※10

文字集合列，またはNCHAR属性の文字データをUTF-16で抽出する場合，サイズの変更はできません。

(5)　ナル値情報ファイル

ナル値情報ファイルは，次のときに指定します。

ナル値の既定値を変更するとき

反映対象の列にナル値を格納する場合に，ナル値とみなす値を変更したいときに指定します。抽出したデータと，ここでの指定で設定した値が同じ場合に，表の列にナル値が格納されます。

また，ファイル作成の場合には，抽出データのナル値をどのような既定値としてファイルに格納するかを指定します。

ナル値情報ファイルを省略（−vオプション省略）した場合のナル値，およびここでの指定によって設定されるナル値の既定値については，「表4-11　ナル値の既定値」を参照してください。

形式

｛列名｜フィールド番号＝ＮＵＭ｝
　｛〔＝｛ＨＩＧＨ｜ＬＯＷ｜ＺＥＲＯ｜ＳＰＡＣＥ｜（’定数値’）｜
　　　　　（X’１６進定数値’）｝〕｜
　　〔，｛ＮＯＣＯＤＥＣＯＮＶ｜ＣＯＤＥＣＯＮＶ｝〕｝

説明

●列名

ナル値の既定値を変更する列を指定します。

HiRDBの表に反映する場合

反映側の表の列名で指定してください。

ファイルだけを作成する場合

抽出側の表の列名で指定してください。

−sオプション指定時は指定できません。

●フィールド番号＝ＮＵＭ

ナル値の既定値を変更する列の先頭からの通番を指定します。

指定値範囲は1〜99999

フィールド番号は重複して指定できません。

HiRDBの表に反映する場合

反映表の定義上の先頭からの通番。

ファイルだけを作成する場合

−sオプション指定なしの場合

抽出表の定義上の先頭からの通番。

−sオプション指定ありの場合

列名記述ファイルに指定した列名の先頭からの通番。

●｛ＨＩＧＨ｜ＬＯＷ｜ＺＥＲＯ｜ＳＰＡＣＥ｜（’定数値’）｜（X’１６進定数値’）｝

ナル値の既定値を指定します。

ここでの指定によって設定される値については，「表4-11　ナル値の既定値」を参照してください。

●｛ＮＯＣＯＤＥＣＯＮＶ｜ＣＯＤＥＣＯＮＶ｝

列単位にコード変換の有無を指定します。

ＮＯＣＯＤＥＣＯＮＶ：文字コード変換機能を使わない場合に指定します。この指定値は，環境変数XTLOCALEを指定してコード変換を行う場合だけ有効となります。

ＣＯＤＥＣＯＮＶ：文字コード変換機能を使う場合に指定します。この指定値は，環境変数XTLOCALEを指定してコード変換を行う場合だけ有効となります。

注意事項

NCHAR属性列で，かつ環境変数XTORANCSETにutf-16を指定した場合，文字コード変換対象となりません。NCHAR属性列を文字コード変換対象にするためには，次の条件をすべて満たす必要があります。

すべての文字列がNCHAR属性である。

すべての文字列にCODECONVを指定する。

抽出側の環境変数XTDATALOCALEにutf-16BE，またはutf-16LEを指定する。

記述規則

1行に一つの列について記述します。複数列分記述したい場合は，複数行記述してください。

注釈は，"＃"以降その行の終わりまでとします。

列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲んでください。

列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲んでください。

引用符（"）で囲まない場合は，すべて英大文字として扱われます。

定数値を指定する場合は，255バイト以下で指定してください。

定数値中に「’）」は指定しないでください（アポストロフィ「’」と右括弧「）」は連続して指定しないでください）。

HiRDBの表へ反映する場合，反映側の列が非NULL属性のときは，ナル既定値がそのままデータとして格納されます。

ファイルの作成時，抽出側の列が非NULL属性のときは，指定を無視します。

記述例

CLM01=HIGH                        #INT
CLM02=LOW                         #DATE
CLM03=('FFFF')                    #CHAR(4)
4=NUM=SPACE                       #CHAR(4)

環境変数XTNLDFLTの指定によって，ナル値情報ファイルの指定規則が異なります。環境変数XTNLDFLTの指定によるナル値情報ファイルの指定規則を次の表に示します。

表5‒7　ナル値情報ファイルの指定規則（ORACLEからのデータ抽出の場合）

ナル値情報ファイル

指定内容

環境変数XTNLDFLTの指定値

0または１

2

HiRDB反映

ファイル作成

HiRDB反映

ファイル作成

バイナリ

形式

DAT形式

バイナリ

形式

DAT形式

列名｜フィールド番号=NUM

◎

◎

◎

◎

◎

◎

ナル値の既定値

○

○

○

×

×

×

NOCODECONV｜CODECONV

○

○

○

○

○

○

（凡例）

◎：必ず指定してください。

○：指定できます。

×：指定できません。

5.2　出力リストの形式

出力リスト形式については「4.3　出力リストの形式」を参照してください。

5.3　実行例

5.3.1　実行例の詳細

HiRDB Dataextractorの実行例について説明します。

実行例のシステム構成を次の図に示します。

図5‒1　実行例のシステム構成（ORACLEからのデータ抽出時）

(1)　実行例の環境

(a)　データの抽出側（HOST1）の環境

表の定義

表名

列名，および属性

TORA01

C01 CHAR(10),C02 NUMBER(10,8),C03 DATE

TORA02

C01 CHAR(10),C02 NUMBER(10,8),C03 NUMBER

環境変数の設定

$ORACLE_BASE /ORACLE8/ORACLE
$ORACLE_HOME /ORACLE8/ORACLE/product/8.1.6
$ORA_NLS33   /ORACLE8/ORACLE/product/8.1.6/ocommon/nls/admin/data
$NLS_LANG    Japanese_Japan.JA16SJIS
$ORACLE_SID  hds1
$ORACLE_TERM hp
$XTORAUSER   "user01"/"user01"
$PATH        /opt/HIRDBXT/bin
$LANG        ja_JP.SJIS
$XTHOST      HOST2
$XTPORTNO    20052

/etc/hostsでの反映先ホストの設定

        :
        :
160.16.150.120  HOST2
160.16.150.121  HOST3
        :
        :

(b)　データの反映側（HOST2）の環境

表の定義

・スキーマ名user01の表の定義

CREATE TABLE T01(C01 CHAR(10),C02 DEC(10,8),C03 DATE,C04 TIME)
CREATE TABLE T02(C01 CHAR(10),C02 DEC(10,8),C03 INT, C04 INT)

・スキーマ名user02の表の定義

CREATE FIX TABLE T03(C01 CHAR(10),C02 DEC(10,8),C03 TIME)

/etc/servicesでのポートの定義

                      :
                      :
hirdbxt1 20052/tcp    # HiRDB Dataextractor
hirdbxt2 50000/tcp    # HiRDB Dataextractor
                      :
                      :

/etc/inetd.confでのHiRDB Dataextractor起動のための定義

                      :
                      :
hirdbxt1 stream tcp nowait user01
/opt/HIRDBXT/bin/pxtcntl pxtcntl /usr/home/user01/xtenv1
hirdbxt2 stream tcp nowait user02
/opt/HIRDBXT/bin/pxtcntl pxtcntl /usr/home/user02/xtenv2
                      :
                      :

環境変数情報設定ファイルでの環境変数の設定

・サービス名hirdbxt1，ポート番号20052の環境変数情報設定ファイル

（/usr/home/user01/xtenv1）

set PDDIR=/HiRDB2
set PDCONFPATH=/HiRDB2/conf
set PDUSER="user01"/"user01"
set LANG=ja_JP.SJIS

・サービス名hirdbxt2，ポート番号50000の環境変数情報設定ファイル

（/usr/home/user02/xtenv2）

set PDDIR=/HiRDB2
set PDCONFPATH=/HiRDB2/conf
set PDUSER="user02"/"user02"
set LANG=ja_JP.SJIS

(c)　ファイル作成側（HOST3）の環境

/etc/servicesでのポートの定義

                     :
                     :
hirdbxt 20052/tcp    # HiRDB Dataextractor
                     :
                     :

/etc/inetd.confでのHiRDB Dataextractor起動のための定義

                     :
                     :
hirdbxt stream tcp nowait user01
/opt/HIRDBXT/bin/pxtcntl pxtcntl /usr/home/user01/xtenv
                     :
                     :

環境変数情報設定ファイルでの環境変数の設定

・サービス名hirdbxt，ポート番号20052の環境変数情報設定ファイル

（/usr/home/user01/xtenv）

set XTTMPDIR=/usr/home/user01/data
set LANG=ja_JP.SJIS

(2)　指定するコマンドとオプション

データの抽出側で，xtrepOコマンドを指定します。

(a)　例1

HOST1の表TORA01をHOST2の表T01に複写します。

指定するオプションは次のとおりです。

反映側のHiRDB Dataextractorが使用するポート番号は20052に設定します。

既存のデータは削除しないで，データを追加します。

更新前ログを取得します。

一括出力ページ数は10ページに設定します。

経過メッセージを1万行単位で出力します。

抽出対象の表に排他制御をします。

ナル値の既定値は変更しません。

コマンド指定例

xtrepO -r T01 -s /usr/home/user01/clm TORA01

/usr/home/user01/clmの内容

C01,C02,C03,C03

(b)　例2

HOST1の表TORA02をHOST2の表T02に複写します。

指定するオプションは次のとおりです。

反映側のHiRDB Dataextractorが使用するポート番号は20052に設定します。

既存のデータを削除してデータを追加します。

ログを取得しません。

一括出力ページ数は255ページに設定します。

経過メッセージを10万行単位で出力します。

抽出対象の表の排他制御はしません。

列C01の値が’0000010000’以下の行を抽出し，列C04には定数0を設定します。

列C01のナル値既定値を’FFFFFFFFFF’にします。

コマンド指定例

xtrepO -r T02 -d -l n -n 255 -m 100 -g -s /usr/home/user01/clm
-v /usr/home/user01/null -w /usr/home/user01/whr TORA02

/usr/home/user01/clmの内容

C01,C02,C03,0

/usr/home/user01/nullの内容

1=NUM=('FFFFFFFFFF')

/usr/home/user01/whrの内容

WHERE C01<='0000010000'

(c)　例3

HOST1の表TORA01をHOST2の表T03に複写します。

指定するオプションは次のとおりです。

HiRDB Dataextractorが使用するポート番号は50000に設定します。

既存のデータは削除します。

更新前ログを取得します。

一括出力ページ数は40ページに設定します。

実行結果を/tmp/xtrep_logに取得します。

経過メッセージを1万行単位で出力します。

抽出対象の表に任意の排他制御をします。

ナル値の既定値は変更しません。

コマンド指定例

xtrepO -d -r T03 -n 40 -p 50000 -e /tmp/xtrep_log -g /usr/home/user01/lck TORA01

/usr/home/user01/lckの内容

IN EXCLUSIVE MODE NOWAIT

(d)　例4

HOST1の表TORA01をHOST3のファイルに出力します。

指定するオプションは次のとおりです。

DAT形式のファイルを作成します。

出力ファイル名は，/usr/home/user01/data/TORA01にします。

全列に対して，変換するデータ型は指定しません。

コマンド指定例

xtrepO -R dat -o TORA01 -h HOST3 -s /usr/home/user01/clm TORA01

/usr/home/user01/clmの内容

C01,C02,C03

(e)　例5

HOST1の表TORA01をHOST3のファイルに出力します。

指定するオプションは次のとおりです。

バイナリ形式のファイルを作成します。

出力ファイル名は，/usr/home/user01/data/TORA01_BINにします。

抽出表の列C01はMCHAR(20)属性に変換します。

抽出表の列C03はTIME属性に変換します。

経過メッセージを5万行単位で出力します。

列C01の値が’0000010000’以下の行を抽出します。

コマンド指定例

xtrep0 -R -o TORA01_BIN -h HOST3 -m 50 -s /usr/home/user01/clm
-w /usr/home/user01/whr -L /usr/home/user01/cnv TORA01

/usr/home/user01/clmの内容

C01,C02,C03

/usr/home/user01/whrの内容

WHERE C01<='0000010000'

/usr/home/user01/cnvの内容

FORMAT FIELD_NUM 1 ATTR MCHAR(20)
       FIELD_NUM 3 ATTR TIME

6　SQL Serverからのデータ抽出，HiRDBへのデータ反映

SQL Serverのデータベースからの，データの抽出，HiRDBの表への反映，およびファイル作成時の指定方法について説明します。

6.1　コマンド

HiRDB Dataextractorを使用して，SQL ServerのDBからデータを抽出してHiRDBのDBへデータを反映するとき，および抽出したデータをファイルへ格納するときには，HiRDB Dataextractorが提供するxtrepSコマンドで操作します。

6.1.1　コマンドの記述形式

内容については，「4.2.1　コマンドの記述形式」を参照してください。

ただし，xtrepコマンドはxtrepSコマンドとなります。

6.1.2　xtrepSコマンド

(1)　機能

指定された抽出対象の表のデータを抽出して，反映対象の表に反映します。

また，オペランドの指定によって，指定された抽出対象の表のデータを抽出して，ファイルを作成します。

(2)　実行者

SQL Serverにユーザ登録されている必要があります。

(3)　実行するサーバマシン

ODBCを使用してSQL Serverに接続できるマシンでコマンドを実行します。

(4)　形式

ｘｔｒｅｐS　〔−ｒ　〔スキーマ名．〕表識別子〕
　　　　　　〔−Ｒ　〔｛ｂｉｎ｜ｄａｔ｝〕〔，セパレータ文字〕〕
　　　　　　〔−ｏ　〔｛出力ファイル名｜出力ディレクトリ名｝
　　　　　　　　　　　〔，｛出力ファイル名｜出力ディレクトリ名｝〕…〕〕
　　　　　　〔−Ｏ　〔｛出力ファイル名｜出力ディレクトリ名｝
　　　　　　　　　　　〔，｛出力ファイル名｜出力ディレクトリ名｝〕…〕〕
　　　　　　〔−ｙ〕
　　　　　　〔−ｊ　ＲＤエリア名〕
　　　　　　〔−ｈ　反映先ホスト名〕
　　　　　　〔−Ｈ　シングルサーバのホスト名またはシステムマネジャのホスト名
　　　　　　　　〔，フロントエンドサーバのホスト名またはバックエンドサーバのホスト名〕〕
　　　　　　〔−ｐ　ポート番号〕
　　　　　　〔−ｆ　フロントエンドサーバ名またはバックエンドサーバ名〕
　　　　　　〔−ｄ〕
　　　　　　〔−ｉ　インデクス作成方法〕
　　　　　　〔−Ｉ　〔ｐｄｌｏａｄ制御情報環境変数名〕
　　　　　　　　　　〔，ｐｄｌｏａｄコマンドライン情報環境変数名〕
　　　　　　　　　　〔，ｐｄｌｏａｄ制御情報ファイルｓｏｕｒｃｅ文情報環境変数名〕〕
　　　　　　〔−ｌ　ログ取得方式〕
　　　　　　〔−Ｌ　反映情報ファイル名〕
　　　　　　〔−ｎ　一括出力ページ数〕
　　　　　　〔−ｚ〕
　　　　　　〔−ｅ　エラーログファイル名〕
　　　　　　〔−ｍ　経過メッセージ出力間隔〕
　　　　　　〔−ｓ　列名記述ファイル名〕
　　　　　　〔−ｗ　表式記述ファイル名〕
　　　　　　〔−ｖ　ナル値情報ファイル名〕
　　　　　　〔−ｂ　ＬＯＢ入力ファイル格納用ディレクトリ名〕
　　　　　　〔−ｑ　エラーデータファイル名〔，出力行数〕〕
　　　　　　〔−ｘ　シェルスクリプトファイル名〕
　　　　　　〔−ａ　個別環境セクション名〕
　　　　　　｛〔スキーマ名．〕表識別子｜表式記述ファイル名｝

(5)　オプション

xtrepSコマンドのオプションは基本的にはxtrepコマンドと同じです。

ここでは，xtrepSコマンド固有のオプションと，意味が変わるものについて説明します。

その他のオプションについては「4.2.2(4)　形式」，および「付録B.5　コマンドの指定方法」を参照してください。

●−Ｌ　反映情報ファイル名　〜＜パス名＞((1〜255けた))

反映情報ファイルを，絶対パス名で指定します。

次の場合は指定が必要です。

抽出したデータのデータ型を変換する場合

抽出したデータの長さを変更する場合

反映情報ファイルでの指定方法については，「6.1.4(3)　反映情報ファイル」を参照してください。

SQL Server抽出時に排他制御をする場合

SQL Server抽出時に排他制御をする場合，表式記述ファイルにWITH句を記述してください。xtrepおよびxtrepOコマンドで指定できる-gオプションは，xtrepSコマンドでは指定できません。表式記述ファイルについては,「6.1.4(2)　表式記述ファイル」を参照してください。

(6)　xtrepSコマンドのオプション組み合わせ

xtrepSコマンドのオプションは，データの抽出後に実行する機能によって，指定できるオプションが異なります。抽出したデータを表に反映する場合は−Rオプションを省略します。ファイルだけを作成して表に反映しない場合は−Rオプションを指定します。

xtrepSコマンドのオプションの組み合わせを，次の表に示します。

表6‒1　xtrepSコマンドのオプションの組み合わせ

オプション

実行する機能

指定形式

指定内容

反映機能

ファイル作成機能

−r

反映対象の表名

△

×

−R

ファイルの作成

−

●

−o

出力ファイル名またはディレクトリ名

（削除しない場合）

△

○

−O

出力ファイル名またはディレクトリ名

（削除する場合）

△

×

−y

上書きの可否

△

△

−j

格納対象のRDエリア名

△

×

−h

処理対象のホスト名

△

△

−H

反映対象のホスト名（抽出側のホストと反映側のホストが異なるLANで構成されている場合）

△

×

−p

処理対象のポート番号

△

△

−f

転送先のFESまたはBES

△

×

−d

格納方式（pdloadの指定値）

△

×

−i

インデクス作成方式（pdloadの指定値）

△

×

−I

pdload制御情報環境変数名

pdloadコマンドライン情報環境変数名

pdload制御情報ファイルsource文情報環境変数名

△

×

−l

ログ取得方式（pdloadの指定値）

△

×

−L

反映情報ファイル名

△

△

−n

一括出力ページ数（pdloadの指定値）

△

×

−z

0バイト文字の格納（pdloadの指定値）

△

×

−e

エラーログファイル名

△

△

−m

経過メッセージ出力間隔

△

△

−s

列名記述ファイル名

△

△

−w

表式記述ファイル名

△

△

−v

ナル値情報ファイル名

△

△

−b

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

△

△

−q

エラーデータファイル名，出力行数

△

×

−x

シェルスクリプトファイル名

×

△

−a

個別環境セクション名

△

△

※

抽出対象の表名

○

○

（凡例）

●：このオプションの指定で実行する機能を選択します。

−：表への反映時には指定しません。−Rオプションを指定した場合は，ファイル作成機能を実行して，表には反映しません。

○：必ず指定します（省略すると，JXU7300Eメッセージを出力してエラーになります）。

△：省略できます。

×：指定できません（指定すると，JXU7306EまたはJXU7307Eメッセージを出力してエラーになります）。

注※

指定形式を次に示します。

環境変数XTSQLが0または省略時

〔スキーマ名.〕表識別子

環境変数XTSQLが1の場合

表式記述ファイル名

6.1.3　データ抽出・反映の付加機能

ここでは，SQL Serverからのデータ抽出・HiRDBへのデータ反映時の機能の中で，特に次の機能について説明します。

データ抽出時のSQLユーザ指定機能

ローダのパラメタユーザ任意指定機能

文字コード変換機能

(1)　データ抽出時のSQLユーザ指定機能

HiRDB Dataextractorでは，SQL Serverからデータを抽出する際に発行するSELECT文に対して，ユーザ任意の指定を行うことができます。

この機能の適用範囲を次の表に示します。

表6‒2　SQL Serverデータ抽出時のSQLユーザ指定機能の適用範囲

データ連携種別

抽出側

反映側

適用可否

HiRDB Dataextractor連携

SQL Server

HiRDB

○

バイナリ形式ファイル

○

DAT形式ファイル

○

（凡例）

○：適用できます。

(a)　HiRDB Dataextractor連携での使用方法

HiRDB Dataextractor連携でSQL Serverからデータ抽出する場合にこの機能を使用するときは，xtrepSコマンドを実行します。

環境変数

抽出側に，環境変数XTSQLを必ず指定します。

コマンドオプション

この機能で指定が必要，不要となるオプションを次に示します。

コマンド

オプション

指定値

HiRDB反映

バイナリ，DATファイル作成

XTSQL

XTSQL

0

1

0

1

xtrepS

−r

〔スキーマ名.〕表識別子

△

○

×

×

−R

−

×

×

○

○

{bin｜dat}

−s

列名記述ファイル名

△

△

△

△

−w

表式記述ファイル名

△

×

△

×

〔スキーマ名.〕表識別子

−

○

×

○

×

表式記述ファイル名

−

×

○

×

○

（凡例）

○：必ず指定してください。

△：省略できます。

×：指定できません。

−：指定値はありません。

−ｒ　〔スキーマ名.〕表識別子

環境変数XTSQLに1を指定した場合，このオプションまたは−Ｒオプションを必ず指定します。

−Ｒ　〔｛ｂｉｎ｜ｄａｔ｝〕

環境変数XTSQLに1を指定した場合，このオプションまたは−ｒオプションを必ず指定します。

−ｓ　列名記述ファイル名

必要に応じて列名記述ファイルの名称を絶対パスで指定します。

−ｗ　表式記述ファイル名

環境変数XTSQLに1を指定した場合，このオプションは指定できません。

〔スキーマ名.〕表識別子

環境変数XTSQLを省略，または0を指定した場合に指定します。

表式記述ファイル名

環境変数XTSQLに１を指定した場合，このオプションを指定します。

各オプションの詳細については，「6.1.2　xtrepSコマンド」を参照してください。

ファイルの指定方法

オプションで指定するファイルの指定方法について説明します。

表式記述ファイル

SELECT文の表式を指定します。

環境変数XTSQLの指定によって，次のようにファイル内容を指定します。

XTSQL

指定内容

0

SELECT文"FROM 表名"以降の表式を指定します。

1

SELECT文"FROM"以降の表式を指定します。

注意事項

環境変数XTSQLに1を指定した場合，ナル値情報ファイルに列名を指定できません。ナル既定値，繰返し列データ形式などを指定する場合，フィールド番号で指定してください。列名を指定した場合は，エラーになります。

(2)　ローダのパラメタユーザ任意指定機能

HiRDB Dataextractorでは，HiRDBへデータを反映する際，HiRDBのデータベース作成ユティリティ（pdload）を起動しています。ローダのパラメタユーザ任意指定機能では，pdloadのパラメタをユーザ任意に指定できます。

この機能の適用範囲を次の表に示します。

表6‒3　ローダのパラメタユーザ任意指定機能の適用範囲（SQL Serverデータ抽出時）

データ連携種別

抽出側

反映側

適用可否

HiRDB Dataextracotr連携

SQL Server

HiRDB

○

（凡例）

○：適用できます。

(a)　使用方法

SQL Serverからデータを抽出する場合に，この機能を使うときは，xtrepSコマンドを実行します。

環境変数

反映側に次の環境変数を必要に応じて指定します。

XTLPRMxxxx

XTPDSRxxxx

コマンドオプション

この機能で指定が必要，不要となるオプションを次に示します。

コマンド

オプション

指定値

指定要否

xtrepS

−d

−

1'

−f

サーバ名

△

−i

{c｜s｜n｜x}

1'

−I

XTPDCFxxxx

△

XTLPRMxxxx

○1

XTPDSRxxxx

○2

−j

RDエリア名

△

−l

{a｜p｜n}

1'

−n

バッファ面数

1'

−q

エラーデータファイル名，件数

2'

−v

ナル値情報ファイル

△

−z

−

1'

（凡例）

○：この機能を使用する場合，どちらかは必ず指定してください。

△：省略できます。

−：指定値はありません。

1，1'：1と1'は同時に指定できません。

2，2'：2と2'は同時に指定できません。

●−Ｉ　〔XTPDCFxxxx〕〔，XTLPRMxxxx〕〔，XTPDSRxxxx〕

指定値は一つ以上指定します。複数指定する場合は，コンマ（，）で区切り，順不同に指定できます。

XTPDCFxxxx（pdload制御情報環境変数名）

必要に応じて指定してください。この環境変数の詳細は，「2.2.3　環境変数の設定」を参照してください。

XTLPRMxxxx（pdloadコマンドライン情報環境変数名）

この機能を使用する場合は，XTLPRMxxxxとXTPDSRxxxxのどちらかの環境変数は必ず指定してください。

注意事項

この環境変数を指定する場合，次のオプションは指定しないでください。

−ｄオプション

−ｉオプション

−ｌオプション

−ｎオプション

−ｚオプション

この環境変数名を指定する場合，HiRDB Dataextractorはpdload起動時に表名，制御情報ファイル名，−ｂオプション，−ｋオプション，−ｖオプション以外のパラメタを指定しないため，必要なオプションはすべてpdloadコマンドライン情報ファイルに指定してください。

XTPDSRxxxx（pdload制御情報ファイルsource文情報環境変数名）

この機能を使用する場合は，XTLPRMxxxxとXTPDSRxxxxのどちらかの環境変数は必ず指定してください。

注意事項

この環境変数を指定する場合，−ｑオプションは指定できません。

(3)　文字コード変換機能

SQL Serverからの抽出データの文字コードを環境変数の指定に従って，文字コード変換して反映できます。

この機能の適用範囲を次の表に示します。

表6‒4　文字コード変換機能の適用範囲（SQL Serverデータ抽出時）

データ連携種別

抽出側

反映側

適用可否

HiRDB Dataextractor連携

SQL Server

HiRDB

○

バイナリ形式ファイル

○

DAT形式ファイル

○

（凡例）

○：適用できます。

(a)　文字コード変換機能の使用方法

環境変数およびナル値情報ファイルを指定することによって，データ反映時に文字コードが変換されます。

環境変数の詳細については，「4.2.3(3)文字コード変換機能」を参照してください。また，ナル値情報ファイルについては，「6.1.4(4)ナル値情報ファイル」を参照してください。

外字のコード変換については，「4.2.3(3)文字コード変換機能」を参照してください。

6.1.4　xtrepSコマンドで指定するファイルの内容

xtrepSコマンドで指定するファイルのうち，次のファイルの内容について説明します。その他のファイルについては「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

列名記述ファイル

表式記述ファイル

反映情報ファイル

ナル値情報ファイル

(1)　列名記述ファイル

列名記述ファイルには，SELECT文での抽出列情報について指定します。

HiRDB Dataextractorでは，列名記述ファイルの指定値を用いてSELECT文を組み立て，SQL Serverからデータを抽出します。

select 列名記述ファイルの指定値 FROM 抽出表名

−sオプションを省略した場合，アスタリスク(*)を仮定します。

注意事項

指定規則などの詳細については，SQL Serverマニュアルを参照してください。

HiRDB Dataextractorは，関数を指定した列名を認識できません。このため，関数を指定した列名には次の名称を仮定します。

"#列番号"

列番号は，先頭からの通番です。

属性が異なる場合で，HiRDBのDECIMAL型に反映したいときは，列名記述ファイルに，CAST関数で反映先のDECIMAL属性での抽出を指定してください。

CAST関数の指定形式を次に示します。

形式

ＣＡＳＴ（列名　ＡＳ　データ型）

(2)　表式記述ファイル

表式記述ファイルには，SELECT文の次の句を指定します。

WHERE句

ORDER BY句

HiRDB Dataextractorでは，列名記述ファイルの指定値を用いてSELECT文を組み立て，SQL Serverからデータを抽出します。

select 列名記述ファイルの指定値 FROM 抽出表名 表式記述ファイルの指定値

−wオプションを省略した場合，条件は使用しません。

SELECT文でのWHERE句，およびORDER　BY句の指定方法については，SQL Serverマニュアルを参照してください。

注意事項

表式の指定値にスペース，ハイフン（−）を含むときは，引用符（"）で囲みます。

表式の指定値の英小文字と英大文字とを区別したい場合は，引用符（"）で囲みます。引用符（"）で囲まない場合は，すべて英大文字として扱われます。

表式記述ファイルで指定できるデータ型の組み合わせについては，「表3-12　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（1/2）」，「表3-13　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（2/2）」を参照してください。

ORDER BY句を指定する場合，抽出時に属性，文字コード変換をすると，反映側システム上での並び順と異なることがあるため注意してください。

SQL Server抽出時に排他制御をする場合，表式記述ファイルにWITH句を記述する必要があります。WITH句の詳細については，SQL Serverマニュアルを参照してください。

(3)　反映情報ファイル

反映情報ファイルには，データ型を変換する列情報とデータ型を指定します。

反映情報ファイルは，次のときに指定します。

抽出データをファイルにだけ格納する場合

指定したデータ型でデータを抽出します。反映情報ファイルを省略（−Lオプション省略）した場合の列，およびデータ型を指定しない列に対する仮定値を，「表6-5　省略時に仮定するデータ型」に示します。

次のデータ型をHiRDBのBLOB，BINARY型で抽出し，反映またはファイルに格納する場合

binary

varbinary

列単位に最大データ長を指定します。これによって，指定された長さのバッファを使用するためにバッファを節約できます。反映情報ファイルを省略（−Lオプション省略），またはデータ型を指定しない列に対するバッファサイズは環境変数XTLOBBUFSIZEに従います。

形式

ＦＯＲＭＡＴ
　｛ＦＩＥＬＤ＿ＮＵＭ　フィールド番号｜ＦＩＥＬＤ＿ＮＡＭＥ　列名｝ＡＴＴＲ　データ型
　　　　〔｛ＦＩＥＬＤ＿ＮＵＭ　フィールド番号｜ＦＩＥＬＤ＿ＮＡＭＥ｝ＡＴＴＲ　データ型〕…

説明

●ＦＯＲＭＡＴ

データ型を変換することを示します。

●ＦＩＥＬＤ＿ＮＵＭ

データ型変換の対象とする抽出列の先頭からの通番を指定します。

−sオプション指定なしの場合

抽出表の定義上の先頭からの通番

−sオプション指定ありの場合

列名記述ファイルに指定した列名の先頭からの通番

指定値範囲は1〜99,999です。また，フィールド番号は重複して指定できません。

●ＦＩＥＬＤ＿ＮＡＭＥ

データ型変換の対象とする抽出列名を指定します。

−sオプション指定時は指定できないので，FIELD_NUMを指定してください。

列名は重複して指定できません。

●ＡＴＴＲ

データ型を指定します。

指定可能なデータ型を「表6-6　ATTRに指定できるデータ型」に示します。

注意事項

1行に一つの列について記述してください。複数列分記述したい場合は，複数行記述してください。

注釈は，"＃"以降その行の終わりまでとします。

列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲みます。

列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲みます。

引用符（"）で囲まない場合は，すべて英大文字として扱われます。

表6‒5　省略時に仮定するデータ型

SQL Serverのデータ型

けた数

仮定するデータ型

char(n)

−

CHAR(n)

nchar(n)

−

NCHAR(n)

varchar(n)

−

VARCHAR(n)

nvarchar(n)

−

NVARCHAR(n)

bigint

−

FLT

int

−

INT

smallint

−

SINT

tinyint

−

SINT

bit

−

CHAR(1)

decimal(p,s)

numeric(p,s)

0＜p≦29かつ0≦s≦p

DEC(p,s)

29＜p≦38かつ0≦s≦p

FLT

money

−

DEC(19,4)

smallmoney

−

DEC(10,4)

float(f)

1≦f≦24

SFLT

25≦f≦53

FLT

real

−

SFLT

datetime

−

DATE※

smalldatetime

−

DATE※

binary(n)

−

BINARY(n)

varbinary(n)

−

BINARY(n)

sql_variant

−

VARCHAR(8000)

ユーザ定義型の場合は，データベース型マッピングに従います。

（凡例）

−：特に指定はありません。

注※

日付情報だけ取り出します。

表6‒6　ATTRに指定できるデータ型

指定できるデータ型※1

対応するHiRDBのデータ型

ファイル作成

HiRDB反映

INT

INTEGER

○

△

SINT

SMALLINT

○

△

DEC(m,n)※2

DECIMAL(m,n)

○

△

FLT

FLOAT

○

△

SFLT

SMALLFLT

○

△

CHAR(n)※3※10

CHAR(n)

○

△

VARCHAR(n)※3※10

VARCHAR(n)

○

△

MCHAR(n)※3

MCHAR(n)

○

△

MVARCHAR(n)※3

MVARCHAR(n)

○

△

NCHAR(n)※4

NCHAR(n)

○

△

NVARCHAR(n)※4

NVARCHAR(n)

○

△

DATE

DATE

○

△

TIME

TIME

○

△

YEAR

INTERVAL YEAR TO DAY

○

△

HOUR

INTERVAL HOUR TO SECOND

○

△

BLOB(n〔{K｜M｜G}〕)※5

BLOB(n〔{K｜M｜G}〕)

○※6

○※7

SGMLTEXT(n〔{K｜M｜G}〕)※5

SGMLTEXT

×

×

XML(n〔{K｜M｜G}〕)※5

XML

×

×

FREEWORD(n)※3

FREEWORD

×

×

BINARY(n)※8

BINARY(n)

○※6

○※7

TIMESTAMP(n)※9

TIMESTAMP(n)

○

△

(凡例)

○：指定できます。

△：指定できません（指定を無視し，反映側のデータ型を仮定します）。

×：指定できません（エラーになります）。

注※1

SQL Serverのデータ型と指定できるデータ型の組み合わせについては「表3-12　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（1/2）」，「表3-13　HiRDB Dataextractorで変換できるデータ型（SQL Serverの場合）（2/2）」を参照してください。

注※2

mおよびnは，1≦m≦38，0≦n≦38，m≧nです。

注※3

nは，バイト数を符号なし整数を指定します。指定値範囲は1≦n≦32,767です。

注※4

nは，文字数を符号なし整数を指定します。指定値範囲は1≦n≦16,383です。

注※5

この指定値長は，環境変数XTLOBBUFSIZEと同等の意味があり，環境変数XTLOBBUFSIZEの指定値よりも優先されます。また，指定値の指定範囲と実際の最大長を次に示します。

単位

nの指定範囲

実際のサイズ（バイト）

なし

1≦n≦2,147,483,647

同左

K

1≦n≦2,097,152

n×1,024

M

1≦n≦2,048

n×1,048,576

G

1≦n≦2

n×1,073,741,824

ただし，実際の最大長の計算結果が2,147,483,648の場合は，2,147,483,647になります。

注※6

環境変数XTLOBBUFSIZEを省略した場合は必ず指定します。指定がない場合，バッファが確保できずにエラー終了することがあります。

注※7

指定した長さが反映側のBLOBデータ型の定義長よりも長い場合，この指定は無効とし，定義長を仮定します。

注※8

nは，バイト数を符号なし整数で指定します。指定値範囲は，1≦n≦2,147,483,647です。

注※9

nは，0，2，4，6のどれかになります。

注※10

文字集合列，またはNCHAR属性の文字データをUTF-16で抽出する場合，サイズの変更はできません。

(4)　ナル値情報ファイル

ナル値情報ファイルは，次のときに指定します。

ナル値の既定値を変更するとき

反映対象の列にナル値を格納する場合に，ナル値とみなす値を変更したいときに指定します。抽出したデータと，ここでの指定で設定した値が同じ場合に，表の列にナル値が格納されます。

また，ファイル作成の場合には，抽出データのナル値をどのような既定値としてファイルに格納するかを指定します。

ナル値情報ファイルを省略（−vオプション省略）した場合のナル値，およびここでの指定によって設定されるナル値の既定値については，「表4-11　ナル値の既定値」を参照してください。

形式

｛列名｜フィールド番号＝ＮＵＭ｝
　｛〔＝｛ＨＩＧＨ｜ＬＯＷ｜ＺＥＲＯ｜ＳＰＡＣＥ｜（’定数値’）｜
　　　　　（X’１６進定数値’）｝〕｜
　　〔，｛ＮＯＣＯＤＥＣＯＮＶ｜ＣＯＤＥＣＯＮＶ｝〕｝

説明

●列名

ナル値の既定値を変更する列を指定します。

HiRDBの表に反映する場合

反映側の表の列名で指定してください。

ファイルだけを作成する場合

抽出側の表の列名で指定してください。

−sオプション指定時は指定できません。

●フィールド番号＝ＮＵＭ

ナル値の既定値を変更する列の先頭からの通番を指定します。

指定値範囲は1〜99999

フィールド番号は重複して指定できません。

HiRDBの表に反映する場合

反映表の定義上の先頭からの通番。

ファイルだけを作成する場合

−sオプション指定なしの場合

抽出表の定義上の先頭からの通番。

−sオプション指定ありの場合

列名記述ファイルに指定した列名の先頭からの通番。

●｛ＨＩＧＨ｜ＬＯＷ｜ＺＥＲＯ｜ＳＰＡＣＥ｜（’定数値’）｜（X’１６進定数値’）｝

ナル値の既定値を指定します。

ここでの指定によって設定される値については，「表4-11　ナル値の既定値」を参照してください。

●｛ＮＯＣＯＤＥＣＯＮＶ｜ＣＯＤＥＣＯＮＶ｝

列単位にコード変換の有無を指定します。

ＮＯＣＯＤＥＣＯＮＶ：文字コード変換機能を使わない場合に指定します。この指定値は，環境変数XTLOCALEを指定してコード変換を行う場合だけ有効となります。

ＣＯＤＥＣＯＮＶ：文字コード変換機能を使う場合に指定します。この指定値は，環境変数XTLOCALEを指定してコード変換を行う場合だけ有効となります。

注意事項

NCHAR属性列で，かつ環境変数XTSQLNCSETにutf-16を指定した場合，文字コード変換対象となりません。NCHAR属性列を文字コード変換対象にするためには，次の条件をすべて満たす必要があります。

すべての文字列がNCHAR属性である。

すべての文字列にCODECONVを指定する。

抽出側の環境変数XTDATALOCALEにutf-16LEを指定する。

記述規則

1行に一つの列について記述します。複数列分記述したい場合は，複数行記述してください。

注釈は，"＃"以降その行の終わりまでとします。

列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲んでください。

列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲んでください。

引用符（"）で囲まない場合は，すべて英大文字として扱われます。

定数値を指定する場合は，255バイト以下で指定してください。

定数値中に「’）」は指定しないでください（アポストロフィ「’」と右括弧「）」は連続して指定しないでください）。

HiRDBの表へ反映する場合，反映側の列が非NULL属性のときは，ナル既定値がそのままデータとして格納されます。

ファイルの作成時，抽出側の列が非NULL属性のときは，指定を無視します。

記述例

CLM01=HIGH                        #INT
CLM02=LOW                         #DATE
CLM03=('FFFF')                    #CHAR(4)
4=NUM=SPACE                       #CHAR(4)

環境変数XTNLDFLTの指定によって，ナル値情報ファイルの指定規則が異なります。環境変数XTNLDFLTの指定によるナル値情報ファイルの指定規則を次の表に示します。

表6‒7　ナル値情報ファイルの指定規則（SQL Serverからのデータ抽出の場合）

ナル値情報ファイル

指定内容

環境変数XTNLDFLTの指定値

0または１

2

HiRDB反映

ファイル作成

HiRDB反映

ファイル作成

バイナリ

形式

DAT形式

バイナリ

形式

DAT形式

列名｜フィールド番号=NUM

◎

◎

◎

◎

◎

◎

ナル値の既定値

○

○

○

×

×

×

NOCODECONV｜CODECONV

○

○

○

○

○

○

（凡例）

◎：必ず指定してください。

○：指定できます。

×：指定できません。

6.2　出力リストの形式

出力リスト形式については「4.3　出力リストの形式」を参照してください。

6.3　実行例

6.3.1　実行例の詳細

HiRDB Dataextractorの実行例について説明します。

実行例のシステム構成を次の図に示します。

図6‒1　実行例のシステム構成（SQL Serverからのデータ抽出時）

(1)　実行例の環境

(a)　データの抽出側（HOST1）の環境

表の定義

表名

列名，および属性

TSQL01

C01 CHAR(10),C02 NUMERIC(10,8),C03 DATETIME

TSQL02

C01 CHAR(10),C02 NUMERIC(10,8),C03 INT

環境変数の設定

（C:¥win32app¥Hitachi¥hirdbxt¥conf¥hirdbxtc.ini）

[xtrepS00]
XTHOST=HOST2
XTPORTNO=20052
XTSQLDSN=MQIS
XTSQLUSER="user01"/"user01"

Windowsのシステムディレクトリ ¥drivers¥etc¥hostsでの反映先ホストの設定

        :
        :
160.16.150.120  HOST2
160.16.150.121  HOST3
        :
        :

(b)　データの反映側（HOST2）の環境

表の定義

・スキーマ名user01の表の定義

CREATE TABLE T01(C01 CHAR(10),C02 DEC(10,8),C03 DATE,C04 TIME)
CREATE TABLE T02(C01 CHAR(10),C02 DEC(10,8),C03 INT, C04 INT)

・スキーマ名user02の表の定義

CREATE FIX TABLE T03(C01 CHAR(10),C02 DEC(10,8),C03 TIME)

環境変数情報設定ファイルでの環境変数の設定

・サービス名hirdbxt1，ポート番号20052の環境変数情報設定ファイル

（C:¥win32app¥Hitachi¥hirdbxt¥conf¥hirdbxt.ini）

[hirdbxt1]
PDCONFPATH=d:¥HiRDB2¥conf
PDDIR=d:¥HiRDB2
PDUXPLDIR=d:¥HiRDB2¥UXPLDIR
PDUSER="user01"/"user01"

・サービス名hirdbxt2，ポート番号50000の環境変数情報設定ファイル

（C:¥win32app¥Hitachi¥hirdbxt¥conf¥hirdbxt.ini）

[hirdbxt2]
PDCONFPATH=d:¥HiRDB2¥conf
PDDIR=d:¥HiRDB2
PDUXPLDIR=d:¥HiRDB2¥UXPLDIR
PDUSER="user02"/"user02"

Windowsのシステムディレクトリ ¥drivers¥etc¥servicesでのポートの定義

                      :
                      :
hirdbxt1 20052/tcp    # HiRDB Dataextractor
hirdbxt2 50000/tcp    # HiRDB Dataextractor
                      :
                      :

(c)　ファイル作成側（HOST3）の環境

環境変数情報設定ファイルでの環境変数の設定

サービス名hirdbxt，ポート番号20052の環境変数情報設定ファイル

（C:¥win32app¥Hitachi¥hirdbxt¥conf¥hirdbxt.ini）

[hirdbxt]
XTTMPDIR=e:¥work¥data

Windowsのシステムディレクトリ ¥drivers¥etc¥servicesでのポートの定義

                     :
                     :
hirdbxt 20052/tcp    # HiRDB Dataextractor
                     :
                     :

(2)　指定するコマンドとオプション

データの抽出側で，xtrepSコマンドを指定します。

(a)　例1

HOST1の表TSQL01をHOST2の表T01に複写します。

指定するオプションは次のとおりです。

反映側のHiRDB Dataextractorが使用するポート番号は20052に設定します。

既存のデータは削除しないで，データを追加します。

更新前ログを取得します。

一括出力ページ数は10ページに設定します。

経過メッセージを1万行単位で出力します。

抽出対象の表に排他制御をします。

ナル値の既定値は変更しません。

コマンド指定例

xtrepS -r T01 -s C:¥win32app¥Hitachi¥hirdbxt¥conf¥clm -o TSQL01

C:¥win32app¥Hitachi¥hirdbxt¥conf¥clmの内容

C01,C02,C03,C03

(b)　例2

HOST1の表TSQL02をHOST2の表T02に複写します。

指定するオプションは次のとおりです。

反映側のHiRDB Dataextractorが使用するポート番号は20052に設定します。

既存のデータを削除してデータを追加します。

ログを取得しません。

一括出力ページ数は255ページに設定します。

経過メッセージを10万行単位で出力します。

抽出対象の表の排他制御はしません。

列C01の値が’0000010000’以下の行を抽出し，列C04には定数0を設定します。

列C01のナル値既定値を’FFFFFFFFFF’にします。

コマンド指定例

xtrepS -r T02 -d -l n -n 255 -m 100 -s C:¥win32app¥Hitachi¥hirdbxt¥conf¥clm
-v C:¥win32app¥Hitachi¥hirdbxt¥conf¥null -w C:¥win32app¥Hitachi¥hirdbxt¥conf¥whe.txt -o TSQL02

C:¥win32app¥Hitachi¥hirdbxt¥conf¥clmの内容

C01,C02,C03,0

C:¥win32app¥Hitachi¥hirdbxt¥conf¥nullの内容

1=NUM=('FFFFFFFFFF')

C:¥win32app¥Hitachi¥hirdbxt¥conf¥whe.txtの内容

WHERE C01<='0000010000'

(c)　例3

HOST1の表TSQL01をHOST2の表T03に複写します。

指定するオプションは次のとおりです。

HiRDB Dataextractorが使用するポート番号は50000に設定します。

既存のデータは削除します。

更新前ログを取得します。

一括出力ページ数は40ページに設定します。

実行結果をc:¥tmp¥xtrep_logに取得します。

経過メッセージを1万行単位で出力します。

抽出対象の表に任意の排他制御をします。

ナル値の既定値は変更しません。

コマンド指定例

xtrepS -d -r T03 -n 40 -p 50000 -e c:¥tmp¥xtrep_log -w C:¥win32app¥Hitachi¥hirdbxt¥conf¥whe.txt -o TSQL01

C:¥win32app¥Hitachi¥hirdbxt¥conf¥whe.txtの内容

WITH (TABLOCKX)

(d)　例4

HOST1の表TSQL01をHOST3のファイルに出力します。

指定するオプションは次のとおりです。

DAT形式のファイルを作成します。

出力ファイル名は，e:¥work¥data¥TSQL01にします。

全列に対して，変換するデータ型は指定しません。

コマンド指定例

xtrepS -R dat -o TSQL01 -h HOST3 -s C:¥win32app¥Hitachi¥hirdbxt¥conf¥clm TSQL01

C:¥win32app¥Hitachi¥hirdbxt¥conf¥clmの内容

C01,C02,C03

(e)　例5

HOST1の表TSQL01をHOST3のファイルに出力します。

指定するオプションは次のとおりです。

バイナリ形式のファイルを作成します。

出力ファイル名は，e:¥work¥data¥TSQL01_BINにします。

抽出表の列C01はMCHAR(20)属性に変換します。

抽出表の列C03はTIME属性に変換します。

経過メッセージを5万行単位で出力します。

列C01の値が’0000010000’以下の行を抽出します。

コマンド指定例

xtrepS -R -o TSQL01_BIN -h HOST3 -m 50 -s C:¥win32app¥Hitachi¥hirdbxt¥conf¥clm
-w C:¥win32app¥Hitachi¥hirdbxt¥conf¥whe.txt -L C:¥win32app¥Hitachi¥hirdbxt¥conf¥cnv TSQL01

C:¥win32app¥Hitachi¥hirdbxt¥conf¥clmの内容

C01,C02,C03

C:¥win32app¥Hitachi¥hirdbxt¥conf¥whe.txtの内容

WHERE C01<='0000010000'

C:¥win32app¥Hitachi¥hirdbxt¥conf¥cnvの内容

FORMAT FIELD_NUM 1 ATTR MCHAR(20)
       FIELD_NUM 3 ATTR TIME

7　運用

HiRDB Dataextractorの開始と終了について説明します。

7.1　運用手順

HiRDB Dataextractorの運用手順について説明します。

7.1.1　HiRDB間のデータの抽出および反映

HiRDBからデータを抽出してHiRDBヘ反映する場合，データの抽出・反映方法は抽出側のHiRDB Dataextractorにxtrepコマンドで指定します。

抽出側でxtrepコマンドを実行すると，HiRDB Dataextractorが起動して抽出処理を開始し，データが抽出されて反映側ヘ送信されます。反映側では，データを受信すると自動的にHiRDB Dataextractorを起動し，HiRDB Dataextractorは反映処理を開始します。

7.1.2　ORACLE，またはSQL Serverから抽出したデータのHiRDBへの反映

ORACLE，またはSQL Serverからデータを抽出してHiRDBへ反映する場合，データの抽出・反映方法は抽出側のHiRDB DataextractorにxtrepO，またはxtrepSコマンドで指定します。

抽出側でxtrepO，またはxtrepSコマンドを実行すると，HiRDB Dataextractorが起動して抽出処理を開始し，データが抽出されて反映側へ送信されます。反映側では，データを受信すると自動的にHiRDBDataextractorを起動し，HiRDB Dataextractorは反映処理を開始します。

7.1.3　メインフレーム側のDBとHiRDB，ORACLEとのデータの抽出および反映

メインフレーム側のDBからデータを抽出してHiRDBヘ反映する場合，およびHiRDB，またはORACLEからデータを抽出してXDM/RDヘ反映する場合，データの抽出・反映方法はVOS3側のXDM/XTに指定します。XDM/XTでの指定方法については，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

メインフレーム側のDBからデータを抽出してHiRDBヘ反映する場合，反映側では，XDM/XTから送信されたデータを受信すると指定に従ってHiRDB Dataextractorが起動され，HiRDB Dataextractorは反映処理を開始します。

HiRDB，ORACLEからデータを抽出してXDM/RDヘ反映する場合，抽出側では，XDM/XTからの制御によって指定に従ってHiRDB Dataextractorが起動されて抽出処理を開始し，データを抽出してXDM/XTへ送信します。XDM/XTは受信したデータを抽出データセットに出力し，この抽出データセットからXDM/RDヘ反映します。

7.1.4　抽出したデータでのファイル作成

HiRDB，ORACLE，またはSQL Serverからデータを抽出してファイルを作成する場合，データの抽出およびファイルの作成方法は，抽出側のHiRDB Dataextractorにxtrepコマンド，xtrepOコマンド，またはxtrepSコマンドで指定します。

抽出側でxtrepコマンド，xtrepOコマンド，またはxtrepSコマンドを実行すると，HiRDB Dataextractorが起動して抽出処理を開始し，データが抽出されてファイル作成側ヘ送信されます。ファイル作成側では，データを受信すると自動的にHiRDB Dataextractorが起動され，HiRDB Dataextractorはファイルの作成処理を開始します。

メインフレーム側のDBからデータを抽出してファイルを作成する場合，データの抽出およびファイルの作成方法は，VOS3側のXDM/XTに指定します。XDM/XTでの指定方法については，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

メインフレーム側のDBからデータを抽出してファイルを作成する場合，ファイルの作成側システムでは，XDM/XTから送信されたデータを受信すると指定に従ってHiRDB Dataextractorが起動され，HiRDB Dataextractorはファイルの作成処理を開始します。

7.1.5　注意事項

次のディレクトリ下には，HiRDB Dataextractorが稼働中に動的に作成するファイルがあります。これらのファイルは，定期的に削除してください。なお，ファイルの削除は，HiRDB Dataextractorの停止中にしてください。

/opt/HIRDBXT/spool/

/opt/HIRDBXT/dump/

7.2　HiRDB Dataextractorの開始と終了

HiRDB Dataextractorの開始・終了方法は使用するプロトコルによって異なります。ここでは，HiRDB Dataextractorの開始と終了について，プロトコルごとに説明します。

7.2.1　TCP/IP使用時のHiRDB Dataextractorの開始と終了

TCP/IP使用時のHiRDB Dataextractorの開始と終了は，データ抽出側の場合と，データ反映側およびファイル作成側の場合とで異なります。

(1)　データ抽出側のHiRDB Dataextractorの開始と終了

HiRDB，ORACLE，またはSQL Serverからデータを抽出する場合は，抽出側のHiRDB Dataextractorはxtrepコマンド，xtrepOコマンド，またはxtrepSコマンドの実行によって起動され，開始します。反映処理またはファイル作成処理が完了すると，終了します。

HiRDB，またはORACLEからデータを抽出して，XDM/RDへ反映する場合および順編成データセットを作成する場合は，抽出側のHiRDB DataextractorはXDM/XTからの制御によって，/etc/inetd.confでの指定に従ってOSのinetdによって起動されて開始します。反映処理または順編成データセットの作成が完了すると，終了します。

(2)　データ反映側，およびファイル作成側のHiRDB Dataextractorの開始と終了

データ反映側およびファイル作成側のHiRDB Dataextractorは，抽出したデータが抽出側から送信されてくると，/etc/inetd.confでの指定に従ってOSのinetdによって起動されて開始します。処理が完了すると，自動的に終了します。

/etc/inetd.confでの設定方法については，「2.2.4　HiRDB Dataextractorを使用するために設定するファイル」を参照してください。

7.2.2　OSI使用時のHiRDB Dataextractorの開始と終了

OSIプロトコルを使用した，メインフレーム側のDBとのデータ抽出，データ反映，およびファイル作成の場合のHiRDB Dataextractorの開始・終了について説明します。

OSIプロトコル使用時にHiRDB Dataextractorを起動するホストは，HiRDB Dataextractorで実行する機能によって異なります。OSIプロトコル使用時にHiRDB Dataextractorを起動するホストを，次の表に示します。

HiRDB Dataextractorは開始したユーザで起動されます。次の点に注意してください。

データを抽出してファイルを作成する場合，作成対象のファイル（LOB入力ファイルを含む）がすでに存在するときは，書き込み権限を持っている必要があります。なお，作成したファイルに対するファイルモードは，環境変数XTFPERMIT，XTDPERMITで指定できます。環境変数の設定方法については「2.2.3(2)環境変数の設定方法」を参照してください。

ORACLEからデータを抽出する場合，ORACLEに登録されているユーザである必要があります。

表7‒1　OSIプロトコル使用時にHiRDB Dataextractorを起動するホスト

HiRDB Dataextractorの種別

抽出側

反映側

ファイル作成側

起動するホスト

HiRDB/シングルサーバの場合

シングルサーバのあるホスト

HiRDB/シングルサーバの場合

シングルサーバのあるホスト

OSIプロトコルで接続されている，ファイルを

作成するホスト

HiRDB/パラレルサーバの場合

OSIプロトコルで接続されている，次のどれかのサーバのあるホスト

システムマネジャ

フロントエンドサーバ

バックエンドサーバ

ディクショナリサーバ

HiRDB/パラレルサーバの場合

OSIプロトコルで接続されている，データの転送先のサーバ（フロントエンドサーバまたはバックエンドサーバ）のあるホスト

システムマネジャのあるホスト※

注※

システムマネジャとXDM/XTとの間がOSIプロトコルによって接続されていない構成のときには，データの転送先のサーバとシステムマネジャとは，TCP/IPプロトコルで通信をします。このため，システムマネジャで稼働するHiRDB Dataextractorの開始と終了は，「7.2.1　TCP/IP使用時のHiRDB Dataextractorの開始と終了」に示す方法で実行します。

(1)　OSI使用時のHiRDB Dataextractorの開始

OSIプロトコル使用時の，HiRDB Dataextractorの開始方法には，自動開始と手動開始があります。

(a)　自動開始

自動開始をする場合は，/sbin/rcに，xtstartコマンドを実行するシェルを起動するためのスクリプトを登録しておきます。

自動開始のための環境設定手順

xtstartコマンドの実行シェルの作成

任意のディレクトリ下に，xtstartコマンドを実行するシェルを作成します。

rcから起動される起動スクリプトの作成

/sbin/init.d下に，「1.」で作成したシェルを実行する起動スクリプトを作成します。

起動スクリプトの登録

起動スクリプトは，実行レベルによって，「シーケンサー・ディレクトリ/sbin/rc*.d」（*（実行レベル）：0〜n）下に名称規則に従い登録します。シーケンサー・ディレクトリの内容は，/sbin/init.dの中にある起動スクリプトへのシンボリック・リンクから構成されていなければなりません。

指定するファイル名の規則については，rcのリファレンスを参照してください。

（例）

ln -s /sbin/init.d/XTS　 /sbin/rc2.d/S600XTS

注

＿（下線部分）は同一でなければなりません。

注意事項

3けたの番号はシーケンサー・ディレクトリ内のスクリプトを順序づけるための番号であるため，XNFの起動後に実行されるように設定してください。実行レベルについては，適用OSのマニュアルを参照してください。

xtstartコマンド実行シェルの作成例

#!/sbin/sh
#
# HiRDB Dataextractor Start
#
export XTTEMPNAM=0
/opt/HIRDBXT/bin/xtstart /HIRDBXT/user01/xtenv1 /HIRDBXT/user01/xtosi1

/sbin/init.d/XTSの作成例（xtstartコマンドの実行シェルのパス名が/HIRDBXT/user01/xtsの場合）

#!/sbin/sh
#
# HiRDB Dataextractor Start script
#

PATH=/usr/sbin:/usr/bin:/sbin
export PATH

rval=0

case $1 in
'start_msg')
  echo "Starting HiRDB Dataextractor"
  ;;

'stop_msg')
  echo "Stopping HiRDB Dataextractor"
  ;;

'start')
  for start_file in ls /HIRDBXT/user01/xts  ; do
    if [ -x ${start_file} ]  ; then
      ${start_file}
      if [ $? !=0 ]  ; then
        rval=1
        break
      fi
    fi
  done
  ;;
'stop')
  ;;

*)
  echo "usge: $0 {start|stop|start_msg|stop_msg}"
  rval=1
  ;;
esac

exit $rval

(b)　手動開始

次の場合は，手動でHiRDB Dataextractorを起動します。

/etc/localrcにHiRDB Dataextractorを自動開始をする情報を設定しない場合。

kill(1)でHiRDB Dataextractorを終了させたあと，電源を切らずに再度HiRDB Dataextractorを開始する場合。

HiRDB Dataextractorが異常終了したあと，再度HiRDB Dataextractorを開始する場合。

指定形式

/opt/HIRDBXT/bin/xtstart　環境変数情報設定ファイル名　通信構成定義情報ファイル名

(c)　注意事項

XDM/XTを起動する前に，HiRDB Dataextractorは起動されていなければなりません。

HiRDB Dataextractorを自動開始する場合は，XNFの起動後にHiRDB Dataextractorが自動開始されるように設定してください。

HiRDB Dataextractorを手動開始する場合は，スーパユーザからxtstartコマンドを実行してください。スーパユーザ以外で起動した場合，HiRDB Dataextractorに障害が発生したときにcoreダンプが出力されません。また，HiRDB DataextractorはXNFの起動後に開始してください。

(2)　OSI使用時のHiRDB Dataextractorの終了

HiRDB Dataextractorは，シグナルSIGTERMを受け取ると処理を終了します。

HiRDB Dataextractorだけを終了させたいときは，次の手順で行います。

ログファイルに出力されたメッセージから，HiRDB DataextractorのプロセスIDを取得します。

kill(1)でHiRDB DataextractorにSIGTERMを送ります。

8　障害時の運用

HiRDB Dataextractorの実行中に障害が発生した場合の処置について説明します。

8.1　HiRDB Dataextractor障害時の処置

ここでは，HiRDBからデータを抽出してHiRDBヘ反映する場合の障害発生時の運用について説明します。XDM/RDからデータを抽出してHiRDBヘ反映する場合の障害時の運用については，マニュアル「データベース抽出プログラム　XDM/XT」を参照してください。

HiRDB Dataextractor障害時の処置を，次の表に示します。

表8‒1　HiRDB Dataextractor障害時の処置

障害内容

HiRDB Dataextractorの処置

ユーザの処置

メモリ不足

メッセージ出力

コネクション断

エラーログファイルにメッセージ出力

プロセス終了

メモリ回復後，再実行してください。

内部矛盾

メッセージ出力

コネクション断

エラーログファイルにメッセージ出力

プロセス異常終了

保守員に連絡してください。

システムコールエラー

メッセージ出力

コネクション断

エラーログファイルにメッセージ出力

プロセス終了

エラーの要因を取り除いて，再実行してください。

回線障害または相手システムによるコネクション断

メッセージ出力

コネクション断

エラーログファイルにメッセージ出力

プロセス終了

ネットワーク障害の場合は，要因を取り除いて再実行してください。

ネットワーク障害以外の場合は，保守員に連絡してください。

HiRDBへのデータ反映時のアクセスエラー

メッセージ出力

コネクション断

エラーログファイルにメッセージ出力

プロセス終了

エラーの要因を取り除いて，再実行してください。

HiRDBからデータを抽出している場合のHiRDBヘのデータ反映エラーのときは，データの抽出側にJXU7010Eメッセージを出力します。このメッセージ出力時は，データ反映プロセスが作成したエラーログファイルに出力されたメッセージを基にエラーの原因を取り除いてください。

HiRDBからのデータ抽出時のアクセスエラー

HiRDBのメッセージ出力

コネクション断

エラーログファイルにメッセージ出力

プロセス終了

エラーの要因を取り除いて，再実行してください。

環境変数PDCLTPATHが指定されている場合は，HiRDBのSQLトレース情報がSQLトレースファイルに出力されますので，この情報を基にエラーの原因を取り除いてください。

ORACLEからのデータ抽出時のアクセスエラー

ORACLEのメッセージ出力

コネクション断

エラーログファイルにメッセージ出力

プロセス終了

SQL解析エラーの場合，列名記述ファイル，表式記述ファイル，または排他情報ファイルの指定値を見直しエラー原因を取り除いて，再実行してください。

SQL解析エラー以外の場合は，ORACLEのメッセージを基にエラーの原因を取り除いて，再度実行してください。

SQL Serverからのデータ抽出時のアクセスエラー

SQL Serverのメッセージ出力

コネクション断

エラーログファイルにメッセージ出力

プロセス終了

SQL解析エラーの場合，列名記述ファイル，および表式記述ファイルの指定値を見直しエラー原因を取り除いて，再実行してください。

SQL解析エラー以外の場合は，SQL Serverのメッセージを基にエラーの原因を取り除いて，再度実行してください。

HiRDB Dataextractor動作環境設定中エラー

メッセージ出力

コネクション断

エラーログファイルにメッセージ出力

プロセス終了

HiRDBの環境（変数など）を見直しエラーの原因を取り除いて，再実行してください。

HiRDB Dataextractor異常終了

OSによるcoreダンプ出力

プロセス異常終了

保守員に連絡してください。

9　メッセージ

HiRDB Dataextractorが出力するメッセージについて説明します。

9.1　メッセージの概要

HiRDB Dataextractorから出力されるメッセージの形式および見方について説明します。

HiRDB Dataextractorのメッセージの出力先を，次の表に示します。

表9‒1　HiRDB Dataextractorのメッセージの出力先

出力先

プロトコル

TCP/IP

OSI

抽出1

抽出2

反映・作成

抽出2

反映・作成

/opt/HIRDBXT/spool/xter…

○※1

○※2

○※2

−

−

/opt/HIRDBXT/spool/xtlog…

−

−

−

○※2

○※2

標準出力

○

−

−

−

−

メッセージログファイル※3

○

○

○

○

○

（凡例）

○：出力します。

−：出力しません。

抽出1：データ抽出機能を実行する場合（xtrepコマンドによるHiRDB間の抽出・反映機能）

抽出2：データ抽出機能を実行する場合（VOS3 XDM/XTと連携する場合）

反映・作成：データ反映機能，またはファイル作成機能を実行する場合

注※1

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

注※2

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

注※3

適用OSがHP-UXの場合，メッセージログファイルでは，各国文字データが正しく表示されません。このため，メッセージログファイルへ出力されるメッセージテキスト中の埋字（表識別子，列名など）に，各国文字データがある場合は，各国文字データが正しく表示されません。この場合，同一メッセージがエラーログファイルにも出力されているので，エラーログファイルで内容を確認してください。

9.1.1　メッセージの形式

メッセージは次の形式で出力されます。

ＪＸＵｎｎｎｎｓ　メッセージテキスト

ＪＸＵ：HiRDB Dataextractorのメッセージを示します。

ｎｎｎｎ：メッセージの番号を示します。

ｓ：メッセージの重要度を示します。

Ｅ：エラーメッセージ（機能が実行できない障害が発生したことを示します）

Ｉ：情報メッセージ（上記以外の単純な動作状況を示します）

メッセージテキスト：メッセージの内容を示します。

9.1.2　メッセージの見方

このマニュアルでの記述形式を次に示します。

JXUnnnns

英文メッセージテキスト

メッセージの説明

(Ｓ)：メッセージの出力後に，HiRDB Dataextractorがする処理を示します。

(Ｐ)：プログラマが取る処置を示します。

なお，メッセージテキスト中の英小文字には該当する値が設定されて，出力されます。

9.1.3　メッセージの出力先

各メッセージの出力先一覧を，次の表に示します。

表9‒2　メッセージ出力先一覧

メッセージ

番号

出力先

備考

コマンド入力側

連携・反映側

エラーログファイル

標準出力

メッセージ

ログファイル

エラーログ

ファイル

メッセージ

ログファイル

JXU7000E

○

○

○

○

○

−

JXU7001E

○

○

○

○

○

−

JXU7002E

○

○

○

○

○

−

JXU7003E

○

○

○

−

−

−

JXU7005I

○

○

○

○

○

−

JXU7006E

−

−

−

○

○

−

JXU7007I

○

○

○

○

○

連携・反映側ではxtstartコマンドの場合にだけ出力されます。

JXU7008I

−

−

−

○

○

−

JXU7009I

−

−

−

○

○

−

JXU7010E

○

○

○

−

−

−

JXU7011I

○

○

○

○

○

−

JXU7012I

−

−

−

○

○

−

JXU7013E

−

−

−

○

○

−

JXU7014I

−

−

−

○

○

−

JXU7017E

−

−

−

○

○

−

JXU7018I

−

−

−

○

○

−

JXU7019I

○

○

○

○

○

−

JXU7020E

○

○

○

○

○

−

JXU7021E

○

○

○

○

○

−

JXU7022E

−

−

−

○

○

−

JXU7023I

−

−

−

−

○

−

JXU7100E

○

○

○

○

○

−

JXU7101E

−

−

−

○

○

−

JXU7102E

○

○

○

○

○

−

JXU7103E

○

○

○

○

○

−

JXU7104E

−

−

−

○

○

OSIの場合にだけ出力されます。

JXU7106I

−

−

−

○

○

−

JXU7200E

○

○

○

○

○

−

JXU7201E

○

○

○

○

○

−

JXU7203E

−

−

−

○

○

−

JXU7204E

○

○

○

○

○

−

JXU7205E

○

○

○

○

○

−

JXU7206E

○

○

○

−

−

−

JXU7207E

○

○

○

−

−

−

JXU7208E

○

○

○

−

−

−

JXU7208I

○

○

○

−

−

−

JXU7209E

−

−

−

○

○

−

JXU7210I

○

○

○

−

−

−

JXU7211E

○

○

○

−

−

−

JXU7212E

○

○

○

−

−

−

JXU7213E

○

○

○

−

−

−

JXU7214E

○

○

○

○

○

−

JXU7215E

○

○

○

○

○

−

JXU7216E

○

○

○

○

○

−

JXU7217E

○

○

○

−

−

−

JXU7218E

○

○

○

−

−

−

JXU7219I

−

−

−

○

○

−

JXU7220E

○

○

○

−

−

−

JXU7221E

−

−

−

○

○

−

JXU7222E

−

−

−

○

○

−

JXU7223E

○

○

○

−

−

−

JXU7224E

−

−

−

○

○

−

JXU7230I

−

−

−

○

○

−

JXU7230E

−

−

−

○

○

−

JXU7300E

×

○

×

−

−

−

JXU7301E

○

○

○

−

−

−

JXU7302E

○

○

○

−

−

−

JXU7303E

○

○

○

−

−

−

JXU7305E

○

○

○

−

−

−

JXU7306E

○

○

○

−

−

−

JXU7307E

○

○

○

−

−

−

JXU7308E

○

○

○

−

−

−

JXU7309E

○

○

○

−

−

−

JXU7311E

○

○

○

−

−

−

JXU7312E

○

○

○

−

−

−

JXU7313E

○

○

○

−

−

−

JXU7314E

○

○

○

−

−

−

JXU7315E

○

○

○

−

−

−

JXU7316E

○

○

○

−

−

−

（凡例）

○：出力します。

×：出力しません。

−：該当しません。

コマンド入力側：xtrepコマンド，xtrepOコマンド，またはxtrepSコマンドを入力するホストを示します。

連携・反映側：次のホストを示します。

XDM/XTと連携するホスト

HiRDBがパラレルサーバの場合には，HiRDB DataextractorおよびHiRDBのデータベース初期作成ユティリティ（pdload）のメッセージがシステムマネジャ（MGR）に出力されることがあります。このため，障害発生時にはシステムマネジャ（MGR）も調査してください。

データ反映機能またはファイル作成機能を実行するホスト

9.2　メッセージの詳細

JXU7000E

ＩＮＳＵＦＦＩＣＩＥＮＴ　ＭＥＭＯＲＹ

メモリ不足が発生しました。

(Ｓ)：コネクション切断後，処理を終了します。

(Ｐ)：メモリ回復後，再度システムを実行してください。

JXU7001E

ＬＯＧＩＣＡＬ　ＥＲＲＯＲ　ＯＣＣＵＲＲＥＤ　ＣＯＤＥ＝Ｕａａａ，

ｂｂｂ［，ｃ…ｃ］

内部処理実行中に異常が発生しました。

aaa：保守コード

bbb：詳細コード

c…c：保守情報

(Ｓ)：コネクション切断後，処理を終了します。

(Ｐ)：保守員に連絡してください。

JXU7002E

ＳＹＳＴＥＭ　ＣＡＬＬ　ＥＲＲＯＲ，ＦＵＮＣ＝ａ…ａ，

ＥＲＲＣＯＤＥ＝ｂｂｂ　｛ＮＡＭＥ＝ｃ…ｃ｜ＳＩＺＥ＝ｄ…ｄ｜

［ｅ…ｅ］｝

a…aで示すシステムコールでエラーが発生しました。

a…a：エラーの発生したシステムコール

bbb：エラーコード

c…c：ファイル名称，またはサービス名

d…d：確保しようとした領域サイズ

e…e：保守情報

(Ｓ)：コネクション切断後，処理を終了します。

(Ｐ)：エラーコードの値と該当する関数の記載されたリファレンスマニュアルを参照してエラー要因を取り除き，再度実行してください。

FUNC=getservebynameの場合

servicesファイルのサービス名とHiRDB　Dataextractorの環境変数情報設定ファイル（hirdbxt.ini）のサービス名が一致しているかどうかを確認してください。

FUNC=connect，errno=239または10061の場合（反映側がWindows版の場合）

サービスが未起動でないか確認してください。

FUNC=LoadLibraryEx，errno=1114，NAME=%PDDIR%¥bin¥pdsingle.dllの場合（反映側がWindows版の場合）

反映側HiRDBがセットアップ識別子付きでインストールされている場合，hirdbxt.iniに次の環境変数が指定されているか確認してください。

・PDDIR

・PDCONFPATH

・PDUXPLDIR

FUNC=CodeCnvOpen，ERRCODE=-4の場合

バージョン07-03以前に作成された文字コード変換用マッピングテーブルを使用していた場合，文字コード変換用マッピングテーブルを再作成してください。

JXU7003E

ＲＯＷ　ＬＥＮＧＴＨ　ＥＸＣＥＥＤＳ　４２９４９６７２９５

1行の長さが4ギガバイトを超えたため，処理を続行することができません。

(Ｓ)：処理を終了します。

(Ｐ)：処理対象になる表の行長を見直し，再度実行してください。

処理対象になる表に，BLOB，BINARY，SGMLTEXT，またはXMLの列が含まれている場合は，環境変数XTLOBBUFSIZEが指定されているかどうかを見直し，再度実行してください。

JXU7005I

ＥＮＤ　ＯＦ　ａ…ａ　ＲＥＴＵＲＮ　ＣＯＤＥ　ＩＳ　ｂｂ

HiRDB　Dataextractorがリターンコードbbで処理を終了しました。

a…a：プログラム名

PXTCNTL：データ反映側のHiRDB　Dataextractor（TCP/IP）

PXTOSIL：データ反映側のHiRDB　Dataextractor（OSI）

xtrep：データ抽出側のHiRDB　Dataextractor（HiRDB抽出）

xtrepO：データ抽出側のHiRDB　Dataextractor（ORACLE抽出）

xtrepS：データ抽出側のHiRDB　Dataextractor（SQL Server抽出）

bb：リターンコード

0：正常終了しました。

4：次の事象が発生しましたが処理を続行しました。

オーバフローまたは切り捨ての可能性があります。

文字の切り捨ての可能性があります。

HiRDBのデータベース作成ユティリティでエラーが発生しました。

8：パラメタエラー

12：処理が続行できないエラーが発生しました。

16：プロセスが異常終了，または内部矛盾を検知しました。

(Ｓ)：処理を終了します。

(Ｐ)：次のどちらかの処置をしてください。

リターンコードが4のとき

JXU7208Iが出力されている場合はオーバフローまたは切り捨てが発生しています。切り捨てたデータを反映しない場合は，環境変数XTERRLEVELに1を指定して再度実行してください。

HiRDBのデータベース作成ユティリティでエラーが発生した場合は，反映側のエラーログファイルに出力されたメッセージを基にエラーを取り除き再度実行してください。

リターンコードが12のとき

エラーログファイルまたは標準出力に出力されたメッセージを基にエラーを取り除き再度実行してください。

リターンコードが16のとき

保守員に連絡してください。

JXU7006E

ａ…ａ　ＴＥＲＭＩＮＡＴＥＤ　ＢＹ　ＳＩＧＮＡＬ，　ＮＯ＝ｂ…ｂ

プログラムがシグナルにより中断しました。

a…a：プログラム名

PXTCNTL：HiRDB　Dataextractorの入口プログラム

PXTLOAD：PXTCNTLが起動するプログラム

PDLOAD：HiRDBデータベース作成ユティリティ

PXTMOCT：OSIデーモンプログラム

b…b：中断の原因となったシグナル番号

(Ｓ)：処理を終了します。

(Ｐ)：このメッセージ以外に出力されているメッセージがあれば原因を調査し，再度実行してください。

このメッセージ以外に出力されているメッセージがなければ保守員に連絡してください。

JXU7007I

ＨｉＲＤＢ　Ｄａｔａｅｘｔｒａｃｔｏｒ　ＳＹＳＴＥＭ　ＳＴＡＲＴＥＤ　

｛ＰＩＤ＝ａ…ａ｜ＳＹＳＬＯＧ＝ｂ…ｂ｝

HiRDB　Dataextractorを開始しました。

a…a：HiRDB　DataextractorのプロセスID

b…b：HiRDB　Dataextractorのエラーログファイル

(Ｓ)：処理を開始します。

JXU7008I

ＨｉＲＤＢ　Ｄａｔａｅｘｔｒａｃｔｏｒ　ＳＹＳＴＥＭ　

ＴＥＲＭＩＮＡＴＥＤ　ＰＩＤ＝ａ…ａ

HiRDB　Dataextractorを終了させました。

a…a：HiRDB　DataextractorのプロセスID

(Ｓ)：処理を終了します。

JXU7009I

ＨｉＲＤＢ　Ｄａｔａｅｘｔｒａｃｔｏｒ　ＬＯＡＤ　ＰＲＯＣＥＳＳ

ａ　ＳＴＡＲＴＥＤ　ＰＡＲＴＮＥＲ　ＪＯＢ　ＮＡＭＥ＝ｂ…ｂ

HiRDB　Dataextractorがデータ反映処理を開始しました。

a：次のどちらかを表示します。

M：制御プロセス

F：入力ファイル作成プロセス

b…b：該当するプロセスとコネクトしたXDM/XTのジョブ名

(Ｓ)：反映処理を開始します。

JXU7010E

ａ…ａ　ＥＲＲＯＲ　ＯＣＣＵＲＲＥＤ，ＣＯＤＥ＝ｂｂ

他プログラムでエラーが発生しました。

a…a：プログラム名

PXTCNTL：データの反映側のHiRDB　Dataextractor

SHELL　SCRIPT：ユーザ指定のシェルスクリプト

bb：エラーコード

a…aがPXTCNTLの場合

4：HiRDBデータベース作成ユティリティでエラーが発生しました。

12：HiRDB　Dataextractor，HiRDB，またはユーザ指定のシェルコマンドとのアクセス時，処理が続行できないエラーが発生しました。

16：HiRDB　Dataextractorが異常終了しました。

a…aがSHELL　SCRIPTの場合

ユーザ指定のシェルスクリプトが返却するexitのステータス

(Ｓ)：次のどれかの処理をします。

a…aがPXTCNTLの場合

エラーコードが4の場合

処理を続行します。

エラーコードが4以外の場合

処理を終了します。

a…aがSHELL　SCRIPTの場合

処理を終了します。

(Ｐ)：次のどれかの処置をしてください。

a…aがPXTCNTLの場合

エラーコードが4の場合

a…aで示されるプログラムの実行結果リストに問題がないか確認してください。

エラーコードが4以外の場合

a…aで示されるプログラムの実行結果リストを基にエラー要因を取り除き，再度ジョブを実行してください。

a…aがSHELL　SCRIPTの場合

ユーザ指定のシェルスクリプトの実行結果に問題がないか確認してください。

JXU7011I

ａ…ａ　ＲＯＷＳ　ＥＸＴＲＡＣＴ　［ＳＵＣＣＥＳＳＦＵＬＬＹ］

a…a行抽出しました。

a…a：抽出行数

SUCCESSFULLY：出力行数最終結果時を表します。

(Ｓ)：処理を続行します。

JXU7012I

｛ＦＩＬＥ｜ＤＩＲＥＣＴＯＲＹ｝ＣＲＥＡＴＥＤ　ＮＡＭＥ＝ａ…ａ　

［ＣＯＵＮＴ＝ｂ…ｂ］

ファイルまたはディレクトリの作成処理を終了しました。

a…a：ファイル名またはディレクトリ名

b…b：データ件数

(Ｓ)：処理を続行します。

JXU7013E

｛ＦＩＬＥ｜ＤＩＲＥＣＴＯＲＹ｝ＥＸＩＳＴ　ＮＡＭＥ＝ａ…ａ

指定されたファイルまたはディレクトリはすでに存在します。

a…a：ファイル名またはディレクトリ名

(Ｓ)：処理を終了します。

(Ｐ)：次のどちらかを行い，再度実行してください。

作成するファイル名またはディレクトリ名の指定を変更します。

ファイルの上書きをしてもよい指定に変更します。

JXU7014I

ＥＸＥＣ　ａ…ａ　ＩＳ　ｂ…ｂ

a…aを実行します。

a…a：実行した事象

pdload　ARG：pdloadを実行します。

SHELL　SCRIPT：シェルスクリプトを実行します。

b…b：次のどちらかを表示します。

a…aがpdload　ARGの場合

pdload実行時のオプション

a…aがSHELL　SCRIPTの場合

シェルスクリプトファイルの絶対パス名

(Ｓ)：a…aの終了を待ちます。

JXU7017E

ＴＨＩＳ　ＦＵＮＣＴＩＯＮ　ＩＳ　ＮＯＴ　ＳＵＰＰＯＲＴ，ＫＩＮＤ＝ａ…ａ　ｂ…ｂ

接続先とのバージョンの組み合わせでサポートされていない機能が実行されました。なお，このメッセージのあとに，保守情報がダンプ形式で出力されます。

接続先：XDM/XTまたはHiRDB　Dataextractor

a…a：保守情報

b…b：保守情報（ダンプ形式）

(Ｓ)：処理を終了します。

(Ｐ)：接続先とのバージョンの組み合わせでサポートされていない機能を実行していないか確認してください。該当しない場合は保守員に連絡してください。

JXU7018I

ＦＩＬＥ　ＣＲＥＡＴＥＤ　ＣＯＵＮＴ＝ａａ　ＳＵＣＣＥＳＳＦＵＬＬＹ

ファイルの作成処理が完了しました。

aa：データ件数

(Ｓ)：処理を続行します。

JXU7019I

ＩＮＶＡＬＩＤ　ＡＤＤＲＥＳＳ　ＭＯＤＥ，

ＨｉＲＤＢ　Ｄａｔａｅｘｔｒａｃｔｏｒ　ａ…ａ　ｂ…ｂ＝ｃ…ｃ

HiRDB　Dataextractorが，アドレッシングモードの異なるプログラムにアクセスしました。

a…a：HiRDB Dataextractorのアドレッシングモード

32bit：32ビットモード

64bit：64ビットモード

b…b：接続相手プログラム

HiRDB

c…c：接続相手プログラムのアドレッシングモード

32bit：32ビットモード

64bit：64ビットモード

(Ｓ)：処理を終了します。

(Ｐ)：接続する相手プログラムとのアドレッシングモードを合わせて，再度実行してください。

JXU7020E

ＭＯＤＵＬＥ　ＴＲＡＣＥ　ＦＩＬＥ　ＣＲＥＡＴＥＤ　ＮＡＭＥ＝ａ…ａ

モジュールトレースファイルを出力しました。

a…a：モジュールトレースファイル名

(Ｓ)：処理を終了します。

JXU7021E

ＮＯＴ　ＥＸＥＣ　ａ…ａ

処理が実行できませんでした。

a…a：実行しようとした処理名

MODULE　TRACE：モジュールトレース取得処理

(Ｓ)：処理を続行します。

JXU7022E

ＣＯＲＥ　ＦＩＬＥ　ＩＮ　ａ…ａ

coreファイル格納ディレクトリはa…aです。

a…a：coreファイル格納ディレクトリ名

(Ｓ)：処理を続行します。

JXU7023I

ＳＹＳＴＥＭ　ＣＡＬＬ　ＩＮＦＯＲＭＡＴＩＯＮ，ＦＵＮＣ=ａ…ａ，ＣＯＤＥ=ｂｂｂ　［ｃ…ｃ］

a…aで示すシステムコールの保守情報を出力します。

a…a：システムコール

bbb：終了コード

c…c：保守情報

(Ｓ)：処理を続行します。

(Ｐ)：次の情報が出力された場合は，Windowsのサービス（HiRDB Dataextractor）が正常に終了していますので対処は不要です。また，次の情報以外が出力された場合は，終了コードの値と該当する関数が記載されたWindows APIのリファレンスマニュアルを参照して要因を取り除き，Windowsのサービス（HiRDB Dataextractor）を再起動してください。

FUNC=WaitForSingleObject(),CODE=6

FUNC=SetServiceStatus(),CODE=6

FUNC=FreeLibrary(),CODE=126

JXU7100E

ＣＯＭＭＵＮＩＣＡＴＩＯＮ　ＥＲＲＯＲ　ＯＣＣＵＲＲＥＤ

ＣＯＤＥ＝（ａａａ，ｂｂｂｂ）［ＰＡＲＴＮＥＲ＝ｄ…ｄ］

［ＨＯＳＴＮＡＭＥ＝ｅ…ｅ］

相手システムとの間で通信障害が発生しました。

aaa：処理コード

2：setsockoptソケットライブラリ

6：受信処理中

7：送信処理中

bbbb：エラーコード

TCP/IPのとき：ソケットライブラリのerrno

OSIのとき：TLI関数のt_errno

d…d：JOBIDまたはプロセスID

XDM/XT時：JOBID

HiRDB　Dataextractor時：PXTCNTLのプロセスID

e…e：通信相手のホスト名称

相手システムがHiRDB　Dataextractor時にだけ出力します。

PARTNERとHOSTNAMEはOSIのときにだけ出力します。

(Ｓ)：コネクション切断後，処理を終了します。

(Ｐ)：エラー要因を取り除き，再度実行してください。

TCP/IPのとき

マニュアル「日立CSMA/CDネットワークCD105（TCP/IP）」によって，処理コードに該当するソケットライブラリの要因コードを参照してください。ネットワーク障害が考えられる場合は，障害要因を取り除いて再度実行してください。

上記以外の場合，保守員に連絡してください。

OSIのとき

PARTNERにプロセスIDが表示された場合

HOSTNAMEの示すホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

PARTNERにプロセスIDが表示されない場合

HiRDBのシステムマネジャの存在するホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

JXU7101E

ａ…ａ　ＣＡＮＮＯＴ　ＣＯＮＮＥＣＴ

［ＰＡＲＴＮＥＲ＝ｄ…ｄ］　［ＨＯＳＴＮＡＭＥ＝ｅ…ｅ］

相手システムとの接続に失敗しました。

a…a：ロード名称

PXTCNTL：TCP/IP使用時のロード名称

PXTOSIL：OSI使用時のロード名称

d…d：JOBIDまたはプロセスID

XDM/XT時：JOBID

HiRDB　Dataextractor時：PXTCNTLのプロセスID

e…e：通信相手のホスト名称

相手システムがHiRDB　Dataextractor時にだけ出力します。

PARTNERとHOSTNAMEはOSIのときにだけ出力します。

(Ｓ)：コネクション切断後，処理を終了します。

(Ｐ)：エラー要因を取り除き，再度実行してください。

TCP/IPのとき

ポート番号の設定が誤っていないかどうかを見直してください。

相手システムのHiRDB　Dataextractorとのバージョンの組み合わせを見直してください。

環境変数XTPCHKTIMEの指定値を見直してください。

OSIのとき

PARTNERにプロセスIDが表示された場合

HOSTNAMEの示すホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

PARTNERにプロセスIDが表示されない場合

HiRDBのシステムマネジャの存在するホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

環境変数XTPCHKTIMEの指定値を見直してください。

JXU7102E

ＣＯＮＮＥＣＴＩＯＮ　ＣＬＯＳＥＤ｛ＣＯＤＥ＝　（ａａａ，ｂｂｂｂ）

｜ＦＵＮＣ＝ｃ…ｃ　ＣＯＤＥ＝ｄ…ｄ｝［ＰＡＲＴＮＥＲ＝ｅ…ｅ］　

［ＨＯＳＴＮＡＭＥ＝ｆ…ｆ］

相手システムとのコネクションが障害によって切断されました。

aaa：処理コード（保守コード）

6：受信処理中

7：送信処理中

bbbb：エラーコード（保守コード）

TCP/IPのとき：ソケットライブラリのerrno

OSIのとき：TLI関数のt_errno

c…c：エラーの発生したTLI関数名（保守コード）

d…d：エラーコード（保守コード）

TLI関数のt_errno

e…e：JOBIDまたはプロセスID

XDM/XT時：JOBID

HiRDB　Dataextractor時：PXTCNTLのプロセスID

f…f：通信相手のホスト名称

相手システムがHiRDB　Dataextractor時にだけ出力します。

PARTNERとHOSTNAMEはOSIのときにだけ出力します。

(Ｓ)：処理を終了します。

(Ｐ)：XDM/XT側，またはHiRDB　Dataextractorで障害が発生したと考えられます。その障害を取り除き，再度実行してください。

PARTNERにプロセスIDが表示された場合

HOSTNAMEの示すホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

PARTNERにプロセスIDが表示されない場合

HiRDBのシステムマネジャの存在するホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

なお，ハードウェアやソフトウェアによるタイマ監視機能（ルータやファイアウォールによる自動切断など）で，HiRDB Dataextractor内部で行っているプロセス間通信が切断されたおそれがあります。監視時間の設定を見直してください。

JXU7103E

ＣＡＮＮＯＴ　ＣＯＮＮＥＣＴ　ＷＩＴＨ　ａ…ａ，（ｂ…ｂ）　

［ＰＡＲＴＮＥＲ＝ｃ…ｃ］

データ格納先ホスト上のHiRDB　Dataextractorとの接続に失敗しました。

a…a：データ格納先ホスト名称

b…b：データ格納先ホストのIPアドレス

xxx.xxx.xxx.xxxの形式（xxx：10進数）

c…c：JOBIDまたはプロセスID

XDM/XT時：JOBID

HiRDB　Dataextractor時：PXTCNTLのプロセスID

PARTNERはOSIのときにだけ出力します。

(Ｓ)：処理を終了します。

(Ｐ)：エラー要因を取り除き，再度実行してください。

TCP/IPのとき

ポート番号の設定が誤っていないか見直してください。

HiRDB Dataextractorの実行時にホスト名ではなくFQDNを指定した場合は，a…aではなくb…bで接続に失敗したホストを判断してください。

OSIのとき

PARTNERにプロセスIDが表示された場合

HOSTNAMEの示すホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

PARTNERにプロセスIDが表示されない場合

HiRDBのシステムマネジャの存在するホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

JXU7104E

ＣＯＭＭＵＮＩＣＡＴＩＯＮ　ＥＲＲＯＲ　ＯＣＣＵＲＥＤ，　

ＬＯＡＤＮＡＭＥ＝ａ…ａ　ＨＯＳＴＮＡＭＥ＝ｂ…ｂ

［ＰＡＲＴＮＥＲ＝ｃ…ｃ］

ほかのHiRDB　Dataextractorとの通信でエラーが発生しました。

a…a：通信を行っている相手側のHiRDB　Dataextractorのロード名称

b…b：a…aの存在するホスト名称

c…c：JOBIDまたはプロセスID

XDM/XT時：JOBID

HiRDB　Dataextractor時：PXTCNTLのプロセスID

PARTNERはOSIのときにだけ出力します。

(Ｓ)：処理を終了します。

(Ｐ)：このメッセージよりも先に出力されたメッセージ，および相手側のロードが出力したメッセージの指示に従ってください。

OSIのときで，PARTNERにプロセスIDが表示された場合

HOSTNAMEの示すホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

PARTNERにプロセスIDが表示されない場合

HiRDBのシステムマネジャの存在するホスト中のHiRDB　Dataextractorのエラーファイルの内容に従い対応してください。該当するエラーファイルは，このメッセージの先頭に表示されたプロセスIDが存在するファイルです。

JXU7106I

ＯＳＩ　ＣＯＭＭＵＮＩＣＡＴＩＯＮ　ＰＲＯＧＲＡＭ　ＩＳ　ＮＯＴ　ＡＣＴＩＶＥ

OSI通信に必要なプログラムが稼働していないため，再試行します。

(Ｓ)：処理を続行します。

(Ｐ)：OSI通信に必要なプログラム（XNF）を起動してください。

JXU7200E

ＥＲＲＯＲ　ＯＣＣＵＲＲＥＤ　ＤＵＲＩＮＧ　

ＤＡＴＡＢＡＳＥ　ＡＣＣＥＳＳ　ＳＴＡＴＵＳ＝ａａａ　

ＯＰＥＲＡＴＩＯＮ　ＣＯＤＥ＝ｂ…ｂ　［ｃ…ｃ］

HiRDB，ORACLE，またはSQL Serverアクセス時に，処理が続行できないエラーが発生しました。このメッセージに続いてHiRDB，ORACLE，またはSQL Serverのメッセージを出力する場合があります。

aaa：HiRDB　SQLCODEまたはORACLE，SQL Serverのエラーコード

b…b：オペレーションコード（内部情報）

c…c：HiRDB，ORACLE，またはSQL Serverのメッセージ

(Ｓ)：コネクション切断後，処理を終了します。

(Ｐ)：

HiRDBの場合

HiRDB　SQLCODE，またはHiRDBのメッセージを基にエラー要因を取り除き再度実行してください。HiRDB　SQLCODE，またはHiRDBのメッセージについては，マニュアル「HiRDB メッセージ」を参照してください。

ORACLEの場合

ORACLEのエラーコードまたはメッセージを基にエラー原因を取り除き再実行してください。SQL解析エラーの場合，列名記述ファイル，表式記述ファイル，または排他情報ファイルの指定値を見直してください。ORACLEのエラーコードまたはメッセージについてはORACLEのマニュアルを参照してください。

SQL Serverの場合

SQL Serverのエラーコードまたはメッセージを基にエラー原因を取り除き再実行してください。SQL解析エラーの場合，列名記述ファイル，表式記述ファイルの指定値を見直してください。SQL ServerのエラーコードまたはメッセージについてはSQL Serverのマニュアルを参照してください。

JXU7201E

ＥＲＲＯＲ　ＯＣＣＵＲＲＥＤ　ＤＵＲＩＮＧ　ＥＮＶＩＲＯＮＭＥＮＴ　

ＳＥＴ　ＦＵＮＣＴＩＯＮ＝ａ…ａ　［ＣＯＤＥ＝ｂｂｂ］

HiRDB　Dataextractorの動作環境設定中，処理が続行できないエラーが発生しました。

a…a：環境設定関数名（内部情報），環境変数名，またはセクション名

PDUSERの場合は，あらかじめユーザIDとパスワードを設定しておく必要があります。

bbb：環境設定関数の戻り値（内部情報）

(Ｓ)：コネクション切断後，処理を終了します。

(Ｐ)：HiRDB，およびHiRDB　Dataextractorの環境（変数）を見直して，再実行してください。または，HiRDBが起動されているか確認してください。

FUNCTION=SECTION　NUMBERの場合

HiRDB　Dataextractorの環境変数情報設定ファイル（hirdbxt.ini）内のセクション数がオーバしています。修正して再度実行してください。

FUNCTION=pdi_utl_sh_prologの場合

HiRDBを起動したあと，再度実行してください。

HiRDBが起動しているときは，「表2-7　HiRDB Dataextractorを使用するために必要な環境変数」のHiRDBの環境変数（PD〜）が正しく指定されているかを確認し，再度実行してください。

JXU7203E

ａ…ａ　ＩＳ　ＮＯＴ　ＤＥＦＩＮＥＤ　ＩＮ　ＥＮＶＩＲＯＮＭＥＮＴ　

ＦＩＬＥ

HiRDB　Dataextractorの環境変数情報設定ファイル中に誤った指定があります。

a…a：環境変数名

(Ｓ)：コネクション切断後，処理を終了します。

(Ｐ)：HiRDB　Dataextractorの環境変数，またはHiRDBの環境変数を見直して，再度実行してください。

JXU7204E

ＴＩＭＥＯＵＴ　ＯＣＣＵＲＲＥＤ　ＤＵＲＩＮＧ　ａ…ａ

処理実行中にタイムアウトが発生しました。

a…a：次のどれかを表示します。

INPUT　FILE　I/O：入力ファイルへの書き込み処理

RECEIVE　DATA：相手システムからのメッセージ受信処理

SEND　DATA：相手システムへのメッセージ送信処理

(Ｓ)：処理を終了します。

(Ｐ)：エラーログファイルまたはHiRDBデータベース作成ユティリティのエラーファイルのメッセージを基にエラーを取り除き再度実行してください。

処理種別がINPUT　FILE　I/Oの場合

格納表に排他が掛かっている場合

格納表に排他を掛けている処理の終了後，再度実行してください。

また，同一の表に同時に反映処理が実行されないように，ジョブスケジュールを見直してください。

排他が掛かっていない場合

入力ファイルの書き込み監視時間（環境変数XTWRTWTIME）を設定して，再度実行してください。すでに設定している場合は，設定値を大きくして，再度実行してください。

処理種別が，RECEIVE　DATAまたはSEND　DATAの場合

通信回線に問題がないか見直してください。通信回線の問題でなければ，通信関数の応答監視時間（環境変数XTTCPWTIME，またはXTOSIWTIME）の指定値を大きくして，再度実行してください。

JXU7205E

ＶＡＬＵＥ　ＯＦ　ａ…ａ　ＰＡＲＡＭＥＴＥＲ　ＩＳ　ＩＮＶＡＬＩＤ

パラメタ値が不正です。

a…a：パラメタ名称

(Ｓ)：処理を終了します。

(Ｐ)：エラー要因を取り除き，再度実行してください。

JXU7206E

ＳＰＥＣＩＦＩＥＤ　ＴＡＢＬＥ　ａ…ａ．ｂ…ｂ　ＩＳ　ＮＯＴ　

ＤＥＦＩＮＥＤ　ＩＮ　ｃ…ｃ　ＤＩＣＴＩＯＮＡＲＹ

指定した表a…a.b…bはディクショナリに定義されていません。

a…a：抽出側または反映側の認可識別子

b…b：抽出側または反映側の表識別子

c…c：データベース種別

(Ｓ)：処理を終了します。

(Ｐ)：表名を直すか，表を定義したあとに再度実行してください。

JXU7207E

ＳＰＥＣＩＦＩＥＤ　ＬＯＡＤ　ＣＯＬＵＭＮ　ＮＵＭＢＥＲ　ＩＳ　

ＮＯＴ　ＥＱＵＡＬ　ＥＸＴＲＡＣＴ　ＣＯＬＵＭＮ　ＮＵＭＢＥＲ　

ＩＮ　ＴＡＢＬＥ　ａ…ａ．ｂ…ｂ

反映する表の列数が抽出する表の列数と一致していません。

a…a：反映側の認可識別子

b…b：反映側の表識別子

(Ｓ)：処理を終了します。

(Ｐ)：表名を直すか，HiRDBの定義を修正したあとに再度実行してください。

JXU7208E

ＤＡＴＡ　ＣＯＮＶＥＲＴ　ＥＲＲＯＲ　ＣＯＤＥ＝ａａ　ＣＯＵＮＴ＝ｂｂ

データの切り捨て，またはオーバフローが発生しました。

aa：エラーコード

01：データの切り捨てが発生しました。

02：オーバフローが発生しました。

bb：エラー発生行数

(Ｓ)：処理を終了します。

(Ｐ)：反映側の列長を直すか，環境変数XTLOBBUFSIZEの値を大きくしたあとに再度実行してください。

JXU7208I

ＤＡＴＡ　ＣＯＮＶＥＲＴ　ＥＲＲＯＲ　ＣＯＤＥ＝ａａ

データの切り捨て，またはオーバフローが発生しました。

aa：エラーコード

01：文字の切り捨てが発生しました。

02：オーバフローが発生しました。

(Ｓ)：処理を続行します。

JXU7209E

ＥＲＲＯＲ　ＯＣＣＵＲＲＥＤ　ＤＵＲＩＮＧ　ＤＡＴＡ　ＰＵＴ　

ＣＯＤＥ＝ａａ　ＣＯＵＮＴ＝ｂ…ｂ　［ＳＩＺＥ＝ｃ…ｃ］

抽出データの書き込みに失敗しました。

aa：エラーコード

01：出力ファイルサイズが不正のため書き込むことができません。

02：出力するファイルがなくなったため書き込むことができません。

b…b：データ件数

c…c：1行のデータ長

(Ｓ)：処理を終了します。

(Ｐ)：次のどれかの処置をしてください。

エラーコードが01の場合

環境変数XTFILESIZEの値を大きくしたあと，再度実行してください。

エラーコードが02の場合

次のどれかの処置をして，再度実行してください。

環境変数XTFILESIZEの値を大きくする

出力ファイルを格納するディレクトリの空き容量を増やす

−oオプションにファイル名称を追加する

JXU7210I

ＤＩＦＦＥＲＥＮＣＥ　ＭＡＹ　ＢＥ　ＩＮＣＬＵＤＥ　ＩＮ　ａ…ａ．

ｂ…ｂ．ｃ…ｃ

データの切り捨て，オーバフロー，丸め誤差が発生する可能性があります。

a…a：抽出または反映側の認可識別子

b…b：抽出または反映側の表識別子

c…c：抽出，反映列名または列名記述領域（SQLCNDA）のSQLNAMECに設定される値（列名記述領域の詳細は，マニュアル「HiRDB SQLリファレンス」を参照してください）

(Ｓ)：処理を続行します。

JXU7211E

ＤＡＴＡ　ＴＹＰＥ　ＯＦ　｛ａ…ａ．ｂ…ｂ．ｃ…ｃ｜ＲＯＷ｜＃ｎ…ｎ｝　

ＣＡＮＮＯＴ　ＣＯＮＶＥＲＴ

データ属性が不正のため変換できません。

a…a：反映側の認可識別子

b…b：反映側の表識別子

c…c：反映側の列名

n…n：抽出フィールド通番

(Ｓ)：処理を終了します。

(Ｐ)：表名を修正するか，またはHiRDBの定義を修正したあとに再度実行してください。

列名記述ファイルにROWを指定し格納列に可変長データがあった場合，ROW指定を解除するか，反映側を固定長データで定義し直し，再度実行してください。

列名記述ファイルにROWを指定し反映情報ファイルを指定した場合，ROW指定を解除するか，反映情報ファイルを指定しないで再度実行してください。

文字集合列を抽出・反映する場合は，文字集合，属性，および長さを同じにして再度実行してください。

JXU7212E

ＤＡＴＡ　ＬＥＮＧＴＨ　ＯＦ　｛ａ…ａ．ｂ…ｂ．ｃ…ｃ｜ＲＯＷ｝　

ＣＡＮＮＯＴ　ＣＯＮＶＥＲＴ

データ長，精度，尺度が不正のため変換できません。

a…a：抽出側または反映側の認可識別子

b…b：抽出側または反映側の表識別子

c…c：抽出側または反映側の列名

ROW：列名記述ファイルにROWを指定し，抽出側と反映側の列合計長が不一致の場合

(Ｓ)：処理を終了します。

(Ｐ)：表名を修正するか，またはHiRDBの定義を修正したあとに再度実行してください。

文字集合列を抽出・反映する場合は，文字集合，属性，および長さを同じにして再度実行してください。

環境変数XTDATALOCALEにutf-16BE，またはutf-16LEを指定して抽出・反映する場合は，列の長さを偶数バイトにして再度実行してください。

JXU7213E

ＳＰＥＣＩＦＩＥＤ　ＲＤＡＲＥＡ　ａ…ａ　ＩＳ　ＩＮＶＡＬＩＤ　ＢＥＣＡＵＳＥ

ＴＡＢＬＥ　ｂ…ｂ．ｃ…ｃ　ＩＳ　ＮＯＴ　ＦＯＵＮＤ　ＩＮ　ＲＤＡＲＥＡ

指定したRDエリアa…aは，表が格納されているＲＤエリアではありません。

a…a：反映側のRDエリア名

b…b：反映側の認可識別子

c…c：反映側の表識別子

(Ｓ)：処理を終了します。

(Ｐ)：表名またはRDエリア名を修正するか，あるいはHiRDBへ定義したあとに再度実行してください。

JXU7214E

ＰＡＲＴＩＴＩＯＮＩＮＧ　ＯＦ　ＳＰＥＣＩＦＩＥＤ　ＴＡＢＬＥ　ａ…ａ．ｂ…ｂ　ＩＳ

ＮＯＴ　ＳＵＰＰＯＲＴＥＤ

指定した表の分割方法はサポート対象外です。

a…a：反映側の認可識別子

b…b：反映側の表識別子

(Ｓ)：処理を終了します。

(Ｐ)：表名を修正し，再度実行してください。

JXU7215E

ＤＡＴＡ　ＴＹＰＥ　ＯＦ　｛ａ…ａ．ｂ…ｂ．ｃ…ｃ｜#n…n｝　ＮＯＴ　

ＳＵＰＰＯＲＴ

サポートされていない属性変換の組み合わせです。

a…a：抽出側または反映側の認可識別子

b…b：抽出側または反映側の表識別子

c…c：抽出側または反映側の列名

n…n：抽出フィールド通番

(Ｓ)：処理を終了します。

(Ｐ)：表名を修正するか，またはHiRDBの定義を修正したあとに再度実行してください。

JXU7216E

ＮＵＬＬ　ＤＡＴＡ　ＣＡＮＮＯＴ　ＢＥ　ＳＰＥＣＩＦＩＥＤ　ＩＮ　

ａ…ａ．ｂ…ｂ．ｃ…ｃ

ナル値情報ファイルに設定した列が非ナル値制約です。

a…a：抽出側または反映側の認可識別子

b…b：抽出側または反映側の格納表識別子

c…c：抽出側または反映側の列名

(Ｓ)：処理を終了します。

(Ｐ)：ナル値情報ファイルまたはHiRDBの定義を修正したあとに，再度実行してください。

JXU7217E

ＡＲＲＡＹ　ＮＵＭＢＥＲ　ＩＮＶＡＬＩＤ　ＩＮ　

ａ…ａ．ｂ…ｂ．ｃ…ｃ

抽出側と反映側の，繰返し列の要素数の組み合わせが不正です。

a…a：反映側の認可識別子

b…b：反映側の表識別子

c…c：反映側の列名

(Ｓ)：処理を終了します。

(Ｐ)：抽出側の列と反映側の列に定義した要素数を見直し，修正したあとに再度実行してください。

JXU7218E

ＤＡＴＡ　ＶＡＬＵＥ　ＯＦ　ａ…ａ．ｂ…ｂ．ｃ…ｃ　ＣＡＮＮＯＴ　ＣＯＮＶＥＲＴ

　ＥＲＲＯＲ　ＣＯＤＥ＝ｄｄ　ＣＯＵＮＴ＝ｅ…ｅ

データの値が不正なため変換できません。

a…a：抽出側の認可識別子

b…b：抽出側の表識別子

c…c：抽出側の列名

dd：エラーコード

e…e：エラー発生行数

01：DATEデータ型の指定値が紀元前である。

02：数値データ型の値がオーバフローした。

(Ｓ)：処理を終了します。

(Ｐ)：反映側の属性を変換可能なものに変更するか，抽出条件を指定して不正なデータを抽出対象外としたあとに再度実行してください。

JXU7219I

ＤＡＴＡ　ＣＯＮＶＥＲＴ　ＩＮＦＯＲＭＡＴＩＯＮ　ＦＲＯＭ＝ａ…ａ　ＴＯ　ｂ…ｂ，ＵＮＤＥＦ　ＣＯＤＥ＝ｃ…ｃ，ＥＲＲＯＲ　ＣＯＵＮＴ＝ｄ…ｄ［，ｅ…ｅ］

文字コード変換情報（ユーザデータ）を出力します。

a…a：変換前の文字コード

b…b：変換後の文字コード

c…c：未定義コード検出時に設定する値（XTUNDEF，XTDATAUNDEFの16進数値）

d…d：文字コード変換エラー時の打ち切り行数

e…e：UCS-4検知時の打ち切り行数

(Ｓ)：処理を続行します。

JXU7220E

ａ…ａ　ＩＳ　ＩＮＶＡＬＩＤ　ＩＮ　ｂ…ｂ　ＬＩＮＥ＝ｃ…ｃ

b…bファイルに記述されているc…c行目のa…aの指定が不正です。

a…a：指定内容

b…b：ファイル名

c…c：行数

(Ｓ)：処理を終了します。

(Ｐ)：ファイル中の指定内容を修正し，再度実行してください。

JXU7221E

ＦＥＳ　ＯＲ　ＢＥＳ　ＩＳ　ＮＯＴ　ＦＯＵＮＤ　ＩＮ　ａ…ａ

ホストa…a上のHiRDBユニットにフロントエンドサーバまたはバックエンドサーバが存在しません。

a…a：データ反映先ホスト名称

(Ｓ)：処理を終了します。

(Ｐ)：フロントエンドサーバまたはバックエンドサーバが存在するデータ反映先ホストと接続するようにクライアント側の設定を見直す，または環境変数情報設定ファイルに指定しているHiRDBの環境変数が，該当するサーバのユニットに対応しているか見直して，再度実行してください。

JXU7222E

｛ＥＮＶＩＲＯＮＭＥＮＴ　ＦＩＬＥ　ＮＡＭＥ　ＩＮ　／ｅｔｃ／

ｉｎｅｔｄ．ｃｏｎｆ｜ＩＮＰＵＴ　ＤＡＴＡ　ＦＩＬＥ　ＮＡＭＥ｝　

ＮＯＴ　ＳＥＴ　ＵＰ

ENVIRONMENT　FILE　NAME　IN　/etc/inetd.confが表示されている場合

コンフィギュレーションファイル/etc/inetd.confにHiRDB　Dataextractorの環境変数情報設定ファイル名が指定されていません。

(Ｓ)：処理を終了します。

(Ｐ)：コンフィギュレーションファイル/etc/inetd.confのフィールド名server　program　argumentsの設定内容を見直して，再度実行してください。

INPUT　DATA　FILE　NAMEが表示されている場合

pdloadに渡す入力データファイルが指定されていません。

(Ｓ)：処理を終了します。

(Ｐ)：次のどちらかの処置をしてください。

HiRDB間のデータ抽出・反映の場合

xtrepコマンドの−oオプション，または−Oオプションを指定して，再度実行してください。

XDM/XTと連携している場合

JXUMCTL制御文のTRANSFER文を指定して，再度実行してください。

JXU7223E

ＴＡＢＬＥ　ＮＡＭＥ　ａ…ａ．ｂ…ｂ　ＩＳ　ＩＮＶＡＬＩＤ　

ＥＲＲＯＲ　ＣＯＤＥ＝ｃ…ｃ

指定した表名が不正です。

a…a：反映側の認可識別子

b…b：反映側の表識別子

c…c：エラーコード

004：指定した表がビュー属性の表です。

005：指定した表がFIX属性の表です。

環境変数XTNLDFLTに2を指定した場合は，FIX表への反映はできません。

(Ｓ)：処理を終了します。

(Ｐ)：表名を修正するか，またはHiRDBの定義を修正したあとに再度実行してください。

エラーコードが005の場合，環境変数XTNLDFLTの指定を変更して，再度実行してください。

JXU7224E

ａ…ａ　ＮＯＴ　ＦＯＵＮＤ

a…aが存在しません。

a…a：絶対パス名

(Ｓ)：コネクション切断後，処理を終了します。

(Ｐ)：a…aに示す絶対パスのファイルまたはディレクトリの有無を確認し，エラー要因を取り除いてから，再度実行してください。

a…aが$PDDIR※/lib/libscomon.sl，$PDDIR※/client/lib/libzclt.sl，$PDDIR※/lib/libssol.soまたは＄PDDIR※/client/lib/libzclt.soの場合

HiRDB Dataextractorの環境変数情報設定ファイル中のPDDIRに設定したディレクトリパスを修正し，再度実行してください。

HiRDBのインストールが正しく実行されていない可能性があります。HiRDBを再インストールし，再度実行してください。

注※　$PDDIRの部分は，HiRDB Dataextractorの環境変数情報設定ファイル中でPDDIRに指定したディレクトリパスが表示される。

JXU7230I

ＤＡＴＡ　ＣＯＮＶＥＲＴ　ＥＲＲＯＲ　ＣＯＤＥ＝ａａ（ｂ…ｂ，ｃ…ｃ−ｄ…ｄ，ｅ…ｅ）〔ｆ…ｆ〕

文字コード変換処理中にエラーが発生しました。

このメッセージは，変換エラー検知数が環境変数XTUNDEFまたはXTUTF8UCS4CHKで指定した打ち切り件数に満たないときに，出力されます。

aa：エラーコード

01：データの切り捨てが発生した。

02：未定義コードを検知した。

03：列のデータが2バイトコード，または3バイトコードの途中で終わっている。

05：文字コードがUTF-8のデータ中に4バイト以上の文字コード（UCS-4）を検知した。

04：その他のコード変換エラー

b…b：次のどちらかを表示します。

列番号〔〔添え字〕〕：抽出対象列の先頭からの通番

保守情報

c…c：エラーを検知した列の開始位置（行の先頭からのオフセット）

d…d：エラーを検知した列の終了位置（行の先頭からのオフセット）

e…e：エラーを検知したデータの行の先頭からのオフセット

f…f：行データ（ダンプ形式）

変換前のデータを出力します。

１行の変換で複数メッセージを出力する場合は，最後のメッセージの次に出力します。なお，行データはメッセージログファイルには出力されません。

(Ｓ)：

エラーコードが01，02，03，04の場合：

処理を続行します。

エラーコードが05の場合：

環境変数XTUTF8UCS4CHKの指定に従い処理を続行します。

(Ｐ)：

エラーコードが01の場合：

反映側の列長を修正したあと，再度実行してください。

エラーコードが02の場合：

外字領域の文字コードの場合，ユーザマッピングテーブルを作成して再度実行してください。

外字領域の文字コードでない場合，抽出データを修正して再度実行してください｡

エラーコードが03，04の場合：

抽出データを修正して，再度実行してください。

エラーコードが05の場合：

オフセット情報は列中の最初に検知した文字であるため，列全体を見直してください。

環境変数XTUTF8UCS4CHKで行のスキップを指定した場合，必要なデータであればユーザ自身で反映側のデータベースにデータを登録してください。

環境変数XTUTF8UCS4CHKで行のスキップを指定しなかった場合，抽出データを修正して再度実行してください。

JXU7230E

ＤＡＴＡ　ＣＯＮＶＥＲＴ　ＥＲＲＯＲ　ＣＯＤＥ＝ａａ（ｂ…ｂ，ｃ…ｃ−ｄ…ｄ，ｅ…ｅ）〔ｆ…ｆ〕

文字コード変換処理中にエラーが発生しました。

このメッセージは，変換エラー検知数が環境変数XTUNDEFまたはXTUTF8UCS4CHKで指定した打ち切り件数に達したときに，出力されます。

aa：エラーコード

01：データの切り捨てが発生した。

02：未定義コードを検知した。

03：列のデータが2バイトコード，または3バイトコードの途中で終わっている。

05：文字コードがUTF-8のデータ中に4バイト以上の文字コード（UCS-4）を検知した。

04：その他のコード変換エラー

b…b：次のどちらかを表示します。

列番号〔〔添え字〕〕：抽出対象列の先頭からの通番

保守情報

c…c：エラーを検知した列の開始位置（行の先頭からのオフセット）

d…d：エラーを検知した列の終了位置（行の先頭からのオフセット）

e…e：エラーを検知したデータの行の先頭からのオフセット

f…f：行データ（ダンプ形式）

変換前のデータを出力します。

１行の変換で複数メッセージを出力する場合は，最後のメッセージの次に出力します。なお，行データはメッセージログファイルには出力されません。

(Ｓ)：処理を終了します。

(Ｐ)：

エラーコードが01の場合：

反映側の列長を修正したあと，再度実行してください。

エラーコードが02の場合：

外字領域の文字コードの場合，ユーザマッピングテーブルを作成して再度実行してください。

外字領域の文字コードでない場合，抽出データを修正して再度実行してください｡

エラーコードが03，04の場合：

抽出データを修正して再度実行してください。

エラーコードが05の場合：

オフセット情報は列中の最初に検知した文字であるため，列全体を見直してください。

環境変数XTUTF8UCS4CHKで行のスキップを指定した場合，必要なデータであればユーザ自身で反映側のデータベースにデータを登録してください。

環境変数XTUTF8UCS4CHKで行のスキップを指定しなかった場合，抽出データを修正して再度実行してください。

JXU7300E

ＥＲＲＯＲ　ＥＸＩＳＴ　ＩＮ　ＣＯＭＭＡＮＤ　ＬＩＮＥ　ＵＳＡＧＥ　

：　ａ…ａ

コマンドラインの指定に誤りがあります。

a…a：コマンド指定方法

xtrep：HiRDB抽出コマンド

xtrepO：ORACLE抽出コマンド

xtrepS：SQL Server抽出コマンド

(Ｓ)：処理を終了します。

(Ｐ)：コマンドラインに正しい指定で入力してください。

JXU7301E

ＬＩＴＥＲＡＬ　ＬＥＮＧＴＨ　ＯＦ　ＰＡＲＡＭＥＴＥＲ　ＩＮ　

ａ…ａ　ＯＰＴＩＯＮ　ＥＸＣＥＥＤＳ　ｂ…ｂ

a…aオプションの指定値の長さがb…bを超えています。

a…a：オプション名

EXTRACT　TABLE：抽出表名

EXTRACT　FILE　NAME：表式記述ファイル名

FILE　NAME：環境変数XTTMPDIRと，−o，−O，または−qオプション指定値を合わせた名称

DIRECTORY　NAME：環境変数XTTMPDIRと−bオプション指定値を合わせた名称

b…b：制限文字数

(Ｓ)：処理を終了します。

(Ｐ)：指定値の文字数をbb以下にして，再度実行してください。

a…aがFILE　NAMEの場合

環境変数XTTMPDIRと，−o，−O，または−qオプション指定値の合計けた数をbb以下にして，再度実行してください。

a…aがDIRECTORY　NAMEの場合

環境変数XTTMPDIRと−bオプション指定値の合計けた数をbb以下にして，再度実行してください。

JXU7302E

ＰＡＲＡＭＥＴＥＲ　ａ…ａ　ＩＮ　ｂ…ｂ　ＯＰＴＩＯＮ　ＩＳ　

ＩＮＣＯＲＲＥＣＴ

b…bオプションの指定値a…aが不正です。

a…a：指定値

b…b：オプション名

EXTRACT　TABLE：抽出表名

(Ｓ)：処理を終了します。

(Ｐ)：指定値を修正して，再度実行してください。

JXU7303E

ＰＡＲＡＭＥＴＥＲ　ａ…ａ　ＩＮ　ｂ…ｂ　ＯＰＴＩＯＮ　ＩＳ　

ＯＵＴ　ＯＦ　ＶＡＬＵＥ　ＲＡＮＧＥ

b…bオプションに指定した指定値a…aの範囲が不正です。

a…a：指定値

b…b：オプション名

(Ｓ)：処理を終了します。

(Ｐ)：指定値を修正して，再度実行してください。

JXU7305E

ａ…ａ　ＯＰＴＩＯＮ　ＭＩＳＳＩＮＧ

a…aオプションが必要ですが指定されていません。

a…a：オプション名

(Ｓ)：処理を終了します。

(Ｐ)：a…aオプションを指定して，再度実行してください。

JXU7306E

ａ…ａ　ＯＰＴＩＯＮ　ＣＡＮＮＯＴ　ＢＥ　ＳＰＥＣＩＦＩＥＤ　

ＷＩＴＨ　ｂ…ｂ　ＯＰＴＩＯＮ

a…aとb…bは同時に指定できません。

a…a：オプション名または環境変数名

b…b：オプション名または環境変数名

(Ｓ)：処理を終了します。

(Ｐ)：a…aまたはb…bのどちらかだけを指定して，再度実行してください。

JXU7307E

ａ…ａ　ＯＰＴＩＯＮ　ＣＡＮＮＯＴ　ＢＥ　ＳＰＥＣＩＦＩＥＤ　

ＷＩＴＨＯＵＴ　ｂ…ｂ　ＯＰＴＩＯＮ

a…aオプションはb…bオプションの指定なしに指定できません。

a…a：オプション名または環境変数名

b…b：オプション名または環境変数名

(Ｓ)：処理を終了します。

(Ｐ)：b…bオプションを指定するか，またはa…aオプションを省略して，再度実行してください。

JXU7308E

ＤＵＰＬＩＣＡＴＥ　ＰＡＲＡＭＥＴＥＲ　ａ…ａ　ＩＮ　ｂ…ｂ　

ＯＰＴＩＯＮ

b…bオプションに指定した指定値a…aが重複して指定されています。

a…a：指定値

b…bが−o，または−Oオプションの場合は，環境変数XTTMPDIRと−o，−Oオプション指定値を合わせた名称が出力されます。

b…b：オプション名

(Ｓ)：処理を終了します。

(Ｐ)：指定値a…aが重複しないように修正し，再度実行してください。

JXU7309E

ａ…ａ〔ＯＰＴＩＯＮ〕ＣＯＮＦＬＩＣＴＳ　ＷＩＴＨ　ｂ…ｂ　〔ＯＰＴＩＯＮ〕

オプション間，指定値間，またはオプションと指定値間の組み合わせが不正です。

a…a：オプション名，または指定値

b…b：オプション名，または指定値

(Ｓ)：処理を終了します。

(Ｐ)：オプション，または指定値を見直して再度実行してください。

JXU7311E

ＩＮＶＡＬＩＤ　ＯＰＴＩＯＮ　ＳＰＥＣＩＦＩＥＤ，ＯＰＴＩＯＮ　ＮＡＭＥ＝ａ…ａ

指定できないコマンドオプションを検知しました。

a…a：コマンドオプション

(Ｓ)：処理を終了します。

(Ｐ)：エラーの要因を取り除いたあと，再度実行してください。

JXU7312E

ＤＥＦＩＮＩＴＩＯＮ　ＦＯＲＭＡＴ　ＥＲＲＯＲ，ＦＩＬＥ＝ａ…ａ，ＬＩＮＥ＝ｂ…ｂ

変換定義ファイルの定義フォーマットが不正です。

a…a：変換定義ファイル名

b…b：行番号

(Ｓ)：処理を終了します。

(Ｐ)：変換定義ファイル内の行番号の示す行の定義内容を修正したあと，再度実行してください。

JXU7313E

ＩＮＶＡＬＩＤ　ＣＨＡＲＡＣＴＥＲ　ＣＯＤＥ，ＦＩＬＥ＝ａ…ａ，ＬＩＮＥ＝ｂ…ｂ，ＫＩＮＤ＝ｃ…ｃ，ＲＥＡＳＯＮ＝ｄ…ｄ

文字コードが不正です。

a…a：変換定義ファイル名

b…b：行番号

c…c：種別

before：変換元文字コード

afer：変換先文字コード

d…d：不正理由

(Ｓ)：処理を終了します。

(Ｐ)：変換定義ファイル内の行番号の示す行に定義した文字コードを不正理由に従って修正したあと，再度実行してください。

JXU7314E

ＯＰＴＩＯＮ　ＶＡＬＵＥＩＳＩＮＶＡＬＩＤ，ＯＰＴＩＯＮ　ＮＡＭＥａ…ａ

コマンドオプションに指定された値が不正です。

a…a：コマンドオプション

(Ｓ)：処理を終了します。

(Ｐ)：エラーの要因を取り除いたあと，再度実行してください。

JXU7315E

ＦＩＥＬＥ　ＡＣＣＥＳＳ　ＥＲＲＯＲ　ＷＡＳ　ＯＣＣＵＲＲＥＤ，ＯＰＥＲＡＴＩＯＮ＝ａ…ａ，ＦＩＬＥ＝ｂ…ｂ，ＥＲＲＮＯ＝ｃ…ｃ

ファイル操作でエラーを検知しました。

a…a：操作種別

b…b：ファイル名

c…c：エラー番号

(Ｓ)：処理を終了します。

(Ｐ)：エラー番号をerrno.hまたはユーザが使うOSのマニュアルを参照して，エラーの要因を取り除いたあと，再度実行してください。

JXU7316E

ＩＮＶＡＬＩＤ　ＣＯＭＭＡＮＤ　ＡＲＧＵＭＥＮＴ

コマンドの引数の指定に誤りがあります。

(Ｓ)：処理を終了します。

(Ｐ)：エラーの要因を取り除いたあと，再度実行してください。

付録

付録A　メモリ所要量とファイル所要量

付録A.1　メモリ所要量

HiRDB Dataextractorが使用するメモリ所要量を，次の表に示します。

このメモリはローカルメモリに確保されます。

表A‒1　HiRDB Dataextractorが使用するメモリ所要量

種別

プロセス名

プロシジャサイズ（単位：キロバイト）

動的メモリサイズ（単位：キロバイト）

HiRDB

抽出プロセス

250

24＋32×2＋B×2＋0.15×C

反映プロセス

200

16＋32×2＋0.1×C

XDM/XT

HiRDB抽出プロセス

850

24＋32×2＋B×2＋0.15×C

HiRDB反映プロセス

850

180＋12×L

ファイル作成

抽出プロセス

250

24＋32×2＋B×2＋0.15×C

ファイル作成プロセス

650

16＋32×4

（凡例）

HiRDB：抽出したデータをHiRDBへ反映する場合，または抽出したデータからファイルを作成してHiRDBへ反映する場合

XDM/XT：XDM/XTを使用して，メインフレーム側DBとHiRDB間のデータを抽出および反映する場合

ファイル作成：HiRDBから抽出したデータでファイルを作成する場合，またはXDM/XTを使用して，メインフレーム側DBから抽出したデータでファイルを作成する場合

B：抽出データ長（単位：キロバイト）

C：抽出列数

L：JXUMCTL制御文のLOAD文の指定枚数

付録A.2　ファイル所要量

環境変数XTNLDFLTの指定によって，出力ファイル容量の計算式が異なります。

ファイル容量の見積もりを次の表に示します。

表A‒2　ファイル容量の見積もり

ファイルの種類

容量の計算式（単位：バイト）

出力ファイル

HiRDB反映，またはバイナリ形式のファイル作成の場合

環境変数XTNLDFLTに0または1を指定した場合※1

c

｛Σ（列データ長i※4）｝×n

i=1

環境変数XTNLDFLTに2を指定した場合

c

｛Σ（列データ長i※4）＋4×（c＋1）｝×n

i=1

DAT形式のファイル作成の場合※2

c

｛Σ（列の最大文字変換長i※5）｝×n

i=1

LOB入力ファイル※3

LOBデータ長※6

（凡例）

n：行数

c：列定義数

注※1

環境変数XTLOBKINDに0を指定した場合は，LOB入力ファイルが別途作成されます。

注※2

SGMLTEXT，BLOB列が存在する場合は，LOB入力ファイルが別途作成されます。

注※3

LOB入力ファイルは，列単位に作成されます。

注※4

列データ長については，「4.2.4(4)出力ファイル」を参照してください。

注※5

列の最大文字変換長を次に示します。また，繰返し列の場合は要素数を考慮する必要があります。DAT形式のファイル作成時の，繰返し列のデータ形式については，「3.1.1(6)繰返し列の抽出」を参照してください。

データ型

最大文字変換長（単位：バイト）

INTEGER

11

SMLLINT

6

DECIMAL

31

FLOAT

24

SMALLFLT

23

CHAR

定義長＋2

VARCHAR

実長＋2

NCHAR

定義長×2＋2

NVARCHAR

実長＋2

MCHAR

定義長＋2

MVARCHAR

実長＋2

DATE

10

TIME

8

INTERVAL YEAR TO DAY

10

INTERVAL HOUR TO SECOND

8

BLOB

LOB入力ファイルの最大絶対パス名称長

SGMLTEXT

LOB入力ファイルの最大絶対パス名称長

XML

−※

FREEWORD

実長＋2

BINARY

実長＋2

TIMESTAMP

26

（凡例）

−：該当しません。

注※

DAT形式のファイル作成はできません。

注※6

最大ファイル数は，次の計算式で求めます。

　1行中のLOBデータ列定義数×行数

付録B　Windowsの機能差異

適用OSがWindowsの場合に，通常の使用方法とは異なる点について説明します。

付録B.1　使用できる機能の相違

(1)　OSIプロトコル

使用できる通信プロトコルは，TCP/IPプロトコルだけです。OSIプロトコルは，使用できません。

(2)　出力ファイルを作成しない反映

データの反映時に，出力ファイルを作成しないで表に反映することはできません。

HiRDB間のデータ抽出・反映の場合

xtrepコマンドで−oまたは−Oオプションを指定する必要があります。指定しない場合は，反映側がJXU7222Eメッセージを出力してリターンコード12で終了します。なお，使用したファイルが不要の場合，−Oオプションを指定してください。−oを指定した場合，サーバホスト内に使用したファイルが残るので，不要であれば手作業でファイルを削除してください。

メインフレーム側DBとのデータ抽出・反映の場合

XDM/XTを使用して，メインフレーム側DBのデータをHiRDBに反映する場合は，XDM/XTのJXUMCTL制御文のTRANSFER文を指定する必要があります。指定しない場合，JXU7222Eメッセージを出力しリターンコード12で終了します。なお，使用したファイルが不要の場合，TRANSFER文にPURGE YESを指定してください。TRANSFER文で，PURGEオペランドにNOを指定するかまたはPURGEオペランドを省略すると，サーバホスト内に使用したファイルが残るので，不要であれば手作業でファイルを削除してください。

付録B.2　注意事項

データ属性の変換

反映対象のHiRDBのデータ属性がVARCHARの場合で，抽出時のデータの後ろに空白がある場合は，データの反映時に後ろの空白を詰めて反映します。

環境変数XTTMPDIRでのネットワークドライブ指定不可

環境変数XTTMPDIRに，ネットワークドライブを指定しないでください。

環境変数XTPDCFxxx，XTLPRMxxxx，およびXTPDSRxxxxの指定値

ファイル名を絶対パス名で指定する際に，空白を含むパス名を指定する場合は，パス名の前後を引用符（"）で囲む必要があります。

HiRDBがセットアップ識別子付きでインストールされている場合の注意事項

抽出側と反映側でそれぞれ次の注意が必要です。

抽出側：

xtrep，xtrepOまたはxtrepSコマンドを指定する際は，HiRDB識別子に対応したコマンドプロンプトで実行してください。

反映側：

hirdbxt.iniの各［サービス名］セクションに次の環境変数を指定してください。抽出側でそのサービス名に対応したポート番号を指定することで任意の識別子に対応したHiRDBに反映できます。

・PDDIR

・PDCONFPATH

・PDUXPLDIR

Windows Vista，およびWindows Server 2008で運用を行う場合の注意事項

HiRDB DataextractorのコマンドはHiRDBが提供する「HiRDBコマンドプロンプト」を実行し，そのウィンドウで実行してください。「コマンドプロンプト」やExplorerなどから実行する場合は，右クリックで表示されるメニューから「管理者として実行」を選んで実行してください。

Windows Vista，およびWindows Server 2008では第3，第4水準漢字が使用できますが，HiRDB Dataextractorのパラメタに第3，第4水準漢字は指定できません。指定した場合の動作は保証できませんので，注意してください。

また，文字コード変換を行わない場合（環境変数XTLOCALEの指定を省略するか，または抽出側と反映側で同じ値を指定する場合）はデータの抽出，反映ができます。

付録B.3　環境の設定方法

(1)　HiRDB Dataextractorのインストール

HiRDB Dataextractorをインストールする方法について説明します。

(a)　インストール前の準備

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

稼働環境の確認

ユーザ権限の確認

(i)稼働環境の確認

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

HiRDB Dataextractorをインストールするマシンのディスクの空き容量が十分にあることを確認してください。

HiRDB Dataextractorが動作するのに必要な製品がインストールされていることを確認してください。HiRDB Dataextractorが動作するのに必要な製品については，「2.1　ソフトウェア構成」を参照してください。

(ii)ユーザ権限の確認

インストールを実行するユーザにAdministratorの権限があることを確認してください。

(b)　HiRDB Dataextractorをインストールするホスト

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

表B‒1　HiRDB Dataextractorをインストールするホスト

種別

抽出側

反映側

ファイル作成側

インストールするホスト※1

HiRDB/シングルサーバの場合

シングルサーバのあるホスト

HiRDB/シングルサーバの場合

シングルサーバのあるホスト

ファイルを作成するホスト

HiRDB/パラレルサーバの場合

次のどれかのサーバのあるホスト

システムマネジャ

フロントエンドサーバ

バックエンドサーバ

ディクショナリサーバ

HiRDB/パラレルサーバの場合

次のサーバのあるホスト※2

システムマネジャのあるホスト

データの転送先のサーバのあるホスト※3

ORACLEの場合

ORACLEのあるホスト

SQL Serverの場合

SQL Serverのあるホスト

注※1

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

注※2

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

注※3

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

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

(c)　インストールの実行

「2.1　ソフトウェア構成」を参照して，HiRDB Dataextractorを使うために必要な製品をインストールしてください。

HiRDBとHiRDB Dataextractorのどちらを先にインストールしてもかまいません。

HiRDB Dataextractorのインストールが完了したあとには，いったんWindowsを再起動する必要があります。

(i)インストールの実行手順

インストール用の統合CD-ROMからインストールする手順を次に示します。インストールを実行する前に，HiRDB DataextractorとすべてのWindowsアプリケーションを終了させてください。

HiRDBの統合CD-ROMを挿入して，hcd_inst.exeを実行します。

日立総合インストーラが起動します。

画面の指示に従って［次へ>］ボタンをクリックします。

名前と会社名を入力して，［次へ>］ボタンをクリックします。

表示されている名前と会社名をそのまま使う場合は，入力は不要です。

インストール先ディレクトリを指定し，［次へ>］ボタンをクリックします。

標準のインストール先は，次に示すディレクトリです。

Windowsのインストール先ドライブ：¥win32app¥Hitachi¥hirdbxt

上記のディレクトリ以外にインストールする場合は，［参照...］ボタンをクリックして，インストール先のディレクトリ※1を指定します。指定したディレクトリがない場合，作成するかどうかを確認するメッセージが表示されます。

登録するプログラムフォルダ名またはグループ名として［HiRDB Dataextractor］が表示されるので，［次へ>］ボタンをクリックします。

表示されている名前以外のグループを登録する場合は，名前を指定します。また，既存のグループに登録する場合は，既存のグループの中から選択します。

環境変数の設定を選択し［次へ>］ボタンをクリックします。

［環境変数を設定しない］を選択すると，環境変数PATHにHiRDB Dataextractorのコマンドライブラリの名称が追加されません。

［環境変数を設定する］を選択すると，環境変数PATHにHiRDB Dataextractorのコマンドライブラリの名称が追加されます。

ファイルのコピーを開始する前に現在の設定が表示されるので，［次へ>］ボタンをクリックします。

HiRDB Dataextractorのインストールが開始されます。

HiRDB Dataextractorのインストールが完了したら，いったんWindowsを再起動します。

注※1

指定できるドライブは，ローカルドライブだけです。ネットワークドライブは指定しないでください。

注※2

すでに運用管理をインストールしている状態でインストールすると，ファイルのコピーでエラーになることがあります。エラーになったときは，SNMPサービスをいったん停止してから再インストールしてください。

(d)　インストール時に登録される内容

インストール時に登録される内容を次に示します。

(i)サービス

インストール時に登録されるサービスの種類，および［コントロールパネル］の［サービス］アイコンを開いたときに表示される名称とスタートアップの設定を次の表に示します。

表B‒2　インストール時に登録されるサービス

種類

表示される名称

スタートアップの種類※

ログオン※

反映サービス

HiRDB Dataextractor

手動

システムアカウント

注※

インストール後にコントロールパネルの［サービス］アイコンを開いて変更できます。システムアカウント以外にAdministrators権限を持つユーザのアカウントに変更できます。

(ii)アイコン

［HiRDB Dataextractor］フォルダまたはグループに，はじめにお読みいただくファイル（HiRDB Dataextractorのインストールディレクトリ下の¥Readme.txt）のアイコンが登録されます。

アンインストールには，［コントロールパネル］の［アプリケーションの追加と削除］アイコンを使うため，アンインストールプログラムのアイコンは登録されません。

(iii)システムの環境変数

環境変数PATHにHiRDB Dataextractorのコマンドライブラリの名称が追加されます。コマンドライブラリの名称を次に示します。

　　　　　HiRDB Dataextractorのインストールディレクトリ¥bin

(e)　HiRDB Dataextractorのアンインストール

HiRDB Dataextractorをアンインストールする手順を次に示します。

アンインストールを実行する前に，［HiRDB Dataextractor］のサービスはすべて終了させてください。

［コントロールパネル］にある［アプリケーションの追加と削除］アイコンを開きます。

［インストールと削除］タブを選択します。

インストールされているアプリケーションの一覧から［HiRDB Dataextractor］を選択して，［追加と削除...］ボタンをクリックします。

画面の指示に従って，［はい］ボタンをクリックします。

アンインストールが終了したら，［OK］ボタンをクリックします。

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

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

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

ディレクトリおよびファイル名

内容

種別

抽出

反映

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

HiRDB Dataextractorの各種ディレクトリおよびファイルを格納するディレクトリ

○

○

インストールディレクトリ¥bin

HiRDB Dataextractorの実行ファイルを格納するディレクトリ（このディレクトリ下にHiRDB Dataextractorのロードモジュールおよびコマンドを格納する）

○

○

インストールディレクトリ¥bin¥pxtmsvc.exe

HiRDB Dataextractorの実行ファイル

○

○

インストールディレクトリ¥bin¥pxtload.exe

○

○

インストールディレクトリ¥bin¥xtrep.exe

HiRDB Dataextractorのxtrepコマンドのファイル

○

○

インストールディレクトリ¥bin¥xtmsgtext.dll

HiRDB Dataextractorのメッセージ出力用テキストファイル

○

○

インストールディレクトリ¥conf¥hirdbxtc.ini※1

HiRDB Dataextractorの環境変数情報設定ファイル

○※2

△

インストールディレクトリ¥conf¥hirdbxt.ini※1

HiRDB Dataextractorの環境変数情報設定ファイル

○※3

○

インストールディレクトリ¥lib¥maptable¥euc2jis.map

文字コード変換用マッピングテーブル（EUCからSJISへの変換）

○

○

インストールディレクトリ¥lib¥maptable¥eucg2j.map

インストールディレクトリ¥lib¥maptable¥euc2ucs2.map

文字コード変換用マッピングテーブル（EUCからUCS-2への変換）

○

○

インストールディレクトリ¥lib¥maptable¥eucg2u.map

インストールディレクトリ¥lib¥maptable¥jis2euc.map

文字コード変換用マッピングテーブル（SJISからEUCへの変換）

○

○

インストールディレクトリ¥lib¥maptable¥jis2ucs2.map

文字コード変換用マッピングテーブル（SJISからUCS-2への変換）

○

○

インストールディレクトリ¥lib¥maptable¥ucs22euc.map

文字コード変換用マッピングテーブル（UCS-2からEUCへの変換）

○

○

インストールディレクトリ¥lib¥maptable¥ucs22jis.map

文字コード変換用マッピングテーブル（UCS-2からSJISへの変換）

○

○

インストールディレクトリ¥lib¥pxtora01.dll

ORACLE抽出DLL

○

○

インストールディレクトリ¥lib¥pxtsql01.dll

SQL Server抽出DLL

○

○

インストールディレクトリ¥lib¥usermap※4

ユーザの文字コード変換用マッピングテーブルを格納するディレクトリ

−

○

インストールディレクトリ¥spool¥※5

HiRDB Dataextractorが稼働中に出力するファイルを格納するディレクトリ

○

○

（凡例）

○：作成します。

△：作成しますが使用しません。

−：作成しません。

抽出：抽出側

反映：反映側

インストールディレクトリ：HiRDB Dataextractorをインストールしたディレクトリ

注※1

インストール時に環境変数情報設定ファイル（hirdbxtc.iniとhirdbxt.ini）を作成しますが，前バージョンなどインストール済みで，アンインストールをしないで同一ディレクトリにインストールした場合は，環境変数情報設定ファイルの名称をhirdbxtcXX.iniとhirdbxtXX.ini（XXは00〜99）で作成します。ただし，HiRDB Dataextractorはhirdbxtc.iniまたはhirdbxt.iniを使用します。

注※2

抽出したデータをHiRDBへ反映する場合にだけ使用します。

注※3

XDM/XTを使用して，HiRDBから抽出したデータをXDM/RDへ反映する場合および順編成データセットを作成する場合にだけ使用します。

注※4

xtccnvedtコマンドでマッピングテーブルを最初に更新するときに作成します。

注※5

インストールディレクトリ¥spool¥下には，HiRDB Dataextractorが稼働中に動的に作成するファイルがあります。それらのファイルはHiRDB Dataextractorの稼働中に削除しないでください。また，インストールディレクトリ¥spool¥を削除しないでください。HiRDB Dataextractorの稼働中にインストールディレクトリ¥spool¥下に作成されるファイルは，適用OSがUNIXの場合と同じです。

(a)　HiRDB Dataextractorを使用するために必要な環境変数

HiRDB Dataextractorの環境変数は，HiRDB Dataextractorがインストール時に作成する次のファイルに設定します。ファイル中には，あらかじめ環境変数が記述されていますので，ユーザの環境に応じた環境変数に変更してください。また，HiRDBのクライアント環境変数を指定するHiRDB.iniと同時に指定することができ，次のファイルの指定値が優先されます。

hirdbxtc.ini

hirdbxt.ini

(i)データ抽出側（HiRDB間の抽出・反映の場合）の環境変数

hirdbxtc.iniファイルの指定方法を次に示します。

形式

［個別環境名］

〜＜スペースを含まない英数字＞((1〜64けた))

注意事項

指定できる個別環境名のセクション数には制限はないが，ファイル容量が大きくなると実行時にメモリを圧迫し，動作できない場合があります。

各セクションには1個以上の環境変数の設定が必要です。

同一セクションを複数指定した場合，先頭のセクションが有効になります。

［　］はセクション名を示す記号ですので，必ず指定してください。

(ii)データ抽出側（XDM/XTと連携する場合），データ反映側の環境変数

hirdbxt.iniファイルの指定方法を次に示します。

形式

［サービス名］

〜＜スペースを含まない英数字＞((1〜64けた))

注意事項

サービス名のセクション数は，最大16個です。

各セクションには1個以上の環境変数の設定が必要です。

サービス名が重複，またはサービス数の上限を超えて指定した場合，エラーになります。

［　］はセクション名を示す記号ですので，必ず指定してください。

hirdbxt.iniファイルを変更した場合，HiRDB Dataextractorサービスの再起動が必要です。

(b)　設定する環境変数

HiRDB Dataextractorを使用するために必要な環境変数を，次の表に示します。HiRDB Dataextractorセクションに指定した環境変数名は，ほかのセクションで指定する環境変数の初期値になります。

また，HiRDBの環境変数は，HiRDBのバージョンによってHiRDB Dataextractorの環境変数情報設定ファイルに設定することもできます。

表B‒4　HiRDB Dataextractorを使用するために必要な環境変数

環境変数の設定

抽出側

反映側

HiRDB

XDM/XT

設定先ファイル

hirdbxtc.ini

hirdbxt.ini

hirdbxt.ini

設定可能なHiRDB Dataextractorの環境変数※1

[XTHOST]

[XTXHOST]

[XTPORTNO]

[XTLOGNAME]

[XTTMPDIR]

[XTLOGNAME]

[XTOPNWTIME]

[XTTMPDIR]

[XTLOGNAME]

[XTOPNWTIME]

設定可能なHiRDBの環境変数※1

[PDUSER]※2

[PDDIR]※2

[PDCONFPATH]※2

[PDUXPLDIR]※2

[その他の環境変数]

PDUSER※2

[PDDIR]※2

[PDCONFPATH]※2

[PDUXPLDIR]※2

[その他の環境変数]

PDUSER※2

[PDDIR]※2

[PDCONFPATH]※2

[PDUXPLDIR]※2

その他の環境変数は無効

（凡例）

HiRDB：抽出したデータをHiRDBへ反映する場合

XDM/XT：XDM/XTを使用して，HiRDBから抽出したデータをXDM/RD へ反映する場合および順編成データセットを作成する場合

注※1

各セクションに指定できます。

注※2

抽出または反映対象とするHiRDBが識別子付きセットアップを使用している場合，この環境変数の設定が必要です。

(c)　環境変数の指定方法

形式

環境変数名＝［環境変数設定値］

注意事項

環境変数設定値を省略した場合，環境変数を設定しない場合と同じです。

記述規則

1行で一つの環境変数の設定を記述します。

注釈は行の先頭の"＃"以降その行の終わりまでです（環境変数の設定行に注釈は記述できません）。

(d)　HiRDB Dataextractorを使用するために設定するファイル

HiRDB Dataextractorを使用するために設定するファイルで，適用OSがUNIXの場合とは異なるファイルについて，次の表に示します。

表B‒5　HiRDB Dataextractorを使用するために設定するファイルで，適用OSがUNIXの場合とは異なるファイル

ファイル名

内容

種別

抽出側

反映側

HiRDB

XDM/XT

インストールディレクトリ¥conf¥hirdbxtc.ini

HiRDB間でのデータの抽出・反映時で抽出時に使用する環境変数を指定します。

○

−

−

インストールディレクトリ¥conf¥hirdbxt.ini

HiRDBへの反映時，ならびにXDM/XTへの抽出および反映時に使用する環境変数を指定します。

−

○

○

hostsファイル※1

反映先のホスト名を指定します。

○

−

−

servicesファイル※2

HiRDB Dataextractor用のサービス名称とポート番号を指定します。

−

○

○

（凡例）

○：必要です。

−：不要です。

インストールディレクトリ：HiRDB Dataextractorをインストールしたディレクトリ

HiRDB：抽出したデータをHiRDBへ反映する場合

XDM/XT：XDM/XTを使用して，HiRDBから抽出したデータをXDM/RD へ反映する場合および順編成データセットを作成する場合

注※1

Windowsシステムディレクトリ¥system32¥drivers¥etc¥hosts

注※2

Windowsシステムディレクトリ¥system32¥drivers¥etc¥services

付録B.4　開始，終了

HiRDB Dataextractorの操作および運用方法について，適用OSがUNIXの場合とは異なる点について説明します。

(1)　HiRDB Dataextractorの開始

HiRDB Dataextractorは次のホストで開始してください。

HiRDBからのデータ抽出，HiRDBへのデータ反映をする場合の反映側ホスト

XDM/XTと連携する場合のHiRDBの抽出側ホスト，またはHiRDBの反映側ホスト

HiRDB Dataextractorの開始方法について説明します。HiRDB Dataextractorの開始方法には，自動開始と手動開始があります。servicesファイルの設定後は自動開始に設定しておくことをお薦めします。

(i)自動開始

Windowsを起動したときに，HiRDB Dataextractorを自動で開始する方法を次に示します。なお，HiRDB Dataextractorを自動開始するには，Windowsのサービスを使用する必要があります。

「管理ツール」の「サービス」アイコンをダブルクリックします。

「サービス」に表示されているリストボックスから HiRDB Dataextractorサービスを選択し，ダブルクリックします。

「スタートアップの種類」で「自動」を選択します。

(ii)手動開始

HiRDB Dataextractorを手動開始する方法を次に示します。手動開始では，WindowsのサービスからHiRDB Dataextractorを開始します。

「コントロールパネル」の「サービス」をダブルクリックします。

「サービス」に表示されているリストボックスから「HiRDB Dataextractor」を選択します。

「開始」ボタンをクリックします。これによって，HiRDB Dataextractorが開始します。

(2)　HiRDB Dataextractorの停止

HiRDB Dataextractorの停止方法について説明します。

HiRDB Dataextractorは，Windowsのサービスで停止します。

(i)Windowsのサービスからの停止

「コントロールパネル」の「サービス」をダブルクリックします。

「サービス」に表示されているリストボックスから「HiRDB Dataextractor」を選択します。

「停止」ボタンをクリックします。

付録B.5　コマンドの指定方法

(1)　xtrep，xtrepO，またはxtrepSコマンド

xtrepコマンドの指定方法について，適用OSがUNIXの場合とは異なる点について説明します。ORACLEの場合はxtrepO，SQL Serverの場合はxtrepSに読み替えてください。

ｘｔｒｅｐ
　　　　　　　　　　　　　　　　　：
　　　　　　　　　　　　　　　　　：
　　　　　　｛−ｏ〔出力ファイル名〕｜−Ｏ〔出力ファイル名〕｝
　　　　　　〔−ａ　個別環境セクション名〕
　　　　　　　　　　　　　　　　　：
　　　　　　　　　　　　　　　　　：

●｛−ｏ｜−Ｏ｝〔出力ファイル名〕　〜＜パス名＞((1〜70けた))

−oオプションまたは−Oオプションのどちらかを必ず指定してください。

オプションの指定方法は適用OSがUNIXの場合と同じです。

出力ファイルの名称は，xtrepコマンドの−oオプションまたは−Oオプションでの指定と，データ反映側の環境変数XTTMPDIRでの指定によって決定します。

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

表B‒6　出力ファイルの名称

指定内容

出力ファイルの名称

出力ファイル名指定

環境変数XTTMPDIR

○

○

%XTTMPDIR%¥出力ファイル名指定値

×

インストールディレクトリ¥spool¥出力ファイル名指定値

×

○

%XTTMPDIR%¥抽出表名-年.月.日-時.分.秒

×

インストールディレクトリ¥spool¥抽出表名-年.月.日-時.分.秒

（凡例）

○：指定あり

×：指定なし

出力ファイル名指定：−oまたは−Oオプションでの出力ファイル名の指定

%XTTMPDIR%：環境変数XTTMPDIRでの指定値

注

指定した出力ファイル名または抽出表名に，スペースまたはコンマ（，）が含まれている場合は，作成されるファイル名ではスペースおよびコンマ（，）はアンダスコア（＿）に変換されます。

●−ａ　個別環境セクション名　〜((1〜64けた))

環境変数情報設定ファイル（hirdbxtc.ini）に指定した，個別環境セクションのセクション名を指定します。HiRDB Dataextractor実行時，指定したセクションの環境変数が有効になります。省略時は，xtrepコマンドの場合xtrep00を，xtrepOコマンドの場合xtrepO00を，xtrepSコマンドの場合xtrepS00を仮定します。

(2)　コマンド指定時の注意事項

認可識別子，表識別子を小文字で指定する場合は，¥"で囲んで指定してください。

指定例

¥"aaa¥"

認可識別子，表識別子にスペースが含まれる場合は，¥"で囲み，さらに引用符（"）で囲んでください。

指定例

"¥"a a¥""

空白を含むパス名を指定する場合は，パス名の前後を引用符（"）で囲んでください。

環境変数XTTMPDIRの指定値に¥だけを指定した場合は，−ｏ，−Ｏ，−ｂオプションに指定するパス名には，フルパス名を指定してください。

付録B.6　メッセージの出力先

メッセージの出力先を，次の表に示します。

表B‒7　メッセージの出力先

出力先

抽出側

反映側

HiRDB

XDM/XT

エラーログファイル

（インストールディレクトリ¥spool¥xter…）

○※1

○※2

○※2

標準出力

○

×

×

イベントログ

○

○

○

（凡例）

○：出力します。

×：出力しません。

HiRDB：抽出したデータをHiRDBへ反映する場合

XDM/XT：XDM/XTを使用して，HiRDBから抽出したデータをXDM/RD へ反映する場合および順編成データセットを作成する場合

注※1

ファイル名は，環境変数XTLOGNAMEが指定されていなければ，HiRDB Dataextractorが一意になるように設定します。

なお，xtrepコマンドの−eオプションの指定によって，任意のファイルに出力することもできます。この場合，指定した名称が環境変数XTLOGNAMEの指定値よりも優先されます。

このファイルは，パラメタ解析中にエラーが発生した場合には作成されず，エラーメッセージは，標準出力にだけ出力されます。

注※2

ファイル名は，環境変数XTLOGNAMEが指定されていなければ，HiRDB Dataextractorが一意になるように設定します。

付録C　Solarisの機能差異

適用OSがSolarisの場合に，通常の使用方法とは異なる点について説明します。

付録C.1　使用できる機能の相違

(1)　OSIプロトコル

使用できるプロトコルは，TCP/IPプロトコルだけです。OSIプロトコルは，使用できません。

付録C.2　環境変数

●LANG

この環境変数を省略した場合，jaを仮定します。

●LD_LIBLARY_PATH

xtrepコマンドを使用してHiRDBのデータを抽出・反映するとき，抽出側のHiRDBの共用ライブラリが格納されているディレクトリを絶対パスでxtrepコマンドを投入するユーザ環境に設定してください。

この環境変数は，既存の環境変数SHLIB_PATHの代わりに指定してください。

付録C.3　注意事項

XDM/XTと連携してHiRDBからデータを抽出，またはHiRDBへデータを反映するとき，環境変数LANGで指定した文字コードと，XDM/XT制御文のCONVERT文で指定された文字種別は同じでなければなりません。異なる文字コードを指定した場合，結果は保証されません。

ナル値情報ファイルを省略したとき，NCHAR，NVARCHAR属性のナル値の規定値は’＃＃’（X’81948194’…SJISコード）を仮定するため，環境変数LANGを省略または指定値がjaの場合，抽出側のHiRDBの’＃＃’というデータが，ナル値として反映側のHiRDBへ格納されません。そこで，’＃＃’というデータをナル値として反映する場合は，ナル値情報ファイルに定数値として’＃＃’をUJISコードで指定してください。ナル値情報ファイルの指定方法の詳細は「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

ナル値情報ファイルでNCHAR，NVARCHAR属性の列に対しSPACEを指定すると，ナル値の規定値を空白(X’8140’…SJISコード)とするため，環境変数LANGを省略または指定値がjaの場合，抽出側のHiRDBの空白データがナル値として反映側のHiRDBへ格納されません。空白をナル値として反映する場合は，ナル値情報ファイルに定数値として空白をUJISコードで指定してください。ナル値情報ファイルの指定方法の詳細は「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

付録D　Linuxの機能差異

適用OSがLinuxの場合に，通常の使用方法とは異なる点について説明します。

付録D.1　使用できる機能の相違

(1)　OSIプロトコル

使用できるプロトコルは，TCP/IPプロトコルだけです。OSIプロトコルは，使用できません。

付録D.2　環境変数

●LANG

この環境変数を省略した場合，ja_JP.eucJPを仮定します。

●LD_LIBLARY_PATH

xtrepコマンドを使用してHiRDBのデータを抽出・反映するとき，抽出側のHiRDBの共用ライブラリが格納されているディレクトリを絶対パスでxtrepコマンドを投入するユーザ環境に設定してください。

この環境変数は，既存の環境変数SHLIB_PATHの代わりに指定してください。

付録D.3　注意事項

XDM/XTと連携してHiRDBからデータを抽出，またはHiRDBへデータを反映するとき，環境変数LANGで指定した文字コードと，XDM/XT制御文のCONVERT文で指定された文字種別は同じでなければなりません。異なる文字コードを指定した場合，結果は保証されません。

ナル値情報ファイルを省略したとき，NCHAR，NVARCHAR属性のナル値の規定値は’＃＃’（X’81948194’…SJISコード）を仮定するため，環境変数LANGを省略または指定値がja_JP.eucJP，ja_JP，またはja_JP.ujisの場合，抽出側のHiRDBの’＃＃’というデータが，ナル値として反映側のHiRDBへ格納されません。そこで，’＃＃’というデータをナル値として反映する場合は，ナル値情報ファイルに定数値として’＃＃’をUJISコードで指定してください。ナル値情報ファイルの指定方法の詳細は「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

ナル値情報ファイルでNCHAR，NVARCHAR属性の列に対しSPACEを指定すると，ナル値の規定値を空白(X’8140’…SJISコード)とするため，環境変数LANGを省略または指定値がja_JP.eucJP，ja_JP，またはja_JP.ujisの場合，抽出側のHiRDBの空白データがナル値として反映側のHiRDBへ格納されません。空白をナル値として反映する場合は，ナル値情報ファイルに定数値として空白をUJISコードで指定してください。ナル値情報ファイルの指定方法の詳細は「4.2.4　xtrepコマンドで指定するファイルの内容」を参照してください。

付録D.4　環境の設定方法

HiRDB Dataextractorを使用するために設定するファイルで，通常の設定とは異なるファイルについて説明します。

RedHat 7以降の場合，inetdコンフィギュレーションファイルは次のファイルになります。

/etc/xinetd.d/xxxx

xxxx：/etc/servicesファイルに登録したサービス名でファイルを作成します。

(1)　内容

HiRDB Dataextractorの起動を設定します。

(2)　作成例

サービス名がhxt000の場合，ファイル名は/etc/xinetd.d/hxt000となります。

（例1）HiRDB Dataextractor起動のための定義

# HiRDB Dataextractor
service hxt000
{
  disable       = no
  socket_type   = stream
  wait          = no
  user          = root
  server        = /opt/HIRDBXT/bin/pxtcntl
  server_args   = /opt/HIRDBXT/conf/xtenv0
}

（例2）環境変数を指定してHiRDB Dataextractorを起動するための定義

# HiRDB Dataextractor
service hxt000
{
  disable       = no
  socket_type   = stream
  wait          = no
  user          = root
  server        = /usr/bin/env
  server_args   = XTLOGNAME=XTLOG /opt/HIRDBXT/bin/pxtcntl /opt/HIRDBXT/conf/xtenv0
}

注

ファイルを追加および修正した場合は，次のコマンドでxinetdを再起動してください。

/etc/rc.d/init.d/xinetd restart

付録E　AIXの機能差異

適用OSがAIXの場合に，通常の使用方法とは異なる点について説明します。

付録E.1　使用できる機能の相違

(1)　OSIプロトコル

使用できるプロトコルは，TCP/IPプロトコルだけです。OSIプロトコルは，使用できません。

付録E.2　環境変数

●LANG

この環境変数には，次の指定値を指定できます。

Ja_JP（シフトJISコード）

ja_JP（日本語EUCコード）

この環境変数を省略した場合，Ja_JPを仮定します。

●LIBPATH

xtrepコマンドを使用してHiRDBのデータを抽出・反映するとき，抽出側のHiRDBの共用ライブラリが格納されているディレクトリを絶対パスでxtrepコマンドを投入するユーザ環境に設定してください。

この環境変数は，既存の環境変数SHLIB_PATHの代わりに指定してください。

付録E.3　注意事項

XDM/XTと連携してHiRDBからデータを抽出，またはHiRDBへデータを反映するとき，環境変数LANGで指定した文字コードと，XDM/XT制御文のCONVERT文で指定された文字種別は同じでなければなりません。異なる文字コードを指定した場合，結果は保証されません。

HiRDB Dataextractorを実行する前にsyslogの設定を行ってください。syslogの設定を行わないで環境変数XTLOGRETRYの指定を省略すると，異常終了します。syslogへの出力を行わずに，HiRDB Dataextractorを実行する場合はXTLOGRETRYに0を指定してください。

XDM/XTと連携してHiRDBからデータを抽出またはHiRDBへデータを反映するとき，環境変数LANGで指定した文字コードとXDM/XT制御文のCONVERT文で指定された文字種別と同じ文字コードでなければなりません。異なった文字コードを指定した場合，結果は保証されません。

索引

記号

/etc/hostsの設定[1]、[2]

/etc/inetd.confの設定[1]、[2]

/etc/localrcの設定[1]

/etc/servicesの設定[1]、[2]

/opt/HIRDBXT/[1]

/opt/HIRDBXT/bin[1]

/opt/HIRDBXT/bin/xtmsgtext[1]

/opt/HIRDBXT/bin/xtrep[1]

/opt/HIRDBXT/bin/xtstart[1]

/opt/HIRDBXT/lib[1]

/opt/HIRDBXT/lib/maptable/euc2jis.map[1]

/opt/HIRDBXT/lib/maptable/euc2ucs2.map[1]

/opt/HIRDBXT/lib/maptable/eucg2jis.map[1]

/opt/HIRDBXT/lib/maptable/eucg2u.map[1]

/opt/HIRDBXT/lib/maptable/jis2euc.map[1]

/opt/HIRDBXT/lib/maptable/jis2ucs2.map[1]

/opt/HIRDBXT/lib/maptable/ucs22euc.map[1]

/opt/HIRDBXT/lib/maptable/ucs22jis.map[1]

/opt/HIRDBXT/lib/pxtora01.sl[1]

/opt/HIRDBXT/lib/usermap[1]

/opt/HIRDBXT/obj/pxto8160.o[1]

/opt/HIRDBXT/spool/[1]

/opt/HIRDBXT/spool/...[1]

/opt/HIRDBXT/spool/.pden...[1]

/opt/HIRDBXT/spool/.pdin...[1]

/opt/HIRDBXT/spool/.xtpc...[1]

/opt/HIRDBXT/spool/pdcf...[1]

/opt/HIRDBXT/spool/pder...[1]

/opt/HIRDBXT/spool/pdin...[1]

/opt/HIRDBXT/spool/pdnf...[1]

/opt/HIRDBXT/spool/xter[1]

/opt/HIRDBXT/spool/xtlog...[1]

$XTTMPDIR/...[1]、[2]

〔ORACLE〕

データ抽出時のSQLユーザ指定機能[1]

ナル値情報ファイル[1]

排他情報ファイル[1]

反映情報ファイル[1]

表式記述ファイル[1]

文字コード変換機能[1]

列名記述ファイル[1]

ローダのパラメタユーザ任意指定機能[1]

〔SQL Server〕

データ抽出時のSQLユーザ指定機能[1]

ナル値情報ファイル[1]

反映情報ファイル[1]

表式記述ファイル[1]

文字コード変換機能[1]

列名記述ファイル[1]

ローダのパラメタユーザ任意指定機能[1]

−ｂオプション〔xtrepコマンド〕 [1]

−ｄオプション〔xtrepコマンド〕 [1]

−ｅオプション〔xtrepコマンド〕 [1]

−ｆオプション〔xtrepコマンド〕 [1]

−ｇオプション〔xtrepOコマンド〕 [1]

−ｇオプション〔xtrepコマンド〕 [1]

−Ｈオプション〔xtrepコマンド〕 [1]

−ｈオプション〔xtrepコマンド〕 [1]

−Ｉオプション〔xtrepコマンド〕 [1]

−ｉオプション〔xtrepコマンド〕 [1]

−ｊオプション〔xtrepコマンド〕 [1]

−Ｌオプション〔xtrepOコマンド〕 [1]

−Ｌオプション〔xtrepSコマンド〕 [1]

−Ｌオプション〔xtrepコマンド〕 [1]

−ｌオプション〔xtrepコマンド〕 [1]

−ｍオプション〔xtrepコマンド〕 [1]

−ｎオプション〔xtrepコマンド〕 [1]

−Ｏオプション〔xtrepコマンド〕 [1]

−ｏオプション〔xtrepコマンド〕 [1]

−ｐオプション〔xtrepコマンド〕 [1]

−ｑオプション〔xtrepコマンド〕 [1]

−Ｒオプション〔xtrepコマンド〕 [1]

−ｒオプション〔xtrepコマンド〕 [1]

−ｓオプション〔xtrepコマンド〕 [1]

−ｖオプション〔xtrepコマンド〕 [1]

−ｗオプション〔xtrepコマンド〕 [1]

−ｘオプション〔xtrepコマンド〕 [1]

−ｙオプション〔xtrepコマンド〕 [1]

−ｚオプション〔xtrepコマンド〕 [1]

数字

16進定数値[1]

A

ADT[1]

AIX[1]

AIXの機能差異[1]

ARRAY[1]

B

bin[1]

BLOB[1]、[2]、[3]

C

CODECONV[1]

D

dat[1]

DAT形式[1]

E

EBCDIK[1]

EUCからSJISへの文字コード変換[1]

EUCからUTF-8への文字コード変換[1]

EUCからUTF-16への文字コード変換[1]

extracts[1]、[2]、[3]

F

FIX属性[1]

FREEWORD型[1]

H

HIGH[1]

HiRDB[1]

HiRDB Dataextractor異常終了[1]

HiRDB Dataextractorで変換および比較できるデータ型[1]

HiRDB Dataextractorで変換できるデータ型（ORACLEの場合）[1]

HiRDB Dataextractor動作環境設定中エラー[1]

HiRDB Dataextractorのアンインストール〔UNIX〕[1]

HiRDB Dataextractorのアンインストール〔Windows〕[1]

HiRDB Dataextractorのインストール〔UNIX〕[1]

HiRDB Dataextractorのインストール〔Windows〕[1]

HiRDB Dataextractorの環境変数情報設定ファイル[1]

HiRDB Dataextractorの環境変数情報設定ファイルの設定[1]

HiRDBからのデータ抽出時のアクセスエラー[1]

HiRDBへのデータ反映時のアクセスエラー[1]

HP-UX[1]

L

LANG[1]

LD_LIBRARY_PATH[1]

LIBPATH[1]

Linux[1]

Linuxの機能差異[1]

LOB入力ファイル[1]、[2]

LOB入力ファイル格納用ディレクトリ[1]、[2]

LOB入力ファイル格納用ディレクトリ名[1]

LOW[1]

N

NOCODECONV[1]

NULLELM[1]

NUM[1]

O

ODBC[1]

ODBC環境の設定[1]

Oracle[1]

ORACLE[1]

ORACLEからのデータ抽出時のアクセスエラー[1]

ORDER BY句〔SELECT文〕[1]

OSI使用時のHiRDB Dataextractorの開始と終了[1]

P

PATH[1]

PDBLKF[1]

PDCLTPATH[1]

PDCONFPATH[1]

PDDIR[1]

PDFESHOST[1]

PDHOST[1]

pdload[1]

pdloadコマンドのパラメタ指定[1]

pdloadコマンドライン情報ファイル[1]

pdloadコマンドライン情報ファイルの設定[1]

pdload制御情報ファイルsource文情報ファイル[1]

pdloadの実行結果[1]

PDNAMEPORT[1]

PDSERVICEGRP[1]

PDSQLTRACE[1]

PDUSER[1]

PXTCNTL[1]、[2]

R

RDエリア単位の格納[1]

S

SELECT文の選択式[1]、[2]

SELECT文の選択式（ROW指定）[1]

SGMLTEXT型[1]、[2]

SHLIB_PATH[1]

SJISからEUCへの文字コード変換[1]

SJISからUTF-8への文字コード変換[1]

SJISからUTF-16への文字コード変換[1]

Solaris[1]

Solarisの機能差異[1]

SPACE[1]

SQL Server[1]、[2]

SQLトレースファイル[1]

T

T_selector[1]

TCP/IP使用時のHiRDB Dataextractorの開始と終了[1]

TZ[1]

U

UTF-8からSJISまたはEUCへの文字コード変換[1]

UTF-16からEUCへの文字コード変換[1]

UTF-16からSJISへの文字コード変換[1]

UTF-16からUTF-8への文字コード変換[1]

UTF-8からUTF-16への文字コード変換[1]

W

WHERE句〔SELECT文〕[1]

Windows [1]

Windowsの機能差異[1]

X

XDM/RD[1]

XDM/XT[1]

XML型[1]、[2]

XTARRAY[1]

XTCCNVDMPSIZE[1]

XTCLMxxxx[1]

XTCNDSKP[1]

XTCSETUSE[1]

XTDATALOCALE[1]

XTDATAUNDEF[1]

XTDATCRLF[1]

XTDATENCLOSE[1]

XTDATSEPARATER[1]

XTDPERMIT[1]

XTENDSPACE[1]

XTERRLEVEL[1]

XTEXTRACTDB[1]

XTFESHOST[1]

XTFILESIZE[1]

XTFPERMIT[1]

XTHOST[1]

XTLCKxxxx[1]

XTLOBBUFSIZE[1]

XTLOBKIND[1]

XTLOCALE[1]

XTLOGNAME[1]

XTLOGRETRY[1]

XTLPRMxxxx[1]

XTNLDFLT[1]

XTOPNWTIME[1]

XTORANCSET[1]

XTORAUSER[1]

XTOSIWTIME[1]

XTPCHKTIME[1]

XTPDCFPATH[1]

XTPDCFxxxx[1]

XTPDSRxxxx[1]

XTPORTNO[1]

xtrepO[1]、[2]

xtrepOコマンドのオプションの組み合わせ[1]

xtrepS[1]、[2]

xtrepSコマンドのオプション組み合わせ[1]

xtrepコマンド[1]、[2]

xtrepコマンドのオプションの組み合わせ[1]

XTSQL[1]

XTSQLDSN[1]

XTSQLNCSET[1]

XTSQLUSER[1]

xtstartコマンド実行シェル（任意のファイル名）[1]

XTSTRETRY[1]

XTTBLxxxx[1]

XTTCPWTIME[1]

XTTEMPNAM[1]

XTTMPDIR[1]

XTTRCDIR[1]

XTUNDEF[1]

XTUTF8UCS4CHK[1]

XTWHExxxx[1]

XTWRTWTIME[1]

XTXBUFKIND[1]

XTXHOST[1]

Z

ZERO[1]

あ

アンインストール〔UNIX〕[1]

アンインストール〔Windows〕[1]

い

一括出力ページ数（−nオプション）[1]、[2]

インストール〔UNIX〕[1]

インストール〔Windows〕[1]

インストール時に登録されるサービス〔Windows〕[1]

インデクス作成方法（−iオプション）[1]、[2]

う

運用手順[1]

え

エラーログファイル[1]、[2]、[3]

エラーログファイル名[1]

お

オプション[1]

オプションフラグ[1]

か

回線障害または相手システムによるコネクション断[1]

環境の設定手順[1]

環境変数[1]

環境変数情報設定ファイル[1]

環境変数情報設定ファイルの設定[1]

環境変数情報設定ファイル名[1]

環境変数の設定[1]

環境変数の設定方法[1]

き

行単位インタフェースでの抽出[1]

く

繰返し列[1]

け

経過メッセージ出力間隔[1]

こ

コマンドの記述形式[1]

コマンド引数[1]

コマンド名[1]

さ

作成するファイルの形式[1]

作成するファイルの文字コード[1]

作成するファイル名の指定[1]

し

シェルスクリプトの実行[1]

シェルスクリプトファイル名[1]

システムコールエラー[1]

システムログファイル[1]

実行例の環境[1]

自動開始[1]

自ホストのTセレクタ値[1]

出力ファイル[1]、[2]、[3]、[4]

出力ファイルの作成[1]

出力ファイル名[1]

出力リスト〔データの抽出時の出力リスト〕[1]

出力リスト〔データの反映時の出力リスト〕[1]

手動開始[1]

初期値[1]

せ

制御プロセス[1]

セパレータ文字[1]

選択式[1]

選択式（ROW指定）[1]

ち

抽出したデータのデータ型変換[1]

抽出したデータの文字コード変換[1]

抽出したデータヘの任意の列の追加[1]

抽出時の規則[1]

抽出する行の選択，並べ替え[1]

抽出する列の選択，並べ替え[1]

抽出データの格納方式（−dオプション）[1]

抽象データ型[1]

抽象データ型関数[1]、[2]

つ

通信構成定義情報ファイル[1]、[2]

通信構成定義情報ファイルの設定[1]

通信構成定義情報ファイル名[1]

て

定数値[1]

データ型[1]

データ型の変換[1]

データ型変換中のオーバフローエラー[1]

データ形式[1]

データ抽出側のHiRDB Dataextractorの開始と終了[1]

データ抽出時のSQLユーザ指定機能[1]

データ転送の準備[1]

データの抽出時の出力リスト[1]

データの反映時の出力リスト[1]

データの反映方法の指定[1]

データ反映側，及びファイル作成側のHiRDB Dataextractorの開始と終了[1]

データベース作成ユティリティ[1]

な

内部矛盾[1]

長さ０のデータの格納（−zオプション）[1]

ナル値[1]

ナル値情報ファイル[1]、[2]、[3]

ナル値情報ファイル名[1]

ナル値の既定値[1]

ナル値の既定値の選択[1]

ナル値反映方法[1]

に

入力ファイル作成プロセス[1]

認可識別子[1]、[2]

は

排他情報ファイル[1]

排他制御[1]

バイナリ形式[1]

反映先ホスト名[1]

反映時の規則[1]

反映情報ファイル[1]

反映情報ファイル名[1]

ひ

必要なデータの抽出[1]

非ナル値制約[1]

表式記述ファイル[1]、[2]、[3]

表式記述ファイル名[1]、[2]

表識別子[1]、[2]

表単位の格納[1]

表の準備[1]

表名情報ファイル[1]

表名情報ファイルの設定[1]

ふ

ファイルの作成[1]

ファイル名の決定方法〔LOB入力ファイル〕[1]

ファイル名の決定方法〔LOB入力ファイル格納用ディレクトリ〕[1]

ファイル名の決定方法〔出力ファイル〕[1]

フィールド番号[1]

フラグ引数[1]

フロントエンドサーバ名[1]

へ

変換できる文字コード[1]

変換できる文字コードの範囲[1]

ほ

ポート番号[1]

め

メッセージの形式[1]

メッセージの出力先[1]

メッセージの見方[1]

メモリ所要量[1]

メモリ不足[1]

も

文字コードの変換[1]

文字コード変換機能[1]

文字コード変換の対象となるデータ型[1]

文字集合[1]

文字集合データの抽出，反映[1]

れ

列名[1]

列名記述ファイル[1]、[2]、[3]、[4]

列名記述ファイル名[1]

ろ

ローダのパラメタユーザ任意指定機能[1]

ログ取得方式（−lオプション）[1]、[2]