Category : Utilities for DOS and Windows Machines
Archive   : HEXD141.ZIP
Filename : HEXD.DOC

Hex Dump Version 1.41

Copyright 1987-1991
Mike Fleischmann
All rights reserved.


Mike Fleischmann
2828 W. Lake St.
Ft. Collins, CO 80521


Welcome to Hex Dump. This is a hexadecimal file dump program with
the following features.

o Handles files up to 2.5 billion bytes.

o Configurable record sizes from 16 bytes to 32k bytes.

o Full searching available.

o Can load and use up to 5 translation tables on either the
hex or ASCII side of the display.

o Block size can be changed from within the program

o Help screen and status screens available.

o Options always displayed on the bottom of the screen

o Full printing of the data is supported by either blocks or
addresses.

o User selectable screen colors.

o Can move relative to the current position in the file.

o Relative goto's now supported.

For those of you who want to get started quickly, just type HEXD
and the file you wish to view. Once in HEXD press F1 for function
key list. Feel free to play as this is a read only utility and
WILL NOT write to the file you are viewing.

To register just fill out the registration form provided and send
it to me. You will then receive instructions on how to remove the
pester screen as well as the evaluation copy message.

Program Startup:
----------------

The calling parameters for Hex Dump are:

HEXD filename.ext [blocksize]

FILENAME.EXT: is the filename and extension you wish to view.

BLOCKSIZE: is the optional blocksize to use. This can be any
value between 16 and 32767 bytes. The program
defaults to 256 bytes per block.


Using HEXD:
-----------

Once the program begins you will see the following screen:

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ>!!EVALUATION COPY!!<ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Address : 0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF º
ÌÍÍÍÍÍÍÍÍÍÍØÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍØÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍØÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹
º 00000000: 0001 0203 0405 0607 0809 0a0b 0c0d 0e0f |................| º
º 00000010: 1011 1213 1415 1617 1819 1a1b 1c1d 1e1f |................| º
º 00000020: 2021 2223 2425 2627 2829 2a2b 2c2d 2e2f | !"#$%&'()*+,-./| º
º 00000030: 3031 3233 3435 3637 3839 3a3b 3c3d 3e3f |0123456789:;<=>?| º
º 00000000: 4041 4243 4445 4647 4849 4a4b 4c4d 4e4f |@ABCDEFGHIJKLMNO| º
º 00000000: 5051 5253 5455 5657 5859 5a5b 5c5d 5e5f |PQRSTUVWXYZ[\]^_| º
º 00000000: 6061 6263 6465 6667 6869 6a6b 6c6d 6e6f |`abcdefghijklmno| º
º 00000000: 7071 7273 7475 7677 7879 7a7b 7c7d 7e7f |pqrstuvwxyz{|}~.| º
º 00000000: 8081 8283 8485 8687 8889 8a8b 8c8d 8e8f |€‚ƒ„…†‡ˆ‰Š‹ŒŽ| º
º 00000000: 9091 9293 9495 9697 9899 9a9b 9c9d 9e9f |‘’“”•–—˜™š›œžŸ| º
º 00000000: a0a1 a2a3 a4a5 a6a7 a8a9 aaab acad aeaf | ¡¢£¤¥¦§¨©ª«¬­®¯| º
º 00000000: b0b1 b2b3 b4b5 b6b7 b8b9 babb bcbd bebf |°±²³´µ¶·¸¹º»¼½¾¿| º
º 00000000: c0c1 c2c3 c4c5 c6c7 c8c9 cacb cccd cedf |ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏ| º
º 00000000: d0d1 d2d3 d4d5 d6d7 d8d9 dadb dcdd decf |ÐÑÒÓÔÕÖ×ØÙÚÛÜÝÞß| º
º 00000000: e0e1 e2e3 e4e5 e6e7 e8e9 eaeb eced eeef |àáâãäåæçèéêëìíîï| º
º 00000000: f0f1 f2f3 f4f5 f6f7 f8f9 fafb fcfd feff |ðñòóôõö÷øùúûüýþÿ| º
º º
º 00000100: 0001 0203 0405 0607 0809 0a0b 0c0d 0e0f |................| º
º 00000110: 1011 1213 1415 1617 1819 1a1b 1c1d 1e1f |................| º
ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹
º File Size:11ea1 Blk Size:100 # Blks:11e Current Blk:0 º
º F1:Help F2:Info F3:File F4:Search F5:Defaults F7:Print F10/ESC: Quit º


The first thing you need to know is that the Hex Dump program
works only with hex values both for displaying the data and for
giving it the input information. The only exception to this is
the block size given on the command link which is in decimal.

The top line of the display gives the low nibble address of the
data for both the hex and the ASCII display.

Each of the data lines starts with the full starting address of
that line followed by 16 bytes displayed in hex and then the same
16 bytes of information displayed in ASCII.

A blank line separates blocks.

The line second from the bottom give you information about the
file size, block size, number of blocks in the file and your
current location.

The bottom line gives you reference as to the assignments of the
function keys.

To scroll the data either the up arrow or down arrow keys can be
used as well as the page up and page down keys.

F1 Key:
-------

The F1 key displays the following help screen which gives more
information on the function of each control key.

HEX DUMP HELP (C) Copyright 1987-1991 Mike Fleischmann All rights reserved.
°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°
° Function Keys ° Function Keys °
° F1 : This Help Screen ° F7 : Printer Functions °
° F2 : General File Information ° B: Print a Range of Blocks °
° F3 : Used to change current file ° A: Print an Address Range °
° F4 : Goto/Search Commands. ° F8 : RESERVED °
° G:Goto Block (+,- Relative blk) ° F9 : RESERVED °
° H:Do hex search A:Do Ascii Srch ° F10: Exit Hex Dump °
° C:Continue Search ° ESC: Exit Hex Dump °
° F5 : Set/Load/Use Translation tables. ° °
° A: Set Ascii translation table. ° °
° H: Set Hex translation table. ° Cursor Keys °
° L: Load translation buffer ° Uparrow Scroll Data Up °
° B: Set block Size ° Dwarrow Scroll Data Down °
° F6: Change Color Setup ° PgUp Move Data Up One Page °
° ° PgDn Move Data Down One Page °
° ° °
° ° °
°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°
° Calling Parameters HEXD DRIVE:PATHNAME\FILENAME [block size] °
° min block size=16 max block size=32767 °
° °
° Press any key...°
°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°

F2 Key:
-------

Pressing the F2 key will display the following screen.

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

HEX DUMP PROGRAM VERSION 1.41


Filename: test.dta

Filesize: 11ea1H bytes 11eH blocks

Block Size: 100H bytes


1 2 3 4 5 N 1 2 3 4 5
Ascii Tables Loaded: _ * _ _ _ Current Table Active _ _ * _ _ _
Hex Tables Loaded: _ _ _ _ _ Current Table Active * _ _ _ _ _


Hex Table Ascii Table
________________________________________________________________________________

Filename 1: Filename 1:
Filename 2: Filename 2: EBC2AS.TBL
Filename 3: Filename 3:
Filename 4: Filename 4:
Filename 5: Filename 5:

Press any key...
********************************************************************************

Filename, Filesize, ect are pretty self explanatory however, you
will notice that after that are several tables. The first table is
the tables you have currently loaded into Hex Dump. You can load
up to 5 conversion tables for either the ASCII portion of the
display or the Hex portion. In the example above, ASCII table
position has been loaded with the file EBC2AS.TBL and it is
currently being used for display. In the second table a star in
the 'N' position informs you that there is no table translation
occuring for that display area.

Each of these tables is a 256 byte direct look up table. I.E. if
the value of the byte in the data file is 1F the program will go
to the table at position 1F and substitute the value located there
for the display.

F3 Key:
-------

The F3 key is used to change the file name you wish to view.
When you press the F3 key a line will come up with the current
file name in it. You may change this to the desired file name
and then press ENTER to accept. Pressing ESC will abort the
command and return you to the display screen. If you name a
non-existent file the program will revert back to the previous
file.

F4 Key:
-------

The F4 key initiates/continues the searching ability of the Hex
Dump program. It also gives you the ability to goto any block
in the file.

Upon pressing F4, you will be asked if you want to do a (H)ex
search,(A)scii search,(C)ontinue a previous search, or (G)oto
an absolute block. Pressing the letter given in the parens
will tell the program which choice you want. As with all the
other functions, pressing ESC at any time will abort the
process.

(A) This will start an ASCII search. An input box will
come up and prompt you for the input you wish. The search
is case sensitive and special characters can be included.

(H) This will start the Hex search. An input box will come
up and prompt you for the hexadecimal values to search
on .

(C) This is used to continue searching from the point
where the previous search found the values you were
searching on.

(G) This will allow you to go to a specified block. Please
remember that the block number you input is in HEX. If
you enter a '+' or a '-' in front of the number the
program will move that many blocks relative to your
current position.

F5 Key:
-------

The F5 key is used to used/load the translation tables as well
as change the default block size the program will use.

When you press the F5 key, you will be asked if you want to set
the (A)scii translation to be used, the (H)ex translation
table to be used, (L)oad a translation table into either the
hex or ascii buffers, or changed the default (B)lock size.

(A) This will bring up a question asking you for the table
number to use for the ASCII translation. You then
press 1 to 5 for tables 1 to 5 or pressing 'N' to
inform the program not to translate.

(H) This works just like the (A) above but affects the Hex
display part of the screen.

(L) Pressing this key will bring up another prompt asking
you if you want to load a (H)ex or (A)scii buffer.
Once you press the letter specifying you choice, the
program will ask you which buffer number you wish to
load. You then press a number between 1 and 5. At this
point the program will bring up all files in the local
directory that have the .TBL extension. You can simply
highlight the one you want or press ? to enter a file
name. Please note that this assumes that the
translation files will be in the local subdirectory
and have the extension .TBL. Also the program will
only use the first 256 bytes of the file or the length
of the file, which ever is smaller.

(B) Pressing this key will bring up a prompt asking you
for the new block size to use as the default. Enter in
a number between 10H to 7FFFH.

F6 Key:
-------

Pressing the F6 key will activate the color change screen.
(shown below)

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ> HEXD COLOR CHANGE SCREEN <ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ³
³ This is the color for NORMAL text ³
³ This is the color for INTENSE text ³
³ This is the color for HIGHLIGHTed text ³
³ This is the color of the text used for ERRORS ³
³ This is the color of the text used for MESSAGES ³
³ This is the Color of the text used for TITLES ³
³ ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ ³
³ Use the function keys to change the color scheme to your liking. To make ³
³ the changes permanent press ALT-F1. Please note that you must be in the ³
³ subdirectory where HEXD.EXE resides for the changes to be made. ³
³ ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ ³
³ F1: Increase normal text color F2: Decrease normal text color ³
³ F3: Increase intense text color F4: Decrease intense text color ³
³ F5: Increase highlight text color F6: Decrease highlight text color ³
³ F7: Increase error text color F8: Decrease error text color ³
³ F9: Increase message text color F10: Decrease message text color ³
³ Shift F1: Increase title text color Shift F2: Decrease title text color ³
³ ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

Just follow the instructions to change the colors you want.
Pressing ESC will return you to the main screen so you may review
the color choices. ALT-F1 will make the changes permanent if you
are in the same directory where the HEXD.EXE program resides.

F7 Key:
-------

Pressing the F7 key will invoke the print function of Hex
Dump. When you press F7 the program will ask you if you want
to print (B)locks or an (A)ddress range. After you make your
selection, the program will ask you for the start and end
blocks/addresses. The program only prints to LPT1: so if you
use a COM port for your printer you will need to use the mode
command to redirect it. During printing you may now cancel the
print job by pressing ESC.

F10/ESC Key:
------------

Pressing the F10 or the ESC key from the main screen will exit
the program. You will be prompted to verify the exit by
pressing 'Y'. Then the program will exit. If you are running
an evaluation copy you will have a 10 second delay with a
please register screen before the program exits.


History:
--------
Changes 1.40 to 1.41:
---------------------

o Added color to the screen and ability of user to change
the color and make it permanent.

o Added a relative goto block function. This allows the
user to go so many blocks forward/backward from the
current position.

o Added the ability to abort a print job by pressing ESC.

o When in the file load screen pressing ESC will now
leave you at your previous position in the file.

o End of file display is now cleaner.

Version 1.40: (this was the first version release to shareware.)
----------------------------------------------------------------
I work as a systems analyst. One contract dealt with large
files that were in EBCDIC. I wrote HEXD in 1987 to allow me to
do the analysis I needed to fulfil the contract. I also gave
the company I was contracting with a site license. I am
amazed that over the years I have yet to encounter a program
that fills the niche this one does and that I have needed to do
very little in the way of revisions. After some thought I
decided to offer this program as shareware to help others with
their data analysis problems.

I want HEXD to evolve. I am open to comments and suggestions
on ways to improve it. Because of the small price I am
asking for the program, I will only respond to problems from
registered users. If you are the first registered user to
identify a bug in the program, I will mail you a new copy as
soon as the problem is corrected. Comments and suggestions are
most welcome.

If you offer a unique suggestion that I implement in HEXD I
will send you a registered version as soon as I implement
your comment. I will send you a registered version even if
you were not previously registered. (private parties only
please!!)

You can send comments/suggestions/problems to the address
given on the title page. Or if you use EXEC PC, I can be
reached there under my name.

The number of registrations will determine how fast this
product evolves. Some ideas I have are:

o Add user defined colors. (DONE in 1.41)
o Allow the program to write to files
o Support searching through the translation tables
(currently searching is independent of the tables)
o Build in one or more of the most used tables.
o Wild card searching.
o Print to files as well as the printer.
o Allow the user to save off pieces of the current file.

Now for all the legal stuff:

***************************************************************
* Hex Dump is Copyright 1987-1991 by Mike Fleischmann. *
* All rights reserved. *
***************************************************************

* A $15 shareware contribution is requested for using the
program.
* The author retains the sole right to sell the program.
* The author grants users the right to copy and distribute
the program within the following constraints:
- All program files remain unaltered and are distributed
en masse.
- Only the original "non-cloned" version of the program
with the startup/termination and drive change time
delays is distributed.
- No attempt is made to sell the program, or to make
money from it or any modified version of it.
- The program is not bundled with any other hardware or
software transactions without the author's permission.
- Recognized users' groups may charge a maximum $5
duplication or distribution fee.
* Continued use of the program (more than 1 month) by any
individual, corporation or institution without a single
user or site license is prohibited.
* Single user licenses are obtained by sending in the $15
shareware contribution.
* Corporations and other institutions (including government
and educational) which desire using the program should
refer to the "HD_SITE.LIC" file for site licensing
information.

**********************************************************************
* Disclaimer and warranty *
**********************************************************************

The author disclaims all warranties expressed or implied
as to the quality or performance of this program. The author
will not be held liable for any lost profits, lost savings or
any other direct, indirect, incidental or consequential
damages resulting from the use of this program. Your use of
this program constitutes your agreement to this disclaimer and
your release of the author from any form of liability or
litigation.