|
既存の 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
はパスワードの入力をユーザに自動的に求めます。
バルク ローダ ユーティリティは、コマンドライン引数と入力ファイルから入力情報を取得します。
バルク ロード ファイルは、サービスおよびそれに関するパラメータを定義するテキスト ファイルです。バルク ローダは、このバルク ロード ファイルに定義されたサービスを Jolt リポジトリにロードします。このとき、デフォルトで「BULKPKG」というパッケージ名が使用されます。-p
コマンドを使って任意のパッケージ名を指定し、デフォルトのパッケージ名をオーバーライドすることもできます。-p
オプションを指定してバルク ロード ファイルから再度ロードを行うと、元のパッケージ内のサービスはすべて削除され、新しいバルク ロード ファイルを作成すると、新しいパッケージが作成されます。
-p
オプションで指定していない名前がパッケージに付いていると、コンフリクトの発生がバルク ローダから報告され、バルク ロード ファイルからリポジトリへのサービスのロードは行われません。リポジトリ エディタを使って重複するサービスを削除し、再度バルク ロード ファイルをロードしてください。その他の情報については、「Jolt リポジトリ エディタを使う」を参照してください。
各サービス定義は、サービス プロパティと、特定の数のパラメータ プロパティを持つパラメータで構成されます。各プロパティは、キーワードと値で表されます。
jbld
プログラムはテキスト ファイルからサービス定義を読み取ります。キーワードを使用する際は、次の表のガイドラインに従ってください。
バルク ロード時の転送エラーを避けるため、データ ファイル内のキーワードは指定された順序で並べる必要があります。
まず、バルク ローダ データ ファイルの先頭には、最初のサービスの service=<NAME
キーワードを定義します (「データ ファイル内のキーワードの順序」を参照)。service=<NAME>
キーワードの後には、このサービスに適用されるその他のサービス キーワードをすべて指定します。これらのサービス キーワードは、最初の param=<NAME>
定義の前に指定しなければなりません。ただし、サービス キーワードは、どのような順序で指定してもかまいません。
次に、サービスに関連するパラメータをすべて指定します。param=<NAME>
キーワードの後には、このパラメータに適用されるパラメータ キーワードをすべて指定します。これらのパラメータ キーワードは、次のパラメータ定義の前に指定しなければなりません。パラメータ キーワードは、どのような順序で指定してもかまいません。最初のサービスに関連するすべてのパラメータを定義したら、次のサービスの service=<NAME>
キーワードを定義します。
service=<NAME>
<service keyword>=<value>
<service keyword>=<value>
<service keyword>=<value>
param=<NAME>
<parameter keyword>=<value>
<parameter keyword>=<value>
param=<NAME>
<parameter keyword>=<value>
<parameter keyword>=<value>
サービス定義は service=<NAME>
キーワードから始める必要があります。CARRAY、STRING、または XML のバッファ型を使うサービスに指定できるパラメータは 1 つだけです。CARRAY
バッファ型を使用するサービスには、パラメータ名として CARRAY
、データ型として carray
を指定することをお勧めします。STRING
バッファ型を使用するサービスの場合は、パラメータ名として STRING
、データ型として string
を指定することをお勧めします。XML
バッファ型を使用するサービスの場合は、パラメータ名として XML
、データ型として xml
を指定することをお勧めします。
次の表は、サービス レベルのキーワードと適切な値を使用する際のガイドラインです。
パラメータの定義では、まず param=<NAME>
キーワードを指定し、続いてパラメータ キーワードを指定します。パラメータ キーワードの次は、別の param
キーワードか service
キーワードが続くか、ファイルの最後になります。param=<NAME>
キーワード以降のパラメータ キーワードは、どのような順序で指定してもかまいません。
次の表は、パラメータ レベルのキーワードと適切な値を使用する際のガイドラインです。
バルク ローダ ユーティリティの使用中に問題が発生した場合は、次の表を参照してください。バルク ローダ ユーティリティのエラー メッセージと解決策の総合一覧については、『メッセージ』を参照してください。
次の一覧は、UNIX コマンドの cat servicefile
を使って表示した、正しい形式のサンプル データ ファイルです。この例では、TRANSFER、LOGIN、PAYROLL サービス定義が BULKPKG
にロードされます。
service=TRANSFER
export=true
inbuf=FML
outbuf=FML
param=ACCOUNT_ID
type=integer
access=in
count=2
param=SAMOUNT
type=string
access=in
param=SBALANCE
type=string
access=out
count=2
param=STATLIN
type=string
access=out
service=LOGIN
inbuf=VIEW
inview=LOGINS
outview=LOGINR
export=true
param=user
type=string
access=in
param=passwd
type=string
access=in
param=token
type=integer
access=out
service=PAYROLL
inbuf=FML
outbuf=FML
param=EMPLOYEE_NUM
type=integer
access=in
param=SALARY
type=float
access=inout
param=HIRE_DATE
type=string
access=inout