VS_OpenDict()        Open the data dictionary                             NEW

Description:

  VS_OpenDict() is used internally by several functions that use the
  data dictionary.  It's also available for your functions that need to
  open the dictionary.

Syntax:     

  l_Success = VS_OpenDict( c_FileName )

Pass:       

  c_FileName is a character expression that must contain one of the
  following values...

     _DICTHDR, _DICTFLD, _DICTNTX

Return:     

  l_Success is a logical expression that will be set to .T. if
  VS_OpenDict() was successful, otherwise it will be set to .F.

Notes:      


Example:    

  IF VS_OpenDict("_DICTHDR")

     DO WHILE .NOT. _DICTHDR->( EOF() )
        Qout( _DICTHDR->DBF_NAME, _DICTHDR->DESC )
        _DICTHDR->( dbSkip() )
     ENDDO

  ENDIF
  ...


Usage:      

  VS_OpenDict() is primarily used internally by several functions in the
  Vern Six Clipper Toolbox.