Software Release Notice for VS PACE COBOL HLI PREPROCESSOR Version 07.54.00 March 2000 DISCLAIMER OF WARRANTIES AND LIMITATION OF LIABILITIES The staff of Getronics has taken due care in preparing this manual; however, nothing contained herein modifies or alters in any way the standard terms and conditions of the Getronics purchase, lease, or license agreement by which this software package was acquired, nor shall Getronics 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 Getronics Program Products are licensed to customers in accordance with the terms and conditions of the Getronics Standard Program Products License; no ownership of Getronics Software is transferred and any use beyond the terms of the aforesaid License, without the written authorization of Getronics is prohibited. 1.0 Release Abstract The WANG VS PACE COBOL Host Language Interface Preprocessor permits procedural access to the PACE Relational Database Management System. By imbedding special HLI statements in a WANG VS COBOL program, it is possible to use the PACE product to manage databases from within a COBOL program. 2.0 Prerequisites and Dependencies 2.1 Hardware Prerequisites This COBOL HLI Preprocessor may be installed and run on any VS configuration that has a floppy and a disk drive, and is capable of supporting segments 1 and 2 of at least 1500K bytes. 2.2 Software Prerequisites This COBOL HLI Preprocessor may be run under an operating system on which the PACE Database Management System version 2.20.00 or above is installed, and to which all the restrictions thereby imposed must be adhered. In particular, a currently support Operating System should be used. If there is concern in this area please refer to your Wang Support Center. This COBOL HLI Preprocessor may be run using released versions 7.52.00 and above of the Wang VS COBOL 74 Compiler. Any/all restrictions imposed by your particular version of COBOL must be adhered to. This COBOL HLI Preprocessor may be run using released versions 2.12.00 and above of the Wang VS COBOL 85 Compiler. Any/all restrictions imposed by your particular version of COBOL 85 must be adhered to. 3.0 Restrictions and Special Considerations 1. There are no year 2000 dependencies for this product. 2. COBOL programs that contain embedded HLI entries must be compiled and run on a system that has PACE version 2.20.00 or above installed. A database used in such program must be created using the PACE Definition Facility prior to compilation. 3. All restrictions pertaining to the release version of the WANG VS COBOL Compiler used to compile your COBOL program containing embedded HLI entries must be adhered to. 4. Several components of the COBOL HLI Preprocessor are implemented using arrays. This necessarily implies certain fixed limits which cannot be aleviated by simple increase of data storage available for the compilation but require change in the Preprocessor itself in order to increase them. Some of the limits are listed below: Max number of databases used in a program 5 Max number of tables COPYed without a database declaration 50 Max number of fields in a table 600 Max number of table fields referenced in a WHERE clause 30 Max number of host variables referenced in a WHERE clause 60 Max number of table fields referenced in an ORDER BY clause 8 Max number of different names declared in HLI entries 8,000 Max characters in all these different names 128,000 Max chars in a name of table, field, screen, operation 30 Max chars in a prefix in PREFIXED BY clause of COPY FIELDS 25 Max number of VALUE OF clauses in OBTAIN or SET DB-STATUS 10 Max number of fields in INVALID clause of SET DB-STATUS 5 Other array imposed fixed limits exist but not listed here because their arrays serve inner implementational purposes which are not feasible to document in external documentation. It is expected that all these fixed limits still allow sufficient room for compilation of a manageable sized program. When, however, this happens not to be the case, a Design Change Request should be submitted. 5. The obsolete feature CALLING clause in DECLARE CURSOR statement is not supported. Even though it may still work with COBOL 74, it is guaranteed not to work with COBOL 85. 4.0 Enhancements (since Release 05.20.00) 1. When a COBOL HLI Program needs to COPY FIELDS OF TABLE X where the table X contains a field which is also named X, a disambiguation problem exists. According to COBOL rules, an aggregate object containing an element with identical name is always ambiguous and any reference to such objects must be flagged. And indeed, when you say X ON MY-DATABASE, do you mean table X or field X? However, the COBOL HLI programmer sometimes has no choice but to use such tables which were possibly created by others and cannot be changed. To accommodate such situations, the disambiguation rule is relaxed for tables and their fields. From now on: X OF X - means field X of table X X - means table X. Note that the relaxation applies ONLY to tables and their fields. Field X in buffer X, etc, are still ALWAYS AMBIGUOUS in accordance with COBOL rules. 5.0 Problems Reported Since Release 5.20.00 5.1 PTRs Corrected in Version 5.20.02 PTR Number Description P100013458 User makes COPY FIELD OF TABLE X where table X contains a field with the same name X. A statement DECLARE CCC CURSOR FOR SELECT FROM X is flagged as an ambiguous reference. See Enhancements. P400008063 In a very large program, with many tables COPied in, a reference to a cursor X was flagged with error message H035 "Expecting cursor but found X". 5.2 PTRs Corrected in Version 5.20.03 PTR Number Description P100018306 Precompilation aborted with DMS error "Invalid Address supplied to CLOSE SVC". P900004734 Precompiler did not recognize Cobol 85 reserved word WHEN. 5.3 CTS Problems Corrected in Version 5.20.03 CTS Number Description E075499 The number of elements you can "OR" in a #DECLARE statement is no longer restricted to 60. It now matches the number allowed by ABQRY which is 254 elements. 5.4 CTS Problems Corrected in Version 7.54.00 CTS Number Description E139087 The Date and Time as shown on the PREPROCESSING STARTED line is now correct. 6.0 Known Anomalies (None) 7.0 Media Contents Volume = COBHLI Library = COBOLHLI Module Version Description WCHP220 07.54.00 PACE Host Language Interface Volume = COBHLI Library = CSRNLIB Module Description HLI75400 CSRN 8.0 Installation Instructions Use the COPY utility to move the library COBOLHLI, containing one file, from the accompanying dual density floppy diskette whose volume label is COBHLI to the library in which your COBOL Compiler is installed.