Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/config.refentry @ 3222:c086a5d69b78
Corrected ,pc should have been ,pcr in KRNP3.asm
| author | David Ladd <drencor-xeen@users.sourceforge.net> |
|---|---|
| date | Wed, 20 Dec 2017 23:28:18 -0600 |
| parents | 4dae346c4969 |
| children |
| rev | line source |
|---|---|
| 152 | 1 <refentry id="config"> |
| 2 <refnamediv> | |
| 3 <refname>CONFIG</refname> | |
| 4 <refpurpose>Configures an OS-9 system diskette</refpurpose> | |
| 5 </refnamediv> | |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>config</command> |
| 152 | 10 </cmdsynopsis> |
| 11 </refsynopsisdiv> | |
| 12 | |
| 13 <refsect1><title>Description</title> | |
| 14 | |
| 15 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
16 <command>Config</command> provides menus of all I/O options and all system commands. You select |
| 152 | 17 the device drivers and commands you want to include on a new system diskette |
| 18 from these menus. Selecting only the device drivers and commands you and | |
| 19 your system require lets you make the most efficient use of computer | |
| 20 memory and system diskette storage. | |
| 21 </para> | |
| 22 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
23 The <command>config</command> utility is on a separate CONFIG/BOOT Diskette. Make a copy of this |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
24 diskette using the OS-9 <command>backup</command> command and use the copy as your working |
| 152 | 25 diskette. Keep the original CONFIG/BOOT Diskette in a safe place to use |
| 26 for future backups. You can use the CONFIG/BOOT Diskette for booting OS-9 | |
| 153 | 27 from &make; Disk BASIC from Drive /D0. |
| 152 | 28 </para> |
| 29 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
30 <command>Config</command> requires no initial parameters. You establish parameters during the |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
31 operation of <command>config</command>. Be sure that the execution directory is at /D0/CMDS |
| 152 | 32 before executing the command. |
| 33 </para> | |
| 34 <para> | |
| 35 Examples: | |
| 36 </para> | |
| 37 <screen> | |
| 38 CONFIG [ENTER] | |
| 39 </screen> | |
| 40 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
41 <command>Config</command> executes and a prompt asks you to indicate whether you wish to use |
| 152 | 42 one or two disk drives. Press [1] for single- or [2] for two-drive |
| 43 operation. | |
| 44 </para> | |
| 45 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
46 Next, <command>config</command> builds a list of the various devices from the MODULES directory. |
| 152 | 47 When the list is complete, a screen menu appears. Use the up and down arrow |
| 48 keys to move to a device. Then, press [S] to either select or exclude a | |
| 49 particular device. Press [S] once to display an X to the right of the | |
| 50 selected device. Press [S] again to erase the X. The device is selected | |
| 51 only when the "X" appears. Information about each device is available with | |
| 52 a special help command. To display the information on the current device | |
| 53 (the device indicated by the right arrow [->]), press [H]. | |
| 54 </para> | |
| 55 <para> | |
| 157 | 56 If there are more than ten devices in a CONFIG menu, use [->] to move ahead |
| 57 page-by-page and [<-] to move back. | |
| 152 | 58 </para> |
| 59 <para> | |
| 60 The devices you can select are: | |
| 61 </para> | |
| 157 | 62 |
| 63 <informaltable frame="none"> | |
| 64 <tgroup cols="2"> | |
| 648 | 65 <colspec colwidth="1in"/> |
| 66 <colspec colwidth="4in"/> | |
| 157 | 67 <tbody> |
| 68 <row> | |
| 69 <entry>term32</entry> | |
| 70 <entry>The computer keyboard and standard TV display</entry> | |
| 71 </row> | |
| 72 <row> | |
| 73 <entry>term80</entry> | |
| 74 <entry>The computer keyboard and optional 80 column video display</entry> | |
| 75 </row> | |
| 76 <row> | |
| 77 <entry>d0</entry> | |
| 78 <entry>Disk Drive 0</entry> | |
| 79 </row> | |
| 80 <row> | |
| 81 <entry>d1</entry> | |
| 82 <entry>Disk Drive 1</entry> | |
| 83 </row> | |
| 84 <row> | |
| 85 <entry>d2</entry> | |
| 86 <entry>Disk Drive 2</entry> | |
| 87 </row> | |
| 88 <row> | |
| 89 <entry>d3</entry> | |
| 90 <entry>Disk Drive 3</entry> | |
| 91 </row> | |
| 92 <row> | |
| 93 <entry>h0_15</entry> | |
| 94 <entry>A 15 meg hard disk drive 0</entry> | |
| 95 </row> | |
| 96 <row> | |
| 97 <entry>h1_15</entry> | |
| 98 <entry>A 15 meg hard disk drive 1</entry> | |
| 99 </row> | |
| 100 <row> | |
| 101 <entry>h0_35</entry> | |
| 102 <entry>A 35 meg hard disk drive 0</entry> | |
| 103 </row> | |
| 104 <row> | |
| 105 <entry>h1_35</entry> | |
| 106 <entry>A 35 meg hard disk drive 1</entry> | |
| 107 </row> | |
| 108 <row> | |
| 109 <entry>p</entry> | |
| 110 <entry>A printer using the RS-232 serial port</entry> | |
| 111 </row> | |
| 112 <row> | |
| 113 <entry>t1</entry> | |
| 114 <entry>A terminal port using the standard RS-232 port</entry> | |
| 115 </row> | |
| 116 <row> | |
| 117 <entry>t2</entry> | |
| 118 <entry>A terminal port using the optional RS-232 communications pak</entry> | |
| 119 </row> | |
| 120 <row> | |
| 121 <entry>t3</entry> | |
| 122 <entry>A terminal port using the optional RS-232 communications pak</entry> | |
| 123 </row> | |
| 124 <row> | |
| 125 <entry>m1</entry> | |
| 126 <entry>A modem</entry> | |
| 127 </row> | |
| 128 <row> | |
| 129 <entry>m2</entry> | |
| 130 <entry>A modem</entry> | |
| 131 </row> | |
| 132 <row> | |
| 133 <entry>ssc</entry> | |
| 134 <entry>Speech/Sound Cartridge</entry> | |
| 135 </row> | |
| 136 </tbody> | |
| 137 </tgroup> | |
| 138 </informaltable> | |
| 139 | |
| 152 | 140 <para> |
| 141 To use your computer keyboard and video display, you must select one term. | |
| 142 You must select d0 as your first disk drive. Select d1, d2, and d3 for | |
| 143 additional floppy disk drives. Select /p to use a printer with OS-9, | |
| 144 select ssc to use a Speech/Sound Cartridge from a Multi-Pak slot, and | |
| 145 so forth. | |
| 146 </para> | |
| 147 <para> | |
| 148 After selecting the devices you desire, press [D]. The screen displays, | |
| 149 ARE YOU SURE (Y/N) ? If you are satisfied with your selections, press [Y]. | |
| 150 If you wish to make further changes, press [N]. | |
| 151 </para> | |
| 152 <para> | |
| 153 When the driver selection is complete, a screen prompt requests that you | |
| 1011 | 154 select among the &make; terminal I/O subroutines. Select these |
| 152 | 155 subroutines in the same manner that you selected the device drivers. |
| 156 You have the following modules from which to make your selections: | |
| 157 </para> | |
| 157 | 158 <informaltable frame="none"> |
| 159 <tgroup cols="2"> | |
| 648 | 160 <colspec colwidth="1in"/> |
| 161 <colspec colwidth="4in"/> | |
| 157 | 162 <tbody> |
| 163 <row> | |
| 164 <entry>CO32</entry> | |
| 165 <entry>A video output module for a 32 column TV display</entry> | |
| 166 </row> | |
| 167 <row> | |
| 168 <entry>CO80</entry> | |
| 169 <entry>A video output module for a 80 column video display</entry> | |
| 170 </row> | |
| 171 <row> | |
| 172 <entry>GRFO</entry> | |
| 173 <entry>A graphics module for TV display</entry> | |
| 174 </row> | |
| 175 </tbody> | |
| 176 </tgroup> | |
| 177 </informaltable> | |
| 152 | 178 <para> |
| 179 When choosing subroutine modules, you must select the video output module | |
| 180 that matches the terminal module you previously selected for your console | |
| 181 device. | |
| 182 </para> | |
| 183 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
184 <command>Config</command> builds a boot list from the selected devices and their associated |
| 152 | 185 drivers and managers. "Bootlist" is created in the ROOT directory of |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
186 Drive 0. <command>Config</command> next displays two clock options: |
| 152 | 187 </para> |
| 153 | 188 <literallayout> |
| 157 | 189 1 - 60Hz (American) |
| 190 2 - 50Hz (European) | |
| 153 | 191 </literallayout> |
| 152 | 192 <para> |
| 193 If you live in the United States, Canada, or other country with 60Hz | |
| 194 electrical power, press [1]. If you live in a country with 50Hz power, | |
| 195 press [2]. | |
| 196 </para> | |
| 197 <para> | |
| 198 If you have a single disk drive, a screen prompt asks you to swap diskettes | |
| 199 and press [C]. When asked to isnert the SOURCE diskette, insert the | |
| 200 CONFIG/BOOT Diskette. When asked to insert the DESTINATION diskette, insert | |
| 201 the diskette on which you wish to create the new OS-9 System. | |
| 202 </para> | |
| 203 <para> | |
| 204 If you have more than one drive, a screen prompt asks you to insert a blank | |
| 205 formatted diskette (the DESTINATION diskette) in /D1. The rest of the boot | |
| 206 file creation is automatic. | |
| 207 </para> | |
| 208 <para> | |
| 209 Following the boot file generation, a menu lets you select the commands you | |
| 210 wish to include on your system diskette. You have the following choices: | |
| 211 </para> | |
| 153 | 212 <screen> |
| 157 | 213 [N]o Commands, Stop Now - Do not add any commands |
| 214 [B]asic Command Set - Adds the basic OS-9 commands | |
| 215 [F]ull COmmand Set - Add all OS-9 commands | |
| 216 [I]ndividually Select - Select desired commands one by one | |
| 217 [?] Receive Help - Get help on the command set | |
| 153 | 218 </screen> |
| 152 | 219 <para> |
| 220 Press [N] if you want to create a boot file, but do not wish to add any | |
| 221 commands to the new system diskette. Use this option to create a new boot | |
| 222 file on a diskette on which you have prefviously copied the OS-9 system. | |
| 223 If you have only one disk drive, this procedure is quicker than using | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
224 the <command>config</command> utility to complete the entire system transfer, as less |
| 152 | 225 diskette swaps are required. |
| 226 </para> | |
| 227 <para> | |
| 228 Press [B] if you wish to add a basic command set (the most commonly used | |
| 229 commands) to your new diskette. This selection does not copy the following: | |
| 230 </para> | |
| 157 | 231 <orderedlist numeration="arabic"> |
| 232 <listitem><para> | |
| 233 Assembly language development tools, asm, debug, and edit and the | |
| 234 DEFS directory | |
| 235 </para></listitem> | |
| 236 <listitem><para> | |
| 237 Timesharing utilities, tsmon, login, and the SYS/motd and | |
| 238 SYS/password files | |
| 239 </para></listitem> | |
| 240 <listitem><para> | |
| 241 The system maintenance utilites, such as dsave, dcheck, and cobbler | |
| 242 </para></listitem> | |
| 243 </orderedlist> | |
| 152 | 244 <para> |
| 245 Press [F] to copy all of the commands (an exact copy of the standard OS-9 | |
| 246 system diskette, with a new boot file). | |
| 247 </para> | |
| 248 <para> | |
| 249 Press [I] to individually select commands to copy on the new diskette. This | |
| 250 option displays a selection similar to the device selection screen. Again, | |
| 251 press [S] to select or exclude commands, and use the arrow keys to move | |
| 252 among the commands in the menu. Commands marked with an X are selected. If | |
| 253 a command does not have an X beside it, it is excluded on the new system | |
| 254 diskette. | |
| 255 </para> | |
| 256 <para> | |
| 257 If you have a multi-drive system, a prompt appears asking you to insert your | |
| 258 OS-9 system diskette in /D0. Press the spacebar. The process finishes the | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
259 <command>config</command> operation and returns to OS-9. |
| 152 | 260 </para> |
| 261 <para> | |
| 262 If you have a single-drive system, you swawp diskettes during the final | |
| 263 process. This time, the SOURCE diskette is the OS-9 System Diskette, | |
| 264 instead of the CONFIG/BOOT Diskette. The DESTINATION diskette is the new | |
| 265 system diskette you are creating. The number of swaps in this procedure, as | |
| 266 well as in the boot file creation procedure, depends on the number of options | |
| 267 you select. | |
| 268 </para> | |
| 269 <para> | |
| 270 It would be quicker and easier to use BACKUP to create a system disk, use | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
271 <command>config</command> to create a new bootfile, then delete unwanted commands. However, |
| 152 | 272 this process causes fragmentation of diskette space. Fragmentation results |
| 273 in slower diskette access, and free memory is broken into segments that | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1011
diff
changeset
|
274 might not be large enough for some OS-9 operations. <command>Config</command> causes no |
| 152 | 275 fragmentation. |
| 276 </para> | |
| 277 <para> | |
| 278 The MODULES directory of the CONFIG/BOOT diskette contains all the device | |
| 279 drivers and descriptors supported by OS-9. The filename extension | |
| 280 describes the type of file, as noted in the following table: | |
| 281 </para> | |
| 157 | 282 <informaltable frame="none"> |
| 283 <tgroup cols="2"> | |
| 648 | 284 <colspec colwidth="1in"/> |
| 285 <colspec colwidth="3in"/> | |
| 157 | 286 <thead> |
| 287 <row> | |
| 288 <entry>Extension</entry> | |
| 289 <entry>Module Type</entry> | |
| 290 </row> | |
| 291 </thead> | |
| 292 <tbody> | |
| 293 <row> | |
| 294 <entry>.dd</entry> | |
| 295 <entry>Device Descriptor module</entry> | |
| 296 </row> | |
| 297 <row> | |
| 298 <entry>.dr</entry> | |
| 299 <entry>Device Driver module</entry> | |
| 300 </row> | |
| 301 <row> | |
| 302 <entry>.io</entry> | |
| 303 <entry>Input/Output subroutine module</entry> | |
| 304 </row> | |
| 305 <row> | |
| 306 <entry>.hp</entry> | |
| 307 <entry>Help file</entry> | |
| 308 </row> | |
| 309 </tbody> | |
| 310 </tgroup> | |
| 311 </informaltable> | |
| 152 | 312 </refsect1> |
| 313 </refentry> |