付録D.1 HiRDBデータベース移行ツールの内容

HiRDBデータベース移行ツールとして,ajshirdbportコマンドを提供しています。ajshirdbportコマンドの詳細を次に示します。

<この項の構成>
(1) 形式
(2) 機能
(3) 実行権限
(4) 格納先ディレクトリ
(5) 引数
(6) 注意事項
(7) エラー発生時の対処
(8) 戻り値
(9) 出力例

(1) 形式

ajshirdbport
    [-mh 論理ホスト名]
    -F サービス名
    -p 組み込みDB通信ポート
    [-q]
    [-ru {l|m|s}]
    -id セットアップ識別子
    [-c]
    [-tp テーブル名プリフィックス]

形式1(組み込みDBへの標準的な移行)

ajshirdbport
    [-mh 論理ホスト名]
    -F サービス名
    -p 組み込みDB通信ポート
     [-ru {l|m|s}]
     -id セットアップ識別子

形式2(スケジューラーサービスのデータベースとして使用されている組み込みDBへの移行)

ajshirdbport
    [-mh 論理ホスト名]
    -F サービス名
    -p 組み込みDB通信ポート
    -q
    [-ru {l|m|s}]
    -id セットアップ識別子
    [-tp テーブル名プリフィックス]

形式3(組み込みDBへの移行が中断された場合)

ajshirdbport
    [-mh 論理ホスト名]
    -F サービス名
    -p 組み込みDB通信ポート
    -q
    [-ru {l|m|s}]
    -id セットアップ識別子
    [-tp テーブル名プリフィックス]
    -c

(2) 機能

JP1/AJS2スケジューラーサービスに設定されたデータベースをHiRDBから組み込みDBに移行します。

このコマンドは,HiRDBがスケジューラーサービスのデータベースとして設定されている状態で実行してください。

(3) 実行権限

Windowsの場合:Administrators権限

UNIXの場合:スーパーユーザー権限

(4) 格納先ディレクトリ

Windowsの場合
JP1/AJS2 - Managerインストール先フォルダ¥tools¥
UNIXの場合
/opt/jp1ajs2/tools/

(5) 引数

-mh 論理ホスト名
処理対象とするJP1論理ホスト名を指定します。指定できる文字数は,1~32(単位:バイト)です。
省略した場合,環境変数JP1_HOSTNAMEの設定があれば,環境変数の値を仮定します。環境変数JP1_HOSTNAMEの指定がない場合は,物理ホストを仮定します。
-F サービス名
処理対象とするスケジューラーサービスのサービス名を指定します。
HiRDBがセットアップされているスケジューラーサービス名を指定してください。
-p {組み込みDB通信ポート}
組み込みDBの接続ポートを10進数で指定します。
ajsembdbbuild -pオプションに指定したポート番号を指定してください。
構成定義のRDBPORTパラメーターに設定されます。
指定できる値の範囲については,「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」のRDBPORTパラメーターを参照してください。
-q
スキーマ作成をスキップする場合に指定します。
移行先の組み込みDBに,すでにスケジューラーサービスが設定されている場合に指定します。また,ajshirdbportコマンド実行時,スキーマ作成に成功してテーブル作成時にエラーが発生した場合などにも,このオプションを指定する必要があります。
移行先の組み込みDBにスケジューラーサービスを初めてセットアップする場合は,テーブル作成時にエラーとなるので,このオプションを指定しないでください。
-c
スキーマ作成が成功したあと,テーブル作成処理などでエラーが発生した際に再セットアップをする場合に指定します。
-tp テーブル名プリフィックス
JP1/AJS2スケジューラーデータベースのテーブル名プリフィックスを4バイト以内で指定します。
移行先の組み込みDBがほかのスケジューラーサービスのデータベースに設定されている場合,そのスケジューラーサービスのテーブル名プリフィックスと重複しないように値を設定してください。
-Fオプションで指定したスケジューラーサービスの構成定義TABLENAMEPREFIXパラメーターの値を仮定します。
このオプションを指定した場合,構成定義のTABLENAMEPREFIXパラメーターの設定が変更されます。
-ru {l|m|s}
空き領域の再利用機能を使用する場合に指定します。l,m,sと同時に指定した場合,再利用開始ポイントを指定することができます。
-ruを省略した場合は,-ru lが仮定されます。
-ruの後ろに空き領域の再利用機能の再利用開始ポイントを指定します。データ領域の使用率がここで指定したポイントに達した場合,空き領域の再利用機能が動作します。
l,m,sはそれぞれajsembdbbuildコマンドのデータベースモデル,大・中・小規模に対応しています。ajsembdbbuildコマンドで指定したデータベースモデルの規模と同じオプションを指定してください。
各テーブルに設定される,データベース領域に対する空き領域の再利用機能の再利用開始ポイントは,次のとおりです。
項番テーブル名各テーブルで設定される空き領域の再利用機能の
再利用開始ポイント
1AJSUNITデータベース領域AJS2DATA全体のセグメントの10%
2AJSARROW
3AJSBODY
4AJSSCH
5AJSCAL
6AJSPERF
7AJSENTRY
8AJSGEN
9AJSSTATデータベース領域AJS2DATA全体のセグメントの20%
テーブル名は,テーブルプリフィックスを標準の"AJS"としている場合の名称です。

なお,ajsembdbbuildコマンドのデータベースモデル,大・中・小規模で作成される領域のセグメントの全体量は次の表のとおりです。
項番データベース領域大規模中規模小規模
1AJS2DATA30,80014,9204,940
-id セットアップ識別子
組み込みDBを識別するセットアップ識別子を「_JAn」(nは0~9またはA~Z)の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

(6) 注意事項

(7) エラー発生時の対処

コマンド実行時にエラーが発生する場合があります。エラーが発生した場合は次の表に従って問題に対処し,再実行してください。

メッセージID原因対処方法
DBTYPE
ERROR
移行元スケジューラーサービスのデータベース種別がHiRDBではありません。移行元のデータベース種別を確認してください。
このコマンドはHiRDBからの移行を行う場合だけ使用できます。
KAVS0101-E指定したオプションに引数が指定されていません。オプションに値を指定して,コマンドを再実行してください。
KAVS0178-Eテーブルが作成済みです。-tpオプションに指定している値が,すでに存在するスケジューラーサービスのテーブルプリフィックスの値と重複していないか確認してください。テーブルの作成中,または容量不足などで処理が中断され,再実行したときにこのメッセージが出力された場合は,-qオプションと-cオプションを同時に指定して再実行してください。
KAVS0190-Eホストには指定されたスケジューラーサービスが定義されていません。-Fオプションに,すでに存在しているスケジューラーサービス名を指定してください。
KAVS0985-Eデータベースに接続できません。次の問題が考えられます。
  • HiRDBまたは組み込みDBサーバが起動していない。
  • -pオプションで指定したポート番号が組み込みDBのポート番号と一致していない。
これらの問題を解決してから再実行してください。
KAVS0936-Eスキーマはすでに定義されています。スキーマが作成済みの場合は,-qオプションを指定して再実行してください。
KAVS0996-E指定されたオプションおよび値が不正です。オプションおよびオプションに指定する値を修正してください。
KAVS1003-E構成定義に誤った指定があります。オプションで指定した値を正しい値に修正して,再実行してください。
KFPA11723-E組み込みDBまたはHiRDBが停止しています。組み込みDBまたはHiRDBを起動してください。
KFPA11204-E表がありません。-tpオプションの値を見直して,正しいテーブルプリフィックスを指定してください。また,HiRDBがスケジューラーサービスのデータベースとして接続できる状態であるか確認してください。
KFPA11563-E
KFPA11732-E
組み込みDBまたはHiRDBにほかのユーザーがアクセスしているため,排他待ちタイムアウトになりました。組み込みDBへのアクセスをすべて停止してから再実行してください。
The embedded DB work directory associated with the setup identifier specified by the -id option is invalid.-idオプションに指定したセットアップ識別子に関連づけられている組み込みDB運用ディレクトリが不正です。構成定義に設定されている組み込みDB運用ディレクトリに正しい値を指定し,再実行してください。登録済みのセットアップ識別子および組み込みDB運用ディレクトリは,ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細は,「20. セットアップ時に使用するコマンド ajsembdbidlist」を参照してください。
The setup identifier specified with the -id option is not registered.-idオプションで指定したセットアップ識別子は,登録されていません。登録済みのセットアップ識別子を指定し,再実行してください。なお,登録済みのセットアップ識別子および組み込みDB運用ディレクトリは,ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細は,「20. セットアップ時に使用するコマンド ajsembdbidlist」を参照してください。
Failed to register the configuration definition.構成定義の登録に失敗しました。-qオプションと-cオプションを同時に指定して再実行してください。

なお,KAVSで始まるメッセージの詳細については,マニュアル「JP1/Automatic Job Management System 2 メッセージ 2.3 KAVSで始まるメッセージ(スケジューラーに関するメッセージ)」を参照してください。

(8) 戻り値

0正常終了。
0以外異常終了。

(9) 出力例