VS COBOL 85 Release 03.01.05 Customer Software Release Notice January 2000 Copyright GetronicsWang Co., 2000 DISCLAIMER OF WARRANTIES AND LIMITATION OF LIABILITIES The staff of GetronicsWang Co, has taken due care in preparing this document; however, nothing contained herein modifies or alters in any way the standard terms and conditions of the Wang purchase, lease, or license agreement by which this software package was acquired, nor shall GetronicsWang Co., or its subsidiaries be liable for incidental or consequential damages in connection with or arising from the use of the software package, the accompanying manual, or any related manuals. Notice All Wang Program Products are licensed to customers in accordance with the terms and conditions of the GetronicsWang Co., Standard Program Products License; no ownership of Wang Software is transferred and any use beyond the terms of the aforesaid License, without the written authorization of GetronicsWang Co., is prohibited. CONTENTS PREFACE CHAPTER 1 INTRODUCTION CHAPTER 2 HARDWARE AND SOFTWARE REQUIREMENTS 2.1 Hardware Requirements 2.2 Software Requirements VS Operating System VS Symbolic Debugger Other VS Tools and Utilities CHAPTER 3 ENHANCEMENTS WITH THIS RELEASE CHAPTER 4 CORRECTED PROBLEMS 4.1 Problems Corrected in Release 03.01.05 4.2 Problems Corrected in Release 03.01.04 4.3 Problems Corrected in Release 03.01.03 4.4 Problems Corrected in Release 03.01.02 4.5 Problems Corrected in Release 03.01.01 4.6. Problems Corrected in Release 03.01.00 CHAPTER 5 SPECIAL CONSIDERATIONS AND CONDITIONS 5.1 Year 2000 Special Considerations 5.2 Special Considerations 5.3 Special Conditions CHAPTER 6 MEDIA CONTENTS CHAPTER 7 INSTALLATION INSTRUCTIONS PREFACE This Customer Software Release Notice (CSRN) provides installation instructions and release information for Release 3.01.05 of the Wang VS COBOL 85 compiler. It is written for COBOL 85 programmers and system administrators who are familiar with the VS Operating System. For further information on related topics, consult the following manuals: o COBOL 85 Language Reference Manual (715-4952) o Programmer's Guide to COBOL 85 (800-1214) Update (800-1214.01) o VS PACE COBOL HLI Reference (800-1212) o VS PACE Manager Reference (800-1341) o VS INFO User's Guide (715-0954) CHAPTER 1 INTRODUCTION The Wang VS COBOL 85 compiler validates and translates source programs written in the ANSI Standard COBOL 85 language, producing a program file that executes on any Wang VS system. CHAPTER 2 HARDWARE AND SOFTWARE REQUIREMENTS 2.1 HARDWARE REQUIREMENTS Systems running the compiler should have more than 3 megabytes (MB) of user address space. The compiler requires about 1.3 MB of segment 1 space. The minimum amount of segment 2 space varies with the size and complexity of the program being compiled. 2.2 SOFTWARE REQUIREMENTS This section describes the earliest releases of the VS Operating System and of other VS tools and utilities that are compatible with the COBOL 85 compiler. 2.2.1 VS Operating System The compiler runs on VS Operating System 7.00 or greater, except as noted below: o Versions 3.01.00 and up of the COBOL85 compiler and the object code it creates must be run on a VS Operating System version 7.52.00 or greater to have full YEAR 2000 support and take advantage of the new DATE4 keyword documented further in this document. If this is not a requirment the COBOL85 compiler may be run on VS Operating System 7.21.09 or Operating Systems 7.40 and up. o If you use Extended DMS (XDMS) options or syntax, the compiler requires Operating System Release 7.21 or greater and XDMS Release 00.00.32 or greater. o In order to compile COBOL85 HLI programs specifying the option PREP=YES on the Compiler's OPTIONS screen. To insure that the proper version of the PACE Database Management System is currently installed check with your local sales representative. Please be sure to read the CSRN for the PACE Database Management System for any restrictions or special considerations required. 2.2.2 VS Symbolic Debugger COBOL 85 Releases 3.01.00 and up require Release 1.02.04 or greater of the VS Symbolic Debugger. To display indexes and unsigned packed data with the Debugger VARIABLE command, use Release 1.04.01 or greater of the Debugger. To display PERFORM statement traces, use Version 1.05.04 or greater of the Debugger and compile with option SYMB = NEW. (Version 1.05.04 of the Debugger requires OS Version 7.21 or greater.) Note: SYMB = NEW is not compatible with versions of the Debugger lower than Version 1.05.04. (See Section 5.2.) 2.2.3 Other VS Tools and Utilities Other minimum software requirements of the COBOL 85 compiler Releases 3.01.00 and up are SORT -- To run COBOL programs that need full SORT/MERGE capability, use Release 5.10.01 of the SORT utility. VS INFO -- To access the help text, you must have VS INFO installed on your system. ADEPT or VS Editor -- Use either the VS Advanced Editing Productivity Tool (ADEPT) or Release 7.02.08 or greater of the VS Editor to edit your source programs. CHAPTER 3 ENHANCEMENTS WITH THIS RELEASE This release of the VS COBOL 85 compiler contains the following enhancements: o When a program is compiled using object form 0 with no static runtime library specified there is a timestamp placed in the lengths block. This can be used to help determine the DATSEL option by versions 7.52.05 and greater of the LINKER. The compilation time will also appear on the link map as it currently does from all object form 1 object modules. o DATE4 Keyword for the ACCEPT statement. The DATE4 keyword allows the ACCEPT statement to retrieve the entire 4-digit year. The syntax of the ACCEPT statements has been extended to support the new DATE4 keyword. The syntax of the ACCEPT statement has been extended as shown below. General Format ACCEPT identifier FROM DATE DAY DAY OF WEEK TIME DATE4 Syntax Rules 1. DATE4 is a new reserved word. General Rules Format 2 9. DATE, DAY, DAY-OF-WEEK, TIME, and DATE4 are conceptual data items. You do not describe them in your program. 13. DATE4 is composed of the data elements 4-digit year which is century and year of century, month of the year, and day of the month. The sequence of the data element codes is from high order to low order (left to right). For example October 31, 1995 would be expressed as 19951031. DATE4, when accessed by a COBOL85 program behaves as if it had been described in the COBOL85 program as an unsigned, elementary, numeric integer of eight digits in length. If programs containing the DATE4 keyword are run on an operating system prior to 07.52.00 the first two high order bytes of the year may contain undefinable information. In most cases the century digits will contain zeros, for example October 31, 1995 would be expressed as 00951031. CHAPTER 4 CORRECTED PROBLEMS The following list identifies and describes the problems that have been solved since the release 3.01.00 of the VS COBOL 85 compiler. To review problems corrected prior to this release of the VS COBOL 85 compiler please review the CSRN included in the release of 03.00.11 of the compiler. 4.2 PROBLEMS CORRECTED IN 03.01.05. When optimizing the erroneous Memory Error CBL810 Severity 24 no longer occurs. 4.2 PROBLEMS CORRECTED IN 03.01.04. The @CBLRTF@ file is now accepted as a legal static subroutine library. The problem occured because the linkage data had been erroneously removed in this file. CTS # Description Internal It was discovered that the following code produced an incorrect error message. This has been corrected. 01 DATA-ITEM PIC 9(03) COMP. DISPLAY DATA-ITEM (1). Old error message: CBL497 severity 8 beginning on listing line 15 A figurative constant may not be applied to "DATA-ITEM". New error Message: CBL417 severity 8 beginning on listing line 15 Reverence modification not allowed on "DATA-ITEM". It must have usage display. 4.3 PROBLEMS CORRECTED IN 03.01.03. CTS # Description E142587 The use of the HOLD EXTENSION-RIGHTS no longer causes as PC04 failure. E138011 The ACCEPT DATE4 statement now works for all dates of the month. An error in assigning internal storage was determined to be the problem. 4.4 PROBLEMS CORRECTED IN 03.01.02. CTS # Description E099627 The compiler would fail with a PC04 after an ACCEPT DATE statement with the code received to duplicate the problem. This was due to a stack misalignment which has been corrected. Testing has failed to produce a reoccurance of this problem. 4.5 PROBLEMS CORRECTED IN 03.01.01. CTS # Description E089899 When the compiler generates a PAL assembler instruction Register 1 is updated with the results of the PAL. When Register 1 was previously designated as a base register prior to the PAL the compiler had no way of knowing that Register 1 no longer contained the base address. Now prior to generating a PAL instruction the compiler sets the proper internal switch indicating that the base register must be reestablished after the PAL. Internal When testing the DATE4 function on OS 7.21.09 it was discovered that the 4 digit year being returned did not always contain valid data. Changes have been made to the code generation for the DATE4 function to guarantee that the date will contain zeros in the century digits and that the year will be valid when DATE4 is being used on an operating system prior to 7.52.00. 4.6 PROBLEMS CORRECTED IN 03.01.00. Problem Number Description M410012593 The compiler provides the problem error message when a SELECT statement is missing for a SD specification instead of aborting with a PC04. M800027295 A comparison of a two character string now compares correctly against a 10 character literal. E56656 An extremely large program with an extremely large data section now generates proper code to address the data area properly, hence eliminating aborts with such errors as PC04 and PC07. CHAPTER 5 SPECIAL CONSIDERATIONS AND CONDITIONS 5.1 YEAR 2000 SPECIAL CONSIDERATIONS Versions 3.01.00 and up of the COBOL85 compiler and the object code it creates must be run on a VS Operating System version 7.52.00 or greater to have full YEAR 2000 support and take advantage of the new DATE4 keyword documented further in this document. 5.2 SPECIAL CONSIDERATIONS When you specify SYMB = NEW on the compiler's OPTIONS screen, the compiler generates debugger information about PERFORM statements. This debugger information allows Version 1.05.04 or greater of the Debugger to produce a list of all active PERFORMs at any point in the executing program. Note: Do not specify SYMB = NEW if there is a possibility that the compiled program will be debugged on a system with a version of the Debugger lower than Version 1.05.04. Lower versions will issue an internal error and will not allow debugging to continue. (Version 1.05.04 of the Debugger requires OS Version 7.21 or greater.) The default value for the COMPAT74 (High VS 74 Compatibility) option has been set to IO (COMPAT74 = IO) in this release. This setting allows the compiler to generate much smaller and faster code for IO statements. However, if your current programs depend on ANSI COBOL 85 functionality that is not present in COBOL 74 (such as the setting of ANSI file status codes), you should use the SETOPTS utility to change this option back to NO (COMPAT74 = NO). For a description of the differences between the two settings, refer to the Migration Guide or the COBOL 85 compiler help text (press PF 13 on the compiler OPTIONS screen). 5.3 SPECIAL CONDITIONS Optimization (compiler option OPT = YES, ALL, 1 or 2) will not be performed if TIMEOUT or DEADLOCK processing is present. CHAPTER 6 MEDIA CONTENTS The enclosed media contain four libraries (CSRNLIB, CBLPROG, @SYSTEM@, and @DOCLIB@), whose contents are described as follows. LIBRARY = CSRNLIB Protection File Name Version Class Description C8530105 03.01.05 $ CSRN in DP Print File format LIBRARY = CBLPROG Protection File Name Version Class Description @CBLRTF@ 03.01.05 $ Runtime Subroutine Library C85FORM 000046 $ Form file for the compiler C85PROC @ Procedure that sets compiler options in PACE COB85OPT 02.10.01 @ COBOL 85 help text COBOL85 03.01.05 @ COBOL 85 compiler FIM 01.03.00 @ Forms index manager INSTALL 03.01.05 @ Installation procedure SETOPTS 01.00.13 @ SETOPTS utility SETOPTSF 000035 @ SETOPTS form file TOPIM 01.00.02 @ Topic Index Manager TOPLIBM @ Topic Library Manager Protection File Name Version Class Description WC3GTLB 03.01.05 $ Runtime library file WLKOPT 03.01.05 @ COBOL 85 optimizer WRKACOS 03.01.05 $ Runtime library file WRKASIN 03.01.05 $ Runtime library file WRKATAN 03.01.05 $ Runtime library file WRKCALID 03.01.05 $ Runtime library file WRKCHR 03.01.05 $ Runtime library file WRKCOS 03.01.05 $ Runtime library file WRKCRDT 03.01.05 $ Runtime library file WRKDANR 03.01.05 $ Runtime library file WRKDEDIT 03.01.05 $ Runtime library file WRKDSPLY 03.01.05 $ Runtime library file WRKDTIT 03.01.05 $ Runtime library file WRKDVPL 03.01.05 $ Runtime library file WRKDYIT 03.01.05 $ Runtime library file WRKDYWK 03.01.05 $ Runtime library file WRKIDXC 03.01.05 $ Runtime library file WRKITDT 03.01.05 $ Runtime library file WRKITDY 03.01.05 $ Runtime library file WRKLFD 03.01.05 $ Runtime library file WRKLOG 03.01.05 $ Runtime library file WRKLOG10 03.01.05 $ Runtime library file WRKLOWR 03.01.05 $ Runtime library file WRKMTPL 03.01.05 $ Runtime library file WRKNMV 03.01.05 $ Runtime library file Protection File Name Version Class Description WRKNMVC 03.01.05 $ Runtime library file WRKORD 03.01.05 $ Runtime library file WRKPOWER 03.01.05 $ Runtime library file WRKRAND 03.01.05 $ Runtime library file WRKRVRS 03.01.05 $ Runtime library file WRKSBCK 03.01.05 $ Runtime library file WRKSIN 03.01.05 $ Runtime library file WRKSOME 03.01.05 $ Runtime library file WRKSQRT 03.01.05 $ Runtime library file WRKSTCK 03.01.05 $ Runtime library file WRKSWITC 03.01.05 $ Runtime library file WRKTAN 03.01.05 $ Runtime library file WRKUPPR 03.01.05 $ Runtime library file LIBRARY = @SYSTEM@ Protection File Name Version Class Description C74TOC85 Blank COBOL 74 to COBOL 85 Text Change File CVTEXT 01.00.01 @ CVTEXT utility LIBRARY = @DOCLIB@ Protection File Name Version Class Description WI7HELP 01.00.00 $ CVTEXT Help Text CHAPTER 7 INSTALLATION The INSTALL procedure copies onto your system the COBOL85 compiler file, optimizer, form file, help text, and runtime library. To install VS COBOL 85, follow these steps: 1. Run the BACKUP utility and restore library CBLPROG. (Note that you must use BACKUP with RESTORE since CBLPROG may span installation media.) 2. Make sure the compiler is not currently in use on your system and is not specified as permanently open by the FASTLINK utility. If your installation uses FASTLINK, run FASTLINK and remove the COBOL85 compiler entry from the list of open files. 3. Run the restored installation procedure INSTALL. The INSTALL procedure allows you to specify the names of the volume and library on which you want the compiler installed and the name of the volume on which you want the runtime library @CBLRTM@ installed. When making these specifications, keep the following information in mind: o The installation procedure looks for the SETOPTS utility in the compiler's library and in library @SYSTEM@ on your system volume. If it does not find the utility in either of these libraries, INSTALL copies both SETOPTS and its form file (SETOPTSF) to the compiler's library. o If you install the compiler runtime library (@CBLRTM@) on any volume other than your system volume, the installation procedure runs SETOPTS to update the LINKVOL option on the compiler's OPTIONS screen. o The installation procedure copies the compiler's help text file (COB85OPT) to library @DOCLIB@ on your system volume. To update the topics index file, @TOPICS@ (located in library @DOCLIB@), INSTALL then runs TOPIM (contained on the distribution volume), which enters the names of the compiler help text (COBOL85 Help Text) and the compiler's help text file (COB85OPT). o The installation procedure copies the compiler's form file (C85FORM) to the compiler's library unless the compiler's library is @SYSTEM@ on your system volume. In this case, INSTALL copies the form file to library @SYSFRM@ on your system volume. To update the forms index file, @FORMS@ (located in library @SYSFRM@), INSTALL then runs FIM (contained on the distribution volume), which enters the names of the compiler (COBOL85) and the compiler's form file (C85FORM). Note: The COBOL 85 compiler's form file (C85FORM) must not reside in @SYSTEM@ on your system volume. If an old compiler form file resides on your system volume, the installation procedure gives you the option of deleting it. For information about C85FORM, see the compiler's help text. To install C74TOC85, CVTEXT, and WI7HELP, follow these steps: 1. Log on as a security administrator. 2. Run the BACKUP utility and restore the CVTEXT and C74TOC85 files from the enclosed media to library @SYSTEM@ on your IPL volume. 3. Restore the WI7HELP file from the enclosed media to library @DOCLIB@ on your IPL VOLUME. 4. Run VS INFO to regenerate the topic directory so that it includes the CVTEXT help text. (For information about VS INFO, refer to the VS INFO User's Guide.)