BSP_ERR.MDA

One of the frequently asked questions on the Microsoft Access forum is:  "Where
can I get a list of all possible Access error messages and codes?"

BSP_ERR.MDA is an Access 2.0 add-in application that will create an Access table
(of course) that contains all valid error codes and their corresponding text,
and also provides a simple lookup form for finding a specific code or for
finding all messages that contain a particular string of characters.  The lookup 
form is easily accessible by selecting File/Add-Ins from the Access menu bar.

[10/28/94] "Find Word" procedure fixed to handle search strings that contain 
either a single- or double-quote.  If a search string contains BOTH, a MsgBox
appears to advise the user that such a string can't be searched for.

INSTALLING BSP_ERR.MDA

1)  Copy file BSP_ERR.MDA into your Access 2.0 directory.

2)  Start Access, and open any database (NOT BSP_ERR.MDA).

3)  Select File/Add-Ins from the menu bar, then select Add-In Manager.

4a) If "Error Message Lookup" appears in the list titled "Available
    Libraries", select "Install".
4b) If "Error Message Lookup" is NOT in the list, select "Add New...",
    then select BSP_ERR.MDA in the "Add New Library" dialog box.

5)  Select "Close" in the Add-In Manager, then "OK" when the message 
    appears reminding you to restart Microsoft Access.

6)  Restart Access.  When you select File/Add-Ins from the menu bar, an
    entry will now appear for "Error Lookup".

USING THE ERROR LOOKUP ADD-IN  

As distributed, the add-in library contains an empty error message table.  The
first time you use the add-in, a function will run which detects that the table
is empty, and then populates the table.

At the top of the Message Lookup form is a text box which allows you to enter a
number or a text string.  If a integer in the range 1-32767 is entered, tabbing
out of the text box will change the focus to the "Find Error#" button, which will
look up an error by ErrorCode.  If a text string is entered, tabbing out of the
text box will change the focus to a checkbox next to the "Find Word" button;  the
"Find Word" button will find all messages that contain the desired text string.
(Although entering a number will automatically tab you to the "Find Error#" button,
you can still click on the "Find Word" button if you wish to find the number within 
message text instead of as an error code.)

The "Blank-delimited" checkbox determines how the search string is handled when 
"Find Word" is selected.  If checked, then the search string must occur at the 
START of the message text, the END of the message text, or surrounded by spaces 
-- i.e., the search string is treated as a WORD.  If the box is NOT checked, the 
search string can occur anywhere in the message.  As an example of how this 
differs, try using the search string "disk" with the box both checked and 
unchecked.

The "Show All" button will display all messages, in sequence by Error Code.

The "Build Table" button will delete all messages from the Error Message table 
and will reconstruct it.  Use of this button should not be necessary, unless an 
upgrade to Access is installed which might include changes to error codes and 
messages.  After using "Build Table", it would be worthwhile to use the Add-In 
manager to temporarily un-install the add-in, compact BSP_ERR.MDA, and re-install
the add-in.

The "Close" button closes the Message Lookup form -- surprise!

It's not exactly a Nobel Prize winning application, but it's functional -- enjoy!

Jim Newman
CIS 74503,2251