DOCUMENTATION CHANGES FOR: RDOS SYSTEM REFERENCE PART NUMBER 093-400027-01 THIS FILE (FILENAME 093400027.01) CONTAINS INFORMATION THAT AFFECTS THE FOLLOWING PAGES OF YOUR MANUAL: *28 *100 *221 *41 *110 *APPENDIX J *43 *111 *44 *112 49 *142 *53 *152 *57 *155 *63 *169 *70 *172 *71 *175 *75 *176 *92 211 THIS SECOND REVISION OF 093400027.01 WAS UPDATED ON JANUARY 18, 1989. ITEMS APPEARING HERE SINCE THE LAST REVISION ARE EASY TO IDENTIFY: IN THE LIST ABOVE, ASTERISKS (*) MARK PAGES WITH CHANGES PRINTED IN THIS FILE FOR THE FIRST TIME. AND, IN THE MARGIN OF PAGES THAT FOLLOW, CHANGE BARS (|) MARK THE NEW MATERIAL. FOR EXAMPLE, THIS REVISION OF 093400027.01 CONTAINS A CHANGE TO PAGE 175 OF ITS PARENT MANUAL. YOU ARE SEEING THIS CHANGE FOR THE FIRST TIME, AND BARS APPEAR NEXT TO IT. TO KEEP YOUR MANUAL CURRENT, YOU SHOULD DO EITHER OF THE FOLLOWING: O MARK THE AFFECTED PAGES OF YOUR MANUAL SO THAT YOU WILL KNOW TO REFER TO THIS FILE FOR ADDITIONAL INFORMATION. O PRINT THIS FILE, PUNCH HOLES TO FIT YOUR BINDER, AND INSERT THE PAGES INTO YOUR MANUAL. COPYRIGHT (C) DATA GENERAL CORPORATION, 1983-1989 ALL RIGHTS RESERVED LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 28 | USE THE FOLLOWING INFORMATION TO UPDATE TABLE 2.4. | | AC1 MEANING | --- ------- | | DCESC = 1B7 DG/RDOS ONLY. IF YOU ASK FOR ^C^X INTERRUPT | SEQUENCES WHEN YOU RUN SYSGEN AND THEN OPEN A | MULTIPLEXOR LINE WITH CHARACTERISTICS BITS 7 | AND 15 SET, THE SYSTEM WILL MAP ESC TO ^C^A. | | DCXON = 1B8 IF YOU OPEN A MULTIPLEXOR LINE WITH THIS BIT | SET, THE SYSTEM DOES NOT INTERPRET ^S AND ^Q AS | STOP AND START CHARACTERS. INSTEAD, ^S AND ^Q | ARE PASSED DIRECTLY TO YOUR PROGRAM. | | DCKEY = 1B10 IF YOU OPEN A MULTIPLEXOR LINE WITH THIS BIT | SET, LINE EDIT (^Z, ESC, \, DEL) AND THE | ECHOING OF INPUT ARE DISABLED ON A .RDL SYSTEM | CALL. (ON AN .RDS SYSTEM CALL, LINE-EDIT | CHARACTERS ARE ALWAYS PASSED TO YOUR PROGRAM, | AND THE ECHOING OF INPUT IS ALWAYS DISABLED.) | | NOTE: IF DCXON IS SET AND DCKEY IS NOT SET WHEN YOU OPEN A QTY | LINE, THE OPERATING SYSTEM TRANSMITS A CTRL-Q AT THE | BEGINNING AND A CTRL-S AT THE END OF EACH .RDS AND .RDL | SYSTEM CALL ON THAT LINE. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 41 | IN ITS DISCUSSION OF THE .RLSE SYSTEM CALL, THE MANUAL MENTIONS | RELEASING THE MASTER DIRECTORY. THE MANUAL SHOULD ADD THAT YOU CAN | RELEASE THE MASTER DIRECTORY ONLY IF NO FOREGROUND PROGRAM IS | RUNNING AND THE PROGRAM RUNNING IN THE BACKGROUND IS AT BASE LEVEL. | ALSO, IN RDOS, RELEASING THE MASTER DIRECTORY SHUTS DOWN THE | OPERATING SYSTEM. | | ADD THE FOLLOWING ENTRIES TO THE TABLE IN THE RIGHT COLUMN CALLED | "POSSIBLE ERRORS." | | AC2 MNEMONIC MEANING | --- -------- ------- | | 70 ERFGE FOREGROUND ALREADY RUNNING | | 72 EROPD DIRECTORY SHARED RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 43 | REPLACE THE FIRST PARAGRAPH IN THE DISCUSSION OF THE .EQIV SYSTEM | CALL WITH THE FOLLOWING ONE: | | THIS CALL ASSIGNS A TEMPORARY NAME TO A DISK OR TAPE UNIT, | PERMITTING UNIT INDEPENDENCE DURING THE EXECUTION OF YOUR | PROGRAM. THUS, YOU MIGHT WRITE ALL MAGNETIC TAPE REFERENCES IN | A PROGRAM AS MTAPE AND, AT RUNTIME, USE THE CLI COMMAND EQUIV | TO ASSIGN THE NAME MTAPE TO A SPECIFIC DEVICE SUCH AS MT6. YOU | MUST ISSUE THIS COMMAND BEFORE INITIALIZING THE DEVICE UNDER | ITS NEW NAME. THE MASTER DIRECTORY CANNOT BE ASSIGNED A | TEMPORARY NAME. ALSO, IF YOU ARE WORKING IN DG/RDOS AND THE | MASTER DIRECTORY IS A SECONDARY PARTITION, THE PARENT DISK | CANNOT BE GIVEN SUCH A NAME. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 44 | THE FOLLOWING DESCRIPTION OF THE .SMDIR SYSTEM CALL SHOULD FOLLOW | THAT OF .MDIR. | | .SMDIR (DG/RDOS ONLY) | CHANGE THE MASTER DIRECTORY | | THIS CALL ALLOWS YOU TO MAKE A NEW DIRECTORY YOUR MASTER | DIRECTORY WITHOUT REBOOTING THE OPERATING SYSTEM. BEFORE THE | CALL WILL SUCCEED, HOWEVER, THE SYSTEM YOUR PROGRAM IS RUNNING | ON MUST MEET THE FOLLOWING CRITERIA. | | 1) BOTH THE CURRENT MASTER DIRECTORY AND THE PROPOSED NEW | MASTER DIRECTORY MUST BE PRIMARY PARTITIONS (THAT IS, | DISKS). | | 2) NEITHER DIRECTORY CAN BE INITIALIZED. | | 3) NO FOREGROUND PROGRAM CAN BE RUNNING, AND THE PROGRAM | RUNNING IN THE BACKGROUND MUST BE AT BASE LEVEL. | | REQUIRED INPUT | | AC0 - BYTE POINTER TO THE NAME OF THE NEW MASTER DIRECTORY. | | FORMAT | | .SYSTM | .SMDIR | ERROR RETURN | NORMAL RETURN | | POSSIBLE ERRORS | | AC2 MNEMONIC MEANING | --- -------- ------- | | 2 ERICM ILLEGAL SYSTEM COMMAND | | 3 ERICD ILLEGAL COMMAND FOR DEVICE | | 25 ERCM3 PUSH DEPTH EXCEEDED | | 36 ERDNM DEVICE NOT IN SYSTEM | | 45 ERIBS DEVICE ALREADY IN SYSTEM RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 | 52 ERIDS ILLEGAL DIRECTORY NAME | | 56 ERDIU DIRECTORY IN USE | | 70 ERFGE FOREGROUND ALREADY RUNNING RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 49 THE LAST ENTRY IN TABLE 3.4 SHOULD READ AS FOLLOWS: UFTDL RIGHT BYTE: FUNCTIONS AS A DCT LINK. BITS 10-15 CONTAIN THE DEVICE CODE OF THE DEVICE THAT HOLDS THE FILE. LEFT BYTE: CONTAINS THE HIGH-ORDER BITS OF THE FILE'S LOGICAL BLOCK ADDRESS. (THE REST OF THIS ADDRESS IS STORED IN UFTAD.) IF THE FILE IS ON A SMALL DISK, THIS BYTE WILL CONTAIN ZEROS. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 53 | THE NEXT TO LAST ENTRY IN TABLE 3.7 NEEDS TO BE CHANGED AS FOLLOWS: | | AC2 MNEMONIC MEANING | --- -------- ------- | | 1B15 DCNI WHEN FILE IS QTY LINE: INTERRUPTS ARE | ENABLED ON THIS LINE RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 57 | THE FOLLOWING INFORMATION IS RELATED TO THE .OPEN SYSTEM CALL. | | THE RDOS AND DG/RDOS CONSOLE DRIVERS ALLOW YOU TO OPEN THE | INPUT LINE FOR BINARY INPUT AND, THUS, OVERRIDE ANY INTERPRETA- | TION OF SPECIAL CHARACTERS. THERE ARE TWO TYPES OF BINARY | INPUT. ONE IS ABSOLUTE BINARY INPUT, AND THE OTHER IS BINARY | INPUT WITH SOFTWARE BUSY ENABLED. IN ABSOLUTE BINARY MODE, ALL | CHARACTERS THAT ARE INPUT ARE PASSED TO YOUR PROGRAM WITHOUT | INTERPRETATION OR ECHOING. IN BINARY MODE WITH SOFTWARE BUSY | ENABLED, ALL CHARACTERS YOU ENTER, EXCEPT XON/XOFF | (CTRL-S/CTRL-Q), ARE PASSED TO YOUR PROGRAM WITHOUT ECHOING. | | YOU INVOKE BINARY INPUT BY SETTING BITS IN THE DEVICE CHARAC- | TERISTIC MASK THAT IS PASSED IN AC1 ON THE .OPEN SYSTEM CALL. | THE FOLLOWING TABLE SHOWS THE BIT SETTINGS FOR EACH POSSIBLE | STATE. THE OTHER BITS OF THE USER DEVICE CHARACTERISTIC MASK | ARE DEFINED ON PAGE 53. | | USER DEVICE CHARACTERISTIC MASK OPERATING MODE | BIT 12 BIT 15 | 0 0 NORMAL MODE | 0 1 BINARY MODE WITH SOFTWARE | BUSY ENABLED | 1 0 RESERVED (DEFAULTS TO | NORMAL MODE) | 1 1 ABSOLUTE BINARY MODE | | NOTES ABOUT USING BINARY MODE: | | 1) ALTHOUGH YOU ENTER BINARY MODE BY OPENING A CHANNEL TO $TTI | OR $TTI1, THE MODE IS A FUNCTION OF THE DEVICE. THIS MEANS | THAT A SECOND CHANNEL OPENED TO THE SAME DEVICE WILL ALSO | BE IN A BINARY MODE REGARDLESS OF THE SETTING OF BITS 12 | AND 15 IN AC1 ON THE SECOND .OPEN SYSTEM CALL. ALSO NOTE | THAT BINARY INPUT REMAINS IN EFFECT UNTIL EITHER CHANNEL IS | CLOSED. | | 2) XON/XOFF (CTRL-S/CTRL-Q) IS DISABLED IN ABSOLUTE BINARY | MODE. | | 3) IN NORMAL MODE THE DRIVER INTERCHANGES THE NEW LINE AND | CARRIAGE RETURN CODES. THIS INTERCHANGE DOES NOT OCCUR IN | EITHER OF THE BINARY MODES. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 63 | CHANGE THE SECOND PARAGRAPH IN THE DEFINITION OF THE .SPOS SYSTEM | CALL TO READ AS FOLLOWS: | | RDOS INDICATES THE RELATIVE CHARACTER POSITION WITHIN A FILE BY | THE DOUBLE-PRECISION BYTE POINTER ILLUSTRATED IN FIGURE 3.1. | IF YOU SET THE FILE POINTER BEYOND THE END OF A FILE, RDOS WILL | EXTEND THE FILE'S LENGTH AUTOMATICALLY THE NEXT TIME YOU WRITE | TO THE FILE, WITH ONE EXCEPTION. IF YOU SET THE FILE POINTER | BEYOND THE END OF A CONTIGUOUS FILE, THAT IS, ONE THAT CANNOT | BE EXTENDED, RDOS TAKES THE ERROR RETURN AND PASSES ERSCP IN | AC2. ONLY POSITION 0, THE FILE'S STARTING LOCATION, CAN BE | SPECIFIED ON MAGNETIC TAPE. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 70 | MAKE THE FOLLOWING CHANGES IN THE "REQUIRED INPUT" SECTION OF THE | DISCUSSION OF THE .MTDIO SYSTEM CALL. FIRST, IF YOU WANT TO READ | THE DEVICE STATUS WORD, AC1, NOT AC0, SHOULD CONTAIN THE COMMAND | WORD, SO THE FIRST PARAGRAPH SHOULD READ LIKE THIS: | | THE FOLLOWING INPUT IS REQUIRED TO READ THE DEVICE STATUS WORD. | | AC1 - COMMAND WORD, WITH BITS 1 THROUGH 3 SET AND ALL OTHER | BITS 0. | | AC2 - CHANNEL NUMBER, IF THE SYSTEM CALL SPECIFIES CHANNEL 77. SECOND, IN DISCUSSING THE INPUT REQUIRED FOR OPERATIONS OTHER THAN READING THE DEVICE STATUS WORD, THE MANUAL STATES THAT YOU SHOULD SET BIT 0 OF AC1 TO 1 FOR EVEN PARITY AND TO 0 FOR ODD PARITY. ADD THE FOLLOWING NOTE TO THAT STATEMENT. SET BIT 0 OF AC1 TO SELECT EVEN PARITY ONLY ON A MODEL 6027 TAPE DRIVE. THIS BIT SHOULD NOT BE SET FOR OTHER TAPE DRIVES SUPPORTED BY RDOS AND DG/RDOS. FOR EXAMPLE, THIS BIT IS IGNORED ON A 6026, RESULTS IN AN ILLEGAL COMMAND ERROR ON THE MODEL 6125 TAPE UNIT, AND WILL PUT A 6299 OR 6300 IN DIAGNOSTIC MODE. | THIRD, NEAR THE BOTTOM OF THE PAGE, THE MANUAL EXPLAINS WHAT SHOULD | BE IN BITS 4-15 OF AC1. CHANGE THE CURRENT EXPLANATION TO READ AS | FOLLOWS: | | BITS 4-15 RECORD OR WORD COUNT. IF 0 ON A SPACE FORWARD OR | BACKWARD COMMAND AND THE FILE IS NO MORE THAN 4096 | RECORDS LONG, RDOS POSITIONS THE TAPE TO THE | BEGINNING OF THE NEXT (OR PREVIOUS) FILE ON THE | TAPE. IF 0 ON A READ COMMAND, RDOS READS WORDS | UNTIL IT ENCOUNTERS EITHER AN END OF RECORD OR 4096 | WORDS. IF 0 ON A WRITE COMMAND, THE SYSTEM WRITES | 4096 WORDS. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 71 | THE FOLLOWING DESCRIPTION OF THE .MTDRW SYSTEM CALL SHOULD FOLLOW | THAT OF .MTDIO. | | .MTDRW (DG/RDOS ONLY) | | PERFORM FREE FORMAT I/O | | THIS COMMAND PROVIDES READING AND WRITING CAPABILITIES SIMILAR | TO THOSE PROVIDED BY .MTDIO, BUT OFFERS A LARGER MAXIMUM RECORD | SIZE. IT ALLOWS YOU TO READ OR WRITE DATA IN VARIABLE LENGTH | RECORDS OF FROM 1 TO 8192 WORDS. BEFORE YOU CAN USE THIS CALL, | YOU MUST OPEN THE TAPE UNIT FOR FREE FORMAT I/O WITH THE SYSTEM | CALL .MTOPD. | | REQUIRED INPUT | | AC0 - MEMORY ADDRESS FOR DATA TRANSFER. | | AC1 - COMMAND WORD, DIVIDED INTO TWO FIELDS: | | BIT 0 SET TO 0 FOR READING WORDS, OR TO 1 FOR | WRITING WORDS. | | BITS 1-15 WORD COUNT. THIS WORD COUNT CAN BE A | MAXIMUM OF 8192. (IF THE COUNT IS 0, .MTDRW | ATTEMPTS TO READ OR WRITE 64-KBYTE RECORDS.) | | AC2 - CHANNEL NUMBER IF THE SYSTEM CALL SPECIFIES CHANNEL 77. | | FORMAT | | .SYSTM | .MTDRW N | ERROR RETURN | NORMAL RETURN | | VARIABLE N REPRESENTS THE CHANNEL NUMBER. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 | THE POSSIBLE ERRORS AND THE VALUES RETURNED IN ACCUMULATORS ARE | THE SAME AS THOSE FOR .MTDIO WITH THESE TWO EXCEPTIONS: | | 1) THE VALUE RETURNED IN AC0 IS UNDEFINED. | | 2) ERROR ERDCH (INSUFFICIENT ROOM IN DATA CHANNEL MAP) IS | RETURNED IF YOU TRY TO TRANSFER A TAPE RECORD LARGER THAN | THE LARGEST RECORD SUPPORTED BY THE OPERATING SYSTEM, ONE | OF 8192 WORDS. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 75 | THERE IS AN ERROR IN THE SECOND PARAGRAPH OF THE DESCRIPTION OF THE | .MEMI SYSTEM CALL. THE NEXT TO LAST SENTENCE IN THAT PARAGRAPH | SAYS THAT TO RUN THE LARGEST POSSIBLE SAVE FILE, YOU CAN SET THE | VALUE OF NMAX AS HIGH AS 77416. THIS FIGURE SHOULD ACTUALLY BE | 100000. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 92 | REPLACE THE FIRST PARAGRAPH ON THE PAGE WITH THE FOLLOWING ONE: | | A PROGRAM WITH OPEN MULTIPLEXOR LINES MUST CLOSE THOSE LINES | BEFORE IT CAN SWAP TO ANOTHER PROGRAM. IT IS YOUR RESPONSIBIL- | ITY TO MAKE SURE THESE LINES ARE CLOSED; THE .EXEC SYSTEM CALL | WILL NOT TAKE AN ERROR RETURN IF YOU FORGET TO DO SO. ALSO, | NOTE THAT ANY PROGRAM YOU PLAN TO SWAP OR CHAIN TO MUST BE AN | EXECUTABLE FILE. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 100 | IN THE SECTION "POSSIBLE ERRORS," CHANGE THE ENTRIES FOR ERMEM AND | ERFIL TO READ AS FOLLOWS: | | AC2 MNEMONIC MEANING | --- -------- ------- | | 26 ERMEM INSUFFICIENT MEMORY TO LOAD VIRTUAL | OVERLAYS (MAPPED SYSTEMS ONLY). | | 30 ERFIL FILE READ ERROR ON VIRTUAL OVERLAY FILE | (MAPPED SYSTEMS ONLY). | | ALSO, ADD TWO NEW POSSIBLE ERRORS TO THE LIST. | | AC2 MNEMONIC MEANING | --- -------- ------- | | 45 ERIBS DEVICE ALREADY IN SYSTEM. (YOU TRIED TO | OPEN A VIRTUAL OVERLAY AFTER USING THE | .MAPDF SYSTEM CALL.) | | 60 ERFIU FILE IN USE. (YOU TRIED TO OPEN A VIRTUAL | OVERLAY TWICE.) RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 110 | REPLACE THE CURRENT SECTION "POSSIBLE ERRORS" WITH THE FOLLOWING | ONE: | | AC2 MNEMONIC MEANING | --- -------- ------- | | 26 ERMEM INSUFFICIENT MEMORY TO EXECUTE PROGRAM. | THIS ERROR OCCURS (1) IF AC1 OR AC2 IS | EQUAL TO 0, OR EQUAL TO OR GREATER THAN | 32,768, (2) IF THE TOP OF THE WINDOW WOULD | BE BEYOND NMAX, OR (3) IF NOT ENOUGH PAGES | ARE AVAILABLE IN YOUR GROUND. | | 45 ERIBS DEVICE ALREADY IN SYSTEM. (YOU TRIED TO | DEFINE A WINDOW AND WINDOW MAP TWICE.) RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 111 | ABOUT TWO THIRDS OF THE WAY DOWN THE LEFT COLUMN, THE MANUAL STATES | THAT YOU CAN USE BITS 9 AND 10 OF AC1 ONLY UNDER ZRDOS. HOWEVER, | YOU CAN ACTUALLY USE THESE BITS UNDER TRDOS AND DG/RDOS AS WELL. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 112 | ADD THE FOLLOWING INFORMATION TO THE TABLE ENTITLED "POSSIBLE | ERRORS": | | AC2 MNEMONIC MEANING | --- -------- ------- | | 135 EREMP INVALID WINDOW BLOCK NUMBER (.REMAP) RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 142 | UNDER THE HEADING ".IDST" THERE IS A LIST OF CODES THAT THE COMMAND | MAY RETURN IN AC0. CHANGE THE DESCRIPTIONS OF CODES 2, 5, 6, AND 7 | TO READ AS FOLLOWS: | | CODE DESCRIPTION | | 2 SUSPENDED BY A .SUSP, .ASUSP, OR .TIDS COMMAND. | | 5 DOUBLY SUSPENDED BY .ASUSP OR .TIDS AND BY .SYSTM. | | 6 DOUBLY SUSPENDED BY .XMTW OR .REC AND .ASUSP OR .TIDS. | | 7 WAITING FOR AN OVERLAY NODE AND SUSPENDED BY .ASUSP OR | .TIDS. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 152 | UNDER THE HEADING "TST" THERE IS A LIST OF CODES THAT THE COMMAND | MAY DISPLAY ON YOUR CONSOLE. CHANGE THE DESCRIPTIONS OF CODES 2, | 5, 6, AND 7 TO READ AS FOLLOWS: | | CODE DESCRIPTION | | 2 SUSPENDED BY A .SUSP, .ASUSP, OR .TIDS COMMAND. | | 5 DOUBLY SUSPENDED BY .ASUSP OR .TIDS AND BY .SYSTM. | | 6 DOUBLY SUSPENDED BY .XMTW OR .REC AND .ASUSP OR .TIDS. | | 7 WAITING FOR AN OVERLAY NODE AND SUSPENDED BY .ASUSP OR | .TIDS. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 155 | CHANGE THE "FORMAT" SECTION IN THE DEFINITION OF THE .MULTI SYSTEM | CALL TO READ AS FOLLOWS: | | FORMAT | | .MULTI | NORMAL RETURN RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 169 | UNDER THE HEADING "REQUIRED INPUT," REPLACE THE INSTRUCTIONS FOR | USING AC1 WITH THESE DIRECTIONS: | | AC1 - 1B1: GIVE THE NEW BACKGROUND PROGRAM THE SAME PRIORITY | AS THE CHECKPOINTED PROGRAM. CLEAR ALL OTHER BITS | IN AC1 TO ZERO. | | ALSO, IN THE RIGHT COLUMN, CHANGE THE ENTRY FOR ERROR CODE 25 TO | READ AS FOLLOWS: | | AC2 MNEMONIC MEANING | --- -------- ------- | | 25 ERCM3 PUSH DEPTH EXCEEDED RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 172 | THERE ARE TWO MISTAKES ON THIS PAGE. ONE OCCURS IN THE FIRST | PARAGRAPH WHERE THE MANUAL STATES THAT "A MAXIMUM OF 10 USER | DEVICES CAN BE IDENTIFIED TO THE SYSTEM AT ANY MOMENT." IN | ACTUALITY, THE MAXIMUM NUMBER COULD BE ANY NUMBER BETWEEN 0 AND 64, | DEPENDING ON HOW YOU ANSWERED SYSGEN'S QUESTION ABOUT USER-DEFINED | DEVICES. THE OTHER OCCURS AT THE TOP OF THE SECOND COLUMN. THE | PROPER FORMAT FOR THE SYSTEM CALL IS AS FOLLOWS: | | .SYSTM | .IDEF | ERROR RETURN | NORMAL RETURN RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 175 | THE FOLLOWING MATERIAL FITS IN JUST AFTER THE DESCRIPTION OF THE | .STMAP SYSTEM CALL. | | .DVMAP (DG/RDOS ONLY) | DEVICE MAP | | THIS CALL MAPS THE FIRST OF A MEMORY-MAPPED DEVICE'S "SPECIAL | SPACE" PAGES INTO A PAGE IN THE SECOND 64 KBYTES OF YOUR | LOGICAL ADDRESS SPACE. YOU MUST USE THIS CALL TO .IDEF AND | DRIVE AN INTELLIGENT ASYNCHRONOUS OR SYNCHRONOUS CONTROLLER ON | AN MV/1400 DC, MV/2000 DC, OR MV/2500 DC SYSTEM. | | BECAUSE OF INTERNAL OPERATING SYSTEM RESTRICTIONS, DEVICE PAGES | MAY ONLY BE MAPPED INTO USER PAGES BETWEEN 32 AND 63 DECIMAL. | YOU MUST USE MV INSTRUCTIONS TO ACCESS THESE PAGES. ALSO, | BECAUSE TCBS AND OTHER OPERATING SYSTEM DATA STRUCTURES ONLY | SAVE THE LOW ORDER 16 BITS OF THE ACCUMULATORS, YOU MUST | DISABLE INTERRUPTS WHILE USING THESE INSTRUCTIONS. | | REQUIRED INPUT | | AC0 - DEVICE CODE. THIS CODE MUST BE ONE OF THE FOLLOWING | OCTAL VALUES: | 30 LSC INSTALLED IN UPPER (A) POSITION | 31 LSC INSTALLED IN LOWER (B) POSITION | 40 MODEL 4560 LAC OR MODEL 5560 LAC WITH ITS | DEVICE-CODE SELECTOR POSITIONED TO THE RIGHT | INSTALLED IN UPPER (A) POSITION | 41 MODEL 4560 LAC OR MODEL 5560 LAC WITH ITS | DEVICE-CODE SELECTOR POSITIONED TO THE RIGHT | INSTALLED IN LOWER (B) POSITION | 46 MODEL 5560 LAC WITH ITS DEVICE-CODE SELECTOR | POSITIONED TO THE LEFT INSTALLED IN UPPER (A) | POSITION | 47 MODEL 5560 LAC WITH ITS DEVICE-CODE SELECTOR | POSITIONED TO THE LEFT INSTALLED IN LOWER (B) | POSITION | | AC1 - BITS 0-7 FIRST DEVICE PAGE TO MAP. THIS VALUE MUST | BE 0. | | BITS 8-15 FIRST USER PAGE TO MAP. THIS VALUE MUST BE | BETWEEN 32 AND 63 DECIMAL. | | AC2 - NUMBER OF PAGES TO MAP. THIS VALUE MUST BE 1. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 | FORMAT | | .SYSTM | .DVMAP | ERROR RETURN | NORMAL RETURN | | ERROR ERICM (ILLEGAL SYSTEM COMMAND) IS RETURNED IF YOU SUPPLY | INVALID ARGUMENTS, OR IF YOU TRY THE CALL UNDER DG/RDOS ON ANY | MACHINE OTHER THAN AN MV/1400 DC, MV/2000 DC, OR MV/2500 DC | COMPUTER. | | TYPICALLY, A PROGRAM WOULD PERFORM THE FOLLOWING SEQUENCE OF | OPERATIONS: | | 1) .DEBL THE DEVICE CODE. | | 2) .IDEF THE DEVICE CODE AS A NON-DATA-CHANNEL DEVICE. | | 3) .DVMAP THE FIRST DEVICE PAGE INTO PAGE 32 OF USER SPACE. IF | YOU HAVE .IDEFED A SECOND MEMORY-MAPPED DEVICE, .DVMAP ITS | FIRST DEVICE PAGE INTO PAGE 33 OF USER SPACE, AND SO ON. USING | THIS PROCEDURE, YOU NEED TO USE THE .DVMAP SYSTEM CALL ONLY | ONCE FOR EACH DEVICE DURING THE LIFE OF THE PROGRAM. | | THE AMOUNT OF LOGICAL AND EXTENDED MEMORY AVAILABLE TO THE PROGRAM | (VIA THE SYSTEM CALLS .MEM/.MEMI, .VMEM/.MAPDF, AND .OVOPN IF YOU | ARE OPENING VIRTUAL OVERLAYS) IS NOT AFFECTED BY .DVMAP. THESE | MEMORY AREAS ARE ENTIRELY SEPARATE AND CANNOT BE MAPPED INTO EACH | OTHER. | | USE XWSTA, XWLDA, AND OTHER MV INSTRUCTIONS TO MOVE DATA BETWEEN | THE STANDARD 16-BIT ADDRESS SPACE AND THE DEVICE PAGE. MAKE SURE | THE HIGH ORDER 16 BITS OF ACCUMULATORS ARE SET PROPERLY; USE ZEX, | NLDAI, XLEF, LPHY, AND OTHER MV INSTRUCTIONS. DISABLE INTERRUPTS | DURING SEQUENCES OF MV INSTRUCTIONS TO GUARANTEE THAT THE HIGH | ORDER 16 BITS OF ACCUMULATORS ARE PRESERVED. | | APPENDIX J CONTAINS A SAMPLE PROGRAM THAT DEMONSTRATES THE USE OF | .DVMAP TO COMMUNICATE WITH A MEMORY-MAPPED DEVICE UNDER DG/RDOS | RUNNING ON AN MV/1400 DC, MV/2000 DC, OR MV/2500 DC SYSTEM. | | FOR DETAILS ON HOW TO PROGRAM THE LOCAL ASYNCHRONOUS CONTROLLER AND | LOCAL SYNCHRONOUS CONTROLLER, REFER TO THE FOLLOWING MANUALS: RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 | PART NUMBER TITLE | ----------- ----- | | 014-001207 ECLIPSE MV/2000 DC ASYNCHRONOUS CONTROLLER | PROGRAMMER'S REFERENCE | | 014-001208 ECLIPSE MV/2000 DC SYNCHRONOUS CONTROLLER | PROGRAMMER'S REFERENCE RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 176 | ADD THE FOLLOWING LINE UNDER THE HEADING "REQUIRED INPUT." | | AC0 - 77 (OCTAL), THE DEVICE CODE FOR THE CPU. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 211 INSERT THIS NEW ERROR CODE AT THE END OF TABLE A.2: CODE MNEMONIC MEANING ---- -------- ------- 135 EREMP AN INVALID WINDOW BLOCK NUMBER HAS BEEN PASSED TO THE .REMAP TASK CALL. (THE ERROR PREVIOUSLY RETURNED IN THIS SITUATION WAS ERADR.) RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 PAGE 221 ADD THE FOLLOWING ENTRIES UNDER THE HEADING "ENVIRONMENT STATUS BITS": ENMIC= 1B1 ;MICROECLIPSE: S/20, DESKTOP GENERATION, OR ;DG/500 SYSTEM (FORMERLY UNUSED) | ENMVR= 1B10 ;MV/CLASS ECLIPSE SYSTEM | ENDGR= 1B12 ;DG/RDOS SYSTEM (FORMERLY MEANT INFOS, IRDOS, ;OR JRDOS SYSTEM) PROGRAMS THAT CHECK THE ENVIRONMENT WORD AT RUNTIME MAY REQUIRE MODIFICATION. RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 APPENDIX J | ADD THE SAMPLE PROGRAM BELOW TO YOUR MANUAL AS APPENDIX J. | | APPENDIX J | -------------------------------------------------------------- | USING .DVMAP | | | | THIS SAMPLE PROGRAM DEMONSTRATES THE USE OF .DVMAP TO COMMUNI- | CATE WITH A MEMORY-MAPPED DEVICE UNDER DG/RDOS RUNNING ON AN | MV/1400 DC, MV/2000 DC, OR MV/2500 DC SYSTEM. A MEMORY-MAPPED | DEVICE IS A DEVICE YOU CANNOT ACCESS WITH I/O INSTRUCTIONS. | YOU ACCESS SUCH A DEVICE BY READING FROM OR WRITING TO A | PHYSICAL PAGE THAT RESOLVES TO THE DEVICE. YOU CAN USE THE | .DVMAP CALL UNDER DG/RDOS, WHICH SUPPORTS THE LAC AND THE LSC, | TO MAKE THE PHYSICAL PAGE ASSOCIATED WITH A MEMORY-MAPPED | DEVICE VISIBLE TO A DG/RDOS APPLICATION PROGRAM. THE FOLLOWING | PROGRAM DETERMINES WHETHER OR NOT THERE IS A LAC WITH THE | DEVICE CODE 40 IN THE SYSTEM. YOU CAN CHANGE LOCATION DVCOD TO | MODIFY THE PROGRAM TO SEARCH FOR ANOTHER DEVICE CODE IF YOU | DESIRE. | | .TITL SIZR | .NREL | | SIZR: | | ; THIS SIMPLE-MINDED PROGRAM MERELY .IDEFS AND .DVMAPS THE | ; MEMORY-MAPPED DEVICE WHOSE DEVICE CODE IS IN LOCATION DVCOD. | ; THEN IT TESTS TO SEE IF THE DEVICE IS PRESENT IN THE SYSTEM | ; VIA AN NIOC/NIOP/SKPDN SEQUENCE. THE PROGRAM DOES NOT | ; ACTUALLY LOAD CODE INTO THE DEVICE OR START IT RUNNING. | | ; FIRST, WE .IDEF THE DEVICE. NOTE THAT THERE IS NO DATA | ; CHANNEL ON AN MV/1400 DC, MV/2000 DC, OR MV/2500 DC COMPUTER, | ; SO WE USE THE NON-DATA-CHANNEL FLAVOR OF .IDEF. | | LDA 0,DVCOD ; DEVICE CODE | .SYST | .DEBL | JMP ERREX | | ELEF 1,LDCT ; DCT ADDRESS | SUB 2,2 | .SYST | .IDEF RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 | JMP ERRXT | | ; NOW, WE ISSUE A .DVMAP CALL TO MAP IN A PAGE OF THE DEVICE. | ; WE MAP THE DEVICE PAGE INTO PAGE 32 OF OUR ADDRESS SPACE. | ; SINCE WE CANNOT REACH THIS PAGE WITH ECLIPSE INSTRUCTIONS, | ; WE WILL USE MV-SPECIFIC INSTRUCTIONS TO ACCESS THIS PAGE | ; AFTER IT IS MAPPED IN. | | LDA 0,DVCOD ; DEVICE CODE | LDA 1,LPAGE ; LOGICAL PAGE 32 | SUBZL 2,2 ; ONLY NEED 1 PAGE | .SYST | .DVMAP | JMP ERRXT | | ; THE DEVICE PAGE IS MAPPED INTO LOGICAL PAGE 32 OF OUR | ; ADDRESS SPACE. WE WILL HAVE TO USE MV-SPECIFIC INSTRUCTIONS | ; TO ACCESS THIS PAGE. SINCE DG/RDOS ONLY GUARANTEES THE | ; CONTENTS OF THE LOWER 16 BITS OF OUR ACCUMULATORS IF A | ; SIGNIFICANT INTERRUPT OCCURS, WE WILL HAVE TO DISABLE | ; INTERRUPTS WHILE WE ARE USING THESE MV-SPECIFIC | ; INSTRUCTIONS. YOU CAN FIND DEFINITIONS FOR THE MV-SPECIFIC | ; INSTRUCTIONS USED IN THIS PROGRAM IN MVID.SR. | | ; AT THIS POINT A REAL APPLICATION WOULD INITIALIZE THE DEVICE | ; BY SENDING THE PHYSICAL ADDRESS OF VIRTUAL I/O REGISTERS TO | ; THE DEVICE USING THE INITIAL SERIAL PROTOCOL. NOTE THAT YOU | ; CAN USE THE XLEF AND LPHY INSTRUCTIONS TO OBTAIN THE | ; PHYSICAL ADDRESS THAT CORRESPONDS TO A LOGICAL ADDRESS IN AN | ; APPLICATION PROGRAM. SINCE THIS IS ONLY A SAMPLE PROGRAM, | ; HOWEVER, WE WILL LIMIT OURSELVES TO PLAYING WITH CLEAR/PULSE | ; AND THE DONE BIT OF THE DEVICE. | | ; THE RING OUR APPLICATION PROGRAM IS LOADED INTO DEPENDS ON | ; WHAT GROUND WE ARE IN AND WHAT REVISION OF DG/RDOS WE ARE | ; RUNNING. TO MAKE THIS LITTLE PROGRAM RUN IN EITHER GROUND | ; AND ALSO MAKE IT REVISION INDEPENDENT, WE WILL USE AN XLEF | ; 0,0 INSTRUCTION TO FIGURE OUT WHAT RING WE HAVE BEEN LOADED | ; INTO IN ORDER TO CONSTRUCT VALID 32-BIT LOGICAL ADDRESSES. | | INTDS ; SO WE WILL NOT BE DISTURBED | XLEF 0,0 ; GET LOGICAL ADDRESS OF LOC. 0 | XNLDA 2,LPAGE ; CONVERT LOGICAL PAGE # TO | WLSHI 10.,2 ; A WORD ADDRESS | WADD 0,2 ; ADD IN OUR RING FIELD | | ; THE 32-BIT LOGICAL ADDRESS OF THE DEVICE PAGE IS IN AC2. WE | ; WILL NOW PERFORM AN NIOC/NIOP SEQUENCE TO THE DEVICE. IF RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 | ; THE DEVICE IS PRESENT IN THE SYSTEM, IT WILL RESPOND BY | ; SETTING ITS DONE BIT. | | XWSTA 0,200,2 ; MEMORY-MAPPED NIOC | XWSTA 0,300,2 ; MEMORY-MAPPED NIOP | | ; POLL THE DEVICE'S DONE BIT FOR A WHILE. IF THE DONE BIT IS | ; NOT SET IN A REASONABLE TIME, WE CONCLUDE THE DEVICE IS NOT | ; THERE. | | LDA 0,CTHI ; 2-WORD COUNTER | LDA 1,CTLO | HILP: INC 0,0,SNR ; BUMP COUNTER (HIGH WORD) | JMP NODEV ; COUNTER = 0; DEVICE IS ABSENT | LOLP: INC 1,1,SNR ; BUMP COUNTER (LOW WORD) | JMP HILP ; LOW WORD WRAPPED | XWLDA 3,0,2 ; BUSY/DONE/DEVICE-CODE REG. | ANDI 1B9.,3 ; BIT 9 IS DONE BIT | MOV 3,3,SNR ; IS THE DONE BIT SET? | JMP LOLP ; NOT SET YET, CONTINUE LOOPING | | ; THE DEVICE RESPONDED TO US. RESET IT AND EXIT NORMALLY. | | XWSTA 0,200,2 ; MEMORY-MAPPED NIOC | INTEN | .SYST | .RTN | | ; THE DEVICE DID NOT RESPOND. EXIT WITH ERROR MESSAGE. | | NODEV: ELEF 2,ERDNM ; "DEVICE NOT IN SYSTEM" | | ERRXT: INTEN | | ERREX: .SYST | .ERTN | | ; DUMMY ISR FOR MEMORY-MAPPED DEVICE. SINCE THIS PROGRAM | ; TALKS TO THE DEVICE WITH INTERRUPTS OFF, WE SHOULD NEVER | ; ENCOUNTER THIS CODE. | | IMPOS: HALT ; SHOULD NOT HAPPEN | | ; MISCELLANEOUS STORAGE USED BY SIZR. | | DVCOD: 40 ; DEVICE CODE OF LAC IN THE "A" | ; BERTH. THIS MAY BE SET TO | ; 41, 30, OR 31 TO TEST FOR A RDOS SYSTEM REFERENCE, 093-400027-01 18/JAN/89 DOCUMENTATION CHANGES, REVISION 02 | ; LAC IN THE "B" BERTH OR A LSC | ; IN EITHER BERTH. | LPAGE: 32. ; MEMORY-MAPPED I/O PAGE # | CTHI: -4 ; 2-WORD SKPDN COUNTER | CTLO: 0 | LDCT: 0 ; NON-DCH DCT | -1 ; A SAFE MASK | IMPOS ; ISR ADDRESS | | .END SIZR | --END OF UPDATE FILE--