HiRDBファイルシステムにログ関係の物理ファイルを作成し，稼働中のHiRDBで使用できるように初期設定をします。

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

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

 
　pdloginit ｛-d sys 〔-s サーバ名〕
 
　　　　　　　　-f 物理ファイル名 -n HiRDBレコード数 〔-l レコード長〕
 
　　　　　　 ｜-d spd 〔-s サーバ名〕
 
　　　　　　　　-f 物理ファイル名 -n HiRDBレコード数｝
 

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

 
　pdloginit ｛-d sys -s サーバ名 〔-u ユニット識別子〕
 
　　　　　　　　-f 物理ファイル名 -n HiRDBレコード数 〔-l レコード長〕 〔-D〕
 
　　　　　　 ｜-d spd  -s サーバ名 〔-u ユニット識別子〕
 
　　　　　　　　-f 物理ファイル名 -n HiRDBレコード数 〔-D〕｝
 

• -d sys|spd

初期設定をするログ関係のファイルを指定します。

sys：

システムログファイル

spd：

シンクポイントダンプファイル

• -s サーバ名　〜＜識別子＞((1〜8))

ファイルグループに対応するサーバの名称を指定します。

• -f 物理ファイル名　〜＜パス名＞((167文字以内))

初期設定をする物理ファイルの名称を絶対パス名で指定します。物理ファイル名は，HiRDBファイルシステム領域名/HiRDBファイル名で指定してください。HiRDBファイル名は，HiRDBファイルシステム領域内で重複しないようにしてください。既に初期設定されているHiRDBファイル名を指定すると，エラーとなります。また，HiRDBファイル名にplで始まる名称は指定できません。

• -n HiRDBレコード数　〜＜符号なし整数＞((12〜104857600))

初期設定をするHiRDBファイルのレコード数を指定します。なお，ここでいうレコードとは，HiRDBファイルシステム上の次に示すサイズの領域のことです。

• -d sysの場合は，-lオプションで指定したレコード長
• -d spdの場合は，4,096バイト

＜指定範囲＞

HiRDBレコード数には，次に示す範囲の値を指定してください。

-d sysの場合

• 上限
  pd_large_file_useオペランドにNを指定しているとき：
  2147483648÷-lオプションの指定値
  pd_large_file_useオペランドにYを指定又は指定を省略しているとき：
  107374182400÷-lオプションの指定値
  
• 下限
  ↑(32000＋368＋3×4096)÷-lオプションの指定値↑＋1
  

-d spdの場合

12〜262144

＜指定値の目安＞

HiRDBレコード数の見積もりについては，マニュアル「HiRDB Version 8 システム導入・設計ガイド」を参照してください。

• -d sysの場合
  見積もったレコード数は総容量なので，作成するシステムログファイルの個数で割った値×1.2を目安にしてください。
  
• -d spdの場合
  見積もったレコード数×1.2を目安にしてください。
  

• -l レコード長　〜＜符号なし整数＞((1024〜4096))

システムログファイルとして初期設定するHiRDBファイルのレコード長を指定します。

このオプションは，システム定義変更前にシステムログファイルを作っておきたい場合や，レコード長を明示的に指定したい場合に指定します。

＜規則＞

1. レコード長は，HiRDBシステム定義のpd_log_rec_lengオペランドと同じ値にしてください。設定される値は次のようになります。
   
   • 指定値が1,024のときは1,024に設定されます。
   • 指定値が1,025〜2,048のときは2,048に設定されます。
   • 指定値が2,049〜4,096のときは4,096に設定されます。
   上記以外の値を指定するとエラーになります。
   
2. このオプションを省略すると，HiRDBシステム定義のpd_log_rec_lengオペランドに指定した値で初期設定します。pd_log_rec_lengオペランドと異なるレコード長で初期設定したファイルは，システムログファイルとしてオープンできません。
3. 指定するレコード長の目安として，統計情報から得られるシステムログファイルに出力した平均ブロック長を考慮してください。このオプションには，次のように指定することをお勧めします。
   
   • 平均ブロック長が1,024バイト以下の場合，1,024を指定してください。
   • 平均ブロック長が1,025〜2,048バイトの場合，2,048を指定してください。
   • 平均ブロック長が2,049バイト以上の場合，4,096を指定するか省略してください。
4. シンクポイントダンプファイルとして初期設定する場合，このオプションを指定するとエラーになります。また，HiRDBファイルシステムのセクタ長未満のレコード長を指定した場合もエラーになります。

• -u ユニット識別子　〜＜識別子＞((4文字))

影響分散スタンバイレス型系切り替え機能を適用している場合，ファイル作成先のディスクがあるホストの，ユニット識別子を指定します。

該当するサーバが稼働中の場合，-uオプションの指定は無視されます。

次のどれかに該当する場合に-uオプションを指定すると，エラーとなります。

• 指定するユニットが，-sオプションで指定したサーバの移動先となるHAグループに属していない。
• -sオプションで指定したサーバが，HAグループ内のサーバではない。
• 影響分散スタンバイレス型系切り替え機能を適用していない。

-uオプションの指定要否を次に示します。

• -D

pdchgconfコマンドでユニットの追加，又はサーバの追加をする場合に指定します。

ユニットの追加，又はサーバの追加をする場合に必要となる，システムログファイル又はシンクポイントダンプファイルの初期化をします。このオプションを指定した場合，サーバ名のチェックはしません。

このオプションを指定してpdloginitコマンドを実行する場合，作成するシステムログファイル又はシンクポイントダンプファイルがあるユニットで実行してください。

1. pdloginitコマンドは，HiRDBの稼働に関係なく実行できます（ただし，HiRDB開始処理中及びHiRDB終了処理中は除きます）。
2. pdloginitコマンドは，シングルサーバ又はシステムマネジャがあるサーバマシンで実行してください。
3. pdloginitコマンド実行時，環境変数のPDDIRにHiRDBディレクトリの環境変数と同じものが設定されていないと，コマンドエラーになったときにメッセージが出力されません。
4. キャラクタ型スペシャルファイル上にHiRDBファイルシステムを作成した場合，ファイルを作成するハードディスクのパーティションは，次のようにしてください。
   
   • 初期設定するファイルがシステムログファイルの場合(-d sysの場合)，ハードディスクのパーティションのセクタ長の整数倍が-lオプションで指定したレコード長になるようにしてください。
   • 初期設定するファイルがシンクポイントダンプファイルの場合(-d spdの場合)，ハードディスクのパーティションのセクタ長の整数倍が4,096になるようにしてください。
5. システムログファイルのレコード長は，各サーバのすべてのファイルで，HiRDBシステム定義のpd_log_rec_lengオペランドと同じ値を指定してください。

1. システムログファイルを二重化する場合，一つのログファイルグループを構成するA系とＢ系の物理ファイルは，レコード長とレコード数が同じになるように初期設定してください。
2. システムログファイルを二重化する場合，A系とB系の物理ファイルは障害発生に備えて，なるべく別々のハードディスクに作成してください。
3. pdloginitコマンドの結果は，コマンド実行時のリターンコード，又はエラーメッセージの有無で確認できます。コマンド実行時のリターンコードを次に示します。
   0：正常終了
   4：異常終了
   8：異常終了（オプション指定不正，rsh失敗など）
   12：異常終了（IPアドレス引き継ぎなし構成の待機系でリトライしたとき）
   
4. セクタ長が4,096バイトを超えるHiRDBファイルシステムには，ファイルを初期設定できません。
5. ログ同期方式のリアルタイムSANレプリケーションを適用している場合，コマンドを実行したサイトによって初期設定できるファイルが異なります。
   
   • 業務サイトの場合
     システムログファイル，正シンクポイントダンプファイル，及び副シンクポイントダンプファイルを初期設定対象とします。
     
   • ログ適用サイトの場合
     副シンクポイントダンプファイルを初期設定対象とします。システムログファイル，及び正シンクポイントダンプファイルについては初期設定できません。
     

例1：

システムログファイルを作成します。

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

pdloginit -d sys ..........................1 -f /svr01/logf11 ................2 -n 64 ...........................3 pdloginit -d sys ..........................1 -f /svr01/logf12 ................2 -n 64 ...........................3

［説明］

1. 初期設定をするログ関係のファイル種別　sys（システムログファイル）
2. 物理ファイル名　/svr01/logf11，/svr01/logf12
3. 物理ファイルのレコード数　64

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

pdloginit -d sys ..........................1 -s bes1 .........................2 -f /svr01/logf11 ................3 -n 64 ...........................4 pdloginit -d sys ..........................1 -s bes1 .........................2 -f /svr01/logf12 ................3 -n 64 ...........................4

［説明］

1. 初期設定をするログ関係のファイル種別　sys（システムログファイル）
2. ファイルグループに対応するサーバ名　bes1
3. 物理ファイル名　/svr01/logf11，/svr01/logf12
4. 物理ファイルのレコード数　64

例2：

シンクポイントダンプファイルを作成します。

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

pdloginit -d spd ..........................1 -f /svr01/spdf11 ................2 -n 64 ...........................3 pdloginit -d spd ..........................1 -f /svr01/spdf12 ................2 -n 64 ...........................3

［説明］

1. 初期設定をするログ関係のファイル種別　spd（シンクポイントダンプファイル）
2. 物理ファイル名　/svr01/spdf11，/svr01/spdf12
3. 物理ファイルのレコード数　64

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

pdloginit -d spd ..........................1 -s bes1 .........................2 -f /svr01/spdf11 ................3 -n 64 ...........................4 pdloginit -d spd ..........................1 -s bes1 .........................2 -f /svr01/spdf12 ................3 -n 64 ...........................4

［説明］

1. 初期設定をするログ関係のファイル種別　spd（シンクポイントダンプファイル）
2. ファイルグループに対応するサーバ名　bes1
3. 物理ファイル名　/svr01/spdf11，/svr01/spdf12
4. 物理ファイルのレコード数　64