## Notes on oskit: RSX-11Mplus V3.0 system on a RP06 volume

### General remarks

See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on
  1. I/O emulation setup
  2. FPGA Board setup
  3. Rlink and Backend Server setup
  4. SimH simulator setup
  5. Legal terms

**Also read README_license.txt which is included in the oskit !!**

### Installation
A disk set is available from
http://www.retro11.de/data/oc_w11/oskits/rsx11mp-30_rpset.tgz

Download, unpack and copy the disk images (*.dsk), e.g.
```bash
       cd $RETROBASE/tools/oskit/rsx11mp-30_rp
       rsx11mp-30_rp_setup
```

### Usage

- Start disk image in SimH simulator (see section SimH in
  [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh))

  ```
       pdp11 rsx11mp-30_rp_boot.scmd
  ```

  or **ONLY IF YOU HAVE A VALID LICENSE** on w11a (see section Rlink in
  [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink))
  ```
       ti_w11 <opt> @rsx11mp-30_rp_boot.tcl
  ```

  where `<opt>` is the proper option set for the board.

- Hit `<ENTER>` in the `xterm` window to connect to SimH or backend server.
  The boot dialog in the console xterm window will look like
  (required input is in `{..}`, with `{<CR>}` denoting a carriage return:
  ```
       RSX-11M-PLUS V3.0  BL24   1920.KW  System:"RSXMPL"
       >RED DB:=SY:
       >RED DB:=LB:
       >RED DB:=SP:
       >MOU DB:"RSX11MPBL24"
       >@DB:[1,2]STARTUP
       >; ... some comments ...
  ```

  This os version was released in July 1985, so it's no suprise
  that it is not y2k ready. So enter a date before prior to 2000.
  ```
       >* Please enter time and date (HH:MM DD-MMM-YY) [S]: {<.. see above ..>}

       >TIME 12:42 14-MAY-95
       >ACS SY:/BLKS=1024.
       >CON ONLINE ALL
       >ELI /LOG/LIM
       >CLI /INIT=DCL/CTRLC
       >INS LB:[1,1]RMSRESAB.TSK/RON=YES/PAR=GEN
       >INS LB:[1,1]RMSLBL.TSK/RON=YES/PAR=GEN
       >INS LB:[1,1]RMSLBM.TSK/RON=YES/PAR=GEN
       >INS $QMGCLI
       >INS $QMGCLI/TASK=...PRI
       >INS $QMGCLI/TASK=...SUB
       >QUE /START:QMG
       >INS $QMGPRT/TASK=PRT.../SLV=NO
       >QUE LP0:/CR/NM
       >START/ACCOUNTING
       >CON ESTAT LP0:
       >QUE LP0:/SP/FL:2/LOWER/FO:0
       >QUE BAP0:/BATCH
       >QUE LP0:/AS:PRINT
       >QUE BAP0:/AS:BATCH
       >@ <EOF>
       >
  ```

  Now you are at the MCR prompt and can exercise the system.

  At the end it is important to shutdown properly with a `run $shutup`.
  The simulator (or the rlink backend) can be stopped when the
  CPU has halted.
