com.HTTPResponse.getFileResponse
Returns the entire HTTP response to 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 file name 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)