Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/chap2.chapter @ 1014:d9ed9d44b70c
Some character entities had missing semicolons. It's &CPU;
The os9l1guide and os9l2guide are now much more modular simply because
the sections that are not to be included in one of them is defined as
the empty string in the <!ENTITY declaration
Split exbin and binex pages so the occur at the right place in the manual.
Got the content for wcreate from the Internet.
| author | roug |
|---|---|
| date | Tue, 04 Mar 2003 20:05:50 +0000 |
| parents | cc153d1671f7 |
| children | c9b63a3c0a17 |
| rev | line source |
|---|---|
| 144 | 1 <chapter> |
| 2 <title>Basic Interactive Functions</title> | |
| 3 | |
| 4 <section> | |
| 5 <title>Running Commands and Basic Shell Operation</title> | |
| 6 <para> | |
| 7 The "shell" is a the part of OS-9 that accepts commands from your | |
| 8 keyboard. It was designed to provide a convenient, flexible, and | |
| 9 easy-to-use interface between you and the powerful functions of the | |
| 10 operating system. The shell is automatically entered after OS-9 is | |
| 11 started up. You can tell when the shell is waiting for input | |
| 1011 | 12 because it displays the shell prompt. This prompt indicates that |
| 144 | 13 the shell is active and awaiting a command from your keyboard. It |
| 14 makes no difference whether you use upper-case letters, lower-case | |
| 15 letters, or a combination of both because OS-9 matches letters of | |
| 16 either case. | |
| 17 </para> | |
| 18 <para> | |
| 19 The command line always begins with a name of a program which can | |
| 20 be: | |
| 21 </para> | |
| 22 | |
| 23 <itemizedlist> | |
| 24 <listitem><para>The name of a machine language program on disk</para></listitem> | |
| 25 <listitem><para>The name of a machine language program already in memory</para></listitem> | |
| 26 <listitem><para>The name of an executable program compiled by a high-level | |
| 1011 | 27 language such as Basic09, Pascal, Cobol, etc.</para></listitem> |
| 28 <listitem><para>The name of a procedure file</para></listitem> | |
| 144 | 29 </itemizedlist> |
| 30 <para> | |
| 31 If you're a beginner, you will almost always use the first case, | |
| 32 which causes the program to be automatically loaded from the CMDS | |
| 33 directory and run. | |
| 34 </para> | |
| 35 <para> | |
| 36 When processing the command line, the shell searches for a | |
| 37 program having the name specified in the following sequence: | |
| 38 </para> | |
| 39 | |
| 40 <orderedlist numeration="arabic"> | |
| 41 | |
| 1011 | 42 <listitem><para> If the program named is already in memory, it is run.</para></listitem> |
| 144 | 43 |
| 1011 | 44 <listitem><para> The "execution directory", usually "CMDS", is searched. |
| 144 | 45 If a file having the name given is found, it is loaded and |
| 1011 | 46 run.</para></listitem> |
| 144 | 47 |
| 1011 | 48 <listitem><para> The user's "data directory" is searched. If a file having |
| 144 | 49 the name given is found, it is processed as a "procedure |
| 50 file" which means that the file is assumed to contain one | |
| 51 or more command lines which are processed by the shell in | |
| 52 the same manner as if they had manually typed in one by one.</para></listitem> | |
| 53 | |
| 54 </orderedlist> | |
| 55 <para> | |
| 56 Mention is made above of the "data directory" and the "execution | |
| 57 directory". At all times each user is associated with two file | |
| 58 directories. A more detailed explanation of directories is presented | |
| 1011 | 59 later. The execution directory (usually CMDS) includes |
| 144 | 60 files which are executable programs. |
| 61 </para> | |
| 62 <para> | |
| 63 The name given in the command line may be optionally followed by | |
| 64 one or more "parameters" which are passed to the program called by | |
| 65 the shell. | |
| 66 </para> | |
| 67 <para> | |
| 68 For example, in the command line: | |
| 69 </para> | |
| 70 <screen> | |
| 1011 | 71 list file1 |
| 144 | 72 </screen> |
| 73 <para> | |
| 74 the program name is LIST, and the parameter passed to it is FILE1. | |
| 75 </para> | |
| 76 <para> | |
| 77 A command line may also include one or more "modifiers" which are | |
| 78 specifications used by the shell to alter the program's standard | |
| 1011 | 79 input/output files or memory assignments. |
| 144 | 80 |
| 81 | |
| 82 </para> | |
| 83 <section> | |
| 84 <title>Sending Output to the Printer</title> | |
| 85 <para> | |
|
1014
d9ed9d44b70c
Some character entities had missing semicolons. It's &CPU;
roug
parents:
1011
diff
changeset
|
86 Normally, most commands and programs display output on the &make; video display. The output of these programs can |
| 144 | 87 alternatively be printed by specifying output redirection on the |
| 88 command line. This is done by including the following modifier to | |
| 89 at the end of any command line: | |
| 90 </para> | |
| 91 <screen> | |
| 1011 | 92 >/p |
| 144 | 93 </screen> |
| 94 <para> | |
| 95 The ">" character tells the shell to redirect output (See 4.3.2) to | |
| 1011 | 96 the printer using the &make;'s printer port, which has the device |
| 144 | 97 name "/P" (See 3.2). For example, to redirect the output of the |
| 98 "dir" command to the printer, enter: | |
| 99 </para> | |
| 100 <screen> | |
| 1011 | 101 dir >/p |
| 144 | 102 </screen> |
| 103 <para> | |
| 104 The "xmode" command can be used to set the printer port's | |
| 105 operating mode such as auto line feed, etc. For example, to examine | |
| 106 the printer's current settings, type: | |
| 107 </para> | |
| 108 <screen> | |
| 1011 | 109 xmode /p |
| 144 | 110 </screen> |
| 111 <para> | |
| 112 To change any of these type XMODE followed by the new value. | |
| 113 For example, to set the printer port for automatic line feeds at the | |
| 114 end of every line, enter: | |
| 115 </para> | |
| 116 <screen> | |
| 1011 | 117 xmode /p lf; |
| 144 | 118 </screen> |
| 119 </section> | |
| 120 </section> | |
| 121 | |
| 122 <section> | |
| 123 <title>Shell Command Line Parameters</title> | |
| 124 <para> | |
| 125 Parameters are generally used to either specify file name(s) or | |
| 126 to select options to be used by the program specified in the command | |
| 127 line given to the shell. Parameters are separated from the command | |
| 128 name and from each other by space characters (hence parameters and | |
| 129 options cannot themselves include spaces). Each command program | |
| 130 supplied with OS-9 has an individual description in the last section | |
| 131 of this manual which describe the correct usage of the parameters of | |
| 132 each command. | |
| 133 </para> | |
| 134 <para> | |
| 135 For example, the LIST program is used to display the contents of | |
| 136 a text file on your display. It is necessary to tell to the LIST | |
| 137 program which file it is to be displayed, therefore, the name of the | |
| 138 desired file is given as a parameter in the command line. For | |
| 139 example, to list the file called startup (the system initialization | |
| 140 procedure file), you enter the command line: | |
| 141 </para> | |
| 142 <screen> | |
| 1011 | 143 list startup |
| 144 | 144 </screen> |
| 145 <para> | |
| 146 Some commands have two parameters. For example, the COPY command is | |
| 147 used to make an exact copy of a file. It requires two parameters: | |
| 148 The name of the file to be copied and the name of the file which is | |
| 149 to be the copy, for example: | |
| 150 </para> | |
| 151 <screen> | |
| 1011 | 152 copy startup newstartup |
| 144 | 153 </screen> |
| 154 <para> | |
| 155 Other commands have parameters which select options. For example: | |
| 156 </para> | |
| 157 <screen> | |
| 1011 | 158 dir |
| 144 | 159 </screen> |
| 160 <para> | |
| 161 shows the names of the files in the user's data directory. Normally | |
| 1011 | 162 it simply lists the file names only, but if the "-e" |
| 144 | 163 (for <emphasis>e</emphasis>ntire) |
| 164 option is given, it will also give complete statistics for each file | |
| 165 such as the date and time created, size, security codes, etc. To do | |
| 166 so enter: | |
| 167 </para> | |
| 168 <screen> | |
| 1011 | 169 dir -e |
| 144 | 170 </screen> |
| 171 <para> | |
| 172 The DIR command also can accept a file name as a parameter which | |
| 173 specifies a directory file other than the (default) data directory. | |
| 174 For example, to list file names in the directory sys , type: | |
| 175 </para> | |
| 176 <screen> | |
| 1011 | 177 dir sys |
| 144 | 178 </screen> |
| 179 <para> | |
| 180 It is also possible to specify both a directory name parameter and | |
| 181 the e option, such as: | |
| 182 </para> | |
| 183 <screen> | |
| 1011 | 184 dir sys -e |
| 144 | 185 </screen> |
| 186 <para> | |
| 1011 | 187 giving file names and complete statistics. |
| 144 | 188 </para> |
| 189 </section> | |
| 190 | |
| 191 <section> | |
| 192 <title>Some Common Command Formats</title> | |
| 193 <para> | |
| 194 This section is a summary of some commands commonly used by new | |
| 195 or casual OS-9 users, and some common formats. Each command is | |
| 196 followed by an example. Refer to the individual command | |
| 1011 | 197 descriptions later int his book for more detailed information and |
| 144 | 198 additional examples. Parameters or options shown in brackets are |
| 199 optional. Whenever a command references a directory file name, the | |
| 200 file <emphasis>must</emphasis> be a directory file. | |
| 201 | |
| 202 <screen> | |
| 203 CHD filename chd DATA.DIR | |
| 204 </screen> | |
| 205 Changes the current <emphasis>data</emphasis> working directory to | |
| 206 the <emphasis>directory</emphasis> file specified. | |
| 207 <screen> | |
| 208 COPY filename1 filename2 copy oldfile newfile | |
| 209 </screen> | |
| 210 Creates filename2 as a new file, then copies all data from | |
| 211 "filename1" to it. "filename1" is not affected. | |
| 212 <screen> | |
| 213 DEL filename del oldstuff | |
| 214 </screen> | |
| 215 Deletes (destroys) the file specified. | |
| 216 <screen> | |
| 1011 | 217 DIR [filename] [-e] [-x] dir myfiles -e |
| 144 | 218 </screen> |
| 219 List names of files contained in a directory. If the "x" option is | |
| 220 used the files in the current <emphasis>execution</emphasis> | |
| 221 directory are listed, | |
| 222 othervise, if no directory name is given, the current | |
| 223 <emphasis>data</emphasis> directory will be listed. | |
| 224 The "e" option selects the long format | |
| 225 which shows detailed information about each file. | |
| 226 <screen> | |
| 227 FREE devicename free /d1 | |
| 228 </screen> | |
| 229 Shows how much free space remains on the disk whose name is given. | |
| 230 <screen> | |
| 231 LIST filename list script | |
| 232 </screen> | |
| 233 Displays the (text) contents of the file on the terminal. | |
| 234 <screen> | |
| 235 MAKDIR filename makdir NEWFILES | |
| 236 </screen> | |
| 237 Creates a new directory file using the name given. Often followed | |
| 238 by a "chd" command to make it the new working data directory. | |
| 239 <screen> | |
| 240 RENAME filename1 filename2 rename zip zap | |
| 241 </screen> | |
| 242 Changes the name of filename1 to filename2. | |
| 243 </para> | |
| 244 </section> | |
| 245 | |
| 246 <section> | |
| 247 <title>Using the Keyboard and Video Display</title> | |
| 248 <para> | |
|
148
525b12e17d60
Made the word "Dragon" an entity, thereby making it replacable with "Color"
roug
parents:
144
diff
changeset
|
249 OS-9 has many features to expand the capability of the &make; |
| 144 | 250 keyboard and video display. The video display has screen pause, |
| 251 upper/lower case, and graphics functions. The keyboard can generate | |
| 252 all ASCII characters and has a type-ahead feature that permits you | |
| 253 to enter data before requested by a program (except if the disk is | |
| 254 running because interrupts are temporarily disabled). Appendix C of | |
| 255 this manual is a list of the characters and codes that can be | |
| 256 generated from the keyboard. The keyboard/video display can be used | |
| 257 as a file known by the name "/TERM". | |
| 258 </para> | |
| 259 | |
| 260 <section> | |
| 261 <title>Video Display Functions</title> | |
| 262 <para> | |
| 1011 | 263 The &make; uses reverse video (green letters in a black box) to |
| 144 | 264 represent lower-case letters. Normally they are not used, so you |
| 265 have to turn them on if you want to use them with the command: | |
| 266 </para> | |
| 267 <screen> | |
| 1011 | 268 tmode -upc |
| 144 | 269 </screen> |
| 270 <para> | |
| 271 The screen pause feature stops programs after 16 lines have been | |
| 272 displayed. Output will continue if you hit any key. Normally this | |
| 273 feature is on. It can be turned on or off with the TMODE command as | |
| 274 follows: | |
| 275 </para> | |
| 276 <screen> | |
| 1011 | 277 tmode -pause turns pause mode off |
| 278 tmode pause turns pause mode on | |
| 144 | 279 </screen> |
| 280 <para> | |
| 281 The display system also has a complete set of commands to emulate | |
| 282 commercial data terminals, plus a complete set of graphics commands. | |
| 283 These are described in detail in Appendix D. | |
| 284 </para> | |
| 285 </section> | |
| 286 | |
| 287 <section> | |
| 288 <title>Keyboard Shift and Control Functions</title> | |
| 289 <para> | |
| 290 Two keys are used in combination with other keys to change their | |
| 291 meaning. The SHIFT KEY selects between upper case and lower case | |
|
1014
d9ed9d44b70c
Some character entities had missing semicolons. It's &CPU;
roug
parents:
1011
diff
changeset
|
292 letters or punctuation, and the &ctrlkey; key can be used to generate |
| 1011 | 293 control characters. |
| 144 | 294 </para> |
| 295 <para> | |
| 296 The keyboard has a shift lock function similar to a typewriter's, | |
| 297 which is normally "locked". The keyboard's shift lock may be | |
| 1011 | 298 reversed by depressing the control key and 0 keys |
| 144 | 299 simultaneously. The shift lock only affects the letter (A-Z) keys. |
| 300 When the keyboard is locked, these keys generate upper case letters, | |
| 301 and lower case only if the SHIFT key is depressed. When the | |
| 302 keyboard is unlocked, the reverse is true, e.g., lower case letters | |
| 303 are generated unless the SHIFT key is depressed at the same time as | |
| 304 a letter key. | |
| 305 </para> | |
| 306 </section> | |
| 307 | |
| 308 <section> | |
| 309 <title>Control Key Functions</title> | |
| 310 <para> | |
| 311 There are a number of useful control functions that can be | |
| 312 generated from the keyboard. Many of these functions use "control | |
|
1014
d9ed9d44b70c
Some character entities had missing semicolons. It's &CPU;
roug
parents:
1011
diff
changeset
|
313 keys" which are generated by simultaneously depressing the &ctrlkey; key |
| 144 | 314 plus some other key. For example, to generate the character for |
|
1014
d9ed9d44b70c
Some character entities had missing semicolons. It's &CPU;
roug
parents:
1011
diff
changeset
|
315 CONTROL D press the &ctrlkey; and D keys at the same time. |
| 144 | 316 </para> |
| 317 <variablelist> | |
| 318 <varlistentry> | |
| 319 <term>CONTROL A</term> | |
| 320 <listitem> | |
| 321 <para> | |
| 322 Repeat previous input line. The last line entered will be redisplayed but | |
| 323 <emphasis>not</emphasis> processed, with the cursor positioned at the end of | |
| 324 the line. You may hit return to enter the line, or edit the line by | |
| 325 backspacing, typing over characters to correct them, and entering | |
| 326 control A again to redisplay the edited line. | |
| 327 </para> | |
| 328 </listitem> | |
| 329 </varlistentry> | |
| 330 <varlistentry> | |
| 331 <term>CONTROL D</term> | |
| 332 <listitem> | |
| 333 <para> | |
| 334 Redisplay present input on next line. | |
| 335 </para> | |
| 336 </listitem> | |
| 337 </varlistentry> | |
| 338 <varlistentry> | |
| 339 <term>CONTROL W</term> | |
| 340 <listitem> | |
| 341 <para> | |
| 342 Display Wait - This will temporarily halt output to the display so | |
| 343 the screen can be read before the data scrolls off. Output is | |
| 344 resumed when any other key is hit. | |
| 345 </para> | |
| 346 </listitem> | |
| 347 </varlistentry> | |
| 348 <varlistentry> | |
| 349 <term>CONTROL 0</term> | |
| 350 <listitem> | |
| 351 <para> | |
| 352 Shift lock. Reverses present shift lock state. | |
| 353 </para> | |
| 354 </listitem> | |
| 355 </varlistentry> | |
| 356 <varlistentry> | |
| 357 <term>BREAK KEY (or CONTROL E)</term> | |
| 358 <listitem> | |
| 359 <para> | |
| 360 Program abort - Stops the current running program | |
| 361 </para> | |
| 362 </listitem> | |
| 363 </varlistentry> | |
| 364 <varlistentry> | |
| 365 <term>SHIFT BREAK KEY (or CONTROL C)</term> | |
| 366 <listitem> | |
| 367 <para> | |
| 368 Interrupt - Reactivates Shell while keeping program running as | |
| 369 background task. | |
| 370 </para> | |
| 371 </listitem> | |
| 372 </varlistentry> | |
| 373 <varlistentry> | |
| 374 <term>CONTROL BREAK KEY (ESCAPE)</term> | |
| 375 <listitem> | |
| 376 <para> | |
| 377 End-of-File - This key is used to send an end-of-file to programs | |
| 378 that read input from the terminal in place of a disk or tape file. | |
| 379 It must be the first character on the line in order for it to be | |
| 380 recognized. | |
| 381 </para> | |
| 382 </listitem> | |
| 383 </varlistentry> | |
| 384 <varlistentry> | |
| 385 <term>LEFT ARROW (OR CONTROL H)</term> | |
| 386 <listitem> | |
| 387 <para> | |
| 388 Backspace - erase previous character | |
| 389 </para> | |
| 390 </listitem> | |
| 391 </varlistentry> | |
| 392 <varlistentry> | |
| 393 <term>SHIFT LEFT ARROW (or CONTROL X)</term> | |
| 394 <listitem> | |
| 395 <para> | |
| 396 Line Delete - erases the entire current line. | |
| 397 </para> | |
| 398 </listitem> | |
| 399 </varlistentry> | |
| 400 </variablelist> | |
| 401 </section> | |
| 402 </section> | |
| 403 | |
| 404 </chapter> |