com.TCPRequest.beginXmlRequest

Starts a streaming XML request.

Syntax

beginXmlRequest()
  RETURNS xml.StaxWriter

Usage

The beginXmlRequest() method begins a streaming HTTP request and returns an xml.StaxWriter object ready to send XML to the server.

After sending all the XML data to the server, you must call the endXmlRequest() method with the xml.StaxWriter object created by the beginXmlRequest() 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)