add dos-11 on simh

docs/1970s/1970/dos-11/index.md

@@ -5,11 +5,15 @@ description: "! DOS-11 was an operating system for the DEC PDP-11 computer. We c
 sidebar_position: 5
 ---
 
+import DocCardList from '@theme/DocCardList';
+
 # ! DOS-11
 
 ![! DOS-11](./dos-11.webp)
 
-! DOS-11 (**D**isk **O**perating **S**ystem - 11) was an operating system for the DEC PDP-11 computer. It has no relation with MS-DOS/PC-DOS other than the fact that all of them are ***disk*** operating systems. We can run DOS-11 on SIMH
+! DOS-11 (**D**isk **O**perating **S**ystem - 11) was an operating system for the DEC PDP-11 computer. It has no relation with MS-DOS/PC-DOS other than the fact that all of them are **_disk_** operating systems. We can run DOS-11 on SIMH.
+
+<DocCardList />
 
 ## Manuals
 
@@ -17,7 +21,7 @@ You can download the ! DOS-11 Handbook from here (it is broken into several PDFs
 
 - [! DOS-11 Handbook](http://www.bitsavers.org/pdf/dec/pdp11/dos-batch/V9/DosBatchHandbook_v9_Apr74/)
 
-There are many other additional DOS-11 manuals on bitsaver:
+There are many other additional DOS-11 manuals on Bitsavers:
 
 - [Other DOS-11 Manuals](http://www.bitsavers.org/pdf/dec/pdp11/dos-batch/)
 

docs/1970s/1970/dos-11/simh/index.md

@@ -0,0 +1,230 @@
+---
+keywords: ["DOS-11", "PDP-11", SIMH, 1970s, 1970]
+image: ./dos-11-simh-23.webp
+description: "We can run ! DOS-11 on the SIMH PDP-11 emulator. First, we need to download the ! DOS-11 tapes. You can download them from Bitsavers:"
+sidebar_position: 1
+sidebar_label: "! DOS-11 on SIMH"
+---
+
+# How to install DOS-11 on SIMH?
+
+![SIMH PDP-11 emulator with ! DOS-11](./dos-11-simh-23.webp)
+
+We can run [! DOS-11](/1970s/1970/dos-11) on the SIMH PDP-11 emulator. First, we need to download the ! DOS-11 tapes.
+dos-11-simh-23.webp
+
+## Downloads
+
+You can download the tapes needed to install ! DOS-11 on the SIMH PDP-11 emulator from Bitsavers:
+
+- [! DOS-11 tape 1 of 3](http://bitsavers.org/bits/DEC/pdp11/dectape/BS/v920c1.dta)
+- [! DOS-11 tape 2 of 3](http://bitsavers.org/bits/DEC/pdp11/dectape/BS/v920c2.dta)
+- [! DOS-11 tape 3 of 3](http://bitsavers.org/bits/DEC/pdp11/dectape/BS/v920c3.dta)
+
+## Installing ! DOS-11
+
+:::tip
+
+If you have not already installed SIMH PDP-11 emulator, see [the VirtualHub Setup tutorial on how to do so](https://setup.virtualhub.eu.org/simh-pdp11/) on Linux and Windows.
+
+:::
+
+:::tip
+
+If you want, you can skip these installation steps, and download a pre-installed image from this website: [http://iamvirtual.ca/PDP-11/DOS-11/DOSv9-20C-RK05.DSK](http://iamvirtual.ca/PDP-11/DOS-11/DOSv9-20C-RK05.DSK). Rename the file to `rk05.dsk` and move it to the VM folder. Now you can start [using DOS-11](#using-dos-11)!
+
+:::
+
+Create a folder somewhere to store the for this VM, and move the tapes into it.
+
+Now we will create a config file for our VM. Create a text file called `pdp11.ini` with the following content in the VM folder:
+
+```ini
+set cpu 11/05
+set cpu 64K
+set hk disable
+set ptr disable
+set ptp disable
+set dz disable
+set rl disable
+set rx disable
+set rp disable
+set rq disable
+set tm disable
+set tq disable
+set rk enable
+attach rk0 rk05.dsk
+set tc enable
+attach tc0 v920c1.dta
+set tc0 locked
+attach tc1 v920c2.dta
+set tc1 locked
+attach tc2 v920c3.dta
+set tc2 locked
+attach lpt lineprinter.txt
+boot tc0
+```
+
+![installation pdp11.ini](./dos-11-simh-1.webp)
+
+Now open a terminal and move to the VM folder. Run the following command to start the emulator:
+
+```bash
+pdp11
+```
+
+![start pdp11 emulator for installation](./dos-11-simh-2.webp)
+
+After the emulator starts, you will be asked for `CONSOLE FILL COUNT`. Type `0` and press enter. Then, you will be asked for a date. Enter the date in the `DD-MMM-YY` format. For example, enter `11-JAN-74`. To avoid various issues. Enter a date from the 1970s.
+
+![console fill count & date (installation)](./dos-11-simh-3.webp)
+
+To the `DIALOGUE?` prompt, type `Y` and press enter. When asked if you want help, type `N` and press enter. When asked `LP ONLINE ?`, enter `Y`.
+
+![dialogue, help & lp online (installation)](./dos-11-simh-4.webp)
+
+You will get a `#` prompt. Type `DK0:MONLIB.CIL/ZERO/HOOK/BOOT<DT0:MONLIB.LCL` and press enter.
+
+![MONLIB.CIL (installation)](./dos-11-simh-5.webp)
+
+Then you will get `ANSWER WITH CARRET OR 'Y'CARRET:- IS YOUR LINE FREQUENCY 50 HERTZ?`. Type `^` and press enter. When asked if you want to disable dialogue forever, type `N` and press enter.
+
+The system will restart.
+
+![ANSWER WITH CARRET & disable dialogue forever (installation)](./dos-11-simh-6.webp)
+
+You will be asked for date again. Enter the date in the same format as above. Then you will be asked for time. Enter the time in `HH:MM` format. For example, enter `09:12`. When prompted `DIALOGUE?` type `Y` and press enter. You will be asked whether you want to reset "fill count". Type `N` and press enter. When asked if any devices are down, type `N` and press enter.
+
+![system restarted (installation)](./dos-11-simh-7.webp)
+
+You will be asked if you want to change line printer. Press `Y` and press enter. When prompted with `LS11?` enter `Y`.
+
+![change line printer (installation)](./dos-11-simh-8.webp)
+
+When asked `HOW MANY COLUMNS ?`, enter `132`. Type `N` and press enter when asked `LOWER CASE?`, `Y` when asked `OVERPRINT?`, `Y` when asked `ELONGATION` and `N` when asked if you got RK02 disks.
+
+![printer config (installation)](./dos-11-simh-9.webp)
+
+You will get a `$` prompt. Type `LOGIN 1,1` to log in.
+
+![login (installation)](./dos-11-simh-10.webp)
+
+Then type `RUN DT0:PIP16` and press enter. The prompt will change to `#`.
+
+![run pip (installation)](./dos-11-simh-11.webp)
+
+Type `SY:<DT0:DTBLD.BAT` and press enter. Then press `Ctrl` + `C`. The prompt will change to `.`. Type `KI` and press enter to exit `PIP`.
+
+![exit pip (installation)](./dos-11-simh-12.webp)
+
+The prompt will turn back to `$`. Type `BATCH SY:DTBLD.BAT` and press enter.
+
+![BATCH SY:DTBLD.BAT (installation)](./dos-11-simh-13.webp)
+
+When you get a `$` prompt, type `CO` and press enter to continue.
+
+![Start installation (installation)](./dos-11-simh-14.webp)
+
+You will get a `$` prompt, asking to type `CO` or `KI`, three times. Type `CO` the first time (RF or RK disk), `KI` the second time (RF or RK disk) and `CO` the third time (Line Printer or not) and press enter to continue.
+
+![CO (1) & KI (2) (installation)](./dos-11-simh-15.webp)
+
+![CO (3) (installation)](./dos-11-simh-16.webp)
+
+At last, you will be asked to type `TE`. Do so, and press enter to finish the installation.
+
+![TE (installation)](./dos-11-simh-17.webp)
+
+Now, press `Ctrl` + `e` to pause the emulation, and then enter `exit` to exit the emulator.
+
+![Exit emulator (installation)](./dos-11-simh-18.webp)
+
+That's it, we have installed DOS-11. We can now start using it. You can delete all the files other than the `rk05.dsk` disk image. We will create a fresh `pdp11.ini` file.
+
+## Using DOS-11
+
+Now we will create a fresh config file for using DOS-11. Create a text file called `pdp11.ini` with the following content in the VM folder:
+
+```ini
+set cpu 11/05
+set cpu 64K
+set hk disable
+set ptr disable
+set ptp disable
+set dz disable
+set rl disable
+set rx disable
+set rp disable
+set rq disable
+set tm disable
+set tq disable
+set rk enable
+attach rk0 rk05.dsk
+set tc enable
+attach lpt lineprinter.txt
+boot rk0
+```
+
+![pdp11.ini](./dos-11-simh-19.webp)
+
+Now open a terminal and move to the VM folder. Run the following command to start the emulator:
+
+```bash
+pdp11
+```
+
+After the emulator starts, you will be asked for a date. Enter the date in the `DD-MMM-YY` format. For example, enter `11-JAN-74`. To avoid various issues. Enter a date from the 1970s. Then, you will be asked for time. Enter the time in `HH:MM` format. For example, enter `15:09`. Next, you will be asked if you want dialogue. Type `N` and press enter to continue.
+
+![Date, Time, Dialogue](./dos-11-simh-20.webp)
+
+Type `LOGIN 1,1` and press enter to log in. The system date and time will be printed.
+
+![login](./dos-11-simh-21.webp)
+
+Now type `RUN PIP` and press enter to start `PIP`.
+
+![login](./dos-11-simh-22.webp)
+
+The prompt will change to `#`. Type `/DI` to see a list of files in the `1,1` account.
+
+![list of files](./dos-11-simh-23.webp)
+
+To exit `PIP`, you can press `Ctrl` + `C`. After the prompt turns to `.`, type `KI` and press enter. To quit the emulation, press `Ctrl` + `e` and then enter `exit`.
+
+That's it! We used ! DOS-11. We can create a shell script to make it easy to launch the VM. Create a file called `dos-11.sh` with the following content:
+
+```bash
+#!/bin/bash
+pdp11
+```
+
+Now make the file executable:
+
+```bash
+chmod +x dos-11.sh
+```
+
+Now you can start the VM using the shell script. For example, on KDE you can right-click the file and choose `Run in Konsole` or on GNOME, where you can right-click the file and choose `Run as executable`. The VM will start.
+
+See the [manuals section](/1970s/1970/dos-11/#manuals) on the [main ! DOS-11 page](/1970s/1970/dos-11) to learn how to use it.
+
+## Windows
+
+:::tip
+
+You should use Linux. If you don’t know how to install a Linux distro, see [our tutorials on how to install Kubuntu](https://setup.virtualhub.eu.org/tag/os/), a beginner-friendly distro.
+
+:::
+
+On Windows, you need to place the `PDP11.exe` file you downloaded in [this tutorial](https://setup.virtualhub.eu.org/simh-pdp11#windows) in the VM folder. Then you can follow the above tutorial as usual. The shell script will not work on Windows. You need to rename it to `dos-11.bat`. Then you can double-click the file to launch the VM, no need to make it executable.
+
+## Credits
+
+- The DOS-11 tapes used above were taken from [Bitsavers](http://bitsavers.org).
+- This tutorial is based on the tutorial from this website: [http://iamvirtual.ca/PDP-11/DOS-11/Install.htm](http://iamvirtual.ca/PDP-11/DOS-11/Install.htm)
+
+## Video tutorial
+
+Do you want to follow the tutorial by watching a video? We will post a video on our [YouTube channel](https://www.youtube.com/@virtua1hub) soon.
+
+Archives of this tutorial are available on [Wayback Machine](https://web.archive.org/web/*/https://virtualhub.eu.org/1970s/1970/dos-11/simh/).