アーカイブ・ユーティリティーの使用


概説

タスク

組み込み先

Tivoli Problem Management

概説

ヘルプ・トピックの目次

アーカイブ・ユーティリティーの構成に説明されたインストール手順を完了した後、アーカイブ・ユーティリティーが使用できるようになります。このヘルプ・トピックでは、アーカイブ・ユーティリティーの使用で、次のことについて説明します。
  • アーカイブ・オプションの構成
  • アーカイブ・ユーティリティーの実行
  • アーカイブ・プロセスの管理
  • Tivoli Problem Management 変更との互換性の保証

構成オプション

データをアーカイブする前に、アーカイブ・ユーティリティーを適切な情報で構成する必要があります。次の情報を指定しなければなりません。

Tivoli Problem Management の構成

データを適切にアーカイブするには、アーカイブ・ユーティリティーは、正しい Tivoli Problem Management データベース・テーブルにアクセスしなければなりません。

「Tivoli Problem Management アーカイブ・ユーティリティー」ウィンドウに表示された Tivoli Problem Management バージョンおよびデータベース情報が正しいことを確認する必要があります。

リストされた Tivoli データ・ソースが Tivoli Problem Management 実動データ・ソースでない場合:

データをアーカイブする場所

データをアーカイブする前に、アーカイブするアイテムの宛先を指定する必要があります。次の 3 つのオプションから選択することができます。
  • フラット・ファイル
  • データベース
  • データの削除

データをフラット・ファイルにアーカイブすることを選択した場合には、このファイルの各行は、テーブルからの 1 レコードを示します。フラット・ファイルにアーカイブするには、そのデータをアーカイブするファイルを指定しなければなりません。フラット・ファイルの詳細については、アーカイブ・ユーティリティーで使用される API を参照してください。

データベースへのアーカイブを選択した場合には、アーカイブされるデータは、デフォルト・データベース中のアーカイブ・テーブルに保管されます。デフォルト・データベースは、「Tivoli Problem Management アーカイブ・ユーティリティー」ウィンドウの Tivoli データ・ソースとして識別されます。データベースにアーカイブするには、宛先データベース・テーブルが既に存在していなければなりません。アーカイブ・テーブルの詳細については、宛先データベース・テーブルの作成 を参照してください

データの削除を選択した場合には、アーカイブされたすべてのアイテムが削除されます。これらは、フラット・ファイルまたはアーカイブ・データベース・テーブルにコピーされません。

注意: このオプションを選択した場合には、どんな目的であっても削除したデータを検索する ことはできません !

データをアーカイブする日付

アーカイブされたアイテムは、"クローズされた" 状況で何らかの問題または情報コールとなる可能性があります。これらの問題およびコールのクローズされた状況は特定の日付に割り当てられています。どのデータ・アイテムをアーカイブするかを指示するには、アーカイブされるアイテムがクローズとして指定された間の日付の範囲を指定してください。

ユーザーが指定する日付は、その日付も含まれることに注意してください。すなわち、アーカイブされる問題は、開始日および終了日にクローズとして指定した、それらの問題も含まれます。

アーカイブするアイテム

アーカイブ手順を実行するには、アーカイブするアイテム数を指定する必要があります。

このアイテムは、複数のテーブル中の複数のレコードで構成することができます。たとえば、情報コールは 1 つの CALL と、1 つまたは複数の SESION レコードで構成することができます。

アーカイブ日付を最初に指定した場合には、「予測」機能を使用して、指定した範囲内にアーカイブするアイテム数がいくつあるかを判別することができます。「予測」は、アーカイブするアイテム数を計算して、「アーカイブする合計アイテム数」ボックスにその結果を表示します。

アーカイブするアイテム数が不確かな時、あるいはアーカイブするアイテム数を制限する必要がある時には、これは便利な機能です。「予測」によって計算された値が大き過ぎる場合には、日付の範囲を狭くするか、あるいは小さいアイテム数を指定することができます。

アーカイブ・ユーティリティーを初めて実行する場合には、異なった数値を使用して、ユーザー側のデータのアーカイブに要する時間を判別すると便利です。「コミット・サイズ」と「アイテムの合計数」の両方のテキスト・ボックスに異なった値を使用して、ユーザー側のパフォーマンスをテストすることができます。

コミット・サイズ

アーカイブ手順のコミット・サイズを指定する必要があります。

コミット・サイズは、データベース・ "コミット" を行なう前のアーカイブされるアイテム数を示します。1 つのアイテムが複数の CALL、SESION、 WORK_HISTORY、PROBLEM_HISTORY、および PROBLEM レコードから構成されているので、この数値は、ロールバック・セグメントの値よりはるかに小さい値でなければなりません。デフォルトによって、このコミット・サイズは 50 アイテムとなります。

大量のデータ転送では、コミット・サイズとロールバック・セグメントを構成する必要があります。 ユーザーのデータベースで使用するコミット・サイズとロールバック・セグメントを確認するには、ユーザー側のデータベース文書を参照してください。この値を変更する必要があるのは、データベース・アドミニストレーターによって許可された場合だけです。

Tivoli Problem Management との互換性

アーカイブ・ユーティリティーは Tivoli Problem Management データとともに作動するので、Tivoli Problem Management に対する変更またはカスタマイズがアーカイブ・ユーティリティーに影響することがあります。 Tivoli Problem Management を変更した場合には、そのアーカイブ・ユーティリティーがそれらの変更と互換していることを確認する必要があります。

次の Tivoli Problem Management 変更では、Tivoli Problem Management データとともに使用するために、そのアーカイブ・ユーティリティーの変更が必要となります。

  • アーカイブ・ユーティリティーのインストール後の Tivoli Problem Management のインストール
  • Tivoli Problem Management PROBLEMS、SESION、CALL、PROBLEM_HISTORY または WORK_HISTORY のテーブルに対するカスタマイズ

次の項には、これらの変更の後で Tivoli Problem Management の互換性を維持するために行なわれるステップが説明されています。

Tivoli Problem Management のカスタマイズ

データベースにアーカイブして、Tivoli Problem Management データベースの次のテーブルの 1 つをカスタマイズした場合には、そのアーカイブ・ユーティリティーをカスタマイズして、これらの変更を反映させる必要があります。
  • PROBLEMS
  • SESION
  • CALL
  • PROBLEM_HISTORY
  • WORK_HISTORY

アーカイブ・テーブルのカスタマイズには、次の 2 つのステップが含まれています。

  • アーカイブ・テーブルを作成するビルド・スクリプトの変更、または そのテーブル自体の変更
  • アーカイブ・テーブルの変更を反映させるための eaacust.kb ファイルの編集

インストールの前の、アーカイブ・データベース・テーブルをカスタマイズするもっとも簡単な方法は、そのテーブルをビルドするスクリプトを変更する方法です。ただし、インストールの後では、ビルド・スクリプトを再実行すると、そのテーブル中のすべてのデータが破棄されます。その代わりに、アーカイブ・データベース・テーブル自体を直接カスタマイズする必要があります。データベース・テーブルのカスタマイズの詳細については、ユーザーの DBMS の文書を参照してください。

eaacust.kb を変更する時点

アーカイブ・ユーティリティーによって使用される Tivoli Problem Management のそれぞれのテーブルは、eaacust.kb ファイルのプロシージャーと対応しています。そのプロシージャー名は下記にリストされています。各プロシージャーの名前には、それと対応するテーブルの名前が含まれています。
  • EAProblems
  • EASesion
  • EACall
  • EAProblem_History
  • EAWork_History

Tivoli Problem Management 中のこれらのテーブルのどれかをカスタマイズした場合には、eaacust.kb ファイルの対応するプロシージャー項目を変更する必要があります。

文字列または整数データ

データのタイプに応じて Tivoli Problem Management テーブルに追加した場合には、異なったプロシージャーを使用して、新規のフィールドを eaacust.kb プロシージャーに定義する必要があります。
  • char および vchar フィールドなどの文字列では、AddStr を使用してください。
  • 整数および日付のフィールドなどの文字列以外では、AddNonStr を使用してください。

AddStr と AddNonStr プロシージャーは、次の通り同じパラメーターを取ります。

( VAL Wrap : STRING, VAL Delmtr : STRING, 
REF str : STRING, VAL newstr : STRING)

このパラメーターの説明は次の通りです。

パラメーター 説明
Wrap 出力テキスト・ファイルの文字列または文字列以外を囲むために入れられる文字
Delmtr 出力テキスト・ファイルの列を区切るために使用される文字
str その値が実行時に定義される、参照パラメーター。このパラメーターの引き数として、つねに "str" を使用してください。
newstr 新規フィールドの名前。

これらのパラメーターの引き数として使用する各ファイル・エクスポート文字の説明については、アーカイブ・ユーティリティーで使用される API を参照してください。

たとえば、Tivoli Problem Management テーブルに列を追加した場合には、その追加の列と対応する eaacust.kb のプロシージャーに改行を追加する必要があります。

問題コードに対する変更を追跡するために、Tivoli Problem Management の PROBLEM_HISTORY テーブルに Problem_Code フィールドを追加した、とします。その後、その Problem_Code フィールドと対応する eaacust.kb の EAProblem_History プロシージャーに改行を追加する必要があります。

問題コードが文字列であるために、EAProblem_History プロシージャーに新規の Problem_Code フィールドを定義するために追加する行は次のようになります。

AddStr( STD, DELM, str, ph.problem_code);

タスク

アーカイブ・ユーティリティーの構成と実行

次のステップには、アーカイブ・ユーティリティーを使用するためのガイドラインが示されています。
  1. プログラムの開始に示された通りに、アーカイブ・ユーティリティーを開始します。
    「Tivoli Problem Management アーカイブ・ユーティリティー」ウィンドウが表示されます。
  2. 「Tivoli Problem Management の構成」の下で、そのバージョンおよびデータ・ソース情報を検査してください。
  3. 「データ宛先」の下で、アーカイブ・ファイルを送信する場所を選択します。
    フラット・ファイルを選択した場合には、次のステップに進んでください。
    そうでない場合には、ステップ 11 に進んでください。
  4. 次の 1 つを実行してください。
    • 「ファイル名」ボックスでは、データをアーカイブする全パスおよびファイル名を入力して、ステップ 11 に進みます。
    • 「ファイル名ブラウズ」ボタンを選択します。
  5. 「フラット・ファイルの選択」ダイアログ・ボックスでは、アーカイブ宛先として既存のファイルをポイントして、ステップ 8 に進みます。
  6. 「オープン」を選択します。
  7. 「ファイルの存在」メッセージが表示されて、アーカイブされたデータをファイルに追加するかどうかを尋ねられた時に、「Yes」を選択します。
    ステップ 10 に進みます。
  8. アーカイブされたファイルが常駐することになるフォルダーをポイントして、ファイル名を指定します。
  9. 「オープン」を選択します。
  10. 「Tivoli Problem Management アーカイブ・ユーティリティー」ウィンドウが表示され、その「ファイル名」が埋め込まれています。
  11. 次の 1 つを実行してください。
    • 「クローズ日付の開始」ボックスでは、アイテムをアーカイブする開始日を入力します。
    • 「カレンダー」ボタンを選択し、「カレンダー」を使用して日付を指定します。
  12. 次の 1 つを実行してください。
    • 「開始の日付」ボックスでは、アイテムをアーカイブする終了日を入力します。
    • 「カレンダー」ボタンを選択し、「カレンダー」を使用して日付を指定します。
  13. 次の 1 つを実行してください。
    • 「アーカイブする合計アイテム数」ボックスでは、アーカイブするアイテム数を入力します。
    • 「予測」を選択します。
  14. 「コミット・サイズ」ボックスでは、コミットを行なう前にアーカイブされるアイテム数を入力するか、あるいはデフォルトのままにします。
  15. 「実行」を選択します。
  16. 「実行」ダイアログ・ボックスでは、「了解」を選択します。
    「アーカイブ処理」ダイアログ・ボックスが現れます。
    アーカイブ処理が完了すると、「完了」ダイアログ・ボックスが表示されます。
  17. 「了解」を選択します。
  18. 「Tivoli Problem Management アーカイブ・ユーティリティー」ウィンドウが再表示されたら、「終了」を選択してください。
    アーカイブ・ユーティリティーがクローズされます。

複数マシン上でのアーカイブ・ユーティリティーの実行

異なった時間に 1 つまたは複数のマシン上でアーカイブ・ユーティリティーを実行することが懸命である場合があります。複数のマシンの使用を選択するのは、次の状態によって決まります。
  • データをアーカイブする容量
  • アーカイブを実行するために制限された時間
    注意: 1 つの MS-SQL サーバーまたは Sybase データベースで一度に複数のアーカイブ・ユーティリティーを実行しないでください。これらのデータベースは低レベル・ロックではなく、ページ・レベル・ロックをサポートします。すなわち、アーカイブの同時実行では、パフォーマンスが低下します。

複数マシン上でアーカイブ・ユーティリティーを実行する場合には、次が必要です。

  1. それぞれのマシンでアーカイブ・ユーティリティーを開始する。
  2. それぞれのマシンが同じデータ・ソースを参照していることを確認する。
  3. それぞれのマシンに、重ならない日付範囲を入力する。
    注: たとえば、あるマシンに 1/1/1997 〜 4/15/1997 の日付範囲を使用した場合には、別のマシンでは 4/16/1997 〜 6/30/1997 の日付範囲を使用することができます。
  4. 「実行」を選択します。
    それぞれの日付範囲に含まれるデータがアーカイブされます。
    注: 同じデータベースで同時にアーカイブを実行すると、Tivoli Problem Management のパフォーマンスが低下する原因になることがあります。

アーカイブ・ユーティリティー実行後のテーブルの除去

ユーティリティーの実行後に、そのアーカイブ・ユーティリティーで使用したテーブルの除去を考慮したい場合があります。テーブルを除去すると、データ・ソースのスペースが大きく節約されます。

注意: 除去されるテーブルのデータが将来の利用のために必要となる場合には、そのアーカイブ・テーブルを除去する前に、それをバックアップしてください。

アーカイブ・ユーティリティーで使用するために作成したテーブルを除去するには、そのデータベース・サーバーと対応したスクリプトを選択して、TSD Build でそれを使用してください。

ユーザーの DBMS このスクリプト・ファイルの除去の実行
Oracle 7.x eaaor7.drp
DB2 eaadb2.drp
MS-SQL Server eaamss.drp
Sybase 10.x eaassyb.drp
Informix eaainf.drp

TSD Build の使用の詳細については、Tivoli Service Desk インストールの手引き を参照してください。

DDM で使用するためのアーカイブ・テーブルの変更

データベースへのアーカイブを行ない、Tivoli Problem Management で使用するために DDM をインストールする場合には、そのアーカイブ・テーブルが DDM と互換していることを確認する必要があります。

アーカイブ・ユーティリティーのインストールの後で DDM をインストールして、アーカイブ・テーブルを作成する場合には、ユーティリティーの DBMS と対応した .alt スクリプト・ファイルを実行することによって、DBMS で使用するためにそのテーブルを変更することができます。このためにどのビルド・スクリプト (.tab スクリプト) も実行する必要は ありません 。これを行なうと、アーカイブ・テーブル中に現在あるデータが破棄されます。

DDM で使用するためのアーカイブ・テーブルを変更するには、次のステップに従ってください。

  1. Tivoli Problem Management での使用のためにアーカイブ・テーブルの変更に記述されている通りに、.alt スクリプトの実行用プロシージャーを完了します。
  2. アーカイブ・ユーティリティー・ファイルの解析 に記述されている通りに、アーカイブ・ユーティリティーを解析します。

eaacust.kb の編集

次の手順では、eaacust.kb を編集する方法が説明されています。
  1. ユーザー・システムのテキスト・エディターをオープンします。
  2. 「ファイル」メニューから、「オープン」を選択します。
  3. 「ファイルのオープン」ダイアログ・ボックスから、eaacust.kb を保管するディレクトリーを選択します。
  4. eaacust.kb を選択します。
  5. 「了解」を選択します。
    結果: ファイル eaacust.kb がエディターのテキスト・ウィンドウに表示されます。
  6. ユーザーがカスタマイズした Tivoli Problem Management テーブルと対応したプロシージャーにスクロールダウンします。
  7. そのテーブルの新規のそれぞれの行を示すために行を追加します。
    注: フィールドを定義するには、それに適切な AddStr または AddNonStr を使用してください。
  8. 「ファイル」メニューから、「保管」を選択します。
  9. テキスト・エディターを終了します。
  10. 「Tivoli アーカイブ・ユーティリティー」プログラム・グループで、「アーカイブ・ユーティリティーの解析」アイコンを選択します。
    結果: そのアーカイブ・ユーティリティーが解析します。