- A map-specific message file,
mapName_locale.txt
where mapName corresponds to the name of the map and
locale corresponds to the locale that the map is defined in.
Map messages appear in the Messages tab of
Map Designer Express and are stored as part of the map definition in the
repository. When you compile the map, Map Designer Express extracts the
message content and creates (or updates) the message file for run-time
use. The name of the message file has the following format:
MapName_locale.txt
Example: For the LegacyAddress_to_CwAddress
map, if it is created in an English locale in the United States, Map Designer
Express creates the message file called
LegacyAddress_to_CwAddress_en_US.txt and places it in the
ProjectName\Maps\Messages directory. After the map is
deployed to InterChange Server Express, it will be placed in the
DLMs\messages directory.
- The
UserMapMessages.txt message file
To this file, you can add new message numbers that fall into a
"safe" range, as defined by WebSphere Business Integration Express
(see Table 143). For example, if you create a message for an Oracle
map, you would assign the message a number between 6101 and 6200. You
can also use a message number that is already defined in the WebSphere
Business Integration Express generic message file
(CWMapMessages.txt, described next) and change the existing
message text to text of your choice. Since the
UserMapMessaages.txt file is searched before the
WebSphere Business Integration Express message file, your additions override
those messages.
- The WebSphere Business Integration Express generic message file,
CWMapMessages.txt (which WebSphere Business Integration Express
provides).
If your map does not reference one of the other two message
files, it must reference this one. Table 143 lists the message numbers that WebSphere Business
Integration Express has assigned and that are contained in the generic message
file.
Attention: Do not change the contents of the
WebSphere Business Integration Express generic message file
CwMapMessages.txt! Make changes to a generic message by
copying it into the UserMapMessage.txt message file and
customizing it.
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 Express. The other two files provide you
with the option to customize messages for your maps, as needed.
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:
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."); }
|