Description

# HG changeset patch # User boisy # Date 1026067468 0 # Node ID 6c48191bd06a81434ae966ed5cd217deb73aabf2 # Parent 845e890728df682e55e94400c87f62a9eb77da48 Refentries for CoCo OS-9 commands diff -r 845e890728df -r 6c48191bd06a docs/nitros9guide/config.refentry --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/nitros9guide/config.refentry Sun Jul 07 18:44:28 2002 +0000 @@ -0,0 +1,213 @@ + + +CONFIG +Configures an OS-9 system diskette + + + + +CONFIG + + + +Description + + +CONFIG provides menus of all I/O options and all system commands. You select +the device drivers and commands you want to include on a new system diskette +from these menus. Selecting only the device drivers and commands you and +your system require lets you make the most efficient use of computer +memory and system diskette storage. + + +The CONFIG utility is on a separate CONFIG/BOOT Diskette. Make a copy of this +diskette using the OS-9 BACKUP command and use the copy as your working +diskette. Keep the original CONFIG/BOOT Diskette in a safe place to use +for future backups. You can use the CONFIG/BOOT Diskette for booting OS-9 +from Color Disk BASIC from Drive /D0. + + +CONFIG requires no initial parameters. You establish parameters during the +operation of CONFIG. Be sure that the execution directory is at /D0/CMDS +before executing the command. + + +Examples: + + + CONFIG [ENTER] + + +CONFIG executes and a prompt asks you to indicate whether you wish to use +one or two disk drives. Press [1] for single- or [2] for two-drive +operation. + + +Next, CONFIG builds a list of the various devices from the MODULES directory. +When the list is complete, a screen menu appears. Use the up and down arrow +keys to move to a device. Then, press [S] to either select or exclude a +particular device. Press [S] once to display an X to the right of the +selected device. Press [S] again to erase the X. The device is selected +only when the "X" appears. Information about each device is available with +a special help command. To display the information on the current device +(the device indicated by the right arrow [->]), press [H]. + + +If there are more than ten devices in a CONFIG menu, use [->] to move ahead +page-by-page and [<-] to move back. + + +The devices you can select are: + + + term32 The computer keyboard and standard TV display + term80 The computer keyboard and optional 80 column video display + d0 Disk Drive 0 + d1 Disk Drive 1 + d2 Disk Drive 2 + d3 Disk Drive 3 + h0_15 A 15 meg hard disk drive 0 + h1_15 A 15 meg hard disk drive 1 + h0_35 A 35 meg hard disk drive 0 + h1_35 A 35 meg hard disk drive 1 + p A printer using the RS-232 serial port + t1 A terminal port using the standard RS-232 port + t2 A terminal port using the optional RS-232 communications pak + t3 A terminal port using the optional RS-232 communications pak + m1 A modem + m2 A modem + ssc Speech/Sound Cartridge + + +To use your computer keyboard and video display, you must select one term. +You must select d0 as your first disk drive. Select d1, d2, and d3 for +additional floppy disk drives. Select /p to use a printer with OS-9, +select ssc to use a Speech/Sound Cartridge from a Multi-Pak slot, and +so forth. + + +After selecting the devices you desire, press [D]. The screen displays, +ARE YOU SURE (Y/N) ? If you are satisfied with your selections, press [Y]. +If you wish to make further changes, press [N]. + + +When the driver selection is complete, a screen prompt requests that you +select among the Color Computer terminal I/O subroutines. Select these +subroutines in the same manner that you selected the device drivers. +You have the following modules from which to make your selections: + + + CO32 A video output module for a 32 column TV display + CO80 A video output module for a 80 column video display + GRFO A graphics module for TV display + + +When choosing subroutine modules, you must select the video output module +that matches the terminal module you previously selected for your console +device. + + +CONFIG builds a boot list from the selected devices and their associated +drivers and managers. "Bootlist" is created in the ROOT directory of +Drive 0. CONFIG next displays two clock options: + + + 1 - 60Hz (American) + 2 - 50Hz (European) + + +If you live in the United States, Canada, or other country with 60Hz +electrical power, press [1]. If you live in a country with 50Hz power, +press [2]. + + +If you have a single disk drive, a screen prompt asks you to swap diskettes +and press [C]. When asked to isnert the SOURCE diskette, insert the +CONFIG/BOOT Diskette. When asked to insert the DESTINATION diskette, insert +the diskette on which you wish to create the new OS-9 System. + + +If you have more than one drive, a screen prompt asks you to insert a blank +formatted diskette (the DESTINATION diskette) in /D1. The rest of the boot +file creation is automatic. + + +Following the boot file generation, a menu lets you select the commands you +wish to include on your system diskette. You have the following choices: + + + [N]o Commands, Stop Now - Do not add any commands + [B]asic Command Set - Adds the basic OS-9 commands + [F]ull COmmand Set - Add all OS-9 commands + [I]ndividually Select - Select desired commands one by one + [?] Receive Help - Get help on the command set + + +Press [N] if you want to create a boot file, but do not wish to add any +commands to the new system diskette. Use this option to create a new boot +file on a diskette on which you have prefviously copied the OS-9 system. +If you have only one disk drive, this procedure is quicker than using +the CONFIG utility to complete the entire system transfer, as less +diskette swaps are required. + + +Press [B] if you wish to add a basic command set (the most commonly used +commands) to your new diskette. This selection does not copy the following: + + + 1. Assembly language development tools, asm, debug, and edit and the + DEFS directory + + 2. Timesharing utilities, tsmon, login, and the SYS/motd and + SYS/password files + + 3. The system maintenance utilites, such as dsave, dcheck, and cobbler + + +Press [F] to copy all of the commands (an exact copy of the standard OS-9 +system diskette, with a new boot file). + + +Press [I] to individually select commands to copy on the new diskette. This +option displays a selection similar to the device selection screen. Again, +press [S] to select or exclude commands, and use the arrow keys to move +among the commands in the menu. Commands marked with an X are selected. If +a command does not have an X beside it, it is excluded on the new system +diskette. + + +If you have a multi-drive system, a prompt appears asking you to insert your +OS-9 system diskette in /D0. Press the spacebar. The process finishes the +CONFIG operation and returns to OS-9. + + +If you have a single-drive system, you swawp diskettes during the final +process. This time, the SOURCE diskette is the OS-9 System Diskette, +instead of the CONFIG/BOOT Diskette. The DESTINATION diskette is the new +system diskette you are creating. The number of swaps in this procedure, as +well as in the boot file creation procedure, depends on the number of options +you select. + + +It would be quicker and easier to use BACKUP to create a system disk, use +CONFIG to create a new bootfile, then delete unwanted commands. However, +this process causes fragmentation of diskette space. Fragmentation results +in slower diskette access, and free memory is broken into segments that +might not be large enough for some OS-9 operations. CONFIG causes no +fragmentation. + + +The MODULES directory of the CONFIG/BOOT diskette contains all the device +drivers and descriptors supported by OS-9. The filename extension +describes the type of file, as noted in the following table: + + + Extension Module Type + .dd Device Descriptor module + .dr Device Driver module + .io Input/Output subroutine module + .hp Help file + + + + diff -r 845e890728df -r 6c48191bd06a docs/nitros9guide/help.refentry --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/nitros9guide/help.refentry Sun Jul 07 18:44:28 2002 +0000 @@ -0,0 +1,99 @@ + + +HELP +Displays the usage and syntax of OS-9 commands. + + + + +TUNEPORT + + + + + + +Notes + + +To use HELP, first copy Cmds.hp from the SYS directory of the CONFIG/BOOT +Diskette to the SYS directory of your system diskette. Next, copy HELP +from the CMDS directory of the CONFIG/BOOT Diskette to the CMDS directory +of your system diskette as follows: + + +Procedure for one disk drive: + + +1. With OS-9 booted and the system diskette in your drive, type: + + + LOAD COPY [ENTER] + + +2. Replace the system diskete with the CONFIG/BOOT Diskette and type: + + + COPY /D0/SYS/CMDS.HP /D0/SYS/CMDS.HP -S #30K [ENTER] + + +3. Exchange the two diskettes as requested by the screen prompts until the +process is complete. + + +4. Again, place the CONFIG/BOOT DIskette int he drive, and type: + + + COPY /D0/CMDS/help /D0/CMDS/help -S #30K [ENTER] + + +5. Swap diskettes as requested until the process is complete. + + +Procedure for two disk drives + + +1. With OS-9 booted, place the CONFIG/BOOT Diskette in Drive 1. Be sure +the system diskette is in Drive 0. + + +2. Type: + + + COPY /D1/SYS/CMDS.HP /D0/SYS/CMDS.HP [ENTER] + + +3. When the first copy is complete, type: + + + COPY /D1/CMDS/help /D0/CMDS/help [ENTER] + + +Cmds.hp is a data file, not a text file, and you cannot successfully display +it on your screen or edit it with a standard text editor. It contains help +for standard OS-9 commands. + + +HELP displays the form and syntax of the specified command. If you use a +non-standard command name, a screen display tells you that help is not +available for that command. + + +Examples: + + + HELP BACKUP [ENTER] + BACUKP [e][s][-v][dev][dev] + Copies all data from one device to another + + HELP ME [ENTER] + ME Help not available + + HELP [ENTER] + HELP [command name][...] + + + diff -r 845e890728df -r 6c48191bd06a docs/nitros9guide/iniz.refentry --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/nitros9guide/iniz.refentry Sun Jul 07 18:44:28 2002 +0000 @@ -0,0 +1,51 @@ + + +INIZ +Initialize a device. + + + + +INIZ + + + + + + +Description + + +Links the specified device to OS-9, places the device addres in a new device +table entry, allocates the memory needed by the device driver, and calls +the device driver initialization routine. If the device is already +installed, INIZ does not reinitialize it. + + +Options: + + + devicename is the name of the device drivere you want to + initialize. Specify as many device drivers as you + wish with one INIZ command. + + +Notes: + + +You can use Iniz in the startup file or at the system startup to initialize +devices and allocate their static storage at the top of memory (to reduce +memory fragmentation). + + +Example: + + + INIZ P T2 [ENTER] + + +initializes the P (printer) and T2 (terminal 2) devices. + + + + diff -r 845e890728df -r 6c48191bd06a docs/nitros9guide/tuneport.refentry --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/nitros9guide/tuneport.refentry Sun Jul 07 18:44:28 2002 +0000 @@ -0,0 +1,52 @@ + + +TUNEPORT +Tune the printer port on the Color Computer + + + + +TUNEPORT + + + + + + +Description + + +This command lets you test and set delay loop values for the current baud +rate and select the best value for your printer (/P) or terminal (/T1). + + +Examples + + + TUNEPORT /P [ENTER] + + +Provides a text operation for your printer. After a short delay, TUNEPORT +displays the current baud rate and sends data to the printer to test if it +is working properly. The program then displays the current delay value and +asks for a new value. Enter a decimal delay value and press [ENTER]. Again, +test data is sent to the printer as a test. Continue this process until you +find the best value. When you are satisfied, press [ENTER] instead of +entering a value at the prompt. A closing message displays your new value. + + +Use the same process to set a new delay loop value for /T1 terminal + + + TUNEPORT /P -s=225 [ENTER] + + +Sets the delay loop value for your printer at 225. Use such a command on +future system boots to set the optimum delay value determined with the +TUNEPORT test function. Then, using OS9GEN or COBBLER, generate a new +boot file for your system diskette. You can also use TUNEPORT in your +system startup file to set the value using the -S option. + + + +