CKVHEX and CKVDEH                                                    June 1994

  Originally by Stuart Hecht of Stevens Institute of Technology.
  Later versions by Eric McQueen, Utah State University.
  Converted to work on the Alpha AXP by Hunter Goatley, Western Kentucky Univ.
  (See program edit history for additional credits.)

CKVHEX is an assembly language program for the VAX or Alpha AXP to convert any
VMS file into a printable ASCII "hex" file, suitable for transfer as a text
file over BITNET, or by electronic mail, or other means, or for storage on a
text-oriented medium such as ANSI Format-D magnetic tape.  CKVDEH converts a
hex file created by CKVHEX back into its original form, with all its
attributes intact.

CKVDEH.MAR supports both 16-bit-address and 32-bit-address format files by
changing the ':' that starts each line to '<' for 32-bit- address lines (you
can also use 24-bit addresses by putting ';' on the front of a line).  It does
not require the output file to be contiguous.

CKVHEX only creates 32-bit address lines.  Older versions of CKVHEX created
16-bit lines.  The current version of CKVDEH should be able to decode either
kind of file correctly.

To build CKVDEH, to do this:

  MACRO CKVDEH
  LINK CKVDEH

To build CKVHEX:

  MACRO CKVHEX
  LINK CKVHEX

Or use the CKVDEH.COM procedure to build these programs.  Or if you have MMS,
rename CKVDEH.MMS to DESCRIP.MMS and then run MMS.

To use either of these programs, simply run it.  It prompts you for the input
or output file names.  If you press Return/Enter in response to "Output
file name", the default name the same as the original file, but with its
filetype replaced by .HEX.

NOTE: These programs work well, but the resulting .HEX file is usually about
twice the size of the original file.  No attempt is made to optimize the size
of the hexified file.  To produce smaller ASCII files, see Carlo Mekenkamp's
MFTU package, which you can get by sending the command SEND MFTU in the body
of a mail message to FILESERV@WKUVX1.BITNET.

By the way, you can use CKVHEX to hexify an AXP binary on a VAX and vice
versa, and CKVDEH to dehexify a VAX binary on an AXP (and vice versa).

[End of CKVDEH.HLP]
