com.HTTPRequest.doDataRequest

Performs the request by sending binary data.

Syntax

doDataRequest(
   data BYTE )
  1. data is the binary data.

Usage

Performs the request by sending binary data contained in the BYTE variable.

Supported methods are PUT and POST.

The BYTE must be located in memory and not NULL otherwise operation fails.

The default Content-Type header is application/octet-stream, but it can be changed to any other mime type. For example: image/jpeg.

In HTTP 1.1, if the body size is greater than 32k, the request will be sent in several chunks of the same size.

This HTTP request method is non-blocking: It returns immediately after the call. Use the com.HTTPRequest.getResponse method, to perform a synchronous HTTP request, suspending the program flow until the response returns from the server. If the program must keep going on, use the com.HTTPRequest.getAsyncResponse method, to check if a response is available.

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)