FUNCTIONUnder review

MSCopyTo

MsCopyTo([cArqOrig],cArqDest) -> lOk

Copies records and structure to a destination.

MSCopyToAdvPL

01 · OVERVIEW

Overview

An omitted source may use the current work area for local access; TOP requires it explicitly. Destination is required. Unlike MsCopyFile, this operation handles records through the driver. Historical reference: verify behavior in the deployed release/RDD. (Sources: refs. 1–1.)

02 · SYNTAX

Syntax

MsCopyTo([cArqOrig],cArqDest) -> lOk

Parameters

cArqOrig

CharacterOptional

Source; required with TOP.

cArqDest

CharacterRequired

Destination for copied records.

Return value

Logical result of the documented operation.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed535()
    // Block not invoked; supply only authorized test artifacts.
    Local bOperation := {|cSource,cDest| MsCopyTo(cSource,cDest)}
    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.