Trailing-Edge
-
PDP-10 Archives
-
BB-H580E-SB_1985
-
cbl12c.ins
There are 2 other files named cbl12c.ins in the archive. Click here to see a list.
CBL12C.INS -- Installation Guide for COBOL-74 V12C on TOPS-10
COPYRIGHT (C) 1985 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND 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. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY
TRANSFERRED.
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 2
CONTENTS
--------
CHAPTER 1 INTRODUCTION
CHAPTER 2 CONTENTS OF DISTRIBUTION TAPE
CHAPTER 3 SYSTEM INSTALLATION
CHAPTER 4 SYSTEM REBUILDING
4.1 Required System Software
4.2 Standard Configuration
4.3 Non-Standard Configurations
4.3.1 DBMS-10
4.3.2 SORT
4.3.3 User OTS Routines
4.3.4 MCS-10
4.3.5 Single Segment Compiler
4.3.6 Shareable RMS and OTS
CHAPTER 5 COBOL-68 TO COBOL-74 CONVERSION UTILITY
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 3
1.0 INTRODUCTION
This document describes procedures for building and installation of
all supported COBOL-74 system configurations. It assumes that the
installation is licensed for COBOL-74 and SORT.
The distributed compilers are prepared to support DBMS-10 and MCS-10,
however, they run perfectly well without it. The only difference is
that the DBMS-10 and MCS-10 reserved words are always active under the
version 12C standard configuration. This was done to simplify adding
of DBMS-10 and MCS-10 to user systems, and to simplify and increase
the reliability of packaging and installation procedures. Most
configurations can be generated simply by reloading portions of the
system. System installation of the distributed configuration can be
accomplished by simply copying a set of files according to the
instructions in Section 3.
Note, additional work must be done to the OTS to support DBMS-10 and
MCS-10 This is described in the appropriate set of procedures starting
with section 4.3.
In order to obtain a configuration other than that distributed, all or
part of the COBOL-74 system must be rebuilt before installation
according to the appropriate set of procedures in Section 4.
Please read this guide fully before attempting to rebuild the COBOL-74
system. Rebuilding should not be necessary unless you want to change
the feature test switch settings or have local patches to install.
If you wish to rebuild all or part of COBOL then the supplied CTL
files can be used without modification provided that certain rules are
obeyed. See Section 4.0 for more details.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 4
2.0 CONTENTS OF THE DISTRIBUTION TAPE
This distribution tape is written in BACKUP INTERCHANGE format at 1600
and contains the complete COBOL-74 system. There are eight save sets.
If any save sets are empty then you are not licensed to receive their
contents.
The save sets are:
1. DOCUMENTATION
2. BINARY
3. COBOL-SOURCE
4. SORT-SOURCE
5. COBOL-BUILD
6. SORT-BUILD
7. CONVERSION
8. TEST
The DOCUMENTATION save set contains the following files:
CBL12C.INS -- this file
COBOL.BD -- directory of BINARY save set
COBOL.SD -- directory of COBOL-SOURCE save set
SORT.SD -- directory of SORT-SOURCE save set
SORT.BD -- directory of BINARY save set
COBOL.RD -- directory of COBOL-BUILD save set
SORT.RD -- directory of SORT-BUILD save set
68274.DIR -- directory of the CONVERSION-UTILITY save set
COBOL.UTD -- directory of the UETP-DIRECTORY save set
CBL12C.BWR -- the Beware file for COBOL-74 12C
CBL12C.DOC -- the Doc file for COBOL-74 12C
SRT4D.BWR -- the Beware file for SORT 4D
SRT4D.DOC -- the Doc file for SORT 4D
NEW-ISAM.MEM -- the Doc file for ISAM
*.HLP -- the Help files for COBOL and SORT etc.
68274.MEM -- the Doc file for the conversion utility
KEYRMS.CBL -- the RMS example shown in the appendix I
The COBOL-SOURCE save set contains all the source files required to
build COBOL-74. There is no need to load these files onto the disk
unless you want to rebuild the COBOL-74 system. The building of the
complete COBOL system requires about 10,000 blocks of free disk space
and about 1 hour of CPU time on a KL-10.
The SORT-SOURCE save set contains all the source files required to
build the stand alone SORT and the COBOL SORT.
The COBOL-BUILD save sets contain the REL, UNV files, etc. from the
final build. These files can be used to rebuild the corresponding
compiler if only minor changes have been made (i.e. bug fixes) rather
than a feature test switch change.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 5
Similarly the SORT-BUILD save set contains the REL, UNV files etc.
from the final SORT build.
The CONVERSION save set contains the REL, UNV, files, etc. from the
build of the conversion utility (68274). The files can be used to
rebuild the utility when bug fixes have been installed.
The TEST save set contains all files which may be used to test COBOL.
These may be copied to UTP:.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 6
The following is a general description of the COBOL-74 system
components and the classes of files on the distribution tape. For a
specific list of the files associated with a given system component
please refer to the control file for that component.
The components of the COBOL system are:
CBL74 the COBOL compiler
C74LIB the COBOL object time system
COBDDT the debugger
68274 the COBOL-68 to COBOL-74 conversion utility
RERUN the recovery system
ISAM ISAM utility program
LIBARY source library maintenance program
SORT Sort package
DBMS-10*(1) Data Base Management System
MCS-10*(1)
In addition there is one unsupported component:
CPYLIB the native mode LIBARY utility
GPMSM utility to merge two or more high segments
---------------
*(1) DBMS-10 and MCS-10 system components are not included in this
distribution area, excepting some small support portions contained
within other of the system components. In order to build and install
a system supporting one or more of these unbundled products please
refer to section 4 of this document in conjunction with the
installation instructions included with the individual unbundled
component distributions.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 7
The following files or sets of files are included in the distribution:
CBL12C.DOC Each component has a documentation section in this
file.
CBL12C.INS This installation guide.
*.HLP Each component has a help text file for use by the
system HELP command.
*.CTL Each component has a control file which may be run to
rebuild the given component. Refer to section 4 of
this document for general system rebuilding
instructions and submission instructions.
*.EXE The set of shareable files that compose the distributed
ready to install system.
*.MAP LINK load maps for each component.
*.MAC MACRO source files.
*.REL Relocatable binary files.
*.UNV Universal files.
COBOL.TEC File containing installation specific logical names.
This file is read by the COBOL CTL files.
*.CMD LINK indirect loading command files for the components.
*.MEM Other files containing useful information.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 8
3.0 INSTALLATION OF THE COBOL SYSTEM
This section details the procedure for installing the COBOL-74 system.
This procedure applies to the installation of systems rebuilt to
support one or more of the unbundled system components as well as
installation of the distributed form.
If it is not necessary to support DBMS-10 and MCS-10 or any of the
special configurations described in section 4 only the files mentioned
in the remainder of this section need to be obtained from the
distribution tape. If one or more of the unbundled components or
special configurations is to be supported please refer to section 4 of
this document for details of required files and procedures for
restructuring the system before installation. Instructions for the
installation of the unbundled components themselves are included with
the unbundled distribution packages.
First restore the DOCUMENTATION save set to DSK:
Then read the DOC and BWR files.
To do this use the following procedure:
A. Mount the COBOL distribution tape on MTA0:
B. Type the following commands:
R BACKUP
TAPE MTA0:
INTERCHANGE
DENSITY 1600
RESTORE *.*
REWIND
EXIT
To install COBOL and SORT use the following procedure:
A. Mount the COBOL distribution tape on MTA0:
B. Type the following commands:
R BACKUP
TAPE MTA0:
INTERCHANGE
DENSITY 1600
SKIP 1
RESTORE *.EXE, C74LIB.REL, COBDDT.REL
REWIND
EXIT
The entire installation can then be accomplished with three COPY
commands of the general form:
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 9
In order to do the following copies one must be logged into [1,2]
.COPY SYS: = *.EXE, COBDDT.REL, C74LIB.REL
.COPY DOC: = *.DOC
.COPY HLP: = *.HLP
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 10
4.0 SYSTEM REBUILDING
This section details how to rebuild all or part of the COBOL-74 system
in order to support DBMS-10 and MCS-10, to change feature test switch
setting, or for maintenance purposes.
To simplify the building task BLDCBL.CTL reads the COBOL.TEC file
which contains definitions of all the logical names used. If this
file exists BLDCBL uses it to modify all the CTL files to produce CTM
files which it then submits. This allows the installation to use
private packs and different disk areas for the build. It is
recommended that the same logical names be used and that the user
should edit COBOL.TEC to contain appropriate definitions. Similarly
BLDSRT.CTL reads SORT.TEC if it exists to produce SORT.CTM from
SORT.CTL. Once the CTM files have been produced they can be submitted
for all future rebuilds providing, of course, that the logical names
do not change. It is recommended that installations modify the TEC
files rather than the CTL files since Digital will most likely modify
the CTL files with each release.
The logical names used by the CTL files are: SYS:, REL:, UNV:
Digital must use field-image software to build a release tape, thus
the supplied TEC files use the device DEC:. In general installations
do not have this device, thus SYS: should not be redefined. If you
have devices REL: and UNV: they also do not need to be redefined,
otherwise they must be ASSIGNED to SYS:
COBOL-74 version 12C supports the following user installation settable
feature assembly switches: DEBUG, DBMS, DBMS4 (DBMS version 4
features) and DBMS6 (DBMS version 6 features) MCS, BIS, and ONESEG
(single segment compiler). Other assembly switches are supported only
in their distributed position. The default setting for the DBMS,
DBMS4 DBMS6, MCS, and BIS switches is ON (1), and for DEBUG the
default setting is OFF (0). This represents the standard default
configuration.
The supported switches may be turned on or off by setting their
symbols equal to 1 or 0 in the universal file COBASM and rebuilding
portions of the system according to the instructions in the following
sections. COBASM is the assembly switch definition file for all
system components. A symbol equal to 1 means the switch is on, a
symbol equal to 0 means the switch is off.
Rebuilding requires that all of the distributed files be copied to the
appropriate disk areas. If a total rebuild is to be done then the
appropriate build area can be cleaned up by deleting all LOG, REL,
MAP, UNV, etc. files leaving only the control files.
Included on the tape is a sample COBOL.MIC. If your system uses mic,
then this file can be modified for your build. However, if your
system does not have MIC then this file needs to be deleted.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 11
4.1 Required System Software
In order to rebuild all or part of the COBOL system the following
standard system software is required, of the specified or a later
version.
Software Version
-------- -------
MACRO 53A(1173)
LINK 4A(1220)
MAKLIB 2A(67)
CREF 53(53)
UUOSYM.UNV 15(521)
COBOL-74 Version 12C will run under all monitors 7.02 or later as will
programs compiled with COBOL version 12C.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 12
4.2 Standard Configuration
The standard distributed multi-segment compiler contains support for
all DBMS-10 and MCS-10 syntax. This means that all of the reserved
words for DBMS-10 and MCS-10 are present in the standard configuration
of COBOL-74 Version 12C. This eliminates the necessity for rebuilding
the COBOL compiler to get support for this unbundled component.
The standard distributed configuration also contains an object time
system and a series of utility routines. The standard distributed
configuration of the object time system includes full support for SORT
so there is no need to run the SORT CTL file unless there are bug
fixes to apply to SORT. The standard distributed configuration of the
object time system does not include support for DBMS-10 or MCS-10.
However rebuilding of the entire object time system is not required,
all that is required is to submit the additional control file as
specified in sections 4.3 and later..
In general it is not necessary to rebuild the entire COBOL system in
order to configure systems supporting unbundled components or to make
patches to the existing system. The instructions for each component
specify any dependencies upon the state of other system components in
order that no more of the system need be rebuilt than necessary. The
only general restriction is that none of the component building
control files may be executed concurrently and that the compiler and
OTS must be built first or the .UNV files from a previous build must
be available for the other components. The following is a list of
each component of the standard configuration. The list is in the
order in which the control files for each component should be
submitted if all components are being built. The list shows the
actual SUBMIT command which should be used for each control file, and
as long as the user is aware of the dependencies described, the order
of submitting them is not critical. If you should wish to build the
whole system, just submit the file BLDCBL.CTL in COBOL-BUILD which
will then submit all the other .CTL/.CTM files in the correct order
with dependency counts. The .CTM files are only created if the
COBOL.MIC file has been deleted.
Note that there is a "chicken and egg" problem with trying to build
from scratch a COBOL OTS containing either or both SORT and DBMS. The
problem is that the LIBOL CTL file could build a complete OTS in one
step if only the SORT and/or DBMS CTL files had already been run.
However these control files require that LIBOL be run first. The
correct procedure is to first run LIBOL as part of the general rebuild
(use BLDCBL). Then run SORT followed by DBMS. Once the initial build
has taken place only the control file for the piece that has changed
need be rerun providing, of course, that nothing in the build areas is
deleted. Thus if a bug is fixed in COBOL SORT there is no need to
rerun the LIBOL control file, just run the SORT one. Currently only
the LIBOL and SORT CTL files have been fixed to do this. The DBMS CTL
files have not yet been fixed, they still require a version of
C74LIB.REL not yet containing DBMS files.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 13
Please be sure that you have at least 20,000 blocks free to begin this
procedure
To build the COBOL-74 compiler:
A. Mount the COBOL distribution tape on logical MTA0:
B. Type the following commands:
LOGIN to the COBOL-source area
REWIND MTA0:
R BACKUP
TAPE MTA0:
DENSITY 1600
INTERCHANGE
SKIP 3
RESTORE *.*
REWIND
EXIT
LOGIN to the COBOL-BUILD area
REWIND MTA0:
R BACKUP
TAPE MTA0:
DENSITY 1600
INTERCHANGE
SKIP 4
RESTORE *.*
REWIND
EXIT
LOGIN to the SORT-build area
REWIND MTA0:
R BACKUP
TAPE MTA0:
DENSITY 1600
INTERCHANGE
SKIP 5
RESTORE *.*
REWIND
EXIT
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 14
C. LOGIN to COBOL-BUILD. Modify COBOL.TEC,
DELETE *.LOG, then SUBMIT the required files.
a. The whole system
SUBMIT BLDCBL.CTL
Note, in general the various CTL files will not run unless
modified. BLDCBL does this when it is submitted, it reads the
CTL files and produces CTM files which it then SUBMITS.
b. COMPILER
SUBMIT COBOL.CTM/TIME:1:00:00/RESTART:YES
Dependencies: None
c. OTS
SUBMIT LIBOL.CTM/TIME:1:00:00/RESTART:YES
Dependencies: None
d. COBDDT
SUBMIT COBDDT.CTM
Dependencies: INTERM.UNV and COMUNI.UNV
e. ISAM
SUBMIT ISAM.CTM
f. LIBARY
SUBMIT LIBARY.CTM
Dependencies: None
g. RERUN
SUBMIT RERUN.CTM
Dependencies: COMUNI.UNV, FTDEFS.UNV and LBLPRM.UNV
h. CPYLIB
SUBMIT CPYLIB.CTM
Dependencies: None
NOTE, there will be no SORT in the OTS built by this procedure unless
the file SRTCBL.REL is in the SORT-BUILD area (this file is produced
by SORT.CTL).
See sec. 4.3.2 for instructions for installing SORT into the OTS.
Also, there will be no DBMS support in the OTS built by this procedure
unless the file DBSCOB.REL is in the DBMS-BUILD area (this file is
produced by DBMS.CTL). See sec. 4.3.1 for instructions for
installing DBMS into the OTS.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 15
4.3 Non-Standard Configurations
The following sections specify what rebuilding of the system is
required in order to produce specialized configurations. The
instructions are divided by feature but they are easily combinable to
provide more than one of the capabilities. Refer to the preceding
section for specifics when instructed to rebuild some system
component.
4.3.1 DBMS-10 -
4.3.1.1 Completing Support For DBMS-10 -
If you have a standard configuration Version 12C COBOL-74 compiler
(i.e. the one on the distribution tape), all that is needed to
complete support for DBMS-10 is to follow these instructions:
1. Include a copy of C74LIB.REL and C74SHR.REL in the same disk
area as the contents of the DBMS-10 distribution tape.
2. Refer to DBMS10.DOC for DBMS-10 installation instructions.
3. If you already have built DBMS and are just changing SORT or
LIBOL then it is just sufficient to run the appropriate SORT
or LIBOL CTL file.
4.3.1.2 Removing Support For DBMS-10 -
The standard configuration of the COBOL-74 compiler comes complete
with support for DBMS-10 , however, the object time systems will not
have DBMS-10 support. This makes it much easier to install DBMS-10
later. However, it does increase the size of the compilers slightly
and increases the number of reserved words. If you do not want any
DBMS-10 support in the compilers, it is possible to rebuild the
compilers turning off the DBMS, DBMS4, and DBMS6 switches. This can
be accomplished in the following manner:
a. Copy the contents of the COBOL distribution tape into
appropriate disk areas.
b. Modify the universal file "COBASM.MAC" to include the symbol
definition "DBMS==0".
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 16
c. Rebuild the COBOL compiler.
If you later wish to reinstitute support for DBMS-10 in the compiler,
follow steps a and c, making sure that the symbol "DBMS" does not
appear in the universal file "COBASM.MAC".
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 17
4.3.2 SORT -
a. If COBOL-74 and SORT are all being rebuilt because of major
changes in the configuration, then the correct procedure is
to first submit BLDCTL.CTL and then SORT.CTL.
BLDCTL.CTL creates the file required by SORT.CTL to add the
SORT to C74OTS.
On the other hand if a COBOL-74 OTS exists and only SORT has
been modified then it is sufficient to run only SORT.CTL.
Similarly if SORT exists (i.e. SRTCBL.REL) and COBOL-74 OTS
has been modified it is sufficient to run only LIBOL.CTL for
the OTS.
b. SUBMIT SORT.CTL/TIME:0:30:00/RESTART:YES
which will replace the existing SORT module in the OTS
(either the original dummy one or an existing real one) with
a newer real SORT. It will generate modified versions of
C74LIB.REL and C74O12.EXE. It will try to rename these
modified files back to the area from which it got them (note
both the file and UFD protection must be set to allow this).
If, for any reason, this should fail they will be left in the
SORT-BUILD area. It will also build SORT.EXE which is the
stand alone configuration.
c. Install the new SORT
COPY SYS: = SORT.EXE
COPY DOC: = SORT.DOC
COPY HLP: = SORT.HLP
4.3.3 USER OTS ROUTINES -
COBOL-74 includes a facility allowing installations to add their own
special purpose MACRO routines to C74LIB.REL. This is accomplished
via a dispatch routine, loaded with the user program which resolves
the external references into references to a user dispatch table in
the OTS. For routines requiring low segment storage there is a user
dynamic (indexed) low segment facility. Refer to USRDSP.MAC for
complete instructions.
The user routines are added to C74LIB.REL after all other OTS
rebuilding but before installation on SYS:.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 18
4.3.3.1 MCS -
4.3.3.2 Completing Support For MCS-10 -
If you have the standard configuration compiler (i.e. the one on the
distribution tape), it is not necessary to rebuild any system
component, simply refer to the MCS-10 distribution package for MCS-10
building and installation procedures.
4.3.3.3 Removing Support For MCS-10 -
The standard configuration of the compiler comes complete with support
for MCS-10. This makes it much easier to install MCS-10 later,
however, it does increase the size of the compilers slightly and
increases the number of reserved words. If you do not want any MCS-10
support in the compiler, it is possible to rebuild the compiler
turning off the MCS switch. This can be accomplished in the following
manner:
a. Copy the contents of the COBOL distribution tape into
appropriate disk areas.
b. Modify the universal file "COBASM.MAC" to include the symbol
definition MCS==0.
c. Rebuild the COBOL-74 compiler.
If you later wish to reinstitute support for MCS-10 in the compiler,
follow steps a and c, making sure that the symbol MCS does not appear
in the universal file "COBASM.MAC".
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 19
4.3.4 Single Segment Compiler -
It is possible to build a single segment compiler. The compiler will
require 110K to compile a minimal COBOL program.
a. Modify COBASM.MAC to include the symbol definition
"ONESEG==1".
b. Rebuild the COBOL compiler.
c. This will produce a single segment compiler CBL74.EXE which
can be copied to SYS: instead of the multi-segment compiler.
d. The remainder of the system is installed in the normal
fashion.
4.3.5 Shareable RMS And OTS -
The normal method of using RMS is to have a shareable OTS and to merge
in RMSCOB at run time. This results in each job that uses RMS in
having a non-shareable copy of RMSCOB. If the majority of users at
any site use RMS this can result in a considerable waste of memory.
It is possible to build a high segment that contains both the OTS and
RMSCOB, however then all users of COBOL-74 will get a larger OTS.
To do this use the program GPMSM which is on the DOCUMENTATION save
set.
.R GPMSM
GPMSM>MERGE SYS:C74O12
GPMSM>MERGE SYS:RMSCOB
GPMSM>EXIT
.SSAVE C74O12
Then use this version of C74O12 in place of the original one.
COBOL-74 FOR V12C ON TOPS-10: INSTALLATION GUIDE Page 20
5.0 COBOL-68 TO COBOL-74 CONVERSION UTILITY
The COBOL-68 to COBOL-74 conversion utility, 68274, is just another
version of the COBOL compiler. See 68274.MEM for more details. A
working version of the utility is in the BINARY save set. This
version is re-built just like any other non-standard version (see
section 4.3). Specifically:
a. Copy the contents of the COBOL distribution tape into
appropriate disk areas.
b. Modify the universal file "COBASM.MAC" to include the symbol
definitions ANS68==1 and FT68274==1.
c. Submit COBOL.CTL to rebuild the conversion utility.
There is a HELP file and a MEM file in the DOCUMENTATION save set.
[END of CBL12C.RNI]