SYSGEN.DOC DISCLAIMER This document file was created by scanning the original document and then editing the scanned text. As much as possible, the original text format was restored. Some format changes were made to insure this document would print on current laser printers using 60 lines per page. The original spelling and grammar has been preserved. 1-Sep-1996 RTS/8 System Generation Manual Order No. AA-D943A-TA February 1979 ABSTRACT This manual describes the procedure by which a user generates an RTS/8 realtime operating system. After answering System Generation questions, the program can automatically build, using OS/8 BATCH and MACREL/LINK, an RTS/8 system with little or no user intervention. The System Generation procedure is a flexible one that presents the user with the minimum number of questions needed to build a system. As user systems may vary significantly, the RTS/8 System Generation permits modifications in its interactive dialogue so that the System Generation is unique to a user's needs. SUPERSESSION INFORMATION: This is a new manual. VERSION: V01 ------------------------------------------------------------ | To order additional copies of this document, contact the | | Software Distribution Center, Digital Equipment | | Corporation, Maynard, Massachusetts 01754 | ------------------------------------------------------------ digital equipment corporation - maynard. massachusetts First Printing, February 1979 The information in this document is subject to change without notice (and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may only be used or copied in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by DIGITAL or its affiliated companies. Copyright (c) 1979 by Digital Equipment Corporation The postage-prepaid READER'S COMMENTS form on the last page of this document requests the user's critical evaluation to assist us in preparing future documentation. The following are trademarks of Digital Equipment Corporation: DIGITAL DECsystem-10 MASSBUS DEC DECtape OMNIBUS PDP DIBOL OS/8 DECUS EDUSYSTEM PHA UNIBUS FLIP CHIP RSTS COMPUTER LABS FOCAL RSX COMTEX INDAC TYPESET-8 DDT LAB-8 TYPESET-11 DECCOMM DECSYSTEM-20 TMS-11 ASSIST-11 RTS-8 ITPS-10 VAX VMS SBI DECnet IAS PDT DATATRIEVE TRAX CONTENTS Page PREFACE v CHAPTER 1 INTRODUCTION 1-1 CHAPTER 2 THE SYSGEN DIALOGUE 2-1 2.1 OVERVIEW 2-1 2.2 THE DIALOGUE 2-2 2.3 PASS 2 AND BATCH 2-46 2.4 RTS/8 SYSGEN DOCUMENT NUMBERS 2-51 CHAPTER 3 TWO EXAMPLE SYSGENS 3-1 3.1 OVERVIEW 3-1 3.2 A DEFAULT SYSGEN 3-1 3.3 A NORMAL SYSGEN 3-4 CHAPTER 4 MODIFYING THE SYSGEN 4-1 4.1 OVERVIEW 4-1 4.2 THE STRUCTURE OF SCRIPT.MA 4-1 4.2.1 Record Directory 4-2 4.2.2 Script Records 4-3 4.2.3 Parameter Records 4-10 4.2.4 Skeleton Records 4-12 4.2.5 Error Message Records 4-12 4.2.6 LINK and MACREL BATCH Records 4-12 4.2.7 Limit Records 4-12 4.3 EXAMPLES 4-13 4.3.1 Deleting Questions 4-13 4.3.2 Adding Questions 4-17 4.3.3 Changing the Default 4-31 4.3.4 Multiple TTY Systems 4-34 APPENDIX A RTS/8 SYSTEM GENERATION SOURCE FILES A-1 APPENDIX B DEC/X8 SPECIFICATION SHEET B-1 APPENDIX C SYSGEN CHECK LIST C-1 APPENDIX D RTS/8 PARAMETER LISTING D-1 APPENDIX E ERROR MESSAGES E-1 INDEX Index-1 iii PREFACE This manual describes the RTS/8 system generation procedure. System generation, or SYSGEN, is an interactive procedure you use when building RTS/8 operating systems from source modules. These source modules are tasks that DIGITAL supplies and tasks that you create. In addition, the design of the RTS/8 SYSGEN script allows you to make changes in the interactive dialogue so that the SYSGEN procedure itself more precisely meets your needs. The manner in which you program an RTS/8 operating system after it is running is described in the RTS/8 User's Manual, V3. This SYSGEN manual assumes that you are familiar with the DIGITAL-supplied tasks as they are described in the User's Manual. For example, the RTS/8 Monitor Console Routine is not described. You are expected to have read the sections of the User's Manual which describe it. The RTS/8 SYSGEN, among other functions, allows you to incorporate various device handlers into your RTS/8 system. However, this manual does not attempt to describe the devices themselves. It assumes you know which devices are in your system and are familiar with the information contained in the hardware manual that you received when you purchased the device. For example, no attempt is made to describe an RLO1 disk. The first three chapters of this manual introduce and explain the SYSGEN. Chapter 1 is an overview of the SYSGEN process. The portion of the SYSGEN that is most visible to a user is the interactive dialogue. Chapter 2 discusses this dialogue. Any SYSGEN you perform uses portions of this dialogue. As Chapter 2 presents the dialogue in its entirety, you may find it difficult to see the continuity and flow inherent in the information the SYSGEN prints. Consequently, Chapter 3 is a listing of two example SYSGENs. The advanced user may wish to change the SYSGEN so that it more precisely conforms to the kinds of systems that will be built. The final chapter details how you may tailor the SYSGEN procedure to your needs. v CHAPTER 1 INTRODUCTION RTS/8 SYSGEN is the procedure you use to build a real-time operating system. Unless you decide to reconfigure the SYSGEN (see Chapter 4), most of the operations that the SYSGEN performs are invisible to you; that is, the operations the SYSGEN performs are not seen and, in most cases, are not important to what you are doing. The minimum memory size that you will need to run the SYSGEN is 12K. Also, the SYSGEN program, SYSGEN.SV, must reside on SYS and the dialogue must reside on a mass storage device. If you chain to BATCH, you will need a 16K system. In addition, you conceivably may require more memory than 16K if you are creating a large RTS/8 system. The SYSGEN program produces three batch files that OS/8 BATCH uses to create the RTS/8 system. The SYSGEN may also create TTY and floppy disk control files. These files contain information that is specific to a particular TTY or floppy device. When MACREL creates the .RB (Relocatable Binary) file, it uses the equates in these control files to create a task that is specific to your configuration. The SYSGEN is an interactive dialogue; that is, it asks you questions and you supply answers. After you answer the questions, the SYSGEN builds a real-time operating system that consists of an Executive (the routines that control task execution) and other tasks. These other tasks are either DIGITAL-supplied tasks or those that you create. You may also build an RTS/8 system that consists of a real-time operating system foreground and an OS/8 background. In such a system, the real-time tasks have primary control of the computer. When these tasks do not need to use the computer, OS/8 can run; that is, OS/8 runs in the "background" of the RTS/8 operating system. You begin executing the SYSGEN, called SYSGEN.SV on its distribution medium, by typing R SYSGEN in response to the OS/8 prompt. (The SYSGEN runs only under OS/8 and SYSGEN.SV must be on SYS.) If SYSGEN.SV is not on SYS, you must use an OS/8 COPY command to bring it to SYS. The program then asks you which device contains the interactive dialogue. The dialogue, called SCRIPT.SV on the distribution medium, can either reside on SYS or on any other file-structured device that OS/8 recognizes. If the dialogue is on SYS, you type a carriage return. Otherwise, type the OS/8 device name. 1-1 INTRODUCTION After you respond to this question, the SYSGEN dialogue begins. In general, each question is composed of three parts. The first is the question itself. The second is a string within square brackets []. This string indicates the type of response you must type; for example [D] means decimal, [Y/N] means YES/NO and so on. The third portion, within parentheses, indicates the default answer. For example: DO YOU WANT ASSEMBLY LISTINGS [Y/N] (N): In this question, N (meaning no) is the default answer that you select by typing a carriage return. Many of the questions pertain to DIGITAL supplied tasks. For some of the DIGITAL tasks, you need only state that you wish to include that task in the RTS/8 system. Other DIGITAL tasks may require more than one response. For example, if you include the RTS/8 Monitor Console Routine, the SYSGEN eventually asks if you wish to include the SYSTAT command. The first series of SYSGEN questions ask you to supply information about the computer on which you will run RTS/8. A second series of questions ask where the SYSGEN should store output files, what it should do with the output files, and other similar information. For example, you may create an RTS/8 system that provides you with assembly listings, linker load maps, and comes up running. The SYSGEN then asks which DIGITAL tasks you wish to include in the system. It then asks questions about these tasks (if applicable). The last questions of the dialogue ask if you wish to include user tasks and in which partitions you wish them to reside (if the task is nonresident), if you wish to change task priorities, and if the partition allocation is correct. During any one session, the SYSGEN does not print all the questions it is capable of asking because questions may be mutually exclusive. For example, if you state that the computer upon which RTS/8 will execute does not include EAE hardware, the SYSGEN does not ask if you wish to save the contents of the EAE registers. Consequently, you see only the questions that are necessary to build the system. While typing answers, you may edit your response by using the delete key or erase the entire answer with a CTRL/U. If, however, you type an incorrect response, the SYSGEN prints an error message and then reprints the question. A list of error messages appears in Appendix E. In general, you must provide four types of information to the SYSGEN. o You must tell the SYSGEN what actions it is to perform when it completes the interactive dialogue. These actions include writing output files, creating listings, and chaining to the RTS/8 system. 1-2 INTRODUCTION o You must provide information that tells the SYSGEN which machine you are creating an RTS/8 system for and the kinds of hardware (not peripherals) that exist in the configuration. o You must specify which of the DIGITAL tasks you will include in the system. The DIGITAL tasks, for the most part, are handlers for peripheral devices. Other DIGITAL tasks are the Monitor Console Routine and the Power Fail Task. For some of the DIGITAL tasks, you must provide specific hardware information such as the peripheral's device code. o You can place tasks that you write into the RTS/8 system. You may also make any user task nonresident and place it into a partition. When you begin a SYSGEN, you should have all the information you will need with you at the terminal. Appendix C is a checklist of SYSGEN questions. Using a copy of this form, you can fill in your responses before you sit down at the terminal. In addition, this form documents the systems that you create. The RTS/8 SYSGEN also allows you to create a unique SYSGEN procedure as well as a unique operating system. By customizing the SYSGEN procedure, you create an interactive dialogue and presentation that best fits your needs. For example, the SYSGEN contains questions on RF02 and DF32 fixed head disks and LINCtapes. If your system does not contain these devices, you may make a simple change in SCRIPT.MA (the source program for SCRIPT.SV) using any text editor. These changes prevent the SYSGEN from asking these questions. The following two chapters present the SYSGEN dialogue. For the novice user of the SYSGEN, these are the only chapters that need be read as they discuss the SYSGEN that DIGITAL distributes. The user who wishes to make modifications in the SYSGEN dialogue should read Chapter 4, which discusses how you can delete questions, add questions, and change the default system. 1-3 CHAPTER 2 THE SYSGEN DIALOGUE 2.1 OVERVIEW This chapter describes RTS/8 SYSGEN questions, expected answers, SYSGEN remarks, and SYSGEN run paths. Because the SYSGEN chooses the questions it prints (basing its choices on the answers you give to other questions), some of the questions in this chapter may appear to be out of order. In addition, other questions were purposely printed here in a different order so that you may more fully understand the material that the SYSGEN offers. Chapter 3 is closely related to this chapter in that it consists entirely of two example dialogues. (These examples present the dialogue in the order they would appear on your terminal.) The following section contains four types of information. o The first is the question that the SYSGEN prints. SYSGEN questions appear in capital letters and begin at the left margin. o The second is the remark, also printed in capital letters, that the SYSGEN prints if you ask it to. The remarks are indented from the left margin. (The SYSGEN does not indent these remarks when it prints them.) o The third type of information is remarks that the SYSGEN always prints. These remarks appear in capital letters and also begin at the left margin. To distinguish these remarks from questions, each line of the remark is followed by the word "remark" in this chapter. o The fourth kind of information is a further explanation of the question. This explanation (in upper and lower case) is not part of the SYSGEN. Some of the upper and lower case explanations state that if you are unsure if something exists in your system or if you do not have some information, such as a device code, you should check with your system manager or your sales representative. You can also check the form that DIGITAL provided when you purchased your system. This form, reproduced as Appendix B, lists the device codes. In this sample, note that the devices you purchased are listed in column 1 and the device codes in column 2. 2-1 THE SYSGEN DIALOGUE 2.2 THE DIALOGUE Before running the SYSGEN, you should type an OS/8 SET TTY NO PAUSE command because page pauses are unnecessary (and distracting) when running the SYSGEN program. The machine you use to create the RTS/8 system must contain 12K of memory. If you will chain to BATCH, as will be discussed below, you must have sufficient memory to assemble and link the system (ordinarily, 16K). You begin the SYSGEN by running the SYSGEN.SV program. This program runs only under OS/8. If SYSGEN is not on the system device, you must copy it to SYS. After the OS/8 monitor prompt, type R SYSGEN After the SYSGEN is running, it prints the question: ON WHAT DEVICE IS SCRIPT.SV LOCATED ? : SCRIPT.SV is the file that contains the interactive dialogue. If SCRIPT.SV is on SYS, type a carriage return. Otherwise, type the OS/8 name of the device upon which the file SCRIPT.SV resides. The SYSGEN program then begins printing the interactive dialogue. RTS/8 V03 SYSTEM BUILDER PROGRAM V01. remark remark THIS PROGRAM IS A CONVERSATIONAL remark QUESTION AND ANSWER SYSTEM FOR remark BUILDING RTS/8 REAL TIME SYSTEMS. remark remark THE QUESTIONS AND EXPLANATIONS IN THIS remark DIALOGUE ARE BRIEF. CHAPTER 2 IN THE remark SYSTEM GENERATION MANUAL INCLUDES AD- remark DITIONAL INFORMATION. remark DO YOU WANT PROGRAM OPERATION INFORMATION? (YOU MAY TYPE Y FOR YES OR N FOR NO FOLLOWED BY A CARRIAGE RETURN): If you answer "Y" to this question, you receive an explanation of how you interact with the SYSGEN dialogue. If you are using this program 2-2 THE SYSGEN DIALOGUE for the first time, you should read these instructions carefully. (The following paragraphs also explain how to use the SYSGEN program.) The standard SYSGEN question has the following format NUMBER QUESTION ANSWER-TYPE DEFAULT Each of these elements is discussed in the following paragraphs. An example of a question that the SYSGEN prints is 003 DO YOU WISH TO BUILD AN RTS/8 SYSTEM WITHOUT SPECIFYING PARAMETERS? [Y/N] (N): The SYSGEN discussion begins with a description of the answer-types that SYSGEN expects to a question. YES OR NO ANSWERS ARE INDICATED BY A [Y/N] NOTATION. TYPE A 'Y' FOR YES OR AN 'N' FOR NO, FOLLOWED BY A CARRIAGE RETURN, TO ANSWER THE QUESTION. Answer a YES/NO question with a Y or N or with a YES or NO. Note that the SYSGEN does not record your response to a question until you type a carriage return. QUESTIONS REQUIRING A NUMERICAL RESPONSE ARE INDICATED BY A [D] FOR DECIMAL OR AN [O] FOR OCTAL. ENTER THE NUMBER FOLLOWED BY A CARRIAGE RETURN. (ALWAYS INTEGER) If your response to a question is a number, type the number and then type a carriage return. The SYSGEN checks to ensure that numerical responses do not contain non-numeric characters. SYSGEN always checks to determine if numerical answers are within acceptable limits. For example, if your answer to a question was 100 (octal) and the largest answer SYSGEN allows for the question is 77 (octal), the SYSGEN prints an error message. Also, if your answer is greater than six digits long, SYSGEN prints an error message. (Some teletype questions accept only five character or digit answers.) If the expected response is an octal number, SYSGEN rejects any number that contains an 8 or 9 and prints an error message. Chapter 4 discusses how SYSGEN evaluates numerical answers and how you may change the limits. 2-3 THE SYSGEN DIALOGUE ARE YOU READY TO CONTINUE? [Y/N] (Y): When you finish reading the above instructions, type a response to the ARE YOU READY question. You may type a Y or, because Y is the default answer, a carriage return. (See below for an explanation of default answers.) If you type an N, the SYSGEN repeats the question. Any other response produces an error message. This question exists so that the SYSGEN does not print further instructions until you tell it that you are ready. (If you are displaying the information on a hard copy terminal, you may wish to remove this question. See Chapter 4.) After you answer this question, SYSGEN types additional information. QUESTIONS REQUIRING AN ALPHANUMERIC ANSWER ARE INDICATED BY [A]. RESPOND BY TYPING THE ALPHANUMERIC DATA FOLLOWED BY A CARRIAGE RETURN. The error-checking that the SYSGEN performs on alphanumeric answers determines if you type too many characters and if the answer contains characters other than the upper case letters A through Z and the numbers 0 through 9. Because many alphanumeric responses are device specifications, you must be especially careful that you enter these responses correctly. If you do not, OS/8 BATCH or the generated RTS/8 system cannot execute. IF YOU WOULD LIKE AN EXPLANATION OF A QUESTION, TYPE A ? FOLLOWED BY A CARRIAGE RETURN. THE PROGRAM THEN PRINTS AN EXPLANA TION AND ALSO REPRINTS THE QUESTION. Most questions have explanations. The purpose of these explanations is to jog your memory about what the question is asking. For more information, you should read this manual, the appropriate hardware manual, or the RTS/8 User's Manual. ___________________ ON THE LINE FOLLOWING MOST REMARKS IS A DOCUMENTATION NUMBER OF THE FORM (DOC. NO NNN). YOU USE THIS NUMBER TO LOCATE ADDITIONAL INFORMATION IN THE SYSTEM GENERATION MANUAL. The documentation number gives you a means to find information in this chapter while you are generating a system. 2-4 THE SYSGEN DIALOGUE The last page of this chapter is a table that lists all the document numbers that the SYSGEN references. Across from the document number is the page in this manual where you can find additional information. (These numbers are the same as the MACREL tag that the SYSGEN uses to locate the remark.) EACH QUESTION HAS A NUMBER ASSOCIATED WITH IT. IF YOU NOTICE A MISTAKE DURING AN RTS/8 QUESTION SESSION, TYPING #NNN CAUSES QUESTION NUMBER NNN TO BE REPEATED. YOU CAN THEN CHANGE THE ANSWER TO NNN. THE PROGRAM THEN RESUMES AT THIS NEW QUESTION. IT ALSO RENUMBERS QUESTIONS BEGINNING AT THIS NUMBER. (NOTE THAT AFTER A TASK PRIORITY CHANGE, THIS FEATURE IS NOT SERVICED.) For example, if you are on question 47 and you wish to change your answer to question 44, you type #44; the SYSGEN then reprints that question. You may only branch backwards. When the SYSGEN branches, it removes the answers to questions it branches over. Therefore, you must reanswer questions that the SYSGEN branches over. Because the SYSGEN dynamically numbers questions, it is possible that the question you branched from will have a different number if you reencounter that question. In the above example, if question 44 branches in a different manner than it previously did, then the next time question 47 appears, it will have a different number. Moreover, if your answer to question 44 means that question 47 is no longer relevant, the SYSGEN does not repeat it. After you add your own tasks to the system in response to a SYSGEN question (this occurs near the end of the SYSGEN), it asks if you wish to change the priority of any of the tasks in the system. After this question, you cannot use the # branching feature to jump to other questions. See DOC. NO 312 for information on task priority changes. IF YOU TYPE AN INVALID ANSWER, THE PROGRAM PRINTS AN ERROR MESSAGE, AND THEN REPRINTS THE QUESTION. Appendix E lists the error messages and explains the responses that cause the SYSGEN to print a message. For all non-fatal errors, the SYSGEN retypes the question to which you gave an incorrect response. If the error was fatal, control returns to the OS/8 monitor. Fatal errors occur only if 2-5 THE SYSGEN DIALOGUE 1. BATCH, TTY, and other similar utilities do not exist in the system upon which you are generating the RTS/8 system. 2. You enter an incorrect device specification and the SYSGEN cannot locate the devices. 3. You make errors in modifying the SYSGEN (as described in Chapter 4). 4. The device to which you send SYSGEN output files do not have sufficient space to contain the files. All other errors are non-fatal. CONTROL/C RETURNS YOU TO THE OS/8 KEY- BOARD MONITOR AND ABORTS THE CURRENT SYSGEN. If you type a CONTROL/C, all the information you enter is lost and the SYSGEN does not create output files. There is no recovery if you accidently type CONTROL/C. FOR FILE STORAGE SPECIFICATIONS SUCH AS DTA0, THE PROGRAM EXPECTS STANDARD DEVICE NAMES. NOTE THAT YOU DO NOT APPEND A COLON TO THE DEVICE NAME. The SYSGEN accepts any string you type that contains the upper-case letters A through Z and the numbers 0 through 9. Consequently, you must make sure that the file specification is a character string that OS/8 recognizes. You may, of course, use an OS/8 ASSIGN command to equate a user file specification with a system file specification. NEXT TO THE BRACKETS [] INDICATING THE EXPECTED RESPONSE ARE PARENTHESES () WHICH INDICATE THE DEFAULT ANSWER. YOU SELECT THE DEFAULT ANSWER BY JUST TYPING A CARRIAGE RETURN. A default answer is a predetermined answer that satisfies the majority of the users of RTS/8. However, it may not be appropriate for your particular system. See Chapter 4 for information on changing defaults. If a question does not have a default, the parentheses contain a question mark, that is, (?). 2-6 THE SYSGEN DIALOGUE The following questions ask you to state which computer of the PDP/8 family you wish to install the RTS/8 system on. If the processor does not match the machine type, it represents a special case. For example, the 8/A 620 series has an 8/E processor in an 8/A cabinet. In such a case, you use the processor designation to specify the clock task and the powerfail task. Here, the target machine has an 8/A clock and 8/E powerfail hardware. For example, if you do not have a clock or powerfail hardware, you may state that you have an 8/A or 8/E. If the target machine has a clock, call it an 8/A. If it has powerfail hardware, call it an 8/E. If it has both, call it an 8/E; when you answer the clock question, specify a non-standard 8/A clock. IS THE TARGET MACHINE FOR WHICH YOU ARE BUILDING THE RTS/8 SYSTEM A PDP 8/A? [Y/N] (Y): THE TARGET MACHINE IS THE MACHINE FOR WHICH THE RTS/8 SYSTEM IS BEING BUILT. THE MACHINE RUNNING THIS PROGRAM AND THE TARGET MACHINE DO NOT HAVE TO BE THE SAME. (DOC. NO 042) For example, you may build a system for a PDP 8/A that contains 128K of memory and many I/O peripherals while running the SYSGEN on a PDP 12 with 12K of memory whose only peripheral is a LINCtape drive. IS THE TARGET MACHINE A PDP 8/E? [Y/N] (N): THE TARGET MACHINE IS THE MACHINE FOR WHICH THE RTS/8 SYSTEM IS BEING BUILT. THE MACHINE RUNNING THIS PROGRAM AND THE TARGET MACHINE DO NOT HAVE TO BE THE SAME. (DOC. NO 042) IS THE TARGET MACHINE A PDP-12? [Y/N] (N): THE TARGET MACHINE IS THE MACHINE FOR WHICH THE RTS/8 SYSTEM IS BEING BUILT. THE MACHINE RUNNING THIS PROGRAM AND THE TARGET MACHINE DO NOT HAVE TO BE THE SAME. (DOC. NO 042) IS THE TARGET MACHINE A VT78 SYSTEM? [Y/N] (N): THE TARGET MACHINE IS THE MACHINE FOR WHICH THE RTS/8 SYSTEM IS BEING BUILT. THE MACHINE RUNNING THIS PROGRAM AND THE TARGET MACHINE DO NOT HAVE TO BE THE SAME. (DOC. NO 042) 2-7 THE SYSGEN DIALOGUE If your answers were "no" to the questions asking which machine RTS/8 will run on, the SYSGEN assumes it is a PDP 8/L, a PDP-8, or a LINC-8. THE TARGET MACHINE MUST BE A PDP 8/I, remark A PDP 8/L, A PDP-8, OR A LINC-8 BECAUSE IT IS remark NOT ONE OF THE ABOVE. remark (DOC. NO 046) The SYSGEN requires you to specify the actions it will perform upon completion of this dialogue. Depending upon your answer, it can return to the monitor, chain to OS/8 BATCH to execute the files it creates, and/or continue through the BATCH procedure to the RTS/8 system. The SYSGEN also requires you to specify where it is to write its output files, what it should name them, and other such similar information. TO WHICH DEVICE SHOULD SYSGEN WRITE THE OUTPUT FILES? [A] (SYS): THIS PROGRAM PRODUCES THREE MAJOR OUTPUT FILES: (1) A PARAMETER FILE, (2) A MACREL BATCH FILE, AND (3) A LINKER BATCH FILE. OS/8 BATCH MUST KNOW THE DEVICE UPON WHICH THESE FILES RESIDE IN ORDER TO GENERATE AN RTS/8 SYSTEM. (DOC. NO 022) The device that you specify must be active in the system that you are using to create the RTS/8 system. If you specify a device that is not in the system, the SYSGEN produces an error message and returns execution control to the OS/8 Keyboard Monitor, and all your answers are lost. The parameter file is a series of statements that MACREL uses when assembling source files. These statements are equates that, if the SYSGEN defines them, MACREL uses when assembling another program. (See Chapter 4 for a discussion of the parameter file. Also, Appendix D is an abbreviated listing of the parameter file.) The MACREL batch file is the list of source files that MACREL assembles to create the .RB files that the LINK program uses. The SYSGEN enters the source file name for each task you indicate in the SYSGEN. (The task name must be the name of the source file.) It also appends switches depending on answers you give to questions in this section. The LINK batch file contains the file specifications that LINK needs to create the .SV image of the RTS/8 system. 2-8 THE SYSGEN DIALOGUE The MACREL and LINK batch files must reside on SYS (or a coresident device such as RKB0 or RL0B) when BATCH executes. If they are not on SYS or a coresident device, BATCH cannot execute. (This is an OS/8 restriction.) The SYSGEN appends switches to the MACREL and LINK batch file in response to your answers to questions. For further information on MACREL and LINK, see the MACREL/LINK User's __________________ Manual. ______ DO YOU WANT TO CHAIN IMMEDIATELY TO THE RTS/8 SYSTEM WHICH BATCH CAN PRODUCE? [Y/N] (Y): THIS PROGRAM CAN INSERT A REQUEST TO RUN THE RTS/8 SYSTEM IT PRODUCES WHEN BATCH FINISHES RUNNING. NOTE THAT INPUT SOURCE FILES MUST BE ON ONE MEDIUM TO PROVIDE FOR THIS FEATURE TO WORK CORRECTLY. (DOC. NO 024) If you wish the RTS/8 system to begin running after BATCH generates the RTS/8 system, answer yes to this question. When BATCH finishes executing, it chains to RTS/8 automatically if the RTS/8 save image is on SYS. (If the save image is not on SYS, BATCH still chains to RTS/8. However, the save image is not executable.) WHAT FIVE CHARACTER NAME WOULD YOU LIKE TO CALL THE FILES PRODUCED? [A] (DEFLT): THE RTS/8 SYSGEN PROGRAM NAMES THE OUTPUT FILES. EXAMPLE: MDEFLT.BI IS THE INPUT SOURCE BATCH FILE FOR THE MACREL ASSEMBLIES; LDEFLT.BI IS THE INPUT SOURCE BATCH FILE FOR THE LINKER; PDEFLT.MA IS THE PARAMETER FILE PRODUCED. (DOC. NO 026) The name you select for the output file can be from one to five characters long. If your answer is six characters long, the SYSGEN truncates it to five characters. (If it is more than six characters long, the SYSGEN prints an error message.) The above remark assumes you chose the default file name of DEFLT. However, if you chose the name MYOWN, the SYSGEN creates the files MMYOWN.BI, LMYOWN.BI, and PMYOWN.MA. 2-9 THE SYSGEN DIALOGUE The first character of the three major output files* are always M for MACREL, L for LINK, and P for parameter. See Chapter 4 for a discussion of these files. See also DOC. NO 022 for a summary of these files. DO YOU WANT THE SYSGEN PROGRAM TO REQUEST BATCH TO RUN BEFORE TERMINATING? [Y/N] (Y): THE RTS/8 SYSGEN PROGRAM CAN CHAIN TO BATCH AFTER COMPLETING THIS QUESTION AND ANSWER SESSION. THE PROGRAM BUILDS A BATCH FILE BASED ON THE DEVICE SPECIFICATIONS YOU PROVIDE IN YOUR ANSWERS. BATCH ALSO RESUBMITS ITSELF IF ALL SOURCE FILES ARE NOT ON THE SAME MEDIUM. BATCH THEN CREATES THE RTS/8 SAVE IMAGE. (DOC. NO 030) Answering yes to this question instructs the SYSGEN to chain to BATCH. BATCH then executes the MACREL and LINK batch files. If all of the source MACREL files for the RTS/8 tasks are not on the same medium, which you will indicate in another question (see DOC. NO 340), the SYSGEN inserts instructions that allow you to mount the media when BATCH needs them. If the sources are not on the same medium, then the MACREL batch file does not automatically chain to the LINK batch file. After BATCH causes MACREL to assemble all sources, you must interrupt BATCH using a C, then submit the LINK batch file. If you also answered yes to a previous question (DOC. NO 024), RTS/8 also comes up running after the conclusion of the SYSGEN. ON WHICH INPUT DEVICE DO THE SOURCE FILES RESIDE? [A] (SYS): FOR EXAMPLE, THE DEVICE COULD BE RXA0 OR DTA0. (NOTE THAT A ':' IS NOT A LEGAL CHARACTER). THE SOURCE FILES MUST RESIDE ON ONE TYPE OF MEDIA AND THE .RB FILES MUST ALL RESIDE ON ONE MEDIUM. IF RTS/8 IS TO RUN AUTOMATICALLY, BATCH MUST WRITE THE .SV FILE ONTO SYS. (DOC. NO 033) The source files this question references are the source files for any tasks that you include in the system and the source files that DIGITAL provides. -------------- * The SYSGEN may also create control files for the TTY drivers and floppy controllers. 2-10 THE SYSGEN DIALOGUE Note that the colon terminating this question is not part of the device name; it is part of the SYSGEN question. Although the sources must be on one type of device, they do not have to be on the same physical device. For example, some of the sources could be on one floppy and the remainder on another. However, you can not have some of the sources on one medium such as a floppy and others on another medium such as a DECtape. If, for example, the source files are on two floppies, you answer no to this question. When BATCH submits the MACREL batch file, MACREL assembles all the source files on the first floppy. BATCH then prints a message that tells you to insert the next floppy into the drive. After you signal that you have performed this action, assembly continues. This process continues until MACREL assembles all source files. You must then type a C to abort BATCH because BATCH cannot determine when MACREL has assembled all of the files. (BATCH keeps on displaying the message to insert the new medium.) You then manually submit the LINK batch file. ON WHICH DEVICE SHOULD BATCH STORE THE .RB FILES? [A] (SYS): FOR EXAMPLE, THE DEVICE COULD BE RXA0 OR DTA0. (NOTE THAT A ': ' IS NOT A LEGAL CHARACTER). THE SOURCE FILES MUST RESIDE ON THE TYPE OF MEDIA AND THE .RB FILES MUST ALL RESIDE ON ONE MEDIUM. IF RTS/8 IS TO RUN AUTOMATICALLY, BATCH MUST WRITE THE .SV FILE ONTO SYS. (DOC. NO 033) The SYSGEN uses this remark, DOC. NO 033, for several questions. The .RB files are the assembled source files that are ready to be linked. The device referenced in this question must be in the system when BATCH executes the MACREL batch file. If there is insufficient room on the device for storing the .RB files, BATCH displays an error message. If this occurs, you must either delete files from the medium or place another device in that drive (if possible) and then resubmit the MACREL batch file. ON WHICH OUTPUT DEVICE SHOULD BATCH STORE THE .SV FILE? [A] (SYS): FOR EXAMPLE, THE DEVICE COULD BE RXA0 OR DTA0. (NOTE THAT A ': ' IS NOT A LEGAL CHARACTER). THE SOURCE FILES MUST RESIDE ON ONE TYPE OF MEDIA AND THE .RB FILES MUST ALL RESIDE ON ONE MEDIUM. IF RTS/8 IS TO RUN AUTOMATICALLY, BATCH 2-11 THE SYSGEN DIALOGUE MUST WRITE THE .SV FILE ONTO SYS. (DOC. NO 033) You may write the .SV image to any device in the system. However, if this device is not SYS, BATCH cannot chain to an executable RTS/8 system. If you wish to write the .SV image to a non-system device, you must copy the RTS/8 save file onto SYS before executing the RTS/8 image. DO YOU WANT ASSEMBLY LISTINGS? [Y/N] (N): YOU MAY ELECT TO OBTAIN ASSEMBLY LISTINGS OF SYSTEM AND USER TASKS AS MACREL ASSEMBLES THEM DURING THE BATCH STREAM. (DOC. NO 334) If you wish assembly listings, you receive them for all tasks in the RTS/8 system. Obtaining assembly listings is useful if you will be changing the sources. For the form, organization, and content of assembly listings, see the MACREL/LINK User's Manual. _________________________ TO WHICH OUTPUT DEVICE SHOULD BATCH WRITE THE ASSEMBLY LISTINGS? [A] (LPT): FOR EXAMPLE, THE DEVICE COULD BE RXA0 OR DTA0. (NOTE THAT A ':' IS NOT A LEGAL CHARACTER). THE SOURCE FILES MUST RESIDE ON ONE TYPE OF MEDIA AND THE .RB FILES MUST ALL RESIDE ON ONE MEDIUM. IF RTS/8 IS TO RUN AUTOMATICALLY, BATCH MUST WRITE THE .SV FILE ONTO SYS. (DOC. NO 033) Normally, the SYSGEN directs MACREL to print the assembly listings on the line printer. You may, however, instruct MACREL to write these listings to files on any device. If MACREL writes the listings to device files, you must make sure that the device has sufficient room to contain them. If the SYSGEN writes the assembly listings to a mass storage device, the listings have an .LS extension and the corresponding cross-reference listing extension will be .LT. DO YOU WANT LINKER LOAD MAP LISTINGS? [Y/N] (N): THE LINKER LOAD MAP DESCRIBES THE MEMORY LAYOUT OF THE RTS/8 SYSTEM. (DOC. NO 341) 2-12 THE SYSGEN DIALOGUE You request a load map if you must know the locations in memory where tasks reside. See the MACREL/LINK User's Manual for an explanation of _________________________ the form and contents of the load map. ON WHICH OUTPUT DEVICE SHOULD BATCH WRITE THE MEMORY MAP LISTINGS? [A] (LPT): FOR EXAMPLE, THE DEVICE COULD BE RXA0 OR DTA0. (NOTE THAT A : IS NOT A LEGAL CHARACTER). THE SOURCE FILES MUST RESIDE ON ONE TYPE OF MEDIA AND THE .RB FILES MUST ALL RESIDE ON ONE MEDIUM. IF RTS/8 IS TO RUN AUTOMATICALLY, BATCH MUST WRITE THE .SV FILE ONTO SYS. (DOC. NO 033) Normally, the SYSGEN directs LINK to print the memory maps on the line printer. A non-default answer tells LINK which device to write this file to. The following question asks if you want to build a default system. This system is a small RTS/8 system and includes only the tasks listed in DOC. NO 017. A default system does not include user tasks. DO YOU WISH TO GENERATE AN RTS/8 SYSTEM WITHOUT SPECIFYING PARAMETERS? [Y/N] (N): IF YOU ANSWER YES TO THIS QUESTION, THE RTS/8 SYSGEN PROGRAM GOES TO PASS 2 AND GENERATES A SYSTEM WHICH INCLUDES A TTY TASK, A MONITOR CONSOLE ROUTINE, A TEST ROUTINE, A NULL ROUTINE, A CLOCK ROUTINE, AND AN EXIT TASK. (DOC. NO 017) For an explanation of the function and purpose of these tasks, see the RTS/8 User's Manual. However, the Test Routine is explained below. ___________________ If you answer yes to this question, the SYSGEN immediately goes to Pass 2. Pass 2 is the part of SYSGEN that builds the Parameter, MACREL, and LINK batch files. (Section 2.3 explains Pass 2 actions.) ARE ALL SOURCE FILES ON THE SAME MEDIUM? [Y/N] (Y): IF, FOR EXAMPLE, THE SOURCE FILES EXIST ON SEVERAL FLOPPIES, THEN THE BATCH FILE WILL BE CONSTRUCTED TO RESUBMIT ITSELF. ON EACH PASS, THE SOURCES FROM ANOTHER FLOPPY CAN BE ASSEMBLED. (DOC. NO 340) 2-13 THE SYSGEN DIALOGUE If all of the sources are not on the same medium, OS/8 BATCH pauses and prints a message that allows you to place the medium into the drive unit. (If they are not on the same medium, the SYSGEN inserts a BATCH /E switch. This switch specifies that when BATCH cannot find the file on the medium, it should not abort. This gives you the opportunity to place the medium with the file into the device drive.) Note that you cannot have sources on two different kinds of devices, for example, DECtape and floppies. The SYSGEN now asks you to enter information on the target system's hardware. (The SYSGEN does not ask these and the following questions if you select the default system; see DOC. NO 017.) DOES THE TARGET SYSTEM HAVE EAE HARDWARE? [Y/N] (N): EAE HARDWARE IS AN OPTION WHICH MAY BE PRESENT IN THE TARGET CONFIGURATION. EAE HARDWARE ALLOWS OPERATIONS SUCH AS MULTIPLY AND DIVIDE TO BE PERFORMED IN THE HARDWARE. (DOC. NO 050) The EAE (Extended Arithmetic Element) allows the central processor to perform arithmetic operations at high speed. Most users employ the EAE with a 23-bit Floating-Point Processor to provide fast floating- point arithmetic, mathematical and trigonometric function evaluation, and formatted floating-point I/O. Check with the system manager or your sales representative if you do not know if the system has EAE hardware. DO YOU WISH TO SAVE THE CONTENTS OF THE EAE REGISTERS WHEN TASK SWITCHING OCCURS? [Y/N] (Y): IF MORE THAN ONE TASK USES THE EAE REGISTERS, YOU SHOULD SAVE ITS CONTENTS TO AVOID LOSING DATA WHEN TASK SWITCHING OCCURS. ASSUME THAT BOTH TASK A AND TASK B USE THE EAE. IF TASK B STARTS EXECUTING BEFORE TASK A FINISHES, THEN THE CONTENTS OF THE EAE MAY BE DIFFERENT WHEN TASK A RESUMES BECAUSE OF TASK B'S USE OF THE EAE. (DOC. NO 052) Although it is usually desirable to save the contents of the EAE registers, you do not have to save them. Considerably greater processor overhead is needed if you save the registers; you should save them only if the tasks that you add to the system use them. If you save the EAE registers, the RTS/8 Executive includes an additional location for each task; for example, if you save the EAE and your 2-14 THE SYSGEN DIALOGUE system has 30 tasks, then the RTS/8 Executive contains 30 more locations than it would if you did not save the EAE registers. DOES THE TARGET SYSTEM HAVE A HARDWARE MQ REGISTER? [Y/N] (Y): SOME TARGET SYSTEMS MAY NOT. THE MQ REGISTER IS OPTIONAL ON THE PDP 8/I, 8/L, LINC 8, AND THE 8. (DOC. NO 054) The MQ (Multiplier Quotient Register) is a 12-bit bidirectional shift register that acts as an extension of the accumulator during extended arithmetic operations. You may also use this register as a temporary storage location. If you indicate that RTS/8 should save the EAE, then it also saves the MQ register contents. However, if you indicate that the target system does not contain an EAE or that you do not wish to save the EAE, you still may wish to save the MQ. DO YOU WANT TO SAVE THE CONTENTS OF THE MQ REGISTER WHEN TASK SWITCHING OCCURS? [Y/N] (Y): IF MORE THAN ONE TASK USES THE MQ REGISTER, YOU SHOULD SAVE ITS CONTENTS TO AVOID LOSING DATA WHEN TASK SWITCHING OCCURS. ASSUME THAT BOTH TASK A AND TASK B USE THE MQ. IF TASK B STARTS EXECUTING BEFORE TASK A FINISHES, THEN THE CONTENTS OF THE MQ MAY BE DIFFERENT WHEN TASK A RESUMES BECAUSE OF TASK B'S USE OF THE EAE. (DOC. NO 056) You should save the contents of the MQ only if the tasks you install in the RTS/8 system use the MQ. Saving the MQ requires greater processor overhead. IN WHICH FIELD DOES RTS8 RESIDE? [D] (0): UNLESS YOU ARE REALLY SURE, RTS8 SHOULD RESIDE IN FIELD 0. (DOC. NO 353) The answer to this question must be from 0 to 31 (decimal). 2-15 THE SYSGEN DIALOGUE DIGITAL strongly recommends that you always place RTS/8 in field 0. (You might wish to place RTS/8 in a different field if you are generating a symbiont system.) For example, if the target machine contains 16K of memory and you wish to place RTS/8 in the highest possible memory locations, answer 4 to the number of fields and then place RTS/8 in field 3. If you place RTS/8 in a field other than 0, then you must control LINK to ensure that other RTS/8 tasks do not execute in fields below the RTS/8 field. HOW MANY FIELDS OF MEMORY EXIST IN THE TARGET MACHINE? [D] (4): IF YOU HAVE 16K OF MEMORY, THE ANSWER IS 4. ENTER THE NUMBER IN DECIMAL. (DOC. NO 060) Your answer to this question must be between 2 and 32 (decimal). Consider carefully your answer to this question. If you do not specify sufficient memory, there may not be enough room for the RTS/8 save image to execute properly. Consequently, unless you have a reason for limiting memory, your answer should specify the maximum amount of memory available in the target system. (The minimum amount of memory is determined by the amount of storage LINK needs to create the system.) If you are unsure how much memory the target system has, check with the system manager or your sales representative. If the target system has OS/8, you may also determine the number of fields by typing the OS/8 Keyboard Monitor MEMORY command. See the OS/8 Handbook for _____________ further information. DOES YOUR TARGET SYSTEM HAVE POWER FAIL HARDWARE? [Y/N] (N): POWER FAIL HARDWARE IS AN OPTION AVAILABLE ON ALL MACHINES (EXCEPT THE VT-78) WHICH HAVE CORE MEMORY. (DOC. NO 062) Power fail hardware causes an interrupt to occur when the power falls below a predetermined threshold. When power returns, this hardware causes the computer to restart. The power fail hardware is useful only with machines that have core memory (which is non-volatile) If the target machine has semiconductor memory, it ordinarily does not possess power fail hardware. 2-16 THE SYSGEN DIALOGUE If you do not know if the system has this hardware, check with your system manager or your sales representative. DO YOU WANT THE POWER FAIL HANDLER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question if you wish to provide for an orderly shutdown of the computer when it loses power. This task saves the contents of all volatile registers. When sufficient power exists, the task restores the contents of the volatile registers and returns control to RTS/8. If you answered no to the question that asked if you have power fail hardware (DOC. NO 062), the SYSGEN does not print this question. ----------------- CAUTION ------------------ | If you erroneously answer that the | | target system has power fail hardware | | and you state that you wish to have the | | power fail task, then the resulting | | RTS/8 system will execute improperly. | | This is an error that the SYSGEN cannot | | check for because the target machine and | | the machine upon which you are | | generating the RTS/8 system may not be | | the same. | -------------------------------------------- DOES THE TARGET SYSTEM HAVE KL8-A HARDWARE? [Y/N] (N): THE KL8-A IS A 4-CHANNEL ASYNCHRONOUS INTERFACE FOR THE PDP-8 FAMILY. IT PROVIDES FULL MODEM CONTROL ON 1 CHANNEL AND PARTIAL MODEM CONTROL ON THE OTHER THREE CHANNELS. IF YOU HAVE ANY KL8-A'S IN YOUR TARGET SYSTEM, ANSWER YES TO THE QUESTION. (DOC. NO 064) HOW MANY KL8-A'S ARE IN THE TARGET SYSTEM? [D] (1): THERE ARE 4 CHANNELS PER KL8-A. IF, FOR EXAMPLE, YOU HAVE 8 CHANNELS THE ANSWER IS 2. (DOC. NO 066) 2-17 THE SYSGEN DIALOGUE Your answer must be between 1 and 3. If you do not know if the target system has a KL8-A or you do not know how many KL8-As exist in the target system, consult your system manager or your sales representative. THIS SECTION PRESENTS THE PARAMETERS remark REQUIRED TO SPECIFY THE KL8-A TASK WHICH remark YOU HAVE SELECTED. remark (DOC. NO 274) remark If you select the KL8-A, the SYSGEN prints the above remark after it presents all DIGITAL tasks. WHAT IS THE DEVICE CODE FOR THE FIRST KL8-A DEVICE? [O] (40): MULTIPLE KL8-A HARDWARE MUST HAVE CONSECUTIVE DEVICE CODES. THE ANSWER TO THIS QUESTION IS THE DEVICE CODE FOR THE FIRST KL8-A. (DOC. NO 276) Your answer must be between 1 and 77 (octal). If you do not know the device code, check with the system manager or your sales representative. DO YOU HAVE KT8A HARDWARE IN THE TARGET SYSTEM? [Y/N] (N): THE KT8A IS A MEMORY MANAGEMENT OPTION WHICH ALLOWS YOU TO HAVE UP TO 128K OF MEMORY ON SEVERAL MACHINES OF THE PDP-8 FAMILY. (DOC. NO 070) If the target machine has more than 32K of memory, it has a KT8A. (However, a machine with less than 32K may also possess KT8A hardware.) You can determine if you have more than 32K of memory by using the OS/8 Keyboard Monitor MEMORY command (provided the target system has OS/8). If you are unsure if the target system contains a KT8A, check with your system manager. DO YOU WANT ANY OF THE DEC- PROVIDED SYSTEM TASKS IN YOUR RTS/8 SYSTEM? [Y/N] (Y): SEVERAL TASKS ARE PROVIDED BY DEC IN SOURCE FORM WHICH YOU CAN INCLUDE IN YOUR 2-18 THE SYSGEN DIALOGUE RTS/8 SYSTEM (FOR EXAMPLE, THE TTY TASK). (DOC. NO 072) If you answer yes to the above question, the SYSGEN prints the following remark. EACH DEC TASK WILL BE LISTED ONE AT A remark TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR remark SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE remark SYSGEN PROGRAM REQUIRES MORE INFORMATION remark ABOUT A TASK, IT WILL ASK THE QUESTIONS remark IN ANOTHER SECTION. remark (DOC. NO 073) remark This remark is also the response you receive when you type a ? response to many of the SYSGEN questions that ask if you wish to include a DIGITAL-supplied task. For more information on any of these questions, see the appropriate hardware manual or the RTS/8 User's ____________ Manual. ______ If a task you select requires more than a yes/no response, the SYSGEN asks these questions after it asks all questions that allow you to select DIGITAL tasks. However, here they are grouped together for your convenience. CLOCK HANDLER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question only if the target system has a clock. (If the target system does not have a clock and you answer yes to this question, RTS/8 ignores the clock handler task that the SYSGEN installs.) If you are unsure if the target system has a clock, consult the system manager or your sales representative. THIS SECTION PRESENTS THE PARAMETERS remark REQUIRED TO SPECIFY THE CLOCK TASK WHICH remark YOU HAVE SELECTED. remark (DOC. NO 216) remark If you state that the target system has a clock, the SYSGEN prints the 2-19 THE SYSGEN DIALOGUE above remark and the following questions after it presents all DIGITAL tasks. DOES YOUR TARGET SYSTEM HAVE A STANDARD CLOCK? [Y/N] (Y): STANDARD CLOCKS: CPU CLOCK --- ----- PDP 8/A PDP8A PDP 8/E DK8EA/DK8EC PDP-12 KW12 VT-78 PDP8A OTHER DK8EA/DK8E IF YOUR TARGET SYSTEM HAS A CLOCK OTHER THAN THOSE INDICATED IN THE TABLE, ANSWER 'N' TO THIS QUESTION. (DOC. NO 220) If the target system contains the clock that DIGITAL normally provides with your PDP 8 system, answer yes to this question. If you are unsure if you have a standard clock, consult the system manager or your sales representative. If the processor does not match the machine type, it represents a special case. For example, the 8/A 620 series has an 8/E processor in an 8/A cabinet. For information on answering this and the next question, see the paragraph preceding DOC. NO 42. WHAT IS THE DEC DESIGNATION FOR THE NON- STANDARD CLOCK? [A] (?): THE NON-STANDARD CLOCKS SUPPORTED ARE THE DK8EP AND ALL THOSE WITH INSTRUCTION SETS COMPATIBLE WITH ONE OF THE ABOVE. (DOC. NO 222) If you have a non-standard clock, you must check its instruction set against those that this handler supports. If the clock is incompatible with those listed above, you must provide your own clock handler. Note that this answer does not have a default. HOW MANY ENTRY SLOTS IN THE CLOCK QUEUE DO YOU WANT? [D] (16): 2-20 THE SYSGEN DIALOGUE THE LEGAL RANGE IS 16-256. EACH SLOT REQUIRES 6 MEMORY LOCATIONS. (DOC. NO 224) The clock handler uses 6 locations in memory to store a clock request. (The six contiguous locations are called an entry slot.) You must ensure that the clock queue has sufficient slots to store requests; if you specify an insufficient number, your system may malfunction. HOW MANY SOFTWARE TICKS PER SECOND? [D] (10): RTS8 ALLOWS THE HARDWARE CLOCK INTERRUPT RATE TO BE SUBDIVIDED SO THAT THE SOFTWARE SEES ONLY EVERY NTH INTERRUPT. THE SOFTWARE INTERRUPT RATE SHERTZ MUST DIVIDE EVENLY INTO THE HARDWARE RATE HERTZ. IF NOT, ASSEMBLY ERRORS RESULT. (DOC. NO 347) Your answer must be in the range 1 through 192 (decimal). To answer this question, you must know the hardware tick rate. This tick rate is usually 50 or 60 times a second. If, for example, your hardware clock can produce an interrupt every 1/60 of a second, then you could answer, among other answers, 1, 6, 12, 20, and 30. Respectively, the RTS/8 software receives interrupts every 1/60, 1/10, 1/5, 1/3, and 1/2 seconds. DO YOU WANT THE SPECIAL CLOCK INTERRUPT LINKAGE? [Y/N] (N): THIS FEATURE, TO BE USED WITH EXTREME CARE, ALLOWS A USER-SUPPLIED SUBROUTINE TO BE CALLED FROM CLOCK INTERRUPT LEVEL. (DOC. NO 351) In some cases, a task may require an action to be taken at a time as soon as possible after the clock hardware interrupt. This linkage provides this close timing. (Note that it is normally sufficient to have the clock schedule a task to carry out an action rather than use this linkage.) For more information, see Section 4.4 of the RTS/8 User's Manual. _____________________ DIGITAL recommends that you incorporate the linkage into your system only if a task must respond immediately after a clock interrupt occurs. UNIVERSAL DIGITAL CONTROLLER TASK? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR 2-21 THE SYSGEN DIALOGUE SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) The UDC/ICS is an analog and digital I/O device that permits the computer to interrogate external devices in a process control environment. This handler is the means by which a task communicates with the UDC/ICS functional devices. See Section 4.15 of the RTS/8 _____ User's Manual for a description of this handler. _____________ THIS SECTION PRESENTS THOSE PARAMETERS remark WHICH RTS/8 REQUIRES TO SPECIFY THE UDC remark TASK WHICH YOU HAVE SELECTED. remark (DOC. NO 225) remark If you state that the target system contains a UDC, the SYSGEN prints the above remark after it presents all DIGITAL tasks. HOW MANY INTERRUPTS CAN BE STORED AT ONE TIME? [O] (12): YOU SET THE NUMBER OF SLOTS RESERVED FOR INTERRUPTS PENDING SERVICE BY THIS QUESTION (DOC. NO 227) Your answer must be in the range 1 through 50 (octal). This number represents the maximum number of interrupts that the handler can store. The handler stores interrupts so that it does not have to interrupt other processing until it can service the latest interrupt. If you do not specify sufficient slots, the RTS/8 system may either not receive an interrupt or it may stop executing. HOW MANY COUNTER MODULES IN THE TARGET SYSTEM'S UDC? [O] (1): ENTER THE NUMBER OF MODULE BOARDS WHICH WILL BE IN THE UDC OF THE TARGET SYSTEM. (DOC. NO 231) Your answer must be in the range 1-20 (octal). Consult the system manager to determine how many counter modules exist in the target system. 2-22 THE SYSGEN DIALOGUE HOW MANY CONTACT MODULES IN THE UDC? [O] (2): ENTER THE NUMBER OF MODULE BOARDS WHICH WILL BE IN THE UDC OF THE TARGET SYSTEM. (DOC. NO 231) Your answer must be in the range 1-20 (octal). Consult the system manager to determine how many contact modules exist in the target system. HOW MANY ANALOG INPUT CONVERTER MODULES? [O] (2): ENTER THE NUMBER OF MODULE BOARDS WHICH WILL BE IN THE UDC OF THE TARGET SYSTEM. (DOC. NO 231) Your answer must be in the range 1-20 (octal). Consult the system manager to determine how many analog input converter modules exist in the target system. WHAT IS THE ADDRESS OF THE FIRST COUNTER MODULE? [O] (?): ENTER THE ADDRESS OF THE FIRST MODULE. THE ADDRESSES MUST BE CONTIGUOUS. (DOC. NO 235) Your answer must be in the range 0 through 3777 (octal). This question has no default answer. Consult the system manager to determine the first counter module address. WHAT IS THE ADDRESS OF THE FIRST CONTACT INTERRUPT MODULE? [O] (?): ENTER THE ADDRESS OF THE FIRST MODULE. THE ADDRESSES MUST BE CONTIGUOUS. (DOC. NO 235) Your answer must be in the range 0 through 3777 (octal). Note that there is no default answer to this question. Consult the system manager to determine the first contact module address. 2-23 THE SYSGEN DIALOGUE WHAT IS THE ADDRESS OF THE FIRST A/D CONVERTER MODULE? [O] (?): ENTER THE ADDRESS OF THE FIRST MODULE. THE ADDRESSES MUST BE CONTIGUOUS. (DOC. NO 235) Your answer must be from 0 to 3777 (octal). There is no default answer to this question. Consult the system manager to determine the first analog to digital converter address. RF08 DISK DRIVER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question only if the target system has an RF08 fixed head disk drive and you wish to perform I/O using that device. If you will be supplying your own handler or driver, answer no to this question. DF32 DISK DRIVER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question if the target system has a DF32 fixed head disk drive and you wish to perform I/O operations using the device. RK8E DISK DRIVER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION 2-24 THE SYSGEN DIALOGUE ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question if the target system has an RK8E cartridge disk drive and you will use it for I/O. RK8 DISK DRIVER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question if the target system has an RK8 cartridge disk drive. RL01 DISK DRIVER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question if the target system has an RL01 mass storage disk drive. DECTAPE DRIVER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question if the system contains a TC08 DECtape drive. Note that RTS/8 does not support TD8E DECtape drives. 2-25 THE SYSGEN DIALOGUE LINCTAPE DRIVER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) The SYSGEN asks you this question only if you previously specified that the target machine is a PDP 12. If you wish to use the LINCtape, answer yes to this question. The SYSGEN now asks if you want floppy disk controllers and how many you wish to have. FIRST FLOPPY CONTROLLER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) SECOND FLOPPY CONTROLLER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) THIRD FLOPPY CONTROLLER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) FOURTH FLOPPY CONTROLLER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE 2-26 THE SYSGEN DIALOGUE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Each floppy controller performs I/O upon two floppies; that is, one floppy unit contains two drives. Thus, if your system allows you to use six floppies simultaneously, you include three floppy controllers in the RTS/8 system. Answer yes to these questions if the target system contains either single or double density floppies. Since the floppy controller can distinguish between single and double density floppies, the SYSGEN does not ask which kind the target system contains. The SYSGEN allows you to include up to four floppy controllers in an RTS/8 system. (The SYSGEN also builds a control file for each floppy controller you wish to include in the system. A control file is a file that MACREL combines with a source file. This allows SYSGEN to use a single source file to create more than one task.) The SYSGEN asks if you want a second controller only if you respond affirmatively to its question asking if you want a floppy controller. Likewise, it asks if you want a third controller only if you said you wanted a second controller, and so on. THIS SECTION PRESENTS THE HARDWARE DEVICE remark CODE SPECIFICATION(S) FOR THE FLOPPY CONTROLLER(S) remark WHICH YOU HAVE SELECTED. remark (DOC. NO 335) If you state that the target system contains floppy drives, the SYSGEN prints the above remark after it finishes asking which tasks it should include in the system. WHAT IS THE DEVICE NUMBER FOR THE FIRST DEVICE CONTROLLER? [O] (75): THE RTS/8 SYSGEN PROGRAM PRODUCES A PARAMETER CONTROL FILE FOR EACH FLOPPY CONTROLLER YOU SPECIFY. ENTER THE ANSWER IN OCTAL. (DOC. NO 136) WHAT IS THE DEVICE NUMBER FOR THE SECOND DEVICE CONTROLLER? [O] (70): 2-27 THE SYSGEN DIALOGUE THE RTS/8 SYSGEN PROGRAM PRODUCES A PARAMETER CONTROL FILE FOR EACH FLOPPY CONTROLLER YOU SPECIFY. ENTER THE ANSWER IN OCTAL. (DOC. NO 136) WHAT IS THE DEVICE NUMBER FOR THE THIRD DEVICE CONTROLLER? [O] (71): THE RTS/8 SYSGEN PROGRAM PRODUCES A PARAMETER CONTROL FILE FOR EACH FLOPPY CONTROLLER YOU SPECIFY. ENTER THE ANSWER IN OCTAL. (DOC. NO 136) WHAT IS THE DEVICE NUMBER FOR THE FOURTH DEVICE CONTROLLER? [O] (72): THE RTS/8 SYSGEN PROGRAM PRODUCES A PARAMETER CONTROL FILE FOR EACH FLOPPY CONTROLLER YOU SPECIFY. ENTER THE ANSWER IN OCTAL. (DOC. NO 136) Your answers to these questions must be between 1 and 77 (octal). If you do not know the device codes for the floppies, consult the system manager or your sales representative. DIGITAL also provides a specification sheet that lists the devices codes. See Appendix B for a sample sheet. LINE PRINTER DRIVER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question if you wish to include the line printer handler. EMERGENCY BREAKTHROUGH TASK? [Y/N] (N): THE EMERGENCY BREAKTHROUGH TASK ALLOWS A TASK TO BREAK THROUGH TO A TTY (SELECTED LATER) FOR URGENT MESSAGES. (DOC. NO 325) 2-28 THE SYSGEN DIALOGUE The emergency breakthrough task interrupts a task that controls the terminal so that an emergency message can be sent to the terminal. (Using the standard RTS/8 message format, you can send an emergency message from one task to this task; the emergency task then prints the message on the terminal.) This procedure is necessary because other tasks cannot print messages while another task has control of the terminal. For more information, see Chapter 4 of the RTS/8 User's ____________ Manual. ______ WHAT IS THE TASK NAME OF THE DEVICE HANDLER TO BE USED FOR EMERGENCY BREAKTHROUGH MESSAGES? [A] (TTY): YOU HAVE SELECTED THE EMERGENCY BREAKTHROUGH TASK. SELECT WHICH TTY TASK IS TO BE PRE-EMPTED FOR EMERGENCY MESSAGES. (DOC. NO 331) If you select the emergency breakthrough task, state which terminal receives emergency messages. If you select the default answer, you must answer YES to the following question. TERMINAL DRIVER? [Y/N] (Y): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question if your target system includes terminals. If the target system uses the MCR task or the OS/8 background task (and they both share the same terminal), you must include this task. You may, of course, provide your own TTY handler provided you name it TTY.MA. HOW MANY TTY TASKS WILL BE IN THE TARGET SYSTEM? [D] (1): THE RTS/8 SYSGEN PROCEDURE AUTOMATICALLY GENERATES UP TO FIVE TTY TASKS FOR YOUR RTS/8 TARGET SYSTEM; 1 FOR EACH OF UP TO FIVE TTY PERIPHERALS. A CONTROL FILE WILL BE BUILT FOR ANY IN EXCESS OF 1 TTY TASK, NOT EXCEEDING A TOTAL OF FIVE. (DOC. NO 317) 2-29 THE SYSGEN DIALOGUE The SYSGEN program allows you to include up to five TTY tasks in the target system. If your system requires more than five, see Chapter 4. For each TTY task other than the first, the SYSGEN creates a control file that contains equates necessary to generate the TTY .RB image or images. (A control file is a file that MACREL combines with a source file. This allows SYSGEN to use a single source file to create more than one task.) The last line of each control file is an .INCLUDE that tells MACREL to use the principal TTY task with the equates for the specific TTY task you generate. The following TTY questions differ from other SYSGEN questions in that the answer you type must be five or fewer characters. IN THE FOLLOWING QUESTIONS, YOU CAN ENTER remark UP TO FIVE ANSWERS, SEPARATED BY COMMAS. remark THE ANSWERS INDICATE YOUR CHOICE FOR THE GIVEN remark PARAMETER FOR EACH OF THE TTY TASKS THAT YOU HAVE remark SELECTED. EXAMPLE: remark IF YOU TYPE TO THE DEVICE CODE QUESTION: remark 04,31,33,35,37 (CARRIAGE RETURN) YOU SELECT remark DEVICE CODE CODE 04 FOR TTY TASK, 31 FOR TTY1 remark ETC. remark (DOC. NO 252) remark For the next eight questions, you must specify either the default answer or you must specify the answer for each TTY task. (When you are running the SYSGEN, it prints a message that tells you that there are no more questions that require more than one answer.) If, for example, the target system contains five TTY tasks, you must supply an answer for each. You cannot type two answers and then have the SYSGEN supply the default answer for the remaining three. WHAT IS THE KEYBOARD DEVICE CODE FOR THE TTY TASK? [O] (03): THE DEVICE CODE FOR THE TTY TASK HAS A DEFAULT OF 4 BUT YOU MAY CHANGE IT TO MATCH THE TARGET SYSTEM'S HARDWARE CONFIGURATION. THE KEYBOARD DEFAULT IS (03). (DOC. NO 254) The keyboard device code specifies the part of the terminal from which the computer receives information. If you do not know the device code, check with your system manager or your sales representative. The default shown for this question is valid if the target system contains only one TTY and it is correct for your system. If your terminal is connected to a KL8-A, the device code is 100 plus 2-30 THE SYSGEN DIALOGUE the line number for the keyboard (KB) and the teleprinter (TT). For additional information, see DOC. NO 174. WHAT IS THE TTY DEVICE CODE FOR THE TTY TASK? [O] (04): THE DEVICE CODE FOR THE TTY TASK HAS A DEFAULT OF 4 BUT YOU MAY CHANGE IT TO MATCH THE TARGET SYSTEM'S HARDWARE CONFIGURATION. THE KEYBOARD DEFAULT IS (03). (DOC. NO 254) This device code specification is the code the computer uses to signal the terminal that it is to receive information. If you do not know the device code, check with your system manager or your sales representative. The default for this question is valid if the target system contains one TTY and the device code is correct for your system. DO YOU WANT CNTRL/S AND CNTRL/Q FEATURES FOR YOUR TTY TASK? [Y/N] (Y): WHEN YOU SET THIS PARAMETER, CNTRL/S STOPS TTY PRINTOUT AND CNTRL/Q RESUMES THE PRINTOUT. (DOC. NO 257) DO YOU WANT RUBOUT SUPPORT FOR THE TTY SCREEN? [Y/N] (Y): IF YOU SET THIS PARAMETER, TYPING RUBOUT CAUSES THE CURSOR TO MOVE LEFT 1 POSITION AND REMOVE THE LAST CHARACTER YOU TYPE FROM SCREEN. (DOC. NO 261) You normally include these features if you have a CRT. However, it is not necessary for you to include these features. (On many terminals, the RUBOUT key is labeled DELETE.) HOW MANY NULLS AFTER A LINE FEED FOR THE TTY DEVICE? [O] (0): NULLS ALLOW A LINE FEED TO TAKE PLACE BEFORE THE NEXT CHARACTER IS TRANSMITTED. (DOC. NO 263) Some terminals require the transmission of null characters in order that the TTY device can complete the carriage return/line feed action before it prints another character. 2-31 THE SYSGEN DIALOGUE HOW MANY CHARACTERS DO YOU WANT ON A LINE FOR THE TTY DEVICE? [D] (80): THIS QUESTION ASKS HOW MANY CHARACTERS FIT ON A LINE. 0 MEANS THAT NO POSITION COMPUTATIONS ARE DONE AT ALL. NOTE THAT THE WIDTH MUST BE A MULTIPLE OF 8. (DOC. NO 265) The maximum on most CRT screens is 80. The maximum on most hard-copy terminals is 128. (A 132-character line requires that you answer 128 to this question, because 128 is the largest number that is divisible by 8.) If your answer is not a multiple of 8, the teletype handler may execute improperly. DOES THE HARDWARE SUPPORT TABS ON THE TTY DEVICE? [Y/N] (Y): IF YOU ANSWER NO, THE SOFTWARE SIMULATES TABS BY INSERTING SPACES. (DOC. NO 273) If you are unsure if a terminal supports hardware tabs, check with your system manager. HOW MANY SECONDS BEFORE A TTY READ TIMEOUT? [D] (0): A ZERO ANSWER MEANS NO TIMEOUT EXISTS. TIMEOUT MEANS THAT IF THE TASK HAS A PENDING REQUEST AND YOU DO NOT TYPE A RESPONSE WITHIN THE TIMEOUT PERIOD, THE TTY HANDLER ABORTS THE CURRENT REQUEST. (DOC. NO 267) The TTY read timeout function tells RTS/8 to abort a read request if the receiving task does not receive a prompt reply. This function allows the terminal to be freed without resorting to emergency messages. SWAPPER TASK? [Y/N] (N): THE SWAPPER TASK SWAPS NONRESIDENT TASKS INTO AND OUT OF MEMORY. YOU MUST INCLUDE THIS TASK IF THE RTS/8 SYSTEM WILL HAVE ANY NON- RESIDENT TASKS. (DOC. NO 342) 2-32 THE SYSGEN DIALOGUE Answer yes to this question if the target system will contain nonresident tasks. If you answer 'no' to this question, the SYSGEN does not ask any questions about nonresident tasks or allow you to change partitions at a later time. You may wish to include the swapper even if no task is initially non-resident. Specifically, if you are debugging a nonresident task, DIGITAL recommends that you debug it when it is resident. For additional information, see Chapter 6 of the RTS/8 User's Manual. ___________________ THIS SECTION PRESENTS THOSE PARAMETERS remark REQUIRED TO SPECIFY THE SWAPPER TASK WHICH remark YOU HAVE SELECTED. remark (DOC. NO 240) remark If you stated that the target system contains the swapper task, the SYSGEN prints this remark after it presents all DIGITAL tasks. WHICH RTS/8 DEVICE TASK WILL THE SWAPPER TASK USE TO MAKE TRANSFERS? [A] (RK8E): SWAPPING MUST OCCUR FROM THE DEVICE THAT WAS SYS WHEN THE RTS/8 SYSTEM WAS ORIGINALLY RUN FROM OS/8. TYPE THE RTS/8 DEVICE HANDLER FOR THAT DEVICE. (DOC. NO 246) This question asks you to type the name of the device that the SWAP task uses when it reads and writes task object code. This device must be the OS/8 system from which RTS/8 was run. WHICH PHYSICAL UNIT WILL THE SWAPPER USE FOR MAKING TRANSFERS? [A] (0): TYPE THE DEVICE NUMBER OF THE DEVICE CORRESPONDING TO SYS. TYPE 0 FOR RKA0. (DOC. NO 250) As some mass storage devices have more than one physical device, you must also specify which unit of the device swapper makes transfers to or from. Typically, this is unit 0; however it can be other units. CASSETTE DRIVER? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION 2-33 THE SYSGEN DIALOGUE ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) Answer yes to this question if the target system performs I/O on a tape cassette. DO YOU WANT THE CASSETTE FILE SUPPORT TASK? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) This task performs auxiliary operations such as rewind, backspace to file gap, write file gap, backspace to a block gap, and skip a file on a CAPS-8 formatted cassette. OS/8 FILE SUPPORT TASK? [Y/N] (N): THE OS/8 FILE SUPPORT TASK ALLOWS OTHER TASKS TO LOOKUP, CREATE, AND DELETE FILES IN OS/8 DIRECTORIES. A SYSTEM MAY HAVE THIS TASK WITHOUT HAVING OS/8 IN THE SYSTEM. (DOC. NO 153) The file support task allows foreground jobs to manipulate files on file-structured media. MONITOR CONSOLE ROUTINE? [Y/N] (Y): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) The MCR accepts a series of interactive commands that allow you to control, inspect, and, to some extent, debug the RTS/8 system. It also allows you to schedule and execute tasks at specified intervals, suspend task execution, and print system status information. 2-34 THE SYSGEN DIALOGUE THIS SECTION PRESENTS THE PARAMETERS remark REQUIRED TO SPECIFY THE MCR TASK remark WHICH YOU HAVE SELECTED. remark (DOC. NO 205) remark The SYSGEN prints this remark and the following questions if you have indicated that the target system contains an MCR. For additional information, see Chapter 5 of the RTS/8 User's Manual. ___________________ DO YOU WANT TIME-OF-DAY FACILITY IN YOUR MCR TASK? [Y/N] (Y): THE MCR TIME COMMAND ALLOWS MCR TO PRINT OR CHANGE THE TIME-OF-DAY. DOC. NO 207) The SYSGEN prints this question if you specified that the target system contains a clock. If you include this facility, you may either change or display the system time of day. DO YOU WANT THE MCR SYSTEM STATUS REPORT CAPABILITY? [Y/N] (Y): THE SYSTAT COMMAND OF THE MCR TASK PRINTS THE STATUS OF A SINGLE TASK OR OF THE ENTIRE SYSTEM. INDICATED ARE FLAGS/MESSAGES, RUN STATUS, AND SOME CURRENT REGISTER CONTENTS. (DOC. NO 211) See Section 5.3.13 of the RTS/8 User's Manual for a description of the ___________________ SYSTAT facility. WHICH TERMINAL WILL THE MCR TASK USE? [A] (TTY): ENTER THE TASK NAME OF THE TASK WHICH RTS/8 WILL USE AS THE MCR CONSOLE DEVICE. (DOC. NO 215) If you specify the default answer, you must include at least one TTY task in the system (see DOC. NO 317). If you do not, the RTS/8 system you are creating will execute improperly. (You may also select the default answer if you include your own TTY task provided that you name this task TTY.MA.) 2-35 THE SYSGEN DIALOGUE RTS/8 TEST TASK? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) The Test Task is a demonstration program that prints a string on your terminal. As DIGITAL distributes it, the task is in a run state when the RTS/8 system begins executing. If the target system has the Monitor Console Routine, it releases control of the terminal, and the test task sends a message that it wishes to print a string on the terminal. This string consists of the characters you type in response to the Test Task prompt. After you type the string, the Test Task prints it. If you type an ESCAPE to terminate the string, the Test Task suspends itself. You may reactivate the Test Task by requesting it to run from the MCR. The MACREL source code for the test task shows the use of the .TASK and .NONRES macros. Thus, you can make the Test Task nonresident. EXIT TASK? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) You include this task so that the target system can perform special processing before the RTS/8 system returns control to the OS/8 Monitor. See Section 4.6 of the RTS/8 User's Manual. ___________________ OS/8 SUPPORT TASK? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) 2-36 THE SYSGEN DIALOGUE This task allows the RTS/8 system to support the execution of an OS/8 operating system in the background of a foreground/background system. OS/8 SHARED BACKGROUND TERMINAL SUPPORT TASK? [Y/N] (Y): THE OS/8 BACKGROUND TERMINAL SUPPORT TASK ALLOWS A TERMINAL TO BE SHARED BY FOREGROUND TASKS AND AN OS/8 BACKGROUND. (DOC. NO 323) Answer yes to this question if the OS/8 terminal background terminal is the same as the RTS/8 foreground. THIS SECTION PRESENTS THE QUESTIONS remark WHICH REQUIRE MULTIPLE PARAMETERS TO SPECIFY remark THE OS/8 BACKGROUND TASK WHICH YOU HAVE SELECTED. remark (DOC. NO 166) remark If you selected the OS/8 task, the SYSGEN prints the above remark. HOW MANY FIELDS DO YOU WISH TO ALLOCATE FOR THE OS/8 BACKGROUND? [D] (2): OS/8 REQUIRES A MINIMUM OF 2 FIELDS (8K). IF YOU WISH TO USE BATCH, YOU NEED A MINIMUM OF 3 FIELDS (12K). (DOC. NO 170) OS/8 requires a minimum of two memory fields to operate. If you will use the OS/8 BATCH utility when RTS/8 is running, OS/8 requires a minimum of three fields. You may, however, specify up to 8 fields of memory if the target system has a KT8A. WHAT IS THE OS/8 KEYBOARD DEVICE CODE? [O] (03): TYPE THE DEVICE CODE FOR THE KEY- BOARD DEVICE YOU HAVE SELECTED FOR THE OS/8 TASK. (DOC. NO 174) Your answer must be between 1 and 113. The keyboard device code is the code for the terminal keyboard (which is different than the teleprinter described in the next question). See also DOC. NO 254. 2-37 THE SYSGEN DIALOGUE SYSGEN uses device codes in the range 100 to 113 to indicate that the terminal is attached to a KL8-A. Note that the keyboard and teleprinter codes are the same for a KL8-A terminal. Thus, 100-103 are the four lines on the first KL8-A; 104-107 for the second; and 110-113 for the third. WHAT IS THE OS/8 TELEPRINTER DEVICE CODE? [O] (04): TYPE THE DEVICE CODE FOR THE TERMINAL YOU HAVE SELECTED FOR THE OS/8 TASK. (DOC. NO 172) Your answer must be in the range 1 through 113. The teleprinter device code is the code for the logical unit that prints information from the PDP/8. If you do not know the device code, check with the system manager or your DIGITAL sales representative. WHAT IS THE RTS/8 HANDLER TASK FOR OS/8? [A] (RK8E): YOU SPECIFY THE SYSTEM DEVICE FOR THE OS/8 TASK HERE. TO ANSWER THIS QUESTION, TYPE THE SYSTEM DRIVER TASK (UP TO 6 CHARACTERS). THIS DEVICE MUST BE 'SYS' AT THE TIME YOU RUN THE TARGET SYSTEM. (DOC. NO 176) This question asks you to enter the device name upon which SYS resides. This device is also that which the swap task uses. DO YOU WANT THE OS/8 BACKGROUND TASK TO RUN IN THE HIGHEST AVAILABLE FIELDS? [Y/N] (Y): THE OS/8 SUPPORT TASK RUNS THE OS/8 BACKGROUND IN CONTIGUOUS FIELDS (TYPICALLY THE HIGHEST FIELDS OF THE TARGET MACHINE). THE KT8A ALLOWS THE OS/8 BACKGROUND FIELDS TO BE LOCATED IN CONTIGUOUS FIELDS OTHER THAN THE HIGHEST FIELDS. ENTER THE DECIMAL NUMBER OF THE LOWEST FIELD IN WHICH OS/8 WILL RUN. FIELD 0 IS RESERVED FOR RTS/8. (DOC. NO 202) If the target system possesses KT8A memory management hardware, the OS/8 support task can reside wherever it is most convenient for you to place it. (If you do not have the KT8A, the SYSGEN does not ask this 2-38 THE SYSGEN DIALOGUE question. Instead, it automatically places OS/8 in the highest memory fields.) You must make sure that OS/8 does not reside in the same field where RTS/8 resides (see DOC. NO 353). Normally you would place RTS/8 in field 0 and OS/8 in the upper memory fields. If you inadvertently place the two in the same field of memory, RTS/8 does not assemble. WHAT IS THE LOWEST FIELD WHICH RTS/8 WILL USE FOR THE OS/8 TASK? [D] (?): THE OS/8 SUPPORT TASK RUNS THE OS/8 BACKGROUND IN CONTIGUOUS FIELDS (TYPICALLY THE HIGHEST FIELDS OF THE TARGET MACHINE). THE KT8A ALLOWS THE OS/8 BACKGROUND FIELDS TO BE LOCATED IN CONTIGUOUS FIELDS OTHER THAN THE HIGHEST FIELDS. ENTER THE DECIMAL NUMBER OF THE LOWEST FIELD IN WHICH OS/8 WILL RUN. FIELD 0 IS RESERVED FOR RTS/8. (DOC. NO 202) Your answer must be in the range 1 through 30 (decimal). Only if you answer no to the previous question does the SYSGEN print this question. If you do not wish OS/8 to run in the highest fields of memory, enter the lowest field in which it will run. (See also the comment for DOC. NO 202 above.) HOW MANY NULL CHARACTERS ARE REQUIRED AFTER A LINE FEED UNDER OS/8? [D] (0): TO ALLOW AN I/O DEVICE TIME TO COMPLETE A LINE FEED BEFORE TRANSMITTING THE NEXT CHARACTER, ZERO CHARACTERS (NULLS) ARE PADDED INTO THE TRANSMISSION FOLLOWING THE LINE FEED CHARACTER. YOU MUST DETERMINE FROM THE CONFIGURATION OF THE TARGET SYSTEM HOW MANY ARE REQUIRED. (EXAMPLE: A 2400 BAUD VT-50 REQUIRES 4). (DOC. NO 204) Your answer must be in the range 0 through 10 (decimal). Some terminals require null characters as fill to allow a carriage return/line feed to complete its mechanical motion before transmitting additional characters. If you are unsure, check with the system manager or your sales representative. If you have a KL8-JA interface, it automatically provides pad characters. 2-39 THE SYSGEN DIALOGUE WHAT IS THE TASK NAME FOR THE OS/8 BACKGROUND TERMINAL SUPPORT TASK? [A] (TTY): TYPE THE TASK NAME OF THE TERMINAL HANDLER WHICH THE FOREGROUND WILL SHARE WITH THE OS/8 SUPPORT TASK. (DOC. NO 327) If you select the default to this question, you must have stated previously that the target system has at least one TTY task. If you do not include a TTY task, the RTS/8 system you create cannot execute correctly unless you include an alternate task. NULL JOB? [Y/N] (N): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION. (DOC. NO 073) SYSGEN prints this question only if you have a PDP 8/A. The function of this task is to display a sequential series of numbers on the LED accumulator. If you answer no to this question or if you do not have a PDP 8/A, the Executive uses a null task that is part of the MCR task. If your system does not have an MCR, the RTS/8 Executive uses a small null routine included within its code. DO YOU WANT TO INCLUDE ANY USER TASKS IN THIS RTS/8 SYSTEM? [Y/N] (N): YOU MAY SPECIFY USER TASKS DURING THIS PORTION OF THE QUESTION AND ANSWER PROGRAM. ANSWER YES IF YOU HAVE ANY TASKS TO INCLUDE OTHER THAN THE SYSTEM TASKS SELECTED ABOVE. (DOC. NO 300) A user task is a task that you write which is to be part of the RTS/8 system. If you answer yes to this question, the SYSGEN prints the following remark. 2-40 THE SYSGEN DIALOGUE ENTER THE NAMES OF YOUR TASKS FOLLOWED BY remark A CARRIAGE RETURN. EXAMPLE: remark remark TASK 1: NAME-1,M remark TASK 2: NAME-2,M remark . remark . remark . remark TASK N: NAME-N,M remark remark M IS THE PARTITION WHERE THE TASK WILL RESIDE remark (ENTER ZERO OR NO ENTRY FOR THE MAIN LEVEL). remark YOU SHOULD ENTER THE TASK IN THE ORDER OF remark DECREASING PRIORITY (THE FIRST ENTERED HAS THE HIGH- remark EST PRIORITY). TERMINATE ENTRY BY TYPING A CARRIAGE remark RETURN (ONLY). remark (DOC. NO 301) remark TASK 001 ?: An RTS/8 system may contain up to 127 tasks. However, the number of tasks that you may include at this point is dependent on the number of DIGITAL tasks you specify; that is, the total number of tasks is 127, not the number of user tasks. The task name must be the name of the source file; for example, task MYOWN must have the source file MYOWN.MA. You should enter the tasks in order of decreasing priority. You may not enter an extension to any user task as the task name that you type must have an .MA extension. (Note that the period you type before an extension is an illegal character in the SYSGEN.) If you make a mistake in assigning priorities (or partitions), the SYSGEN gives you an opportunity to make corrections in the following two questions. However, if you enter a task name incorrectly, you must repeat this question beginning at task 1. You repeat the question by typing a carriage return to leave the question, then type a # followed by the question number of this question. If you attempt to enter more than 127 tasks, the SYSGEN prints an error message and then prints the following question. This question is also the next question when you type a carriage return in response to the TASK prompt. DO YOU WANT TO CHANGE ANY OF THE TASK'S PRIORITIES? [Y/N] (N): YOU MAY CHANGE THE PRIORITY OF ANY OF THE TASKS HERE. DIGITAL RECOMMENDS THAT YOU LEAVE THE PRIORITY OF THE SYSTEM TASKS AS IS. FOR YOUR CONVENIENCE, THE NAMES OF SYSTEM AND 2-41 THE SYSGEN DIALOGUE USER TASKS WHICH YOU HAVE SPECIFIED CAN BE LISTED HERE. (DOC. NO 307) If you answer YES to this question, the SYSGEN prints the following instructions. THE WAY IN WHICH YOU CHANGE DEVICE PRIORITIES remark IS TO NAME THAT TASK WHICH WILL BE HIGHER IN remark PRIORITY THAN THE NEXT NAMED TASK, TAKEN A PAIR AT A remark TIME, AND DELIMITED BY A COMMA. remark remark EXAMPLE: remark remark PRIORITY CHANGE: TASK-3, TASK-1 remark PLACES TASK-3 HIGHER IN PRIORITY THAN remark TASK-1. THE TASK ORDER WILL NOW BE TASK-3, remark TASK-1, TASK-2. WHEN YOU FINISH CHANGING remark PRIORITIES, A CARRIAGE RETURN (ONLY) TERMINATES THE ENTRY. remark remark TYPE ? AND A CARRIAGE RETURN TO OBTAIN A LIST- remark ING OF THE CURRENT TASK PRIORITIES AFTER ANY remark PRIORITY PROMPT DURING THE RESPONSE TO THIS QUESTION remark (DOC. NO 312) PRIORITY CHANGE: The above line is the system prompt for you to begin. If you are unsure of the task priority order, type a question mark in response to the PRIORITY CHANGE prompt. The SYSGEN then lists all tasks in the system and their priority in octal. The following is a sample worksheet. RTS8 BUILD PROGRAM TASK PRIORITY ASSIGNMENT TASK PRIORITY PWRF = 001 CLOCK = 002 RL01 = 003 RX8A = 004 RX8B = 005 LPT = 006 TTY = 007 MCR = 010 0S8 = 011 2-42 THE SYSGEN DIALOGUE If, in response to PRIORITY CHANGE prompts, you type RX8A,RL01 RX8B,RL01 and then type a question mark, you receive the following worksheet. RTS8 BUILD PROGRAM TASK PRIORITY ASSIGNMENT TASK PRIORITY PWRF = 001 CLOCK = 002 RX8A = 003 RX8B = 004 RL01 = 005 LPT = 006 TTY = 007 MCR = 010 0S8 = 011 In this second listing, the two floppy controller tasks now have a higher priority than the RL01 task. The remainder of the listing is the same. If your system does not have a line printer, the SYSGEN automatically displays the information on your terminal. If you wish to display this information on your terminal and you have a line printer, use an OS/8 ASSIGN command to assign the line printer to TTY before beginning the SYSGEN. If you assign the line printer to your terminal and you state in other questions that the assembler and map listings will go to the LPT, then you must o Not chain to BATCH, o Use the OS/8 DEASSIGN command, and o Execute the Pass 2 output files by running BATCH. If your system includes nonresident tasks, the SWAP task must have a higher priority than any nonresident user task. After answering this question, you may not branch to a previous question using the # feature. DO YOU WANT TO CHANGE ANY TASK'S PARTITION ASSIGNMENT? [Y/N] (N): 2-43 THE SYSGEN DIALOGUE IF YOU WISH TO CHANGE THE PARTITION ASSIGNMENT OF ANY TASK (SYSTEM OR USER), ANSWER YES TO THE QUESTION. MOST SYSTEM TASKS MUST BE MEMORY RESIDENT, AND SHOULD NOT BE ASSIGNED TO A PARTITION. NO TASK WITH A PRIORITY HIGHER THAN THE SWAP TASK MAY BE SWAPPED. (DOC. NO 242) If you answer YES to this question, the SYSGEN prints the following instructions. AT THIS POINT, YOU SPECIFY THE NAMES OF THE remark TASKS WHICH YOU WISH TO PLACE IN DIFFERENT remark PARTITIONS. EXAMPLE: remark remark PARTITION : TASK-1,M remark CAUSES TASK-1 TO BE PLACED IN PARTITION M. remark TYPE A ? AND A CARRIAGE RETURN TO OBTAIN A CURRENT remark LISTING OF PARTITION ALLOCATION. remark A CARRIAGE RETURN (ONLY) TERMINATES THE ENTRY. remark (DOC. NO 314) PARTITION : This question changes only the partition assignments. If you wish to obtain a worksheet of the present partition assignments, type a question mark in response to the PARTITION prompt. A worksheet for a small system might look as follows. RTS8 BUILD PROGRAM TASK PARTITION ALLOCATION TASK PARTITION PWRF 0 CLOCK 0 RL01 0 RX8A 0 RX8B 0 LPT 0 TTY 0 MCR 0 OS8 0 SWAP 0 A 1 B 1 C 2 D 3 E 4 2-44 THE SYSGEN DIALOGUE The following responses to PARTITION prompts MCR,6 B,5 cause the following worksheet to appear in response to a question mark. RTS8 BUILD PROGRAM TASK PARTITION ALLOCATION TASK PARTITION PWRF 0 CLOCK 0 RL01 0 RX8A 0 RX8B 0 LPT 0 TTY 0 OS8 0 SWAP 0 A 1 C 2 D 3 E 4 B 5 MCR 6 This second worksheet differs from the first in that it shows that task B now executes in partition 5 and the MCR executes in partition 6. ------------------- NOTE ------------------- | MCR is the only DIGITAL-supplied task | | that you can successfully make | | nonresident. However, the SYSGEN does | | not know that a task cannot be made | | nonresident. Thus, you can place any | | task into any partition. To prevent | | DIGITAL tasks from becoming nonresident, | | each task except the MCR has code that | | overrides your input and does not allow | | LINK to place the task into a partition. | -------------------------------------------- If you do not have a line printer to display the partitions, the SYSGEN displays the information on your terminal. If you have a line printer and wish to display the information on your terminal, use an 2-45 THE SYSGEN DIALOGUE OS/8 ASSIGN command before beginning the SYSGEN. (See the comment to DOC. NO 301 for additional information.) The above question is the last question of the SYSGEN. If you took the default path, the SYSGEN prints THE QUESTION AND ANSWER SESSION IS remark COMPLETED. A DEFAULT SYSTEM IS NOW BEING remark PRODUCED. remark If you do not take the default path, the SYSGEN prints THE QUESTION AND ANSWER SESSION IS COMPLETED. remark THE PROGRAM WILL CONTINUE ON TO remark PASS 2 (FILE BUILDING). remark For both default and non-default, the SYSGEN prints the following if you do not chain to BATCH. PASS 2 COMPLETED. RETURNING TO MONITOR If you chain to BATCH, the BATCH program prints PASS 2 COMPLETED. CHAINING TO BATCH AS REQUESTED $JOB-MACREL TASK ASSEMBLY $MSG MOUNT TASK SOURCES ON SYS: AND STRIKE ANY KEY TO CONTINUE 2.3 PASS 2 AND BATCH As stated in the previous section, the output of the SYSGEN is 1. A Parameter file 2. A MACREL batch file 3. A LINK batch file 4. From 0 to 4 TTY control files (The source file TTY.MA does not need an external control file. Instead, the control information for this file is part of the parameter file.) 2-46 THE SYSGEN DIALOGUE 5. From 0 to 4 floppy control files The function of Pass 2 is to create these files and write them to the device you specify. The Pass 2 actions always occur and the SYSGEN always writes these files. Chapter 3 presents these files for a major RTS/8 system. Ordinarily, you do not need to understand the information contained in these files. You may, of course, use OS/8 to list these files on your terminal or line printer. The parameter file that the SYSGEN creates consists of a series of equates. These equates define symbols that the RTS/8 task sources use when they assemble. The equates may define task priority, set up conditional assemblies, and provide other such information. See Chapter 4 for additional information on the Parameter File. The switches that appear in the MACREL and LINK batch file are dependent upon the answers you give to SYSGEN questions. The MACREL batch file is a series of commands, one for each task in the RTS/8 system, that instruct MACREL to assemble the tasks. A sample statement is: .MAC SYS: TTYSY 01 CLOCK O 02 TTY M 03 MCR 04 EXIT R >SYSTAT TTY 02 TTY M 0051: 0000 2224 0000 0062 >DATE 27-NOV-78 >DATE 27-NOV-78 >TIME 00:00:35 >TIME 15:04 >TIME 15:04:01 >EXIT $END $END BATCH . 3-3 TWO EXAMPLE SYSGENS 3.3 A NORMAL SYSGEN .R SYSGEN ON WHAT DEVICE IS SCRIPT.SV LOCATED ? : SYS RTS/8 V03 SYSTEM BUILDER PROGRAM V01. THIS PROGRAM IS A CONVERSATIONAL QUESTION AND ANSWER SYSTEM FOR BUILDING AN RTS/8 REAL TIME SYSTEMS. THE QUESTIONS AND EXPLANATIONS IN THIS DIALOGUE ARE BRIEF. CHAPTER 2 IN THE SYSTEM GENERATION MANUAL INCLUDES AD- DITIONAL INFORMATION. 001 DO YOU WANT PROGRAM OPERATION INFORMATION? (YOU MAY TYPE Y FOR YES OR N FOR NO FOLLOWED BY A CARRIAGE RETURN): YES OR NO ANSWERS ARE INDICATED BY A [Y/N] NOTATION. TYPE A 'Y' FOR YES OR AN 'N' FOR NO FOLLOWED BY A CARRIAGE RETURN TO ANSWER THE QUESTION. QUESTIONS REQUIRING A NUMERICAL RESPONSE ARE INDICATED BY A [D] FOR DECIMAL OR AN [O] FOR OCTAL. ENTER THE NUMBER FOLLOWED BY A CARRIAGE RETURN. (ALWAYS INTEGER) QUESTIONS REQUIRING AN ALPHANUMERIC ANSWER ARE INDICATED BY [A]. RESPOND BY TYPING THE ALPHANUMERIC DATA FOLLOWED BY A CARRIAGE RETURN. 002 ARE YOU READY TO CONTINUE? [Y/N](Y): IF YOU WOULD LIKE AN EXPLANATION OF A QUESTION, TYPE A ? FOLLOWED BY A CARRIAGE RETURN. THE PROGRAM THEN PRINTS AN EXPLANA- TION AND ALSO REPRINTS THE QUESTION. ON THE LINE FOLLOWING MOST REMARKS IS A DOCUMENTATION NUMBER OF THE FORM (DOC. NO NNN). YOU USE THIS NUMBER TO LOCATE ADDITIONAL INFORMATION IN THE SYSTEM GENERATION MANUAL. 3-4 TWO EXAMPLE SYSGENS EACH QUESTION HAS A NUMBER ASSOCIATED WITH IT. IF YOU NOTICE A MISTAKE DURING AN RTS/8 QUESTION SESSION, TYPING #NNN CAUSES QUESTION NUMBER NNN TO BE REPEATED. YOU CAN THEN CHANGE THE ANSWER TO NNN. THE PROGRAM THEN RESUMES AT THIS NEW QUESTION. IT ALSO RENUMBERS QUESTIONS BEGINNING AT THIS NUMBER. (NOTE THAT AFTER A TASK PRIORITY CHANGE, THIS FEATURE IS NOT SERVICED.) 003 ARE YOU READY TO CONTINUE? [Y/N](Y): IF YOU TYPE AN INVALID ANSWER, THE PROGRAM PRINTS AN ERROR MESSAGE, AND THEN REPRINTS THE QUESTION. CONTROL C RETURNS YOU TO THE OS/8 KEY- BOARD MONITOR AND ABORTS THE CURRENT SYSGEN. FOR FILE STORAGE SPECIFICATIONS SUCH AS DTA0, THE PROGRAM EXPECTS STANDARD DEVICE NAMES. NOTE THAT YOU DO NOT APPEND A COLON TO THE DEVICE NAME. NEXT TO THE BRACKETS [] INDICATING THE EXPECTED RESPONSE ARE PARENTHESES () WHICH INDICATE THE DEFAULT ANSWER. YOU SELECT THE DEFAULT ANSWER BY JUST TYPING A CARRIAGE RETURN. 004 IS THE TARGET MACHINE FOR WHICH YOU ARE BUILDING THE RTS/8 SYSTEM A PDP 8/A? [Y/N] (Y):NO 005 IS THE TARGET MACHINE A PDP 8/E? [Y/N] (N):MAYBE ERROR 021 NOT A YES OR NO ANSWER OR BAD DEFAULT FOR Y/N RECORD 005 IS THE TARGET MACHINE A PDP 8/E? [Y/N] (N): 006 IS THE TARGET MACHINE A PDP-12? [Y/N] (N): 007 IS THE TARGET MACHINE A VT78 SYSTEM? [Y/N] (N): THE TARGET MACHINE MUST BE A PDP 8/I, A PDP 8/L, A PDP-8, OR A LINC-8 BECAUSE IT IS NOT ONE OF THE ABOVE. (DOC. NO 046) 3-5 TWO EXAMPLE SYSGENS 008 TO WHICH DEVICE SHOULD SYSGEN WRITE THE OUTPUT FILES? [A] (SYS):RXA0 009 DO YOU WANT TO CHAIN IMMEDIATELY TO THE RTS/8 SYSTEM WHICH BATCH CAN PRODUCE? [Y/N] (Y):#8 008 TO WHICH DEVICE SHOULD SYSGEN WRITE THE OUTPUT FILES? [A] (SYS): 009 DO YOU WANT TO CHAIN IMMEDIATELY TO THE RTS/8 SYSTEM WHICH BATCH CAN PRODUCE? [Y/N:] (Y):NO 010 WHAT FIVE CHARACTER NAME WOULD YOU LIKE TO CALL THE FILES PRODUCED? [A] (DEFLT):MY^U MINE 011 DO YOU WANT THE SYSGEN PROGRAM TO REQUEST BATCH TO RUN BEFORE TERMINATING [Y/N] (Y): 012 ON WHICH INPUT DEVICE DO THE SOURCE FILES RESIDE? [A] (SYS):RKB0 013 ON WHICH DEVICE SHOULD BATCH STORE THE .RB FILES? [A] (SYS):RKA0 014 ON WHICH OUTPUT DEVICE SHOULD BATCH STORE THE .SV FILE? [A] (SYS):RXA0 015 DO YOU WANT ASSEMBLY LISTINGS? [Y/N] (N):Y 016 TO WHICH OUTPUT DEVICE SHOULD BATCH WRITE THE ASSEMBLY LISTINGS? [A] (LPT): 017 DO YOU WANT LINKER LOAD MAP LISTINGS? [Y/N] (N):Y 018 ON WHICH OUTPUT DEVICE SHOULD BATCH WRITE THE MEMORY MAP LISTINGS? [A] (LPT): 019 DO YOU WISH TO BUILD AN RTS/8 SYSTEM WITHOUT SPECIFYING ANY PARAMETERS? [Y/N] (N): 3-6 TWO EXAMPLE SYSGENS 020 ARE ALL SOURCE FILES ON THE SAME MEDIUM? [Y/N] (Y):Y 021 DOES THE TARGET SYSTEM HAVE EAE HARDWARE?[Y/N] (N):? EAE HARDWARE IS AN OPTION WHICH MAY BE PRESENT IN THE TARGET CONFIGURATION. EAE HARDWARE ALLOWS OPERATIONS SUCH AS MULTIPLY AND DIVIDE TO BE PERFORMED IN THE HARDWARE. (DOC. NO 050) 021 DOES THE TARGET SYSTEM HAVE EAE HARDWARE?[Y/N] (N):Y 022 DO YOU WISH TO SAVE THE CONTENTS OF THE EAE REGISTERS WHEN TASK SWITCHING OCCURS? [Y/N] (Y): 023 HOW MANY FIELDS OF MEMORY EXIST IN THE TARGET MACHINE? [D] (4):#21 021 DOES THE TARGET SYSTEM HAVE EAE HARDWARE?[Y/N] (N): 022 DOES THE TARGET SYSTEM HAVE A HARDWARE MQ REGISTER? [Y/N] (Y): 023 DO YOU WANT TO SAVE THE CONTENTS OF THE MQ REGISTER WHEN TASK SWITCHING OCCURS? [Y/N] (Y): 024 HOW MANY FIELDS OF MEMORY EXIST IN THE TARGET MACHINE? [D] (4):32 025 IN WHICH FIELD DOES RTS8 RESIDE? [D] (0):32 ERROR 202 NUMERICAL ANSWER NOT WITHIN SPECIFIED LIMITS 025 IN WHICH FIELD DOES RTS8 RESIDE? [D] (0):29 026 DOES YOUR TARGET SYSTEM HAVE POWER FAIL HARDWARE? [Y/N] (N):Y 027 DOES THE TARGET SYSTEM HAVE KL8A HARDWARE? [Y/N] (N):Y 028 HOW MANY KL8A'S ARE IN THE TARGET SYSTEM? [D] (1):3 3-7 TWO EXAMPLE SYSGENS 029 DO YOU HAVE KT8A HARDWARE IN THE TARGET SYSTEM? [Y/N] (N):Y 030 DO YOU WANT ANY OF THE DEC- PROVIDED SYSTEM TASKS IN YOUR RTS/8 SYSTEM? [Y/N] (Y): EACH DEC TASK WILL BE LISTED ONE AT A TIME. IF YOU WISH TO INCLUDE THE TASK IN YOUR SYSTEM, TYPE Y. IF NOT, TYPE N. IF THE SYSGEN PROGRAM REQUIRES MORE INFORMATION ABOUT A TASK, IT WILL ASK THE QUESTIONS IN ANOTHER SECTION . (DOC. NO 073) 031 DO YOU WANT THE POWER FAIL HANDLER? [Y/N] (N) :Y 032 CLOCK HANDLER? [Y/N] (N):Y 033 UNIVERSAL DIGITAL CONTROLLER TASK? [Y/N] (N):Y 034 RF08 DISK DRIVER? [Y/N] (N):Y 035 DF32 DISK DRIVER? [Y/N] (N):Y 036 RK8E DISK DRIVER? [Y/N] (N):Y 037 RK8 DISK DRIVER? [Y/N] (N):Y 038 RL01 DISK DRIVER? [Y/N] (N):Y 039 DECTAFE DRIVER? [Y/N] (N):Y 040 FIRST FLOPPY CONTROLLER? [Y/N] (N):Y 041 SECOND FLOPPY CONTROLLER? [Y/N] (N):Y 042 THIRD FLOPPY CONTROLLER? [Y/N] (N):Y 043 FOURTH FLOPPY CONTROLLER? [Y/N] (N):Y 3-8 TWO EXAMPLE SYSGENS 044 LINE PRINTER DRIVER? [Y/N] (N):Y 045 TELETYPE DRIVER? [Y/N] (Y):Y 046 EMERGENCY BREAKTHROUGH TASK? [Y/N] (N):Y 047 SWAPPER TASK? [Y/N] (N):Y 048 CASSETTE DRIVER? [Y/N] (N):Y 049 DO YOU WANT THE CASSETTE FILE SUPPORT TASK? [Y/N] (N):Y 050 OS/8 FILE SUPPORT TASK? [Y/N] (N):Y 051 MONITOR CONSOLE ROUTINE? [Y/N] (Y): 052 RTS/8 TEST TASK? [Y/N] (N):N 053 EXIT TASK? [Y/N] (N):Y 054 OS/8 SUPPORT TASK? [Y/N] (N):Y 055 OS/8 BACKGROUND TERMINAL SUPPORT TASK? [Y/N] (Y):Y THIS SECTION PRESENTS THE QUESTIONS WHICH REQUIRE MULTIPLE PARAMETERS TO SPECIFY THE OS/8 TASK WHICH YOU HAVE SELECTED. (DOC. NO 166) 056 HOW MANY FIELDS DO YOU WISH TO ALLOCATE FOR THE OS/8 BACKGROUND? [D] (2):? OS/8 REQUIRES A MINIMUM OF 2 FIELDS (8K). IF YOU WISH TO USE BATCH. YOU NEED A MINIMUM OF 3 FIELDS (12K). (DOC. NO 170) 056 HOW MANY FIELDS DO YOU WISH TO ALLOCATE FOR THE OS/8 BACKGROUND? [D] (2):3 3-9 TWO EXAMPLE SYSGENS 057 WHAT IS THE OS/8 KEYBOARD DEVICE CODE? [O] (03):9 ERROR 030 RESPONSE NOT OCTAL/DECIMAL AS EXPECTED 057 WHAT IS THE OS/8 KEYBOARD DEVICE CODE? [O] (03): 058 WHAT IS THE OS/8 TELEPRINTER DEVICE CODE? [O] (04): 059 WHAT IS THE RTS/8 HANDLER TASK FOR OS/8? [A] (RK8E): 060 HOW MANY NULL CHARACTERS ARE REQUIRED AFTER A LINE FEED UNDER OS/8? [D] (O): 061 DO YOU WANT THE OS/8 BACKGROUND TASK TO RUN IN THE HIGHEST AVAILABLE FIELDS? [Y/N] (Y):? THE OS/8 SUPPORT TASK RUNS THE OS/8 BACKGROUND IN CONTIGUOUS FIELDS (TYPICALLY THE HIGHEST FIELDS OF THE TARGET MACHINE). THE KT8A ALLOWS THE OS/8 BACKGROUND FIELDS TO BE LOCATED IN CONTIGUOUS FIELDS OTHER THAN THE HIGHEST FIELDS. ENTER THE DECIMAL NUMBER OF THE LOWEST FIELD IN WHICH OS/8 WILL RUN. FIELD 0 IS RESERVED FOR RTS/8. (DOC. NO 202) 061 DO YOU WANT THE OS/8 BACKGROUND TASK TO RUN IN THE HIGHEST AVAILABLE FIELDS? [Y/N] (Y):30 ERROR 021 NOT A YES OR NO ANSWER OR BAD DEFAULT FOR Y/N RECORD 061 DO YOU WANT THE OS/8 BACKGROUND TASK TO RUN IN THE HIGHEST AVAILABLE FIELDS? [Y/N] (Y):N 062 WHAT IS THE LOWEST FIELD WHICH RTS/8 WILL USE FOR THE OS/8 TASK? [D] (?):30 THIS SECTION PRESENTS THE PARAMETERS REQUIRED TO SPECIFY THE MCR TASK WHICH YOU HAVE SELECTED. (DOC. NO 205) 3-10 TWO EXAMPLE SYSGENS 063 DO YOU WANT TIME-OF-DAY FACILITY IN YOUR MCR TASK? [Y/N] (Y): 064 DO YOU WANT THE MCR SYSTEM STATUS REPORT CAPABILITY? [Y/N] (Y): 065 WHICH TERMINAL WILL THE MCR TASK USE? [A] (TTY): THIS SECTION PRESENTS THE PARAMETERS REQUIRED TO SPECIFY THE CLOCK TASK WHICH YOU HAVE SELECTED. (DOC. NO 216) 066 DOES YOUR TARGET SYSTEM HAVE A STANDARD CLOCK? [Y/N] (Y): 067 HOW MANY SOFTWARE TICKS PER SECOND? [D] (10):#66 066 DOES YOUR TARGET SYSTEM HAVE A STANDARD CLOCK? [Y/N] (Y):? STANDARD CLOCKS: CPU CLOCK --- ----- PDP 8/A PDP8A PDP 8/E DK8EA/DK8EC PDP-12 KW12 VT-78 PDP8A OTHER DK8EA/DK8E IF YOUR TARGET SYSTEM HAS A CLOCK OTHER THOSE INDICATED IN THE TABLE, ANSWER 'N' TO THIS QUESTION (DOC. NO 20) 066 DOES YOUR TARGET SYSTEM HAVE A STANDARD CLOCK? [Y/N] (Y):N 067 WHAT IS THE DEC DESIGNATION FOR THE NON- STANDARD CLOCK? [A] (?):PDP8A 068 HOW MANY SOFTWARE TICKS PER SECOND? [D] (10):30 069 HOW MANY ENTRY SLOTS IN THE CLOCK QUEUE DO YOU WANT? [D] (16):128 3-11 TWO EXAMPLE SYSGENS 070 DO YOU WANT THE SPECIAL CLOCK INTERRUPT LINKAGE? [Y/N] (N):Y THIS SECTION PRESENTS THOSE PARAMETERS WHICH RTS/8 REQUIRES TO SPECIFY THE UDC TASK WHICH YOU HAVE SELECTED. (DOC. NO 225) 071 HOW MANY INTERRUPTS CAN BE STORED AT ONE TIME? [O] (12): 072 HOW MANY COUNTER MODULES IN THE TARGET SYSTEM UDC? [O] (1): 073 HOW MANY CONTACT MODULES IN THE UDC? [O] (2): 074 HOW MANY ANALOG INPUT CONVERTER MODULES? [O] (2):