attachClobToFile()

The lobLib.attachClobToFile() system function associates a specified file with a CLOB variable.

If the file exists, the function uses the existing file; otherwise, the function creates the file. The function releases all previous memory or file resources associated with the variable and resets the length of the file to zero. The function does not write the current value of the CLOB variable to the file upon making the association. However, future changes to the variable, such as setClobFromString() or reading from a database into the variable, write the value of the variable to the associated file.

To save an existing value of the CLOB variable into a file, use the updateClobToFile() system function.

Syntax

  lobLib.attachClobToFile(
    clobVariable CLOB inOut,
    fileName STRING in)
clobVariable
The CLOB variable. If this parameter has a null value, EGL throws a NullValueException.
fileName
The name of the file. The name is fully qualified or is relative to the directory from which the program is invoked.

Feedback