Ibm1130/readme1130.txt

   1 Here's the 1130 simulator as it stands now.
   2
   3 Status: 22Jul2003
   4
   5  * Added support for APL\1130 output translations
   6    and some bug fixes uncovered by APL.
   7
   8 Status: 13Sep2002
   9
  10  * Added support for 1403 printer. It's MUCH faster
  11    even in emulation. Not important for general use,
  12    but it will help the CGI version a lot.
  13
  14 Status: 16Aug2002
  15
  16  * Disk Monitor System R2V12 is available including the
  17    Macro Assembler, Fortran Compiler and System Library.
  18
  19  * There was a bug in the multiply instruction. This has
  20    been fixed, and now the single precision trig functions
  21    work correctly.
  22
  23  * The card punch does not yet work correctly.
  24
  25  * The card reader, punch and disk don't compute their device
  26    status word until an XIO requests it; this is probably bad
  27    as the "examine" command will show the wrong value. Doesn't
  28    affect functioning of emulated software, though.
  29
  30  * Documentation is a work in progress, see ibm1130.doc
  31    in ibm1130software.zip.  We hope to have it finished in
  32    October. This is a Word document. Will distribute as a
  33    PDF when it's finished.
  34
  35  * Thanks to Oscar E Wyss (www.cosecans.ch) for
  36    the DMS V12 source code listings and one card
  37    programs, to Douglas W. Jones for the DMS V10, 11 and
  38    12 microfiche (which will end up scanned on IBM1130.org).
  39
  40  * Thanks to Robert Alan Byer for adding the 1130
  41    to the simh makefiles & testing the builds on several
  42    platforms.
  43
  44  * For updated information about the 1130 and for
  45    future 1130 OS and application software developments,
  46    check www.ibm1130.org periodically.  Sign up for the
  47    mailing list to get updates as they occur!
  48
  49  * Cross-assembler has been updated to handle card image input
  50    correctly. The DMS sources seems to mix up @ and '
  51    as a leading symbol in labels, I have to find out why
  52    this is.
  53
  54 BUILD NOTES: if you download this simulator directly from
  55 IBM1130.org, the makefile, source, and binaries are all in
  56 the main directory. If you use the version from Bob Supnik's
  57 SIMH distribution, the makefile is in the main simh
  58 directory, and the SCP files used are Bob's.  For a
  59 Windows build, use the .mak file in the IBM1130 directory,
  60 as this incorporates the GUI.
  61
  62 Make the utilities in the utils directory if you want
  63 to actually build and load DMS from scratch.  Move the
  64 executables to a common directory in your search path
  65
  66 Brian Knittel
  67 brian@ibm1130.org
  68
  69 --------------------------------------------------------------------------
  70 Some sample things to run:
  71 (it's best to hit CHECK RESET or type "reset" between program runs!)
  72
  73 * Run a Fortran Program
  74         ibm1130
  75         do job roots
  76         do job csort
  77
  78 * List the monitor system disk's contents
  79         ibm1130
  80         do job list
  81
  82 * Look into the files "job", "roots.job" and "csort.job" and "list.job"
  83   to see the actual input files
  84
  85 * When the jobs have run (stop at 2A with 1000 in the
  86   accumulator), detach the printer (det prt) and look at
  87   the output file: for.lst or asm.lst. The supplied "job"
  88   script displays the print output automatically on Windows
  89   builds.
  90
  91 --------------------------------------------------------------------------
  92 Contents:
  93
  94 There are several programs:
  95
  96         ibm1130         the simulator
  97         asm1130         cross assembler
  98         bindump         dumps contents of relocatable format object decks (xxx.bin)
  99         checkdisk       validates DMS disk format
 100         diskview        dumps contents of DMS disk directory
 101         mkboot          creates IPL and Core Image Format Decks from .bin
 102         viewdeck        displays contents of Hollerith-format binary decks
 103
 104 Files in the software (sw) directory:
 105
 106    actual 1130 software:
 107         dms.dsk         disk image file containing Disk Monitor System
 108         zdcip.asm       disk cartridge initialization program
 109         zcrdumpc.asm    a cold-start-mode one card memory dump program
 110         dmsboot.asm     source code for the DMS cold start loader
 111
 112    contributed software:
 113         onecard/*       one-card programs from Oscar Wyss
 114
 115 --------------------------------------------------------------------------
 116 Status of the simulator:
 117
 118 * There is a reasonably fun console GUI available for Windows builds,
 119   as well as support for the 2250 graphical display.
 120
 121 * The card reader emulator now supports deck files with literal cards and
 122   breakpoints. The command "attach cr @filename" tells the simulator to
 123   read data from the files named in the specified file. Input lines are of
 124   the following form:
 125
 126    filename a                 -- input file to be read as ascii text
 127    filename b                 -- input file to be read as binary card images
 128    !xyz...                    -- literal text xyz..., treated as a card
 129    !break                     -- halts the simulator
 130    #comment                   -- remarks
 131
 132 * The do command may have arguments after the filename. These may be
 133   interpolated in the script and in card reader deck files with %1, %2, etc
 134
 135 --------------------------------------------------------------------------
 136 sample usage
 137 --------------------------------------------------------------------------
 138
 139 ibm1130
 140         starts SIMH-based simulator.
 141         Optional command line arguments: -q quiet mode, -g no GUI
 142
 143         Enhancements:
 144
 145         * Windows builds display a console window
 146
 147         * CPU activity log
 148
 149                 the command "attach cpu file.log" will make the simulator
 150                 write a detailed log of CPU and IO activity, good for
 151                 debugging. Turn off with "detach cpu".
 152
 153         * DO command [arg1 arg2...]
 154                 reads file 'filename' for SIMH commands. Lets you write
 155                 simh command files to be run from the prompt rather
 156                 than just the command line. In the do command file, %1 will
 157                 be replaced by the first command line argument, etc. This
 158                 applies to the script run from the ibm1130 command line too.
 159
 160         * DELETE filename
 161                 deletes the named file
 162
 163         * VIEW filename
 164                 displays the named file with "notepad." (Windows only).
 165
 166 --------------------------------------------------------------------------
 167 asm1130 -l program.asm
 168
 169         compiles source file, creates simulator load
 170         file (program.out) and listing file (program.lst)
 171
 172         The cross assembler wants files either in strict column
 173         layout matching the IBM spec, or, if tabs are present in the
 174         source file,
 175
 176         label<tab>opcode<tab>flags<tab>operand
 177
 178         The output file is in the format used by the 1130 simulator's
 179         load command.
 180
 181 --------------------------------------------------------------------------
 182
 183 Note: the DMS disk is built with the Windows batch file "mkdms.bat".
 184
 185 Subnote: DMS cannot be built with the 1130's native assembler.
 186
 187
 188 --------------------------------------------------------------------------
 189 check www.ibm1130.org for updates...