 















             VAX Decision Expert Installation Guide

             Order Number: AA-LW64A-TE



             This document contains instructions for installing VAX
             Decision Expert software on the VMS operating system. It
             also explains how to read the online release notes before
             or after installing the product. This document applies to
             VAX Decision Expert Version 1.0 and all maintenance updates
             throughout that version.





             Revision/Update Information:  This is a new manual.

             Operating System and Version: VMS Version 5.1 or higher.
                                           Future maintenance releases may
                                           require higher versions.

             Software Version:             VAX Decision Expert Version 1.0



             digital equipment corporation
             maynard, massachusetts

 


             ___________________________________________________
             September 1989

             The information in this document is subject to change without
             notice and should not be construed as a commitment by Digital
             Equipment Corporation.

             Digital Equipment Corporation assumes no responsibility for
             any errors that may appear in this document.

             Any software described in this document is furnished under
             a license and may be used or copied only in accordance with
             the terms of such license. No responsibility is assumed for
             the use or reliability of software or equipment that is not
             supplied by Digital Equipment Corporation or its affiliated
             companies.

             Restricted Rights: Use, duplication, or disclosure by the
             U.S. 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 252.227-7013.

              Digital Equipment Corporation 1989.

             All rights reserved.
             Printed in U.S.A.

             The postpaid Reader's Comments forms at the end of this docu-
             ment request your critical evaluation to assist in preparing
             future documentation.

             The following are trademarks of Digital Equipment Corporation:

             ALL-IN-1       DIBOL          RSX
             DEC            EduSystem      RT
             DEC/CMS        IAS            ULTRIX
             DEC/MMS        MASSBUS        UNIBUS
             DECnet         PDP            VAX
             DECmate        PDT            VAXcluster
             DECsystem-10   P/OS           VAXstation
             DECSYSTEM-20   Professional   VMS
             DECUS          Q-bus          VT
             DECwindows     Rainbow        Work Processor
             DECwriter      RSTS           DIGITAL

                                                                  ML-S1037

 















                                                                  Contents
          ________________________________________________________________

          Preface .........................................................   vi


          ________________________________________________________________
          Chapter 1  Preparing to Install VAX Decision Expert
                     Software

               1.1   Prerequisite Software............................. 1-2

               1.2   Accessing the Online Release Notes..............  1-2

               1.3   Installation Procedure Requirements.............  1-2

               1.4   User Account Quotas and Privileges..............  1-2

               1.5   Special Requirements .............................. 1-3

               1.6   Using VMSINSTAL.................................... 1-4










                                                                       iii

 






          ________________________________________________________________
          Chapter 2  Installing VAX Decision Expert

               2.1   Steps to Install VAX Decision Expert............  2-1

               2.2   VAX Decision Expert Logical Names............... 2-11

               2.3   Installing VAX Decision Expert on a VAXcluster
                     System............................................... 2-12


          ________________________________________________________________
          Chapter 3  After the Installation

               3.1   Running the Installation Verification
                     Procedure Separately .............................. 3-2

               3.2   Error Conditions................................... 3-2

               3.3   Maintenance Updates ............................... 3-3

               3.4   Determining and Reporting Problems..............  3-3

          ________________________________________________________________
          Appendix A Sample Installation


          ________________________________________________________________
          Index










          iv

 







          ________________________________________________________________
          Tables

               2-1   Files the Installation Procedure Modifies or
                     Adds.................................................   2-6

               2-2   Logical Names ......................................   2-11































                                                                         v

 














                                                                   Preface
          ________________________________________________________________



             This document explains how to install VAX Decision Expert
             software on the VMS operating system. It is intended for
             system managers. This document applies to VAX Decision Expert
             Version 1.0 and all maintenance updates in that version.
             A major version number is represented by the digits to the
             left of the decimal point, and the maintenance update version
             number is indicated by the digits to the right of the decimal
             point.

             Keep this document with your distribution kit. You will
             need it to install maintenance updates or to reinstall VAX
             Decision Expert software for any other reason.

             For more information about installing Decision Expert soft-
             ware on VMS systems, refer to the installation/operations
             guide for your specific processor.

             This guide describes the installation procedure step-by-step.
             The system prompts you to answer questions and to change
             volumes, and it waits for you to tell it to continue.

             Default values appear in brackets ([])  throughout the in-
             stallation procedure. Text that you type appears bold for VMS
             Bookreader online versions.


          vi

 

















                                                                      Chapter 1


                              Preparing to Install VAX Decision Expert Software
               ________________________________________________________________


                  Your bill of materials (BOM) specifies the number and con-
                  tents of your media. Be sure to check the contents of your
                  kit against this information. If your kit is damaged or if
                  you find that parts of it are missing, call your Digital
                  representative.

                  VAX Decision Expert software runs on VAXstation computers.
                  You can install the software if you are logged on to a ter-
                  minal, but in order to run the Installation Verification
                  Procedure (IVP) after installation, you must log on to a
                  VAXstation keyboard without using a network.

                  This guide also gives details on several options to the
                  installation procedure.

                  You must mount distribution media before you install Decision
                  Expert software. The installation procedure prompts you to
                  mount the volumes. For more information on how to mount
                  distribution media, refer to the installation/operations
                  guide for your specific processor.












                         Preparing to Install VAX Decision Expert Software  1-1

 










               ____________________________________________________________

               1.1  Prerequisite Software

                  VAX Decision Expert Version 1.0 requires VMS Version 5.1,
                  including DECwindows.

               ____________________________________________________________

               1.2  Accessing the Online Release Notes

                  Decision Expert software provides online release notes.
                  The prompt to display or print the release notes before
                  installation appears in step 5 of the installation procedure
                  when you invoke VMSINSTAL with the OPTIONS N parameter.

                  To read the release notes after the installation, display or
                  print the file SYS$HELP:DEEX$010.RELEASE_NOTES.

               ____________________________________________________________

               1.3  Installation Procedure Requirements

                  The installation takes approximately 10 to 15 minutes, de-
                  pending on the type of media and your system configuration.
                  Before installing Decision Expert software, you must have the
                  following privileges and resources:

                   o SETPRV privileges, or CMKRNL, WORLD, and SYSPRV privi-
                     leges.

                   o A minimum of 9000 blocks of free disk space during instal-
                     lation.

                   o Enough physical memory to support a minimum configuration
                     of the VMS V5.1 operating system with the DECwindows V5.1
                     windowing system. Digital Strongly recommends that you
                     have a minimum of 8 megabytes of physical memory.

               ____________________________________________________________

               1.4  User Account Quotas and Privileges

                  To use Decision Expert software, each account must have
                  TMPMBX and NETMBX privileges, and the following minimum
                  requirements:

                   o AST limit (ASTLM) 24 (minimum)

                   o Buffered I/O quota (BIOLM) 18 (minimum)

                   o Buffered I/O byte count quota (BYTLM) 8192 (minimum)

               1-2  Preparing to Install VAX Decision Expert Software

 











                   o Direct I/O quota (DIOLM) 18 (minimum)

                   o Enqueue quota (ENQLM) 30 (minimum)

                   o Open file limit (FILLM) 20 (minimum)

                   o Paging file quota (PGFLQUOTA) 10,240 pages (minimum)

                   o Subprocess creation quota (PRCLM) 2 (minimum)

                   o Working set size (WSDEF) 150 pages (minimum) 1024 pages
                     (optimum)

                  Use the VMS Authorize Utility (AUTHORIZE)  to compare the
                  current values of these quotas with the requirements for
                  Decision Expert. The following example uses the SYSTEM ac-
                  count:

                    $ SET DEFAULT SYS$SYSTEM
                    $ RUN AUTHORIZE
                    UAF> SHOW SYSTEM

                  To change the values of these quotas, use the VMS Authorize
                  Utility's MODIFY command. For more information, see the VMS
                  Authorize Utility Manual.

               ____________________________________________________________

               1.5  Special Requirements

                  Decision Expert software requires manual registration with a
                  Product Authorization Key (PAK). Be sure to register Decision
                  Expert software before starting the installation procedure to
                  ensure a successful installation.

                  The VMS License Management Facility is part of Version 5.1 of
                  the VMS operating system. If you are installing VAX Decision
                  Expert software on a VMS Version 5.1 system, you must regis-
                  ter your software license.

                  The license registration information you need is contained in
                  the PAK that is shipped with VAX Decision Expert software.
                  The PAK is a paper certificate that contains information
                  about your license to run a particular piece of software.

                  It is best to register your VAX Decision Expert license
                  before you perform the installation. During the installation,
                  you are asked if you have registered the VAX Decision Expert
                  license and loaded the appropriate authorization key. If you

                         Preparing to Install VAX Decision Expert Software  1-3

 











                  have not already done so, you can complete the installation;
                  however, you will not be able to run either the VAX Decision
                  Expert development package or its Installation Verification
                  Procedure (IVP). In addition, you must be logged on to a
                  VAXstation to use the Decision Expert development package and
                  to run the IVP. Once you perform the license registration and
                  have loaded an authorization key, you will be able to run the
                  IVP and use VAX Decision Expert on a VAXstation.

                  Under VMS Version 5.1, some products use the VMS License
                  Management Facility (LMF) to register the product on line
                  automatically. Decision Expert software does not use the
                  License Management Facility to automatically register
                  Decision Expert.

                  Refer to your "License Software Product, Product Authorization
                  Key" form for license registration procedures. That document
                  provides a sample session.

               ____________________________________________________________

               1.6  Using VMSINSTAL

                  This section reviews how to use the command procedure
                  VMSINSTAL. See Chapter 2 for specific installation proce-
                  dures for Decision Expert software. Appendix A shows a sample
                  installation.

                  After you log in to the SYSTEM account to install the
                  Decision Expert software, set default to SYS$UPDATE and then
                  invoke VMSINSTAL, the command procedure that installs this
                  product. An example of this procedure is shown in steps 1 and
                  2 of Chapter 2. The command formats are as follows:

                    $ SET DEFAULT SYS$UPDATE
                    $ @VMSINSTAL DEEX010 MUA0: [OPTIONS N]

                  The command parameters are described in the next paragraphs.
                  If you do not supply the first two parameters, VMSINSTAL
                  prompts you for the product and device names. If you want to
                  be prompted for the product and device names and to display
                  or print the release notes, type the following:

                    $ @SYS$UPDATE:VMSINSTAL "" "" OPTIONS N

                  The parameters are defined below.

               1-4  Preparing to Install VAX Decision Expert Software

 











                  DEEX010
                  Represents the release name of VAX Decision Expert software.
                  Refer to the label on the VAX Decision Expert distribution
                  kit or the VAX Decision Expert BOM for the release version
                  number of your kit. You can also type an asterisk (*) in
                  place of DEEX010. If you are installing from magnetic tape,
                  you can use the asterisk to save installation time; using the
                  asterisk installs the software with a minimum number of tape
                  passes.

                  MUA0:
                  Represents the name of the device on which you plan to mount
                  the media, where MUA is the device code and 0 is the unit
                  number. It is not necessary to use the console drive to
                  install the software. If you use the console drive, you
                  should replace any media you removed from the drive. MUA0: is
                  the device name used in examples in this document.

                  OPTIONS N
                  An optional parameter indicating that you want to be prompted
                  to display or print the release notes. If you do not include
                  the OPTIONS N parameter, VMSINSTAL does not prompt you to
                  display or print the release notes. Digital Strongly recom-
                  mends that you read the release notes before proceeding with
                  this installation.

                  VMSINSTAL has several other options; for information, see the
                  VMS documentation on Software Installation.

                  When you invoke VMSINSTAL, it checks the following:

                   o Whether you have logged in to a privileged account.
                     Digital Recommends that you install software from the
                     system manager's account with your default device and
                     directory set to SYS$UPDATE.

                   o Whether you have adequate quotas for installation.
                     VMSINSTAL checks for the following quota values:

                      _ ASTLM = 24

                      _ BIOLM = 18

                      _ BYTLM = 18,000

                      _ DIOLM = 18

                      _ ENQLM = 30

                         Preparing to Install VAX Decision Expert Software  1-5

 











                      _ FILLM = 20

                     Then VMSINSTAL checks the following:

                      o Whether DECnet is up and running

                      o Whether any users are logged in to the system

                     If VMSINSTAL detects that either of these conditions is
                     true, the system asks whether you want to continue the
                     installation. If you want to continue, type YES. If you
                     want to stop the installation, press <Return> .

































               1-6  Preparing to Install VAX Decision Expert Software

 

















                                                                      Chapter 2


                                                 Installing VAX Decision Expert
               ________________________________________________________________


                  This section explains each step of the installation pro-
                  cedure. Note that throughout the installation procedure,
                  default values appear in brackets.

                  To abort the installation procedure at any time, press
                  < Ctrl/Y > . When you press < Ctrl/Y > , the installation
                  procedure deletes all files it has created up to that point
                  and then returns you to the DCL level. If you want to retry
                  the installation procedure after pressing < Ctrl/Y > , you
                  must proceed from step 2.

               ____________________________________________________________

               2.1  Steps to Install VAX Decision Expert

                  Step 1: Log in to the SYSTEM account and set your default
                  device and directory to SYS$UPDATE.

                  If your VMS account requires a secondary password, a third
                  field appears on the screen after your user name and primary
                  password are verified. Enter your secondary password in the
                  same way you entered your primary password.

                  Set your default device and directory as follows:

                    $ SET DEFAULT SYS$UPDATE

                  See Section 2.3 for information on how to install this soft-
                  ware on a VAXcluster system.



                                            Installing VAX Decision Expert  2-1

 











                  Step 2: Invoke VMSINSTAL.

                  Digital recommends that you back up the system disk before
                  installing any software on top of the operating system.
                  Use the backup procedures that have been established at
                  your site. For details on backing up a system disk, see the
                  section on the Backup Utility in the VMS documentation set.

                                               NOTE

                      Each question in the installation is marked with an
                      asterisk (*) at the beginning of the line. Some ques-
                      tions show the default response in brackets, for exam-
                      ple [YES]. If you want to give the default response,
                      press <Return> .

                  To start installation of Decision Expert software, invoke
                  VMSINSTAL as follows:

                    $ @VMSINSTAL DEEX010 MUA0: OPTIONS N

                        VAX/VMS Software Product Installation Procedure V5.1

                    It is dd-mmm-yyyy at hh:mm.
                    Enter a question mark (?) at any time for help.

                    * Are you satisfied with the backup of your
                    system disk [YES]?

                  If you are satisfied with the backup of your system disk,
                  press <Return> . Otherwise, type NO and press <Return> to
                  abort the installation.

                  Step 3: Insert the first installation kit volume.

                  Follow the system prompts:

                    Please mount the first volume of the set on MUA0:.
                    * Are you ready? YES
                    The following products will be processed:

                        DEEX V1.0

                        Beginning installation of VAX Decision Expert V1.0
                        at hh:mm

                    %VMSINSTAL-I-RESTORE, Restoring product saveset A...

               2-2  Installing VAX Decision Expert

 











                  Step 4: Insert the subsequent installation kit volumes.

                  If you have additional media, follow the system prompts:

                    %BACKUP-I-READYREAD, mount volume 2 on _MUA0: for reading

                    Enter "YES" when ready: YES

                  If you respond NO instead of YES, VMSINSTAL displays the
                  prompt again. The system displays these prompts only if your
                  installation kit contains more than one volume.

                  Step 5: Select a release notes option.

                  This step applies when you specify OPTIONS N in step 2.
                  Follow the system prompts:

                    Release Notes Options:

                        1.  Display release notes
                        2.  Print release notes
                        3.  Both 1 and 2
                        4.  Copy release notes to SYS$HELP
                        5.  Do not display, print or copy release notes

                    * Select option [2]:

                  If you select option 1, VMSINSTAL displays the release notes
                  on line immediately. You can terminate the display at any
                  time by pressing < Ctrl/C > .

                  If you select option 2, VMSINSTAL prompts you for a queue
                  name. Either type a queue name or press <Return> to send the
                  file to the default output print device, which is shown in
                  brackets.

                  If you select option 3, VMSINSTAL displays the release notes
                  on line immediately and then prompts you for a queue name.
                  After you supply a queue name or press <Return> , the release
                  notes are copied to the file SYS$HELP:DEEX$010.RELEASE_NOTES.

                                             CAUTION

                      This version of the release notes file is labeled with
                      the current product name and version number. Take care
                      not to delete release notes for previous versions.

                                            Installing VAX Decision Expert  2-3

 











                  Next, follow the system prompt to continue the installation:

                    * Do you want to continue the installation [N]?: YES
                    %VMSINSTAL-I-RELMOVED, The product release notes have
                    been successfully moved to SYS$HELP.

                  If you enter NO or press <Return> to enter the default [N],
                  VMSINSTAL discontinues the installation. VMSINSTAL moves the
                  release notes to SYS$HELP regardless of the response that you
                  enter.

                  Step 6: Select installation options.

                  You must select several installation options. A default
                  for each action is shown in brackets after the installation
                  question. To use the default action, press <Return> for each
                  response.

                  The following three actions specify the directory in which
                  to install Decision Expert software and whether to purge
                  Decision Expert files. Follow the system prompts:

                    * In which directory is VAX Decision Expert to be
                    installed [SYS$COMMON:[DEEX$SYSTEM]]:

                    * Is directory SYS$COMMON:[DEEX$SYSTEM] correct [YES]?

                    * Do you want to purge files replaced by this
                    installation [YES]?

                  If this is not the first time you have installed this
                  product, the directories SYS$STARTUP, SYS$HELP, SYS$TEST,
                  SYS$MESSAGE, and DEEX$SYSTEM may contain previous versions
                  of Decision Expert files. These files are replaced during
                  the installation with new files, but the old files are not
                  automatically purged. Purging is recommended. In response to
                  the purging prompt, press <Return> to purge the files or type
                  NO to keep them.

                  Next, the installation procedure asks if you want to run the
                  Installation Verification Procedure (IVP). The IVP runs tests
                  that check whether the installation procedure was successful.
                  Press <Return> for the default response if you want to run
                  the IVP. If you are logged on to a terminal, you cannot run
                  the IVP.

               * Do you want to run the IVP after the installation [YES]?

               2-4  Installing VAX Decision Expert

 











                  If you do not want to run the IVP, respond NO to the prompt.

                  Finally, the installation procedure asks if you have the
                  correct license for the software. Respond to the prompt:

                            Product:      DECISION-EXPERT
                            Producer:     DEC
                            Version:      1.0
                            Release Date: 13-DEC-1988

                    * Does this product have an authorization key registered
                    and loaded? YES
                    %DEEX-I-NOMOREQUESTIONS, No further questions will be
                    asked.

                  The screen displays a list of system disk directories that
                  the product creates.

                  Step 7: Read informational messages.

                  The VAX Decision Expert installation procedure produces a
                  number of informational messages that report on the progress
                  of the installation. If installation is successful, the
                  system displays the following message:

                    %VMSINSTAL-I-MOVEFILES, files will now be moved to their
                    target directories...

                  The new or modified files are moved to their target di-
                  rectories. In addition, the SYS$HELP:HELPLIB.HLB and
                  SYS$LIBRARY:DCLTABLES.EXE files are updated to include the
                  new versions of the Decision Expert Help text and the DECIDE
                  command line definition. Also, if you have entered YES at
                  the file purge prompt at step 6, the system purges previous
                  versions of the Decision Expert files at this time.

                  Table 2-1 shows the files that the installation procedure
                  modifies or adds to the system, grouped by the directory to
                  which it copies them.






                                            Installing VAX Decision Expert  2-5

 











               Table 2-1:  Files the Installation Procedure Modifies or Adds
               ________________________________________________________________
               File_________________________Directory__________________________

               DEEX$STARTUP.COM             SYS$STARTUP

               DEEX$BUILD.COM               DEEX$SYSTEM

               DEEX$CONVERT_KB.COM          DEEX$SYSTEM

               DEEX$CVTKB.OBJ               DEEX$SYSTEM

               DEEX$DCL.CLD                 DEEX$SYSTEM

               DEEX$DEFS.ADA                DEEX$SYSTEM

               DEEX$DEFS.BAS                DEEX$SYSTEM

               DEEX$DEFS.DTR                DEEX$SYSTEM

               DEEX$DEFS.FOR                DEEX$SYSTEM

               DEEX$DEFS.H                  DEEX$SYSTEM

               DEEX$DEFS.MAR                DEEX$SYSTEM

               DEEX$DEFS.PAS                DEEX$SYSTEM

               DEEX$DEFS.PLI                DEEX$SYSTEM

               DEEX$DEFS.R32                DEEX$SYSTEM

               DEEX$DEFS.SDL                DEEX$SYSTEM

               DEEX$DELCMD.DAT              DEEX$SYSTEM

               DEEX$DELIVER_MAIN.EXE        DEEX$SYSTEM

               DEEX$DELIVER_MAIN_           DEEX$SYSTEM
               OPTION.OPT
               ________________________________________________________________
                                                       (continued on next page)



               2-6  Installing VAX Decision Expert

 











               Table 2-1 (Cont.):  Files the Installation Procedure Modifies or
                                   Adds
               ________________________________________________________________
               File_________________________Directory__________________________

               DEEX$DELIVER_SHR.EXE         DEEX$SYSTEM

               DEEX$DELIVER_SHR_OPTION.OPT  DEEX$SYSTEM

               DEEX$DELIVER_OBJLIB.OLB      DEEX$SYSTEM

               DEEX$DEVELOP_MAIN.EXE        DEEX$SYSTEM

               DEEX$DEVELOP_MAIN_           DEEX$SYSTEM
               OPTION.OPT

               DEEX$DEVELOP_OBJLIB.OLB      DEEX$SYSTEM

               DEEX$DEVELOP_SHR.EXE         DEEX$SYSTEM

               DEEX$DEVELOP_SHR_OPTION.OPT  DEEX$SYSTEM

               DEEX$DUMP.OBJ                DEEX$SYSTEM

               DEEX$HELP.HLB                DEEX$SYSTEM

               DEEX$KEYTBLS.DAT             DEEX$SYSTEM

               DEEX$MSG.ADA                 DEEX$SYSTEM

               DEEX$MSG.BAS                 DEEX$SYSTEM

               DEEX$MSG.DTR                 DEEX$SYSTEM

               DEEX$MSG.FOR                 DEEX$SYSTEM

               DEEX$MSG.H                   DEEX$SYSTEM

               DEEX$MSG.MAR                 DEEX$SYSTEM
               ________________________________________________________________
                                                       (continued on next page)




                                            Installing VAX Decision Expert  2-7

 











               Table 2-1 (Cont.):  Files the Installation Procedure Modifies or
                                   Adds
               ________________________________________________________________
               File_________________________Directory__________________________

               DEEX$MSG.MSG                 DEEX$SYSTEM

               DEEX$MSG.PAS                 DEEX$SYSTEM

               DEEX$MSG.PLI                 DEEX$SYSTEM

               DEEX$MSG.R32                 DEEX$SYSTEM

               DEEX$MSG.SDL                 DEEX$SYSTEM

               DEEX$PROFILE.KBASE           DEEX$SYSTEM

               DEEX$RULCMD.DAT              DEEX$SYSTEM

               DEEX$SUPCMD.DAT              DEEX$SYSTEM

               DEEX$SUPPORT_OBJLIB.OLB      DEEX$SYSTEM

               DEEX$TRECMD.DAT              DEEX$SYSTEM

               DEEX$UIL.UID                 DEEX$SYSTEM

               DEEX$UIL.UIL                 DEEX$SYSTEM

               DEEX$UPDKBV2.TXT             DEEX$SYSTEM

               DEEX$UTLCMD.DAT              DEEX$SYSTEM

               CVTKB.EXE (Unsupported)      DEEX$SYSTEM

               DUMP.EXE (Unsupported)       DEEX$SYSTEM

               UPDKBV2.EXE (Unsupported)    DEEX$SYSTEM
               ________________________________________________________________
                                                       (continued on next page)





               2-8  Installing VAX Decision Expert

 











               Table 2-1 (Cont.):  Files the Installation Procedure Modifies or
                                   Adds
               ________________________________________________________________
               File_________________________Directory__________________________

               DEEX$DCL.CLD                 DEEX$EXAMPLES

               DEEX$BUILD_DELIVERY.COM      DEEX$EXAMPLES

               DEEX$COPY_DELIVERY.COM       DEEX$EXAMPLES

               DEEX$DELIVERY_EXAMPLE_       DEEX$EXAMPLES
               MAIN.OPT

               DEEX$DELIVERY_EXAMPLE_       DEEX$EXAMPLES
               SHR.OPT

               DEEX$EXAMPLE_DCL.CLD         DEEX$EXAMPLES

               DEEX$EXAMPLE_MAIN.MAR        DEEX$EXAMPLES

               DEEX$EXAMPLE_VERSION.MAR     DEEX$EXAMPLES

               DEEX$010.RELEASE_NOTES       SYS$HELP

               HELPLIB.HLB (Modified)       SYS$HELP

               DCLTABLES.EXE (Modified)     SYS$LIBRARY

               DEEX$CKRCVR.IFT       SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$CKTTBL.AOR       SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$DICON.IFT        SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$FACT.KBASE       SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$MOTOR.DEC        SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]
               ________________________________________________________________
                                                       (continued on next page)





                                            Installing VAX Decision Expert  2-9

 











               Table 2-1 (Cont.):  Files the Installation Procedure Modifies or
                                   Adds
               ________________________________________________________________
               File_________________________Directory__________________________

               DEEX$NODE.KBASE       SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$RCRDSTUB.DEC     SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$RCVRFBS.IFT      SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$RCVRFNS.IFT      SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$RCVROK.DEC       SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$REFTBL.KBASE     SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$SYMANAL.IFT      SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$SYMPTOM.DEC      SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$SYSOK.DEC        SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$TOP.DEC          SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI]

               DEEX$IVP.COM          SYS$TEST

               DEEX$DELIVER_IVP_     SYS$SYSROOT:[SYSTEST.DEEX]
               MASTER.SCRIPT

               DEEX$DEVELOP_IVP_     SYS$SYSROOT:[SYSTEST.DEEX]
               MASTER.SCRIPT___________________________________________________


                  Step 8: Observe the Installation Verification Procedure.

                  If you chose to run the IVP in step 6, VMSINSTAL calls the
                  IVP now to verify that the software has been installed suc-
                  cessfully. The Decision Expert software constructs an if-then
                  table, runs inference in both the delivery environment and
                  the delivery package, and compares the results. Observe the
                  system messages. If you are logged on to a terminal and you
                  chose to run the IVP in step 6, the IVP fails.


               2-10  Installing VAX Decision Expert

 











                  Step 9: End the installation procedure.

                  When the installation procedure is complete, the system
                  displays this message:

                    Installation of VAX Decision Expert V1.0 completed at hh:mm

                    VMSINSTAL procedure done at hh:mm

                    $

                  If you have removed any media from the console drive before
                  beginning the installation, you should replace it now.

                  Note that VMSINSTAL deletes or changes entries in the process
                  symbol tables during the installation. Therefore, if you are
                  going to continue using the system manager's account and you
                  want to restore these symbols, log out and log in again.

               ____________________________________________________________

               2.2  VAX Decision Expert Logical Names

                  When you run @SYS$STARTUP:DEEX$STARTUP.COM, a system-wide
                  logical name table is created on your system and added to the
                  default logical name table search lists. Table 2-2 lists the
                  logical names. Check to make sure the installation has worked
                  correctly by issuing the following command:

                    $ SHOW LOGICAL DEEX*

                  Table 2-2:  Logical Names
                  _____________________________________________________________
                  Logical_Name_____File_or_Directory_Identified________________

                  DEEX$DELIVER_    Decision Expert delivery system executable
                  MAIN             file

                  DEEX$DEVELOP_    Decision Expert development system exe-
                  MAIN             cutable file
                  _____________________________________________________________
                                                       (continued on next page)



                                           Installing VAX Decision Expert  2-11

 











                  Table 2-2 (Cont.):  Logical Names
                  _____________________________________________________________
                  Logical_Name_____File_or_Directory_Identified________________

                  DEEX$DELIVER_    Decision Expert delivery system shareable
                  SHR              image

                  DEEX$DEVELOP_    Decision Expert development system shareable
                  SHR              image

                  DEEX$EXAMPLES    Directory of example knowledge bases

                  DEEX$HELP        Decision Expert Help library files

                  DEEX$KBASES      Directory where the knowledge base directo-
                                   ries reside

                  DEEX$KEYBINDINGS Directory where the key binding definitions
                                   reside

                  DEEX$PROFILE     Directory where the user profile file re-
                                   sides

                  DEEX$SYSTEM      Decision Expert software system directory

                  DEEX$UIL_DIR     Directory where the User Interface Database
                  _________________(UID)_file_resides__________________________


               ____________________________________________________________

               2.3  Installing VAX Decision Expert on a VAXcluster System

                  If you want to run the Decision Expert software on multiple
                  nodes of a VAXcluster system, first check to see that you
                  have the appropriate software license. Then, follow these
                  steps after installing the software:

                   1. Run the following commands on each node of the cluster:

                       $ LICENSE LOAD DECISION-EXPERT
                       $ @SYS$STARTUP:DEEX$STARTUP.COM



               2-12  Installing VAX Decision Expert

 











                   2. To use the product on other nodes in the VAXcluster,
                     you must replace the version of the DCL tables that is
                     installed on the other VAXcluster nodes. To do so, perform
                     the following steps:

                      a. Log on to a node on the cluster.

                      b. Run VMSINSTAL and enter the following command at the
                        INSTALL> prompt:

                          INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE

                      c. Repeat steps a and b for each node on the cluster.
































                                           Installing VAX Decision Expert  2-13

 

















                                                                      Chapter 3


                                                         After the Installation
               ________________________________________________________________


                  After installing the VAX Decision Expert software, you need
                  to perform the following tasks:

                   o Edit the system startup and shutdown files.

                   o Reboot the system.

                   o Set user account quotas.

                   o Modify system parameter settings.

                   o Modify the system startup command file (usually named
                     SYS$MANAGER:SYSTARTUP_V5.COM) to execute the file
                     SYS$STARTUP:DEEX$STARTUP.COM each time the system reboots.
                     This action defines the logical names required for the VAX
                     Decision Expert product.

                  The VAX Decision Expert software is now installed and all
                  users can invoke it with the DECIDE command.

                  You may want to install the shareable images DEEX$DEVELOP_
                  SHR.EXE and DEEX$DELIVER_SHR.EXE in memory to improve perfor-
                  mance. See the VMS Install Utility Manual.

                  The installation procedure modifies the DCL command table so
                  that the system recognizes and processes the DECIDE command.
                  However, the previous command table is still in effect for
                  those users who are currently logged in. All logged-in users
                  who want to use the DECIDE command must log out and log in
                  again.


                                                    After the Installation  3-1

 










               ____________________________________________________________

               3.1  Running the Installation Verification Procedure Separately

                  When you install the software while logged on to a VAXstation,
                  you usually run the Installation Verification Procedure (IVP)
                  at installation. If you want to run the IVP separately to
                  ensure the integrity of installed files after system prob-
                  lems occur, log on to a VAXstation and execute the following
                  command procedure:

                    $ @SYS$SYSCOMMON:[SYSTEST]DEEX$IVP.COM

                  If the IVP fails, the system displays error messages as
                  described in Section 3.2.

               ____________________________________________________________

               3.2  Error Conditions

                  If the installation procedure fails, the software displays a
                  message similar to the following:

                    %VMSINSTAL-E-INSFAIL, The installation of
                    VAX Decision Expert V1.0 has failed.

                  An error during the installation can occur if one or more of
                  the following conditions exists:

                   o The operating system version is incorrect.

                   o The prerequisite software version is incorrect.

                   o The quotas necessary for successful installation are
                     insufficient (see Chapter 2).

                   o The process quotas required by VMSINSTAL are incorrect
                     (see Section 1.6).

                   o The VMS Help library is currently in use.

                   o The product was registered incorrectly or not registered.

                  For descriptions of the error messages generated by these
                  conditions, refer to the VMS System Messages and Recovery
                  Procedures Reference Volume, the installation/operations
                  guide for your processor, or the VMS License Management
                  Utility Manual.

               3-2  After the Installation

 











                  If the system notifies you that any of these conditions
                  exists, you should take appropriate action as described in
                  the message. You may need to change a system parameter or
                  increase an authorized quota value.

                  If the installation fails, you must restart the installation
                  procedure from step 2. If the installation fails due to
                  an IVP failure, and you are installing the product while
                  logged on to a VAXstation, contact a Digital Field Service
                  representative.

               ____________________________________________________________

               3.3  Maintenance Updates

                  Digital issues periodic maintenance updates of Decision
                  Expert software. Each update consists of an installation
                  kit. Install the kit as described in this document or in the
                  documentation that accompanies the maintenance update.

                  Each time a maintenance update is released, the version
                  number changes. For example, if the current version is V1.0,
                  the version number of the first maintenance update will
                  be V1.1. In addition, the maintenance update includes new
                  release notes. The release notes describe the changes that
                  have been made to Decision Expert since the previous release.

                  The update release notes are provided on line. You should
                  read the release notes before you install the Decision Expert
                  software; they are also accessible at any time after the
                  product is installed. For information on reading the release
                  notes at the time that you install Decision Expert, follow
                  the installation procedure through step 5. To locate the
                  release notes after you have installed the software, display
                  or print the file DEEX$010.RELEASE_NOTES.

               ____________________________________________________________

               3.4  Determining and Reporting Problems

                  If an error occurs while you are using Decision Expert
                  and you believe that the error is caused by a problem with
                  Decision Expert software, take one of the following actions:

                   o If you purchased Decision Expert within the past 90 days
                     and you think the problem is caused by a software error,
                     submit a Software Performance Report (SPR).

                                                    After the Installation  3-3

 











                   o If you have a BASIC or DECsupport Software Agreement,
                     call your Customer Support Center. With these services,
                     you receive telephone support that provides high-level
                     advisory and remedial assistance. For more information,
                     contact your local Digital representative.

                   o If you have a Self-Maintenance Software Agreement, submit
                     a Software Performance Report (SPR).





































               3-4  After the Installation

 

















                                                                     Appendix A


                                                            Sample Installation
               ________________________________________________________________


                  This section contains a .LOG file for a sample installation
                  of VAX Decision Expert software. The installation procedure
                  is sometimes modified in maintenance updates of this product.
                  Because this installation guide is not usually revised for
                  maintenance updates, be sure to read the letter entitled
                  Read Before Installing or Using VAX Decision Expert before
                  you install this product. The letter notes any significant
                  changes in the installation procedure.


                 Unauthorized Access is Prohibited

               Username: SYSTEM
               Password:

                 Property of Digital Equipment Corporation - INTERNAL USE ONLY

                Welcome to VAX/VMS V5.1

                   Last interactive login on Friday, 14-APR-1989 13:45
                   Last non-interactive login on Thursday, 13-APR-1989 11:27

               $ set default sys$update
               $ @vmsinstal deex010 mua0: options n

                VAX/VMS Software Product Installation Procedure V5.1

               It is 14-APR-1989 at 13:54.
               Enter a question mark (?) at any time for help.
               %VMSINSTAL-W-DECNET, Your DECnet network is up and running.
               * Do you want to continue anyway [NO]? YES
               * Are you satisfied with the backup of your system disk [YES]?

                                                       Sample Installation  A-1

 











               Please mount the first volume of the set on  MUA0:.
               * Are you ready? YES
               %MOUNT-I-MOUNTED, DEEX01 mounted on _MUA0:
               The following products will be processed:
                 DEEX V1.0

                Beginning installation of DEEX V1.0 at 13:57

               %VMSINSTAL-I-RESTORE, Restoring product saveset A ...

                   Release Notes Options:

                1.  Display release notes
                2.  Print release notes
                3.  Both 1 and 2
                4.  Copy release notes to SYS$HELP
                5.  Do not display, print or copy release notes

               * Select option [2]:
               * Do you want to continue the installation? YES
               * In which directory is VAX Decision Expert to be installed
               [SYS$COMMON:[DEEX$SYSTEM]]:
               * Is directory SYS$COMMON:[DEEX$SYSTEM] correct [YES]?
               * Do you want to purge files replaced by this installation [YES]?

                   This kit contains an Installation 
                   Verification Procedure (IVP)
                   to verify the correct installation of the VAX Decision Expert
                   system. It can be run prior to the conclusion of 
                   this procedure
                   by answering "YES" to the IVP prompt or invoked after the
                   installation as follows:

                   @SYS$COMMON:[SYSTEST]DEEX$IVP.COM

               * Do you want to run the IVP after the installation [YES]? NO

                       Product:      DECISION-EXPERT
                       Producer:     DEC
                       Version:      1.0
                       Release Date: 13-DEC-1988






               A-2  Sample Installation

 











               * Does this product have an authorization key registered
               and loaded? YES
               %DEEX-I-NOMOREQUESTIONS, No further questions will be asked.
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
               SYS$COMMON:[SYSHLP.EXAMPLES.DEEX].
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
               SYS$COMMON:[SYSHLP.EXAMPLES.DEEX.FULLHIFI].
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
               VMI$ROOT:[SYSTEST.DEEX].
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
               SYS$COMMON:[DEEX$SYSTEM].

                You should modify the system startup command file
                usually named SYS$MANAGER:SYSTARTUP_V5.COM to
                execute the file SYS$STARTUP:DEEX$STARTUP.COM each
                time the system reboots.  This defines the logical
                names required for the VAX Decision Expert product.

               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target
               directories...

                Installation of DEEX V1.0 completed at 14:18

                VMSINSTAL procedure done at 14:18

               $ logout
                 SYSTEM       logged out at 14-APR-1989 14:20:10.36


















                                                       Sample Installation  A-3

 




















                                                                      Index
               ________________________________________________________________


               A___________________________    I___________________________

               Aborting installation           Installation
                  procedure, 2-1                 files modified or added
               Asterisk in installation            by, 2-6  to 2-10
                  procedure, 2-2                 on a cluster, 2-12  to
                                                   2-13
               B___________________________      sample, A-1  to A-3
               Backing up disks before           tasks to perform after,
                  installation, 2-2                3-1
               Bill of materials (BOM), 1-1    Installation options, 1-5,
                                                  2-4  to 2-5
               D___________________________      authorization key, 2-5
               Disk backup, 2-2                  directory, 2-4
               Distribution media, mounting      Installation Verification
                  , 1-1                            Procedure (IVP), 2-4
                                                 purging files, 2-4
               E                               Installation procedure, 2-1
               ____________________________       to 2-11
               Error conditions, 3-2  to         aborting, 2-1
                  3-3                            asterisk in, 2-2
                                                 backup before, 2-2
               F___________________________    Installation Verification
               Files modified or added by         Procedure (IVP), 2-4,
                  installation, 2-6  to           2-10
                  2-10                           running separately, 3-2

                                                                        Index-1

 






          L___________________________
          Logging in, 2-1                 R___________________________

          Logical names, 2-11  to 2-12    Release notes
          M                                 accessing, 1-2
          ____________________________      displaying, 2-3
          Maintenance updates, 3-3          options, 2-3
          Mounting distribution media,      printing, 2-3

             1-1                          S
                                          ____________________________
          P___________________________    Setting default, 2-1
          Privileges                      Symbols, restoring, 2-11

            required for installation,    V
               1-2                        ____________________________
            required for use, 1-2  to     VAXcluster, installation on,
               1-3                           2-12  to 2-13
          Problems, reporting, 3-3  to    VMSINSTAL
             3-4                            command procedure, 1-4  to
          Product Authorization Key           1-6
             (PAK), 1-3  to 1-4, 2-5        invoking, 2-2

















          Index-2
