Hitachi

ノンストップデータベース HiRDB Version 10 UAP開発ガイド


6.6.3 クライアント環境定義の一覧

クライアント環境定義の一覧を次の表に示します。なお,各環境変数の詳細は「クライアント環境定義の設定内容」を参照してください。

●必ず指定する環境変数

太字表示されている環境変数は,HiRDBシステムの環境に関係なく必ず指定してください。太字表示以外の環境変数については,それぞれのHiRDBシステムの環境に合わせて指定してください。

表6‒29 クライアント環境定義の一覧

環境変数名

機能

環境変数の分類

PDHOST

接続するHiRDBサーバのホスト名を指定します。

システム構成※3

PDNAMEPORT

HiRDBサーバのポート番号を指定します。

PDFESHOST

フロントエンドサーバのホスト名を指定します。

PDSERVICEGRP

シングルサーバ又はフロントエンドサーバのサーバ名を指定します。

PDSRVTYPE

HiRDBサーバの種別を指定します。

PDSERVICEPORT

高速接続用のポート番号を指定します。

PDFESGRP

高速接続をする場合,接続するFESグループを指定します。

PDCLTRCVPORT

クライアントの受信ポート番号を指定します。

PDCLTRCVADDR

クライアントのIPアドレス又はホスト名を指定します。

PDTMID

複数のOLTPから一つのHiRDBサーバをアクセスする場合,それぞれのOLTPにユニークな識別子を指定します。

OLTP下のX/Openに従ったAPIを使用するクライアント※1

PDXAMODE

OLTPシステムと連携する場合に,トランザクションの移行機能を使用するかしないかを指定します。

PDTXACANUM

X/Openに従ったAPIを使用したUAPから同時実行する,最大トランザクション数を指定します。

PDXARCVWTIME

トランザクションが回復できない場合の待ち合わせ時間を指定します。

PDXATRCFILEMODE

X/Openに従ったAPIを使用した接続形態での,各種トレースファイル名の形式を指定します。

PDXAAUTORECONNECT

TP1/EEとの連携の場合に,自動再接続をするかどうかを指定します。

HiRDB_PDHOST

接続するHiRDBサーバのホスト名を指定します。

HiRDB_PDNAMEPORT

HiRDBサーバのポート番号を指定します。

HiRDB_PDTMID

複数のOLTPから一つのHiRDBサーバをアクセスする場合,それぞれのOLTPにユニークな識別子を指定します。

HiRDB_PDXAMODE

OLTPシステムと連携する場合に,トランザクションの移行機能を使用するかしないかを指定します。

PDUSER※4※5

認可識別子,及びパスワードを指定します。UNIX環境の場合は,この環境変数を省略できます。

ユーザ実行環境

PDCLTAPNAME

HiRDBサーバに対してアクセスする,UAPの識別情報(UAP識別子)を指定します。

PDCLTLANG

プリプロセサが処理する,UAPの記述に使われている文字コード種別を指定します。

PDLANG

HiRDBサーバの文字コード種別をチェックする場合に,HiRDBサーバの文字コード種別を指定します。

PDDBLOG

UAPを実行するときに,データベースの更新ログを取得するかしないかを指定します。

PDEXWARN

サーバから警告付きのリターンコードを受け取るかどうかを指定します。

PDSUBSTRLEN

1文字を表現する最大バイト数を指定します。

PDCLTCNVMODE

HiRDBサーバとHiRDBクライアントの文字コード種別が異なる場合,文字コードを変換するかどうかを指定します。

PDCLTGAIJIDLL

ユーザ定義外字変換DLLファイルの名称を指定します。

PDCLTGAIJIFUNC

ユーザ定義外字変換関数の名称を指定します。

PDCLTCNVUOCLIB

UOCによる文字コード変換をする場合,UOCのライブラリファイルの名称を指定します。

PDCLTCNVUOCFUNC

UOCによる文字コード変換をする場合,UOCの文字コード変換関数の名称を指定します。

PDCLTCNVBYTERATIO

UOCによる文字コード変換をする場合,1文字当たりのバイト数の比率を指定します。

PDCLTGRP

クライアントグループの接続枠保証機能を使用する場合,クライアントグループ名を指定します。

PDAUTORECONNECT

自動再接続機能を使用するかどうかを指定します。

PDRCCOUNT

自動再接続機能でのCONNECTのリトライ回数を指定します。

PDRCINTERVAL

自動再接続機能でのCONNECTのリトライ間隔を指定します。

PDRCTIMING

自動再接続機能での再接続契機を指定します。

PDAUTHTYPE

HiRDBクライアントがサーバへ接続するときの認証方式を指定します。

PDUAPENVFILE

UAPを個別の環境で実行する場合,実行する環境を定義したUAP環境定義ファイルを指定します。

PDDBBUFLRU

UAPがアクセスしたページをグローバルバッファにキャッシュするときの処理に,LRU方式を適用するかどうかを指定します。

PDHATRNQUEUING

クライアントでトランザクションキューイング機能を使用しない場合に指定します。

PDCLTBINDLOOPBACKADDR

HiRDBサーバとの通信で使用する受信ポートの生成時,ループバックアドレスでbind()するかどうかを指定します。

PDEXTDECCHECK

外部10進項目の入力データのチェック有無を指定します。

PDDEFAULTOPTION

クライアント環境定義及びプリプロセスオプションについて,省略時の動作を指定します。

PDIPCFILEDIR

接続するHiRDBサーバの通信情報ファイルディレクトリを指定します。

PDASTHOST

UAP実行時に接続する,HiRDB Control Manager - Agentのホスト名を指定します。

UAPからのコマンド実行

PDASTPORT

UAP実行時に接続する,HiRDB Control Manager - Agentのポート番号を指定します。

PDSYSTEMID

UAP実行時に接続する,HiRDB Control Manager - Agentが管理するHiRDBサーバのHiRDB識別子を指定します。

PDASTUSER※5

コマンドを実行するOSのユーザ名,及びパスワードを指定します。

PDCMDWAITTIME

クライアントがHiRDB Control Manager - Agentへ要求をしてから応答が返るまでの,クライアントの最大待ち時間を指定します。

PDCMDTRACE

UAP実行時にコマンドトレースを出力する場合,そのファイルの大きさを指定します。

PDIPC

プロセス間の通信方法を指定します。

プロセス間メモリ通信機能

PDSENDMEMSIZE

プロセス間メモリ通信機能を使用する場合,クライアントからサーバへデータを送るときのデータ格納領域サイズを指定します。

PDRECVMEMSIZE

プロセス間メモリ通信機能を使用する場合,クライアントがサーバからデータを受け取るときのデータ格納領域サイズを指定します。

PDCWAITTIME※4

HiRDBクライアントからHiRDBサーバへ要求をしてから,応答が戻ってくるまでのHiRDBクライアントの最大待ち時間を指定します。

システム監視

PDSWAITTIME※4

HiRDBサーバがHiRDBクライアントからの要求に対する応答を返してから,次にHiRDBクライアントから要求が来るまでのHiRDBサーバの最大待ち時間を指定します。

この時間監視は,トランザクション処理中の時間を対象とします。

PDSWATCHTIME

HiRDBサーバがHiRDBクライアントからの要求に対する応答を返してから,次にHiRDBクライアントから要求が来るまでのHiRDBサーバの最大待ち時間を指定します。

この時間監視は,トランザクション処理以外の時間を対象とします。

PDCWAITTIMEWRNPNT

SQL実行時間警告出力機能使用時に,SQL実行時間警告情報ファイルを出力する契機を,HiRDBクライアントの最大待ち時間に対する比率,又は時間で指定します。

PDKALVL

HiRDBクライアントからHiRDBサーバに対して,定期的にパケットを送信する機能を使用するかどうかを指定します。

PDKATIME

HiRDBクライアントからHiRDBサーバに対して,定期的にパケットを送信する間隔を指定します。

PDTIMEDOUTRETRY

HiRDBクライアントがHiRDBサーバと接続する場合に実行する,connect()システムコールでETIMEDOUTエラーが発生したときに,connect()システムコールをリトライする回数を指定します。

PDCONREFRCOUNT

HiRDBクライアントがHiRDBサーバと接続する場合に実行する,connect()システムコールでECONNREFUSEDエラーが発生したときに,connect()システムコールをリトライする回数を指定します。

PDCONREFRINTERVAL

HiRDBクライアントがHiRDBサーバと接続する場合に実行する,connect()システムコールでECONNREFUSEDエラーが発生したときに,connect()システムコールをリトライする間隔を指定します。

PDNBLOCKWAITTIME

HiRDBサーバ,HiRDBクライアント間のコネクション接続完了を監視する場合,ノンブロックモード時のコネクション確立監視時間を指定します。

PDCONNECTWAITTIME

HiRDBサーバとの接続時,HiRDBサーバから応答が戻ってくるまでのHiRDBクライアントの最大待ち時間を指定します。

PDCLTPATH

HiRDBクライアントが作成するSQLトレースファイル及びクライアントエラーログファイルの格納先ディレクトリを指定します。

トラブルシュート

PDSQLTRACE

UAPのSQLトレースを出力するSQLトレースファイルのサイズを,バイト単位で指定します。

PDUAPERLOG

UAPのエラーログを出力するクライアントエラーログファイルのサイズを,バイト単位で指定します。

PDERRSKIPCODE

特定のクライアントエラーログを出力しない場合に指定します。

PDPRMTRC

SQLトレースにパラメタ情報及び検索データを出力するかどうかを指定します。

PDPRMTRCSIZE

SQLトレースに出力するパラメタ情報及び検索データの最大データ長を指定します。

PDTRCMODE

SQLトレース以外のトラブルシュート情報を出力するかどうかを指定します。

PDUAPREPLVL

UAP統計レポートの出力情報を指定します。

PDREPPATH

PDCLTPATHで指定したディレクトリとは別のディレクトリに,UAP統計レポートを出力するかどうかを指定します。

PDTRCPATH

動的SQLトレースファイルの格納先ディレクトリを指定します。

PDSQLTRCOPENMODE

PDREPPATHを指定している場合,SQLトレースファイルのオープンモードを指定します。

PDSQLTEXTSIZE

SQLトレースに出力するSQL文のサイズを指定します。

PDSQLEXECTIME

SQLトレースにSQL実行時間を出力するかどうかを指定します。

PDRCTRACE

UAPの再接続トレースを出力するファイルのサイズを指定します。

PDWRTLNPATH

WRITE LINE文の値式の値を出力する,ファイルの格納先ディレクトリを指定します。

PDWRTLNFILSZ

WRITE LINE文の値式の値を出力する,ファイルの最大サイズを指定します。

PDWRTLNCOMSZ

WRITE LINE文の値式の値の合計サイズを指定します。

PDUAPEXERLOGUSE

拡張SQLエラー情報出力機能を使用するかどうかを指定します。

PDUAPEXERLOGPRMSZ

拡張SQLエラー情報出力機能を使用する場合,クライアントエラーログファイル及びSQLエラーレポートファイルに出力するパラメタ情報の最大データ長を指定します。

PDDNDPTRACE

ADO.NET 2.0に対応したHiRDBデータプロバイダ for .NET Frameworkで出力するメソッドトレースのファイルサイズを指定します。

PDSQLTRCFMT

SQLトレースの出力形式を指定します。

PDVWOPTMODE

アクセスパス情報ファイルを取得するかどうかを指定します。

アクセスパス表示ユティリティ用アクセスパス情報ファイル

PDTAAPINFPATH

アクセスパス情報ファイルをHiRDBクライアント側に出力する場合に,出力先ディレクトリを指定します。この指定がない場合は出力しません。

HiRDB SQL Tuning Advisor用アクセスパス情報ファイル

PDTAAPINFMODE

アクセスパス情報ファイルをHiRDBクライアント側に出力する場合に,アクセスパス情報ファイルのファイル名の形式を指定します。

PDTAAPINFSIZE

アクセスパス情報ファイルをHiRDBクライアント側に出力する場合に,アクセスパス情報ファイルのファイルサイズを指定します。

PDSTJTRNOUT

UAPに関する統計情報を,トランザクションごとに統計ログファイルに出力するかどうかを指定します。

UAPに関する統計情報の出力単位

PDLOCKLIMIT

一つのサーバに対してUAPから発行する排他要求の上限値を指定します。

排他制御

PDDLKPRIO

UAPのデッドロックプライオリティ値を指定します。

PDLOCKSKIP

無排他条件判定をするかどうかを指定します。

PDFORUPDATEEXLOCK

FOR UPDATE句を指定した(又は仮定された)SQLの排他オプションに,WITH EXCLUSIVE LOCKを適用するかどうかを指定します。

PDISLLVL

SQL文のデータ保証レベルを指定します。

SQL関連

PDSQLOPTLVL※5

データベースの状態を考慮して,最も効率的なアクセスパスを決定するための最適化の方法(SQL最適化オプション)を指定します。

PDADDITIONALOPTLVL※5

データベースの状態を考慮して,最も効率的なアクセスパスを決定するための最適化の方法(SQL拡張最適化オプション)を指定します。

PDHASHTBLSIZE

SQLの最適化で,ハッシュジョイン,副問合せのハッシュ実行を適用する場合,ハッシュ表サイズを指定します。

PDDFLNVAL

表中のデータを埋込み変数に取り出す場合,取り出した値がナル値のときに埋込み変数に既定値を設定するかどうかを指定します。

PDAGGR

GROUP BY処理に使用するメモリ量を決定するため,サーバごとに発生するグループ数の最大値を指定します。

PDCMMTBFDDL

操作系SQLを実行していたトランザクションで定義系SQLを実行する場合,自動的にコミットしてから定義系SQLを実行するかどうかを指定します。

PDPRPCRCLS

開いているカーソルで使用しているSQL識別子を再度PREPARE文で使用する場合,開いているカーソルを自動的にクローズするかどうかを指定します。

PDAUTOCONNECT

HiRDBと接続していない状態でSQL文を実行した場合,自動的に接続するかどうかを指定します。

PDDDLDEAPRPEXE

先行トランザクションの前処理結果を無効にし,定義系トランザクションの実行を優先します。

PDDDLDEAPRP

閉じているホールダブルカーソルで使用している表の定義情報を,トランザクション間に他UAPからの変更を許可するかどうかを指定します。

PDLCKWAITTIME

排他要求が待ち状態になってから,解除されるまでを監視する最大時間を指定します。

PDCURSORLVL

カーソルを使用した検索をする場合に,HiRDBサーバに対してのカーソルオープン・クローズの要求を,自動で行うかどうかを指定します。

PDDELRSVWDFILE

SQL予約語削除機能を使用する場合に,SQL予約語削除ファイル名を指定します。

PDCALCMDWAITTIME

CALL COMMAND文によってコマンド,又はユティリティを開始してから終了するまでの,HiRDBクライアントの最大待ち時間を指定します。

PDSTANDARDSQLSTATE

SQLSTATEの値を詳細に出力するかどうかを指定します。

PDBLKF

HiRDBサーバからHiRDBクライアントに検索結果を転送するときの,一回の転送処理で送られる行数を指定します。

ブロック転送機能

PDBINARYBLKF

定義長が32,001バイト以上のBINARY型の選択式がある表を検索する場合,ブロック転送機能を適用するかどうかを指定します。

PDBLKBUFFSIZE

ブロック転送機能で使用する,サーバ,クライアント間の通信バッファのサイズを指定します。

PDBINDRETRYCOUNT

UNIXドメインでのbindシステムコールでEADDRINUSEが返却された場合のリトライ回数を指定します。

HiRDBの通信処理

PDBINDRETRYINTERVAL

UNIXドメインでのbindシステムコールでEADDRINUSEが返却された場合のリトライ間隔を指定します。

PDDBACCS

インナレプリカ機能を使用している場合,カレントRDエリアではないRDエリアをアクセスしたいときに,そのRDエリアの世代番号を指定します。

インナレプリカ機能

PDDBORGUAP

オンライン再編成閉塞のオリジナルRDエリアに対してUAPを実行する場合に指定します。

更新可能なオンライン再編成

PDSPACELVL

データの格納,比較,及び検索時の,空白変換レベルを指定します。

データの空白変換

PDCLTRDNODE

XDM/RD E2接続機能使用時に,接続するXDM/RD E2のデータベース識別子を指定します。

XDM/RD E2接続機能

PDTP1SERVICE

XDM/RD E2接続機能使用時に,XDM/RD E2にOpenTP1のサービス名を通知するかどうかを指定します。

PDRDCLTCODE

XDM/RD E2接続機能使用時に,クライアントで使用する文字コード種別を指定します。

PDCNSTRNTNAME

参照制約,及び検査制約を定義する場合,制約名定義の位置を指定します。

参照制約及び検査制約

PDTMPTBLRDAREA※5

一時表及び一時インデクスを格納するRDエリアの候補を指定します。

一時表

PDBESCONHOLD

バックエンドサーバ接続保持機能を使用するかどうかを指定します。

バックエンドサーバ接続保持機能

PDBESCONHTI

バックエンドサーバ接続保持機能を使用する場合,バックエンドサーバ接続保持期間を指定します。

PDODBSTATCACHE

ODBC関数のSQLColumns()関数,SQLStatistics()関数で,1度発行して取得したカラム情報,又はインデクス情報をキャッシュするかどうかを指定します。

ODBC関数

PDODBESCAPE

カタログ系のODBC関数の検索で,パターン文字列に対してESCAPE文字('&')を指定するかどうかを指定します。

PDGDATAOPT

ODBC関数のSQLGetData関数で,データを取得済みの列に対して,繰り返しデータを取得する場合に指定します。

PDODBLOCATOR

DBアクセス部品を使用して,BLOB型,又はBINARY型の列を検索する場合に,位置付け子機能を使用してデータを分割取得するかどうかを指定します。DBアクセス部品とは,ODBCドライバ,OLE DBプロバイダ,及びHiRDBデータプロバイダ for .NET Frameworkを示します。

PDODBSPLITSIZE

PDODBLOCATOR=YESを指定している場合,分割取得のサイズを指定します。

PDODBCWRNSKIP

ODBC,OLE DB接続時のワーニングを回避するかどうかを指定します。

PDJETCOMPATIBLE

ODBC3.5ドライバを,ODBC3.5の規格ではなくMicrosoft Access互換モードで動作させるかどうかを指定します。

PDODBGINFOSUPPRESS

ODBC関数のSQLGetInfoW()関数使用時に発生するエラーを回避するために指定します。

PDODBSTANDARDARGSIZE

64ビットモードで動作するODBC3.5ドライバについて,一部のODBC関数の引数に指定されたポインタが指すバッファを4バイト整数として扱うか,8バイト整数として扱うかを指定します。

PDODBSTANDARDSQLSTATE

ODBC3.5ドライバからODBC規格に準拠したSQLSTATEを返却するかどうかを指定します。

PDODBSTANDARDDESCCOL

ODBC3.5ドライバでのSQLDescribeCol関数の実行時に,ODBC規格に準拠した値を返却するかどうかを指定します。

PDODBSTANDARDGTYPEINFO

ODBC3.5ドライバのSQLGetTypeInfo関数で,ODBC規格に準拠した値を返却するかどうかを指定します。

PDPLGIXMK

プラグインインデクスの遅延一括作成を使用するかどうかを指定します。

プラグイン

PDPLUGINNSUB※2

詳細については,各プラグインマニュアルを参照してください。

PDPLGPFSZ

プラグインの遅延一括作成用のインデクス情報ファイルの初期容量を指定します。

PDPLGPFSZEXP

プラグインの遅延一括作成用のインデクス情報ファイルの増分値を指定します。

PDHSICOPTIONS

HSICを使用する運用の場合に,HSICで集積する情報を指定します。

HSIC限定

PDJDBFILEDIR

Type4 JDBCドライバでのExceptionトレースログ及び不正電文トレースのファイル出力先を指定します。

JDBCドライバ

PDJDBFILEOUTNUM

Type4 JDBCドライバでのExceptionトレースログのファイルへの出力数を指定します。

PDJDBONMEMNUM

Type4 JDBCドライバでのExceptionトレースログのメモリ内取得情報数を指定します。

PDJDBTRACELEVEL

Type4 JDBCドライバでのExceptionトレースログのトレース取得レベルを指定します。

PDJDBFILESIZE

Type4 JDBCドライバでのExceptionトレースログの最大ファイルサイズを指定します。

PDDNDPCOMPATIBLE

ADO.NET2.0に対応したHiRDBデータプロバイダ for .NET Frameworkのメソッドが,.NET Frameworkの規格に準拠した仕様とするか,又はHiRDB独自の仕様とするかを指定します。

ADO.NET

注※1

OLTP下のX/Openに従ったAPIを使用して,HiRDBサーバをアクセスするクライアントの場合だけ指定します。そのほかの場合は,指定しても無効になります。

各環境変数が必要かどうかについては,「OLTP下のX/Openに従ったAPIを使用したUAPをクライアントとする場合の指定方法」を参照してください。

なお,複数接続機能を使用する場合,接続先ごとに環境変数のグループ登録をしても,環境変数の指定値は無効になります。

注※2

プラグイン用に設定する環境変数です。この環境変数の設定内容については,クライアントライブラリではチェックされません。また,SQLトレースにも情報は出力されません。

注※3

システム構成に関する環境変数には,HiRDBサーバと接続するときに必要な情報を指定します。HiRDBサーバとの接続形態によっては,環境変数が指定できたりできなかったりします。HiRDBサーバとの接続形態については,「HiRDBサーバと接続するための環境変数と接続形態との関係」を参照してください。

注※4

CALL COMMAND文のENVIRONMENTオペランドに指定できます。

注※5

指定値に引用符( " )で囲む値を含む場合の注意事項を次に示します。

  • UNIXのシェルでOS環境変数にこのクライアント環境変数を指定する場合は,指定値全体をアポストロフィ( ' )で囲む必要があります。

    sh(ボーンシェル)での指定例

    export PDTMPTBLRDAREA=’”rdtmp01”,”rdtmp02”’

  • HiRDBへの接続時に使用するHiRDB.ini,又は環境変数グループ(ファイル登録)にこのクライアント環境変数を指定する場合は,指定値全体をアポストロフィ( ' )で囲む必要があります。ただし,Type4 JDBCドライバを使用する場合,その必要はありません。

    なお,環境変数グループ(レジストリ登録)にこのクライアント環境変数を指定する場合は,指定値をアポストロフィ( ' )で囲むとエラーになります。

    HiRDB.iniでの指定例

    PDTMPTBLRDAREA=’”rdtmp01”,”rdtmp02”’

  • UNIXのシェルでJavaの-Dオプションにこのクライアント環境変数に対応するシステムプロパティを指定する場合は,指定値全体をアポストロフィ( ' )で囲む必要があります。

    Javaコマンドでの指定例

    java -DHiRDB_for_Java_PDTMPTBLRDAREA=

    ’”rdtmp01”,”rdtmp02”’ sample

  • WindowsのコマンドプロンプトでJavaの-Dオプションにこのクライアント環境変数に対応するシステムプロパティを指定する場合は,RDエリア名を\"で囲んで指定値全体を引用符( " )で囲む必要があります。

    Javaコマンドでの指定例

    java -DHiRDB_for_Java_PDTMPTBLRDAREA=

    \”rdtmp01\”,\”rdtmp02\”” sample