DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: VAX COBOL Version 5.4 for OpenVMS VAX Systems SPD 25.04.28 DESCRIPTION VAX COBOL is a high-level language for business data processing that operates on the OpenVMS VAX Operating System, taking full advantage of the system facilities. VAX COBOL is based upon the 1985 ANSI COBOL Standard X3.23-1985 as modified by the X.23a-1989 amendment. VAX COBOL has been validated at the high level by the National Bureau of Standards for conformance to 'FIPS PUB 21-3, Federal Standard COBOL'. The VAX 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. VAX COBOL includes various DIGITAL extensions to COBOL, including screen handling at the source language level, file sharing and record lock- ing. The following list of DIGITAL extensions to COBOL are implemented in VAX COBOL: 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 VAX 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' February 1997 input characters to internal numeric formats as appropriate. The terminal-type is recognized at run time from information provided by the operating 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 (OpenVMS RMS). 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. VAX COBOL implements several statements and extensions designed to make programming easier in the OpenVMS for VAX environment: 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 2 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 VAX 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. VAX COBOL provides support for error diagnostics and cross-reference information to DEC Language-Sensitive Editor/Source Code Analyzer. Ad- ditionally, VAX COBOL provides support for the processing of pseudocode and design comments that are used by the DEC Language-Sensitive Ed- itor/Source Code Analyzer for low-level program design. Object modules produced by the compiler can be linked with other ob- ject modules produced by many other OpenVMS VAX languages, including VAX BASIC and DEC Fortran. VAX COBOL is supported by both the Open- VMS VAX Common Run Time Library (RTL) and the Symbolic Debugger for OpenVMS VAX. The VAX COBOL product includes a COBOL compiler and the REFORMAT util- ity. The REFORMAT utility converts source programs from DIGITAL ter- minal format to ANSI-standard COBOL format and vice versa. HARDWARE REQUIREMENTS 3 Processors Supported: VAXft: VAXft 3000 Model 110 VAXft 3000 Model 310 VAXft 3000 Model 410 VAXft 3000 Model 610 VAXft 3000 Model 612 VAX: VAX 4000 Model 50 VAX 4000 Model 100, 100A, 105A VAX 4000 Model 200 VAX 4000 Model 300 VAX 4000 Model 500, 500A, 505A VAX 4000 Model 600, 600A VAX 4000 Model 700A, 705A VAX 6000 Model 210, 220, 230, 240 VAX 6000 Model 310, 320, 330, 340, 360 VAX 6000 Model 400, 410, 420, 430, 440, 450, 460 VAX 6000 Model 510, 520, 530, 540, 550, 560 VAX 6000 Model 600, 610, 620, 630, 640, 650, 660 VAX 7000 Model 610, 620, 630, 640, 650, 660 VAX 7000 Model 710, 720, 730, 740, 750, 760 VAX 8200, VAX 8250 VAX 8300, VAX 8350 VAX 8500, VAX 8530, VAX 8550 VAX 8600, VAX 8650 VAX 8700 VAX 8800, VAX 8810, VAX 8820, VAX 8830, VAX 8840 VAX 9000 Model 110, 110VP VAX 9000 Model 210, 210VP VAX 9000 Model 310, 310VP 4 VAX 9000 Model 320, 320VP VAX 9000 Model 330, 330VP VAX 9000 Model 340, 340VP VAX 9000 Model 410, 410VP VAX 9000 Model 420, 420VP VAX 9000 Model 430, 430VP VAX 9000 Model 440, 440VP VAX 10000 Model 610, 620, 630, 640, 650, 660 VAX-11/730, VAX-11/750 VAX-11/780, VAX-11/785 MicroVAX: MicroVAX II MicroVAX 2000 MicroVAX 3100 Model 10/10E, 20/20E, 30, 40, MicroVAX 3100 Model 80, 85, 90, 95, 96 MicroVAX 3200, MicroVAX 3300 MicroVAX 3400, MicroVAX 3500 MicroVAX 3600, MicroVAX 3800 MicroVAX 3900 VAXstation: VAXstation II/GPX, VAXstation II/QVSS VAXstation 2000/GPX, VAXstation 2000/MFB VAXstation 3100/GPX Model 38, 48, 76 VAXstation 3100/SPX Model 38, 48, 76 VAXstation 3100 Model 30, 38, 40, 48, 76 VAXstation 3200 VAXstation 3500, VAXstation 3520 VAXstation 3540 VAXstation 4000 Model 60, 90, 95, 96, VLC 5 VAXserver: VAXserver 3100 Model 10, 10E, 20, 20E VAXserver 3200, 3300, 3400 VAXserver 3500, 3600, 3800, 3900 VAXserver 4000 Model 200, 300, 400, 500, 600 VAXserver 6000 Model 210, 220 VAXserver 6000 Model 310, 320 VAXserver 6000 Model 410, 420 VAXserver 6000 Model 510, 520 VAXserver 8200, 8250 VAXserver 8300, 8350 VAXserver 8530, 8550 VAXserver 8600, 8650 VAXserver 8700 VAXserver 8800, 8810, 8820, 8830, 8840 Processors Not Supported: MicroVAX I VAXstation I VAXstation 8000 VAX-11/725 VAX-11/782 Processor Restrictions A TK50 Tape Drive is required for standalone MicroVAX 2000 and VAXs- tation 2000 systems. Disk Space Requirements (Block Cluster Size = 1) Disk space required 12,000 blocks during installation: (6.3 Mbytes) 6 Disk space required for 3,000 blocks use (permanent): (1.6 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. CLUSTER ENVIRONMENT This layered product is fully supported when installed on any valid and licensed VAXcluster* configuration without restrictions. The HARD- WARE REQUIREMENTS section of this product's Software Product Descrip- tion detail any special hardware required by this product. * VAXcluster configurations are fully described in the OpenVMS Clus- ter Software Product Description (SPD 29.78.xx) and include CI, Eth- ernet, and Mixed Interconnect configurations. SOFTWARE REQUIREMENTS For Systems Using Terminals (No DECwindows Interface): o OpenVMS VAX Operating System Version 6.1-Version 7.0 For Workstations Using VWS: o OpenVMS VAX Operating System Version 6.1-Version 7.0 o VMS Workstation Software Version 4.4-Version 4.5 7 For Workstations Using DECwindows: o OpenVMS VAX Operating System Version 6.1-Version 7.0 This product may run in either of the following ways: o Stand-Alone Execution - Running the X11 display server and the client application on the same machine. o Remote Execution - Running the X11 display server and the client application on different machines. OpenVMS Tailoring: For OpenVMS VAX systems, the following OpenVMS classes are required for full use of features of this layered product: 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 VAX COBOL features, the use of DEC Language- Sensitive Editor/Source Code Analyzer Version 4.3 - 4.4 is required: o /DESIGN qualifier o /ANALYSIS_DATA qualifier o VAX Language-Sensitive Editor component Note: The DEC Language-Sensitive Editor/Source Code Analyzer is avail- able separately or in DECset. Please refer to SPD 27.07.xx for order- ing information. 8 VAX COBOL Data Manipulation Language Features Require: o Oracle CODASYL DBMS o Oracle CDD/Repository VAX COBOL COPY FROM DICTIONARY Feature Requires: o Oracle CDD/Repository VAX COBOL Vertical Forms Printing Features Require: o OpenVMS VAX Operating System Version 6.1-Version 7.0 o Vertical Forms Printing OpenVMS VAX Version 1.0 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 Nine-track 1600 BPI Magtape, TK50 Streaming Tape This product is also available as part of the OpenVMS Consolidated Soft- ware Distribution on CD-ROM. ORDERING INFORMATION Software Licenses: QL-099A*-** Software Media: QA-099A*-** Software Documentation: QA-099AA-GZ Software Product Services: QT-099A*-** 9 * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. SOFTWARE LICENSING This software is furnished only under a license. For more information about licensing terms and policies of DIGITAL, contact your local DIG- ITAL 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 System Use and Personal and Conncurrent 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 License Management Facility manual of the OpenVMS Operating System documentation set. SOFTWARE PRODUCT SERVICES A variety of service options are available from DIGITAL. For more in- formation, contact your local DIGITAL office. SOFTWARE WARRANTY Warranty for this software product is provided by DIGITAL with the pur- chase of a license for the product. This means that DIGITAL will rem- edy any nonconformance when it is reported to DIGITAL by the customer during the warranty period. 10 The warranty period is one year. It begins when the software is in- stalled or thirty days after delivery to the end user, whichever oc- curs first and expires one year later. All warranty related support for this software will end one year after release of the subsequent versions. Warranty is provided in the country of purchase. DIGITAL will provide a service location which will accept reporting (in format prescribed by DIGITAL) of a nonconformance problem caused when using the licensed software under normal condtions as defined by this SPD. DIGITAL will remedy a nonconformance problem in the current unaltered release of the licensed software by issuing a correction information such as: cor- rection documentation, corrected code; or a notice of availability of corrected code; or a restriction or a bypass. The customer will be re- sponsible for the preparation and submission of the problem report to the service location. WARRANTY EXCLUSION DIGITAL does not warrant that the software licensed to customer shall be error free, that the software shall operate with any hardware and software other than as specified in this SPD, that the software shall satisfy customer's own specific requirements, or that copies of the software other than those provided or authorized by DIGITAL shall con- form to the SPD. DIGITAL makes no warranties with respect to the fitness and operabil- ity of modifications not made by DIGITAL. If the software fails to function for reasons stated above, the cus- tomer's warrranty will be invalidated and all service calls will be billable at the prevailing per call rates. This Software Warranty is effective for licensed software products or- dered in the United States after October 1988 and supersedes all prior versions. The above information is valid at time of release. Please contract your local DIGITAL office for the most up-to-date information. 11 [TM] CI, DECset, DECwindows, DIGITAL, MicroVAX, OpenVMS, TK, VAX, VAXcluster, VAXft, VAXserver, VAXstation, VAX BASIC, VAX COBOL, DEC Fortan, OpenVMS RMS, VMS, VT100, VT220, VT300, VT400 and the DIGITAL Logo, are trademarks of Digital Equip- ment Corporation. [TM] Oracle is a registered trademark and Oracle CODASYL DBMS, Oracle CDD/Repository are trademarks of Oracle Corporation. © 1997 Digital Equipment Corporation. All Rights Reserved. 12