情報カタログ・マネージャー プログラミングの手引きおよび解説書

FLGMdisImport

メタデータを、メタデータ交換仕様 (MDIS) に 適合するファイルから情報カタログ・マネージャーへインポートします。 MDIS メタデータのインポート先の情報カタログには、有効 な MDIS オブジェクト・タイプ定義が含まれていなければな りませんが、それに限定されることはありません。 情報カタログ・マネージャー 管理の手引き の付録 B には、情報カタログ・マネージャー定義済みオブジェクト・タイプ とそれらを MDIS にマップする方法が説明されています。

許可

管理者

構文



APIRET  APIENTRY   FLGMdisImport( PSZ              pszTagFileID,
                                  PSZ              pszLogFileID,
                                  PFLGEXTCODE  pExtCode );

パラメーター

pszTagFileID (PSZ) − 入力
タグ言語ファイルを識別します。 このパラメーターは必須パラメーターです。

このパラメーターにはドライブ、ディレクトリー・パス、およびファイル名が 含まれており、FAT または HPFS ファイルとして有効な値でなければなりません。 このドライブは、取り外し可能ドライブであってはなりません。 (ドライブとディレクトリーを除く) ファイル名とエクステンションは、 240 文字を超えてはなりません。 ファイル名だけを入力すると、情報カタログ・マネージャー側は、タグ言語ファイルを DGWPATH 環境変数 で示されるドライブおよびパスに存在するものとみなします。

pszTagFileID によって識別されるファイルには、 インポートされる MDIS 適合メタデータが入っています。

pszLogFileID (PSZ) − 入力
ログ・ファイルのロケーションと名前を指定します。 このパラメーターは必須パラメーターです。

このパラメーターにはドライブ、ディレクトリー・パス、およびファイル名が 含まれており、FAT または HPFS ファイルとして有効な値でなければなりません。 このドライブは、取り外し可能ドライブであってはなりません。 ファイル名だけを指定すると、情報カタログ・マネージャー側は、ログ・ファイルを DGWPATH 環境変数 で示されるドライブおよびパスに配置します。

このパラメーターで指定されたログ・ファイルが存在していない場合には、 新しいファイルが作成されます。 このパラメーターで指定されたログ・ファイルがすでに存在している場合には、 情報カタログ・マネージャーはそれに対して行われます。

pszLogFileID によって識別されたファイルには、ログ情報、およ び FLGMdisImport API 呼び出しの処理中に検出された警告とエラーが入ります。

pExtCode (PFLGEXTCODE) − 出力
理由コードに関連する拡張コードを指します。 戻された理由コードに関連した意味のある拡張コードがあるかどうかについて は、付録 D, 情報カタログ・マネージャーの理由コードを参照してください。

理由コード (APIRET)
この API 呼び出しの実行結果を表します。

戻された理由コードの説明については、付録 D, 情報カタログ・マネージャーの理由コードを参照してくだ さい。

使用方法

MDIS 環境の設定

MDIS のインポートを実行する前に、 MDIS 環境変数を次のように設定します。

SET MDIS_PROFILE=X:\SQLLIB\METADATA\PROFILES

X は DB2 UDB が導入されているドライブです。

他のプロダクトや Visual Warehouse 3.1 と ともに MDIS を使用しているユーザーへの注: すでに MDIS 構成 およびプロファイル・ファイルがある場合、DB2 UDB 導入プログラム はそれらを上書きしていません。 ただし、初めて情報カタログ・マネージャーの MDIS 機能を使用する前に、 情報カタログ・マネージャー MDIS プロファイルおよび構成ファイル内の情報を、 既存のファイルにマージする必要があります。 以下の手順を行います。

  1. MDIS 環境変数の設定を調べ、既存の MDIS プロファイル・ファイル (MDISTOOL.PRO) と 構成ファイル (MDISTOOL.CFG) を探し出します。
  2. テキスト・エディターを使い、既存のプロファイル・ファイル に X:\SQLLIB\METADATA\PROFILES\MDISTOOL.PRO の内容 を追加します。 (X は DB2 UDB を導入したドライブです。)
  3. テキスト・エディターを使い、既存の構成ファイル に X:\SQLLIB\METADATA\PROFILES\MDISTOOL.CFG の 内容を追加します。 (X は DB2 UDB を導入したドライブです。)

MDIS インポート・エラーのデバッグ

情報カタログ・マネージャーは、MDIS 適合ファイルをインポートするときに、 ログ・ファイルを作成します。

ログ・ファイルには、インポート処理で発生した事象が記録されます。 これには、インポート処理が開始および終了した日付と時刻が含まれます。 また、処理中に発生した問題に関する警告やエラー・メッセージも含まれます。 pszLogFileID パラメーターによりログ・ファイルが識別されます。


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]