 


















                     DECpresent____________________________________
                     Installation Guide for VMS Systems

                     Order Number: AA-NB92A-TE


                     November 1990

                     This guide describes how to install DECpresent on a
                     VMS system.





                     Revision/Update Information: This is a new manual.

                     Operating System:            VMS Version 5.3 or
                                                  higher

                     Software Version:            DECpresent Version
                                                  1.0







                     Digital Equipment Corporation
                     Maynard, Massachusetts

 






              __________________________________________________________
              November 1990

              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.

              The 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 on 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 1990.

              All Rights Reserved.  The following are trademarks of
              Digital Equipment Corporation: CDA, DTIF, DDIF, DEC,
              DECcalc, DECchart, DECdecision, DECnet, DECpresent,
              DECwindows, DECwrite, Digital, LiveLink, PrintServer 40,
              ReGIS, ScriptPrinter, ULTRIX, ULTRIX Worksystem Software,
              VAXcluster, VAX RMS, VAXstation, VMS, VT, XUI, and the
              Digital logo.

              The following are third-party trademarks:

              Helvetica and Times are registered trademarks of Linotype
              Company.

              ITC Avant Garde Gothic, ITC Souvenir, and ITC Lubalin
              Graph are registered trademarks of International Typeface
              Corporation.

              PostScript is a registered trademark and Display
              PostScript is a trademark of Adobe Systems, Inc.

              Arts and Letters[R] is a registered trademark of Computer
              Support Corporation.

              International Hyphenators, and International CorrectSpell[TM]
              licensed from Houghton Mifflin Company. © 1987, 1988 by
              Houghton Mifflin. German© 1985, 1987 by Langenscheidt K.G.
              French in cooperation with Librairie Larousse. Italian©
              1988 by Nicola Zanichelli. All rights reserved. U.S. Pat.
              Nos. 4,580,241, 4,724,523 and 4,771,401. Canadian Pat.
              No. 1,203,916. English based upon THE AMERICAN HERITAGE
              DICTIONARY. Reproduction or disassembly of embodied
              computer programs or algorithms prohibited.

              Arts and Letters[R] clipart licensed to Digital Equipment
              Corporation, Maynard, Massachusetts. ©Computer Support
              Corporation 1985-1990. All rights reserved.

                                                                  ZK5529

 













     ________________________________________________________________

                                                             Contents


     Preface..................................................      v


     1  Preparing for DECpresent Installation

           1.1   DECpresent Distribution Kit..................      1
           1.2   Prerequisite Software........................      2
           1.3   Prerequisite Hardware........................      3
           1.4   Privileged Account...........................      3
           1.5   License Registration.........................      3
           1.6   VAXcluster Considerations....................      4
           1.7   System Quotas................................      4
           1.7.1     Disk Space Requirements..................      5
           1.7.2     System Parameter Values..................      6
           1.7.2.1     Checking Parameter Values..............      6
           1.7.2.2     Calculating GBLPAGES and GBLSECTIONS
                       Parameter Values.......................      7
           1.7.2.3     Changing Parameter Values with AUTOGEN.      7
           1.8   System Disk Backup...........................      8
           1.9   Displaying DECpresent on Non-VMS Systems.....      8

     2  Installing DECpresent

           2.1   Installing the Video Fonts for the Equation
                 Editor and Bullets...........................      9
           2.2   VMSINSTAL Requirements.......................     10
           2.3   VMSINSTAL Procedure..........................     11







                                                                  iii

 






        3  DECpresent Postinstallation Procedures

              3.1   Editing Startup Files........................     25
              3.1.1     Editing SYSTARTUP_V5.COM.................     25
              3.1.2     Editing PRESENT$STARTUP.COM..............     28
              3.2   Installing DECpresent on a Standalone System.     28
              3.3   Installing DECpresent on a VAXcluster........     29
              3.4   Rebooting the System.........................     30
              3.5   User Account Requirements....................     30
              3.5.1     Privileges...............................     30
              3.5.2     User Account Quotas......................     31
              3.6   Tuning Your System...........................     32
              3.7   Selecting a Language.........................     32
              3.8   Installation Verification Procedures.........     33
              3.9   Using the Font Utility.......................     33
              3.9.1     Preparing to Run the Font Utility........     34
              3.9.2     Font Utility Startup.....................     34
              3.9.3     Font Utility Commands and Descriptions...     35
              3.10  Files Copied During Installation.............     38
              3.11  Running DECpresent from FileView.............     40
              3.12  Running DECpresent from DCL..................     40
              3.13  Determining and Reporting Problems...........     40

        A  Sample DECpresent Installation

              A.1   Full DECpresent Installation.................     43
              A.2   Video Font Only DECpresent Installation......     49

        Index


        Figures

              2-1       Successful Installation Display..........     21











        iv

 






        Tables

              1-1       Free Disk Blocks Required to Install
                        DECpresent...............................      5

              1-2       Minimum Required Global Pages and
                        Sections.................................      6

              2-1       DECpresent Kit Names.....................     11

              3-1       Language Parameters......................     27

              3-2       User Account Quotas......................     31

              3-3       Font Utility Commands....................     35






























                                                                       v

 











        ________________________________________________________________

                                                                 Preface



        Purpose of This Guide

              This guide describes how to install DECpresent on the
              VMS operating system. You should review the entire guide
              before you start the installation.

        Who Should Use This Guide

              This guide is for VMS system managers or others responsi-
              ble for installing system software. To install DECpresent
              software, you must have access to a privileged account
              such as the SYSTEM account, and you must be familiar with
              the VMS installation procedure (VMSINSTAL).

        Structure of This Guide

              The guide has three chapters and two appendixes. Chapter 1
              describes installation prerequisites and suggestions.
              Chapter 2 describes the installation procedure. Chapter 3
              describes postinstallation tuning and general usage
              information. Appendix A shows a sample installation
              procedure for reference purposes.

        For More Information

              For more information on the VMSINSTAL command, see one of
              the following books:

              o  VMS System Manager's Manual (VMS Version 5.3 base
                 documentation set)

              o  Guide to Setting Up a VMS System (VMS Version 5.3 full
                 documentation set)

                                                                       v

 






              Refer to the DECpresent User's Guide or the online
              DECpresent Learn Modules for more information about
              DECpresent. Display the Learn Modules by choosing one
              of the topics from the DECpresent Learn menu.


        Conventions

        <Ctrl/x>              A sequence such as <Ctrl/x> indicates that
                              you must hold down the key labeled Ctrl
                              while you press another key or a pointing
                              device button.

        <Delete>              A key name is shown enclosed to indicate
                              that you press a key on the keyboard.

        blue-green ink        For hardcopy books, blue-green ink
                              indicates information that you must enter
                              from the keyboard or a screen object that
                              you must choose or click on. For online
                              versions, user input is shown in bold.

        italic text           Italic text represents information that
                              can vary in system messages (for example,
                              Internal error number).

        UPPERCASE TEXT        Uppercase letters indicate that you
                              must enter a command (for example, enter
                              OPEN/READ) or a response to system prompt.
                              Uppercase letters also indicate the name
                              of a routine, the name of a file, the
                              name of a file protection code, or the
                              abbreviation for a system privilege.

        DECpresent            The term DECpresent refers to the
                              DECpresent[TM] software.

        DECchart              The term DECchart refers to the DECchart[TM]
                              software.






        vi

 









                                                                       1
        ________________________________________________________________

                                   Preparing for DECpresent Installation



              This chapter describes tasks you must perform when
              installing DECpresent, and suggests how to prepare for
              installation.

              Installing DECpresent is similar to installing other VMS
              layered products. You should:

              1. Take an inventory of the software distribution kit.

              2. Make sure your system has the prerequisite software and
                 hardware.

              3. Register your DECpresent license according to the VMS
                 License Registration section in this chapter.

              4. Prepare your system and its users for installation.

              5. Print and read the release notes.

              6. Perform the installation procedure and any necessary
                 postinstallation procedures.

              7. Resume normal operations after you complete the
                 installation.

              You should allow approximately 70 minutes for the
              installation and 10 minutes to run the Installation
              Verification Procedure (IVP).

        1.1 DECpresent Distribution Kit

              Each DECpresent distribution kit contains:

              o  A bill of materials (BOM) and indented bills report
                 (BIL)

              o  The distribution medium for the DECpresent software

              o  Documentation for the product

                 Media-only kits include the installation guide only.

                                 Preparing for DECpresent Installation 1

 






              o  The Product Authorization Key (PAK)

              To ensure that you have a complete kit, check the kit
              contents against the bill of materials and the indented
              bills report.

              If your kit is damaged or if you find that parts of it are
              missing, contact your Digital representative.

        1.2 Prerequisite Software

              To install DECpresent you must have:

              o  A valid VMS operating system configuration running VMS
                 Version 5.3 or higher, having the VMS Required saveset

              o  DECwindows installed

                 To execute the IVP during the installation, DECwindows
                 should also be running.

              Since DECpresent is a DECwindows application, it can run
              in either of the following ways:

              o  Standalone execution - running the DECwindows X11
                 display server and the client application on the same
                 machine

              o  Remote execution - running the DECwindows X11 display
                 server and the client application on different machines

                 This requires that DECnet also be installed.

              For standalone execution, the following DECwindows
              components must be installed on the machine:

              o  VMS DECwindows Compute Server (base kit, which includes
                 run-time support)

              o  VMS DECwindows Device Support

              For remote execution, the following DECwindows components
              must be installed:

                 On the workstation:

                 o  VMS DECwindows Compute Server (base kit, which
                    includes run-time support)

                 o  VMS DECwindows Device Support

                 On the remote machine:

        2 Preparing for DECpresent Installation

 






                 o  VMS DECwindows Compute Server (base kit, which
                    includes run-time support)

                 o  VMS DECwindows Device Support (optional)

                    Refer to the VMS Version 5.3 Installation Guide for
                    details.

        1.3 Prerequisite Hardware

              DECpresent supports all hardware configurations supported
              by a VMS Version 5.3 system running DECwindows, with a
              minimum of 8 MB of memory. See the DECpresent Software
              Product Description (SPD) for details on supported
              hardware configurations.

        1.4 Privileged Account

              To install DECpresent, you must be logged into an account
              that has the following privileges:

              o  CMKRNL

              o  WORLD

              o  SYSPRV

              Most system managers install software from the SYSTEM
              account.

              Note that the VMSINSTAL command turns off BYPASS privilege
              at the start of the installation.

        1.5 License Registration

              The DECpresent Product Authorization Key (PAK) should
              be registered and loaded before you install or use
              DECpresent. The information you need is in the PAK shipped
              with DECpresent. The PAK is a paper certificate that
              contains data about your license.

              If you do not register and load the license before
              installing DECpresent, the installation will complete
              but the Installation Verification Procedure (IVP) will
              not run. You can execute the IVP manually after the
              installation by following the instructions in Chapter 2.

                                 Preparing for DECpresent Installation 3

 






              To register the license, first log in to a privileged
              account such as the system manager's account, SYSTEM.
              Then choose one of the following procedures to perform the
              registration. The second method is faster for experienced
              users.

              o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When
                 prompted for information, respond with data from your
                 Product Authorization Key (PAK).

                 OR

              o  Issue the DCL commands LICENSE REGISTER and LICENSE
                 LOAD with the appropriate qualifiers that correspond to
                 information on the PAK.

              For additional information, see the License Management
              Facility section in your VMS Version 5.3 documentation
              set.

        1.6 VAXcluster Considerations

              You can install DECpresent on a VAXcluster.

              In a VAXcluster with a common system disk, you can execute
              the installation procedure on a single member of the
              cluster. After the installation is completed, each VAX
              processor can share the same DECpresent software.

              You must check the number of global sections and global
              pages on each node in the VAXcluster where you plan to
              install DECpresent. Instructions for checking these values
              are in the next section.

              See Chapter 3 for details about VAXcluster postinstalla-
              tion instructions.

        1.7 System Quotas

              You use the VMSINSTAL command to install DECpresent. For
              VMSINSTAL to run properly, there must be sufficient disk
              storage space and proper system parameter settings to
              accommodate the installation. This section describes the
              recommended disk space and system parameters.

        4 Preparing for DECpresent Installation

 






        1.7.1 Disk Space Requirements

              Installing DECpresent requires a certain amount of disk
              storage space. Once the installation is complete, less
              storage space is required. Table 1-1 summarizes the
              storage requirements.

              DECpresent includes DECchart Version 1.1, the Equation
              Editor, and the CDA Library Version 1.1. The installation
              procedure checks to see if these bundled applications are
              already installed on your system. DECpresent does not
              install these parts of the kit if they already exist
              on your system. As a result, the disk space required
              for installation may be less than the amount shown in
              Table 1-1.

              The VMSINSTAL command now has an Alternate Working
              Directory (AWD) option. This option directs VMSINSTAL
              to create its temporary files in a directory you specify.
              This allows you to temporarily use space on another disk
              if your system disk space is limited. If you do not have
              the recommended disk space available, try installing using
              the AWD option.

              Table_1-1_Free_Disk_Blocks_Required_to_Install_DECpresent_

                          During
              InstallationInstallationAfter_Installation[1]_____________

              Complete    35,000      34,500

              Font Only   1,500       1,000
              [1]These_values_are_approximate,_but_are_the_maximum_that_

              the installation will require. The installation procedure
              reports the actual number of blocks required, which will
              be slightly less than these values, and may differ from
              the sample installation in Chapter 2.
              __________________________________________________________

                ________________________Note  ________________________

                These values apply only to the US variant. Please
                see the cover letter for the values for all other
                language variants.

                _____________________________________________________

                                 Preparing for DECpresent Installation 5

 






              Use the DCL command SHOW DEVICE to determine the number
              of free blocks that are presently available on the system
              disk:

              $ SHOW DEVICE SYS$SYSDEVICE

              If the disk does not have enough free blocks, delete
              unnecessary files to provide space.

        1.7.2 System Parameter Values

              Digital recommends that the system parameter WSMAX be set
              to at least 4,100. On a single-user workstation, it can be
              set even higher, depending on the amount of workstation
              memory.

              The DECpresent executable images and the shared libraries
              can be installed using the INSTALL utility. Table 1-2
              lists the minimum required system parameter values.

              Table_1-2_Minimum_Required_Global_Pages_and_Sections______

              System_Parameter____Minimum_Value_________________________

              GBLPAGES            4,108

              GBLSECTIONS_________13____________________________________

              If GBLPAGES or GBLSECTIONS are below the recommended
              values, VMSINSTAL displays a message. Since installing
              the DECpresent images and shared libraries is optional,
              you can safely continue the installation. Make sure
              to adjust these system parameters before modifying
              PRESENT$STARTUP.COM. See Chapter 3 for details.

        1.7.2.1 Checking Parameter Values

              To check the value of one or more parameters, enter the
              following command at the DCL prompt:

              $ RUN SYS$SYSTEM:SYSGEN
              SYSGEN>

              At the SYSGEN> prompt, use the SHOW command to display the
              value of each system parameter.

        6 Preparing for DECpresent Installation

 






              After you finish checking parameter values, use the EXIT
              command to return to DCL level.

        1.7.2.2 Calculating GBLPAGES and GBLSECTIONS Parameter Values

              The values for GBLPAGES and GBLSECTIONS in Table 1-2
              indicate that you must have at least 4,108 unused global
              pages and 13 unused global sections available for the
              installation.

              To calculate the number of unused global pages and global
              sections in your system:

              1. Use the DCL F$GETSYI lexical function to determine the
                 number of free global pages and global sections:

                 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES")
                 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")

              2. If the number of unused global pages is less than the
                 number specified in Table 1-2, you must increase the
                 value using the AUTOGEN command procedure (instructions
                 follow).

              The next section describes the procedures for changing
              these values. For more information, refer to the VMS
              system management documentation.

        1.7.2.3 Changing Parameter Values with AUTOGEN

              You use the AUTOGEN command procedure to change system
              parameters. AUTOGEN automatically adjusts values for
              parameters that need to be changed.

              To change system parameters with AUTOGEN:

              1. Edit the SYS$SYSTEM:MODPARAMS.DAT file:

                 For example, to increase the setting for the GBLPAGES
                 system parameter by 2,000, add this line to the file:

                 ADD_GBLPAGES = 2000

              2. Enter the following command to recalculate your system
                 parameters:

                 $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

                                 Preparing for DECpresent Installation 7

 






                 AUTOGEN performs an automatic system shutdown and
                 reboots when it has finished. Rebooting your system
                 makes the new parameter values active.

              For more information about using AUTOGEN, see the
              instructions on modifying system parameters in the VMS
              system management documentation.

        1.8 System Disk Backup

              Make a backup copy of your system disk before you install
              DECpresent.

              For more information about backing up your system disk,
              refer to the VMS system management documentation.

        1.9 Displaying DECpresent on Non-VMS Systems

              If you plan to display DECpresent on non-VMS workstations,
              you must first compile and install the required video
              fonts on the display workstations.

              For example, suppose you install DECpresent on an VAX/VMS
              workstation. If you attempt to display that software on
              an VAX/ULTRIX workstation, you will receive font display
              errors.

              For information about compiling and installing the video
              fonts on remote display devices, refer to the DECpresent
              Release Notes, which are copied to the following directory
              during the DECpresent installation:

              SYS$COMMON:[SYSHLP]PRESENT010.RELEASE_NOTES

              You can obtain additional information on compiling fonts
              by typing the following command at the DCL prompt:

              $ HELP FONT







        8 Preparing for DECpresent Installation

 









                                                                       2
        ________________________________________________________________

                                                   Installing DECpresent



              This chapter describes how to run the DECpresent
              installation procedure. You should allow approximately
              80 minutes to complete the entire installation. Before you
              start installing DECpresent, make sure your system meets
              the requirements outlined in Chapter 1.

              This version of DECpresent supports language switching. If
              you have purchased language variants of DECpresent, you
              can install multiple language variants on a single system.
              You choose which langage variant to use by selecting the
              language from the Session Manager Language dialog box
              before you start DECpresent. See Table 2-1 for a list of
              the language variant kits.

              Appendix A contains a printout of a typical installation
              procedure for your reference.

        2.1 Installing the Video Fonts for the Equation Editor and
            Bullets

              Like other DECwindows software products, you can install
              DECpresent on one DECwindows system and display it on
              another. However, the system that displays DECpresent must
              have access to the DECpresent video fonts.

              You can install the entire DECpresent kit or just the
              video fonts. The video fonts are required for displaying
              the Equation Editor and for the Bullets dialog box on a
              remote workstation. The Equation Editor allows users to
              create complex mathematical equations and include them
              in their presentations. The Bullets dialog box allows you
              to choose alternate characters for the bullets on your
              slides.


                                                 Installing DECpresent 9

 






              If you are installing DECpresent on a VAXcluster, install
              the entire kit. Restart the DECwindows server on each of
              the satellite workstations so they can have access to the
              video fonts. You do not need to install the video fonts
              on the satellites in a VAXcluster if the entire kit is
              installed on the VAXcluster boot node. See Chapter 3 for
              more information.

              However, if you plan to display DECpresent on a remote
              workstation, one that is not part of the VAXcluster, you
              must install the video fonts on the workstation.

              Similarly, if a standalone workstation user, not running
              DECpresent, wants to use either DECwindows Mail or the
              CDA viewer to view documents containing equations and
              alternate bullets, then the video fonts must be installed
              on that workstation.

              And finally, users who wish to display DECpresent on
              a personal computer must also install the video fonts
              for the Equation Editor and slide bullets. See your PC
              documentation for the procedures you need to install the
              fonts on the PC. For the location of the video font files
              on your workstation, see Section 3.10.

        2.2 VMSINSTAL Requirements

              When you invoke the VMSINSTAL command, it checks:

              o  Whether you are logged in to a privileged account

              o  Whether you have adequate quotas for installation

              o  Whether DECnet is up and running

              o  Whether any users are logged in to the system

              If VMSINSTAL detects a problem during the installation
              procedure, it notifies you and asks if you want to
              continue. To stop the installation and correct the
              problem, enter NO or press the Return key. After you have
              made the correction, you can restart the installation.

              To abort the installation procedure at any time, press
              Ctrl/Y. The installation procedure deletes all files
              it has created up to that point and exits. You can then
              restart the installation.

        10 Installing DECpresent

 






              Digital recommends that you refer to the section on the
              VMSINSTAL command in your VMS documentation set. In the
              VMS base documentation set, see the VMS System Manager's
              Manual. In the VMS full documentation set, see the Guide
              to Setting Up a VMS System.

        2.3 VMSINSTAL Procedure

              You must use the VMSINSTAL command procedure to install
              DECpresent. Follow these steps to begin the installation:

              1. Log in to a privileged account such as the VMS system
                 manager's account, SYSTEM.

              2. If a previous version of DECpresent has been installed
                 on your system, send a message requesting that all
                 users exit from DECpresent.

              3. Make sure DECwindows is running. If you have not
                 previously executed the SYS$STARTUP:DECW$STARTUP.COM
                 command procedure, do so at this time.

              4. Enter the following command line to run VMSINSTAL:

                 $ @SYS$UPDATE:VMSINSTAL PRESENT010 device-name OPTIONS N

                 where device-name is the device specification for the
                 distribution medium, for example, MUA0: and where kit-
                 name is the language variant DECpresent kit. If you
                 have purchased one or more language variants, Table 2-1
                 lists their DECpresent kit names.

              Table_2-1_DECpresent_Kit_Names____________________________

              Language_Variant______Kit_Name____________________________

              American English      DECPRESENT

              Dutch                 DECPRESENTNE

              French                DECPRESENTFR

                Belgian French      DECPRESENTFR

                                                (continued on next page)

                                                Installing DECpresent 11

 






              Table_2-1_(Cont.)_DECpresent_Kit_Names____________________

              Language_Variant______Kit_Name____________________________

                Canadian French     DECPRESENTFR

                Swiss French        DECPRESENTFR

              German                DECPRESENTDE

                Swiss German        DECPRESENTDE

              Italian               DECPRESENTIT

                Swiss Italian       DECPRESENTIT

              Swedish_______________DECPRESENTSV________________________


                 Specifying OPTIONS N indicates that you want to be
                 prompted to display or print the Release Notes.

                 Specifying OPTIONS AWD=device:directory allows you to
                 specify an alternate device that VMSINSTAL will use as
                 the temporary working directory.

                ______________________ Caution ______________________

                If the device:directory specified in the AWD option
                already exists, the installation procedure will
                delete it and create it again.

                _____________________________________________________

                 If you do not specify the AWD option, the installation
                 creates the temporary working directory on the system
                 disk by default.

                 VMSINSTAL has several other options, described in the
                 VMS software installation documentation.

                 A message similar to the following appears on your
                 screen:


        12 Installing DECpresent

 






                         VAX/VMS Software Product Installation Procedure V5.3

                 It is 20-SEP-1990 at 15:22.

                 Enter a question mark (?) at any time for help.

                 Your DECnet network is up and running.
                 %VMSINSTAL-W-ACTIVE, The following processes are still active:
                  L
                  M
                  N
                  O
                  P
                 * Do you want to continue anyway [NO]?

                 DECwindows requires that DECnet be up and running.

              5. Enter YES to continue the installation.

                 You are asked whether you need to back up your system
                 disk:

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

                 Generally, you should back up your system disk before
                 any major software installation, as you were instructed
                 in Chapter 1. YES is the default answer. If you backed
                 up your system disk recently, press the Return key to
                 continue.

                 Next, you receive instructions to mount the distribu-
                 tion medium you specified when you invoked VMSINSTAL
                 (in this example, MUA0:). If you did not specify where
                 you would mount the distribution volumes the system
                 prompts you to identify where you have mounted them.

                 Please mount the first volume of the set on MUA0:.
                 * Are you ready?

              6. Mount the medium, then enter YES to indicate that you
                 are ready to continue.

                 The following messages appear on your screen:


                                                Installing DECpresent 13

 






                 The following products will be processed:

                   PRESENT V1.0

                         Beginning installation of DECPRESENT V1.0 at 15:22

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

                 If you selected OPTIONS N when you first invoked the
                 VMSINSTAL procedure, a menu asks you how you want to
                 handle the Release Notes:

                 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]:

                 You should review the Release Notes in case they con-
                 tain any information about changes in the installation
                 procedures. Choosing option 3 displays the Release
                 Notes and prints a copy.

                 If you do choose an option that prints the Release
                 Notes, you are prompted for a print queue:

                 * Queue name [SYS$PRINT]:

              7. Press the Return key to print the Release Notes on
                 SYS$PRINT, or type a different queue name and press
                 Return.

                 The screen displays a message similar to the following:

                 Job 810 (queue SYS$PRINT, entry 1295) started on SYS$PRINT

                 You are asked whether you want to continue with the
                 installation:

                 * Do you want to continue the installation?

              8. Enter YES to continue, otherwise press the Return key.

        14 Installing DECpresent

 






                 In either case, the Release Notes are copied to a file
                 in the SYS$HELP directory and you receive a message
                 similar to the following:

                 %VMSINSTAL-I-RELMOVED, The product's release notes have been
                 successfully moved to SYS$HELP.

                 The Release Notes are contained in SYS$HELP: and have
                 the name PRESENT010.RELEASE_NOTES.

                 Note that the name of the Release Notes file includes
                 the product name and version number.

                 Do not delete Release Notes for previous versions of
                 DECpresent.

                 The screen displays the following messages:

                                 DECpresent V1.0 Installation Procedure

                     International Hyphenators and International CorrectSpell (TM)
                     Copyright (c) 1985, 1987, 1988 by Houghton Mifflin.  All rights
                     reserved. US Pat. Nos. 4,508,241, 4,730,269, and 4,771,401.
                     Canadian Pat. No. 1,203,916.

                     Portions licensed to Digital Equipment Corporation, Maynard,
                     Massachusetts Copyright (c) Frame Technology Corporation 1989.
                     All rights reserved.

                 %VMSINSTAL-I-RESTORE, Restoring product save set B ...
                 %VMSINSTAL-I-RESTORE, Restoring product save set C ...

                      You can install the DECpresent kit completely or just the video
                      fonts required to create equations and bullets.

                      If you are installing this kit for use on a workstation, or on a
                      VAXcluster that includes workstations, then you should install
                      the entire kit. This requires 33935 blocks.

                      If you are installing this kit on a workstation that will only run
                      DECpresent from a remote system, then only the video font files
                      are needed. This requires 1518 blocks.

                 If you are installing DECpresent on a VAXcluster
                 that includes workstations, you should install the
                 entire kit. Workstations that will run DECpresent
                 from a remote system require only that the video
                 fonts be installed locally. See Section 2.1 for more
                 information.

                                                Installing DECpresent 15

 






                 You receive information about the number of blocks
                 required to install the entire kit or only the video
                 font files. You are then asked if you want to install
                 the entire kit:

                 * Do you want to install the entire kit [YES]?

                 This procedure assumes you are installing the kit on a
                 standalone system or VAXcluster and that you will be
                 installing the entire kit. See Appendix A for a sample
                 printout of how the installation appears if you install
                 only the video fonts.

              9. Press the Return key.

                 The installation procedure will then check to see
                 what version of DECchart is installed on your system.
                 Depending on what version of DECchart is installed,
                 the installation procedure will either install a newer
                 version or leave the current version on your system.

                 For example, if DECchart has not been installed on your
                 system, the installation procedure will display the
                 appropriate message.

                     This kit requires DECchart V1.1 or later.

                     *************************************************************

                     DECchart V1.1 will be installed since it does
                     not exist on your system.

                     *************************************************************

                 The installation procedure then checks whether the
                 Equation Editor has been installed on your system.
                 If the Equation Editor has not been installed, the
                 installation procedure will install it automatically.

                 For example, if the Equation Editor has not been
                 installed on your system, the installation procedure
                 will display the appropriate message.

                      This kit requires the Equation Editor V1.1-1 or later.

                      The Equation Editor V1.1-1 will be installed
                      since it does not exist on your system.

        16 Installing DECpresent

 






                 The system proceeds to the next step, which is to
                 install the spell check lexicon directories, if the
                 lexicons have not already been installed on your
                 system.

                      The DECpresent spell check lexicons will be installed in the directory
                     SYS$SYSDEVICE:[LCI.LEXICONS] by default. You may optionally install the
                     files on a device other than the system disk.

                 * Please specify a device on which to install the spell check lexicons
                 [SYS$SYSDEVICE:]:

              10.Press the Return key to install the lexicons on the
                 default device.

                 The procedure then checks to be sure the product
                 authorization key has been installed.

                      Checking/registering INTL-LEXICON-AMERICAN Product Authorization Key...

                         Product:      PRESENT-V
                         Producer:     DEC
                         Version:      1.0
                         Release Date: 1-DEC-1990

                 * Does this product have an authorization key registered and loaded?

              11.If your authorization key is registered and loaded,
                 enter YES.

                 If you answer YES, you are then asked whether you
                 want to run the Installation Verification Procedure
                 (IVP). The IVP is a small presentation that is opened
                 by DECpresent to be sure the installation is complete.
                 The system may ask you where to display the IVP. Enter
                 the name of a working DECwindows workstation on your
                 network if you receive such a prompt.

                 If you answer NO, the screen displays the following
                 messages:

                 %VMSINSTAL-W-NOIVP, The IVP will not be run since the DECpresent license
                 -VMSINSTAL-W-NOIVP, is not installed.

                      You must register and load the license in order to use DECpresent

                      We recommend that you execute the IVP after you complete this
                      installation.  The IVP consists of several separate command
                      procedures.  Execute them as follows:

                                                Installing DECpresent 17

 






                           @sys$test:present$ivp           ! DECpresent
                           @sys$test:chart$ivp             ! DECchart
                           @sys$test:lae$ivp               ! American-English lexicon

                      Installation continuing...

                 You are asked whether you want to purge (delete) old
                 versions of files replaced by this installation:

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

                 Purging is recommended.

              12.Press the Return key to purge old versions of the
                 files. To save old files, or if you are installing
                 DECpresent for the first time, enter NO.

                 The installation procedure then displays information
                 about the DECpresent clipart directories. The clipart
                 directories store the graphics that are displayed in
                 the DECpresent Art Gallery dialog box.

                 * Please a specify location for the clipart directories
                 [SYS$SYSDEVICE:[CLIPART]]:

              13.Press the Return key to create the default directory,
                 or enter a new directory name.

                 The screen displays the following message:

                      You have chosen the clipart directory SYS$SYSDEVICE:[CLIPART]
                 * Is this correct [YES]?

              14.Press the Return key.

                 The screen displays the following messages:

                     To complete the installation on a standalone VAX 11/780
                     will take approximately:

                         1 hour and 10 minutes to install
                         10 minutes to run the IVP

                     All required questions have been asked.
                     You can terminate the installation procedure at this time.

                 * Do you want to continue the installation [YES]?

        18 Installing DECpresent

 






              15.Press the Return key to continue the installation.

                 The screen displays the following messages:

                 %VMSINSTAL-I-RESTORE, Restoring product save set D ...
                 %VMSINSTAL-I-RESTORE, Restoring product save set E ...
                 %VMSINSTAL-I-RESTORE, Restoring product save set F ...
                 %VMSINSTAL-I-RESTORE, Restoring product save set G ...
                 %VMSINSTAL-I-RESTORE, Restoring product save set H ...
                 %VMSINSTAL-I-RESTORE, Restoring product save set I ...
                 %VMSINSTAL-I-RESTORE, Restoring product save set J ...
                 %VMSINSTAL-I-RESTORE, Restoring product save set K ...
                 %VMSINSTAL-I-RESTORE, Restoring product save set L ...
                 %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                 VMI$ROOT:[SYSHLP.PRESENT].
                 %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                 VMI$ROOT:[SYSHLP.EXAMPLES.PRESENT].
                 %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                 VMI$ROOT:[SYSTEST.PRESENT].
                 Providing font files...
                 Providing equation editor files...
                 Providing DECpaint files...
                 Providing clip art files...
                 Providing lexicon files...
                 Providing core DECpresent files...
                 Providing font definition file...
                 Providing shareable library files...
                 %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                 VMI$ROOT:[SYSTEST.CHART$IVP].
                 %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                 VMI$ROOT:[SYSHLP.EXAMPLES.DECCHART].
                 %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                 VMI$ROOT:[SYSTEST.CDACVTLIB].

                      The following commands must be added to the system startup
                      command file SYS$MANAGER:SYSTARTUP_V5.COM for all nodes that will
                      be running DECpresent:

                           @sys$startup:present$startup
                           @sys$startup:lci$startup.com     !American-English lexicon

                      If you are installing this kit on a workstation, you should
                      restart DECwindows after the installation has completed:

                           @sys$startup:decw$startup restart

                                                Installing DECpresent 19

 






                      You must now restart the DECwindows server on each workstation
                      that will use DECpresent.
                      If you don't do this, the workstation user will not be able to
                      use the new Equation Editor and Bullet fonts.
                      To do this, log in to each workstation in a privileged account
                      and type
                           @sys$startup:decw$startup.com restart

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

                 The installation procedure checks the system for
                 previously installed products. It does this to avoid
                 reinstalling earlier versions of products such as
                 DECchart, which are bundled with DECpresent.

                 For example, if the installation procedure determines
                 that the version of DECchart currently installed on
                 the system is a newer version than the one in the
                 DECpresent kit, DECchart will not be installed. The
                 savesets for DECchart need not be restored; therefore,
                 the "%VMSINSTAL-I-RESTORE, Restoring product saveset
                 X" messages and the amount of disk space required
                 will vary depending on previously installed layered
                 products.

                 The installation then executes the IVPs.

                 Executing IVP for: DECpresent V1.0

                     The IVP edits a sample document. If the document looks the same as
                     the illustration in the installation guide, then the installation
                     has been successful. After the document windows appears, click the
                     mouse in the window to assign input focus, and type Alt/Q (hold
                     down the Compose Character or "Alt" key and press Q) to quit
                     DECpresent and complete the DECpresent portion of the IVP.

                     Starting DECpresent....

              16.Follow the instructions in the message. The document
                 displayed on the screen should look like Figure 2-1.




        20 Installing DECpresent

 






              Figure 2-1 Successful Installation Display












































                                                Installing DECpresent 21

 






                 The screen displays the following messages:

                     Starting DECpresent....

                         *************************************

                         DECpresent V1.0

                         IVP COMPLETED SUCCESSFULLY

                         *************************************

                 IVP completed for: DECpresent V1.0

                 Executing IVP for:  International Lexicon/American for VMS V1.0

                         ********************************************

                         International Lexicon/American for VMS V1.0

                         IVP COMPLETED SUCCESSFULLY

                         *********************************************

                 IVP completed for:  International Lexicon/American for VMS V1.0
                 Executing IVP for:  DECchart

                         *************************************
                         DECchart V1.1
                         IVP COMPLETED SUCCESSFULLY
                         *************************************
                 IVP completed for: DECchart V1.1

                 Beginning the CDA Converter Library V1.1 Installation Verification
                 Procedure

                 Starting verification of the AFS front and back ends

                 Starting verification of the CGM front end

                 Starting verification of the DCA front and back ends

                 Starting verification of the DX front and back ends

                 *** The GKS run-time library is not installed. ***
                 *** The Graphics back end cannot be tested at this time. ***

                 Starting verification of the MACPAINT front and back ends

                 Starting verification of the SGML front and back ends

                 Starting verification of the TIFF front and back ends

        22 Installing DECpresent

 






                 Starting verification of the ASCII Tabular front and back ends

                 Starting verification of the CALCGRD front end

                 Starting verification of the DIF front end

                 Starting verification of the WK1 front and back ends

                 CDA Converter Library V1.1 IVP completed successfully.

                      You must now restart the DECwindows server on each workstation
                      that will use DECpresent.
                      If you don't do this, the workstation user will not be able to
                      use the new Equation Editor and Bullet fonts.
                      To do this, log in to each workstation in a privileged account
                      and type
                           @sys$startup:decw$startup.com restart

                         Installation of PRESENT V1.0 completed at 19:34

                 Enter the products to be processed from the next distribution volume set.
                 * Products: ^Z

                         VMSINSTAL procedure done at 15:48

              The installation is complete. Refer to the postinstalla-
              tion procedures in Chapter 3.


















                                                Installing DECpresent 23

 









                                                                       3
        ________________________________________________________________

                                  DECpresent Postinstallation Procedures



              This chapter describes tasks you must complete after you
              install DECpresent.

        3.1 Editing Startup Files

              You must edit the system startup file SYS$MANAGER:SYSTARTUP_
              V5.COM and, optionally, PRESENT$STARTUP.COM before using
              DECpresent.

        3.1.1 Editing SYSTARTUP_V5.COM

              Add the following lines to SYS$MANAGER:SYSTARTUP_V5.COM:

              $ @SYS$STARTUP:PRESENT$STARTUP.COM  ! DECpresent
              $ @SYS$STARTUP:LCI$STARTUP.COM  ! International Lexicons

                ________________________Note  ________________________

                If an international lexicon has previously been in-
                stalled,
                LCI$STARTUP.COM should be in
                SYS$MANAGER:SYSTARTUP_V5.COM.

                _____________________________________________________

              If you install a DECpresent language variant, make sure
              you use the proper parameter with WRITE$STARTUP.COM. Also,
              add DECW$STARTI18N.COM to SYS$STARTUP.COM. For example:

              $ @SYS$STARTUP:WRITE$STARTUP "parameter"
              $ @SYS$MANAGER:DECWSTARTI18N "parameter"

              where parameter identifies the DECpresent language variant
              you are installing. See Table 3-1 for a list of these
              language parameters.

                               DECpresent Postinstallation Procedures 25

 






                ________________________Note  ________________________

                The line for the language variants must come after
                the line that starts the network.

                _____________________________________________________

              For example, in SYS$MANAGER:SYSTARTUP_V5.COM, you might
              see:

              $ @SYS$MANAGER:STARTNET.COM
                      .
                      .
                      .
              $ @SYS$MANAGER:DECW$STARTI18N.COM "parameter"

              where parameter identifies the DECpresent language variant
              you are installing. See Table 3-1 for a list of these
              language parameters.


























        26 DECpresent Postinstallation Procedures

 






              Table_3-1_Language_Parameters_____________________________

              Language______Parameter___________________________________

              American      none required
              English

              Belgian       FR_BE
              French

              Dutch         NL_NL

              French        FR_FR

              French        FR_CA
              Canadian

              German        DE_DE

              Italian       IT_IT

              Swedish       SV_SE

              Swiss French  FR_CH

              Swiss German  DE_CH

              Swiss         IT_CH
              Italian___________________________________________________

              You can start multiple languages on the same line in
              SYSTARTUP_V5.COM by separating the parameters by commas.
              For example, the following command would start Dutch,
              French, and German:

              $ @SYS$STARTUP:DECW$STARTI18N "NL_NL,FR_FR,DE_DE"









                               DECpresent Postinstallation Procedures 27

 






        3.1.2 Editing PRESENT$STARTUP.COM

              PRESENT$STARTUP.COM defines the logical PRESENT$EXAMPLES
              to point to the DECpresent examples directory, SYS$COMMON:[SYSHELP.EXAMPLES].

              When installing a DECpresent language variant, the
              installation places the DECpresent examples in a
              language specific subdirectory. This subdirectory is
              SYS$COMMON:[SYSHELP.EXAMPLES.XX_YY.DECPRESENT], where
              XX_YY is the language parameter. See Table 3-1 for a list
              of the language parameters. Remove the commented line in
              PRESENT$STARTUP.COM that defines PRESENT$EXAMPLES to point
              to the appropriate language variant directory.

              By default, all the INSTALL commands in PRESENT$STARTUP.COM
              are commented out. You can optionally remove the comments
              for the images and shared libraries you want to install.
              This improves system performance on systems where multiple
              users are running DECpresent concurrently.

              Make sure you have completed the steps in Section 1.7
              before executing PRESENT$STARTUP.COM on a standalone
              system or on other nodes in a VAXcluster.

        3.2 Installing DECpresent on a Standalone System

              When installing DECpresent on a standalone system

              1. Enter @SYS$STARTUP:PRESENT$STARTUP.COM

              2. If you have installed any non-US language variants
                 also enter @SYS$MANAGER:DECW$STARTI18N parameter  where
                 parameter is a language parameter, or parameters, from
                 Table 3-1.

                 If you have installed DECpresent on a workstation, you
                 must restart the DECwindows server so that it can use
                 the new fonts required by the Equation Editor and the
                 Bullets dialog box. Enter @SYS$STARTUP:DECW$STARTUP
                 RESTART to restart the server.





        28 DECpresent Postinstallation Procedures

 






        3.3 Installing DECpresent on a VAXcluster

              To install DECpresent on a cluster with a common system
              disk, make sure you load the DECpresent license and the
              American English lexicon license on each node in the
              cluster.

              You also need to restart the DECwindows server on each
              of the satellite workstations. Starting the server gives
              those workstations access to the required video fonts.



































                               DECpresent Postinstallation Procedures 29

 






              To load the licenses, enter the following commands:

              $ mc sysman
              SYSMAN> set environment/cluster/user=system
              Remote Password: <system password for the cluster nodes>
              SYSMAN> do license load PRESENT-V
              SYSMAN> do install replace sys$library:dcltables.exe
              SYSMAN> do install replace sys$library:cda$access
              SYSMAN> do license load intl-lexicon-american
              SYSMAN> do @sys$startup:lci$startup
              SYSMAN> do @sys$startup:PRESENT$startup
              SYSMAN> do @sys$startup:decw$startup restart
              ! If there are no active users. Only required for workstations
              SYSMAN> do @sys$manager:decwstarti18n PARAMETER
              !DECpresent language variants
              SYSMAN> exit

              See Table 3-1 for a list of the language parameters.

        3.4 Rebooting the System

              You can reboot your system after you have installed
              DECpresent and reset the system parameters (if necessary).
              A system reboot verifies that DECpresent is ready for use
              and establishes any new parameter settings. Note, however,
              that rebooting is optional.

        3.5 User Account Requirements

              To use DECpresent, user accounts on your system must
              have certain privileges and quotas. The next two sections
              contain information about these requirements.

        3.5.1 Privileges

              To use DECpresent, each account must have at least the
              TMPMBX and NETMBX privileges. Use the VMS Authorize
              utility to determine whether users have the privileges
              they require.






        30 DECpresent Postinstallation Procedures

 






        3.5.2 User Account Quotas

              You must make sure that the appropriate user accounts have
              sufficient quotas to be able to use DECpresent. Table 3-2
              summarizes minimum recommended process quotas.

              Table_3-2_User_Account_Quotas_____________________________

              Account_Quota____Value____________________________________

              ASTLM            100

              BIOLM            40

              DIOLM            40

              FILLM            40

              TQELM            20

              ENQLM            110

              WSDEF            256

              WSQUOTA          512

              WSEXT            4,100[1]
              [1]On_a_single-user_workstation,_the_value_of_WSEXT_can_be

              set equal to the value of WSMAX for better performance.
              __________________________________________________________

              User account quotas are stored in the file SYSUAF.DAT. Use
              the Authorize utility to verify and change user account
              quotas. First set your directory to SYS$SYSTEM and then
              run AUTHORIZE:

              $ SET DEFAULT SYS$SYSTEM
              $ RUN AUTHORIZE
              UAF>





                               DECpresent Postinstallation Procedures 31

 






              At the AUTHORIZE prompt (UAF>), use the SHOW command
              with an account name to check a particular account. For
              example:

              UAF> SHOW SMITH

              To change a quota, use the MODIFY command at the UAF>
              prompt. MODIFY has the following format:

              MODIFY account-name /quota-name=nnnn

              This example changes the FILLM quota for the SMITH account
              and then exits from the utility:

              UAF> MODIFY SMITH /FILLM=40
              UAF> EXIT

              After you exit from the utility, the VMS system displays
              messages indicating whether or not changes were made. Once
              you have finished making the changes, the users must log
              out and log in again for the new quotas to take effect.

              For more information about modifying account quotas, see
              the description of the Authorize utility in the VMS system
              management and operations documentation.

        3.6 Tuning Your System

              After you install DECpresent, you might want to adjust
              your system to enhance performance or lower the use
              of some system resources. Information about tuning
              your system is included in the VMS System Management,
              Volume 4, Performance manual.

        3.7 Selecting a Language

              You need to specify what language you will use when you
              run a DECpresent language variant. Select the language by
              choosing Language from the Customize menu in the Session
              Manager and double clicking on the primary language.





        32 DECpresent Postinstallation Procedures

 






        3.8 Installation Verification Procedures

              The DECpresent Installation Verification Procedures
              are run automatically at the end of the DECpresent
              installation procedure if you enter YES to that option
              during the installation.

                ________________________Note  ________________________

                Before you run the IVP for any language other than
                English, you must first set the language you will
                use.

                _____________________________________________________

              If you did not enter YES, you may want to run the IVPs
              later. If run later, the IVPs need three separate command
              procedures:

              $ @SYS$TEST:PRESENT$IVP.COM       ! DECpresent
              $ @SYS$TEST:CHART$IVP.COM         ! DECchart
              $ @SYS$TEST:LAE$IVP.COM           ! American-English lexicon
              $ @SYS$TEST:CDACVTLIB$IVP.COM     ! CDA Converters

              You receive a message indicating whether the IVP succeeded
              or failed.

        3.9 Using the Font Utility

              The Font utility is a program that allows users to add
              new fonts or delete existing fonts from the DECpresent
              font family menu. See Section 3.9.3 for the Font utility
              commands, formats, and descriptions.

              If you include a font using the Font utility that does
              not have an equivalent weight or slant in DECpresent,
              DECpresent maps the weight and slant of the imported font
              to a weight and slant that it does use.







                               DECpresent Postinstallation Procedures 33

 






        3.9.1 Preparing to Run the Font Utility

              To prepare to run the font utility you must first:

              o  Install all screen fonts in the SYS$COMMON:[SYSFONT.DECW.USER_
                 75DPI] for 75 dpi font directories or
                 SYS$COMMON:[SYSFONT.DECW.USER_100DPI] for 100 dpi
                 font directories and make them known to the DECwindows
                 server by restarting the server.

              o  Install all corresponding Adobe Font Metric (.AFM)
                 and .PS outline files in the SYS$PS_FONT_METRICS:
                 directory.

              o  Be sure you have defined your display. (See Chapter 2.)

              After adding new fonts to DECpresent enter the following
              command at the $ prompt.

              SET FILE /PROTECTION=(W:RE) SYS$LIBRARY:WRITE$FONTS.INI

              If you do not issue this command, DECpresent displays an
              error message saying that it cannot open WRITE$FONTS.INI
              and exits.

        3.9.2 Font Utility Startup

              The font utility's initialization will require approxima-
              tely 30-60 seconds.

              At the $ prompt enter:

              write$fontutil infilename

              or

              write$fontutil infilename outfilename

              The arguments infilename and outfilename refer to the font
              initialization file.

              The screen displays:

              V1.1 Font Utility
              You may have to wait 30-60 seconds while this utility initializes...
              Enter command>

        34 DECpresent Postinstallation Procedures

 






        3.9.3 Font Utility Commands and Descriptions

              The Font utility allows users to manage additional fonts
              not shipped with DECpresent. Table 3-3 shows the Font
              utility's messages and some explanation of them.

              Each of these commands uses two font lists. The add list
              contains font families that may be added to the DECpresent
              menu. The menu list contains font families that are
              already part of the DECpresent menu.

              Table_3-3_Font_Utility_Commands___________________________

              Command___Format,_Effects,_and_Descriptions_______________

              Add       Add "fontname"

                        Displays one new font family if you specify a
                        fontname and places it (fontname) on the menu
                        list, and removes it from the add list.

                        If you do not specify the fontname, the add
                        command prompts you for it with the prompt
                        Family name:. If you press the Return key
                        without specifying a fontname the add command
                        changes nothing.

              Hide      Hide "fontname"

                        Hides the fontname from the menu list. Hidden
                        or invisible fonts are available to existing
                        DECpresent files read in, but are not visible on
                        the DECpresent Font Family menu. This feature
                        is useful for hiding the DECmath fonts from
                        the menu or in permitting a user to exclude a
                        standard font without actually deleting it.

                        If you do not specify the fontname, the hide
                        command will prompt for it with Family name:.
                        If you press Return, the hide command changes
                        nothing.

                                                (continued on next page)


                               DECpresent Postinstallation Procedures 35

 






              Table_3-3_(Cont.)_Font_Utility_Commands___________________

              Command___Format,_Effects,_and_Descriptions_______________

              Delete    Delete "fontname"

                        Deletes the indicated fontname from the menu
                        list, adding it to the add list.

                        If you do not specify the fontname, the delete
                        command prompts you for it with Family name:.
                        If you press Return, the delete command changes
                        nothing.

              Exit      Exit outfilename

                        Saves the changes made to infilename to
                        outfilename. If you do not specify outfilename
                        on the command line, the exit command uses the
                        following defaults:

                        o  If you specify outfilename in the startup
                           command line

                        $ write$fontutil infilename outfilename

                           or

                        o  If you specify infilename in startup command
                           line

                        $ write$fontutil infilename

                        In either case, DECpresent verifies that you
                        wish to write to the indicated file. This is
                        especially important if infilename would be
                        overwritten by the changes you have just made.

                                                (continued on next page)






        36 DECpresent Postinstallation Procedures

 






              Table_3-3_(Cont.)_Font_Utility_Commands___________________

              Command___Format,_Effects,_and_Descriptions_______________

              Quit      Quit

                        Terminates session without saving changes.

                        If you made changes to the infilename, the
                        font utility prompts you to confirm that you
                        want to quit without saving your changes. If
                        you answer yes, the font utility's session
                        terminates without saving any changes. If you
                        answer no, the utility saves no changes and the
                        font utility continues running.

                        If you have made no changes to the infilename
                        the font utility session ends without confirma-
                        tion.

              Rename    Rename "oldfontname" "newfontname"

                        Renames the indicated font family to a new font
                        name.

                        The font names are the same names displayed on
                        the DECpresent Font Family menu. Changing this
                        name does not affect DECpresent internal font
                        names that are used in looking up a font chosen
                        during a DECpresent session.

                        If you do not specify oldfontname, newfontname
                        or both names, the rename command will ask for
                        the omitted information with the prompts From:
                        and To: for the oldfontname and newfontname,
                        respectively. If you press Return at either of
                        these prompts without entering a font name, the
                        rename command is abandoned.

                                                (continued on next page)





                               DECpresent Postinstallation Procedures 37

 






              Table_3-3_(Cont.)_Font_Utility_Commands___________________

              Command___Format,_Effects,_and_Descriptions_______________

              Show      Show [Full] [Add | Menu] "fontname"

                        Displays the indicated fonts and optionally
                        their corresponding screen font names, .PS
                        filenames and .AFM filenames.

                        If you do not specify a fontname or an option,
                        the Show command defaults to Show Menu showing
                        all entries in the menu list.

                        o  Add

                           Displays all the entries in the add list or
                           displays an entry if you specify a fontname.

                        o  Full

                           Displays additional information consisting
                           of screen font names, .ps filenames and .afm
                           filenames.

                        o  Menu

                           Displays all entries in the menu list or
                           displays an entry if you specify a fontname.

              Reveal    Reveal "fontname"

                        Displays the indicated hidden fontname on the
                        "menu" list. See the Hide command for details
                        about hidden fonts.

                        If you do not specify the fontname, the reveal
                        command will prompt you for it with Family
                        name:. If you press Return, the utility reveals
              __________nothing.________________________________________

        3.10 Files Copied During Installation

              To see a list of the files copied to your VAX or ULTRIX
              system during the DECpresent installation, copy and print
              the following file from the SYS$COMMON:[SYSHLP.PRESENT]
              directory after installation:

        38 DECpresent Postinstallation Procedures

 






              present_file_list.txt












































                               DECpresent Postinstallation Procedures 39

 






        3.11 Running DECpresent from FileView

              As part of the installation, DECpresent is added to the
              FileView Applications menu. You should inform all users
              after the installation that DECpresent is now available as
              an option on their FileView Applications menu.

              If you install a language variant of DECpresent on a
              system where the same language variant of FileView exists,
              DECpresent is added to the FileView Applications menu.

              For more information on FileView, refer to the DECwindows
              User's Guide.

        3.12 Running DECpresent from DCL

              To run DECpresent from the DCL command line enter at the $
              prompt:

              run sys$system:DECpresent

              You can also add a line to your login.com file to define a
              symbol to run DECpresent. For example:

              DECpresent :== $ sys$system:DECpresent

              A user could, after logging out and then logging back in
              or running login.com, enter at the DCL $ prompt:

              DECpresent filename

              This would invoke DECpresent and open the named document.

        3.13 Determining and Reporting Problems

              If you encounter a problem while using DECpresent, report
              it to Digital. Depending on the nature of the problem
              and the type of support you have, you can take one of the
              following actions:

              o  Call Digital if your software contract or warranty
                 agreement entitles you to telephone support.

              o  Submit a Software Performance Report (SPR).

        40 DECpresent Postinstallation Procedures

 






              Review the Software Product Description (SPD) and Warranty
              Addendum for warranty information. If you encounter a
              problem during the warranty period, report the problem as
              indicated above or follow alternate instructions provided
              by Digital for reporting SPD nonconformance problems.








































                               DECpresent Postinstallation Procedures 41

 









                                                                       A
        ________________________________________________________________

                                          Sample DECpresent Installation



              This appendix contains printouts of typical DECpresent
              installation procedures. These procedures show

              o  A full installation with all licenses installed

              o  An installation with only the font license installed

              To perform a successful installation, you must:

              1. Prepare your system by completing the procedure in
                 Chapter 1.

              2. Install DECpresent by completing the installation
                 procedure described in Chapter 2.

              3. Perform any needed postinstallation procedures
                 described in Chapter 3.

        A.1 Full DECpresent Installation

              This sample installation printout shows the user responses
              and system messages when all the appropriate licenses have
              been installed.

        $ @sys$update:vmsinstal present010 sys$update:

                VAX/VMS Software Product Installation Procedure V5.4

        It is 1-NOV-1990 at 18:20.

        Enter a question mark (?) at any time for help.
        %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account.

        %VMSINSTAL-W-LOWQUOTA, The following account quotas may be too low:
                ENQLM: currently 100; minimum expected 200
                FILLM: currently 20; minimum expected 100

                                       Sample DECpresent Installation 43

 






        %VMSINSTAL-W-ACTIVE, The following processes are still active:
                DECW$TE_3
                _TWA2:
                _TWA3:
                _TWA6:
                _RTA1:
        * Do you want to continue anyway [NO]? y
        * Are you satisfied with the backup of your system disk [YES]?

        The following products will be processed:
          PRESENT V1.0

                Beginning installation of PRESENT V1.0 at 18:20

        %VMSINSTAL-I-RESTORE, Restoring product save set A ...
        %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

                        DECpresent V1.0 Installation Procedure

            International Hyphenators and International CorrectSpell (TM)
            Copyright (c) 1985, 1987, 1988 by Houghton Mifflin.  All rights
            reserved. US Pat. Nos. 4,508,241, 4,730,269, and 4,771,401.
            Canadian Pat. No. 1,203,916.

            Portions licensed to Digital Equipment Corporation, Maynard,
            Massachusetts.  Copyright Frame Technology Corporation 1989.
            All rights reserved.

        %VMSINSTAL-I-RESTORE, Restoring product save set B ...
        %VMSINSTAL-I-RESTORE, Restoring product save set C ...

            User quota (not critical) ...
                WSDEFAULT, WSQUOTA, or WSEXTENT is 170 ... suggested minimum: 256

             You can install the DECpresent kit completely or just the video
             fonts required to create equations and bullets.

             If you are installing this kit for use on a workstation, or on a
             VAXcluster that includes workstations, then you should install
             the entire kit. This requires 33935 blocks.

             If you are installing this kit on a workstation that will only run
             DECpresent from a remote system, then only the video font files are
             needed. This requires 1518 blocks.

        * Do you want to install the entire kit [YES]?

             Installing entire DECpresent kit....

        44 Sample DECpresent Installation

 






            This kit requires DECchart V1.1 or later.

            *************************************************************

            DECchart V1.1 will be installed since it does
            not exist on your system.

            *************************************************************

             This kit requires the Equation Editor V1.1-1 or later.

             The Equation Editor V1.1-1 will be installed
             since it does not exist on your system.

             The DECpresent spell check lexicons will be installed in the directory
             SYS$SYSDEVICE:[LCI.LEXICONS] by default. You may optionally install the
             files on a device other than the system disk.

        * Please specify a device on which to install the spell check lexicons
        [SYS$SYSDEVICE:]: dkb300:
          You have chosen the device DKB300:

        * Is this correct [YES]?

             Checking/registering INTL-LEXICON-AMERICAN Product Authorization Key...

                Product:      PRESENT-V
                Producer:     DEC
                Version:      1.0
                Release Date: 1-DEC-1990

        * Does this product have an authorization key registered and loaded? y
        * Do you want to run the IVP after the installation [YES]?

        %VMSINSTAL-W-NODISPLAY, Workstation display not defined

        Please enter the node name of the workstation on which to display the IVP
        or press Return to continue and not run the IVP

        * Node name: latham

        * Do you want to purge files replaced by this installation [YES]?
        * Please a specify location for the clipart directories
        [SYS$SYSDEVICE:[CLIPART]]: dkb300:[clipart]

             Your clipart directory will be DKB300:[CLIPART]
        * Is this correct [YES]?

            To complete the installation on a standalone VAX 11/780
            will take approximately:

                                       Sample DECpresent Installation 45

 






                1 hour and 10 minutes to install
                10 minutes to run the IVP

            All required questions have been asked.
            You can terminate the installation procedure at this time.

        * Do you want to continue the installation [YES]?
        %VMSINSTAL-I-RESTORE, Restoring product save set D ...
        %VMSINSTAL-I-RESTORE, Restoring product save set E ...
        %VMSINSTAL-I-RESTORE, Restoring product save set F ...
        %VMSINSTAL-I-RESTORE, Restoring product save set G ...
        %VMSINSTAL-I-RESTORE, Restoring product save set H ...
        %VMSINSTAL-I-RESTORE, Restoring product save set I ...
        %VMSINSTAL-I-RESTORE, Restoring product save set J ...
        %VMSINSTAL-I-RESTORE, Restoring product save set K ...
        %VMSINSTAL-I-RESTORE, Restoring product save set L ...
        %VMSINSTAL-I-SYSDIR, This product creates system disk directory
        VMI$ROOT:[SYSHLP.PRESENT].
        %VMSINSTAL-I-SYSDIR, This product creates system disk directory
        VMI$ROOT:[SYSHLP.EXAMPLES.PRESENT].
        %VMSINSTAL-I-SYSDIR, This product creates system disk directory
        VMI$ROOT:[SYSTEST.PRESENT].
        Providing font files...
        Providing equation editor files...
        Providing DECpaint files...
        Providing clip art files...
        Providing lexicon files...
        Providing core DECpresent files...
        Providing font definition file...
        Providing shareable library files...
        %VMSINSTAL-I-SYSDIR, This product creates system disk directory
        VMI$ROOT:[SYSTEST.CHART$IVP].
        %VMSINSTAL-I-SYSDIR, This product creates system disk directory
        VMI$ROOT:[SYSHLP.EXAMPLES.DECCHART].
        %VMSINSTAL-I-SYSDIR, This product creates system disk directory
        VMI$ROOT:[SYSTEST.CDACVTLIB].

             The following commands must be added to the system startup
             command file SYS$MANAGER:SYSTARTUP_V5.COM for all nodes that will
             be running DECpresent:

                  @sys$startup:present$startup
                  @sys$startup:lci$startup.com     !American-English lexicon


        46 Sample DECpresent Installation

 






             If you are installing this kit on a workstation, you should
             restart DECwindows after the installation has completed:

                  @sys$startup:decw$startup restart

             You must now restart the DECwindows server on each workstation
             that will use DECpresent.
             If you don't do this, the workstation user will not be able to
             use the new Equation Editor and Bullet fonts.
             To do this, log in to each workstation in a privileged account
             and type
                  @sys$startup:decw$startup.com restart

        %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
        Repairing semantics on DDIF files...
        %DCL-I-SUPERSEDE, previous value of PRESENT$EXAMPLES has been superseded
        %VMSINSTAL-I-RUNIVP, Executing installation verification procedure(s)

        Executing IVP for: DECpresent V1.0

            The IVP edits a sample document. If the document looks the same as
            the illustration in the installation guide, then the installation
            has been successful. After the document windows appears, click the
            mouse in the window to assign input focus, and type Alt/Q (hold
            down the Compose Character or "Alt" key and press Q) to quit
            DECpresent and complete the DECpresent portion of the IVP.

            Starting DECpresent....

                *************************************

                DECpresent V1.0

                IVP COMPLETED SUCCESSFULLY

                *************************************

        IVP completed for: DECpresent V1.0

        Executing IVP for:  International Lexicon/American for VMS V1.0

                ********************************************

                International Lexicon/American for VMS V1.0

                IVP COMPLETED SUCCESSFULLY

                *********************************************

                                       Sample DECpresent Installation 47

 






        IVP completed for:  International Lexicon/American for VMS V1.0
        Executing IVP for:  DECchart V1.1
                *************************************
                DECchart V1.1
                IVP COMPLETED SUCCESSFULLY
                *************************************
        IVP completed for: DECchart V1.1

        Beginning the CDA Converter Library V1.1 Installation Verification
        Procedure

        Starting verification of the AFS front and back ends

        Starting verification of the CGM front end

        Starting verification of the DCA front and back ends

        Starting verification of the DX front and back ends

        *** The GKS run-time library is not installed. ***
        *** The Graphics back end cannot be tested at this time. ***

        Starting verification of the MACPAINT front and back ends

        Starting verification of the SGML front and back ends

        Starting verification of the TIFF front and back ends

        Starting verification of the ASCII Tabular front and back ends

        Starting verification of the CALCGRD front end

        Starting verification of the DIF front end

        Starting verification of the WK1 front and back ends

        CDA Converter Library V1.1 IVP completed successfully.

             You must now restart the DECwindows server on each workstation
             that will use DECpresent.
             If you don't do this, the workstation user will not be able to
             use the new Equation Editor and Bullet fonts.
             To do this, log in to each workstation in a privileged account
             and type
                  @sys$startup:decw$startup.com restart

                Installation of PRESENT V1.0 completed at 19:34

                VMSINSTAL procedure done at 19:34

        48 Sample DECpresent Installation

 






        A.2 Video Font Only DECpresent Installation

              This sample installation printout shows the user responses
              and system messages that appear during a video font only
              installation.

        $ @sys$update:vmsinstal present010 sys$update

                VAX/VMS Software Product Installation Procedure V5.4

        It is 1-NOV-1990 at 17:49.

        Enter a question mark (?) at any time for help.
        %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account.

        %VMSINSTAL-W-LOWQUOTA, The following account quotas may be too low:
                ENQLM: currently 100; minimum expected 200
                FILLM: currently 20; minimum expected 100

        %VMSINSTAL-W-ACTIVE, The following processes are still active:
                _TWA2:
                _TWA3:
                _TWA6:
                _RTA1:
        * Do you want to continue anyway [NO]? y
        * Are you satisfied with the backup of your system disk [YES]?

        The following products will be processed:
          PRESENT V1.0

                Beginning installation of PRESENT V1.0 at 17:50

        %VMSINSTAL-I-RESTORE, Restoring product save set A ...
        %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

                        DECpresent V1.0 Installation Procedure

            International Hyphenators and International CorrectSpell (TM)
            Copyright (c) 1985, 1987, 1988 by Houghton Mifflin.  All rights
            reserved. US Pat. Nos. 4,508,241, 4,730,269, and 4,771,401.
            Canadian Pat. No. 1,203,916.

            Portions licensed to Digital Equipment Corporation, Maynard,
            Massachusetts.  Copyright Frame Technology Corporation 1989.
            All rights reserved.

        %VMSINSTAL-I-RESTORE, Restoring product save set B ...
        %VMSINSTAL-I-RESTORE, Restoring product save set C ...

                                       Sample DECpresent Installation 49

 






            User quota (not critical) ...
                WSDEFAULT, WSQUOTA, or WSEXTENT is 170 ... suggested minimum: 256

             You can install the DECpresent kit completely or just the video
             fonts required to create equations and bullets.

             If you are installing this kit for use on a workstation, or on a
             VAXcluster that includes workstations, then you should install
             the entire kit. This requires 33935 blocks.

             If you are installing this kit on a workstation that will only run
             DECpresent from a remote system, then only the video font files are
             needed. This requires 1518 blocks.

        * Do you want to install the entire kit [YES]? n
        * Do you want to install only the video fonts [YES]?

             Installing only the Equation Editor and Bullet fonts...

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

            To complete the installation on a standalone VAX 11/780
            will take approximately:

                10 minutes to install

            All required questions have been asked.
            You can terminate the installation procedure at this time.

        * Do you want to continue the installation [YES]?
        %VMSINSTAL-I-RESTORE, Restoring product save set D ...
        %VMSINSTAL-I-RESTORE, Restoring product save set E ...
        %VMSINSTAL-I-SYSDIR, This product creates system disk directory
        VMI$ROOT:[SYSHLP.EXAMPLES.PRESENT].
        Providing font files...

             If you are installing this kit on a workstation, you should
             restart DECwindows after the installation has completed:

                  @sys$startup:decw$startup restart





        50 Sample DECpresent Installation

 






             You must now restart the DECwindows server on each workstation
             that will use DECpresent.
             If you don't do this, the workstation user will not be able to
             use the new Equation Editor and Bullet fonts.
             To do this, log in to each workstation in a privileged account
             and type
                  @sys$startup:decw$startup.com restart

        %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
                Installation of PRESENT V1.0 completed at 17:55

                VMSINSTAL procedure done at 17:55

































                                       Sample DECpresent Installation 51

 













     ________________________________________________________________

                                                                Index



     B__________________________          E__________________________

     Backing up the system disk,          Examples
        8                                  PRESENT$EXAMPLES
     Beginning the installation,              directory, 28
        11

                                          F__________________________
     C__________________________          Files copied during

     Checking the distribution              installation, 38
        kit, 1                            Font utility, 33
     Cluster                               commands, 35
       installing DECpresent, 4            descriptions, 35
     Commands                              messages, 35
       Font utility, 35                    preparing to run, 34

                                           startup, 34
     D__________________________          Free disk blocks

     DECpresent                            displaying number of, 6

       running from DCL, 40
       running from FileView, 40          G__________________________

     DECpresent startup file              Global pages, 6
       editing, 28                        Global sections, 6
       PRESENT$STARTUP.COM, 28
     Disk blocks                          I__________________________
       displaying number of free          Images, 28
         disk blocks, 6                   Installation
     Distribution kit                      files copied, 38
       contents of, 1                      sample printout, 43

                                          Installation on a
                                            standalone system, 28
                                          Installation on a
                                            VAXcluster, 29

                                                              Index-1

 






        Installation Verification           Starting the installation,
          Procedures                           11
         running after                      System disk
            installation, 33                  backing up, 8
                                            System startup file
        L__________________________           editing, 25

        Language                            V
         parameter, 28                      ___________________________
         variant, 28                        VAXcluster
        Libraries, shared, 28                 installation on, 29
        License registration, 3               installing DECpresent, 4
                                            VMSINSTAL
        M__________________________           command line, 11
        Messages                              starting the installation
         Font utility, 35                        , 11

        P__________________________

        Parameter
         language, 28
        Preparing for installation,
          1
        Prerequisite software for
          DECpresent installation,
          2
        PRESENT$STARTUP.COM, 28

        R__________________________

        Running DECpresent, 40

        S__________________________

        Sample installation
          printout, 43
        SHOW DEVICE command
         displaying number of free
            disk blocks, 6
        Software
         required before
            installing DECpresent,
            2
        Standalone system
         installation on, 28

        Index-2
