com.HTTPResponse.getFileResponse

Returns the entire HTTP response in a file on the disk.

Syntax

getFileResponse( )
   RETURNS STRING

Usage

Reads an HTTP response and creates a file from it.

The method returns the absolute path to the file containing the HTTP response.

The file is created in the temporary directory used by the runtime system (DBTEMP). The name of the file is the basename found in the HTTP Content-Disposition Header. If this basename is not specified, the filename is created with a UUID. If a file with the same name already exists in the temporary directory, the API prefixes the new file with a number. It is then of the form : /tmp/ABC/filename_index.ext, where index represents the number of files with the same name on disk.

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)