
			[370,150] HEX FILE EDITOR
			-------------------------
Submitted by:	Chris Doran				Date: October 1986
		Sira Ltd., South Hill, Chislehurst, Kent, BR7 5EH, England.
		Tel: +44 1 467 2636,	Telex: 896649,	  FAX: +44 1 467 6515

This is the Sira version of HEX, DECUS 11-480, submitted by Telex Computer
Products (TCP) to the DECUS library, and various SIG tapes. I note that TCS
have now translated the whole thing to Pascal, to run in VAX native mode, and
that it is no longer in the DECUS library, so TCS have probably given up
supporting this version.

*************************************************************************
*									*
*	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						*
*			+44 1 467 2636					*
*			Telex:  896649					*
*			Fax: +44 1 467 6515				*
*									*
*	Submitted by:	Scott Smith					*
*			Telex Computer Products, Inc.			*
*			Raleigh, North Carolina	27604			*
*									*
*************************************************************************

								revision
								11-480

HEX:		Microprocessor File Management Utility

Version:	23Sep6

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, Hex-SMS,
Octal-SMS, Fairchild, and TCI, plus several binary ones: Whitesmiths', PDP-8
RIM and BIN, and PDP-11 object and task formats.

The principal 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

HEX.RNO is a manual in a form suitable for almost any Runoff with the basic
commands. It can be easily edited for input to the RSX SIG's Runoff version
S1.4 (submitted by Charles Spalding), Bonner Lab Runoff, or Digital Standard
Runoff. See the comments at the top of the file for information on conditional
processing. Generate the HEX Manual including the Installation Notes for
information on building and tailoring HEX to suit your site's needs.

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

				NOTE
				----
The files MAX.MAC, OUTPUT.MAC, PATCH.MAC, PROC.MAC, and TYPE.MAC are included
in this kit because they appeared on an RSX SIG tape. They are probably
required if you enable the TC274 conditional, but there is no documentation
as to what this is for, or what they do. They are therefore untried and untested
(by me, anyway).
							Chris Doran, Sira
