メッセージの位置

すべてのメッセージ・ファイルは、IBM WebSphere Business Integration Server Express 製品ディレクトリー内の以下のディレクトリーにあります。

DLMs¥messages
 

注:
本書では、ディレクトリー・パスの規則として円記号 (¥) を使用します。UNIX システムの場合、円記号の代わりにスラッシュ (/) を使用します。すべての WebSphere Business Integration Express 製品のパス名は、ご使用のシステムで WebSphere Business Integration Express 製品がインストールされているディレクトリーを基準とした相対パス名です。

マップに関するメッセージの生成に使用できるメッセージ・ファイルとして、以下の 3 種類のファイルがあります。

これら 3 つのファイルは、マップ固有のファイルから汎用ファイルまでの用途に使用できます。任意のマップが使用できるメッセージは、WebSphere Business Integration Express 提供の汎用ファイル内にあります。他の 2 つのファイルは、作成するマップの必要に応じてメッセージをカスタマイズするためのオプションとなります。

要確認:
InterChange Server Express は、始動時に UserMapMessages.txt ファイルおよび CWMapMessages.txt ファイルをメモリーに読み込みます。UserMapMessages.txt に変更を加えた場合は、その変更内容がマップで有効になるように InterChange Server Express を再始動する必要があります

表 143. CwMapMessages.txt のメッセージ
メッセージ番号 メッセージ・テキスト メッセージの用途
5000 Mapping - Value of the primary key in the source object is null. Map execution stopped. ソース・オブジェクトの基本キーが null の場合に使用されます。ソース・オブジェクトの基本キーに基づいた関係メソッドのいずれかが呼び出される前に、ソースの基本キーが null であるかどうかのチェックを必ず実行する必要があります。基本キーが null の場合、エラーが表示され、マップの実行が停止されます。
5001 Mapping - RelationshipRuntimeException.
Map execution stopped.
以下のいずれかで RelationshipRuntimeException がキャッチされた場合に使用されます。

  • 関数ブロック
    • General/APIs/Identity Relationship/Maintain Simple Identity Relationship
    • General/APIs/Identity Relationship/Maintain Composite Relationship
  • マッピング API
    • maintainSimpleIdentityRelationship()
    • maintainCompositeRelationship()
5002 Mapping - CxMissingIDException.
Map execution stopped.
以下のいずれかで CxMissingIDException がキャッチされた場合に使用されます。

  • 関数ブロック
    • General/APIs/Identity Relationship/Maintain Simple Identity Relationship
    • General/APIs/Identity Relationship/Maintain Composite Relationship
  • マッピング API
    • maintainSimpleIdentityRelationship()
    • maintainCompositeRelationship()
5003 Mapping - Data in the {1} attribute is missing. 関数ブロック Foreign Key Lookup (foreignKeyLookup()) または Foreign Key Cross-Reference (foreignKeyXref()) を使用する前に、ソース属性が null になっていた場合に使用されます。 これらの関係メソッドが呼び出される前に、ソース属性が null であるかどうかのチェックを必ず実行する必要があります。基本キーが null の場合、エラーが表示され、マップの実行が停止されます。
5007 Mapping - ForeignKeyLookup() of '{1}' with Source Value of '{2}' failed for the '{3}' relationship and '{4}' participant on Initiator '{5}'. Map execution stopped. 関数ブロック Foreign Key Lookup (foreignKeyLookup()) を使用した後、宛先属性が null になった場合に使用されます。 マップの実行を停止する必要があります。
5008 Mapping - ForeignKeyLookup() of '{1}' with Source Value of '{2}' failed for the '{3}' relationship and '{4}' participant on Initiator '{5}'. Map execution continued. 関数ブロック Foreign Key Lookup (foreignKeyLookup()) を使用した後、宛先属性が null になった場合に使用されます。マップの実行を続行する必要があります。
5009 Mapping - ForeignKeyXref() of '{1}' with Source Value of '{2}' failed for the '{3}' relationship and '{4}' participant on Initiator '{5}'. Map execution stopped. 関数ブロック Foreign Key Cross-Reference (foreignKeyXref()) を使用した後、宛先属性が null になった場合に使用されます。マップの実行を停止する必要があります。

マップがメッセージ番号を参照するとき、以下の順にメッセージ・ファイルが検索されます。

  1. マップ固有のメッセージ・ファイルmapName_locale. txt (mapName はマップ名) が検索される。
  2. ファイル UserMapMessages.txt が検索される。
  3. WebSphere Business Integration Express の汎用メッセージ CWMapMessages.txt が検索される。

表 144 に、CwMapMessages.txt ファイル内の各メッセージが使用される状態を示したコード例を示します。

表 144. CwMapMessages.txt メッセージのコード例
メッセージ番号 コード例
5000 ObjContract.setVerb(ObjSAP_Contract.getVerb()); if (ObjSAP_Contract.get("ContractId") == null) { logError(5000); throw new MapFailureException( "Data in the primary key is missing"); }
5001 try { IdentityRelationship.maintainSimpleIdentityRelationship( "Contract", "SAPCntr", ObjSAP_Contract, ObjContract, cwExecCtx); } catch (RelationshipRuntimeException e1) { logError(5001); throw new MapFailureException( "RelationshipRuntimeException"); } catch (CxMissingIDException e2) { logError(5002); throw new MapFailureException("CxMissingIDException"); }
5002 上記のコード例を参照してください。
5003 if (ObjSAP_Contract.get("CustomerId") == null) { logError(5003, "CustomerId"); throw new MapFailureException("CustomerId is null"); }
5007
try
    {
    IdentityRelationship.foreignKeyLookup ("Customer",
       "OracCust", ObjOracle_OrderImport, "customer_id",
       ObjOrder, "CustomerId", cwExecCtx);
    } 
 catch (RelationshipRuntimeException e)
    { 
    logWarning(e.toString());
    }
 if (ObjOracle_OrderImport.get("customer_id") == null)
    {
    logError(5007, "customer_id", "CustomerId", "Customer",
       "OracCust", strInitiator);
    throw new MapFailureException(
       "foreignKeyLookup() failed.");
    }
 
5008
try
    {
    IdentityRelationship.foreignKeyLookup ("Customer",
       "OracCust", ObjOracle_OrderImport, "customer_id",
       ObjOrder, "CustomerId", cwExecCtx);
    } 
 catch (RelationshipRuntimeException e)
    { 
    logWarning(e.toString());
    }
 if (ObjOracle_OrderImport.get("customer_id") == null)
    {
    logError(5008, "customer_id", "CustomerId", "Customer",
       "OracCust", strInitiator);
    }
 
5009 try { IdentityRelationship.foreignKeyXref ("Customer", "OracCust", "CWCust", ObjOracle_OrderImport, "customer_id", ObjOrder, "CustomerId", cwExecCtx); } catch (RelationshipRuntimeException e) { logWarning(e.toString()); } if (ObjOracle_OrderImport.get("customer_id") == null( { logError(5009, "customer_id", "CustomerId", "Customer", "OracCust", strInitiator); throw new MapFailureException( "foreignKeyXref() failed."); }

Copyright IBM Corp. 2004