Intel 9800758-02 PREFACE

PREFACE

This manual describes and explains the features and conventions

of

Intel Disk Ex-

tended BASIC-80, as implemented on Intel Intellec

microcomp~ter

development

systems using the Intel Systems Implementation Supervisor (ISIS-II), and on Intel

Single Board Computer Systems using the Intel Real-Time Multitasking Executive

(RMX-80).

This manual

is

written for users who require concise, complete information about

Intel BASIC-80 characteristics, and organizes this information into seven chapters

and five appendices;

"Introduction" describes the general capabilities of BASIC-80, and its operating en-

vironment.

"Language Elements" describes the ways BASIC-80 represents its instructions, con-

stants, variables, arrays, operators, and expressions.

"Entering and Editing Programs" shows how you enter text and edit it, at time

of

entry or after storage.

"Error

Handling" shows how errors are identified, trapped, and used to initiate

error-resolving routines.

"Disk File

Input/Output"

describes and sh0ws how random and sequential data

files

are created and used.

"Commands and Statements" describes each command and

statem~nt

in alphabetic

order.

"Functions" describes each function in alphabetic order.

"Appendix

A:

BASIC-80 Error Codes" lists all BASIC-80 error messages, descrip-

tions, and codes in tabular format.

"Appendix

B:

BASIC-80 Reserved Words" lists words that cannot be used in

variable names.

"Appendix C: BASIC-80 Command Characters" lists BASIC-80 one-character

editing and control characters and their meanings.

"Appendix D: ASCII Codes" lists ASCII codes and their meanings.

"Appendix E: Calling Non-BASIC-80 Subroutines" shows how to prepare and call

PL/M-80, FORTRAN-80, and 8080/S085 assembly language subroutines.

"Appendix F: Configuring RMX-80 BASIC-80" shows how to configure BASIC-80

with various hardware systems using

RMX-SO.

Other Relevant Intel Publications:

The following manuals are required to use BASIC-80 with ISIS-Il

or

RMX-80:

• ISIS-II User's Guide, 9800306, which describes how to operate

the

Intel

Systems Implementation Supervisor" operating system (ISIS-II).

iii

Contents

Main BASIC-SO REFERENCE MANUAL r I ii PREFACE Page CHAPTER! CHAPTER AND APPENDIX CONTENTS 4 RMX/80 HANDLING 5 ILLUSTRATIONS TABLES CHAPTER 1 INTRODUCTION TO BASIC-80 Operating System Interface Invoking BASIC-80 Examples Manipulating Files from BASIC-SO Listing the Directory of "filename", to a Disk 4"4;0"1" CHAPTER 2 LANGUAGE ELEMENTS Instructions Commands Statements Language Elements BASIC-80 Table 2-1. BASIC-80 Commands 2-2 (Cont'd.) Table 2-2. BASIC-80 Statements BASIC-SO Table 2-2. BASIC-80 Statements Language Elements = (Cont'd.) Table 2-3. BASIC-80 Functions Table 2-3. BASIC-80 Functions (Cont'd.) Returns Example Functions Representing Data Syntax Numeric Data Constants o. Integer Constants Decimal Integer Constants Hexadecimal Integer Constants Octal Integer Constants Variables AI String Data String Constants String Variables Converting Data l4! (l4) Array Variables Y(I,1) String Arrays 8. If of Order Operators and Precedence of Evaluation Arithmetic Operators Relational Operators Logical Operators String Operator Expressions Numeric Expressions String Expressions CHAPTER 3 ENTERING AND EDITING PROGRAMS Entering Instruction Lines Correcting Entry Errors Editing Program Text D Subcommand [integer] D L Subcommand I Subcommand H Subcommand X Subcommand S Subcommand K Subcommand C Subcommand Q Subcommand Carriage A Subcommand 40. CHAPTER 4 ERROR HANDLING + = Error Error Trapping ? ? 3 -3 Trace Facility Error Simulation B = A Restarting Program Execution CHAPTER 5 DISK FILE INPUT/OUTPUT Sequential File 1/0 Opening a Sequential File Writing to a Sequential File Reading from a Sequential File Closing a Sequential File Random File I/O Defining a Random 110 Buffers FILE "rMBER 3 Opening and Closing a Random Disk File Reading from a Random File ="; 1/0 Writing to a Random File = ATTRIB CHAPTER 6 COMMANDS J[, ":Fdrive AND STATEMENTS "W1" CLOSE [,[1] CONT DATA I I DEF FN(X) DEFSNG DEFDBL DEFSTR DEFINT DEFUSRn =" "; = DIM DIR O. will + ";8;" EXIT FIELD 110 number of characters AS string variable [,number of characters AS string variable] ... FOR-NEXT-STEP GET [I] file number [,record number] GOSUB line number IF-THEN-ELSE ? INPUT Ok KILL LET LINE INPUT LIST LOAD LSET, RSET = 10 CO MERGE NEW NEXT NULL ERROR ON GOTO ON ... GOSUB ON ... "#" GOTO OPEN OPTION BASE OUT POKE PRINT [II "!"; I;] ... PRINT USING Numeric fields tttt PRUN PUT RANDOMIZE >= READ REM B+C)/3 RENAME RENUM A RESUME RETURN A=11 220 RUN numberlstring RUN IN BREAK TRON, STOP SWAP TROFF WAIT WIDTH ABS CHAPTER 7 FUNCTIONS ?5 Ase ATN ?5 COBl 10 CHR$ A#=1/3 CINT cos 10 1 2 3 AO/o .1666667 ERL 1/0 ERR X/Y <> EXP ? Ok FRE HEXS INP "1", = INPUTS INT ? ? LEFT$ = LEN LOC LOF LOG MID$ [,J]) = MKI$ MKS$ MKD$ OCT$ PEEK P~S RIGHTS = RND o SIN ?8 SPACES NOTE saR STRINGS OK STR$ = TAB 1 TAN 4 USRn VAL VARPTR APPENDIX A BASIC-SO ERROR CODES A-I Error BASIC-80 < Table O. 0, Error APPENDIX B BASIC-SO RESERVED WORDS Page APPENDIX C BASIC-80 COMMAND CHARACTERS Page D-l. * = > Table < Table D-2. ASCII D-2 FS Codes BASIC-SO Code APPENDIXE CALLING NON-BAStC-SO SUBROUTINES Preparing Subroutines NOTE Calling Subroutines ~~D~ESS ILS_f_I~~I Numbers and Strings of Figure B-1. Internal Representation Some Real Examples BASIC-SO Calling Non-BASIC-SO Subroutines E9 E-5 EXTERNAL o E.H o Figure E-2. 8080/8085 Assembly Language Program Calling a Non-BASIC-SO BASIC-SO Program Figure E-4. FORTRAN-80 APPENDIX F RMX/SO BASIC-SO RMX/80 is What Initializing the SO/30 Predefined RMX/SO BASIC-SO Configuration Single Board Computer Hardware Reference Manual, chapter 2. Table F-l. Reference Manual for details). The supplied cable attaches from iSBC RAM RMX/SO RMX/80 Generating for Software Requirements Generating a Boot-Loaded RMX/80 BQOPS.ASM BASIC-80 CPU BOOTED CONTR UIO HIRAM BOTMEM PROM Programming Manual for details) User's Guide for further information.) RMX/80 Generating a PROM-Based Reference Manual shows one way to RMX/80 BASIC-80 o Configuring PROM-Based With or Without DFS. iSBC An o Page Configuring on an iSBC an Adding BASIC-SO to DFS Public Variables and Linking 13,10,26 Adding RMX/SO to Programs BASIC-SO Adding USR BASIC-SO Adding liD Drivers to I/O User-Written Figure F-S. Sample User-Written F-15 RMX/80 1/0 BASIC-SO Altering BASIC-80 Workspace Burning a BASIC-80 Program Into PROM PROM Program- mer Reference Manual, 9800133F. PROM Universal Mapper Operator's Manual, 9S00236A. Page INDEX Index BASIC-SO Ase, 110 # REQUEST COMMENTS READER'S FOR BUSIN ESS REPLY NO U.S.A. IN MAIL Page INTEL