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