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 many of  the  popular  ASCII  hex  formats
including:  INTEL, TEKHEX, Extended TEKHEX, Motorola, and MOSTEK.  The
principle components of the HEX utility is a 64K byte  virtual  memory
area  that  allows the user to manipulate code in memory as if it were
in the target machine.  Note that the 64Kbyte 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 include:

INPUT FUNCTIONS:  The commands READ and COMPARE can be  used  to  read
hex  files  into virtual memory or compare hex files with the contents
of virtual memory.

OUTPUT FUNCTIONS:  The WRITE and APPEND commands write the contents of
virtual memory to a new file or append them to an existing one.

ARITHMETIC AND  LOGICAL  FUNCTIONS:   The  commands  AND,  COMPLEMENT,
DECREMENT, DIVIDE, INCREMENT, MULTIPLY, NEGATE, OR, REMAINDER, ROTATE,
SHIFT, and XOR perform arithmetic  or  logical  manipulations  on  the
selected range of virtual memory.

PROGRAM PARAMETER FUNCTIONS:  Several functions  including  ADDRESSING
MODE,  FILL,  FORMAT,  INIT,  NAME,  OFFSET,  and TRANSFER set program
parameters such as the transfer address or the program name.

VIRTUAL MEMORY MANIPULATION FUNCTIONS:  The contents of virtual memory
may be manipulated through such commands as COPY, DISPLAY, EDIT, MOVE,
REVERSE, and SEARCH.

MISCELLANEOUS COMMANDS:  Other  functions  include  online  help,  the
ability  to  spawn  DCL  commands, and the ability to process indirect
command files.


This revision of HEX is basically a conversion of the original version
of  HEX  as  written  by Kevin Angley from MACRO-11 for RSX-11M to VAX
PASCAL.  Some new functionality as been added.  Especially  noteworthy
is  the  increase  in  the virtual memory buffer size from 32Kbytes to
64Kbytes.  A few of the file formats supported  in  previous  versions
are  not  supported  in  this  latest  version.   If demand exists for
additional formats, they will be added at a later date.

The files in this directory of types .PAS, .INC, .MSG and .MAR are the
source  files  for  HEX.   The  object  and  executable files are also
included.  HEX.HLP and HEX.HLB contain the files for online help.  The
file  MANUAL.MEM  contains  a user's guide to HEX.  Two .COM files are
included in the directory:

BUILDHEX.COM - used to compile and link HEX from the source files.  As
the  .EXE  file is contained in this directory it isn't necessary that
you run this before using HEX.

ADDCOMMAND.COM - used to add HEX to your system DCL tables.  This must
                                                                Page 2


be run before invoking HEX.

In order for these  two  command  procedures  to  work  properly,  the
logical  name  HEX$DIRECTORY  should  be  assigned  to  the  directory
specification in which all of these files reside.   Furthermore,  this
same  assignment  with  the  /SYSTEM qualifier should be added to your
SYSTARTUP.COM so that HEX knows where to find its help library.


Any further questions, complaints, reports of bugs,  etc.   should  be
directed to:

                    David Moore
                    Telex Computer Products, Inc.
                    Communications Division
                    3301 Terminal Drive
                    Raleigh, North Carolina 27604
                    (919) 890-1527