Reference Guide › Reference › 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. DNAXMLAccess.dll enables the component to be called directly from a Visual Basic program or any script language that supports ActiveX controls. The following examples use member functions in this access:

• 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:

• 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"
  

• 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")