Oracle Joltの使用

Joltリポジトリ・エディタの使用

Joltリポジトリ・エディタを使用すると、Oracle Tuxedoの構成ファイルから使用可能な情報に基づいて、リポジトリ内のOracle Tuxedoサービス定義を追加、変更、テスト、エクスポートおよび削除できます。Joltリポジトリ・エディタでは、パッケージ名、サービス名、パラメータ名などのOracle Tuxedoサービス定義を受け入れます。

ここでは、以下の内容について説明します。

リポジトリ・エディタの紹介

Joltリポジトリは、JavaパラメータをOracle Tuxedoの型付きバッファに変換するためにJoltの内部で使用されます。リポジトリ・エディタはダウンロード可能なJavaアプレットとして使用できます。Oracle Tuxedoサービスをリポジトリに追加する場合は、Joltサーバーにエクスポートして、Joltクライアントからクライアント・リクエストを発行できるようにする必要があります。

「Repository Editor」ウィンドウ

リポジトリ・エディタのウィンドウには、入力フィールド、スクロール可能表示、コマンド・ボタン、ステータスおよびラジオ・ボタンが含まれています。図「リポジトリ・エディタ・ウィンドウの例」に、ウィンドウの各構成要素を示します。表「リポジトリ・エディタ・ウィンドウの構成要素」で、各構成要素について詳しく説明します。

「Repository Editor」ウィンドウの説明

表4-1では、前の図に示したリポジトリ・エディタ・ウィンドウの構成要素について詳しく説明します。

概要

リポジトリ・エディタを起動する前に、最低限必要なコンポーネントとしてJoltサーバーとJoltクライアントがインストールされていることを確認してください。

リポジトリ・エディタを使用するには、次の手順に従います。

Java Applet Viewerを使ってリポジトリ・エディタを起動する

Webブラウザを使ってリポジトリ・エディタを起動する

次のいずれかの方法を使用して、Webブラウザからリポジトリ・エディタを起動します。

ローカル・ディスク上のリポジトリ・エディタを起動する場合

Webサーバーからリポジトリ・エディタを起動する場合

リポジトリ・エディタにログオンする

次の表「リポジトリ・エディタのログオン・ウィンドウの説明」で、リポジトリ・エディタのログオン・ウィンドウの要素について説明します。

リポジトリ・エディタのログオン・ウィンドウの説明

リポジトリ・エディタを終了する

パッケージ、サービス、およびパラメータの追加、編集、テスト、削除が完了したらリポジトリ・エディタを終了します。終了する前に、下図の「Oracle Joltリポジトリ・エディタを終了する前のログオン・ウィンドウ」に示すようなウィンドウが表示されます。

使用できるのは、「パッケージ」、「サービス」、および「ログ・オフ」のみです。文字入力フィールドは利用できません。

リポジトリ・エディタを終了するには、次の手順に従います。

リポジトリ・エディタの主なコンポーネント

リポジトリ・エディタではと、次のコンポーネントを追加、変更または削除できます。

リポジトリ・エディタの操作手順

リポジトリ・エディタにログオンすると、「パッケージ」ボタンと「サービス」ボタンの2つが使用可能になります。

この2つのボタンのどちらを選択するかは、図4-4に示したリポジトリ・エディタのフローを参考にして判断してください。

「パッケージ」を選択して「パッケージ」ウィンドウを開き、次の機能を実行します。

詳細は、「パッケージとは」を参照してください。

「サービス」を選択して「サービス」ウィンドウを開き、次の機能を実行します。

詳細は、「サービスとは」を参照してください。

パッケージとは

Joltを管理する際には、パッケージを使用してサービスをグループ化すると便利です。(サービスは、個人識別番号、口座番号、支払、レート、期間、年齢、社会保障番号など、複数のパラメータから構成されます。)

「パッケージ」ウィンドウを使用して、次の操作を実行します。

リポジトリ・エディタのログオン・ウィンドウで「パッケージ」ボタンをクリックすると、使用可能なパッケージが表示されます。表示リストから特定のパッケージを選択すると、そのパッケージ内のサービスが表示されます。

図4-5は、「パッケージ」ウィンドウの例を示しています。BANKAPPパッケージが選択され、BANKAPPパッケージ内のサービスが表示されています。

「パッケージ」ウィンドウの説明

表4-3に、「パッケージ」ウィンドウの説明を示します。

パッケージを表示する手順

サービスとは

サービスとは、使用可能なOracle Tuxedoサービスを定義したものです。サービスは、個人識別番号、口座番号、支払、レートなどの複数のパラメータから構成されます。Joltサービスを追加または編集しても、既存のOracle Tuxedoサービスに影響することはありません。

サービスの追加、編集または削除は、「サービス」ウィンドウを使用して行います。

図4-6は、BANKAPPパッケージが選択された「サービス」ウィンドウの例であり、このパッケージに使用可能なサービスおよびパラメータのリストが表示されています(パラメータについては以降で詳述します)。

「サービス」ウィンドウの説明

表4-4に、「サービス」ウィンドウの説明を示します。

サービスを表示する手順

パラメータの機能

サービスには、個人識別番号、口座番号、支払、レート、期間、年齢、社会保障番号などのパラメータが含まれます。図4-7は、サービスとそのパラメータが選択された「サービス」ウィンドウを示しています。

パラメータを表示する手順

パッケージとサービスを設定する

この項では、パッケージおよびそのサービスの設定に必要な手順を示します。

作業を保存する

サービスとパラメータの作成および編集を行う場合は、入力した情報を失うことがないよう定期的に情報を保存することが重要です。「サービスの編集」ウィンドウの「サービスの保存」をクリックすると、システム障害が発生しても情報を再入力しなくて済みます。

「サービスの編集」ウィンドウで新規サービスの追加や既存サービスの変更を行う場合は、「戻る」を選択する前に必ず「サービスの保存」を選択してください。変更した情報を保存する前に「戻る」を選択すると、ウィンドウの一番下にあるステータス行に簡単な警告が表示されます。

パッケージを追加する

新規のサービス・グループを追加する必要がある場合は、サービスを追加する前に新規パッケージを作成しておく必要があります。パッケージ・オーガナイザ・ウィンドウとそれに続く手順で、新規パッケージBALANCEを「パッケージ」リストに追加する方法を示します。

パッケージを追加する手順

サービスを追加する

サービスとは使用可能なOracle Tuxedoサービスを定義したものであり、Joltパッケージの一部としてのみ存在できます。サービスは新規または既存のパッケージの一部として作成する必要があります。

リポジトリ・エディタでは、新しいサービス名は入力したとおりに受け入れられます(すべて大文字で入力した名前、略語、スペルミスなどもそのまま受け入れられます)。サービス名は30文字以内で指定する必要があります。

図4-9は、サービスを追加するための新規サービスの編集ウィンドウを示しています。

サービスを追加するウィンドウの説明

表4-5で、「パッケージ」ウィンドウでサービスをパッケージに追加するためのオプションについて説明します。

サービスを追加する手順

CARRAYまたはSTRINGをサービス・バッファ型として選択する

新規サービスのバッファ・タイプとして「CARRAY」または「STRING」を選択した場合、それに関連するパラメータのデータ型として追加できるのは「CARRAY」または「STRING」のみです。「パラメータの追加」および「パラメータのデータ型としてCARRAYまたはSTRINGを選択」も参照してください。詳細は、「Joltクラス・ライブラリの使用」を参照してください。

図4-10は、サービスSIMPAPPのバッファ・タイプとしてSTRINGが選択された「サービスの編集」ウィンドウの例を示しています。

パラメータを追加する

「サービスの編集」ウィンドウのパラメータ・レベル・アクション・ラベルの下の「新規」をクリックすると、パラメータの編集ウィンドウが表示されます。図4-11で機能を確認してください。このウィンドウを使用して、サービスのパラメータおよび画面の情報を入力します。

パラメータを追加するウィンドウの説明

パラメータを追加する手順

パラメータのデータ型としてCARRAYまたはSTRINGを選択する

新規サービスのバッファ・タイプとして「CARRAY」または「STRING」を選択した場合、対応するパラメータに追加できるデータ型はCARRAYまたはstringのみです。

この場合は、1つしかパラメータを追加できません。CARRAYバッファ・タイプのパラメータ名にはCARRAY、STRINGバッファ・タイプのパラメータ名にはSTRINGを指定することをお薦めします。

「サービスを追加する手順」および「サービス・バッファ・タイプとしてCARRAYまたはSTRINGを選択」も参照してください。詳細は、「Joltクラス・ライブラリの使用」を参照してください。

図4-12は、パラメータのデータ型としてstringが選択された「パラメータの編集」ウィンドウの例です。「データ型」はデフォルトでstringになり、その特定のデータ型を変更することはできません。「フィールド名」には任意の名前を指定できます。

パッケージ・オーガナイザを使ってサービスをグループ化する

パッケージ・オーガナイザを使用すると、パッケージ間でサービスを移動できます。また、関連するサービスどうしを1つのパッケージにグループ化することもできます(たとえば、毎日指定された時刻にエクスポートされるWITHDRAWALサービスは1つのパッケージにグループ化できます)。

パッケージ・オーガナイザの矢印ボタンを使用すると、サービスを別のパッケージに移動できます。これらのボタンは、パッケージ間で複数のサービスを移動する場合に便利です。パッケージおよびサービスで表示されるリストを使用すると、特定のパッケージ内のサービスを追跡できます。

図4-13は、サービスが別のパッケージに転送されるように選択されたパッケージ・オーガナイザ・ウィンドウの例です。

「Package Organizer」ウィンドウの説明

パッケージ・オーガナイザでサービスをグループ化する手順

パッケージ、サービス、パラメータを変更する

パッケージ、サービス、またはパラメータに対しては、次の変更を行うことができます。

サービスを編集する

既存のサービス名やサービス情報を変更したり、既存のサービスに新しいパラメータを追加するためのウィンドウにアクセスすることができます。「サービスの編集」ウィンドウの詳細は、「サービスを追加するウィンドウの説明」を参照してください。図4-15は、「サービスの編集」ウィンドウの例です。

サービスを編集する手順

サービスを編集するには、次の手順に従います。

パラメータを編集する

パラメータ名を含むすべてのパラメータ要素は変更可能です。

警告:	既存の名前を使用して新規パラメータを作成すると、既存のパラメータが上書きされます。

図4-16は、パラメータの編集ウィンドウの例です。

パラメータを編集する手順

パラメータを変更するには、次の手順に従います。

パラメータ、サービス、およびパッケージを削除する

この項では、パッケージを削除する方法について説明します。パッケージを削除する前に、そのパッケージからすべてのサービスを削除する必要があります。パッケージからサービスなどのコンポーネントがすべて削除されると、「削除」オプションが使用可能になります。

警告:	アイテムの削除を確認するプロンプトは表示されません。「削除」を選択する前に必ず、そのパラメータ、サービスまたはパッケージを削除する予定であること、またはすでに別の場所に移動したことを確認してください。

パラメータを削除する

削除するパラメータを決定し、次の手順に従います。

サービスを削除する

削除するサービスを決定し、次の手順に従います。

パッケージを削除する

削除するパッケージを決定し、次の手順に従います。このオプションを選択する前に、パッケージ内のすべてのサービスが削除されていること、または別のパッケージに移動されたことを確認してください。

Joltクライアントからサービスを利用可能にする

Joltクライアントでサービスを使用可能にするには、サービスをエクスポートします。パッケージ内のすべてのサービスをグループとしてエクスポートまたはアンエクスポートする必要があります。サービスを使用可能にするには、ラジオ・ボタン「エクスポート」および「アンエクスポート」を使用します。

ここでは、以下の内容について説明します。

サービスのエクスポートとアンエクスポート

Joltクライアントで使用可能なサービスと使用できないサービスを判別します。サービスのエクスポートは、JoltクライアントがJoltサーバーからの最新のサービス定義にアクセスできるようにするために行います。

図4-17は、サービスをエクスポートおよびアンエクスポートするための「パッケージ」ウィンドウを示しています。

サービスをエクスポートまたはアンエクスポートするには、次の手順に従います。

エクスポートとアンエクスポートのステータスを確認する

サービスがエクスポートまたはアンエクスポートされると、「サービスの編集」ウィンドウでそのステータスを確認できます。

図4-18では、「エクスポート・ステータス」で「エクスポート」ラジオ・ボタンがアクティブになっているため、サービスTRANSFERの現在のステータスはエクスポート済ということです。

サービスの現在のステータスがエクスポート済かアンエクスポート済かを確認するには、次の手順に従います。

サービスをテストする

サービスおよびそのパラメータは、Joltクライアントで使用可能にする前にテストしてください。現在使用可能なサービスは、サービスやパラメータに変更を加えることなくテストできます。

エクスポートまたはアンエクスポートしたサービスをテストできます。サービスおよびそのパラメータを変更する必要がある場合は、編集前にそのサービスをアンエクスポートしてください。

ここでは、以下の内容について説明します。

Joltリポジトリ・エディタの「サービス・テスト」ウィンドウ

「実行」ボタンを使用してサービスをテストし、パラメータ情報に間違いがないことを確認します。サービスのテストは、テストするサービスに対して対応するOracle Tuxedoサーバーが実行されている場合にのみ実行できます。

パラメータがサービスに追加されていないとき「サービスの編集」ウィンドウの「テスト」ボタンは使用可能ですが、サービス・テスト・ウィンドウのパラメータ・フィールドに「未使用」と表示され、使用できません。未使用のパラメータ・フィールドの例については、「サービス・テスト・ウィンドウの例を参照してください。

図4-19は、書込み可能テキスト・フィールドと読取り専用テキスト・フィールドの両方が含まれるサービス・テスト・ウィンドウの例です。

「サービス・テスト」ウィンドウの説明

次の表で、サービス・テスト・ウィンドウのオプションについて説明します。

サービスをテストする

サービスのテストは、サービスやそのパラメータを変更せずに実行できます。また、サービスやそのパラメータの編集後に、サービスをテストすることもできます。

サービスのテスト手順の流れ

図4-20は、リポジトリ・エディタでの一般的なサービス・テストのフローを示しています。

サービスのテストの手順

サービスをテストするには、次の手順に従います。トラブルシューティングの詳細は、「リポジトリ・エディタのトラブルシューティング」表の最初の2つのエントリを参照してください。

テストの後でサービスを編集する

テストの成功に編集が必要な場合は、次の手順に従います。

リポジトリ・エディタのトラブルシューティング

リポジトリ・エディタの使用中に問題が発生した場合は、表4-6を参照してください。