READ_CLIENT_FILE( client-filename-expression )

LONG BINARY

The value returned by the READ_CLIENT_FILE function represents the contents of the specified client file. You can use the function in syntax wherever a BINARY expression is allowed.

Since the data returns as a binary string, if the data is in another character set, or is compressed, or is encrypted, you may also need to perform character set conversion, decompression, or decryption on it.

During evaluation of READ_CLIENT_FILE, the database server initiates the transfer of the specified file from the client. The client, upon receiving the transfer request, obtains a shared lock on the client file, and holds the lock until the database server requests the client to terminate the request.

Reading of the file is performed by the client software library, and the transfer of data is done using the command sequence communication protocol.

When reading from a file on a client computer:

• allow_read_client_file option
• -sf dbeng12/dbsrv12 server option
• READCLIENTFILE authority

• Access to data on client computers
• READCLIENTFILE authority
• DECOMPRESS function [String]
• DECRYPT function [String]
• CSCONVERT function [String]