Programmatic Access to the DMM Options File

Reference Guide › Batch and Wrapper Files › Programmatic Access to the DMM Options File

Programmatic Access to the DMM Options File

You can programmatically access and manipulate options in a DMM Options file.

DNAXMLAccess.dll is an ATL COM DLL that supports the IDispatch interface. This enables the component to be called directly from a Visual Basic program or any script language that supports ActiveX controls. Some examples of member functions used in this access are shown following:

Open the file specified by bstrFile for access. The file must be a valid DMM Options file in the form of DNAOptions.xml.
```
HRESULT SetFile([in] BSTR bstrFile);
```
Add or replace the string option specified by bstrOption to the value bstrValue.
```
HRESULT SetStringOption([in] BSTR bstrOption, [in] BSTR bstrValue);
```

Retrieve the string option specified by bstrOption.

HRESULT GetStringOption([in] BSTR bstrOption, [out, retval] BSTR* bstrValue);

Add or replace the Boolean option specified by bstrOption to the value fValue.

HRESULT SetBoolOption([in] BSTR bstrOption, [in] VARIANT_BOOL fValue); [out, retval] VARIANT_BOOL* fValue);

Retrieve the Boolean option specified by bstrOption.
```
HRESULT GetBoolOption([in] BSTR bstrOption,
```
Add or replace the integer option specified by bstrOption to the value lValue.
```
HRESULT SetIntOption([in] BSTR bstrOption, [in] LONG lValue);
```

Retrieve the integer option specified by bstrOption.

HRESULT GetIntOption([in] BSTR bstrOption, [out, retval] LONG* lValue);

Visual Basic Example:

To access a DMM Options file using Visual Basic (pseudo code):

REM Create the CPM object for accessing 
Options file
DIM XMLAccess As CNAXMLAccessor
Set XMLAccess = New DNAXMLAccessor

REM Set the file to use for subsequent
XML calls, use the file path you copied above.
XMLAccess.SetFile
"c:\SomeFile\Path\To\MigrationSpecific\
XMLFile.xml"

REM Set any options that need to be customized for this migration
REM BOOL, INT, and STRING options are set like this:
XMLAccess.SetBoolOption "Network log

To access a DMM Options file when the command line exceeds the 255-character limit:

XMLAccess.SetStringOption "command line",
"/D" "c:\MyDNAFile.DNA" "/T"
"C:\MyTemplateFile.dtf"" /M /X"

To use Get* calls to the options file to retrieve post-migration data:

REM Get any options that need to be retrieved after this migration
REM BOOL, INT, and STRING options are retrieved like this:
Dim StringVal As String
DIM BoolVal as Boolean
Dim IntVal As Integer
BoolVal = XMLAccessGetBool-Option("Network log enabled?’)
StringVal = XMLAccess.GetStringOption("Network log level")