1 Medley for the Sun User's Guide, Release 2.0 1 Medley for the Sun User's Guide, Release 2.0 TABLE OF CONTENTS 1 TABLE OF CONTENTS 1 TABLE of CONTENTS 6 Preface ix 1. Introduction 1 What Medley Requires 1 Hardware 1 Input/Output Devices 1 Bitmap Display 1 Printers 1 Software Requirements 2 Medley and Other Applications 2 Display Usage 2 Processor Usage 2 System Components 2 Medley Device-Naming Conventions 3 Notation Conventions 3 Fonts 3 Packages 3 Prompts 3 Compatibility 4 Sysout Compatibility 4 Compiled-File Compatibility 4 End-of-Line Convention 4 Release Contents 4 Documentation 4 Software 5 LispUsers Modules 5 2. Software Installation 7 Getting Ready to Install Medley 7 Ensuring Adequate Swap Space 8 Installing Medley for Shared Use 8 Installing Medley Software 9 Using the Installation Script's Menu 9 Getting a Copy Protection Key 11 Changing Configurations or Adding Options 11 3. Getting Started 13 Getting Ready 13 Running Medley 13 Running Medley Directly 13 Using the Medley Shell Script 13 Where Medley Looks for Your Sysout 15 Where Medley Looks for Your Site Initialization File 15 Medley and X Windows 16 Starting X Windows 16 Running Medley Remotely 16 The Medley Window 17 Environment Variables 17 Keyboard Interpretation 17 Sun Type 3 Keyboard 18 Sun Type 4 Keyboard 19 4. Using Medley on the Sun Workstation 21 Setting Up a Site Init File 21 Setting Up a Personal Init File 22 Saving Your State 22 Sun-Specific Environment Functions 24 System Environment Functions and Variables 24 VM Functions 25 Stopping Lisp Temporarily 25 Login Functions 26 Environment Inquiry 26 Display and Keyboard Functions and Variables 27 Timers and Clocks 27 Miscellaneous Operational Differences 28 Console Messages 28 5. Medley File Systems 31 File Naming Conventions 31 Hosts that Medley Supports 31 Using SunOS Files from Medley 31 Common {DSK} and {UNIX} Naming Conventions 32 {DSK} Naming Conventions 33 Version Numbering 33 Pathnames 35 {UNIX} Naming Conventions 35 Directories 36 Directory Enumeration 36 Directory Creation 36 Directory Deletion 37 Open File Limit 37 Default Pathname 37 File Attributes 38 File Variables 39 File System Errors 39 6. Error Recovery 41 URAID 41 Entering URAID 41 Conventions 41 URAID Commands 42 Displaying a Stack 42 Viewing Frames from a Stack 43 Miscellaneous 44 Other Fatal Error Conditions 44 Lisp Errors 44 Errors While Running Medley 44 Xerox Workstation-Specific Errors 45 Virtual Memory Errors 45 Appendix A. Installation Hints A-1 Medley Shell Variables A-1 Running on Multiple Workstations A-1 Installation for Sites with Sun-3 and Sun-4 Workstations A-1 Using a "runlde" on Multiple Workstations A-2 Configuring the Software A-2 Relinking A-3 Enabling PUP/XNS Ethernet A-3 Using NIS to Manage the Keys for Multiple Workstations A-3 Appendix B. ÿÿVerifying the Installation Tape's Validityÿ B-1 Output B-1 Examples B-1 Appendix C. Layout of Installation Tape Files C-1 Layout of Installation Tape C-1 Font Directories C-3 Manually Extracting Files from the Installation Tape C-4 Appendix D. Differences between Xerox Workstations and the UNIX Version of Medley D-1 Local Disk and Floppy Functions D-1 Library Modules Not Supported on the Sun D-1 TCP, TCPCHAT, etc. D-1 DLRS232C, DLTTY D-2 KEYBOARD, VIRTUALKEYBOARD D-2 Glossary GLOSSARY-1 Index INDEX-1 [This page intentionally left blank](LIST ((PAGE NIL (PAPERSIZE Letter FOLIOINFO (LOWERROMAN "" "") STARTINGPAGE# 3) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD RIGHT) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY HELVETICA OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (LOWERROMAN "" "")) (270 15 288 36) NIL) (HEADING NIL (HEADINGTYPE FOOTINGR) (54 27 558 36) NIL) (TEXT NIL NIL (54 54 504 690) NIL))) (PAGE NIL (PAPERSIZE Letter FOLIOINFO (LOWERROMAN "" "")) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD LEFT) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY HELVETICA OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (LOWERROMAN "" "")) (54 15 288 36) NIL) (HEADING NIL (HEADINGTYPE FOOTINGV) (54 27 558 36) NIL) (HEADING NIL (HEADINGTYPE VERSOHEAD) (54 762 558 36) NIL) (TEXT NIL NIL (54 54 504 684) NIL))) (PAGE NIL (PAPERSIZE Letter FOLIOINFO (LOWERROMAN "" "")) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD RIGHT) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY HELVETICA OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (LOWERROMAN "" "")) (270 15 288 36) NIL) (HEADING NIL (HEADINGTYPE FOOTINGR) (54 27 558 36) NIL) (HEADING NIL (HEADINGTYPE RECTOHEAD) (54 762 558 36) NIL) (TEXT NIL NIL (54 54 504 684) NIL)))))!5à¨à5à¨ø3øìT4ø æTT4ø ìTT5„„ø„ì8TTøTlì9TTøTlæT6„„ø„ìT3ø °T3ø ÈT3øæT3ø æT3ø ìT5TTøTæ5TTøTì6„„ø„òT9TTøTlòT9TTøTlìT5TTøTò3ø òT8TTøTlø-øäìT9lløTløT3TTøTT3ø øT5¨¨ø¨ø5TTøTø2øøFøø PAGEHEADING VERSOHEADFøø PAGEHEADING RECTOHEADEøø PAGEHEADINGFOOTINGVEøø PAGEHEADINGFOOTINGR HELVETICA HELVETICA CLASSIC€CLASSIC CLASSICCLASSIC ! HRULE.GETFNCLASSIC !,  HRULE.GETFNCLASSIC  - HRULE.GETFNCLASSIC  HRULE.GETFNCLASSIC  HRULE.GETFNCLASSIC   #    " $(!-"&8'#&/1*!/       &%>/; W   . 9 8 :$-   $ Å8zº