Message location

All message file are located in the following directory of the IBM WebSphere InterChange Server Express product directory:

DLMs\messages
 

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

There are three types of message files that 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 IBM WebSphere InterChange 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 112. 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 be always 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 be always 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 IBM WebSphere InterChange Server Express generic message CWMapMessages.txt is searched.

Copyright IBM Corp. 1997, 2003