Moving files with DUMP and itstar.

README.md

@@ -86,6 +86,7 @@ There are some short introductions for beginners:
 - [TECO survival guide](doc/TECO.md)
 - [DDT debugging newbie guide](doc/debugging.md)
 - [Hello MIDAS](doc/hello-midas.md)
+- [DUMP and itstar](doc/DUMP-itstar.md)
 
 A list of [known ITS machines](doc/machines.md).
 

doc/DUMP-itstar.md

@@ -0,0 +1,59 @@
+# DUMP and itstar
+
+### Saving ITS files and extract them using itstar
+
+- Mount a tape image in the emulator.  For KLH10, type Control-\\, and
+  then
+
+       devmount mta0 files.tape create
+       continue
+
+  For SIMH, type Control-E, and then
+
+       attach tu0 files.tape
+       continue
+
+- In ITS, type `:dump`.  At the _ prompt, type `dump`.  The `FILE=`
+  prompt will accept directory and file names.  `*` can be used as a
+  wild card.  Finish with an empty line.  When DUMP has finished
+  writing the files, type `quit` to exit.
+
+- Unmount the tape image.  For KLH10, type Control-Z, and
+
+       devunmount mta0
+       continue
+
+  For SIMH, type Control-E, and then
+
+       detach tu0
+       continue
+
+- In the host, run itstar to extract the files:
+
+       itstar -xf files.tape
+
+### Moving host files to ITS
+
+- Create one or more directories, and put the files in them.  There
+  can not be directories inside directories.  For example, let's say
+  you created the directores foo and bar.
+
+- Run itstar to make a tape image:
+
+       itstar -cf files.tape foo bar
+
+- Mount the tape image in the emulator.  For KLH10, type Control-\\ and
+
+       devmount mta0 files.tape
+       continue
+
+  For SIMH, type Control-E, and then
+
+       attach tu0 files.tape
+       continue
+
+- In ITS, type `:dump`.  At the _ prompt, type `load`.  The `FILE=`
+  prompt will accept file names as above.  Finish with an empty line.
+  When DUMP has finished reading the files, type `quit` to exit.
+
+- Unmount the tape image as above.