reccopy

Syntax

stat = RECCOPY(sourcefacsname, destinationfacsname)

Arguments

stat: integer

sourcefacsname, destinationfacsname: facsname

Meaning

Copies the contents of the record that was read from sourcefacsname to the record that was read from destinationfacsname. If you're planning to write a new record in destinationfacsname with the copied data, you don't read a record from this database first. If your source FACS database is _LOCAL, then you don't need to read this record first either, since _LOCAL already contains the currently processed record. All fields with data will be copied, regardless of which fields have been included in the relevant FACS definitions. Data dictionary fields for which the Exchangeable option has been deselected won't be copied along though.

The record number of destinationfacsname remains unchanged when you've read an existing destination record. The current contents of destinationfacsname is overwritten with the contents of sourcefacsname.

For RECCOPY to be effective, destinationfacsname must be written with WRITE destinationfacsnaam or WRITE destinationfacsname NEXT. If WRITE NEXT is used, a new record is added in destinationfacsname.

See also

Click here for general information about FACS.