FUNCTIONUnder review

SUPERGETMV()

SuperGetMV(cName,lHelp,xDefault,[cBranch]) -> xValue

Reads SX6 parameters through the documented cache.

SUPERGETMV()AdvPL

01 · OVERVIEW

Overview

Arguments are the name without branch, help option, default value and optional branch. Documentation describes an in-memory cache for repeated reads; check refresh policy when parameters change. Match default type to the expected value and choose branch deliberately. This uninvoked query uses numeric zero; MV_X_ED680 is fictional rather than a product-standard parameter. (Sources: refs. 1–2.)

02 · SYNTAX

Syntax

SuperGetMV(cName,lHelp,xDefault,[cBranch]) -> xValue

Parameters

cName

CharacterRequired

Parameter name without branch.

lHelp

LogicalRequired

Shows help if not found.

xDefault

VariantRequired

Default matching expected type.

cBranch

CharacterOptional

Branch; current by default.

Return value

Content or default, type determined by parameter.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed680()
    // Fictional name; the block neither reads nor creates a parameter.
    Local bParameter := {|| SuperGetMV("MV_X_ED680",.F.,0)}
    ConOut(ValType(bParameter))
Return Nil

Expected result

Creates block B. No environment value or cache state was verified. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES

Test missing parameters, type, branch and session-time changes; do not log secret parameters.
Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.