コマンドの概要
Datareplicatorでデータ連動の業務を実行するときに使うコマンドの文法について説明します。
Datareplicatorのコマンドを実行する前に,環境変数を設定する必要があります。設定する必要がある環境変数については,「2.4 環境変数の設定(UNIX)」又は「2.8 環境変数の設定(Windows)」を参照してください。
- Windows Vista,及びWindows Server 2008でのコマンドの実行
-
UAC機能を利用している場合,Datareplicatorでコマンドを実行するとき,「管理者として実行」したコマンドプロンプトかどうかによって,動作が異なります。詳細については,「2.10.1 コマンドの実行」を参照してください。
Datareplicatorでデータ連動するときに使うコマンドの一覧を次の表に示します。また,コマンドログに出力される情報について「表7-2 コマンドログに出力される情報」に示します。
コマンドの種類 |
コマンド名 |
機能 |
稼働中での実行 |
|
---|---|---|---|---|
HiRDB 稼働中 |
Datareplicator稼働中 |
|||
抽出側Datareplicatorのコマンド |
hdestart※1 |
抽出側Datareplicatorを起動します。 -iオプションを指定すると抽出側Datareplicator環境を初期化できます。この場合,起動はしません。 |
− |
△※4 |
hdestop※2 |
抽出側Datareplicatorを停止します。 |
− |
○ |
|
hdeevent※2 |
イベントを発行します。 |
○ |
− |
|
hdestate※2 |
抽出側Datareplicatorの状態を標準出力に出力します。 |
− |
○ |
|
hdeprep※2 |
抽出定義を解析して,抽出定義プリプロセスファイルを作成します |
○ |
△※5 |
|
hdemodq※3 |
抽出情報キューファイルの構成を変更します |
− |
× |
|
hdefcopy※2 |
ファイルの二重化で障害が発生したときに,障害ファイルに現用ファイルを複写します。 |
− |
× |
|
ファイルの二重化で使用している,物理ファイルの状態を表示します。 |
− |
△ |
||
抽出側Datareplicatorの共用リソースを削除します。 |
− |
× |
||
抽出側Datareplicatorを部分起動します。 |
− |
○ |
||
抽出側Datareplicatorを部分停止します。 |
− |
○ |
||
抽出側Datareplicatorが停止と起動をわたっても継続して保持する状態,及び情報を変更します。 |
− |
○ |
||
hdeinfoget※2,※9 |
抽出側Datareplicatorで発生した障害の,原因調査に必要な情報を取得します。 |
− |
△ |
|
反映側Datareplicatorのコマンド |
反映側Datareplicatorを起動します。 -iオプションを指定すると,反映側Datareplicator環境を初期化して起動できます。 |
− |
× |
|
hdsstop※6 |
反映側Datareplicatorを終了します。 |
− |
○ |
|
hdsrfctl※6 |
反映処理方式を制御したり,反映処理だけを再起動したりします。 |
− |
○ |
|
hdsstate※6 |
反映側Datareplicatorの状態を標準出力に出力します。 |
− |
○ |
|
hdssamqin※6,※7 |
SAMファイルを使うメインフレーム側DBから抽出した更新情報を,反映情報キューファイルに出力します。 |
− |
○ |
|
hdsfcopy※6 |
ファイルの二重化で障害が発生したときに,障害ファイルに現用ファイルを複写します。 |
− |
× |
|
ファイルの二重化で使用している,物理ファイルの状態を表示します。 |
− |
△ |
||
反映情報ステータスファイルから,各更新情報を抽出して,解析結果出力ファイルに出力します。 |
− |
△ |
||
反映側Datareplicatorが停止と起動をわたっても継続して保持する状態,及び情報を変更します。 |
− |
○ |
||
反映側Datareplicatorの共用リソースを削除します。 |
− |
× |
||
hdsinfoget※6,※9 |
反映側Datareplicatorで発生した障害の,原因調査に必要な情報を取得します。 |
− |
△ |
|
反映側Datareplicatorの全プロセスを強制終了します。 |
− |
△ |
||
HiRDBの コマンド |
抽出側HiRDBがHiRDB Datareplicator連携を開始します。 |
○ |
− |
|
抽出側HiRDBがHiRDB Datareplicator連携を中止します。 |
○ |
− |
||
(-d rpl指定時) |
抽出側HiRDBでのHiRDB Datareplicator連携の状態を表示します。 |
− |
− |
|
(-R指定時) |
システムログファイルの抽出未完了状態を,抽出完了状態に変更します。 |
− |
− |
|
文字コード変換用マッピングテーブルを編集するコマンド |
文字コード変換用マッピングテーブルを編集します。 文字コード変換用マッピングテーブルを更新する場合,及び外字マッピングファイルの移行をする場合は,スーパユーザでコマンドを実行してください。 |
− |
− |
|
稼働トレースファイルを編集するコマンド |
hdstrcedit※2,※6 |
稼働トレースファイルを編集します。 |
− |
− |
Datareplicatorファイルシステム領域で使うコマンド※8 |
hdsfmkfs※2,※6,※9 |
Datareplicatorファイルシステム領域を初期化します。 |
− |
× |
hdsfstatfs※2,※6,※9 |
Datareplicatorファイルシステム領域の状態を表示します。 |
− |
− |
- (凡例)
-
○:稼働中のときだけ実行できます。
×:停止中のときだけ実行できます。
△:停止中のときでも実行できます。
−:関連しません。
- 注※1
-
HiRDB管理者と同じユーザグループに属しているユーザ名で実行してください。
- 注※2
-
抽出側Datareplicatorの初期化(hdestart -iコマンド)を実行したユーザ名で実行してください。
- 注※3
-
抽出ノードマスタプロセス実行ユーザ(inetd.confで指定)と同じユーザ名で実行してください。
- 注※4
-
-iオプション指定は,抽出側Datareplicatorの稼働中には実行できません。
- 注※5
-
稼働中に実行しても,コマンドの実行結果が抽出側Datareplicatorに反映されるのは,抽出側Datareplicatorを停止してから,再開始した時点です(コマンド実行中に稼働している抽出側Datareplicatorには反映されません)。
- 注※6
-
反映側Datareplicatorの初期化(hdsstart -iコマンド)を実行したユーザ名で実行してください。
- 注※7
-
抽出側DBがSAMファイルを使うときにだけ使うコマンドです。XDM/DSを使ってデータ連動する場合の反映側Datareplicatorでは使いません。
- 注※8
-
Datareplicatorファイルシステム領域を設定しているDatareplicatorで使うコマンドです。スーパユーザだけが実行できます。これらのコマンドは,抽出側Datareplicatorと反映側Datareplicatorで共通です。Datareplicatorファイルシステム領域を使ったファイル管理については,「3.4 Datareplicatorファイルシステム領域」を参照してください。
- 注※9
-
Windows版Datareplicatorではサポートしていないコマンドです。
- 注※10
-
Windows版Datareplicatorだけでサポートしているコマンドです。
表7‒2 コマンドログに出力される情報 コマンド名
出力される情報
コマンド引数
コマンド戻り値
エラー発生時の詳細情報
hdechgstatus
×
×
×
hdeevent
hdeeventO
hdeeventS
○
○
×
hdefcopy
○
○
×
hdefstate
×
×
×
hdeinfoget
×
×
×
hdemodq
○
○
×
hdeprep
hdeprepO
hdeprepS
○
○
×
hdeshmclean
○
○
×
hdestart
hdestartO
hdestartS
○
○
○
hdestart_n
○
○
○
hdestate
×
×
×
hdestop
hdestopO
hdestopS
○
○
○
hdestop_n
○
○
○
hdsccnvedt
×
×
×
hdschgstatus
×
×
×
hdsemergencystop
×
×
×
hdsfcopy
○
○
×
hdsfmkfs
×
×
×
hdsfstate
×
×
×
hdsfstatfs
×
×
×
hdsinfoget
×
×
×
hdsrefinfm
×
×
×
hdsrfctl
○
○
×
hdssamqin
○
○
×
hdsshmclean
○
○
×
hdsstart
○
○
○
hdsstate
×
×
×
hdsstop
○
○
○
hdstrcedit
×
×
×
pdlogchg
×
×
×
pdls
×
×
×
pdrplstart
×
×
×
pdrplstop
×
×
×
- (凡例)
-
○:出力されます。
×:出力されません。