.;MONGEN.RNO 1-20-71 MT .SPACING 1 .TITLE ^^MONGEN\\ ^^PROGRAMMING SPECIFICATION\\ .BLANK 5 .CENTER ^^MONGEN\\ .BLANK 1 .CENTER ^^THE PROGRAM FOR DEFINING A PDP-10 MONITOR .CENTER HARDWARE AND SOFTWARE CONFIGURATION .BLANK 15 .LEFT MARGIN 20 \\ ^DATE:##4-^MAR.-71 .BREAK ^FILE:##^^MONGEN.RNO\\ .BREAK ^EDITION:#3.0 .BLANK 15 .LEFT MARGIN 8 .RIGHT MARGIN 55 .FILL .JUSTIFY ^THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY ^DIGITAL ^EQUIPMENT ^CORPORATION. .BLANK 1 ^ACTUAL DISTRIBUTION OF THE SOFTWARE CONTAINED IN THIS SPECIFICATION WILL BE SUBJECT TO TERMS AND CONDITIONS TO BE ANNOUNCED AT SOME FUTURE DATE BY ^DIGITAL ^EQUIPMENT ^CORPORATION. .LEFT MARGIN 10 .RIGHT MARGIN 60 .PAGE .FIGURE 10 .CENTER ^^TABLE OF CONTENTS\\ .CENTER ----------------- .BLANK 2 .SPACING 2 .NOFILL .NOJUSTIFY .TAB STOPS 16 ^^1.0 INTRODUCTION 2.0 PROCEDURE FOR CREATING A NEW MONITOR 2.1 MONGEN STARTUP 2.2 CONFIGURATION DIALOGUE 2.3 PRODUCE COMMON.REL 2.4 LOAD COMMON.REL 2.5 LIBRARY SEARCH 2.6 MONITOR SAVE 3.0 DESCRIPTION OF CONFIG.MAC 4.0 DESCRIPTION OF COMMON.MAC 5.0 DESCRIPTION OF COMMOD.MAC APPENDIX A - SAMPLE DIALOGUE APPENDIX B - DECIMAL DEFAULT VALUES APPENDIX C - OCTAL DEFAULT VALUES \\ .FILL .JUSTIFY .SPACING 1 .LEFT MARGIN 0 .PAGE 1.0##^^INTRODUCTION\\ .BLANK 1 ^^MONGEN\\ (^MONITOR ^GENERATOR) IS A DIALOGUE PROGRAM THAT ALLOWS A USER TO DEFINE HIS HARDWARE AND SOFTWARE CONFIGURATION AS A PREREQUISITE TO CREATING A NEW MONITOR. ^WITH THE ANSWERS TO THE CONFIGURATION QUESTIONS, ^^MONGEN\\ PRODUCES A THREE-PAGE ^^MACRO\\ SOURCE FILE CALLED ^^CONFIG.MAC\\. ^THE USER ASSEMBLES ^^CONFIG.MAC\\ WITH ^^S.MAC\\ (SYMBOL DEFINITION FILE) AND ^^COMMON.MAC\\ (MONITOR NON-DISK DATA BASE) TO PRODUCE A RELOCATABLE BINARY FILE CALLED ^^COMMON.REL\\. ^IF THE USER IS BUILDING A 5-SERIES DISK MONITOR, HE MUST ALSO ASSEMBLE ^^CONFIG.MAC\\ WITH ^^S.MAC\\. AND ^^COMMOD.MAC\\ (MONITOR DISK DATA BASE) TO PRODUCE ^^COMMOD.REL\\. ^THE FILE ^^DATDMP.MAC\\ (CORE BLOCK DUMPER) IS AN OPTIONAL DEBUGGING TOOL THAT MAY BE ASSEMBLED WITH ^^S, CONFIG\\, AND ^^COMMOD\\ IF DESIRED. .BLANK 3 2.0##^^PROCEDURE FOR CREATING A NEW MONITOR .BLANK 3 2.1##MONGEN\\ STARTUP .BLANK 1 ^THE USER INITIATES THE EXECUTION OF THE ^^MONGEN\\ PROGRAM BY TYPING .BLANK 1 .INDENT 10 ^^RUN DSK:MONGEN\\ .BLANK 1 ^THE SYSTEM RETURNS .BLANK 1 .LEFT MARGIN 10 ^^TYPE #DEVICE:NAME.EXT" FOR WHERE TO PUT RESULTS OF THIS DIALOG\\ ^^CR ASSUMES "DSK:CONFIG.MAC\\" .BLANK 1 .LEFT MARGIN 0 REQUESTING THE DEVICE AND THE FILENAME ON WHICH TO STORE THE RESULTS OF THE ^^MONGEN\\ DIALOGUE. ^THE USER RESPONDS WITH A SPECIFIC DEVICE AND FILENAME, SUCH AS ^^DEC\\TAPE 1 (SEE EXAMPLE BELOW) OR THE SYSTEM ASSUMES DISK STORAGE AND FILENAME ^^CONFIG.MAC\\. .BLANK 1 .INDENT 10 ^^DTA1:CONFIG.MAC\\ .BLANK 1 ^^MONGEN\\ TYPES .BLANK 1 .INDENT 10 ^^ANSWER THE FOLLOWING QUESTIONS WITH A Y OR N OR .INDENT 10 A DECIMAL NUMBER SHORT DIALOG\\? .BLANK 1 ^THE USER RESONDS WITH ^N IF HE WOULD LIKE THE BRACKETED, EXPLANATORY COMMENTS PRINTED WITH EACH QUESTION. ^THE USER TYPES ^Y IF THE SHORT DIALOGUE IS SUFFICIENT. ^IT IS RECOMMENDED THAT USERS NOT FAMILIAR WITH THIS VERSION OF ^^MONGEN\\ TYPE ^N IN RESPONSE TO THIS QUESTION. .BLANK 3 2.2##^CONFIGURATION ^DIALOGUE .BLANK 1 ^THE USER DEFINES HIS HARDWARE AND SOFTWARE CONFIGURATION BY ANSWERING ^^MONGEN'\\S QUESTIONS IN CONVERSATIONAL MODE. ^^MONGEN\\ TRANSMITS ONE QUESTION AT A TIME TO THE USER'S ^TELETYPE. ^DEPENDING UPON THE CONTENT OF THE QUESTION, THE USER RESPONDS BY TYPING ^Y FOR YES, ^N FOR NO, OR A DECIMAL NUMBER, FOLLOWED BY A CARRIAGE RETURN. ^CERTAIN QUESTIONS PERMIT THE USER TO RESPOND BY TYPING ONLY A CARRIAGE RETURN, THEREBY ACCEPTING A PREDETERMINED ANSWER. ^THE QUESTIONS AND THEIR DEFAULT OR STANDARD ANSWERS ARE IDENTIFIED BY THE BRACKETED COMMENTS ASSOCIATED WITH THE LONG DIALOGUE. ^MOST OF ^^MONGEN\\'S QUESTIONS AND THE USER'S ANSWERS ARE NOT DESCRIBED IN THIS DOCUMENT BECAUSE THEY ARE CONSIDERED TO BE SELF-EXPLANATORY. ^READERS UNFAMILIAR WITH THE GENERAL FORMAT AND CONTENT OF THE QUESTIONS AND ANSWERS ARE REFERRED TO ^APPENDIX ^A FOR A SAMPLE DIALOGUE. ^^MONGEN'\\S LESS OBVIOUS QUESTIONS ASSOCIATED WITH THE FOLLOWING, ARE DESCRIBED BELOW. .BLANK 1 .LEFT MARGIN 9 .INDENT -4 1.##^DEFINING A ^TERMINAL ^CONFIGURATION, .INDENT -4 2.##^ANSWERING "SYMBOL, VALUE" QUESTIONS WITH DEFAULT ANSWERS .INDENT -4 3.##^ASSIGNING PRIORITY INTERRUPT CHANNELS TO SPECIAL DEVICES .LEFT MARGIN 0 .BLANK 3 2.2.1##^DEFINING A ^TERMINAL ^CONFIGURATION .BLANK 1 ^THE ^^MONGEN\\ DIALOGUE REQUIRES THAT THE USER BE THOROUGHLY FAMILIAR WITH HIS INSTALLATION'S TERMINAL CONFIGURATION. ^IT IS RECOMMEMDED THAT THE USER READ THE DOCUMENT ENTITLED ^^SCNSER,\\ ^LEVEL ^D ^SCANNER ^SERVICE IN THE ^^PDP\\-10 ^SOFTWARE ^NOTEBOOK, AND OBTAIN ALL THE NECESSARY INSTALLATION INFORMATION BEFORE ATTEMPTING TO ANSWER THE QUESTIONS. .BLANK 1 ^^MONGEN\\ ASKS .BLANK 1 .INDENT 10 ^^COMMON.MAC ALREADY EDITED FOR YOUR CONFIGURATION?\\ .BLANK 1 ^TO WHICH THE USER ANSWERS ^Y IF HE HAS PREVIOUSLY DEFINED HIS TERMINAL CONFIGURATION BY EDITING ^^COMMON.MAC,\\ AND PREFERS TO SKIP THIS PORTION OF THE DIALOGUE. ^THE USER ANSWERS ^N TO THIS QUESTION IF HE WISHES TO DEFINE HIS TERMINAL CONFIGURATION WITH THE ^^MONGEN\\ DIALOGUE. ^IF THE USER HAS ANSWERED ^N, THE NEXT QUESTION ASKS WHETHER OR NOT HIS CONFIGURATION HAS .BLANK 1 .INDENT 10 ^^BOTH DC10 AND 680?\\ .BLANK 1 LINE INTERFACES. ^AN ANSWER OF NO IMPLIES THAT THE USER HAS ONLY ONE TYPE OF LINE INTERFACE, EITHER THE ^^DC10\\ OR THE 680. ^^MONGEN\\ THEN PRODUCES DIALOGUE THAT DETERMINES THE APPROPRIATE LINE INTERFACE AND DEFINES THE INSTALLATION'S CONFIGURATION. ^AN ANSWER OF YES PRODUCES A SERIES OF QUESTIONS RELATED TO BOTH THE ^D^C10 AND THE 680. ^THIS IS THE MOST COMPLEX TERMINAL CONFIGURATION TO DEFINE. ^THE FOLLOWING PARAGRAPHS DESCRIBE THE QUESTIONS ASSOCIATED WITH THIS CASE. ^READERS UNFAMILIAR WITH THE ^D^C10 AND THE 680^I ARE REFERRED TO THE FOLLOWING HARDWARE MANUALS: .BLANK 1 .INDENT 5 1.##^^DC10 DATA LINE SCANNER (DEC-10-I8AA-D)\\ .BLANK 1 .INDENT 5 2.##^^DATA COMMUNICATIONS SYSTEM-680I (DEC-08-I7CA-D)\\ .BLANK 1 ^^MONGEN\\ ASKS .BLANK 1 .INDENT 10 ^^HOW MANY DC10B 8-LINE DATA GROUPS?\\ .BLANK 1 .INDENT 10 ^^HOW MANY DC10E DATA SET CONTROL GROUPS?\\ .BLANK 1 AND .BLANK 1 .INDENT 10 ^^HOW MANY OCTAL LINES ON YOUR 680(I)?\\ .BLANK 1 ^THE USER ANSWERS EACH QUESTION BY SPECIFYING THE NUMBER OF LINE GROUPS (AT LEAST 1) IN EACH CATEGORY THAT IS INSTALLED AT HIS INSTALLATION. .BLANK 1 ^THE NEXT QUESTIONS ASK FOR INFORMATION ABOUT TERMINAL LINE ASSIGNMENT. ^THE USER SHOULD PREPARE A PICTORIAL REPRESENTATION OF HIS CONFIGURATION BASED ON THE INSTALLATION'S TERMINAL LINE ASSIGNMENT. ^SOFTWARE ^^TTY\\ LINE NUMBERS ARE ASSIGNED ACCORDING TO THE FOLLOWING FORMAT: (^SEE ^FIGURE 1.) .BLANK 1 .LEFT MARGIN 9 .INDENT -4 1.##^ALL ^D^C10^B 8-LINE DATA GROUPS MUST BE ASSIGNED FIRST. ^THE SOFTWARE LINE NUMBERS, (^^TTY0, TTY1,...,\\ ETC.) MAP DIRECTLY TO THE PHYSICAL PORT NUMBERS. .BLANK 1 .INDENT -4 2.##^NEXT THE ^D^C10^E DATA SET CONTROLLERS, IF ANY, ARE ASSIGNED TO THE PHYSICAL PORTS IMMEDIATELY FOLLOWING THE ^D^C10^B'S. ^SINCE EACH CONTROLLER IS ASSOCIATED WITH A DATA SET LINE, ^D^C10^E'S DO NOT HAVE THEIR OWN SOFTWARE ^^TTY\\ NUMBER. ^THE ASSOCIATION BETWEEN THE INDIVIDUAL DATA SET LINES (^D^C10^B) AND THE DATA SET CONTROLLERS (^^DC10E)\\ IS DETERMINED BY WIRING IN THE ^D^C 10 AT THE TIME THE DATA SETS ARE INSTALLED. (^THIS ^^DC10E, DC10B\\ CORRESPONDENCE IS REQUESTED BY A LATER ^^MONGEN\\ QUESTION.) .BLANK 1 .INDENT -4 3.##^THE SOFTWARE LINE NUMBERS (^^TTY\\N) FOR THE 680 TERMINALS FOLLOW DIRECTLY AFTER THE ^^DC10B\\ LINE NUMBERS, AND ARE ASSIGNED IN NUMERICAL ORDER IMMEDIATELY AFTER THE LAST ^^DC10B.\\ .BLANK 1 .INDENT -9 ^FOR EXAMPLE, IF AN INSTALLATION HAS .BLANK 1 .INDENT -4 A.##^THREE ^^DC10B\\ 8-LINE DATA GROUPS .BLANK 1 .INDENT -4 B.##^ONE ^^DC10E\\ DATA SET CONTROL GROUP, AND .BLANK 1 .INDENT -4 C.##^SIXTEEN 680 LINE TERMINALS .BLANK 1 .LEFT MARGIN 0 THE LINE ASSIGNMENT IS REPRESENTED AS FOLLOWS: .SPACING 1 .BLANK 2 .NOFILL .NOJUSTIFY .TAB STOPS 40 .LEFT MARGIN 10 ^^PHYSICAL SOFTWARE LINE NOS. .INDENT 5 PORT NOS. .BLANK 1 .RIGHT MARGIN 65 .LEFT MARGIN 15 .TAB STOPS 15,20,36,44,50 #0 \L-----------------------------\L \L \L TTY0 \L \L \L \L \L \L \L \L \L \L #7 \L \L TTY7 \L \L-----------------------------\L 10 \L \L TTY10 \L \L \L \L DC10 LINES .INDENT -15 DC10B'S \L \L \L (3 GROUPS) .INDENT -15 (3 GROUPS) \L \L \L 17 \L \L TTY17 \L \L-----------------------------\L 20 \L \L TTY20 \L \L \L \L \L##########\\DATA SETS^^ \L \L \L \L 27 \L \L TTY27 \L \L-----------------------------\L----------- 30 \L \L\L TTY30 \L \L \\DATA SET \L\L \L \L CONTROLLERS^^ \L\L \L .INDENT -15 DC10E'S \L \\(CORRESPOND^^ \L\L \L .INDENT -15 (1 GROUP) \L \\TO LINE 20-27)^^\L\L \L \L \L\L \L 680 LINES 37 \L \L\L TTY37 \L .INDENT -15 --------------------\L-----------------------------\L \L TTY40 \L \L \L \L \L \L \L \L TTY47 \L \L-------------\L .BLANK 1 .CENTER FIGURE 1 .PAGE .FILL .JUSTIFY .LEFT MARGIN 0 .BLANK 1 ^I\\N ADDITION TO LINE ASSIGNMENT THE USER MUST BE PREPARED TO ANSWER QUESTIONS ABOUT THE LINES AND TERMINAL HARDWARE, SUCH AS: .BLANK 1 .LEFT MARGIN 9 .INDENT -4 1.##^WHICH TERMINALS HAVE HARDWARE TABS? .BLANK 1 ^MOST ^TELETYPE MODEL 35'S AND 37'S HAVE HARDWARE TABS, AND MOST MODEL 33'S DO NOT. ^HOWEVER, SINCE THE VARIETY OF FEATURES FOUND ON MODEL 33, 35, AND 37 ^TELETYPES IS SO GREAT, IT IS EACH USER'S RESPONSIBILITY TO DETERMINE THE PHYSICAL CHARACTERISTICS OF HIS INSTALLATION'S TERMINALS. .BLANK 1 ^THE MONITOR SIMULATES TABS ON LINES WHICH DO NOT HAVE TABS BY ECHOING FROM ONE TO EIGHT SPACES. .BLANK 1 ^ALTHOUGH NOT RECOMMENDED IT IS POSSIBLE TO OVERRIDE ^^MONGEN\\ TAB SETTINGS WITH THE ^^SET TTY TAB\\ AND ^^SET TTY NO TAB\\ COMMANDS. .BLANK 1 .INDENT -4 2.##^WHICH LINES ARE CONSIDERED REMOTE? .BLANK 1 ^ALL DATA SETS ARE IMPLICITLY REMOTE, AND THE INSTALLATION MAY GIVE "REMOTE" STATUS TO ANY TERMINAL, EVEN THOSE HARDWIRED. ^IN THIS CONTEXT REMOTE IS A SOFTWARE CHARACTERISTIC OF THE TERMINAL THAT IMPOSES CERTAIN RESTRICTIONS, SUCH AS PROJECT 1 CANNOT LOGIN. (^NOT TO BE CONFUSED WITH TERMINALS AT ^REMOTE ^STATIONS.) .BLANK 1 .INDENT -4 3.##^WHICH LINES ARE HALF-DUPLEX? .BLANK 1 ^THE USER MUST DETERMINE WHICH LINES TRANSMIT IN HALF-DUPLEX MODE. ^HALF-DUPLEX LINES PROVIDE TWO-WAY, ALTERNATE, INDEPENDENT TRANSMISSION OVER THE SAME PAIR OF WIRES. .BLANK 1 .CENTER ^NOTE .BLANK 1 .LEFT MARGIN 9 ^THE TERM HALF DUPLEX IS OCCASIONALLY USED INCORRECTLY. ^TRUE HALF DUPLEX LINES ARE RELATIVELY RARE. ^THEY INCLUDE CERTAIN ^^TWX\\ DATA SETS AND SOME LOCAL TERMINALS CONNECTED BY ^^DC10C\\ INTERFACES. ^SOME LINES LOOSELY CALLED HALF DUPLEX ARE ACTUALLY LOCAL COPY FULL DUPLEX. ^THE IDENTIFICATION OF LOCAL COPY LINES IS ASKED BY ANOTHER ^^MONGEN\\ QUESTION. ^READERS INTERESTED IN A DEFINITION OF THESE TERMS ARE REFERRED TO A DOCUMENT ENTITLED ^^SCNSER,\\ ^LEVEL ^D ^SCANNER ^SERVICE (SECTION 3.0,) IN THE ^^PDP-10\\ ^SOFTWARE ^NOTEBOOK. .BLANK 1 .LEFT MARGIN 9 .INDENT -4 4.## ^WHICH LINES ARE LOCAL COPY? .BLANK 1 ^THE USER MUST DETERMINE WHICH LINES ARE CONSIDERED LOCAL COPY FULL DUPLEX. ^IN LOCAL COPY LINES, ECHOING IS PROVIDED BY THE TERMINAL RATHER THAN THE COMPUTER. .BLANK 1 .INDENT -4 5.##^WHICH LINES ARE SLAVES? .BLANK 1 ^SLAVE IS A SOFTWARE CLASSIFICATION FOR TERMINALS THAT CANNOT LOGIN OR CONTROL JOBS. ^THEY GENERALLY PROVIDE ONLY ^^I/O\\ FOR JOBS CONTROLLED BY OTHER TERMINALS. ^A TERMINAL MAY BE CLASSIFIED AS A SLAVE BY ANY USER, BUT CAN ONLY BE RESTORED TO NORMAL STATUS AT THE OPERATOR'S CONSOLE. .BLANK 1 .INDENT -4 6.##^WHICH LINES HAVE HARDWARE FORMFEED? .BLANK 1 ^MOST ^TELETYPE MODEL 35'S HAVE HARDWARE FORMFEED AND MOST MODEL 33'S DO NOT. ^SINCE THE VARIETY OF FEATURES FOUND ON VARIOUS TERMINALS IS SO GREAT, THE USER MUST INDIVIDUALLY DETERMINE THE HARDWARE CHARACTERISTICS OF HIS INSTALLATION'S TERMINALS. .BLANK 1 .INDENT -4 7.##^WHICH LINES RUN ^^INITIA\\ AT STARTUP? .BLANK 1 ^^INITIA\\ IS A PROGRAM THAT PERFORMS CERTAIN JOB INITIALIZATION FUNCTIONS. ^WHEN THE MONITOR STARTS UP, ^^INITIA\\ IS RUN AUTOMATICALLY FOR THE SPECIFIED LINES. ^AT THE VERY LEAST DEVICE ^^OPR\\ SHOULD RUN ^^INITIA\\. ^IT IS RECOMMENDED THAT ALL LOCAL TERMINALS RUN ^^INITIA\\. (^REMOTE TERMINALS, DATASET TERMINALS, AND REMOTE STATION TERMINALS SHOULD NOT RUN ^^INITIA\\.) .BLANK 1 .LEFT MARGIN 0 ^THE LAST ^^TTY\\ CONFIGURATION QUESTION ASKS FOR THE .INDENT 10 .BLANK 1 ^^CORRESPONDENCE BETWEEN THE DC10E AND DC10B LINES? .BLANK 1 ^T\\HE USER MUST DETERMINE WHICH ^^DC10E\\ DATA SET CONTROLLERS ARE WIRED TO WHICH ^^DC10B\\ LINES. ^IN OUR EXAMPLE (SEE FIGURE 1), LINE NUMBERS 20 THROUGH 27 ARE ^^DC10B\\ DATA SET LINES THAT ARE HARDWIRED TO THE ^^DC10E\\ CONTROLLER LINES 30 THROUGH 37. ^THE CORRESPONDENCE IS THEN .BLANK 1 .LEFT MARGIN 10 .NOFILL .NOJUSTIFY 30,20 31,21 32,22 33,23 34,24 35,25 36,26 37,27 .LEFT MARGIN 0 .FILL .JUSTIFY .BLANK 1 ^THE ACTUAL QUESTIONS AND ANSWERS USED TO DEFINE THE ^TERMINAL CONFIGURATION DESCRIBED BY THE ABOVE EXAMPLE ARE INCLUDED AS PART OF THE SAMPLE DIALOGUE IN ^APPENDIX ^A. .BLANK 3 .TEST PAGE 25 2.2.2##^EXPLANATION OF ^QUESTIONS WITH ^DEFAULT ^ANSWERS .BLANK 1 ^^MONGEN\\ TYPES THE STATEMENT .BLANK 1 .INDENT 10 ^^TYPE "SYMBOL,VALUE" (VALUE IN DECIMAL)\\ .BLANK 1 ASKING THE USER TO TYPE ONLY THOSE CONSTANTS RELATED TO HIS CONFIGURATION THAT DEVIATE FROM THE STANDARD. ^^MONGEN\\ DEFINES EACH OF THE SYMBOLS IN ACCORDANCE WITH PREDETERMINED, STANDARD VALUES UNLESS THE USER SPECIFIES OTHERWISE. ^A LIST AND EXPLANATION OF THE STANDARD SYMBOLS AND DECIMAL DEFAULT VALUES APPEAR IN ^APPENDIX ^B. ^FOR EXAMPLE, TO SPECIFY 50 AS THE POWER FREQUENCY IN ^HERTZ INSTEAD OF THE STANDARD 60, THE USER TYPES .BLANK 1 .INDENT 10 ^^JIFSEC,50\\ .BLANK 1 ^IF THE USER HAS MORE THAN ONE ENTRY, EACH "SYMBOL, VALUE" COMBINATION IS TYPED ON A SEPARATE LINE, WITH AN EXTRA CARRIAGE RETURN AFTER THE LAST ENTRY. ^IF ALL STANDARD VALUES ARE ACCEPTABLE, THE USER TYPES ONLY ONE CARRIAGE RETURN IN RESPONSE TO THE QUESTION. .BLANK 1 ^NEXT THE PROGRAM TYPES .BLANK 1 .INDENT 10 ^^TYPE "SYMBOL,VALUE" (VALUE IN OCTAL) .BLANK 1 \\ REQUESTING OCTAL VALUES THAT ARE TO BE CHANGED FROM THE STANDARD. ^THE PROCEDURE FOR THIS QUESTION IS EXACTLY THE SAME AS FOR THE PREVIOUS QUESTION. ^DEVIATIONS TO THE LIST OF DEFAULT VALUES ARE THE ONLY RESPONSES REQUIRED. ^APPENDIX ^C LISTS AND EXPLAINS THE STANDARD SYMBOLS AND OCTAL VALUES. ^IF NO CHANGES TO THE STANDARD ARE REQUIRED, THE USER TYPES ONLY A CARRIAGE RETURN. .BLANK 3 2.2.3##^ASSIGNING ^^PI\\ ^CHANNELS TO ^SPECIAL ^DEVICES .BLANK 1 ^THE NEXT THREE QUESTIONS ASK THE USER FOR SPECIAL INFORMATION RELATED TO NON-STANDARD PERIPHERAL DEVICES AND THEIR ASSOCIATED PRIORITY INTERRUPT CHANNELS. ^IF THE USER HAS NO SPECIAL DEVICES, HIS RESPONSE TO EACH OF THE THREE QUESTIONS IS SIMPLY A CARRIAGE RETURN. .BLANK 1 ^UNDER ORDINARY CIRCUMSTANCES WHEN ^^COMMON\\ IS ASSEMBLED, DEVICES ARE ASSIGNED TO CHANNELS ACCORDING TO THEIR GROUP PRIORITY. (^REFER TO ^TABLE 1-1). ^IF THE USER HAS A DEVICE NOT LISTED AS A STANDARD DEVICE IN ^TABLE 1-1, AND HAS WRITTEN HIS OWN ^MONITOR ^DEVICE ^SERVICE ^ROUTINE HE MUST SPECIFY THE DEVICE MNEMONIC AND DESIGNATE AN APPROPRIATE PRIORITY INTERRUPT CHANNEL. ^THE USER MUST ANSWER ALL THREE QUESTIONS AS THEY APPLY TO HIS CONFIGURATION. ^THE FIRST QUESTION REQUESTS THE ^^"DEVICE-MNEMONIC, CHANNEL"\\ FOR NON-STANDARD DEVICES FOR WHICH THE SPECIAL DEVICE SERVICE ROUTINES DO NOT NEED EITHER A ^CHANNEL ^SAVE ^ROUTINE OR A ^DEVICE ^DATA ^BLOCK. ^THE SECOND QUESTION REQUESTS ^^"DEVICE-MNEMONIC, CHANNEL, NO.-OF-DEVICES"\\ FOR DEVICES WITH SPECIAL SERVICE ROUTINES THAT HAVE A ^DEVICE ^DATA ^BLOCK BUT NO ^CHANNEL ^SAVE ^ROUTINE. ^THE THIRD QUESTION REQUESTS, ^^"DEVICE-MNEMONIC, CHANNEL, HIGHEST-AC-TO-SAVE"\\ FOR DEVICES WITH SPECIAL SERVICE ROUTINES THAT HAVE A ^CHANNEL ^SAVE ^ROUTINE, BUT NO ^DEVICE ^DATA ^BLOCK. .BLANK 1 ^SPECIAL DEVICES ADDED BY A USER DURING THE ^^MONGEN\\ DIALOGUE ARE CHAINED TO THE REQUESTED CHANNEL. ^TO GIVE A DEVICE THE EXCLUSIVE USE OF A CHANNEL, THE USER RESPONDS TO THE "SYMBOL, VALUE (VALUE IN DECIMAL)" QUESTION WITH .BLANK 1 .INDENT 10 ^^UNIQ\\N,1 .BLANK 1 WHERE N IS THE PRIORITY INTERRUPT CHANNEL TO BE RESERVED. ^REFER TO THE LAST ENTRY IN ^APPENDIX ^B. .TEST PAGE 48 .SPACING 1 .CENTER ^TABLE 1-1 .CENTER ^DEVICE ^GROUPS FOR ^^PI\\ ^CHANNEL ^ASSIGNMENT .FILL .JUSTIFY .BLANK 2 .TAB STOPS 6,23,32 ^DEVICE ^MNEMONIC######^GROUP ^NAME .BREAK ---------------######----- ---- .BLANK 1 .LEFT MARGIN 32 .INDENT -26 ^^DCB\\ ^A 136 ^DATA CONTROL FOR 270 DISK .BLANK 1 .INDENT -26 ^^MTA\\ ^B ^^TM10A\\ ^MAGTAPE DATA CHANNEL .BLANK 1 .INDENT -26 ^^DCT C\\ 136 DATA CONTROL FOR 551 OR 516 TAPE CONTROLS .BLANK 1 .INDENT -26 ^^DTA\\ ^D ^^TD10 DEC\\TAPE DATA CHANNEL .BLANK 1 .INDENT -26 ^^CDR\\ ^E 461 OR ^C^R10 ^CARD READER .BLANK 1 .INDENT -26 ^^APR\\ ^E ^K^A10 OR 166 ARITHMETIC PROCESSOR .BLANK 1 .INDENT -26 ^^SCN\\ ^F ^D^C10, 680, OR 630 ^TELETYPE SCANNER .BLANK 1 .INDENT -26 ^^PTR\\ ^F ^PAPER TAPE READER .BLANK 1 .INDENT -26 ^^LPT\\ ^F ^LINE PRINTER .BLANK 1 .INDENT -26 ^^DTA\\ ^F ^^DEC\\TAPE FLAG CHANNEL (^^DTA \O\R DTC\\) .BLANK 1 .INDENT -26 ^^MTA\\ ^F ^MAGTAPE FLAG CHANNEL .BLANK 1 .INDENT -26 ^^CTY\\ ^F ^CONSOLE ^TELETYPE .BLANK 1 .INDENT -26 ^^DSK\\ ^G ^DISK FLAG CHANNEL (^^FHD,MDF,DPC, \O\R DPD\\) .BLANK 1 .INDENT -26 ^^PEN\\ ^G ^LIGHT PEN .BLANK 1 .INDENT -26 ^^PTP\\ ^G ^PAPER TAPE PUNCH .BLANK 1 .INDENT -26 ^^CDP\\ ^G ^CARD PUNCH .BLANK 1 .INDENT -26 ^^PLT\\ ^G ^PLOTTER .BLANK 1 .INDENT -26 ^^DIS\\ ^H ^DISPLAY DATA CHANNEL .BLANK 1 .INDENT -26 .TEST PAGE 3 ^^CLK\\ ^I ^SCHEDULER, CLOCK ROUTINES (ALWAYS ASSIGNED TO CHANNEL 7) .BLANK 1 .LEFT MARGIN 0 ^^I/O\\ DEVICES ARE GROUPED BY THE RELATIVE SPEEDS OF INTERRUPTS. ^IF ANY DEVICE OF A PARTICULAR GROUP IS PRESENT, A ^^PI\\ CHANNEL IS ASSIGNED TO THAT DEVICE ACCORDING TO ITS GROUP PRIORITY. ^GROUP PRIORITIES FOR STANDARD DEVICES MAY BE REVISED BY REARRANGING THE DEVICES IN ^^INTTAB\\, IN THE SOURCE OF ^^COMMON\\. .BLANK 1 ^AFTER ALL THE QUESTIONS ARE ANSWERED ^^MONGEN\\ PRODUCES ^^CONFIG.MAC\\, A THREE-PAGE ^^MACRO\\ SOURCE FILE. ^THE ORIGINAL ^^MONGEN\\ QUESTIONS APPEAR AS COMMENTS IN ^^CONFIG.MAC\\. ^IF THE USER PREFERS HE MAY MAKE MINOR MODIFICATIONS TO ^^CONFIG.MAC\\ WITH AN EDITOR, RATHER THAN RERUN THE ENTIRE ^^MONGEN\\ PROGRAM. .BLANK 3 .TEST PAGE 15 2.3##^PRODUCE ^^COMMON.REL\\ AND ^^COMMOD.REL\\ .BLANK 1 2.3.1#-#^THE USER ASSEMBLES ^^CONFIG.MAC\\ WITH ^^S.MAC\\ AND ^^COMMON.MAC\\ TO PRODUCE A RELOCATABLE BINARY FILE CALLED ^^COMMON.REL.\\ ^IF THE USER IS BUILDING A 5-SERIES DISK MONITOR, HE ALSO ASSEMBLES ^^CONFIG.MAC\\ WITH ^^S.MAC, AND ^^COMMOD.MAC\\, TO PRODUCE ^^COMMOD.REL\\. ^TO ASSEMBLE A DISK MONITOR THE USER TYPES .BLANK 1 .INDENT 10 ^^COMPIL#/CREF#S+CONFIG+COMMON,S+CONFIG+COMMOD\\ .BLANK 3 .LEFT MARGIN 0 .FILL .JUSTIFY 2.3.2##^ASSEMBLY ^ERROR ^MESSAGES .BLANK 1 ^ONE OR MORE OF THE FOLLOWING ERROR MESSAGES ARE TYPED ON THE USER'S TERMINAL IF ATTEMPTS TO ASSEMBLE ^^CONFIG.MAC\\ ARE UNSUCCESSFUL. .BLANK 1 .LEFT MARGIN 9 .INDENT -4 1.##^^MORE THAN 127. TTYS + PTYS EXCEED FIELD OF DDB.\\ .BLANK 1 ^THIS MESSAGE INDICATES THAT THERE IS A SPECIFICATION ERROR IN THE DATA SET CONTROL TABLE. ^THE USER MUST CORRECT IT. .BLANK 1 ^THIS INDICATES THAT THE SYSTEM CAPACITY OF 127 ^^TTYS\\ AND ^^PTYS\\ HAS BEEN EXCEEDED. ^THE USER MUST RERUN ^^MONGEN\\, ANSWERING QUESTIONS FOR FEWER ^^TTYS\\ AND ^^PTYS\\. .BLANK 1 .INDENT -4 2.##^^NOT ENOUGH PI'S TO SERVICE THIS CONFIGURATION SUGGEST EDITING COMMON TO PUT MORE DEVICES ON A SINGLE CHANNEL.\\ .BLANK 1 ^THIS MESSAGE INDICATES THAT THE SYSTEM CAPACITY OF 7 PRIORITY INTERRUPT CHANNELS HAS BEEN EXCEEDED. ^THE USER SHOULD ASSIGN MORE DEVICES TO EACH ^P^I CHANNEL BY EDITING ^^INTTAB\\ IN THE SOURCE OF ^^COMMON\\. .BLANK 1 .INDENT -4 3.##^^FT2REL MUST BE -1 WHEN 2 RELOC REGISTERS EXIST. .BLANK 1 .INDENT -4 4.##PLEASE ASSEMBLE SOURCES WITH FTRTTRP = -1. .BLANK 1 .INDENT -4 5.##PLEASE ASSEMBLE SOURCES WITH FTLOCK = -1. .BLANK 1 .INDENT -4 6.##PLEASE ASSEMBLE SOURCES WITH FTHPQ = -1.\\ .BLANK 1 ^THESE MESSAGES INDICATE THAT THE USER EDITED ^^S.MAC\\ INCORRECTLY. ^THE USER MUST REEDIT ^^S.MAC\\ TO CORRECT THE IMPROPER SYMBOL DEFINITIONS. .BLANK 1 .INDENT -4 7.##^^SPECIFICATION ERROR - DSCTAB.\\ .BLANK 1 ^THIS MESSAGE INDICATES THAT THERE IS A SPECIFICATION ERROR IN THE DATA SET CONTROL TABLE. ^THE USER MUST CORRECT IT. .LEFT MARGIN 0 .BLANK 3 .FILL .JUSTIFY 2.4##^LOAD THE ^MONITOR .BLANK 1 ^THE USER LOADS USING ^^COMMON.REL\\ WITH A REGULAR LOADER UNDER TIMESHARING, ^^MONLOD\\, OR UNDER A SMALL SINGLE-USER MONITOR (^^SPMON\\). ^SYSTEMS WITH 32^K OR 48^K OF MEMORY MUST LOAD A TIMESHARING MONITOR USING ^^SPMON\\ AND A REGULAR 10/30 LOADER (^^LOADER.SVE\\). .BLANK 1 ^OBSERVE THAT THERE IS A DISTINCTION BETWEEN THE EXTENSIONS ^^.SVE\\ AND ^^.SAV.\\ ^^.SVE\\ IS THE STANDARD EXTENSION FOR FILES SAVED BY THE 10/30 ^^SAVE\\ COMMAND. ^^.SAV\\ IS THE STANDARD EXTENSION FOR FILES SAVED BY THE 10/40 OR 10/50 ^^SAVE\\ COMMAND. ^UNDER ORDINARY CIRCUMSTANCES THE TWO EXTENSIONS CANNOT BE INTERCHANGED BECAUSE THE JOB DATA AREAS ARE INCOMPATIBLE. ^SAVE FILES WRITTEN BY ^^SPMON\\ ARE AN EXCEPTION TO THIS. ^ALTHOUGH ^^SPMON\\ IS A 10/30 MONITOR, IT CREATES ^^.SVE\\ FILES WHICH ARE COMPATIBLE WITH A 10/40 OR A 10/50 MONITOR. ^THESE FILES CAN BE LOADED WITH A 10/40 OR 10/50 ^^GET\\ COMMAND FOR ^^DDT\\ PATCHING. .BLANK 1 .TEST PAGE 8 ^TO LOAD AND SAVE THE MONITOR USING ^^COMMON.REL\\ THE USER TYPES .BLANK 1 .LEFT MARGIN 10 .NOFILL .NOJUSTIFY ^^.R LOADER */S *DSK:COMMON,COMMOD,DSK:TOPS10/L *LPT:__/A/M/P/G *SAVE DSK:5^S03\\ .BLANK 3 .LEFT MARGIN 0 .FILL .JUSTIFY .TEST PAGE 7 2.5##^LIBRARY ^SEARCH .BLANK 1 ^THE USER INITIATES A LIBRARY SEARCH OF THE APPROPRIATE MONITOR FILE E.G., ^^TOPS10.REL\\, TO MAKE A MULTIPROGRAMMING NON-DISK 10/40 MONITOR OR A DISK SWAPPING 10/50 MONITOR. .BLANK 3 .TEST PAGE 6 2.6##^MONITOR ^^SAVE\\ .BLANK 1 ^THE USER EXECUTES THE MONITOR ^^SAVE\\ COMMAND TO WRITE THE LOADED MONITOR ONTO A ^^DEC\\TAPE, A DISK, OR A MAGTAPE AS A FILE THAT CAN LATER BE READ INTO EXEC CORE BY THE ^^DTBOOTS, BOOTS, \O\R MAGRIM\\ LOADERS, RESPECTIVELY. .BLANK 3 .TEST PAGE 16 3.0##^^DESCRIPTION OF CONFIG.MAC\\ .BLANK 1 ^THE ^^CONFIG.MAC\\ FILE PRODUCED BY ^^MONGEN\\ CONTAINS THE FOLLOWING FOR EACH QUESTION ASKED. .BLANK 1 .LEFT MARGIN 9 .INDENT -4 1.##^THE QUESTION ASKED BY ^^MONGEN\\, AS A COMMENT. .BLANK 1 .INDENT -4 2.##^THE ANSWER GIVEN BY THE USER, AS A COMMENT. .BLANK 1 .INDENT -4 3.##^ONE, TWO, OR THREE ^X^P#XXX^N,N MACRO DEFINITIONS THAT DEFINE SYMBOL XXX^N TO BE EQUAL TO N. ^A YES ANSWER HAS THE VALUE 1; A NO ANSWER HAS THE VALUE 0. .LEFT MARGIN 0 .BLANK 1 ^^MONGEN\\ ALWAYS DEFINES ALL THE SYMBOLS THAT APPEAR IN ^^CONFIG.MAC\\, REGARDLESS OF THE ANSWER. ^THEREFORE, THE USER NEED NOT STUDY THE ^^MONGEN\\ PROGRAM IN ORDER TO UNDERSTAND WHAT HAPPENS ON CERTAIN QUESTIONS. ^IT IS SUFFICIENT TO LOOK AT THE LISTING OF ^^CONFIG.MAC\\ THAT IS ASSEMBLED WITH ^^COMMON.MAC\\. .BLANK 3 4.0##^^DESCRIPTION OF COMMON.MAC\\ .BLANK 1 ^WHEN THE THREE-PAGE ^^CONFIG.MAC\\ FILE PRODUCED BY ^^MONGEN\\ IS ASSEMBLED WITH ^^S.MAC\\ AND ^^COMMON.MAC\\, THERE IS NO FEATURE FILE, E.G., ^^FT50S,\\ BECAUSE THE DIALOGUE HAS ALREADY DEFINED THE CONFIGURATION. .BLANK 1 ^SINCE ^^COMMON.MAC\\ SELECTIVELY ASSEMBLES ONLY ITEMS NEEDED FOR THE DEFINED CONFIGURATION, IT CONTAINS THE FOLLOWING (IN THIS ORDER): .BLANK 1 .LEFT MARGIN 9 .INDENT -4 1.##^THE DEFAULT SYMBOLS THAT CAN BE OVERRIDDEN BY THE USER DURING THE ^^MONGEN\\ DIALOGUE. .BLANK 1 .INDENT -4 2.##^THE MONITOR STARTUP LOCATIONS. .BLANK 1 .INDENT -4 3.##^SPECIAL LOWER-CORE LOCATIONS (BELOW 140) IN THE MONITOR. .BLANK 1 .INDENT -4 4.##^VARIABLE DATA LOCATIONS FOR MOST OF THE MONITOR. (^THEREFORE, THE NAME ^^COMMON.\\) .BLANK 1 .INDENT -4 5.##^THE JOB AND HIGH SEGMENT TABLES. ^LENGTH IS DEFINED BY THE ANSWER TO A QUESTION. .BLANK 1 .INDENT -4 6.##^LOCATIONS SET BY ONCE-ONLY DIALOGUE. .BLANK 1 .INDENT -4 7.##^SYSTEM ERROR STOP CODE (147 RESTART.) .BLANK 1 .INDENT -4 8.##^COMMON SUBROUTINE RETURNS. .BLANK 1 .INDENT -4 9.##^COMMON BYTE POINTERS. .BLANK 1 .INDENT -5 10.##^SPECIAL ^^MACRO\\'S TO DEFINE THE ^^PI\\ ASSIGNMENT IF DEVICE IS PRESENT. ^THESE ^^MACRO\\'S CREATE A TWO-WORD-PER-ENTRY TABLE THAT CONTAINS .BLANK 1 .LEFT MARGIN 13 .INDENT -4 A.##^DEVICE DATA BLOCK ADDRESS. .BLANK 1 .INDENT -4 B.##^NUMBER OF DEVICES. .BLANK 1 .INDENT -4 C.##^PRIORITY ^INTERRUPT CHANNEL FOR DEVICE. .BLANK 1 .INDENT -4 D.##^INTERRUPT LOCATION FOR DEVICE. .BLANK 1 .INDENT -4 E.##^LENGTH OF DEVICE DATA BLOCK IF MULTIPLE DEVICE. .BLANK 1 .LEFT MARGIN 9 .INDENT -5 11.##^ONCE-ONLY CODE TO LINK DEVICE DATA BLOCKS AND TO CREATE MULTIPLE COPIES FOR ALL MULTIPLE DEVICES, WITH THE EXCEPTION OF DISK. .BLANK 1 .INDENT -5 12.##^THE ^P^I CHANNEL SAVE AND RESTORE ROUTINES. .BLANK 1 .INDENT -5 13.##^A LIST OF ^^EXTERN\\'S TO SELECTIVELY LOAD ALL THE PROGRAMS THAT ARE REQUIRED, IF THE USER IS LOADING FROM A MONITOR LIBRARY FILE. .BLANK 1 .INDENT -5 14.##^DEVICE-DEPENDENT BIT DEFINITION AND ^^EXTERN\\'S. .BLANK 3 .LEFT MARGIN 0 5.0##^^DESCRIPTION OF COMMOD.MAC\\ .BLANK 1 ^WITH A 5-^SERIES DISK MONITOR, THE USER ALSO ASSEMBLES ^^CONFIG.MAC\\ WITH ^^S.MAC\\, ^^COMMOD.MAC\\ AND ^^DATDMP.MAC\\. .BLANK 1 ^^COMMOD.MAC\\ SELECTIVELY ASSEMBLES THESE ITEMS REQUIRED FOR THE DEFINED CONFIGURATION. ^IT CONTAINS: .BLANK 1 .LEFT MARGIN 9 .INDENT -4 1.##^THE ASSEMBLY INSTRUCTIONS. .BLANK 1 .INDENT -4 2.##^THE DEFAULT SYMBOLS THAT CAN BE OVERRIDDEN BY THE USER DURING THE ^^MONGEN\\ DIALOGUE. .BLANK 1 .INDENT -4 3.##^THE INSTRUCTIONS FOR WRITING A NEW CONTROLLER ROUTINE. .BLANK 1 .INDENT -4 4.##^THE SYMBOL NAMING CONVENTIONS .BLANK 1 .LEFT MARGIN 13 .INDENT -4 A.##3-LETTER PREFIXES .BLANK 1 .INDENT -4 B.##3-LETTER SUFFIXES .BLANK 1 .LEFT MARGIN 9 .INDENT -4 5.##^THE LIST OF UPPER AND LOWER LIMITS FOR VARIOUS DISK PARAMETERS. .BLANK 1 .INDENT -4 6.##^THE DATA STRUCTURE DESCRIPTION. .BLANK 1 .INDENT -4 7.##^THE CORE AND DISK BLOCK SYMBOL DEFINITIONS .BLANK 1 .SPACING 2 .NOFILL .NOJUSTIFY A. GENERALIZED CORE BLOCK B. ^ACCESS TABLE (FIRST HALF) C. ^^BAT\\ BLOCK D. ^DEVICE ^DATA ^BLOCK E. ^HOME BLOCK F. ^MONITOR JOB TABLES G. ^CONTROLLER DATA BLOCK H. ^^MFD\\ BLOCK I. ^NAME BLOCK J. ^PROJECT-^PROGRAMMER NUMBER BLOCK K. ^^RIB\\ BLOCK L. ^^SAT\\ BLOCK M. ^FILE STRUCTURE DATA BLOCK N. ^SYSTEM VARIABLES O. ^^UFD\\ BLOCK P. ^UNIT DATA BLOCK .LEFT MARGIN 0 .FILL .JUSTIFY .SPACING 1 .PAGE .CENTER ^^APPENDIX A - SAMPLE DIALOGUE\\ .BLANK 1 ^THE FOLLOWING IS A SAMPLE ^^MONGEN\\ DIALOGUE WITH REPRESENTATIVE QUESTIONS AND ANSWERS. ^THE OPTIONAL COMMENTS [ENCLOSED IN SQUARE BRACKETS] ARE INCLUDED FOR THE READER'S CONVENIENCE. .BLANK 1 .RIGHT MARGIN 75 .TAB STOPS 8,16,24,32,40,48 .NOFILL .NOJUSTIFY ^^ _.RUN DSK:MONGEN TYPE "DEVICE:NAME.EXT" FOR WHERE TO PUT RESULTS OF THIS DIALOG CR ASSUMES "DSK:CONFIG.MAC" .BLANK 1 ANSWER THE FOLLOWING QUESTIONS WITH Y OR N OR A DECIMAL NUMBER SHORT DIALOG?[N = LONGER QUESTIONS] N 10/50 SYSTEM TO BE BUILT?[N = 10/40] Y NAME OF THIS SYSTEM (24 CHARS OR LESS)? SAMPLE WHAT IS THE SERIAL NUMBER OF YOUR ARITHMETIC PROCESSOR? 2 NAME OF SYSTEM DEVICE?[DTA0 USUAL FOR 10/40 SYSTEM, DSK USUAL FOR 10/50 SYSTEM] DSK LEVEL D SOFTWARE?[N = LEVEL C OR EARLIER] Y HOW MANY DF10 DATA CHANNELS FOR DISKS? 2 [ FOR EACH CHANNEL ANSWER THE FOLLOWING QUESTIONS: HOW MANY RC10 (FIXED HEAD) CONTROLLERS DO YOU HAVE? FOR EACH CONTROLLER, HOW MANY UNITS (BURROUGHS DISK OR BRYANT DRUM)? HOW MANY RP10 (MEMOREX DISK PACK) CONTROLLERS? FOR EACH CONTROLLER, HOW MANY UNITS (DRIVES)? HOW MANY RA10 (BRYANT DISK) CONTROLLERS? FOR EACH CONTROLLER, DUAL POSITIONER?] CHANNEL 0: RC10'S? 1 UNITS ON FHA? 2 RP10'S? 0 RA10'S? 0 CHANNEL 1: RC10'S? 0 RP10'S? 1 DRIVES ON DPA? 6 RA10'S? 0 .TEST PAGE 2 HOW MAY JOBS?[1 TO 128, ATTACHED AND DETACHED, COUNTING NULL JOB] 48 MAX SIZE OF CORE (IN K) FOR ANY SINGLE USER? 0 MEANS ALL OF CORE 30 PDP-10 PROCESSOR?[N = PDP-6] Y 2 RELOCATION REG. SOFTWARE?[Y = MUST HAVE KT10A, N = JUST 1 RELOC. REG.] Y HOW MANY MORE SEGMENTS THAN JOBS?[0 UNLESS YOU ANTICIPATE A LOT OF DORMANT SEGMENTS] 0 LOAD EXEC DDT?[N = ONLY IF LOADER HAS RUN OUT OF CORE BEFORE] Y LOAD LOCAL SYMBOLS?[N = ONLY IF LOADER HAS RUN OUT OF ROOM BEFORE] Y COMMON.MAC ALREADY EDITED FOR YOUR TTY CONFIGURATION?[ N = WILL ALLOW YOU TO DEFINE NOW] N BOTH DC10 AND 680?[N WILL ASK FOR DC10,680 OR 630 ALONE] Y HOW MANY DC10B (OR 632) 8-LINE DATA GROUPS?[ 1=TTY0-7, 2=TTY0-17, ... , 8=TTY0-77] 3 HOW MANY DC10E DATASET CONTROL GROUPS? 1 HOW MANY (OCTAL) LINES ON YOUR 680(I), INCLUDING ITS CONSOLE TELETYPE? 21 ANSWER THE FOLLOWING QUESTIONS ABOUT YOUR TELETYPE LINES: [TYPE OCTAL LINE NUMBERS, ONE PER LINE. TYPE EXTRA CR WHEN DONE.] .BLANK 1 DATA SET LINES?[PROJECT 1 CAN'T LOGIN, LOGIN RESETS LINE TO COMPUTER ECHOING AND NO HARDWARE TABS] 20 21 22 23 24 25 26 27 40 41 42 43 44 45 46 47 .BLANK 1 LINES WITH HARDWARE TABS?[MONITOR SIMULATES REST WITH SPACES] 0 1 2 3 4 5 6 7 10 11 12 13 14 15 .BLANK 1 REMOTE LINES?[PROJECT 1 CAN'T LOGIN,] 12 13 14 15 30 31 32 33 34 35 36 37 .BLANK 1 LOCAL COPY LINES? [ECHOING PROVIDED BY TERMINAL RATHER THAN BY COMPUTER. OFTEN (INCORRECTLY) CALLED "HALF DUPLEX".] .BLANK 1 HALF DUPLEX LINES?[TWX OR HALF DUPLEX WIRED SCANNED(DC10C)] 17 .BLANK 1 SLAVES? [NO COMMANDS MAY BE TYPED] .BLANK 1 LINES WITH HARDWARE FORMFEED? [LEAVE OUT IF USERS WOULD RATHER NOT GET FORMFEEDS UNTIL THEY DO TTY FORM COMMAND] 0 1 2 3 4 5 6 7 .BLANK 1 LINES WHICH RUN INITIA AT STARTUP? 0 1 2 3 16 .BLANK 1 WHAT IS THE CORRESPONDENCE BETWEEN THE DC10E LINES AND THE DC10B LINES? TYPE "_#,_#" FOR EACH DATASET. FIRST _# IS DC10E LINE, SECOND _# IS DC10B LINE.[_# IS AN OCTAL NUMBER. TYPE ONE _#,_# PER LINE, EXTRA CR WHEN DONE.] 30,20 31,21 32,22 33,23 34,24 35,25 36,26 37,27 .BLANK 1 PT READER? Y PT PUNCH? Y PLOTTER? Y HOW MAY LINE PRINTERS?[0,1 OR 2] 1 MOVIE?[DYNAMIC MONITORY DUMP ON LPT] Y CARD READER? Y CR10?[Y = CR10A TOO, N IF PDP-6 CARD READER] Y CARD PUNCH? Y DISPLAY? N HOW MANY DECTAPES?[0 TO 8] 8 TD10 DECTAPE CONTROL?[N = PDP-6 DECTAPE] Y HOW MANY MAGTAPES?[0 TO 8] 2 TM-10A CONTROL?[N = WILL ASK TM-10B, THEN PDP-6 MAGTAPES] Y HOW MANY PSEUDO-TTY'S?[0 TO 64, EACH CONCURRENT BATCH NEEDS ONE] 5 DO YOU WNAT CCL COMMANDS TO STAY IN CORE?[ N = STAY ON DISK] Y HOW MANY WORDS?0 GIVES STD[AVERAGE 20 WORDS/JOB] 0 WHAT LIMIT PER JOB? 0 GIVES STD[40 WORDS] 0 DO YOU WANT TO LOCK JOBS IN CORE?[REQUIRED FOR REAL-TIME] Y WHAT IS THE MINIMUM AMOUNT OF CORE (IN K) TO BE GUARANTEED TO JOBS THAT ARE NOT LOCKED? [0 ASSUMES MAXIMUM] 10 HOW MANY REAL-TIME DEVICES? [TYPE THE MAXIMUM NUMBER OF REAL- TIME DEVICES WHICH COULD BE PUT ON THE PI LEVELS SIMULTANEOUSLY] 5 HOW MANY HIGH PRIORITY QUEUES?[MAX 15] 5 TYPE "SYMBOL,VALUE" (VALUE IN DECIMAL)[FOR ANY SYMBOLS TO BE DEFINED. NEXT QUESTION WILL ASK FOR OCTAL DEFINITION. TYPE EXTRA CARRIAGE RETURN WHEN THROUGH.] JIFSEC,50 .BLANK 1 TYPE "SYMBOL,VALUE" (VALUE IN OCTAL)[FOR ANY SYMBOLS TO BE DEFINED. TYPE EXTRA CARRIAGE RETURN WHEN THROUGH.] .BLANK 1 TYPE "DEVICE-MNEMONIC,CHANNEL"FOR SPECIAL DEVICES[ WITH NEITHER CHANNEL SAVE ROUTINE NOR DEVICE DATA BLOCK. "DEVICE" MUST BE 3 CHARACTERS OR LESS. TYPE EXTRA CARRIAGE RETURN WHEN THROUGH.] .BLANK 1 TYPE "DEVICE-MNEMONIC, CHANNEL, NO.-OF-DEVICES"[ FOR SPECIAL DEVICES WITH DEVICE DATA BLOCKS "DEVICE" MUST BE 3 CHARS. OR LESS. TYPE EXTRA CARRIAGE RETURN WHEN THROUGH.] .BLANK 1 TYPE "DEVICE-MNEMONIC,CHANNEL,HIGHEST-AC-TO-SAVE[ FOR SPECIAL DEVICE WITH CHANNEL SAVE ROUTINES TO SAVE AC'S UP TO "HIGHEST-AC-TO-SAVE". "DEVICE" MUST BE 3 CHARS. OR LESS. TYPE EXTRA CARRIAGE RETURN WHEN THROUGH.] .BLANK 1 DO YOU WANT REMOTE STATION SOFTWARE? Y WHAT IS THE OCTAL STATION NUMBER OF THE PDP-10 CENTRAL SITE (1-77)?[ THE CENTRAL SITE IS THE LOCATION OF THE PDP-10] 2 HOW MANY PDP11 FRONT END'S DO YOU HAVE[ NEXT TWO QUESTIONS ASK FOR DS10'S AND DP01-CA'S, RESPECTIVELY]? 0 HOW MANY DS10'S ?[NEXT QUESTION WILL ASK FOR DP01-CA'S] 2 HOW MANY DP01-CA'S? 2 ANSWER THE FOLLOWING QUESTIONS FOR EACH REMOTE SATELLITE STATION YOU INTEND TO SUPPORT [WHETHER PERMANENTLY CONNECTED OR DIAL UP]. REPLY 0 STATION NUMBER TO END LOOP..... TYPE OCTAL STATION NUMBER TO BE DEFINED:[ 1 TO 77, NOT EQUAL CENTRAL NUMBER] 12 LINE PRINTER?[AT THIS STATION] Y CARD READER? Y TYPE OCTAL STATION NUMBER TO BE DEFINED:[ 1 TO 77, NOT EQUAL CENTRAL NUMBER] 16 LINE PRINTER?[AT THIS STATION] Y CARD READER Y TYPE OCTAL STATION NUMBER TO BE DEFINED:[ 1 TO 77, NOT EQUAL CENTRAL NUMBER] 0 [MONGEN FINISHED NEXT YOU MUST ASSEMBLE COMMON AND COMMOD WITH MACRO THEN LOAD IT AND REST OF MONITOR WITH LOADER AND FINALLY SAVE IT WITH MONITOR COMMAND SAVE .BLANK 1 TO ASSEMBLE, TYPE: R MACRO DSK:COMMON,LPT:__DSK:S,CONFIG,COMMON DSK:COMMOD,LPT:__DSK:S,CONFIG,COMMOD TO LOAD NEW MONITOR, TYPE: R LOADER /S DSK:COMMON,COMMOD,DSK:TOPS10/L LPT:__/A/M/P/G TO SAVE MONITOR, TYPE: SAVE DSK MONITOR END OF CONFIGURATION DEFINITION SUBTTL ] EXIT _. .PAGE .FILL .JUSTIFY .RIGHT MARGIN 60 .LEFT MARGIN 0 .CENTER ^^APPENDIX B - DECIMAL DEFAULT VALUES\\ .LEFT MARGIN 0 .BLANK 1 ^THE FOLLOWING LIST IS A DESCRIPTION OF THE STANDARD SYMBOLS AND DEFAULT DECIMAL VALUES, ASSUMED BY THE ^^MONGEN\\ PROGRAM. .LEFT MARGIN 5 .BLANK 1 .INDENT -5 ^^JIFSEC\\,60 .BREAK ^POWER FREQUENCY IN ^HERTZ (CYCLES PER SECOND). ^INSTALLATIONS WITH A POWER FREQUENCY OF ^^50H\\Z SHOULD CHANGE THE SYMBOL FOR CORRECT ACCOUNTING AND TIME OF DAY. .BLANK 1 .INDENT -5 ^^DTTRY\\,4 .BREAK ^NO. OF TIMES TO TRY ON ^^DEC\\TAPE ERRORS. .BLANK 1 .INDENT -5 ^^MTSIZ\\,128 .BREAK ^SIZE OF MAGTAPE RECORDS IN 36-BIT WORDS. ^THE USER CAN OVERRIDE THIS VALUE BY THE .^^SET BLOCK MTA\\N: SIZE COMMAND. ^PROGRAMS CAN OVERRIDE THIS PARAMETER BY BUILDING SPECIAL BUFFERS. .BLANK 1 .INDENT -5 ^^LPTSIZ\\,29 .BREAK ^SIZE OF ^^LPT\\ BUFFER+2. ^ALLOWS A FULL LINE TO BE TYPED ON A 132 CHARACTER LINE PRINTER IN ONE BUFFER. ^THIS CONSTANT SHOULD BE CHANGED TO 26 WITH A 120 CHARACTER LINE PRINTER. .BLANK 1 .INDENT -5 ^^NSPMEM\\,1000 .BREAK ^NUMBER OF NANOSECONDS PER MEMORY CYCLE. ^THIS SYMBOL IS USED TO COMPUTE THE AMOUNT OF TIME SPENT CORE SHUFFLING AND IS PRINTED BY THE ^^SYSTAT\\ COMMAND. ^FOR ^^MB\\10 MEMORIES, THE CONSTANT SHOULD BE CHANGED TO 1760. .BLANK 1 .INDENT -5 ^^MINCOR,JOBN\\*90 [^^DISK SYSTEMS\\] .BREAK ^THE MONITOR RESERVES A TABLE OF AT LEAST ^^MINCOR\\ WORDS OR POSSIBLY UP TO THE NEXT 1K BOUNDARY FOR ALLOCATING DISK DEVICE DATA BLOCKS AND EXTENDED PUSH DOWN LISTS.^^MINCOR\\ IS NORMALLY ^^JOBN\\*90 WORDS ALLOWING 2.5 OPEN DISK FILES PER JOB. ^IF THIS VALUE IS TOO SMALL A LARGER VALUE MAY BE SUPPLIED. ^THE TOTAL SIZE OF THE MONITOR IS PRINTED AFTER THIS SPACE IS RESERVED IN THE LONG ONCE ONLY DIALOGUE. .BLANK 1 .INDENT -5 ^^MINCOR,JOB*40 [NON-DISK SYSTEMS\\] .BREAK ^THE MONITOR RESERVES SPACE FOR AT LEAST ^^MINCOR\\ WORDS OR POSSIBLY UP TO THE NEXT 1K BOUNDARY FOR ALLOCATING EXTENDED PUSH DOWN LIST SPACE. ^THIS PARAMETER SHOULD BE SET SMALLER IF CORE SPACE IS A PROBLEM, SINCE THE EXEC PUSHDOWN LIST IS ALLOCATED DYNAMICALLY ON OVERFLOW, AND NOT ALL JOBS HAVE OVERFLOW AT THE SAME TIME. .BLANK 1 .INDENT -5 ^^LOGSIZ\\,3 .BREAK ^MINIMUM AMOUNT OF VIRTUAL CORE REQUIRED FOR A USER TO BE LOGGED IN. ^THIS VALUE MUST BE AT LEAST AS LARGE AS THE ^^LOGIN CUSP\\, CURRENTLY 3^K. ^IF THE AMOUNT OF CORE IS INSUFFICIENT THE USER RECEIVES THE USUAL CORE UNAVAILABLE MESSAGE, WHICH INCLUDES THE AMOUNT OF VIRTUAL CORE REMAINING. .BLANK 1 .INDENT -5 ^^STRMAX\\,14 .BREAK ^THE MAXIMUM NUMBER OF DISK FILE STRUCTURES THAT CAN BE ON LINE SIMULTANEOUSLY. ^DECREASING THIS VALUE SAVES ONE WORD PER VALUE. .BLANK 1 .INDENT -5 ^^CCWMAX\\,10 .BREAK ^THE MAXIMUM LENGTH IN WORDS OF A DISK CHANNEL COMMAND LIST. ^ALTERING THIS VALUE AFFECTS EFFICIENCY AND SPACE. .BLANK 1 .INDENT -5 ^^SWPMAX\\,8 .BREAK ^THE MAXIMUM NUMBER OF DISK UNITS THAT MAY BE USED FOR SWAPPING. (1 WORD PER UNIT). .BLANK 1 .INDENT -5 ^^SWCLSN\\,7 .BREAK ^THE HIGHEST CLASS NUMBER FOR SWAPPING. .BLANK 1 .INDENT -5 ^^DSKTRY\\,10 .BREAK ^NUMBER OF TIMES TO TRY ON DISK ERRORS BEFORE RECALIBRATING, INCLUDING THE INITIAL TRY. .BLANK 1 .INDENT -5 ^^SERTRY\\,3 .BREAK ^NUMBER OF TIMES TO TRY ON SEARCH ERRORS BEFORE RECALIBRATING, INCLUDING THE INITIAL TRY. .BLANK 1 .INDENT -5 ^^RCLTRY\\,10 .BREAK ^NUMBER OF TIMES TO RECALIBRATE AND TRY ON "^^DSKTRY\\" DISK ERRORS OR ON "^^SERTRY\\" SEARCH ERRORS, INCLUDING THE INITIAL TRY. ^TOTAL NUMBER OF DISK TRIES WITH RECALIBRATION, IS ^^DSKTRY\\*^^RCLTRY\\ (10*10=100). ^TOTAL NUMBER OF SEARCH TRIES WITH RECALIBRATION IS ^^SERTRY\\*^^RCLTRY\\(3*10=30). .BLANK 1 .INDENT -5 ^^CHVIFP\\,10 .BREAK ^STANDARD FAIRNESS COUNT FOR POSITIONING. ^THE MONITOR CHOOSES THE NEAREST REQUEST FOR POSITIONING (^^CHVFP\\ TIMES -1) BEFORE TAKING THE LONGEST WAITING REQUEST. .BLANK 1 .INDENT -5 ^^CH\\0^^IFP\\, ^^CHVIFP\\ ... ^^CH7IFP,CHVIFP\\ .BREAK ^FAIRNESS COUNT FOR POSITIONING ON CHANNEL 0....7. .BLANK 1 .INDENT -5 ^^CHVIFT\\,10 .BREAK ^STANDARD FAIRNESS COUNT FOR TRANSFERS. ^THE MONITOR CHOOSES THE SHORTEST LATENCY FOR A TRANSFER (^^CHVIFT\\ TIMES -1) BEFORE TAKING THE LONGEST WAITING REQUEST. .BLANK 1 .INDENT -5 ^^CH0IFT,CHVIFT ... CH7IFT,CHVIFT\\ .BREAK ^FAIRNESS COUNT FOR TRANSFERS ON CHANNEL 0,...7. .BLANK 1 .INDENT -5 ^^PTRLEN\\,10 .BREAK ^NUMBER OF IN-CORE RETRIEVAL POINTERS PER DISK ^^DDB\\. .BLANK 1 .INDENT -5 ^^EPL4WD\\,10 .BREAK ^ONE-FOURTH THE LENGTH OF THE MAXIMUM EXEC PUSH DOWN LIST WHEN EXTENDED. .BLANK 1 .INDENT -5 ^^FIL4WD\\,10 .BREAK ^NUMBER OF 4 WORD BLOCKS ALLOCATED PER JOB IN A COMMON POOL OF MONITOR FREE CORE. ^THE VALUE OF ^^FIL4WD\\ SHOULD BE INCREASED IF ^^ENTER#UUO\\ ERROR CODE 16 (.^^ERNET\\) IS RECEIVED REGULARLY. ^TO ASSIGN THIS SPACE THE ONCE ONLY CODE MULTIPLIES THIS FACTOR BY THE NUMBER OF JOBS. ^THESE BLOCKS ARE USED BY THE ^^LEVEL D DISK\\ SERVICE FOR ACTIVE, DORMANT, AND FREE ^^ACC, AKB, NMB, PPB\\, AND ^^UFB\\ BLOCKS. ^THIS POOL IS PERMANENTLY RESERVED FOR THESE BLOCKS AND IS NOT USED FOR ANY OTHER PURPOSE. ^ANOTHER POOL IS USED FOR VARIABLE LENGTH CORE BLOCKS SUCH AS DISK DEVICE DATA BLOCKS, AND EXTENDED EXEC PUSH DOWN LISTS. ^THE SYSTEM SETS THE MINIMUM NUMBER OF 4 WORD CORE BLOCKS AT (10 TIMES 5 OR) 50 WITH 5 OR FEWER JOBS. .BLANK 1 .INDENT -5 ^^UNVRSF\\,500 .BREAK ^THE RECIPROCAL FACTOR OF THE TOTAL DISK SIZE. ^THIS AMOUNT OF DISK SPACE IS SUBTRACTED FROM THE NUMBER OF FREE BLOCKS WHEN THE MONITOR IS STARTED UP. ^THIS AREA IS NOT AVAILABLE FOR USERS' DATA. ^IT IS A SAFETY FACTOR THAT ENSURES THERE IS ROOM TO WRITE THE SECOND ^^RIB\\, ETC. ^THE STANDARD RESERVED FOR THIS PURPOSE IS ONE-FIVE HUNDREDTH OF THE DISK SPACE. .BLANK 1 .INDENT -5 ^^LBNHOM\\,1 ^^LB2HOM\\,10 .BREAK ^STANDARD LOGICAL BLOCK NUMBERS ON EACH UNIT THAT CONTAIN THE HOM BLOCK. .BLANK 1 .INDENT -5 ^^MFDSIZ\\,8 .BREAK ^NUMBER OF BLOCKS ALLOCATED TO THE ^^MFD\\ BY THE REFRESHER IN EACH FILE STRUCTURE. ^THE ^^MFD\\ CAN BE LONGER THAN THIS BUT THERE IS A SPEED ADVANTAGE TO CONSECUTIVE BLOCKS. ^INCREASE THIS VALUE IF THE ^^MFD\\ IS NORMALLY LONGER THAN 8 BLOCKS. .BLANK 1 .INDENT -5 ^^MBFN\\,2 .BREAK ^NUMBER OF 128-WORD MONITOR BUFFERS USED FOR READING AND WRITING NON-USER DATA. (^MUST BE AT LEAST 2.) .BLANK 1 .INDENT -5 ^^UNIQ1,1 UNIQ2,1.......UNIQ6,1\\ .BREAK ^REPRESENT PRIORITY INTERRUPT CHANNELS RESERVED FOR THE EXCLUSIVE USE OF A SPECIAL DEVICE. ^IF PRIORITY INTERRUPT CHANNELS ARE TO BE RESERVED, SET THE VALUE OF ^^UNIQ\\N TO 1, WHERE N IS THE CHANNEL NUMBER. ^FOR EXAMPLE, IF A REAL TIME DEVICE REQUIRES EXTREMELY FAST RESPONSE TIME, IT IS NECESSARY TO SET ^^BLKI\\/^^BLKO\\ POINTER IN THE CHANNEL LOCATION. (^CHANNEL 7 CANNOT BE RESERVED, IT IS ALWAYS USED FOR THE CLOCK. .BLANK 1 .INDENT -5 ^^MINMAX\\,10240 [10^K] .BREAK ^SMALLEST VALUE OF ^^CORMAX\\ ALLOWED TO BE SET AFTER SYSTEM STARTS (WORDS) .PAGE .CENTER ^^APPENDIX C - OCTAL DEFAULT VALUES\\ .BLANK 1 .LEFT MARGIN 0 ^THE FOLLOWING LIST IS A DESCRIPTION OF THE STANDARD SYMBOLS AND DEFAULT OCTAL VALUES ASSUMED BY THE ^^MONGEN\\ PROGRAM. .BLANK 1 .LEFT MARGIN 5 .INDENT -5 ^^STDENS\\,3 .BREAK ^STANDARD MAGTAPE DENSITY IF THE USER PROGRAM DOES NOT OVERRIDE WITH NON-ZERO VALUES IN ^^INIT, OPEN\\, OR ^^SETSTS UUO\\. .BLANK 1 .INDENT 5 .NOFILL .NOJUSTIFY 1##^^BINARY (ODD) PARITY + 200 BPI\\ .INDENT 5 2##^^BINARY (ODD) PARITY + 556 BPI\\ .INDENT 5 3##^^BINARY (ODD) PARITY + 800 BPI\\ .BLANK 1 .INDENT 5 5##^^BCD (EVEN) PARITY + 200 BPI\\ .INDENT 5 6##^^BCD (EVEN) PARITY + 556 BPI\\ .INDENT 5 7##^^BCD (EVEN) PARITY + 800 BPI\\ .FILL .JUSTIFY .BLANK 1 .INDENT -5 ^^INDPPN\\,0 .BREAK ^IF ^^INDPPN\\=0, THEN EACH PROGRAMMER NUMBER REFERS TO THE SAME PERSON IN EVERY PROJECT. .BREAK ^IF ^^INDPPN\\=777777, THEN PROGRAMMER NUMBERS MAY BE ASSIGNED INDEPENDENTLY WITHIN EACH PROJECT. ^THIS AFFECTS ONLY THE DISK FILE ACCESS PROTECTION MECHANISM. .BLANK 1 .INDENT -5 ^^PRVFIL\\,057 .BREAK ^STANDARD FILE PROTECTION. .BLANK 1 .INDENT -5 ^^PRVUFD\\,775 .BREAK ^STANDARD ^^UFD\\ PROTECTION. .BLANK 1 .INDENT -5 ^^SYRDPR\\,555000 .BREAK ^NON PROTECTED FILES IN ^^SYS\\ (^^HOME.SYS, SAT.SYS\\). ^SET BY REFRESHER. .BLANK 1 .INDENT -5 ^^SYNRPR\\,557000 .BREAK ^PRIVILEGED FILE PROTECTION IN ^^SYS\\ (^^CRASH.SAV, SNAP.SYS, RECOV.SYS, BADBLK.SYS, SWAP.SYS\\). ^USED BY REFRESHER. .BLANK 1 .INDENT -5 ^^MFDPRV\\,555000 .BREAK ^^MFD\\ PROTECTION. ^ALL CAN READ, LOOKUP, BUT NOT CREATE. ^SET BY REFRESHER. .BLANK 1 .INDENT -5 ^^SYSPRV\\,775000 .BREAK ^^SYS UFD\\ PROTECTION [PROJECT, PROGRAMMER=1,4] (^PROJECT 1 CAN ^^READ, CREATE, LOOKUP\\; OTHERS CAN ^^READ, LOOKUP\\ ONLY.) ^SET BY REFRESHER. .BREAK