Useful System Information

and Functions


The OS-9 system must load many parts of the operating system

during startup and system operation. Therefore, on a floppy disk

system, you must keep the system diskette in Drive /D0.


Two files used during the system startup operation, OS9Boot

and Startup, must remain in the system diskette's ROOT direc

tory. Other files on the system diskette are organized into two

directories: CMDS (commands) and SYS (other system files). You

can also create other files and directories on the system diskette.

OS-9 always creates the initial data directory, or ROOT direc

tory, when you format a diskette.


File Managers, Device Drivers, and
Descriptors

The bootstrap (instructions that initialize OS-9) loads a file

called OS9Boot into RAM memory at startup. This file contains

file managers, device drivers and descriptors, and any other mod

ules that permanently reside in memory. For instance, the

OS9Boot file might contain these modules:





















OS-9 Commands Reference






OS-9 stores the modules loaded during the system startup with

a minimum of fragmentation. To include additional modules, cre

ate new bootstrap files using the OS9GEN command or the

CONFIG program supplied with OS-9. You cannot unlink a mod

ule loaded as part of the bootstrap.


After booting, when the system switches the boot block into its

own address space, any non-system files included in the boot

strap decrease the memory available in the system mode. It is

best to place optional modules in a separate file and load them

as part of the system startup procedure. One example is the

shell. Never include the shell as part of a system boot file in

OS-9 Level Two systems.


The Sys Directory

The OS-9 SYS directory contains a number of important files:






These files, and the SYS directory itself, are not required to boot

OS-9, but you do need them if you plan to use the ERROR com

mand, or if you intend to use text, or mouse pointers on graphic

windows. You can also add other system-wide files of a similar

nature.


5-2


The Startup File

The Startup file (/DO/startup) is a shell procedure file that OS-9

automatically processes as part of the system boot. You can

include any legal shell command line in the Startup file. Many

people include SETIME to start the system clock. If this file is

not present, the system starts correctly, but the system time is

not accurate.


The CMDS Directory

The directory /DO/CMDS is the system-wide command directory

normally shared by all users as their working execution direc

tory. The shell resides in the CMDS directory. The system start

up process CC3go makes CMDS the initial execution directory.

You can add your own programs to the CMDS directory and have

them execute in the same manner as the original system

commands.


Making New System Diskettes

Getting Started With OS-9 told you how to create new system

diskettes using the CONFIG utility. There are other ways to cre

ate system diskettes and either add or subtract capabilities. The

following information provides guidelines on how to do this. For

more detailed instructions see the descriptions of the CONFIG,

OS9GEN, and COBBLER commands in this manual.


Before starting any of the following procedures, you need a

blank, formatted diskette on which to place your system files.

Then, choose one of the following methods to update your

system:




5-3
OS-9 Commands Reference

If you choose to use CONFIG, the utility creates a complete sys

tem during the process. If you use OS9GEN, follow these steps:





You can perform these steps manually or do them automatically

by using one of these methods:




Technical Information for the RS-232 Port

You can operate the RS-232 port or the printer at all standard

baud rates from 110 baud to 19200 baud. (The default rate is

600 baud.) The default format used is 8 data bits, no parity, and

1 stop bit.


Use the XMODE command to set the port's baud rate, parity,

word length, stop bits, end-of-line delay, auto line feed, and so

forth. To examine the printer's current settings, type:




Then, if you want to make changes, use XMODE with informa

tion from the following chart. Select the parameter you want

from the left column of each chart, and then select the corre

sponding number from the "Value to Use" column and write it

down. After you select the proper value from each chart, add

them together to obtain a final value for XMODE. All values

must be hexadecimal.


5-4


Stop Bits Word Length Baud Rate

Bits Per Value
Second to Use
110 BPS 0
300 BPS 1
600 BPS 2
1200 BPS 3
2400 BPS 4
4800 BPS 5
9600 BPS 6
19200 BPS 7

Word Value
Length to Use
7 Bits 20
8 Bits 0

Number of Value
Stop Bits to Use
1 Stop Bit 0
2 Stop Bits 80

For instance, to set the printer parameters to one stop bit, a

word length of seven bits, and a baud rate of 600, select 0 from

the Stop Bits chart, 20 from the Word Length chart, and 2 from

the Baud Rate chart. Add the values together:




The command to set the printer port for this configuration is:



When you use XMODE to set baud, parity, and stop bit values,

you are actually setting the bits of a special byte to certain val

ues. OS-9 uses these values to determine how to handle subse

quent input/output operations. A bit is a binary digit and can be

either 1 or 0. A byte consists of eight bits and can represent a

value between 0 and 255.


The following chart shows the bits that control baud rate, word

length, and stop bits for input/output operations on a specified

device.


5-5
OS-9 Commands Reference



Baud rate
Reserved
Word length
Stop bits



















Use X M o D E TYPE = va 1 u e to set parity, MDM (modem) kill, and
the not ready delay. Value is a hexadecimal value you calculate
from the following chart:



Not Ready Value
Delay to Use
0 seconds 0
1 second 1
2 seconds 2
3 seconds 3




15 seconds F

Kill Value
Switch to Use
On 10
Off 0

Type of Value
Parity to Use
None 0
Mark AO
Space EO
Even 60
Odd 20

5-6
Useful System Information and Funetions / 5

Select a value from each chart, and add them together to get a
final TYPE value. For instance, to select even parity, MDM kill
off, and a not ready delay of 10 seconds, select these values and
add them:

60 + 0 + A = 6A

To set the new values, type:

xmode /P type=6a ENTER

The following chart shows the bits that control parity, the
modem kill switch, and the not ready delay.

Bit 7 6 5 4 3 2 1 0

Not ready delay
(printer only)

> MDM kill switch (ACIAPAK/
MODPAK devices)

Parity

If the parity value is 000, then parity = none
If the parity value is 101, then parity = MARK, no check
If the parity value is 111, then parity = SPACE, no check





For more information on setting other parameters, such as the

end-of-line delay (null count), see the XMODE command refer

ence in Chapter 6.


5-7