2.23.1　pdconfchkの形式と規則

(1)　機能

HiRDBを開始するために必要な，システム定義の内容をチェックします。

システム定義が誤っている場合は，誤りの箇所及び詳細を表示します。

ページの先頭へ

(2)　実行者

HiRDB管理者が実行できます。

ページの先頭へ

(3)　形式

　pdconfchk 〔-d サブディレクトリ名〕 〔-n〕 

ページの先頭へ

(4)　オプション

ページの先頭へ

(5)　チェックする内容

• 文法のチェック

文法チェックの結果は標準出力又は標準エラー出力に出力されます。

• システムファイルのチェック

システムログファイル，シンクポイントダンプファイル，及びステータスファイルの有無をチェックします。

• アクセス権限のチェック

次のことをチェックします。

• HiRDB管理者がHiRDBファイルをアクセスできるかどうか

• システム定義のpd_tmp_directoryオペランドで指定したディレクトリの有無，及びHiRDB管理者がアクセスできるかどうか

  ただし，pd_tmp_directoryオペランドを省略した場合はチェックしません。

• システムファイルの重複指定チェック

システムログファイル，シンクポイントダンプファイル，及びステータスファイルが重複していないかどうかをチェックします。

• ホストのチェック

ホスト名がHOSTSファイルに記述されているかどうかをチェックします。

• サーバマシン間のチェック（HiRDB/パラレルサーバの場合）

システムマネジャのサーバマシンを基準に，サーバマシン間のチェックをします。

pdconfchkコマンドでチェックできるシステム定義のオペランドについては，マニュアル「HiRDB Version 9 システム定義」の「pdconfchkコマンドでチェックできるオペランド」を参照してください。

ページの先頭へ

(6)　規則

1. pdconfchkコマンドは，HiRDBの稼働に関係なく実行できます。

2. pdconfchkコマンドは，シングルサーバ又はシステムマネジャがあるサーバマシンで実行してください。

ページの先頭へ

(7)　注意事項

1. 正常終了時は，KFPS05007-I return code=0を出力し終了します。正常終了以外の場合には，KFPS05007-I return code=4（警告），又はKFPS05007-I return code=8（エラー）の終了メッセージの前に原因となるメッセージを出力します。

2. サーバマシン間のチェックで，コメント部分（#以降の部分），及びコメントだけの行はエラー検知の対象としません。

3. サーバマシン間のチェックでエラーがあった場合，システムマネジャがあるサーバマシンのシステム定義の内容も見直してください。システムマネジャがあるサーバマシンのシステム定義の内容が誤っていることもあります。

4. サーバマシン間のチェックで，定義文の前方及び文中にあるタブとスペースはチェック対象となります。定義文の後方にあるタブとスペースはチェック対象外となります。

5. サーバマシン間のチェックで，システムマネジャとシステムマネジャ以外の定義の順番が同じでない場合，順番の異なる定義を誤りとします。

   (例)
   システムマネジャの定義　　　システムマネジャ以外の定義
   　　A　　　　　　　　　　　　　 B
   　　B　　　　　　　　　　　　　 A

   この場合，システムマネジャの定義Bとシステムマネジャ以外の定義Bを，Different definitionとして表示します。

6. pdconfchkコマンドでKFPY01012-Eメッセージが出力された場合，pdconfchkコマンドはKFPS05007-I return code=0で終了することがあります。この場合，エラーメッセージの原因を取り除いてください。

7. pdconfchkコマンドを実行してKFPS05062-Wメッセージが出力された場合でも，pdconfchkコマンドはKFPS05007-I（return code=0）で終了します。

8. pdconfchkコマンドが正常に動作した場合でも，KFPO00107-Eメッセージが出力されることがあります。pdconfchkコマンドでの定義チェックの結果はKFPS05007-Iメッセージで確認してください。

9. 系切り替え機能を使用している場合，指定しているオプションによってpdconfchkコマンド実行時にチェック対象となる系が異なります。

   -dオプション以外を指定している場合

   実行系がチェック対象となります。ただし，HiRDBシステムが停止している又は定義エラーなどによって実行系かどうかを判別できないときは現用系がチェック対象になります。

   -dオプションを指定している場合

   現用系がチェック対象となります。

ページの先頭へ

(8)　出力形式

＜システムファイルの有無チェック，アクセス権限のチェック＞
 [aa...a]
  bbbb    cc...c    dd...d    ee...e
＜システムファイルの重複指定チェック＞
 [aa...a]
  bbbb    cc...c    dd...d    ee...e
  bbbb    cc...c    dd...d    ee...e
＜ホストのチェック＞
 [aa...a]
  bbbb    cc...c    dd...d    ff...f
＜サーバマシン間のチェック(HiRDB/パラレルサーバの場合)＞
 [aa...a]
 <gggg:hhhh>
  gggg;  cc...c;  line = iii <- hhhh;  cc...c;  nothing
  gggg;  cc...c;  nothing    -> hhhh;  cc...c;  line = iii

［説明］

aa...a：

チェックした項目のエラーの内容

File not found：

ファイルがありません。次のどちらかの原因が考えられます。

• パス名に使用できない文字を指定しています。

• HiRDBファイル名の長さが制限（30文字）を超えました。

Directory not found：

ディレクトリがありません。次のどちらかの原因が考えられます。

• パス名に使用できない文字を指定しています。

• システム定義のpd_tmp_directoryオペランドに指定したディレクトリがありません。

File invalid：

ファイルが不正です。

Directory invalid：

ディレクトリが不正です。ドライブ直下のディレクトリ（例：C:\）を指定している場合は，別のディレクトリを指定してください。

No Permission：

権限がありません。

Duplicate filename：

ファイル名が重複しています。

Hosts name not matched：

ホスト名が一致しません。

Different definition：

システムマネジャとシステムマネジャ以外のユニットで異なる定義があります。

bbbb：

ユニット識別子

cc...c：

システム定義のファイル名

dd...d：

オペランドの指定内容

ee...e：

dd...dのオペランドで指定しているファイル名（絶対パス名）

ff...f：

dd...dがpdstart，pdunit，又はpd_hostnameの場合に，定義されているホスト名

gggg：

システムマネジャがあるユニットのユニット識別子

hhhh：

システムマネジャ以外のユニットのユニット識別子

iii：

システム定義のファイルの行番号

＜出力例＞

[File not found]
 unt1   pdutsys   pd_syssts_file_name_1              c:\hirdb\rdsys011\ut1sts1a ....1
[File invalid]
 unt1   pdutsys   pd_syssts_file_name_3              c:\hirdb\yyy\pddir ............2
[No permission]
 unt1   bes1      pd_sts_file_name_1                 c:\hirdb\rdsys011\bes1sts1a ...3
[Duplicate filename]
 unt1   fes1      pdlogadpf -d sys -g fes1log1 -a    c:\hirdb\rrdsys011\fes1log1 ...4
 unt1   fes1      pdlogadpf -d sys -g fes1log1 -b    c:\hirdb\rrdsys011\fes1log1 ...4
 unt1   bes1      pdlogadpf -d spd -g bes1spd1 -a    c:\hirdb\rrdsys011\fes1log1 ...4
[Hosts name not matched]
 unt1   pdsys     pdstart -x                         dcm3500 .......................5
[Different definition]
<unt1:unt2>
 unt1   pdsys    line = 2   -> unt2   pdsys   nothing ..............................6
 unt1   pdsys    nothing    <- unt2   pdsys   line = 5 .............................7

［説明］

1. unt1のpdutsysにあるpd_syssts_file_name_1オペランドに指定したファイルが見付かりません。

2. unt1のpdutsysにあるpd_syssts_file_name_3オペランドに指定したファイルが不正です。

3. unt1のbes1にあるpd_sts_file_name_1オペランドに指定したファイルにアクセス権限がありません。

4. unt1のfes1にあるpdlogadpf -d sys -g fes1log1オペランドの-aに指定しているファイル名と，次のファイル名が重複しています。

   • unt1のfes1にあるpdlogadpf -d sys -g fes1log1オペランドの-bに指定しているファイル名

   • unt1のbes1にあるpdlogadpf -d spd -g bes1spd1オペランドの-aに指定しているファイル名

5. unt1のホスト名と，unt1のpdsysにあるpdstart -x dcm3500オペランドで指定しているホスト名の設定が異なっています。

6. unt1のpdsysの2行目の定義が，unt2のpdsysにはありません。

7. unt2のpdsysの5行目の定義が，unt1のpdsysにはありません。

ページの先頭へ

(9)　使用例

運用中のHiRDB/パラレルサーバ（ユニット1，ユニット2の構成）のシステム定義を変更します。変更するHiRDBシステム定義ファイルはユニット1のpdsvrcとします。

1. ユニット1とユニット2の%PDDIR%\conf下と%PDCONFPATH%下にサブディレクトリ「chk」を作成します。

2. 各ユニットで，%PDDIR%\conf下のpdutsysを%PDDIR%\conf\chk\にコピーします。

3. 各ユニットで，%PDCONFPATH%下のHiRDBシステム定義ファイルを%PDCONFPATH%\chk\にコピーします。

4. ユニット1の%PDCONFPATH%\chk\pdsvrcの定義内容を変更します。

5. 「pdconfchk -d chk」を実行します。^※

6. 内容に問題がなければ，pdstopコマンドでHiRDBを正常終了又は計画停止します。ただし，計画停止の場合は，変更できない定義があるため注意してください。

7. pdlogunldコマンドで，「アンロード待ち状態」のシステムログファイルをアンロードします。

8. 4.で変更したHiRDBシステム定義ファイルを%PDCONFPATH%下にコピーします。

9. pdstartコマンドでHiRDBを正常開始します。

注※

「pdconfchk -d chk」実行時に，チェックするHiRDBシステム定義ファイルの場所は次のようになります。

ページの先頭へ