
 DUMPMT.HLP    USER INSTRUCTIONS FOR THE
               GENERAL PURPOSE MAGNETIC TAPE DUMP

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

WRITTEN BY:  RONALD HOEKSEMA
             PERSONNEL DEPARTMENT, THE FIRST NATIONAL BANK OF CHICAGO
             1 FIRST NATIONAL PLAZA, 22ND FLOOR
             CHICAGO, ILLINOIS  60670

DATE:        JUNE 10, 1982


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

	Neither First Chicago Corporation, the First National Bank of Chicago,
nor any of its employees makes any warranty, either expressed or implied,
assumes any legal liability, nor any responsibility for the accuracy,
completeness or usefulness of any information, product or process disclosed.
Neither does First Chicago Corporation, the First National Bank of Chicago, nor
any of its employees represent that use of this material would not infringe
privately owned rights.

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

	This is the user"s guide for the DUMPMT system.  Technical information
is contained in the file DUMPMT.DOC.  This guide gives step-by-step
instructions and useful hints for operating DUMPMT.  The format is to print,
in order in which they might appear, the system prompts to the user and then
list what the responses might mean.

	To start an installed DUMPMT system from monitor mode, the RT-11 user
would simply type:

			R DUMPMT

	Execution of DUMPMT may be halted at any time.  Provisions have been
made in question two and question four to terminate the program.  Typing
in two <CONTROL>C's in a row will also terminate the programs execution.
It is recommended that the <CONTROL>C method be avoided.

	The system prompts will appear in all capital letters, while comments
will be in lower case:

1. IS THIS AN EBCDIC TAPE (Y/N)?

	Answering "Y" will invoke the EBCDIC to ASCII translator for the
	remainder of the time the user is running the program.  Answering
	"N" will leave the data unchanged.  If the user doesn"t know if
	the tape is ASCII or EBCDIC, the user should answer "N" to this
	question.  When the data is displayed, the user can see
	if the data makes sense.  If not, the user can re-execute the
	program using the translator. If the user does not translate an
	EBCDIC character tape, many "@" usually appear when the record is
	displayed.  When translated from EBCDIC to ASCII, the "@" becomes
	a space.
 DUMPMT.HLP   -- PAGE 2 --

2. *** AT THE BEGINNING OF THE TAPE ***
   SKIP ANY FILES OR STOP (Y/N/S) ?

   *** AT THE BEGINNING OF FILE NUMBER n ***
   SKIP ANY FILES OR STOP (Y/N/S) ?

	DUMPMT will always tell the user how much (number of files) of the
	tape has been read.  The appropriate message is given each time
	DUMPMT has reached the beginning of a file and a decision as to what
	to do must be made.  One of the three responses must be given.

	If there is only one file on the tape, or if the user wishes
	to read the first (or next) file, the answer "N" should be given.
  	If the user wishes to pass the first (or next) file on the tape, the
	answer should be "Y". A "S" will cause the tape to be rewound and then
	terminate the program.

	Note that header and trailer records, which end with tape marks,
	are considered files by the DUMPMT system.  In effect, a tape
	mark tells DUMPMT that one file is done and the next file, if any,
	begins. If the user does not know if there are header and trailer
	files, the user would want to look at the first file.  A telltale
	sign of a header is the presence of the letters HDR in the first
	three columns of the first record.

3. HOW MANY?

	This question is asked only if "Y" was answered in question two.
	The DUMPMT system will advance the number of tape marks
	mentioned in the answer.  Remember that header and trailer
	records frequently have tape marks and will be included in the
	count.

	If the user is unsure about how many files to skip, it is better
	to guess low.  It is always possible to skip a file and read on
	to the next file.  However, it is not possible to skip back other
	than to rewind the entire tape and start from the BOT.

4.ENTER : NUMBER BLOCKS , STARTING BLOCK

	The object of this program is to do a magnetic tape dump. 
	T ape dumps could get very long, therefore,  this program has
	included an option to select the number of blocks that are to 
	be printed, and the number of the block at which the printing
	is to start.  For example ; if "10,10" was entered, DUMPMT would
	print 10 blocks starting with the 10th block from the beginning
	of the file.  "10,1" would cause the first 10 blocks in the file
	to be printed.

	If "0,n" (zero,any number) is  entered, DUMPMT will print no blocks.
	This is the same as skipping the complete file.

	If the first number entered is negative,("-n,m"), DUMPMT will rewind
        the tape and then terminate execution.  If the second number is
	negative,("n,-m"), DUMPMT will start dumping the blocks starting with
	the first block in the file.

DUMPMT.HLP   -- PAGE 3 --

5. OCTAL OUTPUT ALSO DESIRED (Y,N)?

	Octal output can also be printed.  If "Y" is specified there will
	be three additional lines of printed output for each 100 characters
	read on the tape.  This is because the program prints  its dump
	in groups of 100 characters on the same line.  Each octal output
	line represents only one of the three octal digits.

	Sample output : (only 10 characters are shown here)

	         FILE NUMBER : 1   BLOCK NUMBER : 1   NUMBER CHAR. READ : 10
 
	OCTAL(1).11    1111
	OCTAL(2).2256642464
	OCTAL(3).2451104105
	ASCII ...RT-11 Tape

	In the above example, the lines beginning with "OCTAL(1).",
	"OCTAL(2).", and "OCTAL(3)." are the three additional lines printed.
	The other lines are always printed.

6. *** TAPE MARK ***    FILE :  n   BLOCKS :  m

	This prompt does not require a response from the user.  It is
	intended only as a message stating that the terminating
	tape mark has been found for the n th  file on the tape 
	and this file contained a total of m blocks.  This message is 
	printed for every file that is read by DUMPMT, irrespective of the
	number of blocks that were printed.

	During file skipping this prompt is printed for each file skipped.  
	When the skipping is finished DUMPMT will prompt for the
	number of blocks to be printed in the next file.  
 
	If the number of blocks in a file that are to be printed is less than
	the actual number of blocks in the file, DUMPMT will print the
	number of blocks desired and then automatically skip to the next tape 
	mark.  The tape mark prompt is printed and the user is then prompted
	for more files to be skipped.

	If there are fewer blocks in the file than are to be printed, DUMPMT
	prints only the blocks found.  The tape mark message is printed
	before the next prompting for more files to be skipped.

7. *** (EOT) FOUND *** DONE *** TAPE IS REWOUND

   *** END OF TAPE DURING FILE SKIPPING ***
   *** TAPE HAS BEEN REWOUND ***

	Either message is printed if two tape marks are found in a row or if
	a tape mark is the first thing found on the tape.  This is a normal
	termination in which the tape is rewound before the user is returned 
	to the monitor mode.

8. *** RUN TERMINATED *** TAPE IS REWOUND ***

	This is the message that is printed when a negative number is entered
	as the number of blocks to be printed.  This is also a normal program
	termination in which the tape is first rewound before the user is 
	returned to the monitor mode.

