*************************************************************************
*									*
*	HEX - Microprocessor hex file management utility		*
*									*
*			Kevin Angley					*
*			Telex Terminal Communications			*
*			3301 Terminal Drive				*
*			Raleigh, North Carolina 27604			*
*			(919) 834-5251					*
*									*
*************************************************************************

This is an update to the HEX utility that appeared on the Spring 1981
Miami RSX tape under [370,150] and also appeared as 11-480 in the DECUS
library. New features include some cosmetic changes, offsetting reads and
writes, and the ability to create "even" and "odd" proms for 8-bit proms
on a 16-bit data bus.


The HEX utility runs under the RSX11M operating system. Its purpose is to
manipulate INTEL ASCII Hex-formatted files that are produced by many cross
assemblers (or linkers) for microprocessors (8080, Z80, 8085, 68000, etc.).
Operations that can be performed on a hex file with HEX include:

FILL - fill address range with a value.
READ - read in a hex file.
COMPARE - compare specified addresses to another hex file.
COMPLEMENT - complement logically (1's complement)
COPY - copy values from one area to another.
CRC - compute the standard bisync cyclic redundancy check on a range.
DISPLAY - display portions of the file to the screen or to a listing file.
EDIT - examine and optionally replace values in the file.
MOVE - move values from one area to another.
NEGATE - complement arithmetically (2's complement)
SEARCH - scan the file for a particular byte or word value.
SUM - compute 16-bit byte-wise sum-check (as with DATA I/O prom burner).
TRANSFER - manipulate the transfer address.
WRITE - write out locations to create new hex files.


The file HEX.TSK is ready to run (without FCSRES).
To build the non-FCSRES version, TKB @HEXBLD.
To build the FCSRES version, TKB @HEXFCSBLD.

If you need to assemble a module, type @MAC and respond with the module name
that you wish to assemble.

HELPHEX.HLP is a help session on HEX and all subcommands.

An actual user's manual can be obtained by sending about a dollar for
postage to me at the above address.

HEX can be easily modified to handle other formats (TEKHEX, MOTOROLA,
etc.) by changing the modules READ and WRITE. Source module READTCI
is an example of how read could be modified to input a different format.

I would VERY much like to hear from you if you find this useful, find
a bug, have modified it for other formats, added whistles and bells, etc.

*************************************************************************
