ajsembdbrorg
形式
ajsembdbrorg -k {unld|reld} [-F スケジューラーサービス名] [-mh 論理ホスト名] [-agent] -d アンロードファイル格納ディレクトリ名
形式1(組み込みDBのデータをアンロードデータファイルへ格納)
ajsembdbrorg -k unld [-F スケジューラーサービス名] [-mh 論理ホスト名] [-agent] -d アンロードファイル格納ディレクトリ名
形式2(組み込みDBのデータをアンロードデータファイルから復元)
ajsembdbrorg -k reld [-F スケジューラーサービス名] [-mh 論理ホスト名] [-agent] -d アンロードファイル格納ディレクトリ名
機能
組み込みDBのデータの取り出し,復元を行います。
組み込みDBが稼働中で,該当する組み込みDBにスケジューラーサービスを作成しているすべてのスケジューラーサービスが停止中の場合だけ実行できます。
実行権限
Windowsの場合:Administrators権限
UNIXの場合:スーパーユーザー権限
格納先ディレクトリ
- Windowsの場合
-
JP1/AJS3 - Managerインストール先フォルダ\tools\
- UNIXの場合
-
/opt/jp1ajs2/tools/
引数
-k unld | reld
処理内容を指定します。
-
unld
指定したスケジューラーサービスのデータベースのデータをアンロードデータファイルへ格納します。
-
reld
指定したスケジューラーサービスのデータベースのデータをアンロードデータファイルから復元します。
-F スケジューラーサービス名
実行対象となるスケジューラーサービス名を指定します。
省略した場合,デフォルトスケジューラーサービス名が仮定されます。
-agentオプションと同時に指定した場合,このオプションは無効になります。
-mh 論理ホスト名
処理対象とするJP1論理ホスト名を指定します。指定できる文字数は,1〜32(単位:バイト)です。
省略した場合,環境変数JP1_HOSTNAMEが設定されていれば,設定値が仮定されます。環境変数JP1_HOSTNAMEが設定されていない場合は,物理ホスト名が仮定されます。
-agent
エージェント管理用のデータベースに対して処理を行います。
-Fオプションと同時に指定した場合,-Fオプションは無効になります。
-d アンロードファイル格納ディレクトリ名
アンロードファイル格納ディレクトリ名を指定します。
ディレクトリ名は絶対パスで指定してください。指定するディレクトリに空白文字を含む場合は,パスを「""」で囲んでください。
ネットワークドライブ上のディスクを指定しないでください。
指定するディレクトリは事前に用意してください。ディレクトリがない場合はエラーになります。
-kオプションにunldを指定した場合は,ここで指定したディレクトリにアンロードファイルが作成されます。
すでにファイルがある場合は,ファイルを削除してよいかどうかの応答メッセージが出力されます。
出力されるメッセージ:OK to Overwrite the unload file?(y/n):
ファイルを削除する場合は「y」を入力してください。
注意事項
-
このコマンドはスクリプトで実装されています。このため,オプションに不当に長い文字列や不正な文字列や値を指定すると,予期しないエラーが発生することがあります。オプション指定値は,DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。
-
このコマンドを実行する前に,該当する組み込みDBにスケジューラーデータベースを作成しているすべてのスケジューラーサービスを停止してください。また,JP1/AJS3サービスを含め,組み込みDBにアクセスしているサービスはすべて停止してください。サービスを停止しないでこのコマンドを実行した場合,長時間の待ち状態が発生するおそれがあります。
-
-kオプションにunldを指定した場合,-dオプションに指定するディレクトリには次に示す空き容量が必要になります。
ajsembdbbuildのオプション
必要な空き容量
-l(大規模モデル)
約6,700メガバイト
-m(中規模モデル)
約1,400メガバイト
-s(小規模モデル)
約200メガバイト
また,バックアップ強化機能が有効な場合は,-dオプションに指定するディレクトリには次に示す空き容量が必要になります。
ajsembdbbuildのオプション
必要な空き容量
-l(大規模モデル)
約7,200メガバイト
-m(中規模モデル)
約1,900メガバイト
-s(小規模モデル)
約700メガバイト
バックアップ強化機能の設定状況は,ajsembdbstatusコマンドで確認できます。ajsembdbstatusコマンドの詳細については,「3. 通常の運用で使用するコマンド ajsembdbstatus」を参照してください。
なお,ajsembdbaddareaコマンドで領域を拡張している場合,およびデータベース自動増分機能を使用している場合は,上記サイズに拡張したサイズを追加した値の容量を確保しておく必要があります。
このコマンドを実行するたびに,上記の容量が必要です。
-
-k reld(復元)を行う場合は,ajsembdbreclaimコマンドを実行し,組み込みDBの領域のメンテナンスを行ってから実行してください。
-
このコマンド実行中に何らかの障害(通信障害,ディスク障害など)が発生すると,コマンドが無応答になることがありますが,無応答になったコマンドを手動で強制終了できない場合は,組み込みDBのシステム共通定義pd_utl_exec_timeを指定することで,無応答になったコマンドの実行を打ち切ることができます。pd_utl_exec_timeについては,マニュアル「JP1/Automatic Job Management System 3 構築ガイド 23.1.1 組み込みDB稼働環境と運用方法の検討」のシステム共通定義を参照してください。
-
-Fオプションに同じスケジューラーサービス名を指定したajsembdbrorgコマンドを同時に複数実行しないでください。
-
-agentオプションを指定したajsembdbrorgコマンドを同じ組み込みDBに対して同時に複数実行しないでください。
-
-k reldオプションを指定して復元する環境は,-k unldオプションを指定して格納した環境と,バックアップ強化機能の設定が同じである必要があります。
例えば,バックアップ強化機能が有効な環境で-k unldオプションを指定して格納したデータを,バックアップ強化機能が無効な環境に-k reldオプションを指定して復元することはできません。
戻り値
0 |
正常終了。 |
0以外の値 |
異常終了。 |
エラー時の対処
コマンドエラー発生時は,次に示す表に従って対処してください。
メッセージID |
現象 |
対処方法 |
---|---|---|
KAVS0996-E |
指定したオプションに誤りがあります。 |
オプションの指定内容を見直してください。 |
KAVS2101-E |
組み込みDBは停止中です。 |
組み込みDBを起動してから再実行してください。 |
KAVS2102-E |
組み込みDBは起動・停止処理中です。 |
組み込みDBの起動をajsembdbstatusコマンドの-s ustオプション指定で確認してから再実行してください。 |
KAVS2104-E |
組み込みDBがセットアップされていません。 |
組み込みDBをセットアップしてから再実行してください。 |
KAVS2106-E |
アンロードに失敗しました。 |
しばらくしてから再実行してください。 |
KAVS2107-E |
リロードに失敗しました。 |
正しいアンロードデータファイルを指定してから再実行してください。 |
KAVS2113-E |
指定したディレクトリが存在しません。 |
-dオプションに指定した引数を見直して再実行してください。 |
KAVS2116-E |
指定したオプションに誤りがあります。 |
メッセージに出力されているオプションを見直して再実行してください。 |
KAVS2117-E |
コマンド実行時にエラーが発生しました。 |
保守情報に出力されているメッセージを参照してください。 |
KFPL15047-E |
-dオプションに指定したパス,またはパス配下のアンロードログファイルに権限がありません。 |
指定したパス,またはアンロードログファイルの権限を見直して,再実行してください。AJS管理者で運用している場合は,AJS管理者に対して権限があるか見直してください。 |