DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: DEC Ada Version 3.4 for OpenVMS Alpha Systems SPD 45.00.04 DESCRIPTION This Software Product Description includes the following two products: o DEC Ada Version 3.4 for OpenVMS Alpha Systems o DEC Ada Version 3.4 Professional Development Option for OpenVMS Alpha Systems DEC Ada for OpenVMS Alpha is Digital Equipment Corporation's validated implementation of the full ANSI/MIL-STD-1815A-1983 Ada Language. As a result of meeting the ANSI standard, DEC Ada also conforms to the Federal Information Processing Standard (FIPS-119). The DEC Ada com- piler runs on the OpenVMS Operating System and generates optimized, shareable, and position-independent code. As a native mode OpenVMS Alpha language, DEC Ada is integrated into the OpenVMS Alpha common language environment. All OpenVMS Alpha sys- tem services and utilities are available to programs written in DEC Ada. DEC Ada supports the OpenVMS Alpha Record Management Services (RMS) sequential, relative, and indexed file organizations and associated access methods. DEC Ada programs can invoke modules written in other OpenVMS languages. Additionally, programs written in other languages can invoke DEC Ada modules. Ada is a powerful, general-purpose language that supports many mod- ern programming practices. The language was designed as the result of a competition sponsored by the United States Department of Defense. The purpose of the competition was to define a language suitable for programming-embedded computer systems. Among the requirements for the November 1997 language were features that would reduce software costs by increas- ing maintainability, evolvability, reliability, and portability. Ada provides a modular structure for programs by allowing separate com- pilation of program units, as well as providing strong typing, tasking, exception handling, and other standard language features that must be supported across implementations. Ada provides a number of features from general systems to real-time applications. Ada Language Features o Strong Typing - An object (variable) of a given type may take on only those values that are appropriate to that type, and only cer- tain predefined operations may be performed on data of that type. Because type checking is done at compile time, strong typing en- sures that any errors associated with incorrect data types are de- tected at compile time. o Data Abstraction - Also known as information hiding, data abstraction hides implementation details while providing users with mechanisms for using the implementation. Abstraction allows the user to focus on important characteristics while ignoring underlying details. Ada provides various levels of abstraction through features such as private data types and packages. o Concurrent Processing - For many applications, it is important that a program be conceived of as a number of parallel, rather than serial activities. Most high-order languages provide little or no support for handling such parallel or concurrent activities. They rely on facilities of the host operating system. Ada uses tasks to allow parallel activities to be programmed directly within the language. o Separate Compilation - Ada's separate compilation feature allows a programmer to divide a large program into compilation units that may be compiled at different times. When a unit is compiled, the Ada program library manager records information about that unit and other related units. This feature is unlike separate compilation features in other languages, where little information about sep- arately compiled modules is maintained. 2 o Generic Definitions - A generic unit is a template from which spe- cific instances can be made at compile time. In many cases, the logic of an algorithm or a set of operations is independent of the spe- cific type of the values being manipulated. However, in a strongly typed language such as Ada, all types must be defined at compile time. Generic definitions let the user to define a general algorithm or set of related operations and then create a specific instance of that algorithm or set of operations for each type to which the algorithm or operations must apply. o Exception Handling - In many operations, especially embedded com- puter systems, it is critical that a system be able to recover quickly and efficiently from error conditions. Ada provides the ability to raise and handle exceptions. It includes predefined exceptions and also permits the user to define exceptions. When an exception occurs in an Ada program, normal processing is abandoned and control passes to the exception handler. DEC Ada Components and Special System-Related Features: o Ada compiler fully conforming to ANSI/MIL-STD-1815A-1983. For de- tails see the DEC Ada Language Reference Manual. o Ada program library manager that provides support for programming teams through: - Program libraries that can be shared by many programmers - A powerful search list model for program libraries. This per- mits the following: * The relationships among program libraries can be changed eas- ily. * Individual programmers can establish different views of pro- gram library relationships - Automatic recompilation of obsolete compilation units - The ability to share compiled Ada code either by reference or copy 3 o DEC Ada supports passive tasking and pragma PASSIVE which can significantly improve the performance of rendezvous in programs. A task rendezvous (consisting of an entry call to a passive task) is accomplished with no context switching overhead. Instead, the accept body is executed in the context of the task mak- ing the entry call. o Strongly-typed DEC Ada bindings that provide interfaces for the fol- lowing versions of X Windows Toolkit and X Window Systems[TM] and Motif® routines: - X Window System Version 11R4 and Motif Version 1.1.3 - X Window System Version 11R5 and Motif Version 1.2 o DEC Ada implements AI-00866, which permits an 8-bit character set based on ISO standard 8859/1 (commonly known as Latin-1). o Support for the ISO Math Library packages GENERIC_PRIMITIVE_FUNCTIONS and GENERIC_ELEMENTARY_FUNCTIONS. o Support for 64-bit integers and floating point numbers. o Debugging capability provided through the OpenVMS Debugger. High- level, fully symbolic debugging including support for debugging task- ing programs, packages and mixed DEC Ada and non-Ada code. o Integration with OpenVMS Alpha Operating System including: - Conformance to the OpenVMS Calling Standard, which allows Ada code to call and be called by code written in other languages, as well as to call OpenVMS system services and the OpenVMS Run- Time Library - The ability to call OpenVMS Record Management Services (RMS) rou- tines directly - Full access to relative and indexed file capabilities - The ability to handle exceptions from non-Ada code and gener- ate exceptions to be handled by non-Ada code 4 - The ability to handle OpenVMS asynchronous system traps (ASTs) - The ability to link with shared images and use shared global sec- tions - The ability to share data with non-Ada code through global vari- ables and psects (common blocks) o System-Dependent Facilities - Different systems vary in such char- acteristics as the size of storage units, memory size, and the smallest and largest integer values supported. Ada provides the predefined package SYSTEM to define system-related constants and to represent system-dependent information. o DEC Ada provides representation clauses that allow the user to tai- lor the representation of data to suit a particular system. DEC Ada provides: - Length clauses that specify the amount of storage associated with a type - Enumeration representation clauses that specify the internal codes for the literals of enumeration types - Record representation clauses that specify the layout of a record type, such as the order, position, and size of record components - Address clauses that specify required addresses in storage for objects, imported subprograms, or single entries o DEC Ada provides a number of pragmas (compiler directives) that al- low various system-related parameters to be set and changed and that control mixed-language programming. o Comprehensive diagnostic messages with references to the DEC Ada Language Reference Manual. This feature is directed at helping the new DEC Ada user. 5 DEC Ada Professional Development Option for OpenVMS Alpha Systems The DEC Ada Professional Development Option is a separately-licensed option that is available with DEC Ada on OpenVMS Alpha Systems. The DEC Ada Professional Development Option includes the following capabilities: o Smart Recompilation-This feature can significantly reduce the num- ber of recompilations that are needed to rebuild a DEC Ada program after some compilation units change. Smart recompilation enables the compiler to propagate changes quickly through a system, elim- inating up to 100% of the usual recompilations. o Program Library File-Block Caching - This feature uses an in-memory cache of file blocks to minimize the actual amount of disk input- output that must be performed. As a result, the elapsed time for compilations is reduced significantly. o Multilevel Program Library Directory Structure-This feature pro- vides a more efficient program library directory structure to im- prove the performance of access to large program libraries. The DEC Ada Professional Development Option is designed so that it is compatible with libraries that are created without the DEC Ada Pro- fessional Development Option and libraries created with a previous ver- sion of DEC Ada. Once a program library is created, DEC Ada programmers do not need to change any of their development procedures to benefit from the DEC Ada Professional Development Option. HARDWARE REQUIREMENTS Processors Supported: AlphaServer 300 Products AlphaServer 400 Products AlphaServer 1000 Products AlphaServer 1000A Products 6 AlphaServer 2000 Products AlphaServer 2100 Products AlphaServer 2100A Products AlphaServer 2100A LP Products AlphaServer 4000 Products AlphaServer 4100 Products AlphaServer 8200 Products AlphaServer 8400 Products Digital 2100 Server Products AlphaStation 200 Products AlphaStation 250 Products AlphaStation 255 Products AlphaStation 400 Products AlphaStation 500 Products AlphaStation 600 Products DEC 2000 Models 300/500 DEC 3000 Models 300, 300L, 300LX, 300X DEC 3000 Models 400, 400S DEC 3000 Models 500, 500S, 500X DEC 3000 Models 600, 600S DEC 3000 Models 700, 700LX DEC 3000 Models 800, 800S DEC 3000 Models 900, 900LX DEC 4000 Model 600 DEC 4000 Model 700 DEC 7000 Model 600 DEC 10000 Model 600 Disk Space Requirements (Block Cluster Size = 1): 7 Disk space required for 120,000 blocks installation: (62 Mbytes) Disk space required for 65,000 blocks permanent use: (33.5 Mbytes) The installation of DEC Ada V3.4 on top of V3.3 requires: Disk space required for 85,000 blocks installation: (43.8 Mbytes) Disk space required for 9,000 blocks permanent use: (4.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. SOFTWARE REQUIREMENTS DEC Ada for OpenVMS Alpha Systems o OpenVMS Alpha Operating System Version 6.1-Version 7.1 (SPD 25.01.xx) DEC Ada Professional Development Option for OpenVMS Alpha requires both: o DEC Ada Version 3.4 for OpenVMS Alpha Systems o OpenVMS Alpha Operating System Version 6.1-Version 7.1 (SPD 25.01.xx) 8 OPTIONAL SOFTWARE o DECset Release 12.2 for OpenVMS Alpha Systems, which includes: - DIGITAL Language-Sensitive Editor/Source Code Analyzer (LSE/SCA) Version 4.5 for OpenVMS Alpha Systems - DIGITAL Test Manager (DTM) Version 3.8 for OpenVMS Alpha Systems - DIGITAL Performance and Coverage Analyzer (PCA) Version 4.5 for OpenVMS Alpha Systems - DIGITAL Code Management System (CMS) Version 3.9 for OpenVMS Alpha Systems - DIGITAL Module Management System (MMS) Version 3.2 for OpenVMS Alpha Systems For more information on DECset Release 12.2 for OpenVMS Alpha Systems, refer to the Software Product Description (SPD 42.29.xx). GROWTH CONSIDERATIONS The minimum hardware and software requirements for any future version of this product may be different from the requirements for the cur- rent version. Note: A version update represents a complete distribution media replace- ment for the previous release of DEC Ada. All user-developed source modules that comprise an application must be recompiled and rebuilt using only DEC Ada software for that version update. Individual com- ponents of DEC Ada software from the latest version update cannot be used in conjunction with components from a previous version. 9 DISTRIBUTION MEDIA The products described in this SPD are distributed on the OpenVMS Al- pha Software Layered Products Library Package (order number QA-03XAA-H8). Online documentation only is distributed on the OpenVMS Alpha Online Documentation Library (order number QA-4KM8A-G8), and binaries only are distributed on the OpenVMS Alpha Software Layered Products Library (order number QA-4KL8A-A8). These CD-ROMs contain the DEC Ada and DEC Ada Professional Development Op- tion software binaries and online documentation in Bookreader[TM] and POSTSCRIPT® format. The DEC Ada documentation is also available in hard copy, which can be ordered separately (order number QA-09PAA-GZ). ORDERING INFORMATION DEC Ada for OpenVMS Alpha Systems Software Licenses: Personal Use: QL-056AA-2B Concurrent Use: QL-056AA-3* Unlimited System Use: QL-09PA*-** Software Media: QA-03XAA-H8 Software Documentation: QA-09PAA-GZ Software Product Services: QT-09PA*-** DEC Ada Professional Development Option for OpenVMS Alpha Systems Software Licenses: Personal Use: QL-0VQAA-2B Concurrent Use: QL-0VQAA-3B Unlimited System Use: QL-0VRA*-** Software Documentation: QA-0VRAA-GZ Software Product Services: QT-0VRA*-** Note: The Software Documentation kit (order number QA-0VRAA-GZ) contains only the Read Before Installation letter and must be ordered (at no cost) with all licenses for DEC Ada Professional Development Option for OpenVMS Alpha Systems. 10 The DEC Ada Professional Development Option for OpenVMS Alpha Systems binaries are provided with the DEC Ada binaries. Purchase of a DEC Ada Professional Development Option for OpenVMS Alpha Systems License (QL-0V*A*-**) enables use of this capability. * 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 DIGITAL licensing terms and policies, contact your local DIGITAL 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 plus Personal Use and Concurrent Use basis. Each Personal Use license allows one identified individual to use the layered product. Each Concurrent Use license allows any one individ- ual at a time 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. SOFTWARE PRODUCT SERVICES A variety of service options are available from DIGITAL. For more in- formation, contact your local DIGITAL office. 11 SOFTWARE WARRANTY Warranty for this software product is provided by DIGITAL with the purchase of a license for the product. This means that DIGITAL will remedy any nonconformance when it is reported to DIGITAL by the customer during the warranty period. The warranty period is one year. It begins when the software is installed or thirty days after delivery to the end user, whichever occurs 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 that will accept reporting (in format prescribed by DIGITAL) of a nonconformance problem caused when using the licensed software under normal conditions 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 operability of modifications not made by DIGITAL. If the software fails to function for reasons stated above, the cus- tomer's warranty will be invalidated and all service calls will be bil- lable at the prevailing per call rates. 12 This Software Warranty is effective for licensed software products or- dered in the United States after October 1988 and supersedes all prior versions. The previous information is valid at time of release. Please contact your local DIGITAL office for the most up-to-date information. ® Motif is a registered trademark of Open Software Foundation, Inc. [TM] X Window System is a trademark of the Massachusetts Institute of Technology. [TM] POSTSCRIPT is a registered trademark of Adobe Sytems Incorpo- rated. [TM] AlphaServer, AlphaStation, Bookreader, CI, DEC, DEC Ada, DEC Ada Professional Development Option, DECset, DECstation, DECsystem, DECwindows, DIGITAL, OpenVMS, VMS, and the DIGITAL Logo are trademarks of Digital Equipment Corporation. © 1997 Digital Equipment Corporation. All rights reserved. 13