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 C's in a row will also terminate the programs execution. It is recommended that the 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.