Mic'ro/RSX User's Guide Order No
Total Page:16
File Type:pdf, Size:1020Kb
Mic'ro/RSX User's Guide Order No. AA-Y5398-TC Micro/RSX Version 3.0 Digital Equipment Corporation Maynard, Massachusetts First Printing, December 1983 Revised, June 1985 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Copyright ©1983, 1985 by Digital Equipment Corporation All Rights Reserved. Printed in U.S.A. The postpaid USER'S COMMENTS form on the last page of this document requests the user's critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: DEC EduSystem UNIBUS DEC/CMS lAS VAX DEC/MMS MASSBUS VAXcluster DECnet MicroPDP-11 VMS DECsystem-10 Micro/RSX VT DECSYSTEM-20 PDP DECUS PDT DECwriter RSTS tDDrnDDElD DIBOL RSX ZK-2544 This document was prepared using an in-house documentation production system. All page composition and make-up was performed by TE", the typesetting system developed by Donald E. Knuth at Stanford University. TE" is a registered trademark of the American Mathematical Society. HOW TO ORDER ADDITIONAL DOCUMENTATION In Continental USA and Puerto Rico call 800-258-1710 DIRECT MAIL ORDERS (CANADA) In New Hampshire. Alaska. and Hawaii call 603-884-6660 Digital Equipment of Canada Ltd. 100 Herzberg Road In Canada call 613-234-7726 (Ottawa-Hull) Kanata, Ontario K2K 2A6 800-267-6215 (all other Canadian) Attn: Direct Order Desk DIRECT MAIL ORDERS (USA & PUERTO RICO)" DIRECT MAIL ORDERS (INTERNATIONAL) Digital Equipment Corporation Digital Equipment Corporation PO. Box CS2008 PSG BUSiness Manager Nashua. New Hampshire 03061 clo Digital's local subsidiary or approved distributor • Any prepaid order from Puerto Rico must be placed with the local Digital subsidiary (809-754-7575) Internal orders should be placed through the Software Distribution Center (SDC). Digital Equipment Corporation, Northboro, Massachusetts 01532 Contents Volume 1 Preface xvii Summary of Technical Changes xxiii Chapter 1 Welcome to Micro/RSX 1.1 What's It For? ................................... 1-2 1.1.1 The Real-Time Control Environment. .............. 1-2 1.1.2 The Applications Environment .................. 1-2 1.1.3 The General Purpose Timesharing Environment . 1-3 1.1.4 The Purpose of the Operating System .............. 1-3 1.2 How the User's Guide is Organized ..................... 1-5 Chapter 2 How to Use DCl 2.1 Micro/RSX and DCL: Basic Concepts .................... 2-2 2.2 DCL Command Descriptions .......................... 2-2 2.2.1 System Programmer Commands ................. 2-3 2.3 The DCL Command Line ............................ 2-3 2.3.1 Prompting ............................... 2-4 2.3.2 Qualifiers ................................ 2-4 2.3.3 HELP .................................. 2-6 2.3.4 Abbreviations ............................. 2-8 2.3.5 Numbers and Dates ........................ 2-10 iii 2.3.6 Multiple Parameters .. ' ...................... 2-10 2.3.7 Underscore Character ....................... 2-11 2.3.8 Colon and Equal Sign . 2-11 2.3.9 Quoting Strings ........................... 2-11 2.3.10 DECnet and DCL .......................... 2-12 2.3.10.1 SET HOST ........................... 2-13 2.3.10.2 SHOW HOST ......................... 2-14 2.3.11 Command Line Continuation .................. 2-15 2.3.12 Comments in Command Lines ................. 2-15 2.3.13 Errors ................................. 2-16 2.4 Using the Queue Manager: PRINT and BATCH Jobs ......... 2-17 2.5 Indirect Command Files in DCL ...................... 2-18 Chapter 3 Using Your Terminal 3.1 Logging In and Logging Out .......................... 3-3 3.1.1 LOGIN ................................. 3-4 3.1.2 LOGOUT ................................ 3-9 3.2 The Keyboard .................................. 3-10 3.2.1 RETURN and Command Line Length ............. 3-11 3.2.2 Line Terminators .......................... 3-12 3.2.3 DELETE Versus BACK SPACE ................. 3-12 3.2.4 CAPS LOCK and SHIFT ..................... 3-13 3.2.5 NO SCROLL or HOLD SCREEN . 3-13 3.2.6 Other Keys . 3-13 3.3 The Keypad ................................... 3-14 3.4 The CTRL Key and Control Characters .................. 3-15 3.4.1 CTRL/C ................................ 3-15 3.4.2 CTRL/O ................................ 3-16 3.4.3 CTRL/Z ................................ 3-16 3.4.4 CTRL/U . 3-17 3.4.5 CTRL/G. 3-17 3.5 HELP 3-18 3.6 BROADCAST.................................. 3-21 3.7 SET and SHOW TERMINAL ......................... 3-25 3.7.1 SET TERMINAL ........................... 3-26 iv 3.7.2 SHOW TERMINAL ......................... 3-27 Chapter 4 EDT 4.1 Introduction to the EDT Editor . 4-1 4.1.1 Starting an Editing Session . 4-3 4.1.2 Choosing an Editing Mode . 4-3 4.1.2.1 Keypad Mode .......................... 4-3 4.1.2.2 line Mode . 4-4 4.1.2.3 Nokeypad Mode . 4-7 4.1.3 Moving Among Editing Modes .................. 4-8 4.1.4 Getting Help from EDT ....................... 4-9 4.1.5 Ending an Editing Session .................... 4-10 4.1.6 Recovering from a Lost Editing Session . 4-11 4.2 Using EDT Buffers . 4-12 4.2.1 EDT'S Permanent Buffers ..................... 4-13 4.3 Using Keypad Mode . 4-13 4.3.1 Using the GOLD Key ....................... 4-14 4.3.2 Moving the Cursor ......................... 4-14 4.3.3 Inserting Text ............................ 4-17 4.3.4 Deleting and Undeleting Text .................. 4-17 4.3.5 Locating Text ............................. 4-20 4.3.6 Moving Text . 4-22 4.3.7 Substituting Text .......................... 4-24 4.3.8 Five More Keys to Use with the GOLD Key ......... 4-26 4.4 How to Use line Mode ............................ 4-27 4.4.1 Line Numbers and Ranges .................... 4-27 4.5 Advanced Editing Features .......................... 4-30 4.5.1 Defining Macros ........................... 4-31 4.5.2 Defining Key Functions ...................... 4-33 4.5.3 Creating a Personal Editing Environment. 4-36 4.5.3.1 Using SET Commands . 4-37 4.5.3.2 Using SHOW Commands to See What is Set. 4-38 4.5.3.3 Startup Command Files .................. 4-39 4.5.3.4 Using Indirect Command Files with EDT ....... 4-42 4.5.4 Structured Tabs ........................... 4-43 v 4.5.5 More on EDT Buffers ....................... 4-44 4.5.5.1 How To Create and Move Between Buffers ...... 4-44 4.5.5.2 How To Copy Text from a File into a Buffer ..... 4-46 4.5.5.3 How To Copy Text from One Buffer to Another Buffer . .. 4-46 4.5.5.4 How To Copy Text from a Buffer to a File ...... 4-48 4.5.5.5 Ways to Use Buffers ..................... 4-48 4.6 EDT Summary. 4-50 4.6.1 Range Specifications . 4-50 4.6.2 Editor Control Commands . 4-54 4.6.3 Line-Mode Editing Commands ................. 4-60 4.6.4 Editing Entities ........................... 4-63 4.6.5 Keypad Commands. 4-65 4.6.6 Nokeypad Commands ....................... 4-70 4.7 EDIT Command ................................. 4-74 Chapter 5 Files on Micro/RSX Systems 5.1 File Ownership and Location ......................... 5-2 5.2 File Specification ................................. 5-3 5.3 Defaults in File Specifications ......................... 5-5 5.4 Wildcards in File Specifications ........................ 5-8 5.5 Date-Related Qualifiers ............................ 5-11 5.6 Protection ..................................... 5-12 5.6.1 File Protection ............................ 5-12 5.6.2 Directory Protection ........................ 5-16 5.6.3 Volume Protection ......................... 5-17 5.7 Creating Directories and Sequential Files ................. 5-18 5.7.1 CREATE ................................ 5-18 5.7.2 CREATE/DIRECTORY ...................... 5-20 5.8 Maintaining a Directory ............................ 5-23 5.8.1 DIRECTORY ............................. 5-23 5.8.2 DELETE . 5-32 5.8.3 PURGE ................................ 5-35 5.8.4 COPY ................................. 5-37 5.8.5 RENAME ............................... 5-40 vi 5.9 More File-Related Commands ........................ 5-42 5.9.1 TYPE .................................. 5-42 5.9.2 PRINT ................................. 5-44 5.9.3 Queue Manager Commands ................... 5-53 5.9.3.1 DELETE/ENTRy ....................... 5-55 5.9.3.2 SHOW QUEUE and SHOW PROCESSOR ....... 5-56 5.9.3.3 SHOW QUEUE ........................ 5-56 5.9.3.4 SHOW PROCESSOR .................... 5-59 5.9.3.5 SET QUEUE .......................... 5-60 5.9.3.6 STOP/ABORT ........................ 5-62 5.9.3.7 HOLD/ENTRY and RELEASE/ENTRY ........ 5-63 5.9.4 UNLOCK ............................... 5-64 5.10 SET and SHOW ................................. 5-65 5.10.1 SET DEFAULT ........................... 5-66 5.10.2 SHOW DEFAULT .......................... 5-68 5.10.3 SET UIC ................................ 5-68 5.10.4 SHOW UIC .............................. 5-70 5.10.5 SET PROTECTION ......................... 5-71 5.10.6 SET PROTECTION/[NO]DEFAULT .............. 5-74 5.10.7 SHOW PROTECTION ....................... 5-77 Chapter 6 Devices and Volumes 6.1 Devices on Micro/RSX Systems ........................ 6-2 6.1.1 Physical Devices, Pseudo Devices, LUNs, and Logical Names .................................. 6-4 6.1.2 Summary of Device and Volume Use Commands ...... 6-4 6.2 MOUNT ....................................... 6-5 6.3 DISMOUNT................................... 6-14 6.4 INITIALIZE . 6-18 6.5 SET and SHOW ................................. 6-24 6.5.1 SHOW DEVICES .......................... 6-24 vii Chapter 7 Running Tasks 7.1 Two Kinds of RUN Command ........................ 7-2 7.1.1 RUN Command for Task Image Files .............. 7-2 7.1.2 RUN Command for Installed Tasks ............... 7-5 7.2 ABORT ....................................... 7-6 7.3 INSTALL ...................................... 7-8 7.4 REMOVE ....................................