OS-9

Commands

Reference

J,.

OS-9© Level Two Operating System

©1983, 1986 Microware Systems Corporation.

Licensed to Tandy Corporation.

All Rights Reserved.

OS-9 Commands:

©1986 Tandy Corporation

and Microware Systems Corporation.

All Rights Reserved.

Reproduction or use, without express written permission

from Tandy Corporation or Microware Systems

Corporation, of any portion of this manual is prohibited.

While reasonable efforts have been taken in preparation of

this manual to assure its accuracy, neither Tandy

Corporation nor Microware Systems Corporation assumes

any liability resulting from any errors in or omissions

from this manual, or from the use of the information

contained herein.

Contents

Chapter 1 Introduction . . . . . . . . . . . . . . .
The Kernel . . . . . . . . .
The Input/Output Manager
Device Drivers . . . . . . . . . . . . . . . . . . .

Device Descriptors
The Shell . . . . . . . . . .
Going On . . . . . . . . . . . . .

.1-2
.1-2
.1-3
.1-3

Chapter 2 The OS-9 File System . . . . . . . . . . . . . . . . . . . .
Input/Output Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Disk Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Subdirectories . . . . . . . . . . . . . .
Disk Files . . . . . . . . . . . . . . . . . . . .
Sectors ....................

Text Files . . . . . .
Random-Access Data Files
Procedure Files . . . . . . . .

Executable Program Module Files . . . . . . .
Miscellaneous File Use .
The File Security System

. 2-1
. . 2-1
. . 2-2
. . 2-3

. 2-5
. . 2-6
. . 2-6

. . 2-8
. . 2-8

. 2-11
. 2-12

Examining and Changing File Attributes
Record Lockout .............................
Device Names . .

Chapter 3 Advanced Features of the Shell
More About Command Line Processing . . . . . . .
Command Modifiers . . . . . . . . . . . . . . : . . . . . . . . . . . . . . . .
Execution Modifiers
Alternate Memory Size Modifier
I/O Redirection Modifiers
Command Separators . .
Sequential Execution Using the

Semicolon .....................

Concurrent Execution Using the

Ampersand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6

Combining Sequential and Concurrent

Executions 3-7

Using Pipes: the Exclamation Mark . . . . . . . . . . . . . 3-7
Raw Disk Input/Output . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Command Grouping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9

. . 3-3

. . 3-4
. . 3-5
Shell Procedure Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-10

Built-in Shell Commands and Options . . . . . . . . . . . . . . .3-11

Running Compiled Intermediate Code Programs . . . . . .3-12

Chapter 4 Multiprogramming and Memory

Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Processor Time Allocation and Timeslicing . . . . . . . . . . . . 4-1

Process States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

Creation of Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Basic Memory Management Functions . . . . . . . . . . . . . . . . 4-5

Loading Program Modules Into Memory . . . . . . . . . . . . 4-6

Deleting Modules From Memory . . . . . . . . . . . . . . . . . . . 4-7

Loading Multiple Programs . . . . . . . . . . . . . . . . . . . . . . . 4-8

Chapter 5 Useful System Information

and Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

File Managers, Device Drivers, and Descriptors . . . . . . . 5-1
The Sys Directory . . . . . . . . . . . . . . . . .
The Startup File . . . . . . . . . . . . . . . . . . . .

The CMDS Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Making New System Diskettes . . . . . . . . . . . . . . . . . . .
Technical Information for the RS-232 Port . . . . . . . .

Chapter 6 System Command Descriptions . . . . . . . . . . .

Organization of Entries . . . . .

Command Syntax Notation

Command Summary . . . . . . . . .

Chapter 7 Macro Text Editor . . . . . . . . . . . . . . . . . . . . . .

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Text Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . .

Edit Pointers

Entering Commands
Control Keys . . . . . . . . . .
Command Parameters
Numeric Parameters

String Parameters . .

. . 5-3
. . 5-3
. . 5-4

Syntax Notation . . .
Getting Started . . . . . . . . . . . . . . . . . .
Edit Commands . . . . . . . . . . . . . . . . . .
Displaying Text . . . . . . . . . . .
Manipulating the Edit Pointer . . .
Inserting and Deleting Lines

. 6-1
. 6-1

. . 7-10
Searching and Substituting . .
Miscellaneous Commands . . . .
Manipulating Multiple Buffers
Text File Operations . . . . . . . . .

Conditionals and Command Series Repetition . . . .
Edit Macros ...................

Macro Headers .
Using Macros .............
Macro Commands
Sample Session 1 . . . . . . . . . . . . . .

Sample Session 2 . . . . . .

Sample Session 3 . . . . . .
Sample Session 4 . . . . . . . . . . . . . .
Sample Session 5 . . . . . .
Edit Quick Reference Summary
Edit Commands . . . . .
Pseudo Macros ......
Editor Error Messages . .

. . . 7-14

. . 7-17

. . 7-18

. . 7-21

. . . 7-25

. . . 7-26

. . . 7-28

. . . 7-32

. . 7-38

. . . 7-40

. . . 7-45

. . 7-49

. . . 7-55

. . 7-55

Appendices

A OS-9 Error Codes

Device Driver Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5

B Color Computer 2 Compatibility
Alpha Mode Display . . . . . . . . . . . .

B-1
B-2

Using Alpha Mode Controls with Windows . . . . . . . . . B-2
Alpha Mode Command Codes . . . . . . . . . . . . . . . . . . . . . B-3
Graphics Mode Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-5
Graphics Mode Selection Codes . . . . . . . . . . . . . . . . . . . B-5
Graphics Mode Control Commands . . . . . . . . . . . . . . . . B-6
Display Control Codes Summary . . . . . . . . . . . . . . . . . . . . B-8

C OS-9 Keyboard Codes

D Keyboard Control Functions

. C-1

. D-1