FUNCTIONUnder review

MSCreate

MsCreate(cArquivo,aEstrut,[cDriver]) -> lOk

Creates a file or table from a field structure.

MSCreateAdvPL

01 · OVERVIEW

Overview

Each field uses name, type, length and decimals. An omitted driver uses the current RDD. TOP needs the appropriate connection and environment. Creation should use a unique test name without replacing production structures. Historical reference: verify behavior in the deployed release/RDD. (Sources: refs. 1–1.)

02 · SYNTAX

Syntax

MsCreate(cArquivo,aEstrut,[cDriver]) -> lOk

Parameters

cArquivo

CharacterRequired

Authorized name for the new file/table.

aEstrut

ArrayRequired

Fields {name,type,length,decimals}.

cDriver

CharacterOptional

RDD driver; defaults to current.

Return value

Logical result of the documented operation.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

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