.layout 2,2 .style headers 3,1,6,7,7,1,1,9,2 .first title .title TAPE__DUMP User Guide .fill .no autojustify .no justify .no number .require "TAPE_DUMP.RNT" .subtitle .date .page .send toc ^^Preface .blank 10 Preface .blank 2 This manual is intended as a guide to the use of the TAPE__DUMP Utility. .blank .number page .chapter ^^TAPE__DUMP Utility .header level 1 ^^Description .header level 1 ^^Usage Summary .chapter ^^TAPE__DUMP Commands .header level 1 ^^Command Summary The following list shows the available commands: .blank .list 0 " " .list element;BACKSPACE .list element;CLOSE .list element;COPY .list element;CREATE .list element;DISABLE .list element;DISPLAY .list element;DUMP .list element;ENABLE .list element;EXIT .list element;FIND .list element;OPEN .list element;REWIND .list element;SET COPY .list element;SET DUMP .list element;SET RECORDSIZE .list element;SHOW .list element;SKIP .list element;SPAWN .list element;UNLOAD .list element;USE .end list .page .header level 1 ^^BACKSPACE Moves the tape backwards to the position indicated. .blank .repeat 70 "__" .blank Format .blank .left margin +4 BACKSPACE [ item ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 "item" can either be a record count (defaults to 1 if omitted) or one of the following keywords. .list " " .list element;BOF to position to the beginning of the current file. .list element;BOT to position to the beginning of the tape. .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^CLOSE Closes the current output file. .blank .repeat 70 "__" .blank Format .blank .left margin +4 CLOSE .left margin -4 .blank .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^COPY Copies data from the tape to the currently selected output file. .blank .repeat 70 "__" .blank Format .blank .left margin +4 COPY [ item ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 "item" can either be a record count (defaults to 1 if omitted) or one of the following keywords. .list " " .list element;EOF to copy to the end of the current file. .list element;EOT to copy to the physical end of tape. .list element;EOV to copy to the logical end of tape. .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^CREATE Creates a file to receive data from the COPY command. .blank .repeat 70 "__" .blank Format .blank .left margin +4 CREATE filespec .left margin -4 .blank .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^DISABLE Disables data conversion or debug options. .blank .repeat 70 "__" .blank Format .blank .left margin +4 DISABLE [ option ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 .list " " .list element;CONVERT to disable EBCDIC to ASCII conversion. .list element;DEBUG to disable debug information. (Default) .list element;SENSECHAR to disable sensechar debug information. .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^DISPLAY Displays the contents of the tape to be viewed at your terminal. .blank .repeat 70 "__" .blank Format .blank .left margin +4 DISPLAY [ item ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 "item" can either be a record count (defaults to 1 if omitted) or one of the following keywords. .list " " .list element;EOF to display to the end of the current file. .list element;EOT to display to the physical end of tape. .list element;EOV to display to the logical end of tape. .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^DUMP Dumps the contents of the tape to be viewed at your terminal. .blank .repeat 70 "__" .blank Format .blank .left margin +4 DUMP [ item ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 "item" can either be a record count (defaults to 1 if omitted) or one of the following keywords. .list " " .list element;EOF to dump to the end of the current file. .list element;EOT to dump to the physical end of tape. .list element;EOV to dump to the logical end of tape. .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^ENABLE Enables data conversion or debug options. .blank .repeat 70 "__" .blank Format .blank .left margin +4 ENABLE [ item ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 .list " " .list element;CONVERT to enable EBCDIC to ASCII conversion. .list element;DEBUG to enable debug information. (Default) .list element;SENSECHAR to enable sensechar debug information. .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^EXIT Exits TAPE__DUMP. .blank .repeat 70 "__" .blank Format .blank .left margin +4 EXIT .left margin -4 .blank .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^FIND Finds the specified location on the tape. .blank .repeat 70 "__" .blank Format .blank .left margin +4 FIND keyword .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 .list " " .list element;BOF the beginning of the current file. .list element;BOT the beginning of the tape. .list element;EOF the end of the current file. .list element;EOT the physical end of tape. .list element;EOV the logical end of tape. .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^OPEN Opens a file to receive data from the COPY command. .blank .repeat 70 "__" .blank Format .blank .left margin +4 OPEN filespec .left margin -4 .blank .repeat 70 "__" .blank Description .blank .left margin +4 See the description of the CREATE command for details. .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^REWIND Rewinds the tape without unloading it. .blank .repeat 70 "__" .blank Format .blank .left margin +4 REWIND .left margin -4 .blank .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^SET COPY Sets the COPY logging option. .blank .repeat 70 "__" .blank Format .blank .left margin +4 SET COPY [ option ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 .list " " .list element;LOG to enable logging of copy operations. .list element;NOLOG to disable logging of copy operations. (Default) .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^SET DUMP Sets the characteristics to be used by the DUMP command. .blank .repeat 70 "__" .blank Format .blank .left margin +4 SET DUMP [ keyword ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 .list " " .list element;ASCII Data is displayed in ascii. (Default) .list element;BOTH Data is displayed in ascii and hexadecimal. .list element;FULL Full records are dumped. .list element;HEXADECIMAL Data is displayed in hexadecimal. .list element;SHORT Only one segment of each record is displayed. .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^SET RECORDSIZE Sets the recordsize to be used during COPY operations. .blank .repeat 70 "__" .blank Format .blank .left margin +4 SET RECORDSIZE [ n ] .left margin -4 .blank .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^SHOW Shows various settings and status information. .blank .repeat 70 "__" .blank Format .blank .left margin +4 SHOW [ keyword ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 .list " " .list element;ALL (Default) .list element;COPY .list element;DEBUG .list element;DEVICE .list element;DISPLAY .list element;DUMP .list element;OUTPUT .list element;TAPE .list element;VERSION .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^SKIP Moves the tape forward to the specified location. .blank .repeat 70 "__" .blank Format .blank .left margin +4 SKIP [ item ] .left margin -4 .blank .repeat 70 "__" .blank Keywords .blank .left margin +4 "item" can either be a record count (defaults to 1 if omitted) or one of the following keywords. .list " " .list element;EOF to position to the end of the current file. .list element;EOT to position to the physical end of tape. .list element;EOV to position to the logical end of tape. .end list .left margin -4 .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^SPAWN Spawns a sub-process. .blank .repeat 70 "__" .blank Format .blank .left margin +4 SPAWN .left margin -4 .blank .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^UNLOAD Rewinds and unloads the tape, but does not exit. .blank .repeat 70 "__" .blank Format .blank .left margin +4 UNLOAD .left margin -4 .blank .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list .page .header level 1 ^^USE Specifies which tape device to use. .blank .repeat 70 "__" .blank Format .blank .left margin +4 USE device .left margin -4 .blank .repeat 70 "__" .blank Description .blank .left margin +4 .left margin -4 .blank .repeat 70 "__" .blank Examples .list .list element; .blank .list element; .blank .end list