AMOS user's guide This document reflects AMOS versions 4.1 end later Jaipha 1tamacro 'AMOS', 'ALphaBASIC', and 'AM—lOD' are trademarks of products and software of ALPHA MICROSYSTEMS Irvine, CA 92714 ©1979 — ALPHA MICROSYSTEMS ALPHA MICROSYSTEMS 17881 Sky Park North Irvine, CA 92714 15 October 1979 DWM—O01 00—57 CHANGE PAGE PACKET #1 FOR THE AMOS USER'S GUIDE 1.0 INTRODUCTION In an effort to keep our users' documentation up—to—date, we have begun to issue ALpha Micro software manual update packages. Each change page packet contains: 1. Update instructions. 2. A new title page for the manual you are updating. 3. A new table of contents for the updated manual (if needed). 4. The manual pages we have changed. 5. A new index for the updated manual. first This change page packet is the such packet for the AMOS User's Guide, (DWM—00100—35). 2.0 UPDATE INSTRUCTIONS To make the update process easier, we recommend that you put your AMOS User's Guide into a three—ring binder notebook. If the pages are attached to one another, separate them. it First, remove the title page from this change page packet and exchange for the title page in the AMOS User's Guide. (We have not issued a new table of contents with this change page packet, because the new pages do not change your current table of contents.) Now, remove the change pages from the packet and substitute them for the original pages listed below. Finally, replace the index. CHANGE PAGE PACKET #1 FOR THE AMOS USERtS GUIDE Page 2 3.0 LIST OF CHANGE PAGES Below is a list of the change pages in this packet. Remove the original pages listed beLow and replace them with the revised pages. Note that we have marked aLl changed portions of the text with change bars (vertical bLack Lines in the Left margin) on each page. ALL change pages aLso bear the date of this change page packet. Original Page Revised Pages TitLe page with TitLe page Page 5—1/5—2 with Page 5—1/5—2 Page 8—3/8—4 with Page 8—3/8—4 Page 8—11/8—12 with Page 8—11/8—12 Pages 9—39 through 9—44 with Pages 9—39 through 9—45 Pages 10—7 through 10—9 with Pages 10—7 through 10—9 Pages 11—1 through 11—6 with Pages 11—1 through 11—6 Page 12—3/12—4 with Page 12—3/12—4 Pages 13—1 through 13—4 with Pages 13—1 through 13—4 Appendix A with Appendix A Index with Index Page iii AMOS USER'S GUIDE IMPORTANT NOTICE that must be followed There are some simple software instaLlation procedures to gt AMOS up and running for the first time on your particuLar hardware. has done this DO NOT attempt to start up your system untiL a System Operator necessary initialization of the system software. NOTE: Throughout this document we frequentLy refer to the manual "Introduction to AMOS." This manual is in the process of being written, and print and distribute it. we ask for your patience until we are able to This document was created using the Alpha Micro text editor VUE and the Alpha Micro text formatter TXTFMT. * NOTE TO THE SYSTEM OPERATOR: If you are to be the System Operator (the person in charge of system management, adding user accounts, adding terminals to the system, etc.), you MUST read the documents "The System Initialization Command File" and "Setting Up the Line Printer Spooler" in the "System Operator's Information" section of the AM—100 documentation packet before you try to use the system. The information in this manual reflects AMOS versions 4.1 and later. Page v AMOS USER'S GUIDE PREFACE This. manual is aimed at the generaL user of the system. We do not assume that you have had any great prior experience with computers. However, we do "files" assume that you are farni Liar with such common computer concepts as (known to IBM users as "data sets"), "disks," "jobs," 'text editors," and "commands." This manual contains very Little theory or discussion of the inner workings of the operating system; instead, it is a practical guide to system operation. If you are interested in a broader system view than this manuaL provides (e.g., discussions on fiLes, the operating system structure, the programs avai Lable on the system, organization of files on the disk, jobs, memory partitions, etc.), refer to the manual "Introduction to AMOS." If you are new to computers, you will probably want to read "Introduction to AMOS" before beginning to use the AMOS system; in it you wilt find definitions for many of the terms we use in the "AMOS User's Guide." If you are an experienced AMOS user, you will want to just skim the "AMOS User's Guide," and refer to the "AMOS System Commands Reference Sheets" for answers to your questions about specific commands. We would also Like to draw your attention to the document titled "A Guide to the Software Documentation Library" which lists aLL of the software AMOS it documentation currentLy offered by Alpha Micro; telLs you what information each manual contains, and also indicates the kind of reader at which each manual is aimed. If you want information on a spebific facet of system operation (such as using the macro—assembler, BASIC or one of the text editors), see "A Guide to the AMOS Software Documentation Library" to find out what manuals cover those topics. Page vii AMOS USER'S GUIDE Table of Contents PREFACE V Vii TABLE OF CONTENTS CHAPTER 1 INTRODUCTION TO THE MANUAL 1.1 MANUAL CONTENTS 1—2 1.2 CONVENTIONS USED IN THIS MANUAL 1—2 PART I GETTING STARTED CHAPTER 2 TURNING THE SYSTEM ON AND OFF 2.1 TURNING ON THE SYSTEM 2—1 2.2 GETTING THE OPERATING SYSTEM'S ATTENTION 2—3 2.3 CHANGING DISK CARTRIDGES AND FLOPPY DISKS .... 2—3 2.3.1 The MOUNT Command 2—3 2.4 TURNING OFF THE SYSTEM 2—4 CHAPTER 3 COMMUNICATING WITH AMOS 3.1 PROMPT AND CURSOR SYMBOLS 3—2 3.2 THE KEYBOARD 3—2 3.3 CONTROL—CHARACTERS 3—3 3.4 TYPING COMMANDS 3—4 3.5 THE HELP COMMAND 3—6 CHAPTER 4 A QUICK DEMO OF SYSTEM USE 4.1 LOGGING IN 4—1 4.2 CREATING A TEXT FILE WITH VUE 4—3 43 4.2.1 Erasing Characters 44 4.2.2 Inserting Characters 4.2.3 Leaving VUE 4—4 4.3 FINDING OUT WHAT FILES ARE IN YOUR ACCOUNT ... 4—5 4.4 DISPLAYING A FILE 4—5 4.5 COPYING A FILE 4—6 4.6 RENAMING A FILE 4—6 4.7 GETTING INTO BASIC 4—7 4.7.1 Saving a BASIC Program 48 4.8 ERASING A FILE FROM YOUR ACCOUNT 4—8 4.9 LOGGING OFF THE SYSTEM 4—9 Page viii AMOS USER'S GUIDE CHAPTER 5 IDENTIFYING YOURSELF TO AMOS 5.1 PROJECT—PROGRAMMER NUMBERS 5—1 5.2 PASSWORDS 5—2 5.3 LOGGING INTO THE SYSTEM 5—2 5.3.1 Finding Out What Account You Are Logged into 54 5.3.2 Transferring to Another Account 54 5.3.3 LOG and the Ersatz Devices 54 5.3.4 The START Command File 55 5.3.5 System Mail S_S 5.4 LOGGING OFF THE SYSTEM 5—5 CHAPTER 6 IDENTIFYING FILES TO AMOS 6.1 FILE SPECIFICATIONS 6—1 6.1.1 Device Name 61 6.1.1.1 Special Devices 6—2 6.1.2 Filename 6—3 6.1.3 Extension 6—3 6.1.4 Project—programmer Number 6—5 6.2 WILDCARD SYMBOLS 6—5 6.3 FILE SPECIFICATION DEFAULTS 6—6 PART II THE SYSTEM COMMANDS CHAPTER 7 INTRODUCTION TO AMOS COMMANDS 7.1 COMMAND SYNTAX 7—2 7.1.1 Command DefauLts 7—3 7.2 COMMAND SWITCHES 7—3 CHAPTER 8 COMMAND FILES AND DO FILES 8.1 THE CONTENTS OF A COMMAND FILE 8—2 8.1.1 Special Symbols in Command Files 8—3 8.2 DO FILES 8—5 8.2.1 Building and Invoking DO FiLes 8—6 8.2.2 Special Parameter Symbols 88 8.2.3 SAMPLE DO FILES 8—9 8.2.3.1 TFORM.DO 8—9 8.2.3.2 PRINTE.DO 8—9 8.2.3.3 BACKUP.DO 8—11 8.2.3.4 WRITE.DO 8—11 8.2.3.5 ASSMBL.DO 8—12 CHAPTER 9 THE WILDcARD FILE COMMANDS 9.1 INTRODUCTION TO WILDCARD FILE COMMANDS 9—1 9.1.1 Wildcard Symbols 9—2 9.1.2 Input File Specifications 93 Page ix AMOS USER'S GUIDE 94 9.1.3 Output FiLe Specifications 95 9.1.4 Command Switches 97 9.1.5 Ersatz Devices 9.2 FINDING OUT WHAT FILES ARE ON THE DISK (DIR) 9—7 9.2.1 Finding Out What FiLes Are in 98 Your Account 9.2.2 Finding Out What FiLes Are in an Account Other Than Your Own 9_S 99 9.2.3 DIR and Wildcard Symbols 9.2.3.1 Using DIR to Find Specific Files 9—10 9.2.4 Creating a FiLe That Contains a Directory Listing 9—11 9.2.5 Printing a Directory Listing 9—12 9.2.6 SeLecting DIR Options 9—12 9.2.7 DIR and Special and Ersatz Devices .... 9—16 9.2.8 DIR Error Messages 9—17 9.3 RENAMING FILES (RENAME) 9—18 9.3.1 Renaming a File in Your Account 9—19 9.3.2 Renaming a FiLe in an Account Other Than Your Own 9—19 9.3.3 RENAME and Wildcard SymboLs 9—20 9.3.4 SeLecting RENAME Options 9—21 9.3.5 RENAME and Special and Ersatz Devices 9—22 9.3.6 RENAME Error Messages 9—23 9.4 ERASING FILES (ERASE) 9—24 9.4.1 Erasing Files From Your Account 924 9.4.2 Erasing Files From Accounts Other Than Your Own 9—25 9.4.3 ERASE and Wildcard Symbols 9—25 9.4.4 Using an Outfilespec 9—26 9.4.5 Selecting ERASE Options 9—27 9.4.6 ERASE and Special and Ersatz Devices .. 9—27 9.4.7 ERASE Error Messages 9—28 9.5 COPYING FILES (COPY) 9—28 9.5.1 Copying a File in Your Own Account .... 9—30 9.5.2 Copying a FiLe into Your Own Account from Another Account 9—30 9.5.3 Copying a File into An Account Other Than Your Own 9—30 9.5.4 COPY and Wildcard Symbols 9—30 9.5.5 COPY and the System Operator 9—31 9.5.6 Selecting COPY Options 9—32 9.5.7 COPY and SpeciaL and Ersatz Devices ... 9—34 9.5.8 COPY Error Messages 935 9.6 PRINTING FILES (PRINT) 9—37 9.6.1 Sending a File to a Printer 9—38 9.6.2 PRINT and Wildcard Symbols 9—38 9.6.3 Finding Out Information About the Printer Queues 9—38 9.6.4 Setting Printer Forms 939 AMOS USER'S GUIDE Page x 9.6.5 Selecting PRINT Options 9—40 9.6.6 PRINT and Ersatz Devices 943 9.6.7 PRINT Error Messages 943 CHAPTER 10 MORE FILE COMMANDS 10.1 DISPLAYING THE CONTENTS OF A FILE (TYPE) ... 10—1 10.1.1 Hints and Restrictions 10—2 10.1.2 TYPE Error Messages 10—2 10.2 APPENDING FILES (APPEND) 10—3 10.2.1 APPEND Error Messages 10—4 10.3 SORTING A FILE (SORT) 10—4 10.3.1 SORT Statistics 10—6 10.3.2 Hints and Restrictions 10—7 10.3.3 Example 10—7 10.3.4 SORT Error Messages 10—8 CHAPTER 11 MEMORY COMMANDS 11.1 LOADING FILES INTO YOUR MEMORY PARTITION (LOAD) 11—1 11.1.1 Hints and Restrictions 11—2 11.2 FINDING OUT WHAT MODULES ARE IN MEMORY (MAP) 11—2 11.2.1 Finding Out What Modules Are in Your Memory Partition 11—3 11.2.2 Displaying Information About Specific Memory Modules 11—3 11.2.3 Selecting MAP Options 11—3 11.2.3.1 Limiting the MAP DispLay 11—4 11.2.3.2 Using MAP to Find Out What Modules Are in System Memory 11—5 11.3 FINDING OUT WHAT MODULES ARE IN SYSTEM MEMORY (SYSTEM) 11—5 11.4 SAVING MEMORY MODULES AS FILES (SAVE) 11—6 11.5 DELETING MEMORY MODULES FROM YOUR MEMORY PARTITION (DEL) 11—7 CHAPTER 12 SYSTEM INFORMATION COMMANDS 12.1 SYSTEM STATUS COMMAND (SYSTAT) 12—1 12.1.1 Job Status Symbols 12—2 12.2 THE SET COMMAND 12—3 12.3 FINDING OUT WHAT DEVICES ARE ON THE SYSTEM (DEVTBL) 12—4 12.4 FINDING OUT THE NAME OF YOUR JOB (JOBS) .... 12—5 12.5 SENDING MESSAGES TO OTHER JOBS (SEND) 12—5 12.5.1 SEND Error Messages 12—6