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]