Message file: Name and location

The content of the collaboration message file is stored as part of the collaboration template. When you compile and deploy a collaboration, Process Designer Express extracts the message content and creates or updates the message file for runtime use. After compilation, the message file is located in the \Templates\messages directory of your Integration Component Library project in System Manager. After deployment, the message file is copied and placed in the productDir\collaborations\messages directory.

The name of the message file has the following format:

CollaborationName.txt
 

For example, when you compile and deploy a collaboration template named SampleHello, Process Designer Express creates a message file called SampleHello.txt and places it in the collaborations\messages subdirectory.

Important:
Never make changes directly to a collaboration message file. Always use Process Designer Express to edit template messages.

The collaboration message file contains all text strings that the collaboration uses. These strings include those for logging, exception handling, and email operations.

Note:
InterChange Server standards recommend that trace messages are not included in a collaboration message file because end users do not normally view them.

For an internationalized collaboration, it is important that these text strings are isolated into the collaboration message file so that this message file can be translated. The name of the translated collaboration message file must include the name of the associated locale (CollaborationName_ll_TT.txt).

In the preceding line, ll is the two-letter abbreviation for the locale (by convention in lowercase letters) and TT is the two-letter abbreviation for the territory (by convention in uppercase letters). For example, the version of the SampleHello collaboration's message file that contains U.S. English messages has the name SampleHello_en_US.txt

At runtime, the collaboration runtime environment locates the appropriate message file for the collaboration locale (inherited from InterChange Server) from the collaborations\messages subdirectory. For example, if the collaboration locale is U.S. English (en_US), the collaboration runtime environment retrieves messages from the CollaborationName_en_US.txt file.

For more information on how to internationalize the text strings of a collaboration, see An internationalized collaboration.

Copyright IBM Corp. 2003, 2004