QuickStart: Installation (VB6)



 PLEASE NOTE: SimplyVBA and SimplyVB6 have been superseded by vbWatchdog.
This page exists for archival purposes only.  
Upgrade licences of vbWatchdog are available at a discounted rate.

Installing the SimplyVB6 Global Error Handler for development

The Global Error Handler is provided as a single DLL library - the filename is VB6GlobalErrorHandler.dll.

This DLL can be found on your computer in '%PROGRAM FILES%\EverythingAccess.com\VB6 Global Error Handler\' (unless you changed the installation directory)

When developing using the SimplyVB6 Global Error Handler the DLL must be properly installed.  The DLL does not need to be "installed" for clients - you can take advantage of the registry-free installation option instead which makes distributing applications made with this product much easier - see Registry-free client installation (DISTRIBUTABLE EDITIONS ONLY)

We provide you with a simple Setup.exe application that handles the full installation of the DLL.

VB6GlobalErrorHandler.dll contains the following components:

A VB6 COM Reference Library

This part of the DLL is what you set a reference to from your VB6 project (discussed below).


A VB6 COM AddIn for displaying line numbers in the VB6 IDE codepane (not essential - can be unloaded)

This AddIn is called 'SimplyVB6 SourceCode Line Numberer' and can be enabled/disabled in the VB6 COM AddIns Manager.  This part is not activated when registering the DLL manually with regsvr32 (or in an installation package).


A VB6 COM AddIn to ensure the compiled code is fully compiled with the necessary extra debug info (highly recommended)

This AddIn is called 'SimplyVB6 Compiler Fix' and can be enabled/disabled in the VB6 COM AddIns Manager.  This part is not activated when registering the DLL manually with regsvr32 (or in an installation package).


INSTALLER PICTURE


Once installed, the library will be available from your VBA references window.

VB6 REFERENCES PICTURE

(Tip: Press the S key on your keyboard when in the References window to scroll down to the libraries starting with the letter S)

Packaged Installation (DISTRIBUTABLE EDITIONS ONLY)

If you've purchased a DISTRIBUTABLE EDITION of SimplyVB6 Global Error handler, then you are allowed to include the VB6GlobalErrorHandler.dll in a packaged install routine for when releasing your products.

Simply copy the VB6GlobalErrorHandler.dll from your Distributable edition over during your installation routine and then register the DLL in the normal way (using regsvr32.exe).

Remember though that you are not allowed to include the DEVELOPER EDITION of the .DLL in any packaged installation since you are not allowed to redistribute that version of the DLL. You must first purchase a DISTRIBUTABLE EDITION.

Any questions regarding licensing should be put to our sales team: sales@everythingaccess.com

Registry-free client installation (DISTRIBUTABLE EDITIONS ONLY)

If you need to distribute the DLL to clients that don't necessarily have administrative permissions to install a COM DLL Library, we give you another neat solution.

Simply distribute the DLL file in the same folder as your application and go to the Add-Ins menu in your VB6 IDE as follows:

Install Free Pic

>> Add-Ins >> SimplyVB6 Global Error Handler >> Setup installation-free DLL support

This will add three class modules to your VB6 project called ErrEx, ErrExCallStack and ErrExDialogOptions.  You need not worry at all about these modules - simply understand that they provide late-binding support to the DLL. 

This method of installation provides exactly the same functionality as having the normal COM reference, but doesn't require any form of installation (... apart from copying over the DLL to the same directory as your VB6 application).  This completely avoids permission related installation problems and Vista elevation messages.  "DLL Hell" no more!