GATHER Command

Writes data from memory variables or an object into the current record.

Syntax

GATHER [MEMO] [NAME oRec | MEMVAR]

Parameters

MEMO

Includes all memo and blob fields when writing the record. GATHER skips memo fields by default. Including memo and blob fields can potentially result in a long during operation especially when performed across a wireless network or a dial-up VPN connection.

When memo and blob fields are written back, their content is always appended to the memo file, even when their content doesn't differ. The MEMO clause does therefore contribute to memo bloat.

NAME oRec

Writes properties of an object into fields of the same name into the current record. Properties that do not have a corresponding field are skipped without notice. Fields that do not have a corresponding property are not changed.

MEMVAR

Locates variables with the same name as the fields in the current record of the active work area. If a variable exists, the value of the variable replaces the content of the field. If the variable does not exist, no error is raised.

See also

SCATTER Command