 






          DIGITAL

          Read Before Installing or Using VAX Ada Version 2.2

          AV-EF83J-TE

          Whether you are a new or a continuing VAX Ada customer, please
          take time to read the following information about your product.

          New VAX Ada customers should receive the following:

          o  The media required for Version 2.2 of VAX Ada

          o  User documentation

          o  Supplemental materials and any additionally ordered items

          Continuing VAX Ada customers should receive the following:

          o  The media required for Version 2.2 of VAX Ada

          o  Supplemental materials and any additionally ordered items

          Installation Information

          For this release, VAX Ada Version 2.2 requires VMS Version 5.4
          or higher.

          Note that for this release, an Ada run-time library is installed
          as part of the VAX Ada kit.

          If you are installing VAX Ada Version 2.2 on a newly-licensed
          node or cluster, you must first register a License Product
          Authorization Key (License PAK) using the License Management
          Facility (LMF). The License PAK may be shipped along with the
          kit if you ordered the license and media together; otherwise, it
          is shipped separately to a location based on your license order.

          If you are installing VAX Ada Version 2.2 as an update on a node
          or cluster already licensed for this software, you must register
          the Service Update PAK (SUP) that is included in your Service
          Update Kit. If you already registered a License PAK or a SUP

 






          for this product on this node or cluster, you do not need to
          register the SUP.

          If you are installing an update of VAX Ada but lack a service
          contract, call your Digital representative for instructions on
          how to get a License PAK.

          See the VMS License Management Utility Manual for registration
          instructions.

          Previous versions of VAX Ada do not need to be installed before
          this version.




              Digital Equipment Corporation. 1991. All rights reserved.






















                                          2

 






          The Version 2.2 media kit consists of the following:

          1. A kit, named ADA022, that contains the following components:

             -  The VAX Ada compiler (ADA.EXE)

             -  The VAX Ada program library manager (ACS.EXE)

             -  The VAX Ada run-time library (ADARTL.EXE)

             -  The VAX Ada message file (ADAMSG.EXE)

             -  The Ada-from-CDD translator utility (ADA$FROM_CDD.EXE)

             -  DCL command definitions for the compiler, program library
                manager, and Ada-from-CDD translator

             -  The VAX Ada predefined library [SYSLIB.ADALIB], which is
                associated with the logical name ADA$PREDEFINED

             -  A predefined VAX Source Code Analyzer (SCA) library
                [SYSLIB.ADA$SCALIB], which is associated with the logical
                name ADA$SCA_PREDEFINED

          2. A kit, named ADAHLP022, that contains the VAX Ada help file

          Release Notes Information

          The release notes for VAX Ada Version 2.2 contain important
          installation-related information, a summary of technical changes
          and new features, compatibility information, current restric-
          tions and restrictions removed, and performance information.

          You can read the release notes before installing VAX Ada by
          invoking VMSINSTAL with the release notes option, N.

          After installing VAX Ada Version 2.2, you can obtain the release
          notes from the file SYS$HELP:ADA022.RELEASE_NOTES. The release
          notes are also included in the VAX Ada help kit (ADAHLP022).
          After you install the help kit, you can obtain the release notes
          by typing:

               $ HELP ADA Release_Notes

                                          3

 






          Note that the release notes in the help kit are more extensive:
          they accumulate information across point releases, and include
          validation and documentation information.

          Compatibility Information

          Before installing VAX Ada Version 2.2, you should read the re-
          lease notes. The release notes contain important information on
          the compatibility of VAX Ada
          Version 2.2 with previous versions of VAX Ada. In particular:

          o  The VAX Ada Version 2.2 compiler is incompatible with VAXELN
             Ada Version 2.0 or lower. It requires VAXELN Ada Version 2.2.

          o  VAX Ada Version 2.2 introduces support for library search
             paths. This support is compatible with Version 2.0 and 2.1
             libraries; no library upgrade or conversion is required.

          o  Beginning with VAX Ada Version 2.0, VAX Ada uses a new pro-
             gram library format that is incompatible with the format for
             VAX Ada Versions 1.0 through 1.5. If you are installing VAX
             Ada Version 2.2 on a system that is currently running a Ver-
             sion 1 compiler, program library manager, and so on, you must
             convert any Version 1 libraries to the Version 2 format using
             the ACS CONVERT LIBRARY command. The conversion makes all
             units in the library obsolete; you must recompile before you
             can link or perform other operations that require units that
             are current. You may also need to manually enter or reenter
             entered units, depending on the order in which you convert
             your libraries and make them current.

                                           NOTE

                If you are installing VAX Ada Version 2.2 on a system
                that is running VAX Ada Version 2.0 or 2.1, no new
                library conversion is required.



                                          4

 






             A number of feature changes may affect the compatibility of
             VAX Ada Version 2.2 with previous versions of VAX Ada. See
             the release notes for more information on new VAX Ada Version
             2.2 features. In particular, note that the following VAX Ada
             predefined units have changed and/or have been recompiled:

                ASSERT
                ASSERT_GENERIC (specification and body)
                CONTROL_C_INTERCEPTION (body)
                DIRECT_MIXED_IO (specification and body)
                DTK (specification)
                FLOAT_TEXT_IO
                INDEXED_MIXED_IO (specification and body)
                INTEGER_TEXT_IO
                LBR (specification)
                LIB (specification)
                LONG_FLOAT_TEXT_IO
                LONG_LONG_FLOAT_TEXT_IO
                MTH (specification)
                NCS (specification)
                OTS (specification)
                PPL (specification)
                RELATIVE_MIXED_IO (specification and body)
                RMS_ASYNCH_OPERATIONS (specification and body)
                SEQUENTIAL_MIXED_IO (specification and body)
                SHORT_INTEGER_TEXT_IO
                SHORT_SHORT_INTEGER_TEXT_IO
                SOR (specification)
                SMG (specification)
                STARLET (specification)
                STR (specification)
                TASKING_SERVICES (specification and body)
                TEXT_IO (specification and body)
                VAXELN_SERVICES (specification and body)





                                          5

 






          o  The installation procedure allows you to save the previous
             version of the compiler and its environment when you install
             VAX Ada Version 2.2. The installation procedure also creates
             command procedures that allow you to switch back and forth
             between the compilers that you have saved and the newly
             installed compiler.

































                                          6

 






          Contents of This Kit

          o  Indented Bill Report (BIL) and Bill of Materials (BOM)

             Please read the BIL and BOM enclosed in this kit and check to
             see that all items listed are actually in your kit. If your
             kit is damaged or any items are missing, call your Digital
             representative.

          o  Media

             If you ordered media, you will find the media and the VAX
             Ada Installation Guide in this kit. Consult the VAX Ada
             Installation Guide for information about installing VAX Ada
             on your system.

          o  Documentation

             Depending on your order, this kit may include copies of the
             following VAX Ada documentation:

             -  VAX Ada and VAXELN Ada Technical Summary-This booklet
                summarizes the features of VAX Ada and VAXELN Ada. It is
                designed to allow users and vendors to compare-at a very
                technical level-the VAX Ada and VAXELN Ada implementations
                with other Ada implementations.

             -  VAX Ada Language Reference Manual-This manual combines
                the text of the Ada ANSI Standard (ANSI/MIL-STD-1815A-
                1983) with specific information about VAX Ada. Use it as a
                reference for preparing VAX Ada source programs.

             -  Developing Ada Programs on VMS Systems-This manual de-
                scribes how to use the VAX Ada program library manager,
                and shows how to compile, link, execute, and debug VAX Ada
                programs on the VMS operating system.

             -  VAX Ada Run-Time Reference Manual-This manual gives
                system-specific information about input-output, stor-
                age allocation, mixed-language programming, system service
                calls, exception handling, and tasking. It also gives
                information on how to improve the run-time performance.

                                          7

 






             Note that the VAX Ada Installation Guide is included with the
             media.

          o  Software Product Description (SPD)

             The SPD provides an overview of the VAX Ada kit and its
             features.

          o  System Support Addendum (SSA)

             The SSA describes the technical environment in which the
             product is supported.

          o  Software Performance Report (SPR)

             Use this form to report any problems with VAX Ada, provided
             you have purchased warranty services.

          A Final Note

          Digital prides itself on responding to customer needs. In order
          to continue serving you, we need your comments. Each manual
          contains preaddressed, postage-paid Reader's Comments forms
          at the back. If you find errors in a manual or want to make
          comments about it, please fill out one of these forms and send
          it to us. If you find errors in the software, please submit an
          SPR, provided you have purchased warranty services.












                                          8
