Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought












                     SR10.1 Product Support Kit Release Document






                                                        SFW-PSK4-MED10
                                                  Order No, 016955-A00












                              Restricted Rights Notice

          Use, duplication, or disclosure by the Government is subject to restrictions
          as set forth in subparagraph (c) (1) (ii) of the Rights in Technical
               Data and Computer Software clause at DFARS 52.227-7013.

                                Apollo Computer Inc.
                                 330 Billerica Road
                                Chelmsford, MA 01824
                                   (508) 256-6600

          Notice: Notwithstanding any other lease or license agreement that
          may pertain to, or accompany the delivery of, this computer software,
          the rights of the Government regarding its use, reproduction and disclosure
          are as set forth in Section 52.227-19 of the FARS Computer Software
                             - Restricted Rights clause.
                                      Copyright
          Copyright 1989 Apollo Computer, Inc., Chelmsford, Massachusetts. Unpublished - all
           rights reserved under the Copyright Laws of the United States.
          This notice shall be marked on any reproduction of these data, in
                                  whole or in part.















                            Product Support Kit (SFW-PSK4-MED10)



                     THE TERMS AND CONDITIONS  GOVERNING  THE  SALE  OF
                     APOLLO  COMPUTER  INC.  HARDWARE  PRODUCTS AND THE
                     LICENSING OF APOLLO COMPUTER  INC.  SOFTWARE  PRO-
                     DUCTS  CONSIST  SOLELY  OF  THOSE SET FORTH IN THE
                     WRITTEN CONTRACTS BETWEEN APOLLO COMPUTER INC. AND
                     ITS  CUSTOMERS.  NO REPRESENTATION OR OTHER AFFIR-
                     MATION OF  FACT  CONTAINED  IN  THIS  PUBLICATION,
                     INCLUDING  BUT NOT LIMITED TO STATEMENTS REGARDING
                     CAPACITY, RESPONSE-TIME  PERFORMANCE,  SUITABILITY
                     FOR  USE  OR  PERFORMANCE  OF  PRODUCTS  DESCRIBED
                     HEREIN SHALL BE DEEMED TO BE A WARRANTY BY  APOLLO
                     COMPUTER INC. FOR ANY PURPOSE, OR GIVE RISE TO ANY
                     LIABILITY BY APOLLO COMPUTER INC. WHATSOEVER.

                     IN NO EVENT SHALL APOLLO COMPUTER INC.  BE  LIABLE
                     FOR  ANY  INCIDENTAL, INDIRECT, SPECIAL, OR CONSE-
                     QUENTIAL DAMAGES  WHATSOEVER  (INCLUDING  BUT  NOT
                     LIMITED  TO LOST PROFITS) ARISING OUT OF OR RELAT-
                     ING TO THIS PUBLICATION OR  THE  INFORMATION  CON-
                     TAINED  IN  IT,  EVEN  IF APOLLO COMPUTER INC. HAS
                     BEEN ADVISED, KNEW, OR SHOULD HAVE  KNOWN  OF  THE
                     POSSIBILITY OF SUCH DAMAGES.

                     THE SOFTWARE PROGRAMS DESCRIBED IN  THIS  DOCUMENT
                     ARE  CONFIDENTIAL INFORMATION AND PROPRIETARY PRO-
                     DUCTS OF APOLLO COMPUTER INC. OR ITS LICENSORS.








                This document was formatted on a Domain(R)node using the
                nroff text formatter distributed with Domain OS(tm)
                software.

                        Confidential and Proprietary. Copyright 1989
                     Apollo Computer, Inc., Chelmsford, Massachusetts.
                     Unpublished -- rights reserved under the Copyright
                      Laws of the United States. All Rights Reserved.










                                             i







                            Product Support Kit (SFW-PSK4-MED10)



                                          Preface

                This document describes the Product Support Kit
                (SFW-PSK4-MED10), which provides software support for new
                functionality that was released after SR10.1. The Product
                Support Kit is provided on media separate from the software
                shipped with the hardware.

                This document consists of an overview of the kit, changes to
                the installation procedure, a summary of changes to techni-
                cal documentation, and a list of known bugs.  Note that this
                document provides an overview of new functionality.  We
                reference various technical manuals throughout this release
                document for additional information.

                The normal software installation process places a version of
                this release document in each node's /install/doc/apollo
                directory. Release Documents for optional Domain software
                are installed in a similar manner. The SR10.1 Release Docu-
                ment is also included in the SR10.1 /install/doc/apollo
                directory so that you can determine what functionality was
                added at that release.

                Apollo Computer Inc. reserves the right to make changes in
                specification and other information contained in this publi-
                cation without prior notice, and the reader should in all
                cases consult Apollo Computer Inc. to determine whether any
                such changes have been made.

                3DGMR, Aegis, D3M, DGR, Domain/ComController,
                Domain/CommonLISP, Domain/CORE, Domain/Debug, Domain/DFL,
                Domain/Dialogue, Domain/Laser-26, Domain/LISP, Domain/PAK,
                Domain/PCC, Domain/PCI, Domain/SNA, Domain/ X.25, DPSS,
                DPSS/Mail, DSEE, FPX, GMR, GPR, GSR, NLS, Network Computing
                Kernel, Network Computing System, OmniBack, Open Dialogue,
                Open Network Toolkit, Open System Toolkit, Personal Super-
                computer, Personal Super Workstation, Series 3000, Series
                3500, Series 4000, Series 4500, and Series 10000 are trade-
                marks of Apollo Computer Inc.

                Personal Computer AT and AT are registered trademarks of
                International Business Machines Corporation.

                UNIX is a registered trademark of AT&T in the USA and in
                other countries.

                ETHERNET is a registered trademark of Xerox Corporation.






                                             ii







                            Product Support Kit (SFW-PSK4-MED10)



                How to Print the Release Notes

                You may print the online copy of this document.

                If your installation uses the SysV lp print daemon, use an
                lp command similar to the following:

                     lp -d printer_name pathname

                where pathname is the pathname of the release notes, usually

                /install/doc/apollo/psk4.v.10.1__notes

                If your installation uses the Domain print system, use the
                following Aegis(tm) /com/prf command:

                     prf pathname -pr printer_name -npag -point 10

                If your installation uses the BSD lpd print daemon, use an
                lpr command similar to the following:

                     lpr -P printer_name pathname































                                            iii










                                          CONTENTS


                1.  Product Support Kit Overview.......................  1-1

                2.  Installing the Product Support Kit.................  2-1

                3.  Documentation......................................  3-1
                    3.1  Online Help File for Manuals..................  3-1
                    3.2  Sources for New and Revised Documentation
                         Listings......................................  3-1

                4.  Patch Kits, Limitations, and Bugs..................  4-1
                    4.1  Preserved Patches.............................  4-1
                    4.2  PSK4 Patches..................................  4-2







































                                           - i -
















                            Product Support Kit (SFW-PSK4-MED10)



                          Chapter 1: Product Support Kit Overview





                This Product Support Kit (SFW-PSK4-MED10) provides addi-
                tional software support for Series 3500(TM), Series
                4000(TM), and Series 4500(TM) Apollo(R) workstations running
                SR10.1. For these workstations, this PSK moves the operating
                system revision level up to SR10.1.2 and is required to sup-
                port the following:

                   ⊕ SCSI devices controlled by the Multi-Function Peri-
                     pheral Controller (SWFC), including:

                        ⊕ Apollo's SCSI 8-mm tape drive device used with
                          OmniBack(TM) running on SR10.1.

                        ⊕ SCSI 1/2-inch reel-to-reel tape drive.

                        ⊕ SCSI 1/4-inch cartridge tape drive.

                   ⊕ The conversion of the 19-inch color monitor (010700)
                     from a 68-Hz screen refresh rate to a 70-Hz screen
                     refresh rate. (Preserved from SFW-PSK3-MED10.)

                   ⊕ The Disk/Multiple Disk Expansion Module, striping on
                     multiple disk configurations, and enhanced support for
                     the SCSI cartridge tape drive. (Preserved from SFW-
                     PSK2-MED10.)

                This release document describes the contents of the kit and
                how to install it.  Refer to the Domain System Software
                Release Notes (005809-A03) for detailed information about
                SR10.1 software.

                Install SFW-PSK4-MED10 only on m68k (Motorola) systems run-
                ning SR10.1 or SR10.1.x. The kit installation procedure is
                the same as a layered software product (see Chapter 2 of
                this document and Media Installation Instructions for
                Optional Software Products, Order No. 10854-A04).










                1-2                                                 Overview








                            Product Support Kit (SFW-PSK4-MED10)



                       Chapter 2: Installing the Product Support Kit





                The Product Support Kit is installed as layered software
                only on m68k (Motorola) systems running SR10.1 or SR10.1.x.
                Media Installation Instructions for Optional Software Pro-
                ducts (Order No. 10854-A04) and Installing Software with
                Apollo's Release and Installation Tools (Order No. 008860-
                A00) provide instructions for installing the software and
                are included in this kit.  After you install SFW-PSK4-MED10,
                /sau7 systems (DN3500, DN4000, DN4500) display a banner
                showing the operating system at revision SR10.1.2 when the
                bldt command is invoked.

                The software on this PSK must be installed on any /sau7 m68k
                (Motorola) system running the following devices:

                   ⊕ SCSI 8-mm tape drive

                   ⊕ SCSI 1/2-inch reel-to-reel tape drive

                   ⊕ SCSI 1/4-inch cartridge tape drive

                The following table lists all the files (including those
                preserved from PSK3 and PSK2) installed with this kit.
























                Installation                                             2-1








                            Product Support Kit (SFW-PSK4-MED10)



                                         New/Changed    Included
                                         with           Previously with
                PSK4 Files:              PSK4           PSK3/PSK2

                /lib/tfp                 x              x

                /sau7/disp7e.dex         x

                /sau7/help/disp7e.hlp    x

                /sau7/help/vtape.hlp     x

                /sau7/domain_os          x              x

                /sau7/domain_os.map      x              x

                /sau7/ctape7b.dex                       x

                /sau7/scsi7.drvr                        x

                /sau7/vtape.dex          x

                /sau7/vtape7.drvr        x

                /sau7/win7b.dex                         x

                /sau7/win7b.drvr                        x

                /sys/color6_microcode                   x

                /sys/mgrs/rmt_scsi       x

                /sysboot                                x

                /systest/fpu.sh                         x

                /systest/sax                            x

                /systest/sax.slf                        x

                /systest/size_disk.sh                   x

                /systest/size_scsi       x              x

                /systest/vtape           x

                /systest/vtape.lay       x

                /systest/vtape.sh        x

                /usr/apollo/bin/dspst                   x


                2-2                                             Installation








                            Product Support Kit (SFW-PSK4-MED10)



                Distribution Media

                We distribute SFW-PSK4-MED10 on Magtape, 1/4-inch Streaming
                Cartridge Tape, and 5 1/4-inch Floppy Diskette as follows:

                Magtape

                SFW-PSK4-MED10 on Magtape consists of one tape and is
                titled:

                   SFW-PSK4-MED10-T

                The installation name for the Magtape is as follows:

                  mt_psk4_1

                Streaming Cartridge Tape

                SFW-PSK4-MED10 on Streaming Cartridge Tape consists of one
                tape and is titled:

                   SFW-PSK4-MED10-C

                The installation name for the Streaming Cartridge Tape is as
                follows:

                  crtg_psk4_1

                Floppy Diskette

                SFW-PSK4-MED10 on Floppy Diskette consists of seven floppies
                and is titled:

                   SFW-PSK4-MED10-H

                The installation names for the seven Floppy Diskettes are as
                follows:

                  flp5_psk4 disk_1.01 thru 1.07













                Installation                                             2-3








                            Product Support Kit (SFW-PSK4-MED10)



                                  Chapter 3: Documentation





                This chapter indicates where you can find the documents that
                are new or were revised at SR10.1.


                3.1  Online Help File for Manuals

                We provide an online list of our user's manuals and their
                part numbers and revision numbers.  We update this list at
                each operating system release.  To use this list, request
                help for manuals as follows at the shell input pad:

                    help manuals

                Consult this list if you want to determine whether you have
                the most up-to-date revision of a manual, or if you want to
                see other manuals that are available.


                3.2  Sources for New and Revised Documentation Listings

                For a complete list of all technical publications relating
                to Domain System products, refer to the Domain Documentation
                Quick Reference (002685-A01).

                Currently, all new manuals at SR10.1 are listed in Chapter 3
                of the Domain System Software Release Notes (005809-A03).




















                Installation                                             3-1








                            Product Support Kit (SFW-PSK4-MED10)



                        Chapter 4: Patch Kits, Limitations, and Bugs





                This chapter lists the patches that are preserved or
                included in this PSK.


                4.1  Preserved Patches

                All known patches have been preserved in this SFW-PSK4-MED10
                install.  Information on limitations and existing bugs for
                SR10.1 may be found in the Domain System Software Release
                Notes (005809-A03), and the Domain System Software Notice
                (010920-A02).

                The following patches are preserved when you install
                SFW-PSK4-MED10:


                Patch m0039  ring7b/8b .dex, .drvr, .hlp
                Patch m0038  /sys/ethernet8_microcode
                Patch m0035  /usr/apollo/bin/vt100
                Patch m0032  SFW-VERS Driver Fix
                Patch m0031  /lib/gprlib
                Patch m0029  /lib/dblib
                Patch m0028  /lib/ftnlib
                Patch m0027  Sys5.3 f77 Library
                Patch m0026  BSD4.3 f77 Library
                Patch m0024  /sys5/bin/ld and /bsd4.3/bin/ld
                Patch m0023  /lib/gprlib
                Patch m0022  /sys/ins/dialog.ins (c, ftn, pas)
                Patch m0021  /lib/gprlib
                Patch m0019  Installing NIDL(TM) on SR10 and SR10.1
                Patch m0017  Changes to /sys/ethernet8_microcode
                Patch m0016  Changes to /lib/gprlib and /sys/mgrs/dtm_mk3
                Patch m0015  Fixes to Domain/OS Commands
                Patch m0012  Fixes to NFS

                                 NFS Server readdir Bug
                                 NFS Type Manager readdir Bug
                                 NFS Type Manager unlink Bug
                                 NFS Type Manager Absolute Links Bug
                                 NFS Type Manager link and unlink bug
                                 NFS Type Manager ios_$delete bug
                                 NFS Type Manager ios_$inq_path_name bug

                                                      Continued on Next Page


                Bugs                                                     4-1








                            Product Support Kit (SFW-PSK4-MED10)



                                        Preserved Patches Continued

                Patch m0009  Display Diagnostics for /sau7 nodes
                Patch m0007  Fixes to /sau7/domain_os and /lib/streams
                Patch m0002  Change to /SYS5.3/USR/LIB/CPP
                Patch m0001  Change to /LIB/SYSLIB.881


                4.2  PSK4 Patches

                The following new or changed patches are included in
                SFW-PSK4-MED10:

                Patch m0044
                   -  Corrects the operatinal microcode loaded
                      onto the hardware from the diagnostic so
                      that the manual Visual test no longer
                      produces distorted patterns.

                Patch m0043
                   -  Fixes bug in the SCSI manager that runs
                      on the Multi-Function Peripheral
                      Controller Board (/sau7 of SR10.1).
                   -  Fixes the delay in process exit when
                      UNIX(TM)* accounting is turned on.

                Patch m0033
                      The /sau7 domain_os includes a fix to
                      correct the handling of 68882 floating
                      point faults. Errors seen were:
                      coprocessor protocol violation,
                      unimplemented instruction, and
                      occassionally unable to unwind stack.
                   -  The /sau7 domain_os includes a fix to cure
                      the 8000d crash during shutdown.
                   -  Adds wiring for 300 additional pages of
                      pmaps on demand for 16-MB /sau7 nodes.

                                        Continued on Next Page
                _______________
                * UNIX is a registered trademark of AT&T in the USA
                and in other countries.










                4-2                                                     Bugs








                            Product Support Kit (SFW-PSK4-MED10)



                                        PSK4 Patches Continued

                Patch m0030
                      Fixes problem with SCSI tape drive
                      acquisition, and problems with resource
                      release after faults.
                Patch m0020
                      Increases stack size for ring receive
                      server to correct stack overflow problem.
                   -  Includes a generic SR10.1 ACL fix to a
                      problem in remote root protection.
                   -  Fixes problem with multicast handling for
                      AT* bus ETHERNET**.
                   -  Corrects a problem in floppy support.
                   -  Fixes a cartrdige tape problem; all
                      internal AT bus devices were being
                      flagged as 16-bit I/O devices. When
                      multiple IOMAP devices were used, the
                      allocator was mapping the cartridge tape
                      controller incorrectly, resulting in
                      various ctape related problems.

                Patch m0018
                     For single sector transfers, reports
                     sector number under test at time error detected.

                                        Continued on Next Page

                _______________
                * Personal Computer AT and AT are registered
                trademarks of International Business Machines
                Incorporated.
                ** ETHERNET is a registered trademark of
                Xerox Corporation.


















                Bugs                                                     4-3








                            Product Support Kit (SFW-PSK4-MED10)



                                        PSK4 Patches Continued

                Patch m0013
                     Fixes problem with insufficient virtual
                     address space on 010 machine types.
                  -  Corrects unreliable forced write on all
                     machine types.
                  -  Fixes crash on /sau5 machines when
                     releasing GPIO VMEbus device.
                  -  Fixes incorrect disk statistics reported
                     on diskless machine types.
                  -  Fixes object not found error that
                     resulted under heavy loads on all
                     machine types.
                Patch m0011
                     Fixes ctape7b.dex (test 210) and
                     floating-point tests.
                Patch m0010
                     Adds support to perform sector skewing
                     when the disk is formatted by diagnostic.
































                4-4                                                     Bugs












Typewritten Software • bear@typewritten.org • Edmonds, WA 98026