first commit

docs/1960s/1965/4kdms/index.md

@@ -0,0 +1,37 @@
+---
+keywords: ["4K DMS", "PDP-8", "PDP-4", 1960s, 1965]
+image: ./4kdms.webp
+description: "! 4K DMS (Disk Monitor System) was an operating system for the DEC PDP-8 computer. We can run it on the SIMH PDP-8 emulator."
+sidebar_position: 2
+---
+
+import DocCardList from '@theme/DocCardList';
+
+# ! 4K DMS
+
+![! 4K DMS](./4kdms.webp)
+
+! 4K DMS (Disk Monitor System) was an operating system for the DEC PDP-8 computer. We can run it on the SIMH PDP-8 emulator.
+
+<DocCardList />
+
+## Manuals
+
+You can download the ! 4K DMS manuals from here:
+
+- [! 4K DMS Manual](http://www.pdp8online.com/pdp8cgi/query_docs/tifftopdf.pl/pdp8docs/dec-08-odsma-a-d.pdf)
+- [! 4K DMS Programmer's Reference Manual](http://www.bitsavers.org/pdf/dec/pdp8/software/DEC-D8-SDAB-D_diskMonPgmRef.pdf)
+
+You may also be interested in the PDP-8 manuals. They were the computers on which ! 4K DMS was supposed to run. You can download them from Bitsavers:
+
+- [PDP-8 Manuals](http://bitsavers.org/pdf/dec/pdp8/)
+
+## Related Pages
+
+- [VirtualHub Screenshots](https://screenshots.virtualhub.eu.org/1960s/1965/4kdms/)
+- [Wikipedia](https://en.wikipedia.org/wiki/PDP-8_4K_Disk_Monitor_System)
+- [Computer History Wiki PDP-8 page](https://gunkies.org/wiki/PDP-8)
+
+## Credits
+
+- The manuals were taken from [www.pdp8online.com](http://www.pdp8online.com/) and [Bitsavers](http://bitsavers.org).

docs/1960s/1965/4kdms/simh/index.md

@@ -0,0 +1,96 @@
+---
+keywords: ["4K DMS", "PDP-8", "PDP-4", SIMH, 1960s, 1965]
+image: ./4K-DMS-SIMH-3.webp
+description: 'We can run ! 4K DMS on the SIMH PDP-8 emulator. First, we need to download the ! 4K DMS kit. You can download the kit needed to run ! 4K DMS on the SIMH PDP-8 emulator from the "SIMH Legacy" website:'
+sidebar_position: 1
+sidebar_label: "! 4K DMS on SIMH"
+---
+
+# How to install ! 4K DMS on SIMH?
+
+![SIMH PDP-8 emulator with ! 4K DMS](./4K-DMS-SIMH-3.webp)
+
+We can run [! 4K DMS](/1960s/1965/4kdms) on the SIMH PDP-8 emulator. First, we need to download the ! 4K DMS kit.
+
+## Downloads
+
+You can download the kit needed to run ! 4K DMS on the SIMH PDP-8 emulator from the ["SIMH Legacy" website](http://simh.trailing-edge.com/):
+
+- [! 4K DMS kit](http://simh.trailing-edge.com/kits/dms8.zip)
+
+## Using ! 4K DMS
+
+:::tip
+
+If you have not already installed SIMH PDP-8 emulator, see [the VirtualHub Setup tutorial on how to do so](https://setup.virtualhub.eu.org/simh-pdp8/) on Linux and Windows.
+
+:::
+
+Extract the kit you downloaded. Inside you will find several files. Create a folder somewhere to store the files for this VM, and move the file named `dms.df32` into it.
+
+Now we will create a config file for our VM. Create a text file called `pdp8.ini` with the following content in the VM folder:
+
+```ini
+set df enabled
+att df dms.df32
+boot -d df
+```
+
+![pdp8.ini](./4K-DMS-SIMH-1.webp)
+
+Now open a terminal and move to the VM folder. Run the following command to start the emulator:
+
+```bash
+pdp8
+```
+
+![pdp8](./4K-DMS-SIMH-2.webp)
+
+After the emulator starts, type `PIP` and press enter. Then press `L`. You will see the following screen:
+
+![.PIP -> *OPT-L](./4K-DMS-SIMH-3.webp)
+
+Type `S:` and press enter. It will list all the files available on the disk.
+
+![List of files in ! 4K DMS](./4K-DMS-SIMH-4.webp)
+
+That's it! We used ! 4K DMS. We can create a shell script to make it easy to launch the VM. Create a file called `4K-DMS.sh` with the following content:
+
+```bash
+#!/bin/bash
+pdp8
+```
+
+Now make the file executable:
+
+```bash
+chmod +x 4K-DMS.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](/1960s/1965/4kdms/#manuals) on the [main ! 4K DMS page](/1960s/1965/4kdms/) 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 `PDP8.exe` file you downloaded in [this tutorial](https://setup.virtualhub.eu.org/simh-pdp8#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 `4K-DMS.bat`. Then you can double-click the file to launch the VM, no need to make it executable.
+
+## Credits
+
+- The disk image and other files used above are from a kit available on [SimH "Classic" website](http://simh.trailing-edge.com/).
+
+## Video tutorial
+
+Do you want to follow the tutorial by watching a video? Here it is:
+
+<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/j-EA1iLc02Y?si=TYw9Wmd05zw2EDer" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+
+<hr/>
+
+Archives of this tutorial are available on [Wayback Machine](https://web.archive.org/web/*/https://virtualhub.eu.org/1960s/1965/4kdms/simh/).