ADD-BUFFER( ) method

Adds one new buffer to a query object or dynamic ProDataSet object, without affecting the other buffers, if any.

Use the SET-BUFFERS( ) method to remove all prior buffers and set all buffers for the object at the same time.

Return type: LOGICAL

Applies to: ProDataSet object handle, Query object handle

Syntax

ADD-BUFFER ( buffer )

buffer

A handle to a buffer, or a CHARACTER expression that evaluates to the name of a DEFINED buffer (you cannot specify the default buffer), that the AVM searches for at run time.

Note: The maximum number of buffers for a query or ProDataSet is 200.

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.

The following is an example when the parameter is a handle to a buffer:

my-query-handle:ADD-BUFFER(BUFFER Customer:HANDLE).

The following is an example when the parameter is a CHARACTER expression:

DEFINE BUFFER bCustomer FOR Customer.
my-query-handle:ADD-BUFFER("bCustomer").