bea ホーム | 製品 | dev2dev | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > Tuxedo > Jolt > 大量の BEA Tuxedo サービス定義をロードする |
Jolt
|
大量の BEA Tuxedo サービス定義をロードする
既存の BEA Tuxedo アプリケーションに複数の BEA Tuxedo サービスがある場合、これらのサービスを手動で定義してリポジトリ・データベースに登録すると、大幅に時間がかかります。Jolt バルク・ローダは、複数の定義済み BEA Tuxedo サービスを一度に Jolt リポジトリ・データベースにロードするためのコマンド・ユーティリティです。jbld プログラムを実行すると、バルク・ローダ・ユーティリティは BEA 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 リポジトリ・エディタを使うを参照してください。
バルク・ローダ・データ・ファイルの構文
各サービス定義は、サービス・プロパティと、特定の数のパラメータ・プロパティを持つパラメータで構成されます。各プロパティは、キーワードと値で表されます。
キーワードは、次の 2 つのレベルに分類されます。
キーワードの使用に関するガイドライン
jbld プログラムはテキスト・ファイルからサービス定義を読み取ります。キーワードを使用する際は、次の表のガイドラインに従ってください。
バルク・ローダ・データ・ファイルのキーワードの順序 バルク・ロード時の転送エラーを避けるため、データ・ファイル内のキーワードは指定された順序で並べる必要があります。 まず、バルク・ローダ・データ・ファイルの先頭には、最初のサービスの 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 を指定することをお勧めします。 次の表は、サービス・レベルのキーワードと適切な値を使用する際のガイドラインです。
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>
パラメータ・レベルのキーワードと値を使う パラメータの定義では、まず param=<NAME> キーワードを指定し、続いてパラメータ・キーワードを指定します。パラメータ・キーワードの次は、別の param キーワードか service キーワードが続くか、ファイルの最後になります。param=<NAME> キーワード以降のパラメータ・キーワードは、どのような順序で指定してもかまいません。 次の表は、パラメータ・レベルのキーワードと適切な値を使用する際のガイドラインです。
トラブルシューティング
バルク・ローダ・ユーティリティの使用中に問題が発生した場合は、次の表を参照してください。バルク・ローダ・ユーティリティのエラー・メッセージと解決策の総合一覧については、「BEA Jolt システム・メッセージ」を参照してください。
バルク・ロード・データのサンプル
次の一覧は、UNIX コマンドの cat servicefile を使って表示した、正しい形式のサンプル・データ・ファイルです。この例では、TRANSFER、LOGIN、PAYROLL サービス定義が BULKPKG にロードされます。
コード リスト2-2 バルク・ロード・データのサンプル
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
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |