FUNCTIONUnder review

MSFile

MsFile(cArquivo,[cIndice],[cDriver]) -> lExists

Checks file or table existence through the RDD.

MSFileAdvPL

01 · OVERVIEW

Overview

Takes the artifact name and optional index/driver. Existence does not confirm schema, write access or absence of locks. This is not a file-handle open operation. Historical reference: verify behavior in the deployed release/RDD. (Sources: refs. 1–1.)

02 · SYNTAX

Syntax

MsFile(cArquivo,[cIndice],[cDriver]) -> lExists

Parameters

cArquivo

CharacterRequired

Artifact to inspect.

cIndice

CharacterOptional

Index according to driver.

cDriver

CharacterOptional

RDD driver.

Return value

Logical result of the documented operation.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

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