3 files changed, 84 insertions, 0 deletions
diff --git a/sites/pmikkelsen.com/mainframe/MVS-TK5-Setup.md b/sites/pmikkelsen.com/mainframe/MVS-TK5-Setup.md
new file mode 100644
index 0000000..6630fb7
--- /dev/null
+++ b/sites/pmikkelsen.com/mainframe/MVS-TK5-Setup.md
@@ -0,0 +1,28 @@
+# Introduction
+
+This is how I setup mainframe.pmikkelsen.com, which runs MVS TK5.
+It might not be the best way to do things, and it for sure isn't the most secure way, but.. yeah.
+
+# Setup a server
+
+I chose an ubuntu 24.04 server from Hetzner, and hopefully the cheapest one is powerful enough.
+
+# Download and setup TK5
+
+At the time of writing, the version I downloaded is MVS TK5 update 4.
+
+	cd somewhere/that/makes/sense
+	wget https://www.prince-webdesign.nl/images/downloads/mvs-tk5.zip
+	chmod -R +x *
+	cd unattended
+	./set_console_mode
+	./mvs
+
+Now the system is running, and you should be able to connect to it using x3270 on linux, specifying the server's IP and port 3270.
+
+It is probably a good idea to run the ./mvs script inside `screen` or `tmux` so the ssh connection to the server can be closed without stopping the emulator.
+
+# Setting up accounts
+
+It is probably a good idea to change the passwords for the default accounts, or at least the admin ones. Also, while we are at it, adding some new users can be added. Both of these steps are described in the [Adding Users](adding-users) guide.
+
diff --git a/sites/pmikkelsen.com/mainframe/adding-users.md b/sites/pmikkelsen.com/mainframe/adding-users.md
new file mode 100644
index 0000000..70c5aa2
--- /dev/null
+++ b/sites/pmikkelsen.com/mainframe/adding-users.md
@@ -0,0 +1,20 @@
+# Adding a new user
+
+Let's add a user called `TAGE` (named after the guy from the "Dage med Tage" sketch), with the password `linie`.
+
+* Login as someone who has rights to do this sort of thing, such as `HERC01`
+* Navigate to `SYS2.JCLLIB(ADDUSER)`
+* Tweak it as needed, so the last line is `//ADDUSER EXEC ADDUSER,HLQ=TAGE,UTYPE=USER`
+
+The username is specified after `HLQ`, and the user type here is `USER`, but it could also have been `SYSP`.
+
+* Submit the job (write `SUBMIT` on the `Command ===>` line and hit enter).
+* Navigate to `SYS1.SECURE.CNTL(USERS)` and add a new line with the contents `TAGE USER ABCD N` (the fields must line up with the rest of the file, and `ABCD` is the password).
+
+# Changing password
+
+To change your password, connect to the mainframe and at the `Logon ===>` prompt, type your username. Instead of replying with your password, reply with `linie/snaps`, where `linie` is your current password, and `snaps` is your new password.
+
+# `/s rakfuser` (IMPORTANT)
+
+To make any of the changes effective, you must run `/s rakfuser` on the mvs console (the linux terminal session where `./mvs` is running).
diff --git a/sites/pmikkelsen.com/mainframe/howto.md b/sites/pmikkelsen.com/mainframe/howto.md
new file mode 100644
index 0000000..2809db4
--- /dev/null
+++ b/sites/pmikkelsen.com/mainframe/howto.md
@@ -0,0 +1,36 @@
+## Transfer file to/from MVS
+
+Let's say I have written some wise words in a file on mvs, and I want a copy on my linux machine. The MVS file name is `PETER.TEST.TEXT(WISDOM)`, and the linux file is `/tmp/wisdom.txt`. In the file transfer gui, the MVS file name must be enclosed in single quotes.
+
+* On MVS: hit F3 until you get to the READY prompt.
+* Now click `File > File transfer...` in x3270, and type in the local (linux) and host (mvs) file names. The options selected should be `Receive from host`, `Host is TSO`, `Transfer ASCII file`. I leave the rest as it is.
+* Click `Transfer File`
+* Check that it transferred the file.
+
+Example file contents:
+
+	peter@fedora:~$ cat /tmp/wisdom.txt 
+	Så blev de sgu sure.
+	Det er linie.
+
+
+To transfer a file from linux to mvs, follow the same steps, but click the `Send to host` option instead.
+
+## Get back to "the main menu" (ISPF) after hitting F3 too many times
+
+Type `ispf` at the `READY` prompt.
+
+## Exit the editor when it says "SAVE not valid in VIEW mode"
+
+You have opened the editor in view mode (v), but made changes. You should probably have opened it in edit mode (e). For now, type `cancel` to discard your changes, and try again in edit mode this time.
+
+## Help, I can't type anything, and there is a big red X at the bottom of my x3270 window
+
+Hit RESET (Alt-r), and place the curser somewhere where you are allowed to type.There is also HOME (Alt-h) which is nice.
+
+## Scroll
+
+* Up: `F7`
+* Down: `F8`
+* Left: `F10`
+* Right: `F11`