com.HTTPResponse.getFileResponse

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

Syntax

getFileResponse( )
   RETURNING filename STRING
  1. filename is the absolute path to the file containing the HTTP response.

Usage

Reads an HTTP response and creates a file from it.

The file is created in the temporary directory used by the runtime system (DBTEMP). The name of the file will be the basename found in the HTTP Content-Disposition Header, if this basename is not specified, the filename will be 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)