大量のOracle Tuxedoサービス定義をロードする

システム管理者は、既存のOracle Tuxedoアプリケーション内に複数のOracle Tuxedoサービスを設定していることがあります。これらの定義を手動でリポジトリ・データベース内に作成すると、完了までに何時間もかかることがあります。Joltバルク・ローダーは、すでに定義されている複数のOracle Tuxedoサービスを一度にJoltリポジトリ・データベースにロードできるコマンド・ユーティリティです。jbldプログラムを使用すると、バルク・ローダー・ユーティリティによってOracle Tuxedoサービス定義が指定されたテキスト・ファイルから読み取られ、Joltリポジトリにバルク・ロードされます。サービスは、1回のバルク・ロードでリポジトリ・データベースにロードされます。サービスがJoltリポジトリに移入された後は、Joltリポジトリ・エディタを使用して、サービスを作成、編集およびグループ化できます。

バルク・ローダーの使い方

jbldプログラムはJavaアプリケーションです。jbldコマンドを実行する前に、Joltクラス・ディレクトリ(jolt.jarやjoltadmin.jar)の場所を指すようにCLASSPATH環境変数(またはそれに相当するもの)を設定してください。CLASSPATH変数が設定されていないと、Java仮想マシン(JVM)はJoltクラスを検出できません。

セキュリティ上の理由により、jbldではユーザー認証情報(ユーザー・パスワードまたはアプリケーション・パスワード)を指定する場合にコマンドライン引数を使用しません。サーバーのセキュリティ・レベルに応じて、jbldはユーザーにパスワードの入力を自動的に要求します。

バルク・ローダー・ユーティリティは、コマンドライン引数および入力ファイルから入力を取得します。

バルク・ローダーを起動する

プロンプトで(適切なオプションを使用して)次のように入力します。

java bea.jolt.admin.jbld [-n][-p package][-u usrname][-r usrrole] //host:port filename

表2-1を使用して、コマンドライン・オプションを適切に指定します。

コマンドライン・オプション

表2-1 バルク・ローダーのコマンドライン・オプション
オプション	説明
`-u` `usrname`	ユーザー名(デフォルトはアカウント名)を指定します。(セキュリティ上必要な場合は必須。)
`-r` `usrrole`	ユーザー・ロール(デフォルトは`admin`)を指定します。(セキュリティ上必要な場合は必須。)
`-n`	入力ファイルを、現在使用しているリポジトリと検証します。リポジトリは更新されません。(オプション)
-p package	リポジトリ・パッケージ名(デフォルトはBULKPKG)。
`//host:port`	JRLYまたはJSLアドレス(ホストおよびIPポート番号)を指定します。(必須)
`filename`	サービス定義を含むファイルを指定します。(必須)

バルク・ロード・ファイル

バルク・ロード・ファイルは、サービスおよびそれに関連付けられたパラメータを定義するテキスト・ファイルです。バルク・ローダーは、デフォルトでBULKPKGというパッケージ名を使用して、バルク・ロード・ファイル内に定義されているサービスをJoltリポジトリにロードします。-pコマンドを使用して、パッケージに任意の名前を指定し、デフォルトをオーバーライドすることもできます。同じ-pオプションを指定してバルク・ローダー・ファイルから再度ロードを実行すると、元のパッケージ内のサービスはすべて削除され、新しいバルク・ローダー・ファイルからのサービスで新しいパッケージが作成されます。

-pオプションを使用して指定したパッケージ以外のパッケージにサービスが存在していると、バルク・ローダーにより競合が報告され、バルク・ローダー・ファイルからリポジトリへのサービスのロードは行われません。リポジトリ・エディタを使用して重複するサービスを削除し、再度バルク・ローダー・ファイルをロードしてください。詳細は、「Joltリポジトリ・エディタの使用」を参照してください。

バルク・ローダー・データ・ファイルの構文

各サービス定義は、サービス・プロパティおよび決められた数のパラメータ・プロパティを持つパラメータで構成されます。各プロパティは、キーワードと値で表されます。

キーワードの使用に関するガイドライン

jbldプログラムによって、テキスト・ファイルからサービス定義が読み取られます。キーワードを使用する際は、表2-2のガイドラインに従ってください。

表2-2 キーワード使用に関するガイドライン
ガイドライン	例
各キーワードの後には等号(=)と値を指定します。	正: `type=string` 誤: `type`
1行につきキーワードは1つのみ指定します。	正: `type=string` 誤: `type=string access=out`
等号(=)のない行は無視されます。	正: `type=string` 誤: `type string`
明確に定義された値セットのみを受け入れるキーワードもあります。	キーワードaccessで受け入れられる値は、in、 out、inout、noaccessのみです。
入力ファイルには複数のサービス定義を含めることができます。	`service=INQUIRY <service keywords and values> service=DEPOSIT <service keywords and values> service=WITHDRAWAL <service keywords and values> service=TRANSFER <service keywords and values>`
各サービス定義にはキーワードと値の組合せが複数含まれます。	`service=DEPOSIT export=true inbuf=VIEW32 outbuf=VIEW32 inview=INVIEW outview=OUTVIEW`

バルク・ローダー・データ・ファイルのキーワードの順序

バルク・ロード時の転送エラーを回避するため、データ・ファイル内のキーワードは適切な順序で指定する必要があります。

バルク・ローダー・データ・テキスト・ファイル内の最初のキーワード定義は、最初のservice=<NAME>キーワード定義にする必要があります(リスト「データ・ファイル内のキーワード階層順序」を参照)。service=<NAME>キーワードの後は、このサービスに適用されるその他すべてのサービス・キーワードを最初のparam=<NAME>定義より前に指定する必要があります。これらの残りのサービス・キーワードは、任意の順序で指定できます。

サービスに関連付けるすべてのパラメータを指定する必要があります。param=<NAME>キーワードの後には、このパラメータに適用されるすべてのパラメータ・キーワードを、次のパラメータ定義より前に指定します。これらの残りのパラメータ・キーワードは、任意の順序で指定できます。最初のサービスに関連付けるすべてのパラメータを定義したら、新しいservice=<NAME>キーワード定義を指定します。

リスト2-1に、データ・ファイル内のキーワード階層順序を示します。

サービス・レベルのキーワードと値を使う

サービス定義はservice=<NAME>キーワードで始まっている必要があります。CARRAY、STRINGまたはXMLのバッファ・タイプを使用するサービスに指定できるパラメータは1つのみです。CARRAYバッファ・タイプを使用するサービスの場合、パラメータ名としてCARRAY、データ型としてcarrayを指定することをお薦めします。STRINGバッファ・タイプを使用するサービスの場合、パラメータ名としてSTRING、データ型としてstringを指定することをお薦めします。XMLバッファ・タイプを使用するサービスの場合は、パラメータ名としてXML、データ型としてxmlを指定することをお薦めします。

表2-3に、サービスレベルのキーワードおよび各キーワードで許容される値を使用する際のガイドラインを示します。

表2-3 サービスレベルのキーワードおよび値
キーワード	値
`service`	任意のOracle Tuxedoサービス名
`export`	trueまたはfalse(デフォルトはfalse)
`inbuf/outbuf`	次のいずれかのバッファ・タイプを選択します。 `FML FML32 VIEW VIEW32 STRING CARRAY` XML `X_OCTET` `X_COMMON` `X_C_TYPE`
`inview`	入力パラメータに対する任意のビュー名 (バッファ・タイプとして`VIEW`、`VIEW32`、`X_COMMON`、`X_C_TYPE`のいずれかが使用されている場合のみ、このキーワードはオプションです。)
`outview`	出力パラメータに対する任意のビュー名(オプション)

パラメータ・レベルのキーワードと値を使う

パラメータの最初にはparam=<NAME>キーワードを指定し、続いていくつかのパラメータ・キーワードを指定します。パラメータの最後には、別のparamキーワードかserviceキーワードまたはend-of-fileが指定されます。param=<NAME>キーワードより後のパラメータは、任意の順序で指定できます。

表2-4に、パラメータレベルのキーワードおよび各キーワードで許容される値を使用する際のガイドラインを示します。

表2-4 パラメータレベルのキーワードおよび値
キーワード	値
`param`	任意のパラメータ名
`type`	`byte short integer float double string carray` xml
`access`	`in out inout noaccess`
`count`	オカレンスの最大数(デフォルトは1)。無制限のオカレンスに対応する値は0です。リポジトリ・エディタでテスト画面を書式設定する場合にのみ使用されます。

トラブルシューティング

バルク・ローダー・ユーティリティの使用中に問題が発生した場合は、表2-5を参照してください。バルク・ローダー・ユーティリティのエラー・メッセージおよび解決策の完全なリストについては、「システム・メッセージ」を参照してください。

表2-5 バルク・ローダーのトラブルシューティング表
状況	結果
データ・ファイルが見つからない	パスが正しいことを確認します。
キーワードが無効	パッケージ、サービスまたはパラメータのキーワードが有効であることを確認します。
キーワードの値がNULL	キーワードの値を入力します。
値が無効	パラメータの値がそのパラメータに割り当てられた範囲内にあることを確認します。
データ型が無効	パラメータで有効なデータ型が使用されていることを確認します。

バルク・ロード・データのサンプル

リスト2-2に、UNIXコマンドcat servicefileを使用した正しい形式のサンプル・データ・ファイルを示します。このサンプルでは、TRANSFER、LOGINおよびPAYROLLサービス定義がBULKPKGにロードされます。

Oracle Joltの使用