Message location

All message file sare located in the following directory of the IBM WebSphere Business Integration Server Express product directory:

DLMs\messages

Note:
In this document backslashes (\) are used as the convention for directory paths. For Linux installations, substitute slashes (/) for backslashes. All WebSphere Business Integration Server Express product path names are relative to the directory where the WebSphere Business Integration Server Express product is installed on your system.

Three types of message files can be used to generate messages for a map:

These files range from map-specific to general purpose. Messages that can be used by any map are located in a generic file, provided by WebSphere Business Integration Server Express. The other two files provide you with the option to customize messages for your maps, as needed.

Important:
InterChange Server Express reads the UserMapMessages.txt and CwMapMessages.txt files into memory when it starts up. If you make changes to UserMapMessages.txt, you must restart InterChange Server Express for these changes to be available to maps.
Table 148. CwMapMessages.txt messages
Message number Message text Message usage
5000 Mapping - Value of the primary key in the source object is null. Map execution stopped. Used if the primary key of the source object is null. The check for the source primary key = null should always be performed before any of the relationship methods are called that are based on the source object's primary key. If the key is null, the error should display and the map should stop execution.
5001 Mapping - RelationshipRuntimeException.
Map execution stopped.
Used if RelationshipRuntimeException is caught in one of the following:
  • Function blocks
    • General/APIs/Identity Relationship/Maintain Simple Identity Relationship
    • General/APIs/Identity Relationship/Maintain Composite Relationship
  • Mapping APIs
    • maintainSimpleIdentityRelationship()
    • maintainCompositeRelationship()
5002 Mapping - CxMissingIDException.
Map execution stopped.
Used if CxMissingIDException is caught in one of the following:
  • Function blocks
    • General/APIs/Identity Relationship/Maintain Simple Identity Relationship
    • General/APIs/Identity Relationship/Maintain Composite Realtionship
  • Mapping APIs
    • maintainSimpleIdentityRelationship()
    • maintainCompositeRelationship()
5003 Mapping - Data in the {1} attribute is missing. Used when the source attribute is null before using the function block Foreign Key Lookup (foreignKeyLookup()) or Foreign Key Cross-Reference (foreignKeyXref()). The check for the source attribute = null should always be performed before these relationship methods are called. If the key is null, the error should be displayed and the map might stop execution.
5007 Mapping - ForeignKeyLookup() of '{1}' with Source Value of '{2}' failed for the '{3}' relationship and '{4}' participant on Initiator '{5}'. Map execution stopped. Used if the destination attribute is null after using the function block Foreign Key Lookup (foreignKeyLookup()). Map has to stop execution.
5008 Mapping - ForeignKeyLookup() of '{1}' with Source Value of '{2}' failed for the '{3}' relationship and '{4}' participant on Initiator '{5}'. Map execution continued. Used if the destination attribute is null after using the function block Foreign Key Lookup (foreignKeyLookup()). Map has to continue execution.
5009 Mapping - ForeignKeyXref() of '{1}' with Source Value of '{2}' failed for the '{3}' relationship and '{4}' participant on Initiator '{5}'. Map execution stopped. Used if the destination attribute is null after using the function block Foreign Key Cross-Reference (foreignKeyXref()). Map has to stop execution.

When a map references a message number, the message files are searched in the following order:

  1. The map-specific message file mapName_locale.txt where mapName corresponds to the name of the map, is searched.
  2. The file UserMapMessages.txt is searched.
  3. The WebSphere Business Integration Server Express generic message CwMapMessages.txt is searched.

Table 149 shows code examples that demonstrate situations in which each of the messages in the CwMapMessages.txt file might be used.

Table 149. Code Examples for CwMapMessages.txt Messages
Message number Code example
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 See code example above.
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, 2005