Trailing-Edge
-
PDP-10 Archives
-
BB-4148D-BM_1980
-
dbms-v5a/documentation/dbms5a.doc
There are 2 other files named dbms5a.doc in the archive. Click here to see a list.
DBMS5A.DOC -- Changes from V5 to V5A
August 1979
Copyright (C) 1976,1977,1978,1979
Digital Equipment Corporation, Maynard, Mass.
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.
The information in this software is subject to change without notice
and should not be construed as a commitment by Digital Equipment
Corporation.
DEC assumes no responsibility for the use or reliability of its
software on equipment which is not supplied by DEC.
DBMS5A.DOC Page 2
DBMS5A.DOC -- Changes from V5 to V5A
August 1979
1.0 SUMMARY
DBMS-V5A(422) replaces DBMS-V5(240).
DBMS-V5A can co-exist with, and has been tested with, version 6.03A of
TOPS-10, version 3A of TOPS-20, version 12 and 12A of COBOL/LIBOL, and
version 5A of FOROTS.
V5A 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 V5A.
Note: Journal files created by V5A can not be processed by DBMEND V5.
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 V12A of both
COBOL-68 and COBOL-74. Section 2 details additional changes made to
V5 in order to create V5A.
DBMS5A.DOC Page 3
2.0 EXTERNAL CHANGES
SUMMARY - FUNCTIONAL DEFINITION of DBMS-V5A
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 V5A. DBMS5.DOC
details the changes made to create DBMS V5 and contains significant
user documentation.
The primary enhancements to DBMS-V5 are the following:
1. Incorporation of all edits published in the DBMS DISPATCH
through the MAY/JUNE 1979 issue
2. The ability to build DBMS with V12A of both COBOL-68 and
COBOL-74
3. Support for database (.DBS) files greater than 256K blocks
(DBMS-10)
4. Support for journals (.JRN) greater than 256K blocks
(DBMS-10)
5. The SCHEMA switch /CREATE now deletes but does not expunge
.DBS files (DBMS-20)
6. COBOL programs can now do direct comparisons on the "name"
special registers (i.e., ERROR-SET, ERROR-RECORD, etc.)
3.0 KNOWN BUGS AND DEFICIENCIES
1. A DBMS applications program cannot be restarted by the
ctrl-C/START sequence; one can only RUN (GET/START) a DBMS
program.
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.
3. Explicit SFD's are not supported in file specs.
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.
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.
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.
DBMS5A.DOC Page 4
8. An area cannot be simultaneously OPEN twice (ie. by two
sub-schemas of the same schema) in a run-unit.
9. Floating point numbers cannot be dumped by DBINFO on a KA10.
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.
11. DBMS-20 journals are limited in size to 64K pages.
4.0 INSTALLATION INSTRUCTIONS
The components of the DBMS package, are as follows:
SCHEMA
FORDML
COBOL interface
DBCS
DBMEND
DBINFO
DAEMDB
4.1 DBMS-10 Installation
1. To place DBMS-10 on SYS:, follow this procedure:
a. Mount the DBMS-10 distribution tape (marked QH101) on
MTA0:, and type the following commands:
R BACKUP
TAPE MTA0:
REW
INTERCHANGE
DENSITY installation-dependent
RESTORE SYS:*.*=DSKB:[10,6]*.EXE
REW
RESTORE SYS:*.*=DSKB:[10,6]*.HLP
REW
^C
2. To prepare to (re)load DBMS-10 (or parts thereof):
a. Mount the DBMS-10 distribution tape (marked QH101) on
MTA0:, and type the following commands:
R BACKUP
TAPE MTA0:
REW
INTERCHANGE
DBMS5A.DOC Page 5
DENSITY installation-dependent
restore *.*=dskb:[10,6]*.*
rew
^c
4.2 DBMS-20 Installation
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
4.3 Configuring the System Software
1. DBMSn0 is shorthand for DBMS10/DBMS20.
TOPS-10 sites should read it as DBMS10
TOPS-20 sites should read it as DBMS20
2. If COBOL support is desired:
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.
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 DBMSn0.CTL will be submitted.
3. If FORTRAN support is desired:
a. Read FORTRA.MEM in the 1st save set of the FORTRAN
distribution tape. It will explain how to place
DBMS5A.DOC Page 6
FORLIB.REL onto disk.
b. Make sure that your non-DBMS copy of FORLIB.REL is in the
directory from which DBMSn0.CTL will be submitted.
DBMS5A.DOC Page 7
4. Read DBMSn0.CTL.
a. In particular, there are DEFINEs (TOPS-20) and ASSIGNs
(TOPS-10) at the beginning of the CTL file. Alter the
logical assignments therein as necessary for your site.
b. To load just the OTSs, do this submit:
SUB DBMSn0/RES/TIM:15:
To load all the non-OTS components as well, do this
submit instead:
SUB DBMSn0/RES/TIM:30:/TAG:DBALL
c. If execution of DBMSN0.CTL should abort, you should
reperform steps 2b and/or 3b before repeating step 4b.
5. Copy the built host systems to SYS:
LIBOL.REL to SYS:LIBOL.REL
C68OTS.EXE to SYS:LIBO12.EXE
and/or
C74LIB.REL to SYS:C74LIB.REL
C74OTS.EXE to SYS:C74012.EXE
and/or
FORLIB.REL to SYS:FORLIB.REL
FDBOTS.EXE to SYS:FOROTS.EXE
6. Copy *.HLP and *.EXE from the 2nd save set of the DBMS tape
to the appropriate system device.
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):
For TOPS-10:
:SLOG 1/2
:DEF DB=
DB-R DAEMDB
For TOPS-20 (the $ is an altmode):
DEFINE $DB
DB-LOG OPERATOR ANY 77777
DB-DAEMDB
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.
IMPORTANT: for the time being at least, one must pre-assign
magtapes to the DAEMDB job on TOPS-10. To do this, simply do
DBMS5A.DOC Page 8
1 or more MOUNT commands before typing R DAEMDB.
DBMS5A.DOC Page 9
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.
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.
5.0 INTERNAL CHANGES
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 256K.
2. Under TOPS-20 the SCHEMA processor now uses the DELF JSYS to
delete the old .DBS files instead of OPENFing the file with
only OF%WR set. This provides the user with the ability to
UNDELETE an accidentally deleted database.
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.
6.0 SUGGESTIONS
None.
[End of DBMS5A.DOC]