|
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>
|
|
|
9 <command>CONFIG</command>
|
|
|
10 </cmdsynopsis>
|
|
|
11 </refsynopsisdiv>
|
|
|
12
|
|
|
13 <refsect1><title>Description</title>
|
|
|
14
|
|
|
15 <para>
|
|
|
16 CONFIG provides menus of all I/O options and all system commands. You select
|
|
|
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>
|
|
|
23 The CONFIG utility is on a separate CONFIG/BOOT Diskette. Make a copy of this
|
|
|
24 diskette using the OS-9 BACKUP command and use the copy as your working
|
|
|
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>
|
|
|
30 CONFIG requires no initial parameters. You establish parameters during the
|
|
|
31 operation of CONFIG. Be sure that the execution directory is at /D0/CMDS
|
|
|
32 before executing the command.
|
|
|
33 </para>
|
|
|
34 <para>
|
|
|
35 Examples:
|
|
|
36 </para>
|
|
|
37 <screen>
|
|
|
38 CONFIG [ENTER]
|
|
|
39 </screen>
|
|
|
40 <para>
|
|
|
41 CONFIG executes and a prompt asks you to indicate whether you wish to use
|
|
|
42 one or two disk drives. Press [1] for single- or [2] for two-drive
|
|
|
43 operation.
|
|
|
44 </para>
|
|
|
45 <para>
|
|
|
46 Next, CONFIG builds a list of the various devices from the MODULES directory.
|
|
|
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">
|
|
|
65 <colspec colwidth="1in">
|
|
|
66 <colspec colwidth="4in">
|
|
|
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
|
|
153
|
154 select among the &make; Computer 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">
|
|
|
160 <colspec colwidth="1in">
|
|
|
161 <colspec colwidth="4in">
|
|
|
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>
|
|
|
184 CONFIG builds a boot list from the selected devices and their associated
|
|
|
185 drivers and managers. "Bootlist" is created in the ROOT directory of
|
|
|
186 Drive 0. CONFIG next displays two clock options:
|
|
|
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
|
|
|
224 the CONFIG utility to complete the entire system transfer, as less
|
|
|
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
|
|
|
259 CONFIG operation and returns to OS-9.
|
|
|
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
|
|
|
271 CONFIG to create a new bootfile, then delete unwanted commands. However,
|
|
|
272 this process causes fragmentation of diskette space. Fragmentation results
|
|
|
273 in slower diskette access, and free memory is broken into segments that
|
|
|
274 might not be large enough for some OS-9 operations. CONFIG causes no
|
|
|
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">
|
|
|
284 <colspec colwidth="1in">
|
|
|
285 <colspec colwidth="3in">
|
|
|
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>
|
