File DZ--READ.ME 29 Nov 86 DazzleStar Disassembler (User-supported software) 1. Is it a bird, is it a... --------------------------- DazzleStar (DZ) is an interactive disassembler. It requires a Z80 CP/M system, and at least 48K of RAM (preferably more). DazzleStar lets you examine an 8080 or Z80 program (a .COM file) and decode it into Z80 assembler instructions, showing the result on your screen or printer, or producing an assembler source file on disk. Many of the commands are in the style of WordStar (and other commonly used microcomputer editors). If you've used a disassembler before, you'll know that recon- structing and understanding a program (using sensible names for the labels, and meaningful comments) is a painful process. No disassembler can be a complete pain killer. But DazzleStar does make the pain more endurable. DazzleStar is big, but doesn't limit the size of the program to be disassembled. This freedom is due to the way in which DazzleStar reads the program to be disassembled, using a paging technique to ensure that few of the accesses require it to re- read the disk. 2. What you've received ----------------------- You should have a file DZ-NOV86.LBR, which contains the following: -CATALOG.000 CRC values for the following files DZ--READ.ME (This file) Read this first DZ-BRIEF.DOC Print this and paste it on the wall DZ-FIXES.DOC Past and future DZ.COM The interactive disassembler program DZENGHLP.OVR Overlay file (help) for DZ.COM (English version) DZENGMNU.OVR Overlay file (menus) DZENGMSG.OVR Overlay file (messages) DZINSTAL.CFA Data file for DZINSTAL.COM DZINSTAL.COM Installation and customization program 3. Licence ---------- This library is NOT public domain. Copyright is retained by the author, John Washington, and all rights are reserved. A licence is granted for free use and re-distribution of this library, subject to the following conditions: 1. Users may not modify any copyright notices, nor suppress the display of any such notices. 2. Re-distribution may only be made by distributing this library exactly in its present form, with no additions, no deletions, no amendments of ANY kind. 3. Use and redistribution may only be made without profit, except when prior written agreement has been granted by the author. This library may not be included in any other package for sale. Modest charges to cover media copying and distribution are permitted, provided that the author is notified of this intent. Please report any violations to the author. Thank you. 4. WARNING and disclaimer ------------------------- The author will have no liability or responsibility in the event of any loss or damage caused or alleged to be caused directly or indirectly by this program. 5. Getting started ------------------ If you obtained your master disk direct from me, I have probably included NULU.COM, NULU15.LBR, CRUNCH22.LBR and CRC.COM on the disk. If you downloaded from a bulletin board, you can almost certainly find NULU, CRUNCH and CRC elsewhere on that board (if you really can't, I suggest you ask the sysop for advice before contacting me, though I'll be happy to act as longstop). These installation instructions assume you have two disk drives. It is possible to install and run DazzleStar with only a single drive, but I have no experience of doing so. I have two 800K drives and therefore have never calculated the disk capacity required. I imagine much smaller drives will suffice. You should now have a master disk containing the file DZ- NOV86.LBR. We'll call this disk 1A. You should also have a disk containing NULU.COM, UNCR.COM and CRC.COM, which we'll call disk 1B (or you could have everything on one disk if there's enough room, in which case we'll call it disk 1). Your first task is to use NULU to split up the library into its component files, and then use UNCR to expand these files into working versions. Put disk 1B (or 1) into drive A, and press ^C. Put an empty (but formatted) disk (call it disk 2) into drive B. Type B: A:NULU (Start running NULU) Remove disk 1B from drive A, and replace it with disk 1A (unless 1A and 1B are the same disk, disk 1). Then type -O A:DZ-OCT86 (Open the library file) -Q *.* (Extract & unsqueeze contents) -C (Close the library file) -X (Exit to CP/M) Remove disk 1A from drive A and replace it with disk 1B. Type B: A:UNCR *.* (Uncrunch all files) DIR B: Each line is terminated with the key, as usual for CP/M. Disk 2 should now have the files as mentioned in section 2 (above). Your next task is to use CRC.COM to check that you received the files ok, and they have been correctly reconstituted. Put disk 1A into drive A, and warm boot (press ctrl-C). Type B: A:CRC If the CRCs don't all check out, or any files are missing, this is very serious -- first check with your sysop. If his copy is also corrupt, please contact me URGENTLY. Do not try to continue with a bad copy. I've had reports that the CRC.COM that I use (version 5.0) may not work properly on CP/M 3. Since I only use CP/M 2.2 I'm unable to advise on this (and I'd appreciate guidance from a knowledgable CP/M 3 user). Now that you have a good version... Before doing anything further, MAKE A COPY, and put your master disk on the shelf out of harm's way. If you have a printer, you may find it useful to print out the following files DZ--READ.ME (this file) * DZ-BRIEF.DOC DZ-FIXES.DOC * DZENGHLP.OVR The files marked "*" are in WordStar "document" format, and therefore are most easily printed by using WordStar. If you don't have WordStar, you can still get a reasonable listing by using a printer (or CP/M BIOS) which ignores the high bit of characters. Some printers treat the high bit as a signal to use italics; if you don't like that maybe there's an escape sequence which turns off this feature. Check your printer manual. For an Epson printer, try PIP LST:=CON: However, some printers treat the high bit as graphic characters, without any means of suppressing them, in which case you won't have much joy. So try, for example, PIP DZENGHLP.TXT=DZENGHLP.OVR[Z] and print the new file DZENGHLP.TXT that PIP produces. 6. You've seen the trailer, now watch the film! ----------------------------------------------- DazzleStar must use screen control codes, to achieve its impressive display. As these codes are not the same for every computer, you can't run DazzleStar "straight out of the box" (unless you use a Hazeltine 1500 terminal). First you have to run DZINSTAL which modifies DZ.COM to run properly on your screen. Put disk 2 in your drive A. Press ^C. Type DZINSTAL DZINSTAL will present you with menu choices. It is easy to use, provided that you resist any temptation to choose the menu option that sets you in expert mode. Screen size is assumed to be not more than 25 rows of 80 columns. It is expected that most screens will have 24 rows, though perhaps 16 would be sufficient (though irritatingly small if you also want the menus). DazzleStar can be used on an Epson Geneva PX-8 (only eight rows). However, you need to be a very experienced user because no menu display is possible. Well, I sometimes use it myself on a PX-8, and am really happy with it, but I guess I can fairly claim to be a VERY experienced DazzleStar user! [Note for users with very low disk capacity: during installation the only files required are DZINSTAL.COM, DZINSTAL.CF1, DZ.COM] Having configured DZ.COM, you're ready to start disassembling. Choose something fairly small to start with, say, EXAMPLE.COM, and type DZ EXAMPLE [Note for users with very low disk capacity: DZ.COM is only accessed for the initial program load, and can therefore be on a different drive. The overlay files DZ*.OVR should be on the default drive (though this can be modified by DZINSTAL). If a .OVR file is not found, DZ will operate but will be rather cryptic.] 7. Problems ----------- It isn't easy to write installation directions that work well on every machine, and for every user. But I'd like to. So tell me your horror stories, so I can do better next time. Thanks. 8. You've seen the film, now get the book! ------------------------------------------ If you've followed these directions, there's sufficient information to allow you to make good use of DazzleStar. But to make full use of it, get the manuals. There are three manuals: "Installation & Configuration", "Tutorial", and "Reference". To obtain the manuals, send an order form (see DZ-FORMS.DOC) together with your registration fee. ... That's how it used to be, but life is too hectic at present for me to spend time printing and binding. Look out for another library called DZDOCS86.LBR. This will contain the text of the manuals. In fact, my life is SO hectic at present, that I need regular doses of muscle relaxant. So if you find DazzleStar entertaining then I'd appreciate a small contribution for my slate in the local. Many thanks to the users who supported earlier versions of DazzleStar; this new version is a direct result of your encouragement. 9. Feedback ----------- I'd like to get your ideas and comments, whether general or detailed, positive or negative, on anything concerning DazzleStar. Contact: John Washington Washington Electronics and Systems Ltd 33 Turnoak Avenue, Woking, Surrey, GU22 0AJ, England. If you want a reply, YOU MUST include British postage stamps, or a dollar bill, or the smallest note in your local currency. I am a typical generous-hearted Englishman (free advert for the English Tourist Board!), but postage costs do make a hole in my wallet.