Switcher Application Prerequisites

Switcher is a “Win32” executable that can run under any 32-bit or 64-bit edition of Windows® that is NT-based (i.e. Windows NT4, Windows 2000 or later editions).  It is not needed, and will not run on, “Win9x” (i.e. Windows 95, 98 or ME) editions.  It requires a display of at least 800x600 pixels and 256 color [8-bit] depth because its Graphical User Interface [GUI] window has a minimum size constraint of approximately 720x540 pixels (depending on the Windows® edition and user “style” and “theme” settings).

The user must have administrative privileges and permissions because this utility needs “Full Control” access to the content of the HKEY_LOCAL_MACHINE hive of the Registry and the Desktop and Start button programs menu when it does a context switch.  This means that a “limited administrator” under Windows Vista, Server 2008, Windows 7 or Server 2011 is not sufficient (nor is that sufficient to run Export-It or Export-It Plus or other “legacy” applications; see Syscob: Windows 7 & Server 2008/2011 for details).

Switcher Technical Details

The list of defined contexts is kept in the Registry under the SOFTWARE\Syscob\Switcher key of the HKEY_CURRENT_USER hive.  Initially, before any contexts are defined, there will be only one subkey which holds the window location, size, constraints and the position of the movable “splitter” that divides the left and right panes:

Once contexts have been defined there will be a subkey for each one that retains its name [“title”] and which Syscob applications it includes:

For each context in the Registry there is a corresponding folder under the Switcher folder in the user “My Documents” folder.  When a context is selected the files in the context folder are listed in the right pane.  This example is for a context that includes both Syscob applications.  Since the context name is “EP [prod] and EPP [test]” and this is a Windows 7 machine the files are in the C:\Users\Bruce Weinel\Documents\EP [prod] and EPP [test] folder:

The files with “.reg” extensions are normal Windows® Registry files and those with an extension of “.ini” are standard Windows® “INI” files.  Either type may be viewed or changed using Notepad or other text editor.  The names without extensions, and a folder prefix, are subfolders which contain shortcut [“link”] files and the properties of these shortcuts are editable.  The prefix “DesktopFolder_” indicates a folder that is on the user Desktop and prefix “ProgramsFolder_” is used for a folder in the Start button programs menu.  Here is an example of the content of one of the Registry files (file KeyDF5.reg):

Windows Registry Editor Version 5.00
 
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\dfrun5.Document]
@="Visual DataFlex 5 Program"
 
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\dfrun5.Document\shell]
@=""
 
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\dfrun5.Document\shell\open]
@=""
 
[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\dfrun5.Document\shell\open\command]
@="C:\\Exportic\\BIN\\dfrun.exe %1"

The following table specifies the eight [8] possible Registry file names and the Registry key contents that they define in the HKEY_LOCAL_MACHINE hive of the Registry.  Be aware that a file will only be included in a context when its Registry key exists at the time the context was defined or last updated.  That is why the KeyDF3.reg and KeyFLX.reg files in this table do not appear in the list above:

FILE NAME REGISTRY KEY
KeyDAC5.reg SOFTWARE\Data Access Corporation\Visual DataFlex\5
KeyDAC7.reg SOFTWARE\Data Access Corporation\Visual DataFlex\7
KeyDF3.reg SOFTWARE\Classes\dfrun3.Document
KeyDF5.reg SOFTWARE\Classes\dfrun5.Document
KeyDF7.reg SOFTWARE\Classes\dfrun7.Document
KeyFLX.reg SOFTWARE\Classes\.flx
KeyVD5.reg SOFTWARE\Classes\.vd5
KeyVD7.reg SOFTWARE\Classes\.vd7

Note that it is also possible to “import” any of the files in the table above into the Registry by double-clicking on the file (and confirming addition of its content to the Registry). The “INI” files and the shortcuts in the subfolders can also be manually restored by using Windows Explorer to copy the “.ini” files to the Windows® directory and the shortcut folders to the Desktop or Start button programs menu (per the folder prefix which should be removed after the copy; e.g. the subfolder named “DesktopFolder_Export-It” would have a name of “Export-It” and be located on the user Desktop).