Trailing-Edge
-
PDP-10 Archives
-
ap-c800d-sb
-
cobol.rni
There are no other files named cobol.rni in the archive.
.VARIABLE TWENTY 2 1
\\
.LM 0;.RM 70;.F;.J;.SP 1;.PS 58,70;.LC;.FLAG CAP
.TITLE ^^COBOL-68/74 V12A INSTALLATION GUIDE\\
<COBOL.INS -- ^INSTALLATION ^GUIDE FOR <COBOL-68/74 <V12A
.BR
.FG30
^^COPYRIGHT (C) 1979 BY
.BR
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
.B2
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.
.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
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL\\.
.PG;.LM 20;.TS 10,20;.F;.J;.FG 10
<CONTENTS
.BR
--------
.B 1;.NJ;.NF;.I -20
^^CHAPTER 1 INTRODUCTION
.B 1;.I -20
CHAPTER 2 CONTENTS OF DISTRIBUTION TAPE
.B 1;.I -20
CHAPTER 3 SYSTEM INSTALLATION
.B 1;.I -20
CHAPTER 4 SYSTEM REBUILDING\\
.I -10
4.1 ^REQUIRED ^SYSTEM ^SOFTWARE
.I -10
4.2 ^STANDARD ^CONFIGURATION
.I -10
4.3 ^NON-^STANDARD ^CONFIGURATIONS
.I -10
4.3.1 <DBMS
.I -10
4.3.2 <SORT
.I -10
4.3.3 ^USER <OTS ^ROUTINES
.IFN TWENTY
.I -10
4.3.4 <MCS
.I -10
4.3.5 <KI-10 ^PROCESSOR
.I -10
4.3.6 ^SINGLE ^SEGMENT ^COMPILER
.ENDIF TWENTY
.BR
.I -10
4.4 <COMPUTE ^STATEMENT
.BR
.I -10
4.5 <I/O ^PERFORMANCE ^METERING (<LSTATS)
.B 1;.I -20
^^CHAPTER 5 COMPATIBILITY OF <COBOL-68 AND <COBOL-74\\
.PG;.LM 0;.RM 70;.F;.J
1.0##<INTRODUCTION
.B 1
^THIS DOCUMENT DESCRIBES PROCEDURES FOR BUILDING AND INSTALLATION OF ALL SUPPORTED <COBOL-68/74 SYSTEM CONFIGURATIONS.
^IT ASSUMES THAT THE INSTALLATION IS LICENSED FOR <COBOL-68, <COBOL-74, AND <SORT. ^IF THIS IS NOT TRUE THEN THE INSTRUCTIONS WILL STILL BE VALID BUT THE CERTAIN SAVE SETS WILL BE EMPTY AND CERTAIN FILES WILL BE MISSING FROM THE FIRST
.IF TWENTY
TWO SAVE SETS.
.ELSE TWENTY
SAVE SET.
.ENDIF TWENTY
^SEE SECTIONS 2 AND 3 FOR MORE DETAILS.
.B 1
^THE DISTRIBUTED COMPILERS ARE PREPARED TO SUPPORT
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10 AND <MCS-10
.ENDIF TWENTY
\, HOWEVER, THEY RUN PERFECTLY WELL WITHOUT
.IF TWENTY
IT.
.ELSE TWENTY
THEM.
.ENDIF TWENTY
^THE ONLY
DIFFERENCE IS THAT THE
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10 AND <MCS-10
.ENDIF TWENTY
\ RESERVED WORDS ARE ALWAYS
ACTIVE UNDER THE VERSION 12^A STANDARD CONFIGURATION. ^THIS WAS DONE TO
SIMPLIFY ADDING OF
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10 AND <MCS-10
.ENDIF TWENTY
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.
.B 1
^IN ORDER TO OBTAIN A CONFIGURATION OTHER THAN THAT DISTRIBUTED, ALL OR PART
OF THE <COBOL-68/74 SYSTEM MUST BE REBUILT BEFORE INSTALLATION ACCORDING TO THE
APPROPRIATE SET OF PROCEDURES IN ^SECTION 4.
.B 1
<NOTE, LOOK CAREFULLY AT THE BEWARE FILES, <CBL12A.BWR AND <SRT4B.BWR AND APPLY ALL NECESSARY PATCHES, ALSO READ <CBL12A.DOC AND <SRT4B.DOC.
.PG
2.0##^^CONTENTS OF THE DISTRIBUTION TAPE\\
.B 1
^THIS DISTRIBUTION TAPE IS WRITTEN IN
.IF TWENTY
<DUMPER FORMAT AT 1600
.ELSE TWENTY
<BACKUP <INTERCHANGE FORMAT AT EITHER 1600 OR 800
.ENDIF TWENTY
<BPI AND CONTAINS THE COMPLETE <COBOL-68/74 SYSTEM.
^THERE ARE
.IF TWENTY
EIGHT
.ELSE TWENTY
ELEVEN
.ENDIF TWENTY
SAVE SETS. ^IF ANY SAVE SETS ARE EMPTY THEN YOU ARE NOT LICENSED TO RECEIVE THEIR CONTENTS.
.B 1
^THE SAVE SETS ARE:
.B 1
#1.##<DOCUMENTATION
.BR
.IF TWENTY
#2.##<BINARY
.BR
#3.##<COBOL-SOURCE
.BR
#4.##<SORT-SOURCE
.BR
#5.##<COBOL-68-BUILD
.BR
#6.##<COBOL-74-BUILD
.BR
#7.##<SORT-BUILD
.BR
#8.##<LSTATS
.ELSE TWENTY
#2.##<COBOL-SOURCE
.BR
#3.##<SORT-SOURCE
.BR
#4.##<COBOL-68-KL-BUILD
.BR
#5.##<COBOL-68-KI-BUILD
.BR
#6.##<COBOL-74-KL-BUILD
.BR
#7.##<COBOL-74-KI-BUILD
.BR
#8.##<SORT-KL-BUILD
.BR
#9.##<SORT-KI-BUILD
.BR
10.##<SORT-KA-BUILD
.BR
11.##<LSTATS
.ENDIF TWENTY
.B 1
^THE <DOCUMENTATION SAVE SET CONTAINS THE FOLLOWING FILES:
.B 1
.NOFILL
<COBOL.INS -- THIS FILE
.IF TWENTY
<COBOL.BD -- DIRECTORY OF <BINARY SAVE SET
.ENDIF TWENTY
<COBOL.SD -- DIRECTORY OF <COBOL-SOURCE SAVE SET
<SORT.SD -- DIRECTORY OF <SORT-SOURCE SAVE SET
.IF TWENTY
<COBOL.68D -- DIRECTORY OF <COBOL-68-BUILD SAVE SET
<COBOL.74D -- DIRECTORY OF <COBOL-74-BUILD SAVE SET
<SORT.RD -- DIRECTORY OF <SORT-BUILD SAVE SET
.ELSE TWENTY
<COBOL.6LD -- DIRECTORY OF <COBOL-68-KL-BUILD SAVE SET
<COBOL.6ID -- DIRECTORY OF <COBOL-68-KI-BUILD SAVE SET
<COBOL.7LD -- DIRECTORY OF <COBOL-74-KL-BUILD SAVE SET
<COBOL.7ID -- DIRECTORY OF <COBOL-74-KI-BUILD SAVE SET
<SORT.KLD -- DIRECTORY OF <SORT-KL-BUILD SAVE SET
<SORT.KID -- DIRECTORY OF <SORT-KI-BUILD SAVE SET
<SORT.KAD -- DIRECTORY OF <SORT-KA-BUILD SAVE SET
.ENDIF TWENTY
<CBL12A.BWR -- THE ^BEWARE FILE FOR <COBOL-68/74 12^A
<CBL12A.DOC -- THE ^DOC FILE FOR <COBOL-68/74 12^A
<SRT4B.BWR -- THE ^BEWARE FILE FOR <SORT 4^B
<SRT4B.DOC -- THE ^DOC FILE FOR <SORT 4^B
.IF TWENTY
<COBLER.DOC -- INSTRUCTIONS ON USING <COBLER (FOR <LSTATS)
.ENDIF TWENTY
<IOPERF.MEM -- INFORMATION ABOUT THE <LSTATS PROJECT
<CRELD.DOC -- THE ^DOC FILE FOR <CRELD (FOR <LSTATS)
.IFN TWENTY
<RUNTIM.DDT -- <DDT PATCH FILE FOR 6.03^A ONLY
.ENDIF TWENTY
.B 1
.FILL
.IF TWENTY
^THE <BINARY SAVE SET CONTAINS THE FILES REQUIRED TO RUN <COBOL-68/74 AND <SORT.
^THESE FILES ARE NORMALLY KEPT ON <_<SUBSYS_>.
.B 1
.ENDIF TWENTY
^THE <COBOL-SOURCE SAVE SET CONTAINS ALL THE SOURCE FILES REQUIRED TO BUILD BOTH <COBOL-68 AND <COBOL-74.
^THERE IS NO NEED TO LOAD
THESE FILES ONTO THE DISK UNLESS YOU WANT TO REBUILD THE <COBOL-68/74 SYSTEM.
^THE BUILDING OF THE COMPLETE <COBOL SYSTEM REQUIRES ABOUT
.IF TWENTY
3,000 PAGES
.ELSE TWENTY
10,000 BLOCKS
.ENDIF TWENTY
OF FREE DISK SPACE AND ABOUT 1 HOUR OF <CPU TIME ON A
.IF TWENTY
2050.
.ELSE TWENTY
<KL-10.
.ENDIF TWENTY
.B 1
^THE <SORT-SOURCE SAVE SET CONTAINS ALL THE SOURCE FILES REQUIRED TO BUILD THE STAND ALONE <SORT AND THE <COBOL <SORT.
.B 1
.IF TWENTY
^THE <COBOL-68-BUILD AND <COBOL-74-BUILD
.ELSE TWENTY
^THE <COBOL-68-K*-BUILD AND <COBOL-74-K*-BUILD
.ENDIF TWENTY
SAVE SETS CONTAINS THE <REL, <LOG, <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.
.B 1
^SIMILARLY THE
.IF TWENTY
<SORT-BUILD
.ELSE TWENTY
<SORT-K*-BUILD
.ENDIF TWENTY
SAVE
.IF TWENTY
SET CONTAINS
.ELSE TWENTY
SETS CONTAIN
.ENDIF TWENTY
THE <REL, <LOG, <UNV FILES ETC. FROM THE FINAL <SORT BUILD.
.B 1
^THE <LSTATS AREA CONTAINS A VERSION OF THE <OTS WHICH CONTAINS THE <I/O
PERFORMANCE MEASUREMENT PACKAGE. ^IF YOU WISH TO PARTICIPATE IN THE <LSTATS
PROJECT, REFER TO ^SECTION 4.5 FOR DETAILED INSTRUCTIONS.
.PG
^THE FOLLOWING IS A GENERAL DESCRIPTION OF THE <COBOL-68/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.
.B 1
^THE COMPONENTS OF THE <COBOL-68/74 SYSTEM ARE:
.B 1;.LM 20;.TS 20;.I -15
<COBOL THE <COBOL-68 COMPILER
.B 1;.I -15
<CBL74 THE <COBOL-74 COMPILER
.B 1;.I -15
<LIBOL THE <COBOL-68 OBJECT TIME SYSTEM
.B 1;.I -15
<C74OTS THE <COBOL-74 OBJECT TIME SYSTEM
.B 1;.I -15
<COBDDT THE DEBUGGER
.B 1;.I -15
<RERUN THE RECOVERY SYSTEM
.B 1;.I -15
<ISAM <ISAM UTILITY PROGRAM
.B 1;.I -15
<LIBARY SOURCE LIBRARY MAINTENANCE PROGRAM
.B 1;.I -15
<SORT ^SORT PACKAGE
.FN 9
.B 1
---------------
.BR
.IF TWENTY
\\*(1)##<DBMS-20
.ELSE TWENTY
\\*(1)##<DBMS-10 AND <MCS-10
.ENDIF TWENTY
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 THE APPROPRIATE SECTIONS OF THIS DOCUMENT
IN CONJUNCTION WITH THE INSTALLATION INSTRUCTIONS INCLUDED WITH THE INDIVIDUAL
UNBUNDLED COMPONENT DISTRIBUTIONS.
!
.B 1;.I -15
.IF TWENTY
<DBMS-20*(1) ^DATA ^BASE ^MANAGEMENT ^SYSTEM
.ELSE TWENTY
<DBMS-10*(1) ^DATA ^BASE ^MANAGEMENT ^SYSTEM
.B 1;.I -15
<MCS-10*(1) ^MESSAGE ^CONTROL ^SYSTEM
.ENDIF TWENTY
.B 3;.LM 0
<NOTE, BOTH <COBOL-68 AND <COBOL-74 BUILD <COBDDT, <ISAM, <LIBARY, AND <RERUN. <COBDDT, <LIBARY, AND <RERUN ARE INDEPENDENT OF <COBOL-68/74 SO EITHER METHOD PRODUCES IDENTICAL FILES.
<ISAM CONTAINS PART OF THE <OTS SO THAT THE TWO VERSIONS OF <ISAM HAVE DIFFERENT CHECKSUMS BUT WILL BEHAVE THE SAME. ^FOR CONSISTENCY IT IS RECOMMENDED THAT THE <COBOL-68 GENERATED VERSION BE USED. ^THIS CONFLICT WILL BE RESOLVED IN VERSION 13.
.PG;.LM 0
^THE FOLLOWING FILES OR SETS OF FILES ARE INCLUDED IN THE DISTRIBUTION:
.B 1;.LM 15;.TS 15;.I -10
<CBL12A.DOC ^EACH COMPONENT HAS A DOCUMENTATION SECTION IN THIS FILE.
.B 1;.I -10
<COBOL.INS ^THIS INSTALLATION GUIDE.
.B 1;.I -10
<*.HLP ^EACH COMPONENT HAS A HELP TEXT FILE FOR USE BY THE SYSTEM <HELP COMMAND.
.B 1;.I -10
<*.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.
.B 1;.I -10
<*.LOG <.LOG FILES RECORDING THE BUILDING OF THE DISTRIBUTED SYSTEM.
.B 1;.I -10
<*.EXE ^THE SET OF SHAREABLE FILES THAT COMPOSE THE DISTRIBUTED READY TO INSTALL SYSTEM.
.B 1;.I -10
<*.MAP <LINK LOAD MAPS FOR EACH COMPONENT.
.B 1;.I -10
<*.MAC <MACRO SOURCE FILES.
.B 1;.I -10
<*.REL ^RELOCATABLE BINARY FILES.
.B 1;.I -10
<*.UNV ^UNIVERSAL FILES.
.IF TWENTY
.B 1;.I -10
<COBOL.CMD ^FILE CONTAINING INSTALLATION SPECIFIC LOGICAL NAMES. ^THIS FILE IS READ BY THE <COBOL <CTL FILES.
.B 1;.I -10
<A*.CMD <LINK INDIRECT LOADING COMMAND FILES FOR THE COMPONENTS.
.ELSE TWENTY
.B 1;.I -10
<COBOL.TEC ^FILE CONTAINING INSTALLATION SPECIFIC LOGICAL NAMES. ^THIS FILE IS READ BY THE <COBOL <CTL FILES.
.B 1;.I -10
<*.CMD <LINK INDIRECT LOADING COMMAND FILES FOR THE COMPONENTS.
.ENDIF TWENTY
.B 1;.I -10
<*.RN? <RUNOFF SOURCE FILES FOR INCLUDED <.DOC FILES.
^THE SPECIFIC NAMES AND EXTENSIONS OF THESE FILES ARE REFERENCED
IN THEIR ASSOCIATED FINAL <.DOC FILES.
.PG;.LM 0
3.0##^^INSTALLATION OF THE COBOL SYSTEM\\
.B 1
^THIS SECTION DETAILS THE PROCEDURE FOR INSTALLING THE <COBOL-68/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.
.B 1
^IF IT IS NOT NECESSARY TO SUPPORT <DBMS
.IFN TWENTY
,<MCS
.ENDIF TWENTY
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.
.B 2
^TO INSTALL <COBOL USE THE FOLLOWING PROCEDURE:
.B 1
^A. ^MOUNT THE <COBOL DISTRIBUTION TAPE ON ^^MTA0:\\
.B 1
^B. ^TYPE THE FOLLOWING COMMANDS:
.B 1
.NOFILL
.IF TWENTY
^^RESET
DUMPER
TAPE MTA0:
REWIND
DENSITY 1600-BPI
ACCOUNT SYSTEM-DEFAULT
SKIP 1
RESTORE _<*_>*.*.* (TO) <_<SUBSYS_>*.*.*
REWIND
EXIT\\
.ELSE TWENTY
^FIRST DECIDE IF YOU WANT <KL-10 OR <KI-10 (ALSO <KA-10) <COBOL.
.B 1
^FOR <COBOL-68
.BR
^^ R BACKUP
TAPE MTA0:
INTERCHANGE
DENSITY 1600 \\OR^^ 800
SKIP 3 (\\FOR ^^KL-10) \\OR^^ 4 (\\FOR ^^KI-10)
RESTORE *.EXE, LIBOL.REL, COBDDT.REL, *.DOC, *.HLP
REWIND
EXIT\\
.B 1
^FOR <COBOL-74
.BR
^^ R BACKUP
TAPE MTA0:
INTERCHANGE
DENSITY 1600 \\OR^^ 800
SKIP 5 (\\FOR ^^KL-10) \\OR^^ 6 (\\FOR ^^KI-10)
RESTORE *.EXE, C74LIB.REL, *.DOC, *.HLP
REWIND
EXIT\\
.B 1
^FOR <SORT - NOTE THAT THIS WILL OVERWRITE THE PREVIOUSLY RESTORED <LIBOL AND <C74LIB WITH THE NEW VERSIONS.
.BR
^^ R BACKUP
TAPE MTA0:
INTERCHANGE
DENSITY 1600 \\OR^^ 800
SKIP 7 (\\FOR ^^KL-10) \\OR^^ 8 (\\FOR ^^KI-10) \\OR^^ 9 (\\FOR ^^KA-10)
RESTORE *.EXE, *.REL, *.DOC, *.HLP
REWIND
EXIT\\
.ENDIF TWENTY
.FILL
.B 1
.IFN TWENTY
.B 1;.LM 0;.RM 70
^THE ENTIRE INSTALLATION CAN THEN BE ACCOMPLISHED WITH THREE ^^COPY\\ COMMANDS OF THE GENERAL FORM:
.B 1;.LM 5;.NJ;.NF
^^.COPY SYS: = *.EXE, COBDDT.REL, LIBOL.REL, C74LIB.REL
_.COPY DOC: = *.DOC
_.COPY HLP: = *.HLP\\
.LM 0;.F;.J
.ENDIF TWENTY
.FILL
.B 1;.LM 4
.INDENT -4
^C.##^TO VERIFY THE INSTALLATION PROCEDURE COPY THE FILE
.IF TWENTY
<ACP020.LIB
.ELSE TWENTY
<ACP010.LIB
.ENDIF TWENTY
FROM THE
.IF TWENTY
<COBOL-68-BUILD
.ELSE TWENTY
<COBOL-68-K*-BUILD
.ENDIF TWENTY
SAVE SET (TO TEST <COBOL-68) OR FROM THE
.IF TWENTY
<COBOL-74-BUILD
.ELSE TWENTY
<COBOL-74-K*-BUILD
.ENDIF TWENTY
SAVE SET (TO TEST <COBOL-74)
TO A SCRATCH AREA. ^EXTRACT THE MASTER <.CTL FILE WITH THE COMMANDS:
.B 1
.NOFILL
^^
.IF TWENTY
@LIBARY
*=ACP020
*EXTRACT ACPMASCM,ACPMAS.CTL
*_^C
.ELSE TWENTY
.R LIBARY
*=ACP010
*EXTRACT ACPMASCM,ACPMAS.CTL
*_^C
.ENDIF TWENTY
\\
.FILL
.B 1
.INDENT -4
^D.##^SUBMIT THE <.CTL FILE WITH THE COMMAND:
.B 1
.NOFILL
^^
.IF TWENTY
@SUBMIT ACPMAS
.ELSE TWENTY
.SUBMIT ACPMAS
.ENDIF TWENTY
.FILL
\\
.B 1
^IF THE FILE <ACP1.LOG CONTAINS NO ERRORS THEN THE NEW <COBOL COMPILER INSTALLED ON <SYS: CAN PERFORM BASIC <COBOL TASKS.
.PG
.LM 0
4.0##^^SYSTEM REBUILDING\\
.B 1
^THIS SECTION DETAILS HOW TO REBUILD ALL OR PART OF THE <COBOL-68/74
SYSTEM IN ORDER TO SUPPORT
.IF TWENTY
<DBMS-20,
.ELSE TWENTY
<DBMS-10, <MCS-10,
.ENDIF TWENTY
<SORT, OR
FOR MAINTENANCE PURPOSES.
.B 1
^THIS TAPE CONTAINS COMMON SOURCES FOR BOTH <COBOL-68 AND <COBOL-74. ^WHICH VERSION IS GENERATED IS CONTROLLED BY THE SETTING OF TWO MUTUALLY EXCLUSIVE FEATURE TEST SWITCHES IN <COBASM. ^FOR <COBOL-68 SET <ANS68==1 AND <ANS74==0. ^FOR <COBOL-74 SET <ANS68==0 AND <ANS74==1. ^ALTHOUGH IT IS POSSIBLE TO BUILD THE TWO COMPILERS IN THE SAME AREA (THOUGH NOT SIMULTANEOUSLY) IT IS RECOMMENDED THAT SEPARATE BUILD AREAS BE
.IF TWENTY
USED.
.ELSE TWENTY
USED AND THAT THE SOURCE AREA BE MAKE A LIBRARY (DEVICE <LIB:).
.ENDIF TWENTY
.B 1
.IF TWENTY
^TO SIMPLIFY THE BUILDING TASK ALL THE <COBOL <CTL FILES READ THE <COBOL.CMD FILE WHICH CONTAINS DEFINITIONS OF ALL THE LOGICAL NAMES USED. ^IT IS RECOMMENDED THAT THE SAME LOGICAL NAMES BE USED AND THAT THE USER SHOULD EDIT <COBOL.CMD TO CONTAIN APPROPRIATE DEFINITIONS.
.ELSE TWENTY
^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.
.ENDIF TWENTY
.BR
.IF TWENTY
^THE LOGICAL NAMES USED ARE:
.B 1
.BR
<COBOL-DOCUMENTATION:
.BR
<COBOL-BINARY:
.BR
<COBOL-SOURCE:
.BR
<SORT-SOURCE:
.BR
<COBOL-68-BUILD:
.BR
<COBOL-74-BUILD:
.BR
<SORT-BUILD:
.B 1
^THESE LOGICAL NAMES CORRESPOND TO THE SAVE SETS ON THE DISTRIBUTION TAPE.
.ENDIF TWENTY
.B 1
<COBOL-68/74 VERSION 12^A SUPPORTS THE FOLLOWING USER INSTALLATION SETTABLE FEATURE ASSEMBLY SWITCHES: <DEBUG,
<DBMS,
.IF TWENTY
AND <DBMS4.
.ELSE TWENTY
<DBMS4, <MCS, <BIS (<KL-10 CENTRAL PROCESSOR), AND <ONESEG (SINGLE SEGMENT COMPILER).
.ENDIF TWENTY
^OTHER ASSEMBLY SWITCHES ARE SUPPORTED
ONLY IN THEIR DISTRIBUTED POSITION. ^THE DEFAULT SETTING FOR THE
<DBMS,
.IF TWENTY
AND <DBMS4
.ELSE TWENTY
<DBMS4, <MCS, AND <BIS
.ENDIF TWENTY
SWITCHES IS <ON (1), AND FOR <DEBUG
.IFN TWENTY
AND <ONESEG
.ENDIF TWENTY
THE DEFAULT SETTING IS <OFF (0).
^THIS REPRESENTS THE
STANDARD DEFAULT CONFIGURATION.
.B 1
^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.
.B 1
^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.
.PG
4.1##^REQUIRED ^SYSTEM ^SOFTWARE
.B 1
^IN ORDER TO REBUILD ALL OR PART OF THE <COBOL-68/74 SYSTEM THE FOLLOWING STANDARD SYSTEM
SOFTWARE IS REQUIRED, OF THE SPECIFIED OR A LATER VERSION.
.B 1;.LM 5;.TS 20;.NJ;.NF
^SOFTWARE ^VERSION
-------- -------
.B 1
<MACRO 53(1020)
<LINK 4(765)
<MAKLIB 2(20)
.IF TWENTY
<PA1050 <3A(307)
.BR
<MACREL ^PRE-^RELEASE 4
.B 1
^NOTE, THIS IS NOT THE OFFICIAL ^RELEASE 4 <MACREL AND SHOULD ONLY BE USED TO BUILD <COBOL AND <SORT. ^IT CAN BE REPLACED BY THE OFFICIAL ^RELEASE 4 VERSION WHEN ^RELEASE 4 IS SHIPPED.
.ELSE TWENTY
<UUOSYM.UNV 13^A(406)
.ENDIF TWENTY
.B 1;.LM 0;.F;.J
<COBOL-68/74 ^VERSION 12^A WILL RUN UNDER ALL SUPPORTED MONITORS AS WILL PROGRAMS
COMPILED WITH <COBOL-68/74 VERSION 12^A.
.PG
4.2##^STANDARD ^CONFIGURATION
.B 1
^THE STANDARD DISTRIBUTED CONFIGURATION CONSISTS OF TWO
.IFN TWENTY
MULTI-SEGMENT
.ENDIF TWENTY
COMPILERS CONTAINING SUPPORT FOR ALL
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10 AND <MCS-10
.ENDIF TWENTY
\ SYNTAX.
^THIS MEANS THAT ALL OF THE RESERVED WORDS FOR
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10 AND <MCS-10
.ENDIF TWENTY
WILL BE PRESENT IN THE STANDARD CONFIGURATION OF <COBOL-68/74 ^VERSION 12^A.
^THIS WILL ELIMINATE THE NECESSITY FOR REBUILDING THE <COBOL-68/74 COMPILERS
TO GET SUPPORT FOR THIS UNBUNDLED COMPONENT. ^THE STANDARD DISTRIBUTED
CONFIGURATION ALSO CONSISTS OF AN OBJECT TIME SYSTEM AND A SERIES OF
UTILITY ROUTINES. ^THE STANDARD DISTRIBUTED CONFIGURATION OF THE OBJECT TIME SYSTEM
AND OF THE UTILITY ROUTINES DOES NOT INCLUDE SUPPORT FOR
.IF TWENTY
<DBMS-20.
.ELSE TWENTY
<DBMS-10 OR <MCS-10.
.ENDIF TWENTY
.B 1
^IN GENERAL IT IS NOT NECESSARY TO REBUILD THE ENTIRE <COBOL-68/74 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
.IF TWENTY
IN EITHER <COBOL-68-BUILD AND/OR <COBOL-74-BUILD AS REQUIRED
.ENDIF TWENTY
WHICH WILL THEN SUBMIT ALL THE OTHER <.CTL FILES IN THE CORRECT
ORDER WITH DEPENDENCY COUNTS.
.PG;.NOFILL
^TO BUILD <COBOL-68 AND/OR <COBOL-74:
.B 1
^A. ^MOUNT THE <COBOL DISTRIBUTION TAPE ON LOGICAL <MTA0:
.B 2
^B. ^TYPE THE FOLLOWING COMMANDS:
.B 2
.IF TWENTY
^^CONNECT COBOL-SOURCE:
RESET
REWIND MTA0:
DUMPER
TAPE MTA0:
DENSITY 1600-BPI
ACCOUNT SYSTEM-DEFAULT
SKIP 2
RESTORE _<*_>*.*.* (TO) *.*.*
REWIND
EXIT\\
.B 1
FOR <COBOL-68
.BR
^^CONNECT COBOL-68-BUILD:
RESET
REWIND MTA0:
DUMPER
TAPE MTA0:
DENSITY 1600-BPI
ACCOUNT SYSTEM-DEFAULT
SKIP 4
RESTORE _<*_>*.*.* (TO) *.*.*
REWIND
EXIT\\
.B 1
FOR <COBOL-74
.BR
^^CONNECT COBOL-74-BUILD:
RESET
REWIND MTA0:
DUMPER
TAPE MTA0:
DENSITY 1600-BPI
ACCOUNT SYSTEM-DEFAULT
SKIP 5
RESTORE _<*_>*.*.* (TO) *.*.*
REWIND
EXIT\\
.ELSE TWENTY
<LOGIN TO THE <COBOL-SOURCE AREA
.BR
^^REWIND MTA0:
R BACKUP
TAPE MTA0:
DENSITY 1600 \\OR^^ 800
INTERCHANGE
SKIP 1
RESTORE *.*
REWIND
EXIT\\
.B 1
<LOGIN TO THE <COBOL-68-BUILD AREA
.BR
^^REWIND MTA0:
R BACKUP
TAPE MTA0:
DENSITY 1600 \\OR^^ 800
INTERCHANGE
SKIP 3 (\\FOR <KL-10) OR 4 (FOR <KI-10)^^
RESTORE *.*
REWIND
EXIT\\
.B 1
<LOGIN TO THE <COBOL-74-BUILD AREA
.BR
^^REWIND MTA0:
R BACKUP
TAPE MTA0:
DENSITY 1600 \\OR^^ 800
INTERCHANGE
SKIP 5 (\\FOR <KL-10) OR 6 (FOR <KI-10)^^
RESTORE *.*
REWIND
EXIT\\
.B 1
<LOGIN TO THE <SORT-BUILD AREA
.BR
^^REWIND MTA0:
R BACKUP
TAPE MTA0:
DENSITY 1600 \\OR^^ 800
INTERCHANGE
SKIP 7 (\\FOR <KL-10) OR 8 (FOR <KI-10) OR 9 (FOR <KA-10)^^
RESTORE *.*
REWIND
EXIT\\
.ENDIF TWENTY
.B 2;.PG;.LM 4;.I -4
.IF TWENTY
^C.##<CONNECT TO EITHER <COBOL-68-BUILD OR <COBOL-74-BUILD. ^MODIFY <COBOL.CMD,
.ELSE TWENTY
^C.##<LOGIN TO THE APPROPRIATE <COBOL-68-K*-BUILD OR <COBOL-74-K*-BUILD. ^MODIFY <COBOL.TEC,
.ENDIF TWENTY
<DELETE <*.LOG, THEN <SUBMIT THE REQUIRED FILES.
.B 2;.LM 9;.I -4
A.##^THE WHOLE SYSTEM
.BR
###^^SUBMIT BLDCBL.CTL\\
.B 1;.I -4
B.##^^COMPILER\\
.BR
###^^SUBMIT COBOL.CTL/TIME:1:00:00/RESTART:YES\\
.BR
###^DEPENDENCIES: ^NONE
.B 1;.I -4
C.##<OTS
.BR
###^^SUBMIT LIBOL.CTL/TIME:0:30:00/RESTART:YES\\
.BR
###^DEPENDENCIES: ^NONE
.B 1;.I -4
D.##^^COBDDT\\
.BR
###^^SUBMIT COBDDT.CTL\\
.BR
###^DEPENDENCIES: <INTERM.UNV AND <COMUNI.UNV
.B 1;.I -4
E.##^^ISAM\\
.BR
###^^SUBMIT ISAM.CTL\\
.B 1;.I -4
F.##^^LIBARY\\
.BR
###^^SUBMIT LIBARY.CTL\\
.BR
###^DEPENDENCIES: ^NONE
.B 1;.I -4
G.##^^RERUN\\
.BR
###^^SUBMIT RERUN.CTL\\
.BR
###^DEPENDENCIES: <COMUNI.UNV, <FTDEFS.UNV AND <LBLPRM.UNV
.B 2;.LM 0
<NOTE, THERE WILL BE NO <SORT IN THE <OTS BUILT BY THIS PROCEDURE. ^SEE SEC. 4.3.3 FOR INSTRUCTIONS FOR INSTALLING <SORT INTO THE <OTS.
.PG;.LM 0;.RM 70;.F;.J
4.3##^NON-^STANDARD ^CONFIGURATIONS
.B 1
^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 PRECEEDING SECTION FOR SPECIFICS WHEN INSTRUCTED TO REBUILD SOME SYSTEM COMPONENT.
.B 3
4.3.1##^^DBMS\\
.B 1;.LM 0
^IF YOU HAVE A STANDARD CONFIGURATION ^VERSION 12^A <COBOL-68 OR <COBOL-74 ^COMPILER, ALL THAT IS NEEDED TO COMPLETE SUPPORT FOR
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10
.ENDIF TWENTY
\\ IS TO FOLLOW THESE INSTRUCTIONS:
.B 1;.LM 9;.I -4
1.##
.IF TWENTY
<DEFINE THE LOGICAL NAME <DBMS-BUILD AND COPY THE <DBMS-20 DISTRIBUTION TAPE TO IT. ^COPY <DBMS.CTL AND <DBMS.CMD FROM <COBOL-SOURCE: TO <DBMS-BUILD. ^MODIFY <DBMS.CMD TO CONTAIN YOUR LOCAL DEFINITIONS, NOTE <DBMS.CMD IS SIMILAR TO <COBOL.CMD AND <SORT.CMD AND SHOULD CONTAIN THE SAME LOGICAL NAMES, THE MAIN DIFFERENCE IS IN THE DEFINITION OF <DSK:.
.ELSE TWENTY
^INCLUDE A COPY OF <LIBOL.REL AND <LIBSHR.REL (FOR <COBOL-68) AND <C74LIB.REL AND <C74SHR.REL (FOR <COBOL-74) IN THE SAME DISK
AREA AS THE CONTENTS OF THE <DBMS-10 DISTRIBUTION TAPE.
.ENDIF TWENTY
.B 1;.I -4
2.##^REFER TO
.IF TWENTY
<DBMS20.DOC
.ELSE TWENTY
<DBMS10.DOC
.ENDIF TWENTY
FOR
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10
.ENDIF TWENTY
INSTALLATION INSTRUCTIONS.
.B 1;.LM 0
^THE STANDARD CONFIGURATION OF THE <COBOL-68 AND <COBOL-74 COMPILERS COME COMPLETE WITH SUPPORT FOR
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10
.ENDIF TWENTY
, HOWEVER, THE OBJECT TIME SYSTEMS WILL NOT
HAVE
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10
.ENDIF TWENTY
SUPPORT. ^THIS MAKES IT MUCH EASIER TO INSTALL
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10
.ENDIF TWENTY
LATER. ^HOWEVER, IT DOES INCREASE THE SIZE OF THE COMPILERS SLIGHTLY AND INCREASES
THE NUMBER OF RESERVED WORDS. ^IF YOU DO NOT WANT ANY
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10
.ENDIF TWENTY
SUPPORT
IN THE COMPILERS, IT IS POSSIBLE TO REBUILD THE COMPILERS TURNING OFF THE
^^DBMS\\ AND ^^DBMS4\\ SWITCHES. ^THIS CAN BE ACCOMPLISHED IN THE FOLLOWING
MANNER:
.B 1;.LM 9;.I -4
A.##^COPY THE CONTENTS OF THE <COBOL DISTRIBUTION TAPE INTO APPROPRIATE DISK AREAS.
.B 1;.I -4
B.##^MODIFY THE UNIVERSAL FILE ^^"COBASM.MAC"\\ TO INCLUDE THE SYMBOL
DEFINITION ^^"DBMS==0"\\.
.B 1;.I -4
C.##^REBUILD THE <COBOL-68/74 COMPILERS.
.B 1;.LM 0
^IF YOU LATER WISH TO REINSTITUTE SUPPORT FOR
.IF TWENTY
<DBMS-20
.ELSE TWENTY
<DBMS-10
.ENDIF TWENTY
IN THE COMPILERS, FOLLOW STEPS A AND C, MAKING SURE THAT THE SYMBOL <"DBMS" DOES NOT APPEAR IN THE UNIVERSAL FILE <"COBASM.MAC".
.PG;.LM 0
4.3.2##<SORT
.B 1;.LM 9;.I -4
A.##^IF <COBOL-68, <COBOL-74 AND <SORT ARE ALL BEING REBUILT BECAUSE OF MAJOR CHANGES IN THE CONFIGURATION, THEN THE CORRECT PROCEDURE IS TO FIRST SUBMIT
<BLDCBL.CTL FOR EACH COMPILER AND WHEN THEY ARE DONE, <SORT.CTL.
.BR
<BLDCBL.CTL CREATES THE FILES REQUIRED BY <SORT.CTL TO ADD THE <SORT TO <LIBOL AND <C74OTS.
.BR
^ON THE OTHER HAND IF A <COBOL-68 OR <COBOL-74 <OTS EXISTS AND ONLY <SORT HAS BEEN MODIFIED THEN IT IS SUFFICIENT TO RUN ONLY <SORT.CTL.
.BR
^SIMILARLY IF <SORT EXISTS AND <COBOL-68/74 <OTS HAS BEEN MODIFIED IT IS SUFFICIENT TO RUN ONLY <LIBOL.CTL FOR EACH COMPILER.
.B 1;.I -4
B.##^^SUBMIT SORT.CTL/TIME:0:30:00/RESTART:YES\\
.BR
WHICH WILL REPLACE THE DUMMY <SORT
MODULE USED BY THE ^^COBOL SORT\\ ^VERB WITH THE REAL <SORT MODULE.
^IT WILL GENERATE MODIFIED VERSIONS OF
.IF TWENTY
<LIBOL.REL, <LIBO12.EXE, <C74LIB.REL, AND <C74O12.EXE.
.ELSE TWENTY
<LIBOL.REL AND <C74LIB.REL.
.ENDIF TWENTY
^IT WILL ALSO BUILD
^^SORT.EXE\\ WHICH IS THE STAND ALONE CONFIGURATION.
.B 1;.I -4
C.##^INSTALL THE SYSTEM IN THE NORMAL FASHION AND IN ADDITION
.B 1;.LM 13;.NJ;.NF
.IF TWENTY
^^COPY SORT.EXE (TO) _<SUBSYS>SORT.EXE
COPY SORT.DOC (TO) _<SUBSYS>SORT.DOC
COPY SORT.HLP (TO) _<SUBSYS>SORT.HLP\\
.ELSE TWENTY
^^COPY SYS: = SORT.EXE
COPY DOC: = SORT.DOC
COPY HLP: = SORT.HLP\\
.ENDIF TWENTY
.B 3;.LM 0;.F;.J
4.3.3##^^USER LIBOL ROUTINES\\
.B 1
<COBOL-68/74 INCLUDES A FACILITY ALLOWING INSTALLATIONS TO ADD THEIR
OWN SPECIAL PURPOSE <MACRO ROUTINES TO <LIBOL.REL AND <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.
.B 1
^THE USER ROUTINES ARE ADDED TO <LIBOL.REL AND/OR <C74LIB.REL
AFTER ALL OTHER <OTS REBUILDING BUT BEFORE INSTALLATION ON <SYS:.
.LM 0;.F;.J
.IFN TWENTY
.PG
4.3.4##^^MCS\\
.B 1;.LM 0
^IF YOU HAVE THE STANDARD CONFIGURATION COMPILERS, IT IS NOT NECESSARY TO
REBUILD ANY SYSTEM COMPONENT, SIMPLY REFER TO THE
<MCS-10
DISTRIBUTION PACKAGE FOR
<MCS-10
BUILDING AND INSTALLATION PROCEDURES.
.B 1;.LM 0
^THE STANDARD CONFIGURATION OF THE COMPILERS COME 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 COMPILERS, IT IS POSSIBLE TO REBUILD THE COMPILERS TURNING OFF THE
<MCS
SWITCH. ^THIS CAN BE ACCOMPLISHED IN THE FOLLOWING MANNER:
.B 1;.LM 9;.I -4
A.##^COPY THE CONTENTS OF THE <COBOL DISTRIBUTION TAPE INTO APPROPRIATE DISK AREA.
.B 1;.I -4
B.##^MODIFY THE UNIVERSAL FILE <"COBASM.MAC" TO INCLUDE THE SYMBOL DEFINITION
<MCS==0.
.B 1;.I -4
C.##^REBUILD THE <COBOL-68/74 COMPILERS.
.B 1;.LM 0
^IF YOU LATER WISH TO REINSTITUTE SUPPORT FOR
<MCS-10
IN THE COMPILERS, FOLLOW STEPS A AND C, MAKING SURE THAT THE SYMBOL
<MCS
DOES NOT APPEAR IN THE UNIVERSAL FILE <"COBASM.MAC".
.B 3;.LM 0
4.3.5##<KI-10 AND <KA-10 ^PROCESSOR ^CONFIGURATION
.B 1
^THE COMPILERS AND <OTS<S CAN BE RECONFIGURED TO NOT GENERATE <KL10 ^CENTRAL ^PROCESSOR EXTENDED INSTRUCTIONS AND THUS TO RUN ON A <KI-10 OR <KA-10 CPU.
.B 1;.LM 9;.I -4
A.##^MODIFY THE UNIVERSAL FILE <COBASM.MAC TO INCLUDE THE SYMBOL DEFINITION <"BIS==0".
.B 1;.I -4
B.##^REBUILD THE COMPILERS.
.B 1;.I -4
C.##^REBUILD THE <OTS<S.
.B 1;.I -4
D.##^REFER TO SECTION 3 FOR <COBOL SYSTEM INSTALLATION INSTRUCTIONS.
.B 2;.LM 0;.F;.J
4.3.6##^SINGLE ^SEGMENT ^COMPILER
.B 1
^IT IS POSSIBLE TO BUILD A SINGLE SEGMENT COMPILER. ^THE COMPILER WILL REQUIRE
110^K TO COMPILE A MINIMAL <COBOL PROGRAM.
.B 1;.LM 9;.I -4
A.##^MODIFY ^^COBASM.MAC\\ TO INCLUDE THE SYMBOL DEFINITION ^^"ONESEG==1".\\
.B 1;.I -4
B.##^REBUILD THE <COBOL-68/74 COMPILERS.
.B 1;.I -4
C.##^THIS WILL PRODUCE TWO SINGLE SEGMENT COMPILERS CONSISTING OF THE FILES <COBOL.EXE AND <CBL74.EXE WHICH CAN BE COPIED TO ^^SYS:\\ INSTEAD OF THE
MULTI-SEGMENT COMPILER CONFIGURATIONS.
.B 1;.I -4
D.##^THE REMAINDER OF THE SYSTEM IS INSTALLED IN THE NORMAL FASHION.
.ENDIF TWENTY
.PG
.LM 0
4.4##<COMPUTE ^STATEMENT
.B 1
^THE STANDARD CONFIGURATION (AND ALL PREVIOUS VERSIONS) OF THE COMPILER USES SINGLE PRECISION FLOATING POINT WHENEVER THE INTERMEDIATE TEMPORARY EXCEEDES 18 DIGITS OR WHENEVER EXPONENTIATION IS USED. ^THIS MEANS THAT MOST OF THE PRECISION IS LOST. ^THE SOLUTION TO THIS PROBLEM IS TO USE DOUBLE PRECISION FLOATING POINT. ^THIS HAS BEEN DONE
.IFN TWENTY
FOR THE <KL CPU
.ENDIF TWENTY
AND MOST OF THE CODE TO USE THIS NEW INTERNAL DATA TYPE IS ALWAYS ASSEMBLED. ^HOWEVER THE DATA TYPE IS ONLY INVOKED FROM A FEW PLACES AND THESE PLACES HAVE BEEN PUT UNDER A NEW FEATURE TEST SWITCH <BISCMP WHICH IS <OFF IN THE STANDARD CONFIGURATION. ^THE REASON FOR THIS IS THAT THE CODE HAS NOT BEEN SUFFICIENTLY TESTED AND WE DO NOT WANT TO RISK BREAKING MANY WORKING PROGRAMS FOR THE FEW THAT NEED THE NEW CODE. ^ALL THAT HAS TO BE DONE TO SUPPORT DOUBLE PRECISION FLOATING POINT IS TO DEFINE <BISCMP==1 IN <COBASM.MAC AND REBUILD THE COMPILER. ^INFACT ALL THAT REALLY HAS TO BE REASSEMBLED IS <COBASM, <INTERM, <P, <EXPGEN, <MATGEN, <MOVGEN, AND <EXPGEN. ^<BISCMP WILL BE SUPPORTED BOTH <ON AND <OFF, THAT IS, WE WILL FIX ANY BUGS REPORTED IN THE NEW <COMPUTE CODE.
.IFN TWENTY
^NOTE THIS CODE WILL NOT RUN ON <KA-10<S SINCE IT USES DOUBLE PRECISION FLOATING POINT HARDWARE, AND IT WILL NOT RUN ON <KI-10<S SINCE IT USES <DADD INSTRUCTIONS.
.ENDIF TWENTY
.B 1
4.5.##<I/O ^PERFORMANCE ^METERING (<LSTATS)
.B 1
.LM 9;.I -4
A.##^READ <IOPERF.MEM TO UNDERSTAND THE PROJECT AND WHAT YOU HAVE TO DO.
.B 1
.I -4
B.##^BUILD AN <LSTATS OUTPUT AREA AND USE <CRELD TO CREATE THE FILE
<LSTATS.DIR (THE METHOD FOR DOING THIS IS DOCUMENTED FULLY IN <CRELD.DOC).
.B 1
.IF TWENTY
.I -4
C.##^IF YOU ARE RUNNING A MONITOR BEFORE RELEASE 4, REFER TO <COBLER.DOC
FOR INSTRUCTIONS ON HOW TO FIX YOUR <PTYCON.ATO FILE. ^IF YOU ARE RUNNING
<TOPS20 RELEASE 4 OR LATER, YOU MUST DELETE THE FILES <MONSYM.* AS
SUPPLIED ON THE TAPE AND REBUILD <LIBOL. <COBLER IS NOT NEEDED FOR
RELEASE 4 SYSTEMS, SINCE THE <METER% <JSYS HAS BEEN IMPLEMENTED IN THOSE
MONITORS). ^IF YOUR MONITOR IS RELEASE 4 OR YOU HAVE REDEFINED THE <JSYS WHICH
IS USED, <SRTCBL (A MODULE OF <SORT) MUST BE REASSEMBLED.
.ELSE TWENTY
.I -4
C.##^IF YOU ARE RUNNING 6.03^A PLEASE INSTALL THE MONITOR PATCH <RUNTIM.DDT WHICH IS ON THE <DOCUMENTATION AREA. ^THIS PATCH WILL FIX THE <RUNTIM <UUO TO RETURN THE CORRECT RUNTIME FOR THE JOB DOING THE <UUO, OTHERWISE IT COULD BE OFF BY UP TO ONE CLOCK TICK (1/60 SECOND). ^NOTE, THIS PATCH IS NOT APPLICABLE TO 7.00.
.ENDIF TWENTY
.B 1
^AFTER YOU HAVE INSTALLED THE <LSTATS SUPPORT IN YOUR SYSTEM,
YOU CAN REBUILD <LIBOL WITH THE FEATURE TEST SWITCH "<LSTATS" SET TO 1
(OR JUST USE THE <.EXE FILES
SUPPLIED ON THE TAPE, IF ALL DEFAULTS SUIT YOU).
^THIS COMPLETES THE INSTALLATION OF AN <LSTATS <LIBOL.
.PG;.LM 0
5.0##^^COMPATABILITY OF <COBOL-68 AND <COBOL-74\\
.B 1;.LM 9;.I -4
A.##^IN GENERAL <COBOL-68 WILL NOT COMPILE <COBOL-74 PROGRAMS AND <COBOL-74 WILL NOT COMPILE <COBOL-68 PROGRAMS. ^FOR THE DIFFERENCES BETWEEN <COBOL-68 AND <COBOL-74 SEE :
.BR
^AMERICAN ^NATIONAL ^STANDARD <COBOL <ANSI <X3.23-1974
.BR
PAGES <X1V-10 THROUGH <X1V-32.
.BR
OR
.BR
<COBOL-74 ^LANGUAGE ^MANUAL <AA-5059A-TK
.BR
<APPENDIX ^A
.B 1;.I -4
B.##^IT IS NOT POSSIBLE TO MIX <REL FILES PRODUCED BY <COBOL-68 AND <COBOL-74.
.B 1;.I -4
C.##^DATA FILES#-#<COBOL-68 AND <COBOL-74 ARE COMPATIBLE.
.B 3;.LM 0
[<END OF <COBOL.INS]