Mercurial > hg > Members > kono > nitros9-code

comparison docs/nitros9guide/chap1.chapter @ 1011:cc153d1671f7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated for new manuals
author boisy
date Tue, 04 Mar 2003 15:11:34 +0000
parents 525b12e17d60
children d9ed9d44b70c
comparison
equal deleted inserted replaced
1010:1027549ee381 1011:cc153d1671f7
2 <title>Getting Started...</title> 2 <title>Getting Started...</title>
3 3
4 <section> 4 <section>
5 <title>What You Need to Run OS-9</title> 5 <title>What You Need to Run OS-9</title>
6 <para> 6 <para>
7 OS-9 has been tailored to run on your standard, unmodified &make; 7 &os9level &os9version has been tailored to run on the &make;. To use it you'll need the following things:
8 Computer. To use it you'll need the following things:
9 </para> 8 </para>
10 <itemizedlist mark="bullet"> 9 <itemizedlist mark="bullet">
11 <listitem><para>A 64K Memory &make; Computer</para></listitem> 10 <listitem><para>A &minmem &make; </para></listitem>
12 <listitem><para>A &make; Computer Disk Drive With Contoller Cartridge</para></listitem> 11 <listitem><para>A Disk Drive With Contoller Cartridge</para></listitem>
13 <listitem><para>An OS-9 &make; Computer System Disk</para></listitem> 12 <listitem><para>An OS-9 &make; System Disk</para></listitem>
14 </itemizedlist> 13 </itemizedlist>
15 <para> 14 <para>
16 OS-9 is also ready to use the following optional equipment that you 15 OS-9 is also ready to use the following optional equipment that you
17 may have now or may obtain in the future: 16 may have now or may obtain in the future:
18 </para> 17 </para>
19 <itemizedlist mark="bullet"> 18 <itemizedlist mark="bullet">
20 <listitem><para>Additional Expansion Disk Drive(s)</para></listitem> 19 <listitem><para>Additional Floppy Disk Drives</para></listitem>
21 <listitem><para>A Parallel Printer</para></listitem> 20 <listitem><para>SCSI or IDE Hard Drives</para></listitem>
21 <listitem><para>Printers and Serial Ports</para></listitem>
22 <listitem><para>Game Joysticks</para></listitem> 22 <listitem><para>Game Joysticks</para></listitem>
23 <listitem><para>Other OS-9 Compatible Languages and Software</para></listitem> 23 <listitem><para>Other OS-9 Compatible Languages and Software</para></listitem>
24 </itemizedlist> 24 </itemizedlist>
25 25
26 <section> 26 <section>
27 <title>Starting the System</title> 27 <title>Starting the System</title>
28 <para> 28 <para>
29 To start up OS-9 follow these steps: 29 To start up OS-9 follow these steps:
30 30
31 <orderedlist numeration="arabic"> 31 <orderedlist numeration="arabic">
32 <listitem><para>Turn the &make; Computer and disk drive(s) on. You should see 32 <listitem><para>Turn the &make; and disk drive(s) on. You should see
33 the usual Basic greeting message on the screen.</para></listitem> 33 the usual BASIC greeting message on the screen.</para></listitem>
34 34
35 <listitem><para>Insert the OS-9 System Disk in drive zero and close the door.</para></listitem> 35 <listitem><para>Insert the OS-9 System Disk in drive zero and close the door.</para></listitem>
36 36
37 <listitem><para>Type &quot;BOOT&quot;. After a few seconds of disk activity you should 37 <listitem><para>Type &quot;&DOSCMD&quot;. After a few seconds of disk activity you should
38 see a screen with the words &quot;OS9BOOT&quot;.</para></listitem> 38 see a screen with the words &quot;OS9 BOOT&quot;.</para></listitem>
39 39
40 <listitem><para>OS-9 will then begin 40 <listitem><para>OS-9 will then begin
41 its &quot;bootstrap&quot; loading process, which 41 its &quot;bootstrap&quot; loading process, which
42 involves ten to twenty seconds of disk activity. When the system 42 involves ten to twenty seconds of disk activity. When the system
43 startup has finished, a message followed by an &quot;OS9:&quot; prompt will be 43 startup has finished, a message followed by the shell prompt will be
44 displayed.</para></listitem> 44 displayed.</para></listitem>
45 </orderedlist> 45 </orderedlist>
46 </para> 46 </para>
47 </section> 47 </section>
48 48
49 <section> 49 <section>
50 <title>In Case You Have Problems Starting OS-9</title> 50 <title>In Case You Have Problems Starting OS-9</title>
51 <itemizedlist> 51 <itemizedlist>
52 <listitem><para>If Basic gives an error message after you 52 <listitem><para>If BASIC gives an error message after you
53 type &quot;BOOT&quot;, remove the 53 type &quot;&DOSCMD&quot;, remove the
54 disk, turn the computer off and on, then try again. If this 54 disk, turn the computer off and on, then try again. If this
55 repeatedly fails your OS-9 diskette may be bad.</para></listitem> 55 repeatedly fails your OS-9 diskette may be bad.</para></listitem>
56 56
57 <listitem><para>Did you remember to turn the disk drive power switch on?</para></listitem> 57 <listitem><para>Did you remember to turn the disk drive power switch on?</para></listitem>
58 58
59 <listitem><para>Does your &make; Computer have 64K RAM? This is a must!</para></listitem> 59 <listitem><para>Does your &make; have &minmem RAM? This is a must!</para></listitem>
60 60
61 <listitem><para>If your &make; Computer doesn't seem to understand the BOOT 61 <listitem><para>If your &make; doesn't seem to understand the &DOSCMD command, your controller has DOS 1.0. You will need to upgrade to
62 command, contact your dealer.</para></listitem> 62 DOS 1.1.</para></listitem>
63 63
64 <listitem><para>If the &quot;OS9BOOT message is displayed but nothing else happens, 64 <listitem><para>If the &quot;OS9 BOOT message is displayed but nothing else happens,
65 you may have a corrupted system disk. Hopefully you did make a 65 you may have a corrupted system disk. Hopefully you did make a
66 backup!</para></listitem> 66 backup!</para></listitem>
67 </itemizedlist> 67 </itemizedlist>
68 </section> 68 </section>
69 69
90 When OS-9 first starts up, it will display a welcoming message, 90 When OS-9 first starts up, it will display a welcoming message,
91 and then ask you to enter the date and time. This allows OS-9 to 91 and then ask you to enter the date and time. This allows OS-9 to
92 keep track of the date and time of creation of new files and disks. 92 keep track of the date and time of creation of new files and disks.
93 Enter the current date and time in the format requested like this: 93 Enter the current date and time in the format requested like this:
94 <screen> 94 <screen>
95 YY/MM/DD HH:MM:SS 95 yyyy/mm/dd hh:mm:ss
96 TIME ? 83 7 14 1420 96 Time? 2003 03 01 14 20
97 </screen> 97 </screen>
98 In the example above, the date entered was July 14, 1983. OS-9 98 In the example above, the date entered was March 1, 2003. OS-9
99 uses 24-hour time so the date entered was 1420 hours or 2:20 PM. 99 uses 24-hour time so the date entered was 1420 hours or 2:20 PM.
100 Next, OS-9 will print an &quot;OS9:&quot; prompt to let you know it is ready 100 Next, OS-9 will print the shell prompt to let you know it is ready
101 for you to type in a command. 101 for you to type in a command.
102 </para> 102 </para>
103 <para> 103 <para>
104 Now you're ready to try some commands. A good first command to 104 Now you're ready to try some commands. A good first command to
105 try is DIR (for &quot;<emphasis>dir</emphasis>ectory&quot;). 105 try is DIR (for &quot;<emphasis>dir</emphasis>ectory&quot;).
111 followed by a &quot;return&quot;. OS-9 should respond with a listing of file 111 followed by a &quot;return&quot;. OS-9 should respond with a listing of file
112 names which should look something like this: 112 names which should look something like this:
113 <screen> 113 <screen>
114 OS9Boot startup CMDS SYS DEFS 114 OS9Boot startup CMDS SYS DEFS
115 </screen> 115 </screen>
116 The file &quot;OS9Boot&quot; contains the OS-9 program in 6809 machine 116 The file &quot;OS9Boot&quot; contains the OS-9 program in &CPU machine
117 language, which was loaded into memory during the bootstrap 117 language, which was loaded into memory during the bootstrap
118 operation. 118 operation.
119 </para> 119 </para>
120 <para> 120 <para>
121 The file &quot;startup&quot; is a &quot;command file&quot; which is automatically run 121 The file &quot;startup&quot; is a &quot;command file&quot; which is automatically run
158 &quot;SYS&quot;, and &quot;DEFS&quot;. 158 &quot;SYS&quot;, and &quot;DEFS&quot;.
159 The file &quot;CMDS&quot; is a directory that consists of 159 The file &quot;CMDS&quot; is a directory that consists of
160 all the system commands such as DIR, LIST, FORMAT, etc. To see the 160 all the system commands such as DIR, LIST, FORMAT, etc. To see the
161 files contained in this directory, enter: 161 files contained in this directory, enter:
162 <screen> 162 <screen>
163 DIR CMDS 163 dir cmds
164 </screen> 164 </screen>
165 which tells DIR to show files on the directory file CMDS instead 165 which tells DIR to show files on the directory file CMDS instead
166 of the root directory. After you type this you should see a long 166 of the root directory. After you type this you should see a long
167 list of file names. These are the complete set of command programs 167 list of file names. These are the complete set of command programs
168 that come with OS-9 and perform a myriad of functions. Chapter 168 that come with OS-9 and perform a myriad of functions. Chapter
169 Seven explains each one in detail. The DIR command also has a handy 169 Seven explains each one in detail. The DIR command also has a handy
170 option to display the CMDS directory with less typing: 170 option to display the CMDS directory with less typing:
171 <screen> 171 <screen>
172 DIR X 172 dir -x
173 </screen> 173 </screen>
174 Whenever you want a list of available commands you can use this so 174 Whenever you want a list of available commands you can use this so
175 you don't have to look it up in the book. The DIR command has 175 you don't have to look it up in the book. The DIR command has
176 options which can give you more detailed information about each file 176 options which can give you more detailed information about each file.
177 (see sections 3.4 and 3.8.1).
178 </para> 177 </para>
179 </section> 178 </section>
180 </section> 179 </section>
181 <section> 180 <section>
182 <title>Making a Backup of the System Disk</title> 181 <title>Making a Backup of the System Disk</title>
197 <para> 196 <para>
198 IF YOU HAVE ONLY ONE DISK DRIVE you have to be extra careful not to 197 IF YOU HAVE ONLY ONE DISK DRIVE you have to be extra careful not to
199 accidentally FORMAT your system disk. Type: 198 accidentally FORMAT your system disk. Type:
200 199
201 <screen> 200 <screen>
202 FORMAT /D0 201 format /d0
203 </screen> 202 </screen>
204 203
205 and when you see the message 204 and when you see the message
206 205
207 <screen> 206 <screen>
208 DRAGON DISK FORMATTER 1 . 2 207 COLOR COMPUTER FORMATTER
209 FORMAT DRIVE /D0 208 FORMAT DRIVE /D0
210 Y (YES) OR N (NO) 209 Y (YES) OR N (NO)
211 READY? 210 Ready?
212 </screen> 211 </screen>
213 212
214 immediately remove your system disk and insert a blank disk 213 immediately remove your system disk and insert a blank disk
215 <emphasis>before</emphasis> you type &quot;Y&quot;. 214 <emphasis>before</emphasis> you type &quot;Y&quot;.
216 215
250 </para> 249 </para>
251 <para> 250 <para>
252 IF YOU HAVE ONE DRIVE type 251 IF YOU HAVE ONE DRIVE type
253 </para> 252 </para>
254 <screen> 253 <screen>
255 BACKUP /D0 #32k 254 backup /d0 #32k
256 </screen> 255 </screen>
257 <para> 256 <para>
258 The BACKUP program will prompt you to alternately insert the source 257 The BACKUP program will prompt you to alternately insert the source
259 disk (the system disk) and the destination disk (the freshly 258 disk (the system disk) and the destination disk (the freshly
260 formatted disk). 259 formatted disk).
261 </para> 260 </para>
262 <para> 261 <para>
263 IF YOU HAVE TWO DRIVES type 262 IF YOU HAVE TWO DRIVES type
264 </para> 263 </para>
265 <screen> 264 <screen>
266 BACKUP #32K 265 backup #32K
267 </screen> 266 </screen>
268 <para> 267 <para>
269 268
270 The BACKUP program will respond with 269 The BACKUP program will respond with
271 </para> 270 </para>
274 </screen> 273 </screen>
275 <para> 274 <para>
276 Now enter Y for yes. It will then ask: 275 Now enter Y for yes. It will then ask:
277 </para> 276 </para>
278 <screen> 277 <screen>
279 X IS BEING SCRATCHED 278 X is being scratched
280 OK ?: 279 OK ?:
281 </screen> 280 </screen>
282 <para> 281 <para>
283 Answer &quot;Y&quot; for yes again, and the BACKUP process should begin. 282 Answer &quot;Y&quot; for yes again, and the BACKUP process should begin.
284 </para> 283 </para>
295 disk and try to BACKUP again. If BACKUP fails again, the disk is 294 disk and try to BACKUP again. If BACKUP fails again, the disk is
296 physically defective. 295 physically defective.
297 </para> 296 </para>
298 <para> 297 <para>
299 After you have made your backup disk, try turning the &make; 298 After you have made your backup disk, try turning the &make;
300 Computer off and restarting the system with the copy you just made. 299 off and restarting the system with the copy you just made.
301 If it works OK, store it in a safe place in case it is needed later. 300 If it works OK, store it in a safe place in case it is needed later.
302 You should always have a backup copy of your system disk and all 301 You should always have a backup copy of your system disk and all
303 other important disks. 302 other important disks.
304 </para> 303 </para>
305 </section> 304 </section>