FUNCTIONUnder review

MSAppend

MsAppend([cArqDest],cArqOrig) -> lOk

Appends source records to a destination table.

MSAppendAdvPL

01 · OVERVIEW

Overview

Requires compatible structures. With DBFCDX, an omitted destination uses the current work area; TOP requires a destination. This is not a binary file copy. Historical reference: verify behavior in the deployed release/RDD. (Sources: refs. 1–1.)

02 · SYNTAX

Syntax

MsAppend([cArqDest],cArqOrig) -> lOk

Parameters

cArqDest

CharacterOptional

Destination; required with TOP.

cArqOrig

CharacterRequired

Source records.

Return value

Logical result of the documented operation.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed533()
    // Block not invoked; supply only authorized test artifacts.
    Local bOperation := {|cSource,cDest| MsAppend(cDest,cSource)}
    ConOut(ValType(bOperation))
Return Nil

Expected result

Prints B. The operation is not executed; check its logical result when integrating. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES

Check RDD, connection, path and destination ownership. Handle failures, collisions and open resources. This fragment is not a production backup or migration procedure.
Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.