Advanced Compu~.r Design AOS Programiner's Manual AOS Programmer's Manual AQS. PROGRAMMER'S MANUAL VERSION 1.0 June 1982 Advanced Computer Design PDQ-3 is a registered trademark of Advanced Computer Design. Information furnished by ACD is believed to be accurate and reliable. However, no responsibility is assumed by ACD for its use~ nor for any infringements of patents or other rights of third parties which may result from its use. No license is granted by implication or otherwise under any patent or patent rights of ACD. ACD reserves the right to change product specifications at any time without notice. DEC is a registered trademark of Digital Equipment Corporation, Maynard, Mass. UCSD Pascal is a registered trademark of the University of California. Authors: Rich Gleaves Barry Demchak Part #: Copyright ec) 1982, Advanced Computer Design. All rights reserved. Duplication of this work by any means is forbidden without the prior written consent of Advanced Computer Design. AOS Programmer's Manual TABLE OF CONTENTS SECTION PAGE I INTRODUCTION • • • • • • • • • • • • • • • • • • • • • • 1 o Scope of this Manual • • • • • • • • • • • • • • • • • 1 1 Overview • • • • • • • • • • • • • • • • • • • • • • • 2 2 Notation and Terminology • • • • • • • • • • • • • • • 3 II DEVIATIONS FROM STANDARD PASCAL • • • • • • • • • • • • 5 o CASE Statements • • • • • • • • • • • • • •. • • • • 6 1 GOTO Statements • • • • • • • • • • • • • • • • • • • 6 2 NIL • • • • • • • • • • • • • • • • • • • • • • • • • 6 3 FORWARD • • • • • • • • • • • • • • • • • • • • • • • 7 4 ODD, CHR and NOT • • • • • • • • • • • • • • • • • • 7 5 I/O Intrinsics • • • • • • • • • • • • • • • • • • • 8 o INPUT • • • • • • • • • • • • • • • • • • • • • • 8 1 RESET and REWRITE • • • • • • • • • • • • • • • • 8 2 EOF • • • • • • • • • • • • • • • • • • • • • • • 8 3 READ and READLN • • • • • • • • • • • • • • • • • 8 4 WRITE and WRITELN • • • • • • • • • • • • • • • • 9 6 Packed Variables • •• • • • • • • • • • • • • • • • 9 7 Procedural and Functional Parameters • • • • • • • • 9 8 Program Headings •••• • • • • • • • • • • • • • • 9 9 Records • • • • • • • • • • • • • • • • • • • • • • • 10 10 Files • • • • • • • • • • • • • • • • • • • • • • • • 10 11 Reserved Words •••• • • • • • • • • • • • • • • • 10 12 Comments • • •.• • • • • • • • • • • • • • • • • • • 10 13 Type Compatibility ••• • • • • • • • • • • • • • • 11 i AOS Programmer's Manual III EXTENSIONS TO STANDARD PASCAL • • • • • • • • • • • • • 13 o Concurrency • • • • • • • • • • • • • • • • • • • • 14 o Tasks. • • • • • • • • • • • • • • • • • • • • • 15 1 Semaphores • • • • • • • • • • • • • • • • • • • 20 2 Interrupts • • • • • • • • • • • • • • • • • 23 3 Time Slicing • • • ·• '.• • • • • • • • • • • • • • 24 1 Program Segmentation • • • • • • • • • • • • • • • • 25 2 Separate Compilation • • • • • • • • • • • • • • • • 30 o Units. • • • • • • • • • • • • • • • • • • • • • 30 1 USing Units • • • • • • • • • • • • • • • • • • • 33 2 Unit Linkage ••• • • • • • • • • • • • • • • • 36 3 Files • • • • • • • • • • • • • • • • • • • • • • • 37 o File System Access • • • • • • • • • • • • • • • 37 1 Interactive Files • • • • • • • • • • • • • • • • 39 2 The Keyboard File • • • • • • • • • • • • • • • • 41 3 Block Files • • • • • • • • • • • • • • • • • • • 41 4 Random Access Files • • • • • • • • • • • • • • • 43 4 Strings • • • • • • • • • • • • • • • • • • • • • • 44 5 Dynamic Variable Management • • • • • • • • • • • • 49 o The 11.0 Heap • • • • • • • • • • • • • • • • • • 49 1 The IV.O Heap ••••• • • • • • • • • • • • • • 50 6 Extended Precision Arithmetic • • • • • • • • • • • 53 7 Extended Comparisons • • • • • • • • • • • •. • • 57 o Records and Arrays • • • • • • • • • • • • • • • 57 1 Pointers • • • • • • • • • • • • • • • • • • • • 58 8 Byte Array Manipulation • • • • • • • • • • • • • • 59 9 Device I/O • • • • • • • • • • • • • • • • • • • • • 62 10 Inline Machine Code • • • • • • • • • • • • • • • • 57 11 Miscellaneous Extensions • • • • • • • • • • • • • • 69 o Identifiers... • • • • • • • • • • • • • • • • 69 1 Declaration Parts • • • • • • • • • • • • • • • • 70 2 Pointer Type Conversion • • • • • • • • • • • • • 71 3 Screen Control ••••• • • • • • • • • • • • • 72 4 Clock Access • • • • • • • • • • • • • • • • • • 73 5 Powers of Ten • • • • • • • • • • • • • • • • • • 73 6 Arctangent Synonym • • • • • • • • • • • • • • • 74 7 Procedure Termination • • • • • • • • • • • • • • 74 8 I/O Completion Status • • • • • • • • • • • • • • 75 9 MemoryAvailable • • • • • • • • • • • • • • • • 77 10 Breakpoint Trap • • • • • • • • • • • • • • • • • 77 11 Compiler Support • • • • • • • • • • • • • • • • 78 ii AOS Programmer's Manual IV UCSD INTRINSICS • • • • • • • • • • • • • • • • • • • • 81 o ATAN • • • • • • • • • • • • • • • • • • • • • • • • 82 1 ATTACH • • • • • • • • • • • • • • • • • • • • • • • 83 2 BLOCKREAD • • • • • • • • • • • • • • • • • • • • • • 84 3 BLOCKWRITE • • • • • • • • • • • • • • • • • • • • • 85 4 CLOSE • • • • • • • • • • • • • • • • • • • • • • • • 86 S CON CAT • • • • • • • • • • • • • • • • • • • • • • • 87 6 COpy • • • • • • • • • • • • • • • • • • • • • • • • 88 7 DELETE • • • • • • • • • • • • • • • • • • • • • • • 89 8 EXIT • • • • • • • • • • • • • • • • • • • • • • • • 90 9 FILLCHAR • • • • • • • • • • • • • • • • • • • • • • 91 10 GOTOXY • • • • • • • • • • • • • • • • • • • · .. • • 92 11 HALT • • • • • • • • • • • • • • • • • • • • • • • • 93 12 IDSEARCH • • • • • • • • • • • • • • • • • • • • • • 94 13 INSERT • • • • • • • • • • • • • • • • • • • • • • • 95 14 IORESULT • • • • • • • • • • • • • • • • • • • • • • 96 15 LENGTH • • • • • • • • • • • • • • • • • • • • • • • 97 16 MARK • • • • • • • • • • • • • • • • • • • • • • • • 98 17 MEMAVAIL • • • • • • • • • • • • • • • • • • • • • • 99 18 MEMLOCK •• • • • • • • • • • • • • • • • • • • • • • 100 19 MEMSWAP • • • • • • • • • • • • • • • • • • • • • • • 101 20 MOVELEFT • • • • • • • • • • • • • • • • • • • • • • 102 21 MOVERIGHT • • • • • • • • • • • • • • • • • • • • • • 103 22 OPENNEW •• • • • • • • • • • • • • • • • • • • • • • 104 23 OPENOLD •• • • • • • • • • • • • • • • • • • • • • • 105 24 PMACHINE • • • • • • • • • • • • • • • • • • • • • • 106 25 POS • • • • • • • • • • • • • • • • • • • • • • • • • 107 26 PWROFTEN • • • • • • • • • • • • • • • • • • • • • • 108 27 RELEASE • • • • • • • • • • • • • • • • • • • • • • • 109 28 *RESET • • • • • • • • • • • • • • • • • • • • • • • • 110 29 *REWRITE •• • • • • • • • • • • • • • • • • • • • • • 111 30 RMEMAVAIL • • • • • • • • • • • • • • • • • • • • • • 112 31 SCAN • • • • • • • • • • • • • • • • • • • • • • • • 113 32 SEEK • • • • • • • • • • • • • • • • • • • • • • • • 114 33 SEMINIT •• • • • • • • • • • • • • • • • • • • • • • 115 34 SIGNAL • • • • • • • • • • • • • • • • • • • • • • • 116 35 SIZEOF • • • • • • • • • • • • • • • • • • • • • • • 117 36 START· ••• • • • • • • • • • • • • • • • • • • • • • 118 37 STR • • • • • • • • • • • • • • • • • • • • • • • • • 119 38 TIME • • • • • • • • • • • • • • • • • • • • • • • • 120 39 TREESEARCH • • • • • • • • • • • • • • • • • • • • • 121 40 UNITBUSY • • • • • • • • • • • • • • • • • • • • • • 122 41 UNITCLEAR • • • • • • • • • • • • • • • • • • • • • • 123 42 UNITREAD • • • • • • • • • • • • • • • • • • • • • • 124 43 UNITSTATUS • • • • • • • • • • • • • • • • • • • • • 125 44 UNITWAIT • • • • • • • • • • • • • • • • • • • • • • 126 4S UNITWRITE • • • • • • • • • • • • • • • • • • • • • • 127 46 VARAVAIL • • • • • • • • • • • • • • • • • • • • • • 128 47 VARDISPOSE • • • • • • • • • • • • • • • • • • • • • 129 48 VARNEW • • • • • • • • • • • • • • • • • • • • • • • 130 49 WAIT • • • • • • • • • • • • • • • • • • • • • • • • 131 -*- indicates extension of a standard Pascal intrinsic. iii AOS Programmer's Manual v COMPILE OPTIONS • • • • • • • • • • • • • • • ~~tions • • • • • • • • • • • • • • • • • • • • • • • 133 o Compiled Listings • • • • • • • • • • • • • • • • • 136 1 Include Files • • • • • • • • • • • • • • • • • • • 138 2 Swapping Compiler • • • • • • • • • • • • • • • • • 139 3 Conditional Compilation • • • • • • • • • • • • • • 140 4 IIO Checks • • • • • • • • • • • • • • • • • • • • 141 5 Range Checks • • • • • • • • • • • • • • • • • • • 141 6 Heap Intrinsics • • • • • • • • • • • • • • • • • • 142 7 Copyright Notices • • • • • • • • • • • • • • • • • 143 8 Console Display Suppression • • • • • • • • • • • • 144 9 Segment Residency • • • • • • • • • • • • • • • • • 144 10 Ver sion Control • • • • • • • • • • • • • • • • • • 145 11 System Programs • • • • • • • • • • • • • • • • • • 146 12 Operating System • • • • • • • • • • • • • • • • • 147 13 Boolean Negation • • • • • • • • • • • • • • • • • 147 1 Option Summary • • • • • • • • • • • • • • • • • • • • 149 VI OPERATING SYSTEM CUSTOMIZATION • • • • • • • • • • • • • 151 0 Operating System Extensions • • • • • • • • • • • • • 152 1 System Prompt Line and Program Execution • • • • • • 154 2 System Device Drivers • • • • • • • • • • • • • • • • 155 3 Exception Handling • • • • • • • • • • • • • • • • • 158 4 Breakpoint Processor • • • • • • • • • • • • • • • • 159 VII PROGRAMMING PRACTICES • • • • • • • • • • • • • • • • • 161 0 Packed Variables • • • • • • • • • • • • • • • • • • 162 1 Accessing Words, Bits, and Bit Fields • • • • • • • 167 2 Unsigned Integer Manipulation • • • • • • • • • • • 172 3 Full-word Logical Operations • • • • • • • • • • • • 174 4 Variable-sized Buffer Allocation • • • • • • • • • • 175 5 Data Prompts • • • • • • • • • • • • • • • • • • • • 178 6 Device Drivers • • • • • • • • • • • • • • • • • • • 182 7 Multitermina1 Applications • • • • • • • • • • • • • 187 8 Locating Execution Errors. • • • • • • • • • • • • • 190 9 Programming with Units • • • • • • • • • • • • • • • 192 10 Programs as Procedures • • • • • • • • • • • • • • • 196 11 Programming for IIO Redirection • • • • • • •.