SET-BUFFERS( ) method

Binds all buffers for a query or dynamic ProDataSet object at the same time. Any buffers previously added to the ProDataSet object are removed.

Use the ADD-BUFFER( ) method to add one buffer to the object, without affecting the other buffers, if any.

Return type: LOGICAL

Applies to: ProDataSet object handle, Query object handle

Syntax

SET-BUFFERS ( buffer [ , buffer ] ... )

buffer

A handle to a buffer, or a CHARACTER expression that evaluates to the name of a buffer that the AVM searches for at run time.

The maximum number of buffers per query is 18.

Note: Searching for a buffer using a handle is more efficient than a character expression. The AVM resolves a character expression at run time by searching in the current routine for a static buffer with that name. If not found, the AVM searches the enclosing main procedure. If still not found, the AVM searches up through the calling programs of the current routine, and their main procedures. Since a handle uniquely identifies the buffer, no such search is required.

Following is an example:

my-query-handle:SET-BUFFERS(BUFFER customer:handle).