Trailing-Edge
-
PDP-10 Archives
-
BB-4148D-BM
-
dbms-v5a/source/dbms5a.rnd
There are 2 other files named dbms5a.rnd in the archive. Click here to see a list.
.LM 0;.RM70;.F;.J;.SP1;.TS5
.FLAG CAP
\\
^^DBMS5A.DOC\\ -- ^CHANGES FROM ^^V5\\ TO ^^V5A\\
.BR
^AUGUST 1979
.FG30
^COPYRIGHT (^C) 1976,1977,1978,1979
.BR
^DIGITAL ^EQUIPMENT ^CORPORATION, ^MAYNARD, ^MASS.
.B2
^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\\.
.B1
^THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY ^DIGITAL ^EQUIPMENT
^CORPORATION.
.B1
^^DEC\\ ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY ^^DEC\\.
.T ^^DBMS5A.DOC\\
.PG
<DBMS5A.DOC -- ^CHANGES FROM ^V5 TO ^V5^A
.BR
^AUGUST 1979
.B3.LM0
1.0##^^SUMMARY\\
.B1
^^DBMS-V5A(422)\\ REPLACES ^^DBMS-V5(240)\\.
.B1
^^DBMS-V5A\\ CAN CO-EXIST WITH, AND HAS BEEN TESTED WITH, VERSION 6.03^A OF ^^TOPS-10\\, VERSION 3^A OF ^^TOPS-20\\,
VERSION 12 and 12^A OF ^^COBOL/LIBOL\\, AND VERSION 5^A OF ^^FOROTS\\.
.B1
^V5^A IS A COMPATIBLE UPGRADE OF ^V5. ^NO ^SCHEMA OR ^PROGRAM CHANGES ARE REQUIRED AND ^V5 DATABASE (.^^DBS\\) AND JOURNAL (.^^JRN\\) FILES CAN BE PROCESSED BY ^V5^A.
.B1
^NOTE: ^JOURNAL FILES CREATED BY ^V5^A CAN NOT BE PROCESSED BY ^^DBMEND V5\\.
.B1
^THE PRIMARY CHANGE MADE TO ^^DBMS V5\\ TO CREATE ^^DBMS V5A\\ WAS THE
INCORPORATION OF ALL EDITS PUBLISHED IN THE ^^DBMS DISPATCH\\ THROUGH
THE ^^MAY/JUNE 1979\\ ISSUE. ^THE CONTROL FILES AND PROCEDURES FOR BUILDING ^^DBMS\\ HAVE ALSO
BEEN UPDATED TO SUPPORT BUILDING ^^DBMS\\ WITH ^V12^A OF BOTH ^^COBOL-68\\
AND ^^COBOL-74\\. ^SECTION 2 DETAILS ADDITIONAL CHANGES MADE
TO ^V5 IN ORDER TO CREATE ^V5^A.
.PG.B3.LM0
2.0##^^EXTERNAL CHANGES\\
.B1
^^SUMMARY\\ - ^^FUNCTIONAL DEFINITION\\ OF ^^DBMS-V5A\\
.B1
^THIS SECTION COMBINED WITH SECTION 2 OF THE FILE ^^DBMS5.DOC\\ CONSTITUTE
THE FUNCTIONAL DEFINITION OF ^^DBMS V5A\\. ^THIS SECTION DETAILS THE
CHANGES INCORPORATED INTO ^V5 IN ORDER TO CREATE ^V5^A. ^^DBMS5.DOC\\ DETAILS
THE CHANGES MADE TO CREATE ^^DBMS V5\\ AND CONTAINS SIGNIFICANT USER
DOCUMENTATION.
.B1
^THE PRIMARY ENHANCEMENTS TO ^^DBMS-V5\\ ARE THE FOLLOWING:
.B1.LM9.I-4
1.##^INCORPORATION OF ALL EDITS PUBLISHED IN THE ^^DBMS DISPATCH\\ THROUGH THE
^^MAY/JUNE\\ 1979 ISSUE
.B1.I-4
2.##^THE ABILITY TO BUILD ^^DBMS\\ WITH ^V12^A OF BOTH ^^COBOL-68 \A\N\D
COBOL-74\\
.B1.I-4
3.##^SUPPORT FOR DATABASE (^^.DBS\\) FILES GREATER THAN 256^K BLOCKS (^^DBMS-10)\\
.B1.I-4
4.##^SUPPORT FOR JOURNALS (^^.JRN\\) GREATER THAN 256^K BLOCKS (^^DBMS-10\\)
.B1.I-4
5.##^THE ^^SCHEMA\\ SWITCH /^^CREATE\\ NOW DELETES BUT DOES NOT EXPUNGE
^^.DBS\\ FILES (^^DBMS-20\\)
.B1.I-4
6.##^^COBOL\\ PROGRAMS CAN NOW DO DIRECT COMPARISONS ON THE "NAME" SPECIAL REGISTERS
(I.E., ^^ERROR-SET, ERROR-RECORD,\\ ETC.)
.B2.LM0
3.0##^^KNOWN BUGS AND DEFICIENCIES\\
.B1.LM9.I-4
1.##^A ^^DBMS\\ APPLICATIONS PROGRAM CANNOT BE RESTARTED BY THE CTRL-^C/^^START\\ SEQUENCE; ONE CAN ONLY ^^RUN\\ (^^GET/START\\) A ^^DBMS\\ PROGRAM.
.B1.I-4
2.##^IF THE ^^CLOSE\\ STATEMENT SIGNALS AN EXCEPTION,
THE STATE OF THE SYSTEM WILL NOT BE BACKED UP TO WHAT IT WAS BEFORE THE ^^CLOSE\\.
.B1.I-4
3.##^EXPLICIT ^^SFD\\'S ARE NOT SUPPORTED IN FILE SPECS.
.B1.I-4
5.##^THE WORD ^^DBMS\\ IS A RESERVED WORD IN THE ^^COBOL\\ COMPILER,
BUT THIS FACT IS NOT PROPERLY DOCUMENTED NOR PROPERLY FLAGGED AS AN ERROR.
.B1.I-4
6.##^USER SYMBOLS IN AN ^^INVOKE\\ OR ^^ACCESS\\ STATEMENT
CONSTITUTE USER VARIABLES AS FAR AS THE ^^COBOL\\ COMPILER IS CONCERNED. ^THEREFORE THEY MAY NOT BE DECLARED ANYWHERE ELSE IN THE ^^DATA DIVISION\\.
.B1.I-4
7.##^IF EXCEPTION 03 (DATA-NAMES FROM WRONG RECORD) OCCURRED
DURING A ^^GET\\, THE ^^UWA\\ MAY NOT BE LEFT THE SAME AS IT WAS BEFORE THE VERB WAS EXECUTED.
.B1.I-4
8.##^AN AREA CANNOT BE SIMULTANEOUSLY ^^OPEN\\ TWICE (IE. BY TWO SUB-SCHEMAS OF THE SAME SCHEMA) IN A RUN-UNIT.
.B1.I-4
9.##^FLOATING POINT NUMBERS CANNOT BE DUMPED BY ^^DBINFO\\ ON A ^^KA10\\.
.B1.I-4
10.##^^COBOL\\ AND ^^FORTRAN\\ PROGRAM-UNITS BOTH CONTAINING ^^DML\\ STATEMENTS CANNOT BE MIXED IN THE SAME LOAD-UNIT
BECAUSE THE FORM OF THE SPECIAL REGISTERS IS DIFFERENT IN ^^COBOL\\ AND ^^FORTRAN\\.
.B1.I-4
11.##^^DBMS-20\\ JOURNALS ARE LIMITED IN SIZE TO 64^K PAGES.
.B2.LM0
4.0##^^INSTALLATION INSTRUCTIONS\\
.B1
.B1.LM0.F.J
^THE COMPONENTS OF THE ^^DBMS\\ PACKAGE, ARE AS FOLLOWS:
.B1.LM5.NF.NJ
^^SCHEMA
FORDML
COBOL\\ INTERFACE
^^DBCS
DBMEND
DBINFO
DAEMDB\\
.B2
4.1##^^DBMS-10\\ ^INSTALLATION
.B1
.B1.LM9.I-4
1.##^TO PLACE <DBMS-10 ON <SYS:, FOLLOW THIS PROCEDURE:
.B1.LM13.I-4
A.##^MOUNT THE <DBMS-10 DISTRIBUTION TAPE (MARKED <QH101) ON <MTA0:, AND TYPE THE FOLLOWING COMMANDS:
.B1.NF.NJ
^^R BACKUP
TAPE MTA0:
REW
INTERCHANGE
DENSITY\\ INSTALLATION-DEPENDENT
^^RESTORE SYS:*.*=DSKB:[10,6]*.EXE
REW
RESTORE SYS:*.*=DSKB:[10,6]*.HLP
REW
_^C\\
.B1.LM9.F.J.I-4
2.##^TO PREPARE TO (RE)LOAD <DBMS-10 (OR PARTS THEREOF):
.B1.LM13.I-4
A.##^MOUNT THE <DBMS-10 DISTRIBUTION TAPE (MARKED <QH101) ON <MTA0:, AND TYPE THE FOLLOWING COMMANDS:
.B1.NF.NJ
^^R BACKUP
TAPE MTA0:
REW
INTERCHANGE
DENSITY\\ INSTALLATION-DEPENDENT
RESTORE *.*=DSKB:[10,6]*.*
REW
_^C\\
.B2.LM0.F.J
4.2##^^DBMS-20\\ ^INSTALLATION
.B1.NO FILL.NO JUSTIFY.UC
To install DBMS-20, follow the instructions below:
1. To place DBMS-20 on SYS:, follow this procedure:
a. Mount the DBMS-20 distribution tape (marked QT008) on
MTA0:, and type the following commands:
DUMPER
TAPE MTA0:
REW
DENSITY installation-dependent
SKIP 1
RESTORE *.*.* (TO) SYS:*.*.*
REW
^C
2. To prepare to (re)load DBMS-20 (or parts thereof):
a. Mount the DBMS-20 distribution tape (marked QT008) on
MTA0:, and type the following commands:
DUMPER
TAPE MTA0:
REW
DENSITY installation-dependent
SKIP 2
RESTORE *.*.*
REW
^C
.B2.F.J.LM0.LC
4.3##^CONFIGURING THE ^SYSTEM ^SOFTWARE
.B1.LM9.I-4
1.##<DBMS<N0 IS SHORTHAND FOR <DBMS10/DBMS20.
.B1
<TOPS-10 SITES SHOULD READ IT AS <DBMS10
.BR
<TOPS-20 SITES SHOULD READ IT AS <DBMS20
.B1.I-4
2.##^IF ^^COBOL\\ SUPPORT IS DESIRED:
.B1.LM13.I-4
A.##^READ ^^COBOL.INS\\ IN THE FIRST SAVE SET OF THE ^^COBOL\\ DISTRIBUTION
TAPE. ^IT WILL EXPLAIN HOW TO PLACE ^^LIBOL.REL\\ AND ^^LIBSHR.REL\\
AND/OR ^^C74LIB.REL\\ AND ^^C74SHR.REL\\ ONTO DISK.
.B1.I-4
B.##^MAKE SURE THAT YOUR NON-^^DBMS\\ COPY OF ^^LIBOL.REL\\ AND ^^LIBSHR.REL\\
AND/OR ^^C74LIB.REL\\ AND ^^C74SHR.REL\\ ARE IN THE DIRECTORY
FROM WHICH ^^DBMS\N0.CTL\\ WILL BE SUBMITTED.
.B1.LM9.I-4
3.##^IF ^^FORTRAN\\ SUPPORT IS DESIRED:
.B1.LM13.I-4
A.##^READ ^^FORTRA.MEM\\ IN THE 1ST SAVE SET OF THE ^^FORTRAN\\
DISTRIBUTION TAPE. ^IT WILL EXPLAIN HOW TO
PLACE ^^FORLIB.REL\\ ONTO DISK.
.B1.I-4
B.##^MAKE SURE THAT YOUR NON-^^DBMS\\ COPY OF ^^FORLIB.REL\\ IS IN THE
DIRECTORY FROM WHICH ^^DBMS\N0.CTL\\ WILL BE SUBMITTED.
.PG.B1.LM9.I-4
4.##^READ ^^DBMS\N0.CTL\\.
.B1.LM13.I-4
A.##^IN PARTICULAR, THERE ARE ^^DEFINE\\S (^^TOPS-20\\) AND ^^ASSIGN\\S (^^TOPS-10\\) AT THE BEGINNING OF THE ^^CTL\\ FILE.
^ALTER THE LOGICAL ASSIGNMENTS THEREIN AS NECESSARY FOR YOUR SITE.
.B1.I-4
B.##^TO LOAD JUST THE ^^OTS\\S, DO THIS SUBMIT:
.B1.I5
^^SUB DBMS\N0/RES/TIM:15:\\
.B1
^TO LOAD ALL THE NON-^^OTS\\ COMPONENTS AS WELL, DO THIS SUBMIT INSTEAD:
.B1.I5
^^SUB DBMS\N0/RES/TIM:30:/TAG:DBALL\\
.B1.I-4
C.##^IF EXECUTION OF ^^DBMSN\0.CTL\\ SHOULD ABORT, YOU SHOULD
REPERFORM STEPS 2B AND/OR 3B BEFORE REPEATING STEP 4B.
.B1.LM9.I-4
5.##^COPY THE BUILT HOST SYSTEMS TO ^^SYS:\\
.B1.LM13.NF.NJ
^^LIBOL.REL\\ TO ^^SYS:LIBOL.REL\\
^^C68OTS.EXE\\ TO ^^SYS:LIBO12.EXE\\
.I5
AND/OR
^^C74LIB.REL\\ TO ^^SYS:C74LIB.REL\\
^^C74OTS.EXE\\ TO ^^SYS:C74012.EXE\\
.I5
AND/OR
^^FORLIB.REL\\ TO ^^SYS:FORLIB.REL\\
^^FDBOTS.EXE\\ TO ^^SYS:FOROTS.EXE\\
.B1.LM9.F.J.I-4
6.##^COPY *.^^HLP\\ AND *.^^EXE\\ FROM THE 2ND SAVE SET
OF THE ^^DBMS\\ TAPE TO THE APPROPRIATE SYSTEM DEVICE.
.B1.I-4
7.##^IF SUPPORT OF ^^MTA\\ JOURNALING IS DESIRED AND YOU WISH TO RUN ^^DAEMDB\\ UNDER ^^OPSER/PTYCON\\, INSERT AT LEAST THESE COMMANDS
INTO YOUR SYSTEM-RESTART AUTO FILE (SEE 2.3.2.3.5 FOR HOW TO SETUP NON-DEFALT VALUES FOR ^^DAEMDB\\'S CONTROLLING PARAMETERS):
.B1
^FOR ^^TOPS-10\\:
.B1.I5
^^:SLOG 1/2
.I5
:DEF DB=
.I5
DB-R DAEMDB\\
.B1
^FOR ^^TOPS-20\\ (THE $ IS AN ALTMODE):
.B1.I5
^^DEFINE $DB
.I5
DB-LOG OPERATOR ANY 77777
.I5
DB-DAEMDB\\
.B1.LM9.F.J
^IF YOU WISH TO RUN ^^DAEMDB\\ AS AN ORDINARY TIME-SHARING JOB, SIMPLY LOGIN A JOB AND TYPE ^^R DAEMDB\\ EACH TIME YOUR SYSTEM STARTS UP.
.B1
^^IMPORTANT\\: FOR THE TIME BEING AT LEAST, ONE MUST PRE-ASSIGN MAGTAPES
TO THE ^^DAEMDB\\ JOB ON ^^TOPS-10\\. ^TO DO THIS, SIMPLY DO 1 OR MORE ^^MOUNT\\ COMMANDS BEFORE TYPING ^^R DAEMDB\\.
.PG.B1.I-4
8.##^^DBMS-V5\\ UTILIZES THE ^^ENQ/DEQ\\ FACILITY.
^CONSEQUENTLY YOU SHOULD ENSURE THAT YOUR SYSTEM IS CONFIGURED SUCH THAT
SUFFICIENT MONITOR FREE SPACE
IS AVAILABLE TO YOUR ^^DBMS\\ USERS, AND THAT EACH ^^DBMS\\ USER HAS
GLOBAL-^^ENQ\\ CAPABILITIES AND AN ADEQUATE ^^ENQ\\ QUOTA.
^FOR ^^TOPS-10\\ USE ^^REACT\\ TO SET QUOTAS AND CAPABILITIES
(^^ENQ\\ CAPABILITY IS BIT 11 (IE. 100,,0) OF THE CAPABILITIES WORD).
^FOR ^^TOPS-20\\, USE _^^ECREATE TO SET ^^ENQ\\ CAPABILITY.
^ALSO, SEE ^^ENQ/DEQ\\ IN THE MONITOR
INSTALLATION GUIDE. ^AS REGARDS QUANTIFYING YOUR NEEDS, THEY ARE APPROXIMATELY: 2 LOCKS FOR EACH OPEN AREA PLUS 2 LOCKS PER RUN-UNIT.
.B1.I-4
9.##^IF MAGTAPE JOURNALING IS DESIRED, THE COMMENTS REGARDING ^^ENQ/DEQ\\ APPLY TO ^^IPCF\\ AS WELL. ^AS REGARDS QUANTIFYING YOUR NEEDS,
THEY ARE APPROXIMATELY 1 SEND AND 1 RECEIVE FOR EACH APPLICATION RUN-UNIT;
AND (N) SENDS AND RECEIVES FOR ^^DAEMDB\\, WHERE (N) IS THE NUMBER OF SIMULTANEOUS MAGTAPE JOURNALERS.
.B3.LM0.F.J
5.0##^^INTERNAL CHANGES\\
.B1
.LM9.I-4
1.##^UNDER ^^TOPS-10 DBMS\\ NOW USES THE ^^FILOP. UUO .FOUSO\\ AND ^^.FOUSI\\
FUNCTIONS TO PERFORM FILE POSITIONING. ^THIS PERMITS ^^DBMS-10\\ TO CREATE
AND ACCESS DATABASE (^^.DBS\\) AND JOURNAL (^^.JRN\\) FILES GREATER THAN
256^K.
.B1.I-4
2.##^UNDER ^^TOPS-20\\ THE ^^SCHEMA\\ PROCESSOR NOW USES THE ^^DELF JSYS\\
TO DELETE THE OLD ^^.DBS\\ FILES INSTEAD OF ^O^P^E^N^FING THE FILE WITH
ONLY ^^OF%WR\\ SET. ^THIS PROVIDES THE USER WITH THE ABILITY TO ^^UNDELETE\\
AN ACCIDENTALLY DELETED DATABASE.
.B1.LM0
^A COMPLETE
DESCRIPTION OF ALL BUGS FIXED IN ^^V5A\\ CAN BE FOUND BY EXAMINING ALL ISSUES OF
THE ^^DBMS DISPATCH\\ FROM ^^MAY/JUNE 1977\\ THROUGH THE ^^MAY/JUNE 1979\\ ISSUE.
.B1
6.0##^^SUGGESTIONS\\
.B1
^NONE.
.B3
[^END OF ^^DBMS5A.DOC\\]