First Commit of my working state

[simh.git] / Ibm1130 / readme1130.txt

Here's the 1130 simulator as it stands now.\r
\r
Status: 22Jul2003\r
\r
 * Added support for APL\1130 output translations\r
   and some bug fixes uncovered by APL.\r
\r
Status: 13Sep2002\r
\r
 * Added support for 1403 printer. It's MUCH faster\r
   even in emulation. Not important for general use,\r
   but it will help the CGI version a lot.\r
\r
Status: 16Aug2002\r
\r
 * Disk Monitor System R2V12 is available including the\r
   Macro Assembler, Fortran Compiler and System Library.\r
\r
 * There was a bug in the multiply instruction. This has\r
   been fixed, and now the single precision trig functions\r
   work correctly.\r
\r
 * The card punch does not yet work correctly.\r
\r
 * The card reader, punch and disk don't compute their device\r
   status word until an XIO requests it; this is probably bad\r
   as the "examine" command will show the wrong value. Doesn't\r
   affect functioning of emulated software, though.\r
\r
 * Documentation is a work in progress, see ibm1130.doc\r
   in ibm1130software.zip.  We hope to have it finished in\r
   October. This is a Word document. Will distribute as a\r
   PDF when it's finished.\r
\r
 * Thanks to Oscar E Wyss (www.cosecans.ch) for\r
   the DMS V12 source code listings and one card\r
   programs, to Douglas W. Jones for the DMS V10, 11 and\r
   12 microfiche (which will end up scanned on IBM1130.org).\r
\r
 * Thanks to Robert Alan Byer for adding the 1130\r
   to the simh makefiles & testing the builds on several\r
   platforms.\r
\r
 * For updated information about the 1130 and for\r
   future 1130 OS and application software developments,\r
   check www.ibm1130.org periodically.  Sign up for the\r
   mailing list to get updates as they occur!\r
\r
 * Cross-assembler has been updated to handle card image input\r
   correctly. The DMS sources seems to mix up @ and '\r
   as a leading symbol in labels, I have to find out why\r
   this is.\r
\r
BUILD NOTES: if you download this simulator directly from\r
IBM1130.org, the makefile, source, and binaries are all in\r
the main directory. If you use the version from Bob Supnik's\r
SIMH distribution, the makefile is in the main simh\r
directory, and the SCP files used are Bob's.  For a\r
Windows build, use the .mak file in the IBM1130 directory,\r
as this incorporates the GUI.\r
\r
Make the utilities in the utils directory if you want\r
to actually build and load DMS from scratch.  Move the\r
executables to a common directory in your search path\r
\r
Brian Knittel\r
brian@ibm1130.org\r
\r
--------------------------------------------------------------------------\r
Some sample things to run:\r
(it's best to hit CHECK RESET or type "reset" between program runs!)\r
\r
* Run a Fortran Program\r
        ibm1130\r
        do job roots\r
	do job csort\r
\r
* List the monitor system disk's contents\r
        ibm1130 \r
	do job list\r
\r
* Look into the files "job", "roots.job" and "csort.job" and "list.job"\r
  to see the actual input files\r
\r
* When the jobs have run (stop at 2A with 1000 in the\r
  accumulator), detach the printer (det prt) and look at\r
  the output file: for.lst or asm.lst. The supplied "job"\r
  script displays the print output automatically on Windows\r
  builds.\r
\r
--------------------------------------------------------------------------\r
Contents:\r
\r
There are several programs:\r
\r
	ibm1130		the simulator\r
	asm1130		cross assembler\r
	bindump		dumps contents of relocatable format object decks (xxx.bin)\r
	checkdisk	validates DMS disk format\r
	diskview	dumps contents of DMS disk directory\r
	mkboot		creates IPL and Core Image Format Decks from .bin\r
	viewdeck	displays contents of Hollerith-format binary decks\r
\r
Files in the software (sw) directory:\r
\r
   actual 1130 software:\r
        dms.dsk         disk image file containing Disk Monitor System\r
	zdcip.asm	disk cartridge initialization program\r
        zcrdumpc.asm    a cold-start-mode one card memory dump program\r
        dmsboot.asm     source code for the DMS cold start loader\r
\r
   contributed software:\r
	onecard/*	one-card programs from Oscar Wyss\r
\r
--------------------------------------------------------------------------\r
Status of the simulator:\r
\r
* There is a reasonably fun console GUI available for Windows builds,\r
  as well as support for the 2250 graphical display.\r
\r
* The card reader emulator now supports deck files with literal cards and\r
  breakpoints. The command "attach cr @filename" tells the simulator to\r
  read data from the files named in the specified file. Input lines are of\r
  the following form:\r
\r
   filename a                 -- input file to be read as ascii text\r
   filename b                 -- input file to be read as binary card images\r
   !xyz...                    -- literal text xyz..., treated as a card\r
   !break                     -- halts the simulator\r
   #comment                   -- remarks\r
\r
* The do command may have arguments after the filename. These may be\r
  interpolated in the script and in card reader deck files with %1, %2, etc\r
\r
--------------------------------------------------------------------------\r
sample usage\r
--------------------------------------------------------------------------\r
\r
ibm1130\r
	starts SIMH-based simulator. \r
        Optional command line arguments: -q quiet mode, -g no GUI\r
\r
	Enhancements:\r
\r
	* Windows builds display a console window\r
\r
	* CPU activity log\r
\r
		the command "attach cpu file.log" will make the simulator\r
		write a detailed log of CPU and IO activity, good for\r
		debugging. Turn off with "detach cpu".\r
\r
	* DO command [arg1 arg2...]\r
		reads file 'filename' for SIMH commands. Lets you write\r
		simh command files to be run from the prompt rather\r
		than just the command line. In the do command file, %1 will\r
                be replaced by the first command line argument, etc. This\r
                applies to the script run from the ibm1130 command line too.\r
\r
        * DELETE filename\r
                deletes the named file\r
\r
        * VIEW filename\r
                displays the named file with "notepad." (Windows only). \r
\r
--------------------------------------------------------------------------\r
asm1130 -l program.asm\r
\r
	compiles source file, creates simulator load\r
	file (program.out) and listing file (program.lst)\r
\r
	The cross assembler wants files either in strict column\r
	layout matching the IBM spec, or, if tabs are present in the\r
	source file,\r
\r
	label<tab>opcode<tab>flags<tab>operand\r
\r
	The output file is in the format used by the 1130 simulator's\r
	load command.\r
\r
--------------------------------------------------------------------------\r
\r
Note: the DMS disk is built with the Windows batch file "mkdms.bat".\r
\r
Subnote: DMS cannot be built with the 1130's native assembler.\r
\r
	\r
--------------------------------------------------------------------------\r
check www.ibm1130.org for updates...\r