Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/chap1.chapter @ 148:525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
| author | roug |
|---|---|
| date | Sun, 07 Jul 2002 11:45:13 +0000 |
| parents | f4e798ea65b9 |
| children | cc153d1671f7 |
| rev | line source |
|---|---|
| 144 | 1 <chapter> |
| 2 <title>Getting Started...</title> | |
| 3 | |
| 4 <section> | |
| 5 <title>What You Need to Run OS-9</title> | |
| 6 <para> | |
|
148
525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
roug
parents:
144
diff
changeset
|
7 OS-9 has been tailored to run on your standard, unmodified &make; |
| 144 | 8 Computer. To use it you'll need the following things: |
| 9 </para> | |
| 10 <itemizedlist mark="bullet"> | |
|
148
525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
roug
parents:
144
diff
changeset
|
11 <listitem><para>A 64K Memory &make; Computer</para></listitem> |
|
525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
roug
parents:
144
diff
changeset
|
12 <listitem><para>A &make; Computer Disk Drive With Contoller Cartridge</para></listitem> |
|
525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
roug
parents:
144
diff
changeset
|
13 <listitem><para>An OS-9 &make; Computer System Disk</para></listitem> |
| 144 | 14 </itemizedlist> |
| 15 <para> | |
| 16 OS-9 is also ready to use the following optional equipment that you | |
| 17 may have now or may obtain in the future: | |
| 18 </para> | |
| 19 <itemizedlist mark="bullet"> | |
| 20 <listitem><para>Additional Expansion Disk Drive(s)</para></listitem> | |
| 21 <listitem><para>A Parallel Printer</para></listitem> | |
| 22 <listitem><para>Game Joysticks</para></listitem> | |
| 23 <listitem><para>Other OS-9 Compatible Languages and Software</para></listitem> | |
| 24 </itemizedlist> | |
| 25 | |
| 26 <section> | |
| 27 <title>Starting the System</title> | |
| 28 <para> | |
| 29 To start up OS-9 follow these steps: | |
| 30 | |
| 31 <orderedlist numeration="arabic"> | |
|
148
525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
roug
parents:
144
diff
changeset
|
32 <listitem><para>Turn the &make; Computer and disk drive(s) on. You should see |
| 144 | 33 the usual Basic greeting message on the screen.</para></listitem> |
| 34 | |
| 35 <listitem><para>Insert the OS-9 System Disk in drive zero and close the door.</para></listitem> | |
| 36 | |
| 37 <listitem><para>Type "BOOT". After a few seconds of disk activity you should | |
| 38 see a screen with the words "OS9BOOT".</para></listitem> | |
| 39 | |
| 40 <listitem><para>OS-9 will then begin | |
| 41 its "bootstrap" loading process, which | |
| 42 involves ten to twenty seconds of disk activity. When the system | |
| 43 startup has finished, a message followed by an "OS9:" prompt will be | |
| 44 displayed.</para></listitem> | |
| 45 </orderedlist> | |
| 46 </para> | |
| 47 </section> | |
| 48 | |
| 49 <section> | |
| 50 <title>In Case You Have Problems Starting OS-9</title> | |
| 51 <itemizedlist> | |
| 52 <listitem><para>If Basic gives an error message after you | |
| 53 type "BOOT", remove the | |
| 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> | |
| 56 | |
| 57 <listitem><para>Did you remember to turn the disk drive power switch on?</para></listitem> | |
| 58 | |
|
148
525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
roug
parents:
144
diff
changeset
|
59 <listitem><para>Does your &make; Computer have 64K RAM? This is a must!</para></listitem> |
| 144 | 60 |
|
148
525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
roug
parents:
144
diff
changeset
|
61 <listitem><para>If your &make; Computer doesn't seem to understand the BOOT |
| 144 | 62 command, contact your dealer.</para></listitem> |
| 63 | |
| 64 <listitem><para>If the "OS9BOOT message is displayed but nothing else happens, | |
| 65 you may have a corrupted system disk. Hopefully you did make a | |
| 66 backup!</para></listitem> | |
| 67 </itemizedlist> | |
| 68 </section> | |
| 69 | |
| 70 <section> | |
| 71 <title>A Quick Introduction to the Use of the Keyboard and Disks</title> | |
| 72 <para> | |
| 73 For now, the only special keys on the keyboard of interest are | |
| 74 the SHIFT key which works like a typewriter shift key; the ENTER key | |
| 75 which you always use after typing a command or response to OS-9; and | |
| 76 the <- left arrow key which you can use to erase typing mistakes. | |
| 77 </para> | |
| 78 <para> | |
| 79 Your main disk drive is known to to OS-9 as "/D0" and is often | |
| 80 called "drive zero". If you have a second disk drive (drive one), | |
| 81 OS-9 recognizes it as "/D1". Why would anybody put a "/" in a name? | |
| 82 Because all input and output devices have names like files, and | |
| 83 names that start with "/" are always device names. | |
| 84 </para> | |
| 85 </section> | |
| 86 | |
| 87 <section> | |
| 88 <title>Initial Explorations</title> | |
| 89 <para> | |
| 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 | |
| 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: | |
| 94 <screen> | |
| 95 YY/MM/DD HH:MM:SS | |
| 96 TIME ? 83 7 14 1420 | |
| 97 </screen> | |
| 98 In the example above, the date entered was July 14, 1983. OS-9 | |
| 99 uses 24-hour time so the date entered was 1420 hours or 2:20 PM. | |
| 100 Next, OS-9 will print an "OS9:" prompt to let you know it is ready | |
| 101 for you to type in a command. | |
| 102 </para> | |
| 103 <para> | |
| 104 Now you're ready to try some commands. A good first command to | |
| 105 try is DIR (for "<emphasis>dir</emphasis>ectory"). | |
| 106 This will display a list of the files | |
| 107 on the System Disk. Just type: | |
| 108 <screen> | |
| 109 dir | |
| 110 </screen> | |
| 111 followed by a "return". OS-9 should respond with a listing of file | |
| 112 names which should look something like this: | |
| 113 <screen> | |
| 114 OS9Boot startup CMDS SYS DEFS | |
| 115 </screen> | |
| 116 The file "OS9Boot" contains the OS-9 program in 6809 machine | |
| 117 language, which was loaded into memory during the bootstrap | |
| 118 operation. | |
| 119 </para> | |
| 120 <para> | |
| 121 The file "startup" is a "command file" which is automatically run | |
| 122 when the system starts up, and has the commands that printed the | |
| 123 welcoming message and asked for the time. Later, You may want to | |
| 124 replace this startup file with your own customized version after you | |
| 125 are more familiar with OS-9. Do you want to see the contents of | |
| 126 this file? If so, just type | |
| 127 <screen> | |
| 128 list startup | |
| 129 </screen> | |
| 130 As you can see, the LIST command displays the contents of files | |
| 131 that contain text (alphabetic characters). Some files like the | |
| 132 "OS9Boot" file contain binary data such as machine language | |
| 133 programs. These files are called "binary files", and attempts to | |
| 134 list them will result in a jumbled, meaningless display. On the | |
| 135 other hand, OS-9 will complain mightily if you try to run a text | |
| 136 file as a program! | |
| 137 </para> | |
| 138 <para> | |
| 139 As you may have surmised by now, the way you ask OS-9 to run a | |
| 140 program or command (they're really the same thing) is to simply type | |
| 141 its name. Some commands like LIST require one or more names of | |
| 142 files or options. If so, they are typed on the same line using | |
| 143 spaces to separate each item. | |
| 144 </para> | |
| 145 <para> | |
| 146 But where did the LIST and DIR programs come from? There are | |
| 147 really more files on the disk than you suspect. The DIR command | |
| 148 showed you what is the disk's | |
| 149 <emphasis>root directory</emphasis> - so named because the | |
| 150 OS-9 filing system resembles a tree. Growing out of the root | |
| 151 directory are three "branches" - files which are additional | |
| 152 directories of file names instead of programs or data. They in turn | |
| 153 can have even more "branches" - ad infinitum. If you draw a map on | |
| 154 paper of how this works it does look like a tree. | |
| 155 </para> | |
| 156 <para> | |
| 157 The directory files on your system disk are called "CMDS", | |
| 158 "SYS", and "DEFS". | |
| 159 The file "CMDS" is a directory that consists of | |
| 160 all the system commands such as DIR, LIST, FORMAT, etc. To see the | |
| 161 files contained in this directory, enter: | |
| 162 <screen> | |
| 163 DIR CMDS | |
| 164 </screen> | |
| 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 | |
| 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 | |
| 169 Seven explains each one in detail. The DIR command also has a handy | |
| 170 option to display the CMDS directory with less typing: | |
| 171 <screen> | |
| 172 DIR X | |
| 173 </screen> | |
| 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 | |
| 176 options which can give you more detailed information about each file | |
| 177 (see sections 3.4 and 3.8.1). | |
| 178 </para> | |
| 179 </section> | |
| 180 </section> | |
| 181 <section> | |
| 182 <title>Making a Backup of the System Disk</title> | |
| 183 <para> | |
| 184 Before getting too much more involved in further experimentation, | |
| 185 NOW is the time to make one or more exact copies of your System Disk | |
| 186 in case some misfortune befalls your one and only master System | |
| 187 Disk. Making a backup involves two steps: formatting a blank disk | |
| 188 and running a backup program. | |
| 189 </para> | |
| 190 <section> | |
| 191 <title>Formatting Blank Disks</title> | |
| 192 <para> | |
| 193 Before the actual backup procedure can be done (or any fresh | |
| 194 diskette is used for any purpose), the blank disk which is to become | |
| 195 the backup disk must be initialized by OS-9's FORMAT command. | |
| 196 </para> | |
| 197 <para> | |
| 198 IF YOU HAVE ONLY ONE DISK DRIVE you have to be extra careful not to | |
| 199 accidentally FORMAT your system disk. Type: | |
| 200 | |
| 201 <screen> | |
| 202 FORMAT /D0 | |
| 203 </screen> | |
| 204 | |
| 205 and when you see the message | |
| 206 | |
| 207 <screen> | |
| 208 DRAGON DISK FORMATTER 1 . 2 | |
| 209 FORMAT DRIVE /D0 | |
| 210 Y (YES) OR N (NO) | |
| 211 READY? | |
| 212 </screen> | |
| 213 | |
| 214 immediately remove your system disk and insert a blank disk | |
| 215 <emphasis>before</emphasis> you type "Y". | |
| 216 | |
| 217 IF YOU HAVE TWO DISK DRIVES place the blank disk in drive one and | |
| 218 type: | |
| 219 </para> | |
| 220 <screen> | |
| 221 FORMAT /D1 | |
| 222 </screen> | |
| 223 <para> | |
| 224 WHEN THE BLANK DISK IS IN THE RIGHT PLACE, type "Y", then "ENTER". | |
| 225 This initiates the formatting process. IF THE CORRECT DEVICE NAME | |
| 226 (/D1) IS NOT DISPLAYED: TYPE N RIGHT NOW and start over, OR YOU | |
| 227 MAY ERASE your System Disk. | |
| 228 </para> | |
| 229 <para> | |
| 230 When you are asked for a disk name, type any letter, then ENTER. | |
| 231 The name you give is not important. If you have only one drive, | |
| 232 replace the system disk after the FORMAT program has finished. If | |
| 233 the FORMAT program reported any errors, try again. Disks used for | |
| 234 backups can't have any errors. You're now ready to run the BACKUP | |
| 235 program. | |
| 236 </para> | |
| 237 <para> | |
| 238 It takes several minutes for the FORMAT program to run. During | |
| 239 its second phase the hexadecimal number of each track will be | |
| 240 displayed as it is checked for bad sectors. If any are found an | |
| 241 error message for each bad sector is given. | |
| 242 </para> | |
| 243 </section> | |
| 244 | |
| 245 <section> | |
| 246 <title>Running the Backup Program</title> | |
| 247 <para> | |
| 248 The BACKUP program makes an exact duplicate of a disk. It can be | |
| 249 used even if you only have one disk drive. | |
| 250 </para> | |
| 251 <para> | |
| 252 IF YOU HAVE ONE DRIVE type | |
| 253 </para> | |
| 254 <screen> | |
| 255 BACKUP /D0 #32k | |
| 256 </screen> | |
| 257 <para> | |
| 258 The BACKUP program will prompt you to alternately insert the source | |
| 259 disk (the system disk) and the destination disk (the freshly | |
| 260 formatted disk). | |
| 261 </para> | |
| 262 <para> | |
| 263 IF YOU HAVE TWO DRIVES type | |
| 264 </para> | |
| 265 <screen> | |
| 266 BACKUP #32K | |
| 267 </screen> | |
| 268 <para> | |
| 269 | |
| 270 The BACKUP program will respond with | |
| 271 </para> | |
| 272 <screen> | |
| 273 Ready to BACKUP from /D0 to /D0 (or /D1) ? | |
| 274 </screen> | |
| 275 <para> | |
| 276 Now enter Y for yes. It will then ask: | |
| 277 </para> | |
| 278 <screen> | |
| 279 X IS BEING SCRATCHED | |
| 280 OK ?: | |
| 281 </screen> | |
| 282 <para> | |
| 283 Answer "Y" for yes again, and the BACKUP process should begin. | |
| 284 </para> | |
| 285 <para> | |
| 286 The BACKUP command has two phases: the first phase copies | |
| 287 everything from drive zero to drive one checking for errors while | |
| 288 reading from the master but not for "write" errors. The second | |
| 289 phase is the "verify" pass which makes sure everything was copied | |
| 290 onto the new disk correctly. If any errors are reported during the | |
| 291 first (copy) pass, there is a problem with the master disk or its | |
| 292 drive. If errors occur during the second (verify) pass, there is a | |
| 293 problem with the new disk and the BACKUP program should be run | |
| 294 again. If BACKUP repeatedly fails on the second pass, reformat the | |
| 295 disk and try to BACKUP again. If BACKUP fails again, the disk is | |
| 296 physically defective. | |
| 297 </para> | |
| 298 <para> | |
|
148
525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
roug
parents:
144
diff
changeset
|
299 After you have made your backup disk, try turning the &make; |
| 144 | 300 Computer 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. | |
| 302 You should always have a backup copy of your system disk and all | |
| 303 other important disks. | |
| 304 </para> | |
| 305 </section> | |
| 306 </section> | |
| 307 </chapter> |