DELETE 時
2.6 文書検索プラグインのユーザ環境設定
2.6.1 SGML プラグインの環境設定 (1) 環境情報の定義方法
SGML プラグインの環境情報を設定するファイルを環境定義ファイルといいます。環境定義ファイルは，
プラグインごとに作成します。SGML プラグインの環境定義ファイルは，サンプルファイルとして提供さ れています。
SGML プラグインの環境情報を設定できる単位を次に示します。
•
システム単位
システム単位に定義情報を設定するユーザは，プラグインシステム定義情報ファイルを作成します。
作成するディレクトリおよびファイル名は次のとおりです。
•
UNIX の場合
$PDDIR/plugin/_phsgml/conf/pdplgsys
•
Windows の場合
%PDDIR%\plugin\_phsgml\conf\pdplgsys
•
ユニット単位
ユニット単位に定義情報を設定するユーザは，プラグインユニット定義情報ファイルを作成します。
作成するディレクトリおよびファイル名は次のとおりです。
•
UNIX の場合
$PDDIR/plugin/_phsgml/conf/pdplgutsys
•
Windows の場合
%PDDIR%\plugin\_phsgml\conf\pdplgutsys
•
サーバ単位（BES または SDS 単位）
各サーバ単位に定義情報を設定するユーザは，プラグインサーバ環境情報ファイルを作成します。
作成するディレクトリおよびファイル名は次のとおりです。
•
HiRDB/パラレルサーバの場合 UNIX の場合
$PDDIR/plugin/_phsgml/conf/BES名称
Windows の場合
%PDDIR%\plugin\_phsgml\conf\BES名称
•
HiRDB/シングルサーバの場合 UNIX の場合
$PDDIR/plugin/_phsgml/conf/SDS名称
Windows の場合
%PDDIR%\plugin\_phsgml\conf\SDS名称
優先順位は，サーバ単位＞ユニット単位＞システム単位です。
記述誤りなどが検出された場合，サーバは起動しますが，メッセージログに警告メッセージが出力され，
誤りのある定義ファイルは無視されます。環境定義ファイルがないか，環境定義ファイルはあるが設定さ れていない定義がある場合は，エラーではなく，定義値なしとして処理されます。最終的に有効な値がな い場合は，システムのデフォルトで動作します。
メッセージログに次のメッセージが出力されていないことを確認してください。
KFPY99999-I xxxx xxxx(xxxxx) 01001-W Invalid data found.file=aa,line=XX.bb(YY)
または
KFPY99999-I xxxx xxxx(xxxxx) 01002-W Invalid value found. file=aa,line=XX,item=bb.cc(YY)
SGML プラグインの環境定義ファイルの定義例を次の図に示します。
図 2‒40 SGML プラグインの環境定義ファイルの定義例
注意事項
• 各設定項目の行末は改行で区切ってください。
• 設定項目の途中を改行で区切らないでください。
• 1 行に設定できる文字列長は 1,023 バイトです。
• #（シャープ）以降は，コメント文として扱われます。
• 各行は，空行なしで詰めて記述してください。
• BOM（Byte Order Mark）は使用しないでください。BOM が含まれていた場合は，通常の文字と して扱います。
(2) 設定項目
SGML プラグインを動作させる環境情報を SGML プラグインの環境定義ファイルに定義することで，ユー ザごとの環境を設定できます。設定項目を次の表に示します。なお，設定項目には，ユーザごとに，必要 に応じて取得できる最大値を設定します。
表 2‒12 SGML プラグインの環境定義ファイルに設定できる定義項目
種別 環境設定項目 パラメタ 設定値 環境を設定できる
単位
登録・検索 登録・検索同時実行
指定
set phs_search_wait wait，nowait，または nowait_with_update デフォルト：wait
サーバ
登録 原文書データ保持
モード指定
set phs_txt_org Y または N デフォルト：Y
システム，ユニット，
サーバ 登録文書サイズ上限
値指定
set
phs_document_size_max
最大値：5,120 キロバ イト
最小値：1 キロバイト デフォルト：5,120 キ ロバイト
システム，ユニット，
サーバ
エラー処理 エラーコード詳細化
指定
set phs_errorcode_detail off または on デフォルト：off
システム，ユニット，
サーバ XML 出力 接頭辞 xml の小文字
変換指定
set
phs_change_xml_prefix
Y または N デフォルト：Y
システム，ユニット，
サーバ
登録・検索同時実行，または分割遅延登録・更新系 SQL 同時実行指定
登録・検索同時実行，または分割遅延登録・更新系 SQL 同時実行を使用するかどうかを指定します。
なお，この項目を設定できる単位は，サーバ単位だけです。
形式
set phs_search_wait=wait｜nowait｜nowait_with_update
• wait
同時実行を使用しない。
• nowait
登録・検索同時実行を使用する。
• nowait_with_update
登録・検索同時実行機能に加えて，分割遅延登録・更新系 SQL 同時実行を使用する。
原文書データ保持モード指定
登録テキストの原文をデータベースに保持するかどうかを指定します。原文書を保持しない場合，抽象 データ型関数 extracts を発行するときに，原文書出力機能を使用できなくなりますが，RD エリア使用 量を節約できます。
形式
set phs_txt_org=Y｜N
• Y
原文書を保持します。
• N
原文書を保持しません。
登録文書サイズ上限値指定
データベースに登録できる文書サイズの上限値を指定します。
形式
set phs_document_size_max=xxxx
エラーコード詳細化指定
SQL 連絡領域にメッセージが返却される場合に，エラーコードを詳細化モードで出力するかどうかを 指定します。
詳細モードで出力しない場合，SQLCODE=-997 のエラーとなります。詳細化モードで出力する場合，
Text Search Plugin のエラーコードが出力されます。エラーコードの詳細は「付録 F.1 SQL 連絡領
域に出力されるメッセージの形式」を参照してください。
形式
set phs_errorcode_detail=off｜on
• off
詳細化モードで出力しません。
• on
詳細化モードで出力します。
接頭辞 xml の小文字変換指定
extracts 関数の XML 出力で，属性名に英大文字の接頭辞"XML:"が付いている場合に英小文字の接頭 辞"xml:"に変換するかどうかを指定します。
形式
set phs_change_xml_prefix=Y｜N
• Y
英小文字の接頭辞"xml:"に変換します。
• N
英小文字の接頭辞"xml:"に変換しません。
(3) 有効範囲
環境定義ファイルに定義した環境情報は，サーバ開始から終了まで有効です。HiRDB 稼働中に環境情報を 変更した場合は，正しく動作しない場合がありますので，変更しないでください。