com.HTTPServiceRequest.sendResponse

Sends an HTTP response without body.

Syntax

sendResponse(
   code INTEGER,
   description STRING )
  1. code specifies the status code of the response.
  2. description specifies the description of the response.

Usage

The sendResponse() method performs the HTTP response by sending a status (code) and description (description), followed by the headers previously set, without a body.

It is important for the server to return a correct status code, following the HTTP standards, otherwise the client may fail to interpret the response. For instance, if the request is malformed, the server is expected to send an HTTP response with the code of 400 (Bad Request). See HTTP status codes (wikipedia) for more details about common HTTP response codes.

If the description is NULL, a default description based on the status code is sent.

New incoming requests can be retrieved again with the com.WebServiceEngine.GetHTTPServiceRequest() method.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).

The INT_FLAG variable is checked during GWS API call to handle program interruptions, for more details, see Interruption handling in GWS calls (INT_FLAG)