Here is some documentation on how it works:
I. How To Use the Annotator
1. Download the Annotator from the Support Downloads area of the Lotus Support Web site.
2. Run the file CZ7H2NA.EXE to extract the Annotator file ANTW32.EXE
3. Launch ANTW32.
4. In the "Input From" section, click the Browse button to locate the NOTES.RIP file.
5. After locating the RIP file in the "Input From" section, the "Output From"
section lists the location of the annotated RIP file to be called NOTES.ANT.
6. In the "PUB/SYM Files" section, click the Browse button to point to the symbol
files for the Annotator to reference. These files are necessary to properly
annotate the RIP file.
For example C:SYMv4.61dW32 (where C:SYMv4.61dW32 is where the SYM files for Notes Release 4.61d for Windows 95 and Windows NT were copied to.)
II. Why Are SYM Files Necessary?
SYM files are needed to define the function call within the dynamic link library (DLL) or executable file (EXE). In order to annotate the RIP file correctly, the annotator must cross-reference the SYM files to get the proper definition of the function call. In order to achieve this, it is critical that the proper version and platform of Notes SYM files are installed on the hard drive
III. What To Do With an Annotated RIP File
Notes RIP files are basically a dump of threads and their function calls. A NOTES.RIP file may contain more than one thread. The thread that crashed the server (the faulting thread), is the first thread in a RIP file. To identify a thread, the RIP file contains a header stating the following:
State Dump for Thread ID 0 5
Each thread contains function calls on what Notes was doing at the time of the crash.
Sample annotated result (extracted from an annotated NOTES.RIP file):
Stopped at 005095AB (0001:000085AB in d:notesnnotes.dll) Base=0x00500000 RVA=0x00001000 -> _AllocDBlock --> +006B <- 04A5F8DC 04A5F8F0 00509535 008D7280 0000F81A |....5.P..r......| 04A5F8EC 01ABFCE0 04A5F914 00508E32 008D7280 |........2.P..r..| Called from 00509535 (0001:00008535 in d:notesnnotes.dll) Base=0x00500000 RVA=0x00001000 -> _OSAllocDBlock@12+0015 <- 04A5F8F0 04A5F914 00508E32 008D7280 0000F81A |....2.P..r......| 04A5F900 01ABFCE0 0000F81A 01ABFCD0 0000821C |................| 04A5F910 008D6F20 04A5F934 00508D57 00CB0004 | o..4...W.P.....| Called from 00508E32 (0001:00007E32 in d:notesnnotes.dll) Base=0x00500000 RVA=0x00001000 -> _DPoolAlloc@16+00A2 <-
Use these function calls to search the Lotus Knowledge Base for known NOTES.RIP files. To search on the function calls, highlight the function call after the underscore ( "_" ) and before the "at" (" @ ") symbol and it copy to the clipboard. Next, open Knowledge Base and paste in the function calls to search for a possible match.
Example: Based on the sample NOTES.RIP file above, the function calls that would be used to search Notes Knowledge Base would be the following:
AllocDBlock and OSAllocDBlock and DPoolAlloc
When comparing your search results with your annotated RIP file, look for matching patterns within the faulting thread. The combination and pattern of the annotated RIP file is what distinguishes the crash. If no matches are found, contact Lotus Notes Support to further troubleshoot your crash.
IMPORTANT: Notes/Domino SYM files are used in conjunction with the Notes RIP File Windows Annotator. Each Release 4 and Release 5 version of Notes/Domino requires different SYM files. These SYM files are publicly available on the Lotus Support web site at:
5.0 Support Downloads, http://fulfill.lotus.com/support/CZ7K2NA.exe
5.0a Support Downloads, http://fulfill.lotus.com/support/CZ7JNNA.exe
5.0.1 Support Downloads, http://fulfill.lotus.com/support/CZ7JMNA.exe
5.0.1a Support Downloads, http://fulfill.lotus.com/support/CZ7JLNA.exe
5.0.1b Support Downloads, http://fulfill.lotus.com/support/CZ7HBNA.exe
5.0.2 Support Downloads, http://fulfill.lotus.com/support/CZ7HANA.exe
5.0.2a Support Downloads, http://fulfill.lotus.com/support/CZ7H9NA.exe
5.0.2b Support Downloads, http://fulfill.lotus.com/support/CZ7H8NA.exe
5.0.2c Support Downloads,http://fulfill.lotus.com/support/CZ7H7NA.exe
5.0.3 Support Downloads, http://fulfill.lotus.com/support/CZ7H6NA.exe
5.0.4 Support Downloads, http://fulfill.lotus.com/support/CZ7H3NA.exe
5.0.4a Support Downloads, http://fulfill.lotus.com/support/CZ6SSNA.EXE
5.0.5 Support Downloads, http://fulfill.lotus.com/support/CZ7C1NA.exe
5.0.6 Support Downloads, http://fulfill.lotus.com/support/CZ7YUNA.exe
5.0.6a Support Downloads, http://fulfill.lotus.com/support/CZ7YUNA.exe
4.6 Support Downloads, http://fulfill.lotus.com/support/CZ68QNA.exe>
4.6a Support Downloads,http://fulfill.lotus.com/support/CZ68PNA.exe
4.6.1 Support Downloads, http://fulfill.lotus.com/support/CZ68MNA.exe
4.6.1a Support Downloads, http://fulfill.lotus.com/support/CZ68LNA.exe
4.6.1b Support Downloads, http://fulfill.lotus.com/support/CZ68KNA.exe
4.6.1c Support Downloads, http://fulfill.lotus.com/support/CZ68INA.exe
4.6.1d Support Downloads,http://fulfill.lotus.com/support/CZ68HNA.exe
4.6.2 Support Downloads, http://fulfill.lotus.com/support/CZ68FNA.exe
4.6.2a Support Downloads, http://fulfill.lotus.com/support/CZ68DNA.exe
4.6.2b Support Downloads, http://fulfill.lotus.com/support/CZ68BNA.exe
4.6.2c Support Downloads, http://fulfill.lotus.com/support/CZ681NA.exe
4.6.3 Support Downloads, http://fulfill.lotus.com/support/CZ67ZNA.exe
4.6.3a Support Downloads, http://fulfill.lotus.com/support/CZ7YXNA.exe
4.6.3b Support Downloads, http://fulfill.lotus.com/support/CZ7YWNA.exe
4.6.3c Support Downloads, http://fulfill.lotus.com/support/CZ7YVNA.EXE
4.6.4 Support Downloads, http://fulfill.lotus.com/support/CZ67YNA.exe
4.6.4a Support Downloads, http://fulfill.lotus.com/support/CZ67XNA.exe
4.6.4b Support Downloads,http://fulfill.lotus.com/support/CZ67WNA.exe
4.6.4c Support Downloads, http://fulfill.lotus.com/support/CZ67UNA.exe
4.6.5 Support Downloads, http://fulfill.lotus.com/support/CZ7LGNA.exe
4.6.5a Support Downloads, http://fulfill.lotus.com/support/CZ7LCNA.exe
4.6.5b Support Downloads, http://fulfill.lotus.com/support/CZ7LBNA.exe
4.6.6 Support Downloads, http://fulfill.lotus.com/support/CZ7L9NA.exe
4.6.6a Support Downloads, http://fulfill.lotus.com/support/CZ7L8NA.exe
4.6.6b Support Downloads, http://fulfill.lotus.com/support/CZ7K3NA.exe
4.6.6c Support Downloads, http://fulfill.lotus.com/support/CZ7BDNA.exe
4.6.7 Support Downloads, http://fulfill.lotus.com/support/CZ7BENA.exe
Please note: There are some problems using the GUI version of the annotator with releases after R5.0.4, but I understand that there is a DOS version of the annotator that works better for the newer versions of Domino. If anyone knows where this DOS version can be found, I would appreciate a note.
- The DOS Annotator (which works for all Domino versions including 5.04+) is available at Lotus.com as Customer Support Online Resource document #2446.Mike Andrews < LI >
Since 5.04 RIP Annotator Win9x (ANTW32.EXE) is not working, you can use this tip as a workaround. Instead, you can use the DOS version (ANT.EXE) which has been tested up to the 5.07 system files. You can download it from Lotus Support Online Resource Files.Search the following document: DOS Annotator 3.L - For Use With Notes/Domino 5.x, Notes/Domino 4.x and Notes 3.x Doc number 2446. Follow the instructions.Antonio Freitas LI>
This was first published in May 2001