seterrMsg()

Sets a string containing an error or informational message in the return-status descriptor.

Syntax

void seterrMsg(char * errMsg);

Parameters

errMsg[in]
Is the message string.

Return values

None.

Notes

You can use seterrMsg() to return a string containing a message to an integration broker.

Examples

int ExampleBOHandler::doVerbFor(BusinessObject &theObj, 
   ReturnStatusDescriptor *rtnObj)
{
int status = BON_SUCCESS;
char *verb = theObj.getVerb();
 
if (strcmp(verb, CREATE) == 0)
   status = doCreate(theObj);
else if (strcmp(verb, Verb) == 0)
   // Check for other verbs and call verb routines
   else 
   {
      // Send the collaboration a message that
      // this verb is not supported.
      char errorMsg[512];
      sprintf(errorMsg, "The verb '%s' is not supported ", verb);
      rtnObj->seterrMsg(errorMsg);
      status = BON_FAIL;
   }
 
return status;
}

Copyright IBM Corp. 1997, 2004