
*************************************************************************
*									*
*	HEX - Microprocessor object file management utility		*
*									*
*	Author:		Kevin Angley					*
*			Telex Computer Products				*
*			3301 Terminal Drive				*
*			Raleigh, North Carolina 27604			*
*			(919) 834-5251					*
*									*
*	Modified by:	Chris Doran					*
*			Sira Ltd.					*
*			Research & Development Division			*
*			South Hill, Chislehurst, Kent BR75EH		*
*			England						*
*			01-467 2636					*
*			Telex:  896649					*
*									*
*	Submitted by:	Scott Smith					*
*			Telex Computer Products, Inc.			*
*			Raleigh, North Carolina	27604			*
*									*
*************************************************************************

								revision
								11-480

HEX:		Microprocessor File Management Utility

Version:	18APR4

Author:		Kevin Angley, Telex Computer Products, Raleigh, N.C.

Operating System: RSX11M, VAX/VMS Compatability Mode

Keywords:	Microprocessor;  File Management

The HEX utility is designed to manipulate ASCII hex formatted files as output
by cross-assemblers and linkers for microprocessors (Z80, 8085, 68000, etc.).
HEX supports all of the popular ASCII hex formats: Intel, Motorola, Rockwell,
RCA, TekHex, Extended TekHex, Texas, Mostek, Hex-space, Octal-space, and TCI,
plus several binary ones: Whitesmiths', PDP-8 RIM and BIN, and PDP-11 object
and task formats.

The principle component of the HEX utility is a 32K byte virtual memory area
that allows the user to manipulate code in memory as if it were in the target
machine.  Note that the 32K byte virtual memory can be extended to cover the
entire 2**32 address range via the OFFSET command. HEX will handle 16, 24, or
32-bit addresses.  Operations that can be performed on a hex file in virtual
memory:

AND -		logically AND (mask) bytes in a range.
APPEND -	append a range of memory to an existing hex file.
COMPARE -	compare specified addresses to another hex file.
COMPLEMENT -	perform a logical (1's) complement on a range.
COPY -		copy from one area to another.
CRC -		compute the standard cyclic redundancy check.
CSUM -		place a 4-byte checksum block in memory.
DECREMENT -	subtract a constant (default 1) from a range of memory.
DISPLAY -	display to the screen or to a listing file in hex or ASCII.
DIVIDE -	divide a range of memory by a constant.
ECHO -		turn on echoing of commands read from an indirect file.
EDIT -		examine and optionally replace values.
EXIT -		exit to the CLI.
FILL _		fill a range with a value.
FORMAT -	establish the object file format.
HELP -		provide on-line help on HEX commands.
IDENT _		display the HEX program identification.
INCREMENT -	add a constant (default 1) from a range of memory.
INIT -		resets the utility to initial conditions.
MOVE -		move byte or word values.
MULTIPLY -	multiply a range of memory by a constant.
NAME -		establish the object program name.
NEGATE -	perform the arithmetic (2's) complement.
NOECHO -	turn off echoing of commands read from an indirect file.
OFFSET -	establish offset.
OR -		logically inclusive OR bytes in a range with a constant.
READ -		read a hex file into virtual memory.
REMAINDER -	compute the remainder on division (modulus) of bytes in a range.
REVERSE -	reverse the order of bytes in a range.
ROTATE -	rotate bytes in shift a range of memory by n bits.
SEARCH -	search the specified range for a byte or word value.
SHIFT -		arithmetic or logically shift bytes in a range by n bits.
SUM -		compute a 16-bit byte-wise summation.
TRANSFER -	set the transfer address.
USE-		specify which 8-bit section of an addressable unit to use.
WRITE -		write a range of virtual memory to a hex file.
XOR -		logically exclusive OR bytes in a range with a constant.
. -		spawn another task without losing the HEX edit buffer

To build HEX, type @HEXBLD

For a demonstration/test, HEX @HEXTEST.

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

HEX.HLP is a help file on HEX and all subcommands.

HEXRNOMAN.RNO is a manual in a form suitable for input to the RSX SIG's
RUNOFF version S1.4 (submitted by Charles Spalding), and HEXDSRMAN.RNO is a 
form suitable for input to DIGITAL Standard Runoff.  See the comments at the
top of each of these files for information on conditional processing.  Generate
the HEX Manual including the Installation Notes for information on tailoring
HEX to suit your site's needs.

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