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, 2003