Compaq Software Product Description ___________________________________________________________________ PRODUCT NAME: Compaq COBOL Version 5.7A for OpenVMS VAX SPD 25.04.33 DESCRIPTION Compaq COBOL for OpenVMS VAX, formerly known as VAX COBOL and DIGI- TAL VAX COBOL, is a high-level language for business data processing that operates on the OpenVMS VAX Operating System, taking full advan- tage of the system facilities. Compaq COBOL is based upon the 1985 ANSI COBOL Standard X3.23-1985 as modified by the X.23a-1989 amendment. Compaq COBOL adheres to the high level by the National Bureau of Stan- dards for conformance to FIPS PUB 21-3, Federal Standard COBOL. The Compaq COBOL Data Manipulation Language (DML), which is based upon the report of the CODASYL Data Description Language Committee (1978), allows users to write programs that access databases using the Oracle DBMS database management system. Oracle DBMS must be installed to use this feature. Compaq COBOL includes various extensions to COBOL, including screen handling at the source language level, file sharing, and record lock- ing. Compaq COBOL Version 5.7A for OpenVMS VAX is a documentation update release. The software product remains unchanged since the Compaq COBOL V5.7 release. The documentation set has been unified for Compaq COBOL on VAX and Alpha Systems. For recent release specific technical in- formation, such as feature enhancements, bug fixes, restrictions and compatibility charts, please refer to the Compaq COBOL V5.7 Release Notes. November 2002 The following list of extensions to COBOL are implemented in Compaq COBOL for OpenVMS VAX: o Screen handling is implemented using the DISPLAY and ACCEPT state- ments. The DISPLAY statement enables the programmer to display in- formation or prompts anywhere on a video screen. The ACCEPT state- ment takes information typed anywhere on the screen and returns the value to a running Compaq COBOL program. The DISPLAY statement con- verts data from internal numeric format to ASCII display format, and the ACCEPT WITH CONVERSION statement converts ASCII display in- put characters to internal numeric formats as appropriate. The terminal- type is recognized at run time from information provided by the op- erating system. o Many file capabilities are available through RMS including exten- sions for segmented keys, descending keys, and duplicate primary keys. o RMS-STS and RMS-STV and RMS-FILENAME special registers may be ex- amined to assist debugging. These registers contain status values from the Record Management System (RMS) for OpenVMS. o File sharing and record locking features enable more than one user to access data at the same time. o Conditional compilation serves to make debugging easier. o The /INSTRUCTION_SET qualifier customizes object code generation to target the different classes of VAX processors, maximizing spe- cific processor features. o The COPY FROM DICTIONARY statement allows access to common record definitions stored in the Oracle CDD/Repository. Oracle CDD/Repository must be installed to use this feature. o Terminal format recognition for program source files. o Four-digit year-date support in ACCEPT format 2. o Automatic compile-time access to SYS$CURRENCY system logical when CURRENCY SIGN clause not specified in user program. 2 Compaq COBOL for OpenVMS VAX implements several statements and exten- sions designed to make programming easier in the OpenVMS for VAX en- vironment: o CALL statement extensions: BY VALUE, BY DESCRIPTOR, OMITTED, and GIVING o VALUE IS EXTERNAL - Access to link time constants o USAGE IS POINTER - Address data type o VALUE IS REFERENCE - Compile time address evaluation o SET TO REFERENCE - Run time address evaluation o SUCCESS/FAILURE - Class conditions o Thirty-one-character user-names o ACCEPT AT END statement o Single-quote-delimited, non-numeric literals o Hyphen/underscore equivalence in user-names o Non-numeric literal argument passing The Compaq COBOL compiler produces an object module from a source pro- gram. The compiler is capable of producing a source listing with em- bedded diagnostics including the line and column position in source- code, a machine language listing, a file-name map, a data-name map, a procedure-name map, an external program name map, database subschema information, and a cross-reference listing. The cross-reference list- ing and maps may be produced in either alphabetical order, or in or- der of declaration. The cross-reference listing distinguishes updat- ing references to data from read-only references. Compaq COBOL for OpenVMS VAX provides support for error diagnostics and cross-reference information to Language-Sensitive Editor/Source Code Analyzer. Additionally, Compaq COBOL for OpenVMS VAX provides sup- port for the processing of pseudocode and design comments that are used by the Compaq Language-Sensitive Editor/Source Code Analyzer for low- level program design. 3 Object modules produced by the compiler can be linked with other ob- ject modules produced by many other OpenVMS VAX languages, including Compaq's BASIC and Fortran. Compaq COBOL for OpenVMS VAX is supported by both the OpenVMS VAX Common Run Time Library (RTL) and the Symbolic Debugger for OpenVMS VAX. The Compaq COBOL for OpenVMS VAX product includes a COBOL compiler and the REFORMAT utility. The REFORMAT utility converts source programs from DIGITAL terminal format to ANSI-standard COBOL format and vice versa. HARDWARE REQUIREMENTS Any VAX system that is capable of running OpenVMS VAX V6.2 or higher. Disk Space Requirements (Block Cluster Size = 1) Disk space required 12,000 blocks during installation: (6.3 Mbytes) Disk space required for 4,000 blocks use (permanent): (2.0 Mbytes) These counts refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. OPTIONAL HARDWARE A VT100 family, VT200 family, VT300 family, or VT400 family terminal is required for the screen handling extensions to the ACCEPT and DIS- PLAY statements. 4 SOFTWARE REQUIREMENTS OpenVMS VAX Operating System Version 6.2-Version 7.3 (SPD 25.01.xx) SOFTWARE LICENSING This software is furnished only under a license. For more information about licensing terms and policies of Compaq, contact your local Com- paq office. License Management Facility Support This layered product supports the OpenVMS License Management Facil- ity. License units for this product are allocated on an Unlimited Sys- tem Use and Personal and Concurrent Use basis. Each Concurrent Use license allows any one individual at a time to use the layered product. Each Personal Use license allows one identified individual to use the layered product. For more information on the License Management Facility, refer to the OpenVMS Operating System for VAX and Alpha Software Product Descrip- tion (SPD 25.01.xx) or the OpenVMS Alpha Operating System documenta- tion. CLUSTER ENVIRONMENT This layered product is fully supported when installed on any valid and licensed OpenVMS Cluster configuration without restrictions. The HARDWARE REQUIREMENTS section of this product's Software Product De- scription detail any special hardware required by this product. OpenVMS Cluster configurations are fully described in the Compaq OpenVMS Cluster Software Product Description (SPD 29.78.xx) and include CI, Ethernet, DSSI, FDDI, SCSI, and Mixed Interconnect configurations. OpenVMS Tailoring: For OpenVMS VAX systems, the following OpenVMS classes are required for the full use of the features of this layered product: 5 o OpenVMS Required Save Set o Programming Support For more information on OpenVMS classes and tailoring, refer to the OpenVMS Operating System for VAX and Alpha Software Product Descrip- tion (SPD 25.01.xx). OPTIONAL SOFTWARE In order to use the following Compaq COBOL for OpenVMS VAX features, the use of the Compaq Language-Sensitive Editor/Source Code Analyzer is required: o /DESIGN qualifier o /ANALYSIS_DATA qualifier o Compaq Language-Sensitive Editor component Note: The Compaq Language-Sensitive Editor/Source Code Analyzer is avail- able separately or in Compaq DECset. Please refer to SPD 27.07.xx for ordering information. Compaq COBOL for OpenVMS VAX Data Manipulation Language Features Require: o Oracle CODASYL DBMS o Oracle CDD/Repository Compaq COBOL for OpenVMS VAX COPY FROM DICTIONARY Feature Requires: o Oracle CDD/Repository 6 GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the current version. DISTRIBUTION MEDIA The software binaries and documentation are available on various CD-ROM distributions: o OpenVMS VAX Software Layered Products Library-This offering includes the OpenVMS VAX Layered Product software binaries. (QA-5FW8A-A8) o OpenVMS VAX Online Documentation Library-This offering includes the documentation for the OpenVMS VAX Layered Products. (QA-VYR8A-G8) o OpenVMS VAX Software Layered Products Library Package - This of- fering contains both the software binaries and documentation for the OpenVMS VAX Layered Products. (QA-5G88A-H8) SOFTWARE WARRANTY This software is provided by Compaq with a 90 day conformance warranty in accordance with Compaq warranty terms applicable to the license pur- chase. ORDERING INFORMATION Compaq COBOL for OpenVMS VAX Systems Software Licenses: QL-099A*-** Software Documentation (Hard Copy): QA-099AA-GZ Software Product Services: QT-099A*-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. 7 SOFTWARE PRODUCT SERVICES A variety of service options are available from Compaq. For more in- formation, contact your local Compaq office. The previous information is valid at time of release. Please contact your local Compaq office for the most up-to-date information. © 2002 Compaq Information Technologies Group, L.P. The Compaq logo, AlphaServer, OpenVMS, and VAX are trademarks of Com- paq Information Technologies Group, L.P. in the U.S. and/or other coun- tries. UNIX and X/Open are registered trademarks of The Open Group in the United States and other countries. All other product names men- tioned herein may be trademarks of their respective companies. Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Tech- nical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. None of Compaq, Hewlett-Packard Company ("HP") or any other direct or indirect subsidiary of HP shall be liable for technical or editorial errors or omissions contained herein. The information in this docu- ment is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq or HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an ad- ditional warranty. 8