com.HTTPServiceRequest.readFileRequest

Syntax

readFileRequest( )
    RETURNING filename STRING

1. filename the absolute path to the file containing the HTTP response.

Usage

The readFileRequest() method returns the body of the request into a file on the disk.

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.

Supported methods are PUT and POST.

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)