Atari Mini-Speedy 1050 User manual

DISK OPERATING SYSTEM II
REFERENCE MANUAL
JI,-
ATARI®
A Warner Communications Company CI
Every effort has been made to ensure that this manual accurately documents this product of the ATARI Computer Division. However,
because of the ongoing improvement and update of the computer software and hardware, ATARI, INC. cannot guarantee the accuracy
of printed material after the date of publication and cannot accept responsibility for errors or omissions.
Reproduction is forbidden without the specific written permission of ATARI, INC., Sunnyvale, CA 94086. No right to reproduce this docu-
ment, nor the subject matter thereof, is granted unless by written agreement with, or written permission from the Corporation.
PRINTED IN SINGAPORE
MANUAL AND PROGRAM CONTENTS ©1981 ATARI, INC

PREFACE
The ATARI® Disk Operating System II (DOS II) Manual has been structured for
two levels of users. The new user will find DOS II explained in well-defined ter-
minology and sequential operating procedures. However, the new system user
should make the following preparations:
•Read the ATARI 4OO™ or ATARI 800™ Computer Operator's Manual.
•Read the ATARI 81O™ Disk Drive or ATARI 815™ Dual Disk Drive Operating
Manual.
• Acquire some familiarity with an ATARI programming language (preferably
BASIC)
As
the new user becomes familiar with DOS II in Sections 1 through 4, he or she
may then explore Sections 5 and 6, which are designed for the more experienced
user.
The more experienced user is one who has worked with AT ARI DOS I(9/24/79 ver-
sion) or has prior knowledge of the AT ARI Personal Computer System, AT ARI
BASIC, and possibly assembly and other programming languages.
For both levels, explanations are followed by graphics whenever possible. Our in-
tention is to present the material in the clearest, most concise way possible for
users at each level.
Notes and terminology used with DOS II can be found in Appendix B; a glossary
of terms is available in Appendix J; and the use of BASIC commands with DOS II
is
detailed in Section 5.
The experienced user should read Appendix I which explains the major dif-
ferences between DOS I and DOS II, especially noting the addition of the MEM.
SAY function.
Preface v

CONTENTS
PREFACE v
HOW TO USE THIS MANUAL
XI
1
GETTING STARTED WITH DOS \I 1
Setting Up
1
Adding More Disk Drives 2
Setting Drive Codes 2
Labeling Disk Drives 3
Inserting a Diskette
3
What Is a DOS Menu? 4
How Do You Call Up a DOS Menu? 4
DOS II Menu Options
5
2DISKETTES 9
The Master Diskette 9
DOS.SYS File 9
DUP.SYS File 9
AUTORUN.SYS File 9
ATARI810 Formatted Diskettes II 9
How To Format aDiskette 10
Making a System Diskette From Your
Master Diskette 12
Creating a System Diskette With the ATARI
810™ Disk Drive 12
Creating a System Diskette Using an ATARI
815™ Dual Disk Drive 13
Write-Protecting Your Diskettes 14
Labeling Diskettes 15
Single-Density and Double-Density Diskette
Recording 15
Which Diskettes To Use 16
How To Store Diskettes 16
3 USING DOS II 19
Identifying Your Diskette Files 19
Filename Extenders and Their Use 19
Wild Cards
21
Boot Errors 22
Saving, Loading, and Running Programs 23
Contents vii

4SELECTING A DOS
MENU OPTION 27
A. Disk
Directory
27
Parameters for the Disk Directory
Option
28
B. Run Cartridge 29
C.
Copy File 30
D. Delete File 32
E. Rename File 32
F. Lock File 35
G.
Unlock File 35
H. Write DOS File 35
I. Format Diskette
36
J.
Duplicate Disk 37
Duplication Using aSingle Disk Drive
37
Duplication Using Multiple Disk
Drives
38
K.
Binary Save 39
Advanced User I nformation About
Optional Parameters
39
Using Binary Save With Optional
Parameters
40
Structure of a Compound File 41
L. Binary Load
43
M. Run at Address
44
N. Create MEM.SAV
44
Why Have a MEM.SAV File? 45
Using MEM.SAV to Write Assembly
Language Programs
45
Using MEM.SAV to Load Binary
Files 46
O. Duplicate File 47
viii Contents
5 MORE USER INFORMATION
BASIC Commands Used With DOS
Tokenized and Untokenized Files
LOAD
SAVE
LIST
ENTER
RUN
I nput/Output Control Blocks
10CB's With Input/Output Commands
. Using OPE N/CLOSE Commands
Using INPUT/PRINT Commands
49
49
49
49
50
50
50
51
51
51
51
53

Direct Accessing With the NOTE/POINT
Commands
54
Using the PUT/GET Commands
57
Using the STATUS Command
58
Substituting the XIO Command for DOS
Menu Options
60
Saving and Loading Programs and Data
With ATARI BASIC 62
LIST and ENTER 63
OPEN and CLOSE 66
Accessing Damaged Files 67
The AUTORUN.SYS File 67
6
ADDITIONAL INFORMATION
ABOUT THE DISK DRIVE SYSTEM 69
AT ARI Diskettes 69
ATARI Disk Drive
69
ATARI 815 Disk Drive 69
Disk Drive Operation
70
APPENDICES
71
A
Alphabetic Directory of Basic Words Used
With Disk Operations 71
BNotes and Terminology Used With DOS II 73
CBasic Error Messages and
How To Recover 75
DDOS II
Memory Map
81
For 32K Ram System
EHexadecimal-to-Decimal Conversion Table 83
F How To Speed Up Data Transfers to Disk
Drive
85
C How To Increase User RAM Space 87
H Major Differences Between DOS I (9/24/79)
and DOS II 89
Structure of aCompound File 91
C lossary of Terms 93
INDEX 99
ILLUSTRATIONS
1-1
Disk Drive Configurations Available 1
1-2 Drive Code Settings 2
1-3 Inserting aDiskette
Into a Disk Drive 3
1-4 The DOS II
Menu
4
Contents ix

2-1 AFormatted Diskette 10
2-2 Write-Protecting aDiskette 15
2-3 Correct Diskettes for Your Disk Drive 16
3-1 Structure of a Filespec 20
3-2 Examples of Legal and Illegal Filenames 20
3-3
DOS Menu Options That Can and Cannot Use
Use
Wild Cards
21
3-4 Boot Errors 22
3-5 Sample Interest Program 24
4-1
Using the Disk Directory Option
29
4-2
Using the Copy File Option
32
4-3
Using the Delete File Option
33
4-4 Using the Rename File Option
34
4-5
Using the Lock File Option
35
4-6 Using the Unlock File Option
35
4-7
Using the Write DOS File Option
36
4-8
Using the Format Disk Option
36
4-9
Using the Duplicate Disk Option With
Single Disk Drive 38
4-10
Using the Duplicate Disk Option With
Dual or Multiple Disk Drives 38
4-11
The Most Elementary Use of Binary Save 39
4-12
Six-Byte Header Table for Binary Save 39
4-13
Using Binary Save With Optional Parameters 40
4-14
Using Binary Save to Save Compound Files
41
4-15
Converting an Existing Load-Only File to a
Load-and-Go File 43
4-16
Using the Binary Load Option
43
4-17
Using the Run at Address Option
44
4-18
Creating a MEM.SAV File 44
4-19
Example of MEM.SAV Usage 45
4-20
Using the Duplicate File Option
48
5-1
Example of Program Chaining
50
5-2
Explanation of OPE N Statement Parameters
52
5-3
Example of Opening and Closing a File
52
5-4
Sample INPUT/PRINT Program
53
5-5
Sample NOTE Program
54
5-6
Sample Run of NOTE Program
55
5-7
Sample POINT Program
56
5-8
Sample Run of POINT Program
57
5-9
Sample PUT Program
57
5-10
Sample GET Program
58
5-11
Sample Run of PUT/GET Program
58
5-12
Sample STATUS Program
60
x Contents