Google
 

Trailing-Edge - PDP-10 Archives - dec-10-omona-u-mc9 - twe4a.rnd
There are no other files named twe4a.rnd in the archive.
.;4-APR-77-YL
\\
.LM0;.RM70;.F;.J;.FLAG CAP;.SP1;.TS5
<TWICE.DOC -- ^CHANGES FROM ^V4(23) TO ^V4^A(24)
.BR
^MARCH 1977
.FG30
^COPYRIGHT (^C) 1973,1975,1977
.BR
^DIGITAL ^EQUIPMENT ^CORPORATION, ^MAYNARD, ^MASS.
.B 2
^THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE INCLUSION
OF THE ABOVE COPYRIGHT NOTICE. ^THIS SOFTWARE, OR ANY OTHER
COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE
TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH SYSTEM AND TO ONE WHO
AGREES TO THESE LICENSE TERMS. ^TITLE TO AND OWNERSHIP OF THE
SOFTWARE SHALL AT ALL TIMES REMAIN IN <DEC.
.B 1
^THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY ^DIGITAL
^EQUIPMENT ^CORPORATION.
.B 1
<DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY <DEC.
.T <TWE4A.DOC
.PG
<TWICE.DOC -- ^CHANGES FROM ^V4(23) TO ^V4^A(24)
.BR
^MARCH 1977
.B 3
1.0##^^SUMMARY\\
.B 1
^^TWICE\\ HAS BEEN CHANGED TO ASSEMBLE AND LOAD WITH VERSION 6.03 OF
^^TOPS10\\.
.B 3
2.0##^^EXTERNAL CHANGES\\
.B 1
^UNITS THAT ARE DOWN ARE NOW LISTED BUT A RESPONSE (1, 2, OR 3) IS NOT
REQUIRED - SAME AS "^Q" RESPONSE TO REGULAR MONITOR.
.B 3
3.0##^^KNOWN BUGS AND DEFICIENCIES\\
.B 1
^NONE.
.B 3
4.0##^^INSTALLATION INSTRUCTIONS\\
.B 1
^THE FILE ^^TWICE.CTL\\ WILL PRODUCE ^^TWICE.HGH\\ AND ^^TWICE.LOW\\.
^IT IS RECOMMENDED THAT THE ^^TWICE.HGH\\ AND ^^TWICE.LOW\\ ON THE TAPE
BE USED. ^NOTE THAT THE NEW VERSION OF <TWICE MUST BE USED TO
DEFINE <RP06 STRUCTURES. 6.02 <TWICE WILL NOT SET UP THE CORRECT VALUES.
.B 1
^WHEN WE ADDED ^^RP04\\'S WE CHANGED THE ^^MONGEN\\ DIALOGUE WHICH GENERATES
^^HDWMAX\\ (THE MAXIMAL DISK CONFIGURATION) TO CONTAIN TWO OF EACH TYPE
OF DISK CONTROLLER (^^FH, FS, DP, RP\\) AND THE MAXIMUM
NUMBER OF UNITS ON EACH CONTROLLER. ^THIS WAS DONE BECAUSE WE DISCOVERED
THAT CERTAIN MACROS IN ^^COMMOD\\ BLOW UP WHEN MORE THAN EIGHT
CONTROLLERS ARE DEFINED. ^THOSE FEW INSTALLATIONS WITH MORE THAN TWO
CONTROLLERS OF THE SAME TYPE (MOST LIKELY ^^DPA'\S, DPB\\'S, AND ^^DPC\\'S)
MAY REMAKE ^^TWICE\\ FOR THEIR CONFIGURATION OR ELSE LIVE WITH THE
RESTRICTION THAT ^^TWICE\\ WON'T ACCESS UNITS ON THE THIRD CONTROLLER (E.G., ^^DPC\\'S).
.B 3
5.0##^^INTERNAL CHANGES\\
.B1
^EDIT _#
.B1.LM7.TS7.I-7
24	^SATISFY UNDEFINED GLOBAL REQUESTS NEW IN ^^TOPS10\\ VERSION
6.03.
.B3.LM0.TS5
[^END OF <TWE4A.DOC]
.B1
[<TWE4.DOC IS APPENDED AS AN INTEGRAL PART OF <TWE4A.DOC]
.T <TWE4.DOC
.PG
<TWICE.DOC -- ^CHANGES FROM ^V3^A(22) TO ^V4(23)
.BR
^AUGUST 1975
.B 3
1.0##^^SUMMARY\\
.B 1
^^TWICE\\ HAS BEEN CHANGED TO ASSEMBLE AND LOAD WITH VERSION 6.02 OF
^^TOPS10\\.
.B 3
2.0##^^EXTERNAL CHANGES\\
.B 1
\\^UNITS THAT ARE DOWN WILL NOW BE LISTED IN THE SECTION OF UNITS
NOT IN A FILE STRUCTURE, AS IS DONE IN VERSION 6.02 OF ^^TOPS10\\.
^THIS IS DUE TO THE HIGH AVAILABLILITY FEATURE WHICH RETAINS UNITS
IN THE UNIT DATA BLOCK CHAIN EVEN IF THEY ARE DOWN.  ^TWICE NOW HAS
A WRITABLE HIGH SEGMENT WHICH SHOULD NOT BE SHARED.  ^THIS CHANGE
IS DUE TO THE TWO SEGMENT MONITOR FEATURE OF 6.02.  ^THE NUMBER
OF MONITOR BUFFERS REPORTED BY ^^TWICE\\ IS NOW THE RESULT OF A ^^GETTAB\\
(^^%LDMBN\\).
^IF THE GETTAB FAILS, ^^TWICE\\
REPORTS THE VALUE THAT WAS SPECIFIED IN THE HARDWARE CONFIGURATION
FILE THAT IT WAS ASSEMBLED WITH.  ^THIS VERSION OF ^^TWICE\\ IS ONLY SUPPORTED WHEN ASSEMBLED AND LOADED
WITH MATERIAL FROM VERSION 6.02 OF ^^TOPS10\\.

.B 3
3.0##^^KNOWN BUGS AND DEFICIENCIES\\
.B 1
^NONE.
.B 3
4.0##^^INSTALLATION INSTRUCTIONS\\
.B 1
^THE FILE ^^TWICE.CTL\\ WILL PRODUCE ^^TWICE.HGH\\ AND ^^TWICE.LOW\\.  ^IT IS
RECOMMENDED THAT THE ^^TWICE.HGH\\ AND ^^TWICE.LOW\\ ON THE TAPE BE USED.
\\^DUE TO A CHANGE IN THE ^^HOM\\ BLOCKS IN 6.02, THIS VERSION OF
^^TWICE\\ WILL NOT REPORT THE CORRECT VALUE OF ^K FOR ^^CRASH.EXE\\
 (^^CRASH.SAV\\) FOR A FILE STRUCTURE UNLESS THAT STRUCTURE
WAS REFRESHED WITH ^^TOPS10\\ VERSION 6.02 OR THE EQUIVALENT.
.B 1
^WHEN WE ADDED ^^RP04\\'S WE CHANGED THE ^^MONGEN\\ DIALOGUE WHICH GENERATES
^^HDWMAX\\ (THE MAXIMAL DISK CONFIGURATION) TO CONTAIN TWO OF EACH TYPE
OF DISK CONTROLLER (^^FH, FS, DP, RP\\) AND THE MAXIMUM
NUMBER OF UNITS ON EACH CONTROLLER. ^THIS WAS DONE BECAUSE WE DISCOVERED
THAT CERTAIN MACROS IN ^^COMMOD\\ BLOW UP WHEN MORE THAN EIGHT
CONTROLLERS ARE DEFINED. ^THOSE FEW INSTALLATIONS WITH MORE THAN TWO
CONTROLLERS OF THE SAME TYPE (MOST LIKELY ^^DPA'\S, DPB\\'S, AND ^^DPC\\'S)
MAY REMAKE ^^TWICE\\ FOR THEIR CONFIGURATION OR ELSE LIVE WITH THE
RESTRICTION THAT ^^TWICE\\ WON'T ACCESS UNITS ON THE THIRD CONTROLLER (E.G., ^^DPC\\'S).
.B 3
5.0##^^INTERNAL CHANGES\\
.B 1;.LM 10;.I -10
^^EDIT\\#23##^SATISFY UNDEFINED GLOBAL REQUESTS NEW IN ^^TOPS10\\ VERSION
6.02, CHANGE DOWN UNIT LOGIC TO ACCOUNT FOR THE FACT THAT UNITS ARE
NEVER REMOVED FROM UNIT DATA BLOCK CHAIN, WRITE ENABLE MONITOR HIGH
SEGMENT SO ^^TWICE\\ CAN WRITE IN IT, ^^GETTAB\\ NUMBER OF MONITOR
BUFFERS FROM CURRENT MONITOR.
.B 2;.LM 0
[^END OF <TWE4.DOC]
.B1
[<TWE3A.DOC IS APPENDED AS AN INTEGRAL PART OF <TWE4.DOC]
.T <TWE3A.DOC
.PG
<TWICE.DOC -- ^CHANGES FROM V3(21) TO ^V3^A(22)
.BR
^JANUARY 1975
.B 3
1.0##^^SUMMARY\\
.B 1
^^TWICE\\ NOW SUPPORTS ^^RP04\\'S
.B 3
2.0##^^EXTERNAL CHANGES\\
.B 1
^NONE.
.B 3
3.0##^^KNOWN BUGS AND DEFICIENCIES\\
.B 1
^WHEN ASSEMBLED AND LOADED WITH 507 OR EARLIER MONITOR MODULES, ^^TWICE\\
SOMETIMES FAILS WITH AN ^^ILL MEM REF\\ WHEN USING THE ^^DESTROY\\ OPTION.
^THIS IS A PROBLEM IN ^^ONCMOD\\ WHICH AFFECTS THE ^^DESTROY\\ OPTION ONLY.
.B 3
4.0##^^INSTALLATION INSTRUCTIONS\\
.B 1
^THE FILE ^^TWICE.CTL\\ WILL PRODUCE ^^TWICE.SAV\\.  ^IT IS
RECOMMENDED THAT THE ^^TWICE.SAV\\ ON THE TAPE BE USED.  ^THIS ^^TWICE\\
SHOULD WORK UNDER ALL SUPPORTED 5-SERIES MONITORS, INCLUDING THOSE
WHICH DO NOT SUPPORT ^^RS04\\'S AND/OR ^^RP04\\'S.
.B 1
^WHEN WE ADDED ^^RP04\\'S WE CHANGED THE ^^MONGEN\\ DIALOGUE WHICH GENERATES
^^HDWMAX\\ (THE MAXIMAL DISK CONFIGURATION) TO CONTAIN TWO OF EACH TYPE
OF DISK CONTROLLER (^^FH, FS, DP, RP\\) AND THE MAXIMUM
NUMBER OF UNITS ON EACH CONTROLLER. ^THIS WAS DONE BECAUSE WE DISCOVERED
THAT CERTAIN MACROS IN ^^COMMOD\\ BLOW UP WHEN MORE THAN EIGHT
CONTROLLERS ARE DEFINED. ^THOSE FEW INSTALLATIONS WITH MORE THAN TWO
CONTROLLERS OF THE SAME TYPE (MOST LIKELY ^^DPA'\S, DPB\\'S, AND ^^DPC\\'S)
MAY REMAKE ^^TWICE\\ FOR THEIR CONFIGURATION OR ELSE LIVE WITH THE
RESTRICTION THAT ^^TWICE\\ WON'T ACCESS UNITS ON THE THIRD CONTROLLER (E.G., ^^DPC\\'S).
.B 3
5.0##^^INTERNAL CHANGES\\
.B 1;.LM 10;.I -10
^^EDIT\\#22##^INCLUDE ^^RP04\\ SUPPORT
.B 2;.LM 0
[^END OF ^^TWE3A.DOC\\]
.B 1
[^^TWE3.DOC\\ IS APPENDED AS AN INTEGRAL PART OF ^^TWE3A.DOC\\]
.T ^^TWE3.DOC\\
.PG
^^TWICE.DOC\\ -- ^CHANGES FROM V3(17) TO ^V3(21)
.BR
^OCTOBER 1974
.B 3
1.0##^^SUMMARY\\
.B 1
^^TWICE\\ HAS BEEN MODIFIED TO SUPPORT ^^RS04\\'S. ^IN ADDITION,
A BUG HAS BEEN FIXED WHICH CAUSED ^^STOPCD\\'S NOT TO BE PRINTED.
.B 3
2.0##^^EXTERNAL CHANGES\\
.B 1
^NONE.
.B 3
3.0##^^KNOWN BUGS AND DEFICIENCIES\\
.B 1
^^TWICE\\ SOMETIMES FAILS WITH AN ^^ILL MEM REF\\ WHEN USING THE
^^DESTROY\\ OPTION.  ^THIS IS A PROBLEM IN ^^ONCMOD\\ WHICH 
AFFECTS THE ^^DESTROY\\ OPTION ONLY.
.B 3
4.0##^^INSTALLATION INSTRUCTIONS\\
.B 1
^THE FILE ^^TWICE.CTL\\ WILL PRODUCE ^^TWICE.SAV\\.  ^IT IS RECOMMENDED
THAT THE ^^TWICE.SAV\\ ON THE TAPE BE USED.
.B 3
5.0##^^INTERNAL CHANGES\\
.B 1;.LM 9.I -9
^^EDIT\\#20##^SUPPORT ^^RS04\\'S.
.B 1;.I -9
^^EDIT\\#21##^FIX PROBLEM WITH ^^STOPCD\\'S, CHANGE ^^T4POPJ\\ INTO A REAL
ROUTINE SO ^^SATCN\\ IN ^^FILIO\\ CAN USE IT.
.B3.LM 0
[^END OF <TWE3.DOC]
.B1
[<TWE003.DOC IS APPENDED AS AN INTEGRAL PART OF <TWE3.DOC]
.T <TWE003.DOC
.PG
^^TWICE.DOC\\ -- ^CHANGES FROM V2 TO ^V3(17)
.BR
^FEBURARY 1973
.B 3
1.0##^^SUMMARY\\
.BLANK 1
^^TWICE\\ HAS BEEN MODIFIED TO RUN WITH 5.06 MONITOR SOURCES OR .^^REL\\
FILES AND INCORPORATES MANY OF THE NEW FEATURES OF THE 5.06 ^^ONCE\\-ONLY
DIALOGUE.  ^ALSO AN OPTIONAL SCRATCH FILE HAS BEEN ADDED TO FACILITATE
DEBUGGING ^^ONCE\\ OR ^^TWICE\\.  ^^TWICE\\ VERSION 3(17) REQUIRES
5.06 SOURCES OR .^^RELS\\ BUT SHOULD RUN ON ALL 5 - SERIES MONITORS.
.BLANK 3
.LEFT MARGIN 9
.INDENT -9
2.0##^^EXTERNAL CHANGES\\
.B 1;.I -4
1.##^THE NEW ONCE-ONLY OPTIONS FOR SHORTER DIALOGUES FOR DISK PARAMETER
CHANGES HAVE BEEN INCORPORATED.
.B 1;.I -4
2.##^AN OPTIONAL SCRATCH FILE HAS BEEN ADDED. ^^TWICE\\ NOW ASKS ^^USE
SCRATCH FILE (Y OR <CR>)?\\
.BLANK 1
^IF THE ANSWER IS YES, FILE ^^DSK:TWICE.BIN\\ IS CREATED, ALLOWING
50 BLOCKS FOR EACH "UNIT" AS SPECIFIED IN ^^COMMOD\\. ^FURTHER DISK ^I/^O
IS TO THIS FILE INSTEAD OF REAL DISK UNITS, SO THAT, FOR EXAMPLE, REAL ^^HOME\\
 BLOCKS ARE NOT CLOBBERED. ^I/^O TO A GIVEN BLOCK ON A UNIT
IS CHANGED TO MEAN THE CORRESPONDING BLOCK WITHIN THE 50 BLOCKS REPRESENTING
THE UNIT IN THE SCRATCH FILE, USING REGULAR ^^USETI/USETO\\ INSTEAD OF
SUPER#-# ^^USETI/USETO\\. ^I/^O TO A BLOCK OUT OF RANGE IS DONE
TO THE LAST BLOCK IN THE FILE FOR THAT UNIT. ^THE NUMBER OF BLOCKS
RESERVED FOR EACH UNIT IS AN ASSEMBLY PARAMETER ^^BLKPUN\\:. ^ITS DEFAULT
VALUE IS 50 (DECIMAL). ^IF THE SCRATCH FILE IS USED, ^^TWICE\\ MAY BE
RUN UNDER ANY ^^PPN\\.
.BLANK 1
^IF THE ANSWER TO THE QUESTION IS NO, THE REGULAR ^^TWICE\\ DIALOGUE PROCEEDS.
.BLANK 1
.INDENT -4
3.##^THE ROUTINE IN ^^TWICE\\ WHICH SATISFIES PRESUMABLY UNUSED GLOBALS
FROM THE MONITOR ROUTINES HAS BEEN CHANGED FROM A ^^POPJ\\ TO A ^^STOPCD\\,
SO THAT IF IT IS IN FACT BEING CALLED, THAT WILL BE DISCOVERED.
.BLANK 3
.INDENT -9
3.0##^^KNOWN BUGS AND DEFICIENCIES\\
.BLANK 1
.INDENT -9
^NONE.
.PG
.INDENT -9
4.0##^^INSTALLATION INSTRUCTIONS\\
.BLANK 1
.INDENT -4
1.##^^TWICE\\ VERSION 3(17) MUST BE ASSEMBLED WITH ^^HDWCNF.MAC\\, THE
SAME ^^HDWCNF.MAC\\ THAT IS ASSEMBLED WITH THE ^^COMMOD\\ TO BE LOADED
WITH ^^TWICE\\.
.BLANK 1
.INDENT -4
2.##^^TWICE\\ MUST BE ASSEMBLED WITH 5.06 VERSIONS OF ^^F.MAC\\ AND ^^S.MAC\\
(AND ^^HDWCNF.MAC\\), AND MUST BE LOADED WITH .^^REL\\ FILES FROM 5.06
MONITOR SOURCES.
.BLANK 1
.INDENT -4
3.##^MONITOR ROUTINES ^^ONCMOD, REFSTR, FILIO, FILUUO, FILFND\\ ARE
DECLARED ^^EXTERN \\ IN ^^TWICE\\, SO THEY MAY BE LOADED FROM ^^TOPS10.REL\\  IN LIBRARY SEARCH MODE. ^^COMMOD\\ IS NOT DECLARED
^^EXTERN\\ SINCE IT IS NOT IN ^^TOPS10.REL\\ ANYWAY.
.BLANK 3
.INDENT -9
5.0##^^INTERNAL CHANGES\\
.BLANK 1
.INDENT -4
1.##^^TWICE\\ NOW HANDLES OFF-LINE OR NON-EXISTING UNITS PROPERLY BY
PASSING THE PROPER BITS TO ^^ONCMOD\\ IN THE ^^USRCPY\\ ROUTINE.
.BLANK 1
.INDENT -4
2.##^^STOPCD\\S HAVE BEEN EDITED TO CONFORM TO THE 5.06 STANDARD FOR
^^STOPCD\\S.
.B 3.LM0
[^END OF ^^TWE003.DOC\\]
.BR