MOVEIT is a PDP15 program which enables symbolic files to be transferred between that machine and the FR80. Magnetic tape (7-track, 800 bpi, odd parity) is used as an intermediate medium during the transfer.
The FR80 utility programs SYS;S and SYS;R allow selected FR80 disc files to be transferred to, or removed from, magnetic tape. Files are recorded on tape in FR80 disk dumper format, and a tape so formatted is called an FR80 dump tape. This format records not only the contents of the file, but also its name and a descriptive comment which is called a date (although the description need not be restricted to or even contain any reference to the date).
MOVEIT provides a corresponding set of facilities on the PDP15, allowing selected files to be transferred between dump tapes and either the PDP15 disc, or DECtape. Ordinary DOS-15 character files are copied or corrected during the process. Such files can be manipulated by any standard DOS-15 utility, such as PIP or the editor.
The User should first ensure that all the files required by MOVEIT are present on an appropriate PDP15 device and that the correct DAT slot assignments have been made. (See sections 4 and 5 for a discussion of those points.) The FR80 dump tapes which are to be made or written must then be mounted on the PDP15 tape decks, and unit numbers 1 or 2 selected.
If the User wishes to transfer files to or from DECtapes he should mount them on DECtape units 1 or 2. Execution of MOVEIT is started by typing the DOS-15 command: E MOVEIT. MOVEIT will then be loaded and will identify itself by typing a comment on the teletype. It will then type the characters:
READY >
The appearance of this message indicates that MOVEIT is in COMMAND MODE and is waiting for a COMMAND to be typed. Commands are available for listing the contents of a dump tape, for positioning a tape, and also for printing instructions on how to use MOVEIT. An additional command is present which causes MOVEIT to switch into MOVE MODE. It is in this MOVE mode that file transfer actually occurs. No commands are issued to MOVEIT when it is in MOVE mode; the program prompts the user for the information it requires.
Commands consist of a COMMAND NAME, possibly followed by a <UNIT NUMBER>. Command names are simply character strings and may always be abbreviated to their initial letter. A <UNIT NUMBER> is either the digit 1, or the digit 2. The available commands are:
LIST <UNIT NUMBER>
This command causes the names of all the files stored on the dump tape mounted of tape unit <UNIT NUMBER> to be printed on the teletype. The tape is rewound after listing. Example:
LIST 1 - list all the files on unit 1.
DATE <UNIT NUMBER>
This command causes the tape on tape unit <UNIT NUMBER> to be advanced until a change in the DATE information is found. Recall from section 2 that all files on a dump tape have a descriptive text string called a DATE associated with them. Many different files may have the same DATE. MOVEIT remembers the contents of the last DATE it encountered, and on receiving a DATE command, it will move forward through the files on the selected tape until it finds out whose DATE is different from the one previously remembered. The tape will be positioned immediately before the start of this file, and the new DATE will remember the old in MOVEIT's memory. This facility is provided in order to allow different files with the same name to be distinguished. It imitates a facility provided by the FR80 utilities.
Example: DATE 2 - advance the tape on unit 2 until a change of DATE is found.
REWIND <UNIT NUMBER>
This command causes the tape on tape unit <UNIT NUMBER> to be rewound.
Example: REWIND 2 - rewind the tape on unit 2.
Note that when one of the commands LIST, DATE or REWIND is given to MOVEIT as described above, the <UNIT NUMBER> will be remembered and will be supplied as a default if the <UNIT NUMBER> specification is omitted from a subsequent command.
Example: REWIND - rewind the tape on the previously mentioned tape unit.
HELP
This command causes a summary of the information given here to be printed on the teletype.
MOVE
This command causes MOVEIT to switch into MOVE mode. The program will then explicitly prompt for the additional information that it requires.
TERSE
This command causes the prompting messages given in MOVE mode to be printed in an abbreviated form.
VERBOSE
This command causes the prompting messages given in MOVE mode to be typed in full. This is the initial condition.
QUIT, STOP, EDIT
All of those commands cause MOVEIT to terminate execution and to return to DOS.
It is in MOVE mode that file transfers actually take place. In this mode, MOVEIT types prompting messages for the information that it requires from the user. The reader should examine the examples given in Appendix 1. A description of the various items of information required is given below.
SOURCE and SINK DEVICES
MOVEIT is able to transfer files between magnetic tape and either disc, or DECtape. The file is made from the SOURCE device, and written to the SINK device. Devices are known by mnemonics as follows:
MT1 and MT2 refer to magnetic tape units 1 and 2 respectively. DT1 and DT2 refer to DECtape units 1 and 2 respectively. DK refers to the PDP15 disc.
When MOVEIT asks for the identity of the source device, the user should type in the mnemonic of the device from which he wishes to make the file. The SINK device is specified similarly.
PDP15 FILENAME
When requested to do so, the user should type in the name of the file which he wishes to be read or written. A PDP15 filename consists of a NAME of between 1 and 6 characters, followed by a space, followed by an EXTENSION of 3 characters. Example: DEMO SRC
FR80 FILENAME
The user will also be asked to supply the name of the FR80 file which is to be read from or written to magnetic tape. FR80 filenames consist of a 3 character DIRECTORY NAME followed by a semicolon, followed by a semicolon, followed by a FIRST NAME consisting of between 1 and 6 characters, optionally followed by a space and a SECOND NAME, which has the same form as the first name.
Examples:
JMR;DEMO SOURCE SYM; III 166
If the file is being read from tape, then the tape will be searched forward from its current point for the first file with the specified name.
If several files exist on the tape with the same name, the DATE command should be used to position the tape so that the correct file is read. After reading, the tape is positioned immediately after the file that was read.
DATE
If a file is being written to tape, the user will be asked to supply the DATE description which will be recorded along with the file. Any string of up to 80 characters may be typed in response to this request.
OVERWRITE OR APPEND
When a file is being written to tape, it may either be APPENDED to the end of the set of files already present on the tape, or it may be placed at the beginning of the tape, thereby OVERWRITING any previously recorded files, all of which will be lost. Only the appropriate initial letter (O or A) would be typed in response to the request for this information.
FORM-FEED CHARACTER
FR80 files may contain a special character called the FORM-FEED character, which is used by the FR80 editor to separate the file into pages. Since this character is not normally present in PDP15 files and cannot be manipulated by the PDP15 editors, MOVEIT will substitute another character in its place. When asked to supply the FORM-FEED character, the user should respond by typing the character which he wishes to be used in this substitution. Or he may type nothing. If he does type a character, then: then:
If no substitute character is supplied, all FORM-FEEDS read from tape will be ignored, and conversely no FORM-FEED characters will be written to tape.
Whenever the user types a response to a prompting message in MOVE mode, the response is remembered. If, in a subsequent move operation, the user types an empty line in response to a request, the previous response will be recovered and used as a default. Note however that the default for overwrite or append is always APPEND. Note also that the null response to the request to supply the FORM-FEED character does not invoke the previous response, but rather it indicates that FORM-FEEDs are to be ignored.
MOVEIT returns automatically to COMMAND mode when a file transfer initiated in MOVE mode is completed. The user may force a premature return to COMMAND mode (in order, for instance, to re-position the tape) by typing the single character Q (for "QUIT") in response to any request for information in MOVE mode. Typing "Q" will not cover the default response remembered for the request to be changed.
Four files need to be present in order to run MOVEIT. They are all present on DECtape 1705. The files required are:
MOVEIT XCT MOVEIT XCU (Binary files) FR80 HDR and MHELP SRC (an ASCII file)
MOVEIT XCT and MOVEIT XCU contain the MOVEIT binary program. FR80 HDR contains the data that is needed to construct the header block when a file is written to tape. MHELP SRC contains the information that is printed out in response to the HELP command.
The DAT slot assignments required by MOVEIT are as follows:
The default DAT slot assignments established by DOS are suitable for running MOVEIT.
The sources of MOVEIT are all present on DECtape 1704. The file LIST SRC present on this DECtape contains a list of all the source files needed, and may be used by LISTIT to obtain a listing of those files. The main program is present in the file MOVEIT SRC.
All the binary files for MOVEIT are present on DECTAPE 1704. The compiled version of MOVEIT SRC is in the file MOVEIT BIN. The binary versions of all the other files are collected together in the library file .LIBR5 BIN. MOVEIT XCT and MOVEIT XCU are created by using CHAIN.
The directories of DECtapes 1704 and 1705 are reproduced in Appendix 2. The contents of .LIBR5 BIN are listed in Appendix 3, while Appendix 4 gives the output produced by CHAIN.
The file FR80 HDR can be created by using the program RDHDR. The source for this program is in the file RDHDR SRC on DECtape 1704. RDHDR XCT and RDHDR XCU are on DECtape 1705. In order to use this program. mount any FR80 dump tape on mag tape unit 1 (DAT slot 7 must have MTA1 assigned to it) and just EXECUTE RDHDR (ie type E RDHDR). The header block from the dump tape will be read and copied into a file FR80 HDR on the directories device attached to DAT Slot 6.
On the next 5 pages, are reproduced teletype output produced during 2 runs of MOVE IT. The first simply gives a listing of the information produced in response to a HELP command, while the second demonstrates the use of MOVEIT to actually transfer some files.
All operator input is emphasised in these examples.
E MOVEIT
FR80 / PDP-15 FILE INTERCHANGE PROGRAH.
TYPE "HELP" TO RECEIVE INSTRUCTION.
READY >
HELP
THE FOLLOWING COMMANDS ARE AVAILABLE IN "MOVEIT".
LIST <UNIT NO> LIST CONTENTS OF TAPE ON UNIT <UNIT NO>.
DATE <UNIT NO> ADVANCE THE TAPE ON UNIT <UNIT NO> UNTIL THE NEXT
CHANGE OF "DATE".
REWIND <UNIT NO> REWIND THE TAPE ON UNIT <UNIT NO>.
VERBOSE PRINT ALL PROMPTING MESSAGES IN FULL.
(INITIAL OPTION)
TERSE PRINT ALL PROMPTING MESSAGES IN ABBREVIATED FORM.
HELP PRINT THIS FILE.
MOVE PREPARE TO TRANSFER A FILE. (THE PROGRAM WILL PROMPT
FOR ADDITIONAL INFORMATION SUCH AS FILENAMES.)
QUIT
STOP TERMINATE THE PROGRAM.
END
ONLY THE FIRST CHARACTER OF EACH COMMAND NAME NEED BE TYPED.
NOTE THAT <UNIT NO> MUST BE EITHER 1 OR 2 (OR IT HAY BE OMITTED,
IN WHICH CASE THE LAST VALUE TYPED IN WILL BE USED
AS A DEFAULT).
NOTE ALSO THAT A NULL RESPONSE TO ANY REQUEST FOR INFORMATION
WILL CAUSE THE PREVIOUS RESPONSE TO THAT REQUEST TO BE USED AGAIN.
READY > QUIT
STOP 000000
This example demonstrates the HELP command.
E MOVEIT
FR80 / PDP-15 FILE INTERCHANGE PROGRAM.
TYPE "HELP" TO RECEIVE INSTRUCTION.
READY >
MOVE
SOURCE DEVICE?
CHOOSE FROM : MAGTAPE ("MTI","HT2"),
DECTAPE ("DTI","DT2") OR DISK ("DK").
DK
SINK DEVICE?
CHOOSE FROM : MAGTAPE ("MTI","HT2"),
DECTAPE ("DTI","DT2") OR DISK ("DK").
MT1
DO YOU WISH TO "OVERWRITE" THIS TAPE OR "APPEND" TO IT?
OVERWRITE
ENTER THE NAME OF THE FR80 FILE WHICH YOU WISH TO WRITE.
FORMAT IS - "DIR;NAME1 NAME2".
JMR;DEMO SOURCE
ENTER THE "DATE" - UPTO 80 CHARACTERS.
MOVE IT DEMONSTRATION 12 SEP 75
ENTER THE NAME OF THE PDP-15 FILE WHICH YOU WISH TO READ.
FORMAT IS - "NAME EXT".
DEMO SRC
ENTER THE CHARACTER (IF ANY) WHICH REPRESENTS "FORMS-FEED" IN THE PDP-15.
+++ NONE
TRANSFER COMPLETED.
READY > TERSE.
Here, MOVEIT is used to transfer a PDP-15 file called DEMO SRC from disc to magtape unit 1. The file is given the FR80 filename JMR;DEMO SOURCE.
READY > MOVE SOURCE DEVICE? +++ DK ASSUMED. SINK DEVICE? +++ MT1 ASSUMED. OVERWRITE OR APPEND? +++ "APPEND" ASSUMED. FR80 FILENAME? +++ J}MR;DEMO SOURCE ASSUMED. DATE? +++ DEFAULT DATE USED : MOVEIT DEMONSTRATION 12 SEP 75 PDP-15 FILENAME? +++ DEMO SRC ASSUMED. +++ NONE TRANSFER COMPLETED.
This page demonstrates the use of the default facility in MOVE mode. To each request for information, the user has just typed a "carriage return".
Note that the prompting messages have been abbreviated by previous use of the TERSE command.
READY > MOVE SOURCE DEVICE? MT1 SINK DEVICE? DT1 FR80 FILENAME? +++ JMR;DEMO SOURCE ASSUMED. FR80 FILE NOT FOUND ON THE TAPE. FR80 FILENAME? Q READY >
Here is demonstrated the use of the character "Q" to force a return from MOVE mode to COMMAND mode.
(The file was not found on the tape because the tape was positioned after the two files that had previously been written to it.)
READY > REWIND 1 READY > LIST UNIT 1 ASSUHED. DATE : MOVEIT DEMONSTRATION 12 SEP 75 JMR;DEMO SOURCE JMR;DEMO SOURCE READY > MOVE SOURCE DEVICE? MT1 SINK DEVICE= DT1 FR80 FILENAME? +++ JMR;DEHO SOURCE ASSUMED. PDP-15 FILENAME? +++ DEMO SRC ASSUMED. FORH- FEED CHARACTER? +++ NONE TRANSFER COMPLETED. READY > EXIT STOP 000000 DOS-15 V3BOOO $
This page demonstrates the REWIND and LIST commands (note the default <UNIT NUMBER> used in the LIST command) and also demonstrates the transfer of a file from a dump tape to DECtape.
12-SEP-75 DIRECTORY LISTING 712 FREE BLKS 44 USER FILES 10 SYSTEM BLKS MOVEIT SRC 2 3 IODEV SRC 3 1 RDHDR SRC 4 2 FR80 HDR 5 2 NESRCH SRC 13 1 EQSRCH SRC 14 1 TRANS SRC 16 2 GETPDP SRC 105 4 UNPK57 SRC 20 1 PDPCHS SRC 21 6 NEXTTC SRC 63 4 PUTTC SRC 15 3 RDLINE SRC 117 3 WTLINE SRC 10 2 STOPER SRC 51 1 GETTU SRC 146 3 RWNDER SRC 67 1 LIST SRC 32 1 NEWDAT SRC 44 2 DATER SRC 61 3 PACK57 SRC 64 1 PUTDC SRC 36 3 FINDER SRC 103 4 HOVER SRC 104 12 NEXTDC SRC 27 2 GETFR SRC 30 5 POSTP SRC 113 5 PACK6 SRC 124 1 TERSER SRC 131 1 UNPK6 SRC 136 1 VBOSER SRC 141 1 LISTER SRC 24 3 FDATE SRC 17 2 HELPER SRC 25 1 MHELP SRC 37 2 TTIO SRC 57 26
12-SEP-75 DIRECTORY LISTING 617 FREE BLKS 10 USER FILES 10 SYSTEM BLKS TTIO SRC 57 26 .LIBR5 BIN 1 104 MOVEIT BIN 4 5 MOVEIT XCV 3 104 MOVEIT XCT 10 1 MHELIP SRC 5 2 RDHDR XCU 14 26 RDHDR XCT 36 1 FR80 HDR 35 2
| PROGRAM NAME | SOURCE EXTENSION |
PROGRAM SIZE |
|---|---|---|
| TTIO | SRC | 641 |
| IODEV | SRC | 2 |
| MOVER | 2214 | |
| DATER | 671 | |
| TERSER | 30 | |
| VBOSER | 30 | |
| LISTER | 1266 | |
| STOPER | 6 | |
| RWNDER | 52 | |
| HELPER | 365 | |
| NEWDAT | 304 | |
| GETTU | 341 | |
| NEXTTC | 640 | |
| NEXTDC | 472 | |
| PUTTC | 453 | |
| PUTDC | 575 | |
| GETPDP | 1036 | |
| GETFR | 1117 | |
| FINDFR | 1013 | |
| POSTP | 2075 | |
| PDATE | 204 | |
| UNPK57 | 71 | |
| PACK57 | 114 | |
| UNPK6 | 72 | |
| PACK6 | 203 | |
| EQSRCH | 63 | |
| NESRCH | 63 | |
| PDPCHS | SRC | 112 |
| RDLINE | SRC | 65 |
| WTLINE | SRC | 32 |
| JMPDEF | 126 | |
| NEWJMP | 211 | |
| JUMP | 22 | |
| ADPUT | SRC | 11 |
| ERRMES | 44 | |
| YYCARG | 64 |
A DK -5
$CHAIN
CHAIN V7A
NAME XCT FILE >
MOVEIT
LIST OPTIONS & PARAMETERS
>
DEFINE RESIDENT CODE
>MOVEIT
DESCRIBE LINKS & STRUCTURE
>
MOVEIT 76614-77636
TTIO 75753-76613
IODEV 75751-75752
MOVER 73535-75750
DATER 72644-73534
TERSER 72614-72643
VBOSER 72564-72613
LISTER 71276-72563
STOPER 71270-71275
RWNDER 71216-71267
HELPER 70631-71215
NEWDAT 70325-70630
GETTU 67437-67777
NEXTTC 66577-67436
NEXTDC 66105-66576
PUTTC 65432-66104
PUTDC 64635-65431
GETPDP 63577-64634
GETFR 62460-64576
FINDFR 61445-62457
POSTP 55703-57777
PDATE 70121-70324
UNPK57 70030-70120
PACK57 61331-61444
UNPK6 61237-61330
PACK6 61034-61236
EQSRCH 60751-61033
NESRCH 60666-60750
PDPCHS 60554-60665
RDLINE 60467-60553
WTLINE 60435-60466
JMPDEF 60307-60434
NEWJMP 60076-60306
JUMP 60054-60075
ADPUT 60043-60053
ERRMES 55637-55702
YYCARG 55553-55636
MAGTAP 55162-55552
MVC 55024-55161
FILE 54436-55023
.DA 54360-54435
.DJ 54307-54357
BCDIO 50264-54306
BINIO 47421-47777
GOTO 50236-50263
STOP 50155-50235
SPMSG 50036-50154
.FLTB 47133-47420
FIOPS 46162-47132
PARTWD 46022-46161
INTEAE 45671-46021
RELEAE 44572-45670
OTSER 44362-44571
.CB 60021-60042
GLOBAL 70010-70027
HEADER 43762-70027
HEADER 43762-44361
UNITS 70001-70007
CMND 50012-50035
INOUT 60015-60020
LFEED 70000-70000
STRCOM 43651-43761
MTAPE 37651-43650
ST 60004-60014
SUBTAB 37532-37650
CHARS 37516-37531
CHBUF 37454-37515
CONERR 60003-60003
CORE REQ'D
37454-77636
DOS-15 V3B000