目次 前 次 PDF


大量のOracle Tuxedoサービス定義をロードする
大量のOracle Tuxedoサービス定義をロードする
システム管理者は、既存のOracle Tuxedoアプリケーション内に複数のOracle Tuxedoサービスを設定していることがあります。これらの定義を手動でリポジトリ・データベース内に作成すると、完了までに何時間もかかることがあります。バルク・ローダーは、すでに定義済の複数のOracle Tuxedoサービスを単一ステップでOracle Tuxedoサービス・メタデータ・リポジトリ・データベースにロードできるコマンド・ユーティリティです。jbldプログラムを使用すると、バルク・ローダー・ユーティリティによってOracle Tuxedoサービス定義が指定されたテキスト・ファイルから読み取られ、メタデータ・リポジトリにバルク・ロードされます。サービスは、1回のバルク・ロードでリポジトリ・データベースにロードされます。サービスがメタデータ・リポジトリに移入された後は、メタデータ・エディタを使用して、サービスを作成、編集およびグループ化できます。
このトピックには次の項が含まれます:
•
バルク・ローダーの使用
•
バルク・ローダー・データ・ファイルの構文
•
トラブルシューティング
•
バルク・ロード・データのサンプル
バルク・ローダーの使用
jbldプログラムはJavaアプリケーションです。jbldコマンドを実行する前に、Joltクラス・ディレクトリ(jolt.jarやjoltadmin.jar)の場所を指すようにCLASSPATH環境変数(またはそれに相当するもの)を設定してください。CLASSPATH変数が設定されていないと、Java仮想マシン(JVM)はJoltクラスを検出できません。
セキュリティ上の理由により、jbldではユーザー認証情報(ユーザー・パスワードまたはアプリケーション・パスワード)を指定する場合にコマンド行引数を使用しません。サーバーのセキュリティ・レベルに応じて、jbldはユーザーにパスワードの入力を自動的に要求します。
バルク・ローダー・ユーティリティは、コマンド行引数および入力ファイルから入力を取得します。
バルク・ローダーを起動する
1.
プロンプトで(適切なオプションを使用して)次のように入力します。
java bea.jolt.admin.jbld [-n][-p package][-u usrname][-r usrrole] //host:port filename
2.
表2-1を使用して、コマンド行オプションを適切に指定します。
コマンド行オプション
 
表2-1 バルク・ローダーのコマンド行オプション
オプション
説明
-u usrname
ユーザー名(デフォルトはアカウント名)を指定します。(セキュリティ上必要な場合は必須。)
-r usrrole
ユーザー・ロール(デフォルトはadmin)を指定します。(セキュリティ上必要な場合は必須。)
-n
入力ファイルを、現在使用しているリポジトリと検証します。リポジトリは更新されません。(オプション)
//host:port
JRLYまたはJSLアドレス(ホストおよびIPポート番号)を指定します。(必須)
filename
サービス定義を含むファイルを指定します。(必須)
バルク・ロード・ファイル
バルク・ロード・ファイルは、サービスおよびそれに関連付けられたパラメータを定義するテキスト・ファイルです。バルク・ローダーは、デフォルトでBULKPKGというパッケージ名を使用して、バルク・ロード・ファイル内に定義されているサービスをメタデータ・リポジトリにロードします。
-pオプションを使用して指定したパッケージ以外のパッケージにサービスが存在していると、バルク・ローダーにより競合が報告され、バルク・ローダー・ファイルからリポジトリへのサービスのロードは行われません。リポジトリ・エディタを使用して重複するサービスを削除し、再度バルク・ローダー・ファイルをロードしてください。
バルク・ローダー・データ・ファイルの構文
各サービス定義は、サービス・プロパティおよび決められた数のパラメータ・プロパティを持つパラメータで構成されます。各プロパティは、キーワードと値で表されます。
キーワードは、次の2つのレベルに分類されます。
•
サービスレベル
•
パラメータレベル
キーワードの使用に関するガイドライン
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に、データ・ファイル内のキーワード階層順序を示します。
リスト2-1 データ・ファイル内のキーワード階層順序
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を指定することをお薦めします。
表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
boolean
long
view32
access
in
out
inout
noaccess
count
オカレンスの最大数(デフォルトは1)。無制限のオカレンスに対応する値は0です。リポジトリ・エディタでテスト画面を書式設定する場合にのみ使用されます。
Subtype
"(" および ")"
パラメータがview32型の場合、このフィールドによってview構造体名が指定されます。それ以外の場合、このフィールドは無視されます。入れ子構造のview32の全サブパラメータは括弧で囲まれます。
トラブルシューティング
バルク・ローダー・ユーティリティの使用中に問題が発生した場合は、表2-5を参照してください。バルク・ローダー・ユーティリティのエラー・メッセージおよび解決策の完全なリストについては、「システム・メッセージ」を参照してください。
 
表2-5 バルク・ローダーのトラブルシューティング表
状況
結果
データ・ファイルが見つからない
パスが正しいことを確認します。
キーワードが無効
パッケージ、サービスまたはパラメータのキーワードが有効であることを確認します。
キーワードの値がNULL
キーワードの値を入力します。
値が無効
パラメータの値がそのパラメータに割り当てられた範囲内にあることを確認します。
データ型が無効
パラメータで有効なデータ型が使用されていることを確認します。
バルク・ロード・データのサンプル
リスト2-2に、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
service=QUERY
export=true
inbuf=VIEW32
outbuf=VIEW32
inview=MYVIEW2
outview=MYVIEW2
	param=Long1
	type=long
	access=inout
	count=1

	param=Myview1
	type=view32
	subtype=MYVIEW1
	access=inout
	count=1
(
	param=Float1
	type=float
	access=inout
	count=1

	param=Double1
	type=double
	access=inout
	count=1

	param=Long1
	type=long
	access=inout
	count=3

	param=String1
	type=string
	access=inout
	count=2
)
 

Copyright ©1994, 2017,Oracle and/or its affiliates. All rights reserved