.SPACING 1 .TITLE ^^INTRODUCTION TO AN RSX TERMINAL\\ .SKIP20 .CENTER ^^INTRODUCTION TO AN RSX TERMINAL\\ .SKIP 4 .SKIP4 .SPACING 1 ^^NOTE:\\ ^THIS IS A LOCALLY WRITTEN AND MAINTAINED DOCUMENT. ^IT IS SPECIFICALLY FOR THE CONVENIENCE OF GENERAL ^^RSX\\ USERS, AND THEREFORE DOES NOT ATTEMPT TO BE COMPLETE. ^HOWEVER, IF ANY PART OF THIS DOCUMENT IS UNCLEAR OR INSUFFICIENT, PLEASE BRING THIS TO THE ATTENTION OF THE DOCUMENT MAINTAINER, NAMED BELOW. ^IT IS ONLY THROUGH FEEDBACK FROM THE USERS THAT THIS DOCUMENT WILL IMPROVE. .SKIP 5 ^DOCUMENT ^MAINTAINER: ^MARK ^JOHNSON, ^^ASD, ARC.\\ .BREAK ^LAST UPDATE: 23-^^MAY\\-77. .PAGE .SKIP 2 .CENTER ^TABLE OF ^CONTENTS .SKIP 4 .TAB STOPS 55 .NOFILL 0. ^INTRODUCTION. 3 1. ^SPECIAL CHARACTERS. 3 2. ^COMMANDS. 4 3. ^FILES AND DEVICES. 10 4. ^UTILITIES. 12 5. ^LANGUAGES. 13 .SKIP 1 ^A.#^GLOSSARY OF TERMS. 15 ^B.#^DOCUMENTATION AVAILABLE. 21 ^C.#^SAMPLE TERMINAL SESSION. 23 ^D.#^DEVICES AVAILABLE. 24 ^E.#^ERROR CODES. 25 .SKIP 1 ^INDEX. 27 .FILL .PAGE 0. ^INTRODUCTION. .PARAGRAPH ^THIS DOCUMENT IS INTENDED TO PROVIDE USERS OF THE ^^RSX\\ SYSTEM WITH A CONCISE DESCRIPTION OF THE FEATURES AVAILABLE AT THE TERMINAL. ^THIS IS NOT AN EXHAUSTIVE LIST OF THE FEATURES AVAILABLE UNDER ^^RSX\\, BUT THOSE APPLICABLE TO THE GENERAL USER ARE INCLUDED. ^ADVANCED USERS MAY WISH TO CONSULT THE ^^RSX\\ ^OPERATOR'S ^PROCEDURES MANUAL, WHERE ^^RSX\\ TERMINAL USAGE IS DESCRIBED IN DETAIL. .SKIP 2 .INDEX CONTROL CHARACTERS .INDEX SPECIAL CHARACTERS 1. ^SPECIAL CHARACTERS. .PARAGRAPH ^THE ^^RSX\\ OPERATING SYSTEM PROVIDES THE TERMINAL USER WITH A SET OF SPECIAL CHARACTERS TO CONTROL THE BEHAVIOUR OF THE TERMINAL. ^MOST OF THESE CHARACTERS ARE TYPED BY HOLDING THE CONTROL .INDEX ^^CTRL\\ KEY .INDEX CONTROL KEY KEY (^^CTRL\\) DOWN WHILE TYPING THE APPROPRIATE CHARACTER KEY. ^THROUGHOUT THE DOCUMENTATION, THESE CHARACTERS ARE INDICATED BY PRECEDING THE LETTER USED WITH ^^CTRL/\\ (E. G. ^^CTRL/C\\ MEANS THE CHARACTER GENERATED BY DEPRESSING THE ^^CTRL\\ AND ^C KEYS SIMULTANEOUSLY). ^ONLY ^^CTRL/Z\\ AND ^^CTRL/U\\ ARE ECHOED WITH PRINTING CHARACTERS (AS _^^Z AND _^^U). .SKIP 1 ^^NOTE:\\ ^SOME TERMINALS HAVE EXTRA KEYS WHICH MAY SERVE SPECIAL PURPOSES - CONSULT THE TERMINAL USER'S GUIDE FOR A DESCRIPTION OF THESE KEYS. ^ALSO, CERTAIN PROGRAMS MAY USE SPECIAL CHARACTERS IN A DIFFERENT MANNER THAN SPECIFIED HERE - REFER TO THE PROGRAM DESCRIPTION. .SKIP 2 .CENTER ^THE SPECIAL KEYS. .SKIP 1 .NOFILL .TAB STOPS 5 15 .INDEX ^^MCR\\ ^^CTRL/C\\ -ATTRACT ^^MCR\\, SO THAT THE NEXT LINE TYPED .LEFT MARGIN 16 .FILL WILL BE INTERPRETED AS AN ^^MCR\\ COMMAND. ^NOTE THAT IF A TASK IS EXPECTING INPUT FROM THE TERMINAL, THE ^^CTRL/C \\ MUST BE FOLLOWED WITH A CARRIAGE RETURN BEFORE ^^MCR \\ WILL RESPOND. .SKIP 1 .LEFT MARGIN 0 .NOFILL ^^CTRL/O\\ -PRINT/NOPRINT OUTPUT. ^THE FIRST ^^CTRL/O\\ WILL .INDEX OUTPUT #CAUSE PRINTING TO BE DISCARDED, AND THE #SECOND WILL CAUSE PRINTING TO CONTINUE. #^^CTRL/O\\ IS ONLY EFFECTIVE IF THE TERMINAL #HAS BEEN ATTACHED TO THE PROGRAM #SENDING THE OUTPUT (E.G. ^^PIP\\). .SKIP 1 ^^CTRL/R\\ -RETYPE CURRENT LINE ON A NEW LINE, OMITTING .LEFT MARGIN 16 .FILL DELETED CHARACTERS. ^THIS IS USEFUL IF THE ^^RUBOUT\\ KEY HAS BEEN USED. .SKIP 1 .LEFT MARGIN 0 .NOFILL ^^CTRL/S\\ -STOP OUTPUT. ^THIS DIFFERS FROM ^^CTRL/O\\ #IN THAT OUTPUT IS SUSPENDED, NOT DISCARDED. .SKIP 1 ^^CTRL/Q\\ -START OUTPUT. ^UNDOES THE EFFECT OF ^^CTRL/S\\. .SKIP 1 ^^CTRL/U\\ -DELETE THE CURRENT LINE OF INPUT. ^NOTE THAT #THE PROMPT (IF ANY) WILL ^^NOT\\ BE RE-ISSUED. .SKIP 1 ^^CTRL/Z\\ -END-OF-FILE. ^USED TO TERMINATE INPUT TO MANY #PROGRAMS. .SKIP 1 .TEST PAGE 4 ^^RUBOUT\\ -DELETE (AND ECHO) PREVIOUS CHARACTER .INDEX ^^RUBOUT\\ .INDEX DELETE ##(OR ^^DELETE\\) #IN THE INPUT LINE. ^SUCCESSIVE #^^RUBOUT\\S MAY BE USED TO DELETE #SEVERAL CHARACTERS. .SKIP 1 .TEST PAGE 2 ^^ESC\\ -TERMINATE COMMAND LINE AND SUPPRESS ##(OR ^^ALTMODE\\) #FOLLOWING ^^MCR\\ PROMPT. .SKIP 1 ^^CARRIAGE\\ -TERMINATE ^^MCR\\ COMMAND LINE. ^^RETURN\\ .FILL .SKIP 4 .INDEX COMMANDS 2. ^COMMANDS. .PARAGRAPH ^A COMMAND IS GIVEN TO THE COMPUTER BY SENDING A COMMAND LINE TO THE ^MONITOR ^CONSOLE ^ROUTINE (CALLED ^^MCR\\) IN RESPONSE TO A DEFAULT (>) OR EXPLICIT (^^MCR\\>) PROMPT. ^A COMMAND LINE CONSISTS OF THREE PARTS - THE COMMAND NAME, ANY DESIRED COMMAND PARAMETERS, AND A TERMINATOR. .SKIP 1 .LEFT MARGIN 5 .INDENT -5 ^COMMAND NAME: ^^MCR\\ INTERPRETS ALL CHARACTERS FROM THE BEGINNING OF THE LINE TO THE FIRST SPACE, TAB, OR TERMINATOR AS THE COMMAND NAME. ^ONLY THE FIRST THREE CHARACTERS ARE USED TO IDENTIFY THE COMMAND, SO ANY NUMBER OF ALPHANUMERIC CHARACTERS MAY BE APPENDED TO THESE THREE TO IMPROVE THE READABILITY OF THE COMMAND. ^FOR EXAMPLE, ^^ABO\\ OR ^^ABORT\\ HAVE THE SAME EFFECT AS A COMMAND NAME. .SKIP 1 .INDENT -5 ^PARAMETERS: ^THE COMMAND DESCRIPTIONS BELOW INDICATE WHETHER ANY PARAMETERS ARE REQUIRED FOR EACH COMMAND, AND WHAT EFFECT THE PARAMETERS HAVE. .SKIP 1 .INDENT -5 ^TERMINATOR: ^A COMMAND LINE IS TERMINATED BY A CARRIAGE RETURN OR AN ESCAPE OR (^^ALT\\ MODE) KEY. ^IF A CARRIAGE RETURN IS TYPED, ^^MCR\\ WILL INDICATE COMPLETION .INDEX PROMPT OF THE COMMAND BY ISSUING THE DEFAULT PROMPT (>). ^THE ESCAPE KEY SUPPRESSES THIS PROMPT. .LEFT MARGIN 0 .PARAGRAPH ^THE FOLLOWING ARE DESCRIPTIONS OF A SUBSET OF THE ^^RSX\\ COMMAND SET. ^THE EXAMPLES GIVEN ARE FORMATTED TO APPEAR AS THE OUTPUT AT A TERMINAL, SO INPUT LINES ARE PRECEDED WITH THE ">" PROMPT TYPED BY THE SYSTEM. .SKIP 2 .TEST PAGE 5 .INDEX ^^ABO\\ .INDEX ABORT COMMAND .INDEX ABORT ^^ABO\\ (^ABORT) .LEFT MARGIN 10 -USED TO TERMINATE TASK EXECUTION. ^IF NO TASK NAME IS GIVEN, THE TASK NAMED FOR THE ENTERING TERMINAL IS ASSUMED. ^ONLY A PRIVILEGED TERMINAL MAY ABORT TASKS INITIATED FROM ANOTHER TERMINAL. .SKIP 1 .INDENT 5 .NOFILL ^^>ABO TT2\\ !STOP THE TASK ^T^T2. .INDENT 5 ^^>ABO FOR\\ !STOP THE ^^FORTRAN\\ COMPILER. .INDENT 5 ^^>ABO\\ !STOP THE TASK NAMED ^T^TN. .INDENT 5 ^^\\ !(WHERE N IS THE TERMINAL .INDENT 5 ^^\\ !NUMBER.) .SKIP 1 .FILL ^^NOTE:\\ ^THE TERMINAL MAY RESPOND BEFORE THE ABORT HAS BEEN COMPLETED. ^THE ONLY POSITIVE INDICATION OF A COMPLETED ABORT IS THE .INDEX TERMINATION MESSAGE MESSAGE PRINTED AT THE TERMINAL WHICH INITIATED THE TASK. ^IF THIS MESSAGE IS NOT PRINTED, IT COULD BE BECAUSE THE ABORT IS WAITING FOR AN ^I/^O UNIT TO BE MADE READY BEFORE COMPLETING. ^DO NOT PROCEED UNTIL THE MESSAGE HAS BEEN PRINTED. .LEFT MARGIN 0 .FILL .SKIP 2 .INDEX ^^ACT\\ .INDEX ACTIVE TASK ^^ACT\\ (^ACTIVE TASKS) .LEFT MARGIN 10 -USED TO DISPLAY THE NAMES OF ALL CURRENTLY ACTIVE TASKS WHICH WERE INITIATED FROM THE TERMINAL. .SKIP 1 .INDENT 5 ^^>ACT\\ .TAB STOPS 30 .INDENT 5 ^^...MCR !MCR\\ IS ALWAYS ACTIVE. .INDENT 5 ^^...SYS !SYS\\ PRINTS THIS LIST. .INDENT 5 ^^...FOR\\ !^^FORTRAN\\ COMPILER IS RUNNING. .SKIP 2 .INDEX ^^ALL\\ .INDEX ALLOCATE COMMAND .INDEX PRIVATE DEVICE .LEFT MARGIN 0 ^^ALL\\ (^ALLOCATE) .LEFT MARGIN 10 .INDEX DEVICE -USED TO ESTABLISH A DEVICE AS THE USER'S PRIVATE DEVICE. ^THIS PREVENTS OTHER NON-PRIVILEGED USERS FROM ACCESSING THE DEVICE. ^A USER CANNOT ALLOCATE A PUBLIC DEVICE (SUCH AS A LINE PRINTER). ^DEVICES ARE DEALLOCATED EXPLICITLY WITH THE DEALLOCATE COMMAND (^^DEA\\) OR IMPLICITLY WHEN THE USER LOGS OFF THE TERMINAL (SEE ^^BYE\\). .SKIP 1 ^A DEVICE MUST BE ALLOCATED BEFORE A VOLUME MAY BE MOUNTED (SEE ^^MOU\\NT COMMAND). .SKIP 1 .INDENT 5 ^^>ALL MT0:#######!\\MAKE ^^MT0:\\ A PRIVATE DEVICE .SKIP 2 .LEFT MARGIN 0 .INDEX ^^ASN\\ .INDEX ASSIGN COMMAND .INDEX LOGICAL DEVICE .INDEX ASSIGNMENTS ^^ASN\\ (^ASSIGN) .LEFT MARGIN 10 -USED TO DEFINE, DISPLAY, OR DELETE LOGICAL DEVICE ASSIGNMENTS. ^ALL ASSIGNMENTS ARE LOCAL TO A PARTICULAR TERMINAL, SO THIS COMMAND DOES NOT AFFECT USERS ON OTHER TERMINALS. ^IF A LOGICAL NAME IS IDENTICAL TO A PHYSICAL NAME, THE LOGICAL NAME HAS PRECEDENCE. ^ALL ASSIGNMENTS WILL BE DELETED WHEN THE USER LOGS OFF THE TERMINAL (SEE ^^BYE)\\. .BREAK .SKIP 1 A) ^DEFINE: .INDENT 5 .NOFILL ^^>ASN TT1:=BF:\\ !DEFINE ^B^F: .SKIP 1 B) ^DISPLAY: .INDENT 5 ^^>ASN \\ !DISPLAY CURRENT ASSIGNMENTS .INDENT 5 ^^BF: TT1: LOCAL TI - TT0:\\ .SKIP 1 .TEST PAGE 3 C) ^DELETE: .INDENT 5 ^^>ASN =BF:\\ !DELETE DEFINITION OF ^B^F: .INDENT 5 ^^>ASN =\\ !DELETE ALL ASSIGNMENTS. .FILL .LEFT MARGIN 0 .SKIP 2 .TEST PAGE 6 .INDEX ^^BRO\\ .INDEX BROADCAST .INDEX MESSAGES ^^BRO\\ (^BROADCAST) .LEFT MARGIN 10 -USED TO SEND A LINE OF TEXT TO ANOTHER TERMINAL. ^THE RECEIVING TERMINAL MUST BE LOGGED IN. ^THE MESSAGE WILL BE PRINTED ON THE INDICATED TERMINAL, PRECEDED BY THE CURRENT TIME AND THE SENDING TERMINAL'S NAME. .SKIP 1 .INDENT 5 ^^>BRO TT4:DONE WITH TAPE???\\ .SKIP 1 .FILL ^^NOTE:\\ ^TO SEND A MESSAGE TO THE COMPUTER OPERATOR, ^^BRO\\ADCAST TO TERMINAL ^^CO:\\. .LEFT MARGIN 0 .SKIP 2 .INDEX ^^BYE\\ .INDEX ABORT .INDEX DEALLOCATE .INDEX DISMOUNT .INDEX PRIVATE DEVICE .INDEX MOUNTED VOLUME .INDEX SIGN OFF .INDEX LOG OFF ^^BYE\\ .LEFT MARGIN 10 -USED TO SIGN OFF THE SYSTEM. ^^BYE\\ DELETES ALL LOCAL DEVICE ASSIGNMENTS (SEE ^^ASN\\), DISMOUNTS ANY PRIVATE VOLUMES, DEALLOCATES ANY PRIVATE DEVICES, AND ABORTS ANY ACTIVE TASKS INITIATED FROM THE TERMINAL. ^FURTHER USE OF THE TERMINAL IS PREVENTED UNTIL THE ^^HELLO\\ COMMAND IS ISSUED. ^USERS SHOULD ALWAYS ENTER A ^^BYE\\ COMMAND BEFORE LEAVING A TERMINAL. .SKIP 1 .INDENT 5 ^^>BYE\\ .INDENT 5 ^^HAVE A GOOD MORNING\\ .INDENT 5 ^^30-FEB-77 03:35 TT1: LOGGED OFF\\ .FILL .LEFT MARGIN 0 .SKIP 2 .INDEX ^^DEA\\ .INDEX DEALLOCATE .INDEX PRIVATE DEVICE ^^DEA\\ (^DEALLOCATE) .LEFT MARGIN 10 -USED TO RELEASE A PRIVATE (ALLOCATED) DEVICE, SO THAT OTHER USERS MAY ACCESS IT. ^A DEVICE MAY BE DEALLOCATED ONLY FROM THE TERMINAL THAT WAS USED TO ALLOCATE IT (SEE ^^ALL\\OCATE). ^ALL PRIVATE DEVICES ARE DEALLOCATED WHEN THE USER SIGNS OFF (SEE ^^BYE\\). .SKIP 1 .INDENT 5 ^^>DEA MT0:\\ .LEFT MARGIN 0 .SKIP 2 .INDEX ^^DMO\\ .INDEX DISMOUNT COMMAND .INDEX ^^ANSI\\ MAGTAPE .INDEX FILE .INDEX MOUNTED VOLUME ^^DMO\\ (^DISMOUNT) .LEFT MARGIN 10 -USED TO DISMOUNT A MOUNTED VOLUME. ^THIS OPERATION IS ONLY MEANINGFUL FOR FILE-STRUCTURED VOLUMES (DISKS OR ^^ANSI\\ MAG TAPES). ^THERE MAY BE A DELAY IN COMPLETING THE DISMOUNT OPERATION IF ^^I/O\\ OPERATIONS ARE IN PROGRESS ON THE VOLUME. ^IF A MAGNETIC TAPE IS BEING DISMOUNTED, THE VOLUME LABEL MUST BE SPECIFIED. ^A DISMOUNTED TAPE VOLUME WILL BE TURNED OFFLINE. .SKIP 1 .INDENT 5 ^^>DMO MM0:DATA\\ .SKIP 2 .LEFT MARGIN 0 .INDEX ^^HEL\\ .INDEX ^^HELLO\\ .INDEX LOG ON .INDEX SIGN ON .INDEX PASSWORD .INDEX DEFAULT ^^UIC\\ .INDEX USER CODE ^^HEL\\ (^HELLO) .LEFT MARGIN 10 -USED TO LOG ON TO A TERMINAL. ^NO COMMANDS (EXCEPT ^^HELP\\) WILL BE PROCESSED FROM A TERMINAL UNTIL A USER HAS LOGGED IN. ^THE USER IS ASKED FOR A PASSWORD TO CONFIRM HIS AUTHORIZATION, ACCOUNTING INFORMATION IS RECORDED, AND A SYSTEM MESSAGE IS PRINTED. .SKIP 1 ^A USER MAY LOG ON USING AN ALPHABETIC USER CODE OR HIS ^^UIC\\. ^THESE ARE ASSIGNED BY THE SYSTEM MANAGER. .SKIP 1 ^THE EXAMPLES WHICH FOLLOW HAVE OMITTED THE SYSTEM GREETING MESSAGE. ^THIS MESSAGE IDENTIFIES THE SYSTEM VERSION, THE TERMINAL NUMBER, AND THE TIME AND DATE, AND INCLUDES AN INFORMATION MESSAGE. .INDEX TIME .INDEX DATE .SKIP 1 .TAB STOPS 35 .INDENT 5 ^^>HELLO IRVING\\ !USER IDENTIFIES HIMSELF .INDENT 5 ^^PASSWORD:\\ !SYSTEM REQUESTS PASSWORD .SKIP 1 OR .SKIP 1 .INDENT 5 ^^>HEL [100,244]\\ !IDENTIFY USING ^^UIC\\ .INDENT 5 ^^PASSWORD:\\ !STILL NEEDS PASSWORD .SKIP 1 ^^NOTES:\\ .BREAK -THE PASSWORD IS NOT ECHOED. .BREAK -THE SYSTEM MESSAGE MAY BE STOPPED BY TYPING ^^CTRL/O\\, OR BY USING A SLASH (/) INSTEAD OF A COMMA IN THE ^^UIC\\. ^USERS ARE URGED TO READ THIS MESSAGE AT LEAST ONCE A DAY. .LEFT MARGIN 0 .SKIP 2 .INDEX ^^HELP\\ .INDEX INFORMATION COMMAND .INDEX HELP COMMAND ^^HELP\\ (^INFORMATION, PLEASE!) .LEFT MARGIN 10 -USED TO ASK THE SYSTEM FOR INFORMATION. ^A USER WHO HAS DIFFICULTY SIGNING ON SHOULD USE THIS COMMAND. .SKIP 1 .INDENT 5 ^^>HELP\\ .SKIP 1 ^^NOTE:\\ ^ALL FOUR LETTERS OF THIS COMMAND ARE REQUIRED TO DISTINGUISH ^^HELP\\ FROM ^^HELLO\\. .SKIP 2 .LEFT MARGIN 0 .INDEX ^^INI\\ .INDEX INITIALIZE COMMAND .INDEX PRIVATE DEVICE .INDEX FILE .INDEX PRIVATE VOLUME ^^INI\\ (^INITIALIZE VOLUME) .LEFT MARGIN 10 -USED TO INITIALIZE A USER'S VOLUME. ^THE VOLUME MUST BE LOADED ONTO A PRIVATE (ALLOCATED) DEVICE (SEE ^^ALL\\OCATE). ^NOTE THAT TAPE LABELS ARE LIMITED TO 6 CHARACTERS. ^USERS SHOULD CONSULT THE COMPUTER SYSTEM STAFF BEFORE USING THIS COMMAND. .SKIP 1 .INDENT 5 ^^>INI MM0:DATA/DENS=1600\\ .INDENT 5 ^^>INI MT1:ARCHIV\\ .SKIP 1 ^^NOTE:\\ ^ALL FILES ON THE VOLUME WILL BE DESTROYED! .SKIP 2 .LEFT MARGIN 0 .INDEX ^^MOU\\ .INDEX MOUNT COMMAND .INDEX MOUNTED VOLUME .INDEX FILE .INDEX PRIVATE DEVICE .INDEX ^^ANSI\\ MAGTAPE .INDEX MAGNETIC TAPE ^^MOU\\ (^MOUNT) .LEFT MARGIN 10 -USED TO MOUNT A FILE-STRUCTURED VOLUME (DISK OR ^^ANSI\\ STANDARD FORMAT MAGNETIC TAPE) ON A USER'S PRIVATE DEVICE (SEE ^^ALL\\OCATE). ^VOLUMES CAN NOT BE MOUNTED ON DEVICES WHICH ARE NOT PRIVATE. ^VOLUMES WHICH ARE NOT FILE-STRUCTURED CAN NOT BE MOUNTED. .SKIP 1 .LEFT MARGIN 15 ^^>MOU MT1:ARCHIV\\ .BREAK ^^>MOU MM0:DATA/DENS=1600\\ .BREAK ^^>MOU DK1:TEMPSTOR\\ .SKIP 1 .LEFT MARGIN 10 ^^NOTE:\\ ^MANY OPTIONS ARE AVAILABLE WHEN USING A PRIVATE VOLUME. ^CONSULT THE COMPUTER STAFF FOR MORE DETAIL. .SKIP 2 .LEFT MARGIN 0 .INDEX ^^RESUME\\ ^^RESUME\\ .LEFT MARGIN 10 -USED TO CONTINUE EXECUTION OF A SUSPENDED TASK. .SKIP 1 .INDENT 5 ^^>RESUME TT2\\ .SKIP 1 .INDEX SUSPEND ^^NOTE:\\ ^A TASK CAN ONLY BE SUSPENDED BY ITSELF. ^THIS CAN BE DONE USING A SYSTEM CALL WITHIN THE PROGRAM, FOR EXAMPLE, IN ^^FORTRAN: .INDENT 5 .SKIP 1 CALL SUSPND .LEFT MARGIN 0 .SKIP 2 .INDEX ^^RUN\\ ^^RUN\\ .LEFT MARGIN 10 -USED TO RUN A TASK. .INDEX TASK NAME ^THE TASK TO BE RUN IS IDENTIFIED BY ITS FILENAME, AND WILL BE GIVEN THE NAME ^^TT\\N, WHERE N IS THE NUMBER OF THE TERMINAL ISSUING THE COMMAND. .SKIP 1 .INDENT 4 .NOFILL .TAB STOPS 28 ^^>RUN DK2:PROG\\ !GET THE TASK FROM ^^DK2:PROG.TSK\\ .INDENT 4 ^^>RUN $PROG\\ !RUN A SYSTEM PROGRAM .FILL .INDEX ^^TI:\\ .SKIP 1 ^^NOTES: TI:\\ WILL BE ESTABLISHED AS THE TERMINAL FROM WHICH THE TASK WAS RUN. ^THIS COMMAND ONLY ^^REQUESTS\\ THAT A TASK BE RUN, AND IT IS POSSIBLE THAT THE TASK WILL NOT BE STARTED IMMEDIATELY (E.#G. INSUFFICIENT MEMORY). ^IN THIS CASE, WAIT FOR THE ^^TASK\\ (NOT ^^MCR\\) TO RESPOND BEFORE PROCEEDING. ^IT IS IMPOSSIBLE TO ABORT THE TASK UNTIL IT BEGINS .INDEX ABORT TO RUN, AND ATTEMPTING TO ^^RUN\\ IT AGAIN IS POINTLESS. ^PLEASE BE PATIENT AT TIMES LIKE THIS, THE SYSTEM IS PROBABLY BUSY, AND WILL GET TO YOU EVENTUALLY. .LEFT MARGIN 0 .SKIP 2 .INDEX ^^SET\\ .INDEX TERMINAL ^^SET\\ .LEFT MARGIN 10 -USED TO ALTER OR DISPLAY CERTAIN TERMINAL CHARACTERISTICS. ^THIS COMMAND SHOULD BE USED WITH CARE AT A PRIVILEGED TERMINAL, SINCE IT IS POSSIBLE TO INCAPACITATE THE SYSTEM. ^THE GENERAL FORM OF THE ^^SET\\ COMMAND IS: .SKIP 1 .INDENT 5 ^^>SET\\ /KEYWORD=VALUE .SKIP 1 ^ONLY ONE KEYWORD PER COMMAND IS PERMITTED. ^MOST KEYWORDS CAN BE PREFIXED BY ^^NO\\ TO NEGATE OR DISABLE THE FUNCTION OF THE KEYWORD. ^EXCEPTIONS INCLUDE ^^BUF\\, AND ^^UIC\\. ^THE KEYWORDS LISTED BELOW ARE THE ONLY KEYWORDS THAT SHOULD BE USED BY THE GENERAL USER. .SKIP 1 ^IF THE "=VALUE" PART OF THE COMMAND IS OMITTED, ALL TERMINALS WITH THE CHARACTERISTIC DESCRIBED BY THE KEYWORD ARE LISTED. .SKIP 2 .INDENT -6 .INDEX BUFFER SIZE .INDEX LINE LENGTH ^^/BUF\\##A) ^SET OR DISPLAY THE DEFAULT BUFFER SIZE FOR THE SPECIFIED DEVICE. ^A NON-PRIVILEGED USER MAY ONLY ALTER THE BUFFER SIZE OF HIS OWN TERMINAL. ^THE BUFFER SIZE DETERMINES HOW MANY CHARACTERS WILL BE PRINTED PER LINE. .SKIP 1 .INDENT 5 ^^>SET /BUF=TI:\\ !DISPLAY CURRENT SIZE .INDENT 5 ^^BUF=TI0:72. .INDENT 5 ^^>SET /BUF=TI:132.\\ !SET FOR WIDE PAPER .SKIP 2 .INDENT -6 ^^/CRT\\##B) ^CONTROL ^^RUBOUT\\ DISPLAY. .INDEX ^^RUBOUT\\ .INDEX DELETE ^IF A TERMINAL IS A REFRESHED ^^CRT\\ (^CATHODE ^RAY ^TUBE), IT IS POSSIBLE TO ERASE THE LAST CHARACTER WITH A ^^RUBOUT\\ BY ECHOING A BACKSPACE-SPACE-BACKSPACE. ^THIS OPTION IS NOT TOO USEFUL FOR OTHER TERMINALS. .SKIP 1 .LEFT MARGIN 15 .NOFILL ^^>SET /CRT=TI:\\ !THIS TERMINAL IS A ^^CRT\\ ^^>SET /CRT\\ !SHOW ALL ^^CRT\\S ^^CRT=TT1:\\ ^^>SET /NOCRT=TI:\\ !RETURN TO NORMAL .LEFT MARGIN 10 .FILL .SKIP 2 .TEST PAGE 11 .INDEX CASE CONVERSION .INDENT -7 ^^/LOWER\\ .INDEX LOWER CASE C) ^CONTROL OR DISPLAY LOWER CASE CONVERSION. (^TERMINALS NORMALLY CONVERT ALL INPUT TO UPPER CASE, BUT THIS CAN BE CONTROLLED AS SHOWN BELOW.) .NOFILL .LEFT MARGIN 15 .SKIP 1 ^^>SET /LOWER=TI:\\ !DISABLE CONVERSION >SET /NOLOWER=TI: !ENABLE CONVERSION ^^>SET /LOWER\\ !DISPLAY TERMINALS WITH ^^LOWER=TT2:\\ !CASE CONVERSION DISABLED. ^^>SET /NOLOWER\\ !DISPLAY TERMINALS WITH ^^NOLOWER=TT0:\\ !CASE CONVERSION ENABLED. ^^NOLOWER=TT1: ^^NOLOWER=TT3:\\ .SKIP 1 .LEFT MARGIN 10 .TEST PAGE 4 .INDEX ^^UIC\\ .INDEX FILE .SKIP 1 .INDEX DEFAULT ^^UIC\\ .FILL .INDENT -6 ^^/UIC\\##D) ^ESTABLISH OR DISPLAY DEFAULT ^U^I^C. ^NOTE THAT THIS COMMAND DOES NOT AFFECT THE ^^UIC\\ USED TO AUTHORIZE ACCESS TO FILES. ^THIS MEANS THAT A FILE WHICH CAN ONLY BE READ WILL STILL BE READ-ONLY EVEN IF THE DEFAULT ^^UIC\\ IS SET TO THAT OF THE FILE'S OWNER. ^THIS COMMAND IS USEFUL IF MANY REFERENCES ARE TO BE MADE TO ANOTHER USER'S FILES. .SKIP 1 .LEFT MARGIN 15 .NOFILL ^^>SET /UIC=[100,100]\\ !SET DEFAULT ^^UIC\\ ^^>SET /UIC\\ !DISPLAY DEFAULT ^^UIC\\ ^^UIC=[100,100]\\ .FILL .LEFT MARGIN 0 .SKIP 2 .INDEX ^^TIME\\ .INDEX TIME .INDEX DATE ^^TIME\\ .LEFT MARGIN 10 -USED TO DISPLAY CURRENT TIME AND DATE. .INDENT 5 .SKIP 1 ^^>TIME\\ .INDENT 5 13:14:15 29-^^FEB\\-77 .SKIP 4 .LEFT MARGIN 0 3. ^FILES AND ^DEVICES. .INDEX FILE .INDEX DEVICE .INDEX RECORD .INDEX ^I/^O .PARAGRAPH ^THE DEVICES ON A COMPUTER SYSTEM ARE USED TO INPUT, STORE, AND OUTPUT DATA. ^THE DATA ARE ORGANIZED INTO UNITS, CALLED RECORDS, WHICH ARE HANDLED INDIVIDUALLY BY THE COMPUTER SYSTEM. ^THE CHARACTERISTIC OF A RECORD IS THAT ITS TRANSFER IS ACCOMPLISHED WITH A SINGLE OPERATION, SO THAT A RECORD IS THE SMALLEST UNIT OF DATA FOR ^^I/O\\ PURPOSES. ^EXAMPLES OF RECORDS ARE: A LINE OF TEXT TYPED AT A TERMINAL, A STRING OF CO-ORDINATES FROM A DIGITIZER, AND A SEQUENCE OF NUMBERS ON MAGNETIC TAPE. .PARAGRAPH ^MOST DEVICES ARE ABLE TO TRANSFER RECORDS SEQUENTIALLY ONLY, AND THEREFORE CAN BE USED BY ONLY ONE TASK AT A TIME. ^TO PROVIDE MANY SIMULTANEOUS USERS WITH DATA HANDLING FACILITIES WOULD REQUIRE MANY SUCH DEVICES. ^A SOLUTION TO THIS PROBLEM IS A FILE SYSTEM, WHERE MANY AREAS ON A RANDOM-ACCESS DEVICE (USUALLY A DISK) CAN BE ACCESSED SIMULTANEOUSLY, AND A SYSTEM PROGRAM ENSURES THAT EACH TRANSFER IS DIRECTED TO THE PROPER AREA. ^THUS A FILE SYSTEM PROVIDES THE APPEARANCE OF MANY INDIVIDUAL SEQUENTIAL DEVICES. .PARAGRAPH ^A FILE IS A USER-NAMED AREA ON A MASS STORAGE DEVICE (DISK OR MAGNETIC TAPE), CONSISTING OF A COLLECTION OF RECORDS. ^FILES ARE IDENTIFIED BY A FILE SPECIFIER IN THE FOLLOWING FORMAT: .SKIP 1 .CENTER DEV:[G,M]FILENAME.TYP;VER .SKIP 1 .NOFILL ###########E.G. ^^DK1:[231,11]PROGRAM1.FTN;32\\ .SKIP 1 WHERE: .TAB STOPS 12 52 .LEFT MARGIN 12 .NOFILL .INDENT -10 DEV: IS THE PHYSICAL DEVICE ON WHICH THE ##^^DK1:\\ .RIGHT MARGIN 50 .FILL VOLUME CONTAINING THE DESIRED FILE IS MOUNTED. ^THE NAME CONSISTS OF TWO CHARACTERS FOLLOWED BY A ONE OR TWO DIGIT (OCTAL) UNIT NUMBER AND A COLON. ^NOTE THAT THE COLON IS PART OF THE DEVICE NAME. (SEE ^APPENDIX ^D FOR A LIST OF DEVICES ON THIS SYSTEM.) .SKIP 1 .NOFILL .RIGHT MARGIN 60 .INDENT -10 [G,M] IS THE USER IDENTIFICATION CODE (^^UIC\\), [231,11] .INDEX ^^UIC\\ .FILL .RIGHT MARGIN 50 WHICH IDENTIFIES THE DIRECTORY CONTAINING THE FILE. G AND M ARE OCTAL NUMBERS IN THE RANGE 1 TO 377, IDENTIFYING THE GROUP AND THE MEMBER OF THE GROUP, RESPECTIVELY. ^NOTE THAT THE SQUARE BRACKETS ARE PART OF THE ^^UIC\\. .SKIP 1 .RIGHT MARGIN 60 .NOFILL .INDENT -10 FILENAME IS THE NAME OF THE FILE, WHICH MAY BE ^^PROGRAM1\\ .INDEX FILENAME .FILL .RIGHT MARGIN 50 UP TO NINE ALPHANUMERIC CHARACTERS IN LENGTH. .SKIP 1 .RIGHT MARGIN 60 .NOFILL ^FILENAME AND FILE TYPE ARE ALWAYS SEP- ###. .RIGHT MARGIN 50 .FILL ARATED BY A PERIOD, WHICH IS NOT A PART OF EITHER THE FILENAME OR THE FILE TYPE. .SKIP 1 .NOFILL .RIGHT MARGIN 60 .INDENT -10 TYP IS THE FILE TYPE, AND IS USED TO INDI- ##^^FTN\\ .INDEX TYPE .FILL .RIGHT MARGIN 50 CATE THE FORM OF THE FILE. ^FILE TYPE MAY BE UP TO THREE ALPHANUMERIC CHARACTERS, AND WHILE THERE ARE NO RESTRICTIONS ON THE TYPES A USER MAY USE, THERE ARE CERTAIN RECOMMENDED SYSTEM DEFAULTS, FOR EXAMPLE: .RIGHT MARGIN 60 .SKIP 1 .TEST PAGE 6 .RIGHT MARGIN 50 .LEFT MARGIN 20 .NOFILL ^^FTN - FORTRAN\\ SOURCE CODE. ^^OBJ\\ - OBJECT CODE. ^^TSK\\ - TASK IMAGE. ^^DAT\\ - DATA RECORDS. ^^CMD\\ - COMMANDS. ^^TMP\\ - TEMPORARY FILE. .FILL .LEFT MARGIN 12 .SKIP 1 ^A COMPLETE LIST OF PREFERRED SYSTEM FILE TYPES IS INCLUDED IN THE ^^PIP\\ DOCUMENTATION. .SKIP 1 .NOFILL .RIGHT MARGIN 60 ^FILE##TYPE AND VERSION NUMBER ARE SEP- ###; .RIGHT MARGIN 50 .FILL ARATED BY A SEMICOLON, WHICH IS NOT A PART OF EITHER THE TYPE OR THE VERSION NUMBER. .SKIP 1 .RIGHT MARGIN 60 .NOFILL .INDENT -10 VER IS AN OCTAL NUMBER USED TO DIFFERENTI- ##32 .INDEX VERSION .FILL .RIGHT MARGIN 50 ATE AMONG VERSIONS OF A FILE. ^FOR EXAMPLE, A FILE CREATED BY THE EDITOR WOULD HAVE A VERSION NUMBER OF 1. ^IF THE FILE IS EDITED AGAIN, THE ORIGINAL FILE WILL BE KEPT FOR BACKUP, AND THE NEW FILE WILL HAVE THE SAME FILENAME AND TYPE, BUT A VERSION NUMBER OF 2. .RIGHT MARGIN 60 .SKIP 4 .LEFT MARGIN 0 .INDEX UTILITIES 4. ^UTILITIES. .PARAGRAPH ^MANY TASKS ARE AVAILABLE ON THE SYSTEM FOR CONVENIENCE TO THE USER. ^SOME OF THESE TASKS ARE INSTALLED IN THE SYSTEM SO THAT THE USER MAY INVOKE THEM BY TYPING THE TASK NAME (^^PIP, CNT\\), OPTIONALLY FOLLOWED BY AN INPUT STRING (THESE ARE CALLED ^^CUSP\\S, FOR ^COMMONLY ^USED ^SYSTEM ^PROGRAMS). ^OTHER UTILITIES ARE INITIATED USING THE ^^RUN\\ COMMAND, PREFIXING THE UTILITY NAME WITH A $ (E.#G. ^^RUN $EDI\\). .PARAGRAPH ^COMPLETE DOCUMENTATION ON SOME OF THESE TASKS IS AVAILABLE IN THE ^^RSX-11M U\\TILITIES MANUAL, AND IF LOCALLY-WRITTEN SUMMARIES ARE AVAILABLE, THIS IS INDICATED BY TWO ASTERISKS FOLLOWING THE TASK NAME IN THE LIST BELOW. .SKIP 2 .CENTER ^^CUSP\\S. .SKIP 1 .LEFT MARGIN 10 .INDENT -10 .INDEX ^^CNT\\ .INDEX CONTIGUOUS SPACE .INDEX FREE SPACE ^^CNT###**##C\\ONTIGUOUS BLOCK DISPLAY. ^DISPLAYS FREE SPACE AND CONTIGUOUS BLOCKS AVAILABLE ON A DISK. .SKIP 1 .INDEX ^^EDI\\ .INDEX EDITOR .INDEX TEXT FILE .INDENT -10 ^^EDI\\#######^^EDI\\IT-11. ^AN EASY-TO-USE TEXT FILE EDITOR. .SKIP 1 .INDENT -10 ^^FLX\\#######^FILE TRANSFER PROGRAM. ^TRANSFERS DATA TO AND .INDEX ^^FLX\\ FROM MAGNETIC TAPES AND DISKS IN OTHER ^^PDP-11\\ FORMATS. .SKIP 1 .TEST PAGE 2 .INDENT -10 ^^GTL\\#######^^GT40\\ ^LOADER. ^LOADS TASKS INTO THE ^^GT40\\ MEMORY. ^NOTE THAT THESE TASKS MUST BE IN A SPECIAL FORMAT. .SKIP 1 .INDENT -10 .INDEX ^^PIP\\ .INDEX FILE ^^PIP\\#######^PERIPHERAL INTERCHANGE PROGRAM. ^LISTS DIRECTORIES; COPIES, DELETES, RENAMES, SPOOLS, AND CREATES FILES. .SKIP 1 .INDEX ^^PLT\\ .INDEX ^^PDF\\S .INDEX PLOT .INDENT -10 ^^PLT\\#######^HARD COPY ^P^LO^T PRODUCER. ^SENDS PLOT DESCRIPTION FILES (^P^D^FS) TO THE PLOTTER. .SKIP 1 .INDENT -10 ^^RNO###**##\\^RU^N^OFF. ^A TEXT FORMATTING PROGRAM. .INDEX ^^RNO\\ .INDEX RUNOFF .INDEX FORMATTING ^RUNOFF WAS USED TO PRODUCE THIS DOCUMENT. .SKIP 1 .INDEX ^^RPT\\ .INDEX REPLOT .INDENT -10 ^^RPT\\###**##^RE^PLO^T FACILITY. ^PLOTS PLOT DESCRIPTION FILES (^P^D^FS) ON A GRAPHICS TERMINAL. .SKIP 1 .INDEX ^^SRD\\ .INDEX DIRECTORY .INDEX SORT DIRECTORY UTILITY .INDENT -10 ^^SRD\\###**##^SO^RT ^DIRECTORY. ^USED TO PRODUCE DIRECTORY LISTINGS IN ALPHABETICAL ORDER. .SKIP 1 .INDEX ^^TECO\\ .INDEX EDITOR .INDEX TEXT FILES .INDENT -10 ^^TECO\\##**##^TEXT ^EDITOR AND ^C^ORRECTOR. ^A COMPREHENSIVE TEXT PROCESSOR USED TO EDIT FILES CONTAINING TEXT CHARACTERS. .SKIP 3 .LEFT MARGIN 0 .INDEX LANGUAGES .INDEX ^^FORTRAN\\ .INDEX ^^FOCAL\\ .INDEX ^^MACRO\\ 5. ^LANGUAGES. .PARAGRAPH ^THERE ARE TWO TYPES OF LANGUAGES AVAILABLE ON THE ^^RSX\\ SYSTEM - THOSE THAT REQUIRE A TRANSLATION STEP AND A BUILDING STEP BEFORE PROGRAMS MAY BE RUN, AND THOSE THAT RUN IMMEDIATELY. ^THE FIRST TYPE IS GENERALLY MORE EFFICIENT AND MORE VERSATILE, WHILE THE SECOND TYPE IS EASIER TO USE, AND THEREFORE MORE SUITABLE FOR SHORTER PROGRAMS. ^THIS SYSTEM CURRENTLY SUPPORTS TWO LANGUAGES OF THE FIRST TYPE - ^^FORTRAN\\ AND ^^MACRO\\; AND .INDEX ^^BASIC\\ TWO OF THE SECOND - ^^FOCAL\\ AND ^^BASIC\\. .PARAGRAPH ^PROGRAMS WRITTEN IN ^^FORTRAN\\ OR ^^MACRO\\ .INDEX OBJECT .INDEX ^^TKB\\ ARE COMPILED OR ASSEMBLED TO PRODUCE OBJECT FILES WHICH ARE COMBINED USING A TASK BUILDER (^^TKB\\ .INDEX ^^FTB\\ OR ^^FTB\\). ^MANY SEPARATE PROGRAMS AND SUBPROGRAMS IN BOTH LANGUAGES CAN BE COMBINED BY THE TASK BUILDER TO PRODUCE A TASK FILE WHICH MAY BE RUN. ^THIS IS A COMPLEX PROCEDURE, DESCRIBED FULLY IN THE ^^RSX-11M\\ ^TASK ^BUILDER MANUAL, AND SUMMARIZED FOR ^^FORTRAN\\ USERS IN THE ^^FORTRAN\\ USERS' GUIDE. ^^FOR, MAC, TKB,\\ AND ^^FTB\\ ARE INSTALLED AS ^^CUSP\\S. .PARAGRAPH .TEST PAGE 8 ^^FOCAL\\ OR ^^BASIC\\ PROGRAMS ARE TYPED DIRECTLY INTO THE COMPUTER AND ARE EXECUTED IMMEDIATELY. ^CURRENTLY, PROGRAMS WRITTEN IN ^^FOCAL\\ CAN NOT BE SAVED, AND MUST BE RE-ENTERED EACH TIME THEY ARE TO BE RUN, SO THE USEFULNESS OF THIS LANGUAGE IS LIMITED SIMILAR TO A DESK CALCULATOR. ^^BASIC\\ PROGRAMS MAY BE SAVED ON DISK AND RETRIEVED AND UPDATED OR EXECUTED LATER. ^BOTH ^^FOCAL\\ AND ^^BASIC\\ MAY BE INVOKED WITH THE ^^RUN\\ COMMAND, FOR EXAMPLE: .SKIP 1 .CENTER ^^RUN $FOCAL\\ .PAGE .CENTER ^^APPENDIX A.\\ .CENTER ^GLOSSARY OF ^^RSX\\ TERMS. .LEFT MARGIN 5 .SKIP 2 .INDENT -5 ABORT: THE EXECUTION OF A TASK MAY BE TERMINATED BY A COMMAND TO .INDEX ABORT ^^MCR\\ (SEE ^^ABORT\\ COMMAND, SECTION 2) FROM THE TERMINAL THAT INITIATED THE TASK OR FROM A PRIVILEGED TERMINAL. .SKIP 1 .INDENT -5 ACTIVATE: SEE "RUN". .INDEX ACTIVE TASK .SKIP 1 .INDENT -5 ACTIVE: A TASK IS ACTIVE IF IT IS COMPETING FOR SYSTEM RESOURCES. ^NOTE THAT A TASK MAY BE ACTIVE WITHOUT ACTUALLY BEING IN MEMORY, AND THAT A TASK IN MEMORY MAY NOT BE ACTIVE. .INDEX ALLOCATE .INDEX DEALLOCATE .INDEX PRIVATE DEVICE .SKIP 1 .INDENT -5 ALLOCATE, DEALLOCATE: A USER MAY PREVENT OTHER USERS FROM ACCESSING A DEVICE BY ALLOCATING THE DEVICE. ^WHEN A DEVICE HAS BEEN SUCCESSFULLY ALLOCATED TO A USER, IT IS CALLED HIS "PRIVATE" DEVICE, AND ACCESS CAN BE CONTROLLED BY THE USER UNTIL THE DEVICE IS DEALLOCATED. SEE "PUBLIC DEVICE". .SKIP 1 .INDEX ^^ANSI\\ MAGTAPE .INDENT -5 ^^ANSI, ANSI\\ MAGTAPE: ^AMERICAN ^NATIONAL ^STANDARDS ^INSTITUTE, A CLEARINGHOUSE FOR VOLUNTARY STANDARDS. ^THE TAPE FORMAT SUPPORTED BY ^^RSX\\ IS ^^ANSI X3.27-1969.\\ .SKIP 1 .INDENT -5 ASSIGN, ASSIGNMENT: USING THE ASSIGN COMMAND (^^ASN\\), A USER .INDEX ASSIGN .INDEX LOGICAL DEVICE .INDEX DEVICE MAY ASSOCIATE A PHYSICAL DEVICE TO A LOGICAL DEVICE, SO THAT REFERENCES TO THE LOGICAL DEVICE ARE MAPPED TO THE PHYSICAL DEVICE. ^IN THIS WAY, A PROGRAMMER NEED NOT SPECIFY THE ACTUAL DEVICE TO BE USED FOR INPUT OR OUTPUT UNTIL THE PROGRAM IS TO BE RUN. .SKIP 1 .INDENT -5 ATTACH: A TASK MAY WISH TO COMMUNICATE WITH A DEVICE WITHOUT .INDEX ATTACH .INDEX DETACH INTERFERENCE FROM OTHER TASKS. ^TO MAKE THIS POSSIBLE, A TASK CAN "ATTACH" A DEVICE, AND ANY OTHER TASKS NEEDING THE DEVICE MUST WAIT UNTIL THE TASK "DETACHES" BEFORE THEY CAN USE IT. ^ATTACHING/DETACHING IS DONE THROUGH CALLS TO SYSTEM SUBROUTINES. .SKIP 1 .INDENT -5 CHECKPOINT, -ABLE, -ED, -ING: .INDEX CHECKPOINT .INDEX PRIORITY .INDEX MEMORY IN ORDER THAT A TASK OF HIGH PRIORITY MAY RUN WHEN NECESSARY, LOWER PRIORITY TASKS MAY BE STOPPED, THEIR CURRENT STATUS SAVED, REMOVED FROM MEMORY, AND WRITTEN TO DISK. ^WHEN MEMORY BECOMES AVAILABLE AGAIN, THE LOW PRIORITY TASK WILL BE BROUGHT BACK INTO MEMORY, AND EXECUTION WILL CONTINUE. ^THIS PROCESS IS CALLED CHECKPOINTING. ^SINCE DISK SPACE MUST BE ESTABLISHED FOR THE INTERMEDIATE COPY OF THE TASK, ONLY CERTAIN TASKS ARE MADE CHECKPOINTABLE. ^A TASK MAY BE BUILT AS A CHECKPOINTABLE TASK THROUGH COMMANDS TO THE TASK BUILDER (^^TKB\\). .SKIP 1 .INDENT -5 COMMAND FILE: SEE "INDIRECT FILE". .SKIP 1 .INDENT -5 ^^CUSP:\\ ^COMMONLY ^USED ^SYSTEM ^PROGRAM. .INDEX ^^CUSP\\ ^A ^^CUSP\\ IS A TASK WHICH HAS BEEN INSTALLED IN THE SYSTEM SO THAT IT MAY BE RUN SIMPLY BY TYPING IT THREE-LETTER NAME. ^A ^^CUSP\\ MAY ALSO BE GIVEN ONE COMMAND LINE FOLLOWING ITS NAME, IN WHICH CASE IT WILL EXECUTE THE COMMAND AND RETURN TO ^^MCR\\. .SKIP 1 .INDENT -5 DEALLOCATE: SEE "ALLOCATE". .SKIP 1 .INDENT -5 DETACH: SEE "ATTACH". .SKIP 1 .INDENT -5 DIRECTORY: A DIRECTORY IS A SPECIAL TYPE OF FILE CONTAINING .INDEX DIRECTORY .INDEX FILE .INDEX ^^UIC\\ THE NAMES AND LOCATIONS OF OTHER FILES ON THE SAME VOLUME. ^EACH USER OF THE SYSTEM IS GIVEN A DIRECTORY ON EACH DISK HE IS AUTHORIZED TO ACCESS, AND REFERS TO THE DIRECTORY USING A USER IDENTIFICATION CODE (^^UIC\\). ^BY ESTABLISHING A DEFAULT ^^UIC\\ (SEE ^^SET\\ COMMAND, SECTION 2), THE SYSTEM ASSUMES ALL FILE REFERENCES ARE TO FILES CONTAINED IN THE USER'S DIRECTORY. ^THIS ALLOWS MORE THAN ONE USER TO HAVE FILES OF THE SAME NAME, AND RESTRICTS THE LIST OF FILES FOR EACH USER TO THOSE OF INTEREST TO HIM. ^THE DIRECTORY MAY BE EXAMINED USING ^^PIP\\ OR ^^SRD\\. .SKIP 1 .INDENT -5 DISMOUNT: SEE "MOUNT". .SKIP 1 .INDENT -5 DORMANT: A TASK IS SAID TO BE DORMANT WHEN ITS LOCATION .INDEX DORMANT ON THE DISK IS KNOWN TO THE SYSTEM, BUT IT HAS NOT BEEN ACTIVATED BY A ^^RUN\\ COMMAND OR REQUEST. ^A TASK IS MADE DORMANT BY INSTALLING IT. SEE "INSTALL". .SKIP 1 .INDENT -5 DRIVER, DEVICE DRIVER: EACH HARDWARE DEVICE ON THE SYSTEM IS .INDEX DEVICE .INDEX DRIVER CONTROLLED BY A SOFTWARE PROGRAM CALLED A DRIVER. ^IT IS THE DUTY OF THE DRIVER TO INTERPRET INPUT SIGNALS AND PROVIDE THE PROPER OUTPUT SIGNALS TO CONTROL THE DEVICE. .SKIP 1 .INDENT -5 ECHO: EACH CHARACTER TYPED AT A KEYBOARD IS ACTUALLY SENT .INDEX ECHO .INDEX TERMINAL ONLY TO THE COMPUTER. ^THE TERMINAL DEVICE DRIVER (SEE "DRIVER") THEN USUALLY SENDS CONFIRMATION OF THE CHARACTER TO THE OUTPUT PART OF THE TERMINAL. ^THIS CONFIRMATION IS CALLED ECHO, AND MAY BE THE SAME AS THE CHARACTER TYPED, THE UPPER CASE VERSION OF THE CHARACTER, OR A STRING OF CHARACTERS (E.#G.#_^^U FOR ^^CTRL/U\\). .SKIP 1 .INDENT -5 FILE: A FILE IS AN OWNER-NAMED AREA ON A MASS STORAGE DEVICE. .INDEX FILE ^FILES BEHAVE MUCH LIKE DEVICES IN THAT ^I/^O MAY BE DIRECTED TO THEM, BUT THEY ARE MORE DYNAMIC AND FLEXIBLE THAN PHYSICAL DEVICES. SEE "DIRECTORY". .SKIP 1 .INDENT -5 FILENAME, FILE SPECIFIER: SEE ^SECTION 3 - ^FILES AND ^DEVICES. .INDEX FILENAME .SKIP 1 .INDENT -5 INDIRECT FILE, COMMAND FILE: A SEQUENCE OF COMMANDS WHICH IS .INDEX INDIRECT FILE .INDEX COMMAND FILE TO BE REPEATED OFTEN MAY BE ENTERED INTO A FILE CALLED A COMMAND FILE. ^THE ^^RSX\\ SYSTEM PROVIDES A METHOD FOR PASSING THIS SEQUENCE, ONE LINE AT A TIME, TO THE PROPER PROGRAM. ^FULL DOCUMENTATION ON THE INDIRECT FILE PROCESSOR IS AVAILABLE IN THE ^^RSX-11M\\ ^OPERATOR'S ^PROCEDURES MANUAL. .SKIP 1 .INDENT -5 INITIATE: SEE "RUN". .SKIP 1 .INDENT -5 INSTALL: BEFORE A TASK FILE MAY BE LOADED INTO MEMORY AND EXECUTED, THE .INDEX INSTALL SYSTEM MUST BE INFORMED OF ITS EXISTENCE, NAME, LOCATION ON DISK, AND OTHER PARAMETERS NECESSARY TO RUN THE TASK. ^THIS PROCEDURE IS CALLED INSTALLING. ^A TASK MAY BE INSTALLED IN THE SYSTEM PERMANENTLY IF IT IS USED OFTEN, OR TEMPORARILY IF IT IS RUN OCCASIONALLY. ^MOST USER PROGRAMS ARE INSTALLED AUTOMATICALLY BY THE ^^RUN\\ COMMAND, AND REMOVED AFTER COMPLETION. SEE "REMOVE-ON-EXIT". .SKIP 1 .INDENT -5 ^^I/O\\: INPUT/OUTPUT. .INDEX ^I/^O .SKIP 1 .INDENT -5 LABEL: A LABEL IS USED TO IDENTIFY A VOLUME AS IT IS ^^MOU\\NTED. ^THE LABEL IS GIVEN TO THE VOLUME WHEN IT IS ^^INI\\TIALIZED. ^TAPE LABELS MUST BE 6 CHARACTERS OR LESS. SEE ^^MOU\\NT AND ^^INI\\TIALIZE COMMANDS. .SKIP 1 .INDENT -5 LOGICAL DEVICE: A LOGICAL DEVICE IS A NAME WHICH MAY BE .INDEX LOGICAL DEVICE .INDEX DEVICE REFERRED TO BY A PROGRAMMER WHILE DEVELOPING A PROGRAM, AND THEN MAPPED TO ANY DESIRED PHYSICAL DEVICE WHEN THE PROGRAM IS TO BE RUN. SEE "ASSIGN". .SKIP 1 .INDENT -5 LOGICAL UNIT: AN ^^RSX\\ TASK PERFORMS INPUT AND OUTPUT .INDEX UNIT .INDEX ^^LUN\\ .INDEX ^^LUN\\ .INDEX UNITS .INDEX ^I/^O .INDEX LOGICAL UNIT NUMBERS ON A SET OF CONCEPTUAL ENTITIES CALLED LOGICAL UNITS, REFERRED TO IN THE TASK BY NUMBERS. ^THESE UNITS ARE ASSOCIATED WITH PHYSICAL DEVICES BEFORE THE PROGRAM IS RUN. ^THERE IS A DEFAULT MAPPING OF ^^FORTRAN\\ LOGICAL UNIT NUMBERS (^^LUN\\S) TO LOGICAL DEVICES, BUT THIS MAY BE CHANGED USING OPTIONS IN THE TASK BUILDER (^T^K^B). .SKIP 1 .INDENT -5 ^^MCR\\ (^MONITOR ^CONSOLE ^ROUTINE): ^^MCR\\ IS A SPECIAL .INDEX ^^MCR\\ TASK TO WHICH THE SYSTEM PASSES UNSOLICITED INPUT FROM A TERMINAL. ^^MCR\\ MAY ALSO BE SPECIFICALLY REQUESTED BY TYPING ^^CTRL-C\\. ^^MCR\\ INTERPRETS USER COMMANDS, AND IS USED TO RUN TASKS, ABORT TASKS, SET PARAMETERS, DISPLAY SYSTEM INFORMATION, AND SO ON. SEE ^SECTION 2 - ^COMMANDS. .SKIP 1 .INDEX MOUNT .INDEX DISMOUNT .INDEX FILE .INDEX VOLUME .INDENT -5 MOUNT, DISMOUNT: BEFORE FILES ON A FILE-STRUCTURED VOLUME CAN BE ACCESSED, CONTROL INFORMATION MUST BE MADE AVAILABLE TO THE SYSTEM. ^THE PROCEDURE FOR EXTRACTING THIS INFORMATION FROM THE VOLUME IS CALLED "MOUNTING". ^ONCE A VOLUME HAS BEEN MOUNTED, A USER MAY REFER TO FILES ON THE VOLUME BY NAME UNTIL THE VOLUME IS DISMOUNTED. ^TO AVOID CONFUSION, THE OPERATION OF PUTTING THE VOLUME ON THE PHYSICAL DEVICE SHOULD BE REFERRED TO AS "LOADING". .SKIP 1 .INDENT -5 MULTIPROGRAMMING: ALTHOUGH THE CENTRAL PROCESSOR OF THE COMPUTER .INDEX MULTIPROGRAMMING ONLY EXECUTES INSTRUCTIONS FROM ONE TASK AT A TIME, MANY TASKS MAY BE COMPETING FOR EXECUTION. ^IF THE OPERATING SYSTEM IS ABLE TO PASS CONTROL TO ANOTHER TASK WHEN THE CURRENT TASK IS WAITING FOR A SLOW OPERATION TO COMPLETE (USUALLY ^I/^O), THE RESULT IS THE APPEARANCE OF SIMULTANEOUS EXECUTION OF MORE THAN ONE TASK, AND THIS PROCEDURE IS CALLED MULTIPROGRAMMING. .SKIP 1 .INDENT -5 OBJECT CODE, OBJECT FILE: .INDEX OBJECT THE FIRST STEP IN RUNNING A PROGRAM WRITTEN IN A HIGHER-LEVEL LANGUAGE IS THE TRANSLATION FROM THE LANGUAGE THE PROGRAM IS WRITTEN IN TO LOW-LEVEL COMPUTER INSTRUCTIONS. ^THE COMPUTER INSTRUCTIONS ARE REFERRED TO AS OBJECT CODE AND ARE STORED IN AN OBJECT FILE. SEE "SOURCE CODE", "TASK", "PROGRAM". .SKIP 1 .INDENT -5 PARTITIONS: A PARTITION IS A CONTIGUOUS AREA OF MEMORY, .INDEX PARTITION .INDEX MEMORY IDENTIFIED BY A NAME. ^EACH TASK TO BE RUN IS ASSIGNED TO A PARTITION, AND COMPETES WITH OTHER TASKS ASSIGNED TO THAT PARTITION FOR SPACE WITHIN IT. ^THUS A TASK CAN BE GUARANTEED TO HAVE MEMORY SPACE AVAILABLE IF A PARTITION IS SET ASIDE FOR IT ALONE. ^MOST USER PROGRAMS COMPETE FOR SPACE IN ONE LARGE PARTITION, WHICH IS DIVIDED UP BY THE SYSTEM DYNAMICALLY FOR AS MANY TASKS AS POSSIBLE. .SKIP 1 .INDENT -5 ^^PDF\\ (^PLOT ^DESCRIPTION ^FILE): .INDEX ^^PDF\\ .INDEX PLOT WHEN A PICTURE IS TO BE SAVED, A DESCRIPTION OF THE PRIMITIVE COMPONENTS OF THE PICTURE (LINES, CHARACTERS, ETC.) IS STORED ON A DISK IN A PLOT DESCRIPTION FILE. ^THIS FILE CAN LATER BE PLOTTED, TRANSFORMED, OR MERGED WITH OTHER ^P^D^FS. .SKIP 1 .INDENT -5 PERIPHERAL: .INDEX PERIPHERAL A PERIPHERAL IS A HARDWARE DEVICE ATTACHED TO THE COMPUTER SYSTEM OTHER THAN THE MEMORY OR THE CENTRAL PROCESSOR. .SKIP 1 .INDENT -5 ^^PIP\\ (^PERIPHERAL ^INTERCHANGE ^PROGRAM): .INDEX ^^PIP\\ .INDEX FILE A SYSTEM UTILITY USED FOR MANAGING AND TRANSFERRING FILES. .SKIP 1 .INDENT -5 PRIORITY: A TASK COMPETING FOR RESOURCES IS ASSIGNED A PRIORITY .INDEX PRIORITY IN THE RANGE 1-250. ^A TASK IS RUN ONLY WHEN ALL HIGHER PRIORITY TASKS ARE COMPLETE OR HELD UP FOR ^I/^O. .SKIP 1 .INDENT -5 PRIVATE DEVICE: SEE "ALLOCATE". .SKIP 1 .INDENT -5 PRIVILEGED TERMINAL, PRIVILEGED COMMANDS: .INDEX PRIVILEGE .INDEX TERMINAL IN ORDER TO PROVIDE ADEQUATE CONTROL OVER THE OPERATING SYSTEM, CERTAIN POWERFUL COMMANDS MUST BE AVAILABLE. ^IN ORDER THAT THESE COMMANDS ARE NOT INADVERTENTLY MISUSED, THEIR USE IS RESTRICTED TO SPECIFIC TERMINALS, CALLED PRIVILEGED TERMINALS. ^USERS AT PRIVILEGED TERMINALS SHOULD BE AWARE OF THE HAVOC THEY MAY WREAK. .SKIP 1 .INDENT -5 PROGRAM: .INDEX PROGRAM A PROGRAM IS A SEQUENCE OF COMPUTATIONAL STEPS, USUALLY TO BE PERFORMED BY A COMPUTER. SEE "TASK". .SKIP 1 .INDENT -5 PROMPT: .INDEX PROMPT .INDEX TERMINAL .INDEX ATTACH WHEN A TASK REQUESTS INPUT FROM A TERMINAL, THE TERMINAL SHOULD BE ATTACHED BY THE TASK, SO THAT UNINTERRUPTED INPUT IS GUARANTEED. ^TO INDICATE THIS TO THE USER AT THE TERMINAL, A STRING OF CHARACTERS IDENTIFYING THE TASK IS USUALLY PRINTED. ^THIS STRING OF CHARACTERS IS CALLED A PROMPT, AND ALLOWS A USER TO RUN MORE THAN ONE TASK, YET ENSURE THAT INPUT IS GIVEN TO THE PROPER TASK. ^THE STANDARD ^^RSX\\ PROMPT IS "^^XXX\\>", WHERE ^^XXX\\ IS THE TASK'S NAME. .SKIP 1 .INDENT -5 PSEUDO DEVICES (^^CL:, CO:, TI:, SY:\\): .INDEX PSEUDO .INDEX DEVICE .INDEX TERMINAL A PSEUDO DEVICE IS A DEVICE NAME WHICH IS REDIRECTED AS NECESSARY TO A PHYSICAL DEVICE. ^FOUR PSEUDO DEVICES EXIST ON THIS SYSTEM: .LEFT MARGIN 15 .SKIP 1 .INDENT -5 ^^CO:\\ - CONSOLE OUTPUT. ^USED TO SEND MESSAGES TO THE SYSTEM OPERATOR. .INDENT -5 ^^CL:\\ - CONSOLE LISTING. ^USED FOR LONGER OUTPUT DIRECTED TO THE SYSTEM STAFF. .INDENT -5 ^^SY\\: - SYSTEM DISK. ^CONTAINS THE DISK IMAGE OF THE OPERATING SYSTEM, AND CERTAIN SYSTEM TASKS. .INDENT -5 ^^TI:\\ - TERMINAL INPUT. ^ESTABLISHED FOR EACH TASK AS THE TERMINAL FROM WHICH IT WAS ^^RUN.\\ ^NOTE THAT THIS DEVICE MAY BE USED FOR OUTPUT TO THE TERMINAL AS WELL. .LEFT MARGIN 5 .SKIP 1 .INDENT -5 PUBLIC DEVICE: .INDEX PUBLIC DEVICE .INDEX PRIVATE DEVICE .INDEX ALLOCATE SOME DEVICES MUST BE AVAILABLE TO MANY USERS SIMULTANEOUSLY. ^IN ORDER TO PREVENT A USER FROM ALLOCATING SUCH A VOLUME AS HIS PRIVATE DEVICE, AND SO RESTRICTING ACCESS TO IT, THE VOLUME IS MADE "PUBLIC". ^NO USER CAN ALLOCATE A PUBLIC DEVICE. SEE "ALLOCATE". .SKIP 1 .INDENT -5 REMOVE-ON-EXIT: .INDEX REMOVE ON EXIT IF A TASK WAS INSTALLED TEMPORARILY AS A RESULT OF A ^^RUN\\ COMMAND, IT WILL BE REMOVED FROM THE SYSTEM WHEN IT EXITS (EVEN IF IT IS ABORTED). .SKIP 1 .INDENT -5 RUN: .INDEX RUN .INDEX INITIATE TO INITIATE THE EXECUTION OF A TASK BY REQUESTING THAT IT BE ALLOWED TO COMPETE FOR SYSTEM RESOURCES, A ^^RUN\\ COMMAND (OR REQUEST) MUST BE ISSUED. ^IF THE TASK MUST BE INSTALLED, IT WILL BE REMOVED ON EXIT. .SKIP1 .INDENT -5 SOLICITED INPUT: .INDEX SOLICITED .INDEX UNSOLICITED .INDEX TERMINAL .INDEX ^^MCR\\ WHEN INPUT FROM A TERMINAL HAS BEEN EXPLICITLY REQUESTED BY A TASK, ANY INPUT ENTERED AT THE TERMINAL IS REFERRED TO AS SOLICITED INPUT, AND IS SENT TO THE TASK. ^IF NO TASK HAS REQUESTED INPUT, ANY CHARACTERS TYPED ARE REFERRED TO AS UNSOLICITED INPUT, AND ARE PASSED TO ^^MCR\\ TO BE INTERPRETED. ^NOTE THAT ^^MCR\\ ATTACHES THE TERMINAL AFTER THE FIRST CHARACTER IS TYPED, SO NO FURTHER TERMINAL ACTIVITY IS POSSIBLE UNTIL THE UNSOLICITED INPUT LINE IS TERMINATED (WITH A CARRIAGE RETURN). .SKIP 1 .INDENT -5 SOURCE CODE, SOURCE FILE: .INDEX SOURCE THE TEXT OF A PROGRAM AS WRITTEN BY THE PROGRAMMER IS REFERRED TO AS SOURCE CODE AND IS STORED IN A SOURCE FILE. ^SOURCE CODE IS USUALLY SUBMITTED TO A TRANSLATOR FOR CONVERSION INTO OBJECT CODE. SEE "OBJECT CODE". .SKIP 1 .INDENT -5 SPOOL: .INDEX SPOOL .INDEX OUTPUT LITERALLY MEANS ^SIMULTANEOUS ^PERIPHERAL ^OPERATION ^ON-^LINE. ^THIS TERM REFERS TO THE OPERATION OF AN INPUT OR OUTPUT TRANSFER WHICH OCCURS ASYNCHRONOUSLY WITH RESPECT TO THE TASK WHICH INITIATES IT. ^FOR EXAMPLE, OUTPUT TO THE LINE PRINTER MAY BE STORED ON DISK TO BE PRINTED WHEN THE PRINTER IS AVAILABLE. ^THUS MORE THAN ONE TASK PRODUCING LINE PRINTER OUTPUT MAY RUN SIMULTANEOUSLY, AND THEIR OUTPUTS WILL BE PRODUCED SEQUENTIALLY LATER ON. .SKIP 1 .INDENT -5 TASK: .INDEX TASK .INDEX PROGRAM A TASK IS A COMPLETE SET OF INSTRUCTIONS IN MACHINE FORMAT, READY TO BE EXECUTED BY THE COMPUTER. ^WHILE IT IS OFTEN SAID THAT A USER "RUNS A PROGRAM", WHAT IS ACTUALLY RUN IS THE TASK BUILT FROM THE TRANSLATED PROGRAM SEGMENTS. SEE "PROGRAM". .SKIP 1 .INDENT -5 TYPE (AS IN FILE TYPE): SEE ^SECTION 3 - ^FILES AND ^DEVICES. .SKIP 1 .INDENT -5 ^^UIC\\ (^USER ^IDENTIFICATION ^CODE): .INDEX ^^UIC\\ .INDEX USER .INDEX FILE A PAIR OF OCTAL NUMBERS WHICH IDENTIFY AN INDIVIDUAL USER. ^THE FIRST NUMBER IDENTIFIES A GROUP OF USERS WHO MAY WISH TO SHARE FILES, AND THE SECOND NUMBER IDENTIFIES THE INDIVIDUAL WITHIN THE GROUP. ^^UIC\\S ARE ALLOCATED BY THE SYSTEM MANAGER. .SKIP 1 .INDENT -5 UNSOLICITED INPUT: SEE "SOLICITED INPUT". .SKIP 1 .INDENT -5 VERSION NUMBER: SEE ^SECTION 3 - ^FILES AND ^DEVICES. .SKIP 1 .INDENT -5 VOLUME: A VOLUME IS A PHYSICAL UNIT WHICH MAY CONTAIN DATA, SUCH .INDEX VOLUME AS A DISK OR A MAGNETIC TAPE. .LEFT MARGIN 0 .PAGE .CENTER ^^APPENDIX B.\\ .TAB STOPS 5 40 51 .CENTER ^DOCUMENTATION AVAILABLE. .PARAGRAPH ^THIS IS A LIST OF LOCALLY WRITTEN AND/OR MAINTAINED DOCUMENTATION FOR THE ^^RSX-11M\\ SYSTEM AND ITS UTILITIES. ^AN UP-TO-DATE COPY OF THIS ^APPENDIX IS MAINTAINED ON DISK IN A FILE CALLED ^^DK1:[100,6]DOCS.DOC\\. ^USERS ARE ENCOURAGED TO CHECK THIS LIST REGULARLY, TO SEE IF CHANGES HAVE BEEN MADE TO ANY DOCUMENTS RELEVANT TO THEIR WORK. ^DOCUMENTS WHICH HAVE CHANGED RECENTLY WILL USUALLY BE AVAILABLE ON DISK, AND COPIES MAY BE GENERATED USING ^^RUNOFF\\. ^PAPER COPIES OF MORE STABLE DOCUMENTS ARE AVAILABLE FROM ^MARK. .SKIP 1 .NOFILL ^NAME ^LENGTH ^LAST ^CHANGE .TAB STOPS 42 50 .SKIP 1 ^^CNT\\ ^USERS MANUAL. 1 1-^^NOV\\-76 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -USE OF THE CONTIGUOUS BLOCK SCAN UTILITY (^^CNT\\). .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^DBMGEN\\ ^USERS MANUAL. 4 1-^^NOV\\-76 .LEFT MARGIN 5 .RIGHT MARGIN 40 .FILL -USE OF THE CALIBRATION TABLE PROCESSING PROGRAM (^^DBMGEN\\). .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^DEVICES. 1 23-^^MAY\\-77 .INDEX DEVICE .LEFT MARGIN 5 .RIGHT MARGIN 40 .FILL -A LIST OF DEVICES AVAILABLE ON THE SYSTEM. (UP-TO-DATE VERSION OF ^APPENDIX ^D OF THE ^INTRODUCTION TO AN ^^RSX\\ ^TERMINAL) .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^DTZ\\ ^USERS MANUAL. 2 1-^^NOV\\-76 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -USE OF THE DIGITIZER TO CREATE ^^PDF\\S. .INDEX ^^PDF\\ .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^FACILITIES AVAILABLE. 4 1-^^NOV\\-76 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -A DESCRIPTION OF THE HARDWARE AND SOFTWARE AVAILABLE. .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^GRAPHICS ROUTINES. 14 1-^^NOV\\-76 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -^^FORTRAN\\ CALLABLE SUBROUTINE LIBRARY FOR WRITING GRAPHICS PROGRAMS. .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^GRPLBR\\ DESCRIPTION. 5 19-^^JAN\\-77 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -SOME AUXILIARY GRAPHICS ROUTINES .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^HIRSCH\\-A USER'S MANUAL. 1 6-^^JAN\\-77 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -USE OF ^HIRSCH CLOUD MODEL .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^INTRODUCTION TO AN ^^RSX\\ ^TERMINAL. 29 23-^^MAY\\-77 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -BRIEF SUMMARY OF THE USE OF AN ^^RSX\\ TERMINAL. .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^LMAR76\\-A USER'S MANUAL. 1 6-^^JAN\\-77 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -USE OF ^^LMA\\ CLOUD MODEL .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^QUOTE\\ - TELETYPE OUTPUT ROUTINES. 5 1-^^NOV\\-76 .INDEX OUTPUT .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -QUICK AND DIRTY TELETYPE OUTPUT ROUTINES. .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^RADAR DATA ROUTINES. 19 12-^^MAY\\-77 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -RADAR DATA TAPE ACCESS ROUTINES. .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^RAD76\\-A USER'S MANUAL. 1 6-^^JAN\\-77 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -USE OF MOBILE RADIOSONDE DATA PROCESSOR .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^RPT\\ - ^REPLOT UTILITY. 2 1-^^NOV\\-76 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -FACILITY FOR REPLOTTING ^^PDF\\S STORED ON DISK. .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^RNO\\- ^RUNOFF. 14 1-^^NOV\\-76 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -TEXT FORMATTING SYSTEM USERS MANUAL. .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^SRD\\ -^SORT DIRECTORY. 4 1-^^NOV\\-76 .INDEX DIRECTORY .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -DIRECTORY LISTING AND SORTING UTILITY. .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 ^^TECO\\ 56 1-^^NOV\\-76 .RIGHT MARGIN 40 .LEFT MARGIN 5 .FILL -TEXT EDITOR. .LEFT MARGIN 0 .RIGHT MARGIN 60 .NOFILL .SKIP 1 .PAGE .FILL .CENTER ^^APPENDIX C.\\ .CENTER ^SAMPLE TERMINAL SESSION. .SKIP 1 ^THIS EXAMPLE IS INTENDED TO DEMONSTRATE A FEW OF THE COMMON ACTIVITIES PERFORMED AT AN ^^RSX\\ TERMINAL. ^USER INPUT IS SHOWN IN LOWER CASE. .SKIP 2 .NOFILL .TAB STOPS 28 >HELLO IRVING SIGN ON TO SYSTEM ^^PASSWORD:\\ PASSWORD IS NOT ECHOED >EDI REQUEST THE FILE EDITOR. ^^EDI>\\DK2:PROG.FTN IN RESPONSE TO THE PROMPT, SPECIFY FILE NAME. ^^[CREATING NEW FILE]\\ ^SINCE THIS IS A NEW FILE, THE ^^INPUT\\ EDITOR ASSUMES INPUT MODE, INTEGER A,B ^USER ENTERS PROGRAM. I=1 (SEE ^^EDIT-11\\ MANUAL FOR FULL . DESCRIPTION OF . EDITOR COMMANDS . AND TECHNIQUES.) *EX LEAVE THE EDITOR. .INDEX ^^FOR\\ >FOR PROG,TI:=DK2:PROG COMPILE THE PROGRAM, WITH A LISTING ON THE TERMINAL. .INDEX ^^TKB\\ >TKB DK2:PROG/FP/CP=PROG BUILD A TASK (/FP AND /CP ARE RECOMMENDED SWITCHES). >RUN DK2:PROG RUN THE PROGRAM. PROGRAM OUTPUT WOULD BE HERE ^^TT4 - STOP\\ TASK TERMINATION MESSAGE. >BYE LEAVE THE SYSTEM. .FILL .SKIP 2 ^^NOTES:\\ .SKIP 1 .INDEX DEFAULT TYPE ^THE FILE TYPES USED IN THIS EXAMPLE ARE ALL SYSTEM STANDARD DEFAULTS, AND THEREFORE USUALLY DO NOT NEED TO BE SPECIFIED. ^SINCE THE EDITOR DOES NOT KNOW WHAT TYPE OF FILE WILL BE USED, THE FULL FILENAME AND TYPE ARE SUPPLIED WHEN THE FILE IS CREATED. ^THE ^^FORTRAN\\ COMPILER EXPECTS AN INPUT FILE OF TYPE .^^FTN\\, SO THE FILE TYPE IS NOT NECESSARY FOR THE INPUT FILE, AND, SINCE NO FILE TYPE WAS SPECIFIED FOR OUTPUT, THE COMPILER CREATES A FILE OF DEFAULT TYPE .^^OBJ\\. ^THIS FILE WILL BE ON THE DEFAULT SYSTEM DISK, SINCE NO DISK WAS NAMED. ^THE TASK BUILDER EXPECTS AN INPUT FILE OF TYPE .^^OBJ\\, AND CREATES A FILE OF DEFAULT TYPE .^^TSK\\ AS OUTPUT. ^AT THE END OF THE SESSION, THERE ARE THREE FILES ON DISK, ALL WITH FILE NAME ^^PROG\\. ^THEY ARE: .SKIP 1 .NOFILL .TAB STOPS 16 ^^DK2:PROG.FTN\\ -SOURCE FILE. ^^DK1:PROG.OBJ\\ -OBJECT FILE. ^^DK2:PROG.TSK\\ -TASK IMAGE FILE, WHICH MAY BE ^^RUN\\. .PAGE .FILL .CENTER ^^APPENDIX D.\\ .CENTER ^DEVICES AVAILABLE. .INDEX DEVICE .SKIP 2 ^ALL DEVICES LISTED BELOW MAY BE TREATED AS PHYSICAL DEVICES ON THE SYSTEM, SINCE REFERENCES TO THE PSEUDO DEVICES ARE MAPPED TO THE APPROPRIATE PHYSICAL DEVICES AUTOMATICALLY. .SKIP 2 .TAB STOPS 10 .NOFILL ^^CO:\\ CONSOLE OUTPUT (PSEUDO DEVICE). ^^CL:\\ CONSOLE LISTING (PSEUDO DEVICE). .SKIP 1 ^^DK0: _\ DK1:\\ > CARTRIDGE DISK SYSTEM. ^^DK2: / .SKIP 1 ^^GP0:\\ ^^GRAF/PEN\\ DIGITIZER. ^^GP1:\\ INTERFACE TO DISTROMETER CASSETTE READER. ^^GT40:\\ SPECIAL INTERFACE TO ^^GT40\\ TERMINAL. ^^LP0:\\ PRINTER/PLOTTER. ^^LP1:\\ LINE PRINTER. ^^MM0:\\ DOUBLE DENSITY TAPE DRIVE. .SKIP 1 ^^MT0: MT1:\\ MAGNETIC TAPE DRIVES. .SKIP 1 ^^NL0:\\ NULL DEVICE. ^^SY0:\\ SYSTEM DISK (PSEUDO DEVICE). ^^TI0:\\ TERMINAL INPUT (PSEUDO DEVICE). .SKIP 1 ^^TT0: _\ TT1: ! TT2: ! TT3:\\ > TERMINALS. ^^TT4: ! TT5: ! TT6: / .FILL .PAGE .CENTER ^^APPENDIX E\\ .CENTER ^^RSX\\ ^ERROR CODES. .INDEX ERROR CODES .SKIP 1 .PARAGRAPH ^ERRORS ARE REPORTED BY THE ^^RSX\\ SYSTEM USING A NUMERICAL CODE SYSTEM. ^THIS APPENDIX CONTAINS A LIST OF THESE CODES AND A SHORT EXPLANATION OF EACH CODE. .SKIP 2 ^FILE CONTROL SYSTEM (^^FCS\\) ERROR CODES. .SKIP 1 ^THESE ERRORS ARE REPORTED TO THE USER IN THE ^^FDB\\, AND PRINTED BY THE ^^FORTRAN OTS\\. ^THE ^^FORTRAN\\ ERROR MESSAGE IS IN THE FORM: .SKIP 1 ^^FCS: -24 0 FILENAME 4\\ .SKIP 1 WHERE THE ERROR CODE IS THE FIRST NUMBER PRINTED (-24 IN THE EXAMPLE). ^THE REMAINING INFORMATION ON THIS LINE IS AN ERROR TYPE INDICATOR (0 INDICATES AN ^^FCS\\ ERROR), THE FILENAME OF THE FILE (NOT INCLUDING TYPE OR VERSION), AND THE LOGICAL UNIT ON WHICH THIS ERROR OCCURRED. .SKIP 1 .NOFILL ^DECIMAL ^OCTAL ^SIGNIFICANCE .SKIP 1 - 1 377 ^BAD PARAMETERS - 2 376 ^INVALID FUNCTION CODE - 3 375 ^DEVICE NOT READY - 4 374 ^PARITY ERROR ON DEVICE - 5 373 ^HARDWARE OPTION NOT PRESENT - 6 372 ^ILLEGAL USER BUFFER - 7 371 ^DEVICE NOT ATTACHED - 8 370 ^DEVICE ALREADY ATTACHED - 9 367 ^DEVICE NOT ATTACHABLE -10 366 ^END OF FILE DETECTED -11 365 ^END OF VOLUME DETECTED -12 364 ^WRITE ATTEMPTED TO LOCKED UNIT -13 363 ^DATA OVERRUN -14 362 ^SEND/RECEIVE FAILURE -15 361 ^REQUEST TERMINATED -16 360 ^PRIVILEGE VIOLATION -17 357 ^SHARABLE RESOURCE IN USE -18 356 ^ILLEGAL OVERLAY REQUEST -19 355 ^ODD BYTE COUNT (OR VIRTUAL ADDRESS) -20 354 ^LOGICAL BLOCK NUMBER TOO LARGE -21 353 ^INVALID ^^UDC\\ MODULE # -22 352 ^^UDC\\ CONNECT ERROR -23 351 ^CALLER'S NODES EXHAUSTED -24 350 ^DEVICE FULL -25 347 ^INDEX FILE FULL -26 346 ^NO SUCH FILE -27 345 ^LOCKED FROM READ/WRITE ACCESS -28 344 ^FILE HEADER FULL -29 343 ^ACCESSED FOR WRITE -30 342 ^FILE HEADER CHECKSUM FAILURE -31 341 ^ATTRIBUTE CONTROL LIST FORMAT ERROR -32 340 ^FILE PROCESSOR DEVICE READ ERROR -33 337 ^FILE PROCESSOR DEVICE WRITE ERROR -34 336 ^FILE ALREADY ACCESSED ON ^^LUN\\ -35 335 ^FILE ^^ID\\, FILE NUMBER CHECK -36 334 ^FILE ^^ID\\, SEQUENCE NUMBER CHECK -37 333 ^NO FILE ACCESSED ON ^^LUN\\ -38 332 ^FILE WAS NOT PROPERLY CLOSED -39 331 ^OPEN - NO BUFFER SPACE AVAILABLE FOR FILE -40 330 ^ILLEGAL RECORD SIZE -41 327 ^FILE EXCEEDS SPACE ALLOCATED, NO BLOCKS -42 326 ^ILLEGAL OPERATION ON FILE DESCRIPTOR BLOCK -43 325 ^BAD RECORD TYPE -44 324 ^ILLEGAL RECORD ACCESS BITS SET -45 323 ^ILLEGAL RECORD ATTRIBUTES BITS SET -46 322 ^ILLEGAL RECORD NUMBER - TOO LARGE -47 321 (UNUSED) -48 320 ^RENAME - 2 DIFFERENT DEVICES -49 317 ^RENAME - NEW FILE NAME ALREADY IN USE -50 316 ^BAD DIRECTORY FILE -51 315 ^CAN'T RENAME OLD FILE SYSTEM -52 314 ^BAD DIRECTORY SYNTAX -53 313 ^FILE ALREADY OPEN -54 312 ^BAD FILE NAME -55 311 ^BAD DEVICE NAME -56 310 ^BAD BLOCK ON DEVICE -57 307 ^ENTER - DUPLICATE ENTRY IN DIRECTORY -58 306 ^NOT ENOUGH STACK SPACE (^^FCS\\ OR ^^FCP\\) -59 305 ^FATAL HARDWARE ERROR ON DEVICE -60 304 ^FILE ^^ID\\ WAS NOT SPECIFIED -61 303 ^ILLEGAL SEQUENTIAL OPERATION -62 302 ^END OF TAPE DETECTED -63 301 ^BAD VERSION NUMBER -64 300 ^BAD FILE HEADER -65 277 ^DEVICE OFF LINE -66 276 ^BLOCK CHECK OR ^^CRC\\ ERROR -67 275 (UNUSED) -68 274 ^NO SUCH NODE -69 273 ^PATH LOST TO PARTNER -70 272 ^BAD LOGICAL BUFFER -71 271 ^TOO MANY OUTSTANDING MESSAGES -72 270 ^NO DYNAMIC SPACE AVAILABLE -73 267 ^CONNECTION REJECTED -74 266 ^TIMEOUT ON REQUEST -75 265 ^FILE EXPIRATION DATE NOT REACHED -76 264 ^BAD TAPE FORMAT -77 263 ^NOT ^^ANSI 'D'\\ FORMAT BYTE COUNT -78 262 ^NOT A NETWORK ^^LUN\\ -79 261 ^TASK NOT LINKED TO SPECIFIED ^^ICS/ICR\\ INTERRUPTS -80 260 ^SPECIFIED TASK NOT INSTALLED -81 257 ^DEVICE OFFLINE WHEN OFFLINE REQUEST WAS ISSUED -82 256 ^INVALID ESCAPE SEQUENCE -83 255 ^PARTIAL ESCAPE SEQUENCE -84 254 ^ALLOCATION FAILURE -85 253 ^UNLOCK ERROR .FILL .SKIP 2 ^MAGNETIC TAPE MOUNT ERROR CODES. .INDEX MOUNT .INDEX MAGNETIC TAPE .SKIP 1 ^THESE ERRORS ARE GENERATED WHILE MOUNTING ^^ANSI\\ FILE-STRUCTURED MAGNETIC TAPE VOLUMES, AND ARE REPORTED AFTER A ^^MOU\\NT COMMAND, IN THE FORM: .SKIP 1 ^^MOU -- MOUNT ERROR ACP\\ NNN .SKIP 1 WHERE NNN IS THE ERROR NUMBER. .SKIP 1 .TAB STOPS 5 16 ^DECIMAL VALUE ^MEANING .NOFILL 6 ^GET COMMAND LINE ERROR 7 ^SYNTAX ERROR 8 ^BAD DEVICE 11 ^WRONG VOLUME (INCORRECT LABEL) 12 ^ALL UNITS MUST BE ^T^U16S 13 ^NOT ^^ANSI\\ FORMAT 17 ^PRIVILEGE VIOLATION 18 ^MIXED 9 AND 7 TRACK 19 ^MESSAGE TASK (^^F11MSG\\) NOT INSTALLED. .FILL .PAGE \\ .CENTER ^INDEX. .PRINT INDEX