Conference bulova::decw_jan-89_to_nov-90

3535.0. "Announcing the ANNOTATE tool for server log files" by STAR::VATNE (Peter Vatne, VMS Development) Wed Nov 07 1990 13:58

I have placed a copy of the ANNOTATE tool for server log files in:

	BULOVA::DECW$PUBLIC:[UNSUPPORTED]ANNOTATE*.*

This tool was developed internally by James Synge to decode the
stack dumps in server log files.  It works by reading MAP files
from the Server builds, and matches up the addresses with the
the closest global routine addresses.  We have found this tool
very handy for quickly categorizing the type of server crash.

Some rules about this tool:

1.  As you can see from the directory spec I placed it in, this
    tool is UNSUPPORTED.  This means that you, the user, own all
    the problems you may find with this tool.  However, if you
    find and fix a bug, I encourage you to post it in this notes
    file.  We will do the same if we find and fix any bugs.
    This program does occasionally ACCVIO on bogus data.

2.  Sources are provided.  However, the main parts of the program
    are written in the SCAN language.  If you wish to modify the
    program, you will need a SCAN compiler.  However, I have also
    provided an EXE file so you can use it out of the box.  There
    is also a handy example command file for running the tool.

3.  This tool is only useful if you have access to the MAP files.
    For further analysis, you need the LIS files.  If you are in
    CSSE or one of the CSCs, you should have access to a CD ROM
    with the "VMS Listings".  These should include DECwindows.

Enjoy!

I have placed the server map files for VMS V5.3-1 and V5.4 in

	BULOVA::DECW$PUBLIC:[MAPS.V53-1]
	BULOVA::DECW$PUBLIC:[MAPS.V54]

Note that we provided entirely new images with VMS V5.3-1, so
the maps won't corresponding exactly with the DECwindows listings
on the VMS V5.3 listings CD.  I don't know when (if ever) the
listings will be available on CD.  The VMS V5.4 listings are
in progess, I don't know if they're available on CD yet.

I have also revised ANNOTATE.COM to refer ANNOTATE instead of
the earlier name of ANNOTATOR.  You will probably still have
to modify the command file to get the map files from whatever
directory you place them in.