6.8.35 DMcob_LoadProfile

With this function variables that can be changed by the end user can be read from a file and processed by the DM. This facility enables end users to influence dialog behavior when the dialog source or the DM are not available.

77  DM-dialogid  pic 9(4) binary value 0.
01  DM-path      pic X(256).

call "DMcob_LoadProfile" using
            DM-StdArgs
            DM-dialogid
            DM-path.

Parameters

<- DM-dialogid

Name of the dialog to be configured.

<- DM-path

Name of the file to be read. The path should be terminated with a low value or the separator character. Otherwise no more than 256 characters are read.

COBOL Interface for Micro Focus Visual COBOL

The parameter may also be passed as National Character (PIC N) when working with Unicode texts (UTF-16).

-> DM-Options of DM-StdArgs

Currently not used. Please specify with 0.

Return Value

DM-status of DM-StdArgs

DM-error

The indicated file is not an error free DM profile, or the file was not found by the DM.

DM-success

The indicated file was an error free DM profile and was processed successfully.

Example

    77    DM-Profile     pic x(256) value spaces.

    

    move "./myModifications@" to DM-profile.

    call "DMcob_LoadProfile" using DM-StdArgs DialogID DM-    profile.

    perform ErrorCheck.