Starts an HTTP streaming request.


  RETURNS xml.StaxReader


The beginXmlRequest() method starts the streaming of HTTP request and returns a xml.StaxReader object ready to read the XML from the client.

Supported methods are PUT and POST.

The request Content-Type header must be of the form */xml or */*+xml. For example: application/xhtml+xml.

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)