mpiMessage

Declaration

const char *mpiMessage(long  messageId,
                       char  *messageText) 

Required Header: message.h

Description

mpiMessage returns the text message associated with messageId and copies the text to messageText if messageText is not NULL.

If "messageText" is
Then
NULL Message returns a pointer to message text resident in the library
not NULL Message returns the pointer messageText, which must point to a buffer large enough to hold the message text (that will be copied into it)
Return Values
NULL if messageId is invalid
Pointer to an empty string (" ") if the messge utility is not enabled or the message function pointer associated with messageId is NULL1.
Pointer to a non-zero-length string if the mpiMessage successsfully retrieves the message associated with messageId.

ObjectCreate(...) methods register the appropriate message function associated with Object’s module. If the MPI returns a certain messageId, then the appropriate message function should already be loaded and mpiMessage should return the appropriate error code. Only an application whose job is to translate message IDs specified by some source other than the MPI (user or a log file) to error messages will need to call the create methods of all MPI objects. MEI recommends using the message.exe utility for this task, since it is already designed to manage these issues.

See Also

mpiMessageFunction | message.exe utility