com.TCPRequest.doRequest

Performs a TCP request.

Syntax

doRequest()

Usage

The doRequest() method performs the TCP request.

The connection is shutdown for writing, to notify that no data will be sent.

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)

Example

IMPORT com
IMPORT XML

MAIN
  DEFINE url STRING
  LET url = "tcp://localhost:4242"
  CALL an_example(url)
END MAIN

FUNCTION an_example(url)
DEFINE url STRING
DEFINE req com.TCPRequest
DEFINE resp com.TCPResponse
DEFINE ret xml.DomDocument

TRY
  LET  req = com.TCPRequest.create(url)
  CALL req.doRequest()
  LET  resp = req.getResponse()
  LET  ret = resp.getXmlResponse()  
CATCH
  DISPLAY "ERROR : ", STATUS, SQLCA.SQLERRM
  EXIT PROGRAM(-1)   
END TRY

END FUNCTION