 















             VMS__________________________________________________
             DECwindows V2.1 Language Variants Installation Guide


                                                              AA-PAJHB-TE




             October 1990

             This guide describes how to install VMS DECwindows V2.1
             Language Variants on the VMS Operating System.




             Revision Information:         This is a revised manual.

             Operating System:             VMS V5.4

             Software Version:             VMS DECwindows V2.1 Language
                                           Variants




             digital equipment corporation
             maynard, massachusetts

 






             October 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 October 1990.

             All Rights Reserved.
             Printed in U.K.

             The following are trademarks of Digital Equipment Corporation:

             CDA             LiveLink         VAXcluster
             DDIF            LN03             VAX RMS
             DEC             MASSBUS          VAXserver
             DECnet          MicroVAX         VAXstation
             DECUS           PrintServer 40   VMS
             DECwindows      Q-bus            VT
             DECwrite        ReGIS            XUI
             DEQNA           ULTRIX
             DIGITAL         UNIBUS
             GIGI            VAX              DIGITAL

             The following is a third-party trademark:

             PostScript is a registered trademark of Adobe Systems, Inc.

 















          ________________________________________________________________


                                                                  Contents




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


          1  Preparing to Install VMS DECwindows V2.1 Language
             Variants

              1.1  Prerequisite Software...........................    1-2
              1.2  Installation Procedure Requirements.............    1-2
              1.2.1  Time .........................................    1-2
              1.2.2  Privileges ...................................    1-2
              1.2.3  Disk Space ...................................    1-3
              1.2.4  VMSINSTAL Requirements .......................    1-4
              1.2.5  Backing Up Your System Disk ..................    1-5
              1.2.6  VMS DECwindows V2.1 Language Variant
                     Requirements.................................     1-5









                                                                       iii

 






          2  Installing VMS DECwindows V2.1 Language Variants

              2.1  General Information.............................    2-1
              2.1.1  Accessing the Online Release Notes ...........    2-1
              2.1.2  Determining the Files Added to the System ....    2-2
              2.1.3  Installation Verification Procedure (IVP) ....    2-2
              2.1.4  Aborting the Installation ....................    2-3
              2.2  The Installation Procedure......................    2-3
              2.2.1  Invoking VMSINSTAL ...........................    2-3
              2.2.2  Installation Questions .......................    2-5
              2.2.3  Informational Messages .......................    2-7
              2.2.4  Completing the Installation Procedure ........    2-9
              2.3  Error Recovery..................................   2-10


          3  After Installing VMS DECwindows V2.1 Language Variants

              3.1  Editing the System Startup File.................    3-1
              3.2  Amending the LIBRARY.DECW$BOOKSHELF file........    3-3
              3.3  Checking the Installation.......................    3-4
              3.4  Invoking and Running a Language Variant.........    3-4
              3.5  Determining and Reporting Problems..............    3-5


          A  Sample Installation


          B  Files and Logical Names Installed on Your System

              B.1  Directories.....................................    B-1
              B.2  Files...........................................    B-3
              B.3  Logical Names...................................    B-8








          iv

 






          Index


          Tables

              1-1  Disk space requirements.........................    1-3

              2-1  Release Notes...................................    2-2

              2-2  Installation names..............................    2-3

              3-1  Parameter values................................    3-2

              3-2  Language variant bookshelf files................    3-3

              B-1  Directory values................................    B-2

              B-2  New files installed.............................    B-4

              B-3  Logical name values.............................    B-9




















                                                                         v

 














          ________________________________________________________________


                                                                   Preface




             The VMS DECwindows V2.1 Language Variants are translated
             versions of the VMS DECwindows V2.1 user interface, online
             help and online documentation. The language variants are
             installed on top of the American English version of VMS
             DECwindows V2.1.

             The following language variants are covered by this guide:

                Dutch
                French
                French Canadian
                German
                Italian
                Norwegian
                Swedish
                Swiss French
                Swiss German
                Swiss Italian






                                                                         v

 






          Purpose of This Guide

             This guide describes how to install the VMS DECwindows V2.1
             Language Variants on the VMS operating system. You must read
             the whole guide before you start to install the product.



          Who Should Use This Guide

             This guide is intended for VMS system managers or others
             who are responsible for installing system software. To
             install the VMS DECwindows V2.1 Language Variants, you
             must have access to a privileged account, such as the SYSTEM
             account. You must also be familiar with the VMS installation
             procedure, VMSINSTAL.

             Keep this document with your distribution kit. You will need
             it if for any reason you have to reinstall any of the VMS
             DECwindows V2.1 Language Variants.


          Structure of This Guide

             This guide has three chapters and two appendices.

             Chapter 1 describes the prerequisites and preparations for
             the installation.

             Chapter 2 describes the installation procedure.

             Chapter 3 describes what to do after the installation.

             Appendix A lists a sample installation procedure.

             Appendix B lists the files and logical names which are
             created on your system during the installation.



          vi

 






          For More Information

             For more information about installing products on VMS sys-
             tems, refer to your processor-specific Installation/Operations
             guide.

             For more information about VMSINSTAL, refer to the VMS System
             Manager's Manual.

             For more information on DECwindows, refer to the following
             manuals:

              _ VMS DECwindows User's Guide

              _ VMS DECwindows Desktop Applications Guide

























                                                                       vii

 

















                                                                              1
               ________________________________________________________________

                     Preparing to Install VMS DECwindows V2.1 Language Variants




                  This chapter discusses the preparations and requirements for
                  installing the VMS DECwindows V2.1 Language Variants.

                  Your bill of materials (BOM) and indented bills report (BIL)
                  specify the number and contents of your media. Be sure to
                  verify the contents of your kit using this information. If
                  your kit is damaged, or if you find that parts of it are
                  missing, contact your Digital representative.

                  The VMS DECwindows V2.1 Language Variants provide online
                  Release Notes. Digital strongly recommends that you read the
                  Release Notes before proceeding with the installation. For
                  information on accessing the online Release Notes, refer to
                  Section 2.1.1.

                  You can install VMS DECwindows V2.1 Language Variants on a
                  standalone VAX and on a VAXcluster.

















                Preparing to Install VMS DECwindows V2.1 Language Variants  1-1

 











               1.1  Prerequisite Software

                  This section discusses the software you must have installed
                  on your system before you install any VMS DECwindows V2.1
                  Language Variants. The System Software Addendum (SSA)
                  contains a complete list of prerequisite software and the
                  required version numbers. The SSA is part of the Software
                  Product Description (SPD).

                  You must have VMS V5.4 and the American English version of
                  VMS DECwindows V2.1 installed and running on your system
                  before you install the VMS DECwindows V2.1 Language Variants.

               Note: All VMS DECwindows V2.1 Language Variants run on VMS V5.4
                  releases only.

               1.2  Installation Procedure Requirements

                  The following sections discuss various requirements for
                  installing the VMS DECwindows V2.1 Language Variants.

                  1.2.1  Time

                  The installation takes approximately 10 minutes, depending on
                  your type of media and your system configuration.

                  1.2.2  Privileges

                  To install the VMS DECwindows V2.1 Language Variants, you
                  must be logged in to an account that has SETPRV or at least
                  the following privileges:

                   _ CMKRNL

                   _ WORLD

                   _ SYSPRV

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








               1-2  Preparing to Install VMS DECwindows V2.1 Language Variants

 











                  1.2.3  Disk Space

                  Installing one of the VMS DECwindows V2.1 Language Variants
                  requires a certain amount of free disk storage space during
                  and after the installation. Table 1-1 summarizes the storage
                  requirements:

                  Table 1-1    Disk space requirements

                  _____________________________________________________________
                  Language         Blocks During         Blocks After
                  Variant_Kit______Installation__________Installation__________

                  Dutch            7,000                 7,000

                  French           7,000                 7,000

                  French Canadian  7,000                 7,000

                  German           7,000                 7,000

                  Italian          7,000                 7,000

                  Norwegian        7,000                 7,000

                  Swedish          7,000                 7,000

                  Swiss French     7,000                 7,000

                  Swiss German     7,000                 7,000

                  Swiss_Italian____7,000_________________7,000_________________
















                Preparing to Install VMS DECwindows V2.1 Language Variants  1-3

 











               To determine the number of free disk blocks on the current
               system disk, enter the following command at the DCL prompt:


                    $ SHOW DEVICE SYS$SYSDEVICE

                  1.2.4  VMSINSTAL Requirements

                  When you invoke VMSINSTAL, it checks the following:

                   _ Whether you have set your default device and directory to
                     SYS$UPDATE

                   _ Whether you are logged in to a privileged account

                   _ Whether you have adequate quotas for installation

                   _ Whether DECnet is running

                   _ Whether any users are logged in to the system

                  Note that VMSINSTAL requires the installation account to have
                  a minimum of the following quotas:

                     ASTLM = 24
                     BIOLM = 18
                     BYTLM = 18,000
                     DIOLM = 18
                     ENQLM = 30
                     FILLM = 20

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

                    $ SET DEFAULT SYS$SYSTEM
                    $ RUN AUTHORIZE
                    UAF>

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

                    UAF> SHOW SYSTEM

                  To change a quota, use the MODIFY command. MODIFY has the
                  following format:

                     MODIFY account-name /quota-name=NNN

               1-4  Preparing to Install VMS DECwindows V2.1 Language Variants

 











                  The following example changes the FILLM quota for the SYSTEM
                  account and then exits from the utility:

                    UAF> MODIFY SYSTEM /FILLM=30
                    UAF> EXIT

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

                  For more information on modifying account quotas, refer to
                  the description of the Authorize Utility in the VMS System
                  Management Documentation Subkit.

                  If VMSINSTAL detects any problems during the installation,
                  it notifies you and asks if you want to continue the
                  installation. In some instances, you can enter YES to
                  continue. To stop the installation process and correct
                  the situation, enter NO or press <Return>. Then correct the
                  problem and restart the installation.

                  1.2.5  Backing Up Your System Disk

                  At the beginning of the installation, VMSINSTAL asks if you
                  have backed up your system disk. Digital recommends that you
                  do a system disk backup before installing any software.

                  Use the backup procedures that are established at your site.
                  For details on performing a system disk backup, refer to the
                  section on the Backup Utility in the VMS System Management
                  Documentation Subkit.

                  1.2.6  VMS DECwindows V2.1 Language Variant Requirements

                  During the installation of VMS DECwindows V2.1 Language
                  Variants, the product checks that you have VMS V5.4 and the
                  American English version of VMS DECwindows V2.1 installed and
                  running on your system. If you do not have VMS V5.4 and VMS
                  DECwindows V2.1, an error message will be displayed and the
                  installation procedure will abort.

                  The product also checks that you have sufficient disk space
                  available for the installation. The disk space for each
                  language variant is listed in Table 1-1. If you do not have
                  enough disk space, an error message will be displayed and the
                  installation procedure will abort.

                Preparing to Install VMS DECwindows V2.1 Language Variants  1-5

 

















                                                                              2
               ________________________________________________________________

                               Installing VMS DECwindows V2.1 Language Variants




                  This chapter describes how to install VMS DECwindows V2.1
                  Language Variants.

                  Section 2.2 contains a step-by-step description of the
                  installation procedure.

               2.1  General Information

                  This section includes information about the following topics:

                   _ Accessing online Release Notes.

                   _ Determining which files have been added to your system

                   _ Aborting the installation.

                  2.1.1  Accessing the Online Release Notes

                  The VMS DECwindows V2.1 Language Variants provide online
                  Release Notes. You must specify OPTIONS N when you invoke
                  VMSINSTAL to see the question about online Release Notes.
                  This question comes near the beginning of the installation.
                  This is described in Section 2.2.1.

                  You must review the Release Notes in case they contain any
                  information about last minute changes in the installation
                  procedure. If you have already reviewed the Release Notes
                  during a previous installation, you do not need to specify
                  OPTIONS N.

                  Once the language variant has been installed, the Release
                  Notes are located in the directory SYS$HELP: in one of the
                  files listed in Table 2-1.

                          Installing VMS DECwindows V2.1 Language Variants  2-1

 











                  Table 2-1    Release Notes

                  _____________________________________________________________
                  Language
                  variant__________Release_Notes_file__________________________

                  Dutch            DECWNL_NL021.RELEASE_NOTES

                  French           DECWFR_FR021.RELEASE_NOTES

                  French Canadian  DECWFR_CA021.RELEASE_NOTES

                  German           DECWDE_DE021.RELEASE_NOTES

                  Italian          DECWIT_IT021.RELEASE_NOTES

                  Norwegian        DECWNO_NO021.RELEASE_NOTES

                  Swedish          DECWSV_SE021.RELEASE_NOTES

                  Swiss French     DECWFR_CH021.RELEASE_NOTES

                  Swiss German     DECWDE_CH021.RELEASE_NOTES

                  Swiss_Italian____DECWIT_CH021.RELEASE_NOTES__________________


                  2.1.2  Determining the Files Added to the System

                  During the installation, some directories and files are
                  created on your system. These directories and files are
                  listed in Appendix B.

                  2.1.3  Installation Verification Procedure (IVP)

                  The installation procedure for the VMS DECwindows V2.1
                  Language Variants does not include an Installation
                  Verification Procedure (IVP).

                  This is because the VMS DECwindows V2.1 Language Variants
                  consist only of the user interface and online help.

                  As there is no IVP, Digital recommends that you check after
                  the installation that the files have been installed correctly
                  and that the language variant runs correctly. Refer to
                  Section 3.3 and Section 3.4 for more information.


               2-2  Installing VMS DECwindows V2.1 Language Variants

 











                  2.1.4  Aborting the Installation

                  To abort the installation procedure at any time, press
                  CTRL/Y. When you press CTRL/Y, the installation procedure
                  deletes all files it has created up to that point and exits.
                  You can then start the installation again.

               2.2  The Installation Procedure

                  The installation procedure consists of a series of questions
                  and informational messages.

                  2.2.1  Invoking VMSINSTAL

                  To start the installation, invoke the VMSINSTAL command
                  procedure from a privileged account, such as the SYSTEM
                  account. VMSINSTAL is in the SYS$UPDATE directory. You use
                  the following syntax to invoke VMSINSTAL:

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

                  saveset-name
                  The installation name for the component. For the VMS
                  DECwindows V2.1 Language Variants, use the installation names
                  shown in Table 2-2.

                  Table 2-2    Installation names

                  _____________________________________________________________
                  Language
                  variant__________Installation_name___________________________

                  Dutch            DECWNL_NL021

                  French           DECWFR_FR021

                  French Canadian  DECWFR_CA021

                  German           DECWDE_DE021

                  Italian          DECWIT_IT021

                  Norwegian        DECWNO_NO021

                  Swedish          DECWSV_SE021

                                                       (continued on next page)

                          Installing VMS DECwindows V2.1 Language Variants  2-3

 











                  Table 2-2 (Cont.)    Installation names

                  _____________________________________________________________
                  Language
                  variant__________Installation_name___________________________

                  Swiss French     DECWFR_CH021

                  Swiss German     DECWDE_CH021

                  Swiss_Italian____DECWIT_CH021________________________________

                  device-name
                  The name of the device on which you plan to mount the media.
                  For example, MTA0: is a device name for a tape drive.

                  It is not necessary to use the console drive for this
                  installation. However, if you do use the console drive, once
                  the installation is complete, you should replace any media
                  you removed.

                  OPTIONS N
                  An optional parameter that indicates you want to see the
                  Release Notes question. If you do not include the OPTIONS
                  N parameter, VMSINSTAL does not ask you about the Release
                  Notes. You must review the Release Notes before proceeding
                  with the installation in case they contain new information
                  about the installation.

                  Note that there are several other options you can select
                  when you invoke VMSINSTAL. Refer to the VMS documentation
                  on software installation in the VMS System Management Subkit
                  for information on these options. If you specify more than
                  one option, separate the options with commas, for example,
                  OPTIONS A,N.

                  The following example invokes VMSINSTAL to install the Dutch
                  VMS DECwindows language variant from tape drive MTA0: and
                  shows the system response.









               2-4  Installing VMS DECwindows V2.1 Language Variants

 











                    $ @SYS$UPDATE:VMSINSTAL DECWNL_NL021 MTA0: OPTIONS N

                          VAX/VMS Software Product Installation Procedure V5.4


                    It is 16-SEP-1991 at 11:44.

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

                  If you do not supply either the product name or the device
                  name, VMSINSTAL prompts you for this information later
                  in the installation procedure. If you do not specify any
                  installation options, VMSINSTAL also prompts you to enter
                  options.

                  2.2.2  Installation Questions

                  This section discusses the questions that appear during
                  the installation. Appendix A contains a sample installation
                  procedure which shows how the questions can be answered.

                  Each question in the installation is marked with an asterisk
                  (*) at the beginning of the line. Some questions show the
                  default response in brackets, for example [YES] or [Y]. To
                  use the default response, press <Return>.

                   1 System backup

                     VMSINSTAL asks if you are satisfied with your system
                     backup. You should always back up your system disk before
                     performing an installation. If you are satisfied with the
                     backup of your system disk, press <Return>. Otherwise,
                     enter NO to discontinue the installation. After you back
                     up your system disk, you can restart the installation.

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

                   2 Options

                     If you did not specify any options on the command line,
                     VMSINSTAL asks you to enter the installation options
                     you want to use. Press <Return> if you do not want any
                     options.

                       * Enter installation options you wish to use (none):



                          Installing VMS DECwindows V2.1 Language Variants  2-5

 











                   3 Mounting the media

                     You must now mount the first distribution volume on the
                     device you specified when you invoked VMSINSTAL. The
                     device name appears in the line preceding the question.
                     VMSINSTAL then asks you if you are ready to continue with
                     the installation.

                     If you respond YES, to indicate that you are ready,
                     VMSINSTAL displays a message that the media containing
                     the language variant has been mounted on the specified
                     device and that the installation has begun. For example:

                       Please mount the first volume of the set on MTA0:.
                       * Are you ready? YES
                       %MOUNT-I-MOUNTED, DECWNL_NL021 MOUNTED ON _$$MTA0:
                       The following products will be processed:
                         DECWNL_NL V2.1

                           Beginning installation of DECWNL_NL V2.1 at 11:45

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

                     If you entered the wrong device name when you invoked
                     VMSINSTAL and need to restart the installation, enter NO
                     in response to the "Are you ready?" question. To abort the
                     installation for other reasons, press CTRL/Y.

                   4 Release Notes

                     If you specified OPTIONS N when you invoked VMSINSTAL or
                     when VMSINSTAL prompted you to enter an option, you are
                     now asked to choose one of the four options for reviewing
                     the Release Notes.

                       Release notes included with this kit are always copied 
                       to SYS$HELP.

                       Additional Release Notes Options:

                        1.  Display release notes
                        2.  Print release notes
                        3.  Both 1 and 2
                        4.  None of the above

                       * Select option [2]:

                     If you select option 1, VMSINSTAL displays the Release
                     Notes immediately on the console terminal. You can
                     terminate the display at any time by pressing CTRL/C.

               2-6  Installing VMS DECwindows V2.1 Language Variants

 











                     If you select option 2, VMSINSTAL prompts you for the name
                     of the print queue that you want to use:

                       * Queue name [SYS$PRINT]:

                     You can press <Return> to send the file to the default
                     output print device or you can enter another queue name.

                     If you select option 3, VMSINSTAL displays the Release
                     Notes immediately on the console terminal and then prompts
                     you for a queue name for the printed version.

                     Select option 4 if you have already reviewed the Release
                     Notes and are restarting the installation.

                   5 Continuing the installation

                     The installation procedure now asks if you want to
                     continue the installation. To continue, enter YES.
                     Otherwise, press <Return>. In either case, the Release
                     Notes are copied to a file in the SYS$HELP directory. For
                     example:

                       * Do you want to continue the installation [NO]?: YES
                       %VMSINSTAL-I-RELMOVED, The product's release notes have 
                                           been successfully moved to SYS$HELP.
                       %DECWNL_NL-I-INTRO, Installing VMS DECwindows Dutch 
                                           language support.

                     The Release Notes for each language variant are located in
                     one of the files listed in Table 2-1 in Section 2.1.1.

                   6 Choosing to purge files

                     You have the option to purge files from any previous
                     versions of VMS DECwindows Language Variants that are
                     superseded by this installation. Purging is recommended;
                     however, if you need to keep files from the previous
                     version, enter NO in response to the question.

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

                  2.2.3  Informational Messages

                  At this point, the installation procedure displays a number
                  of informational messages that report on the progress of the
                  installation. The installation procedure does not ask any
                  further questions.

                          Installing VMS DECwindows V2.1 Language Variants  2-7

 











                  If the installation procedure has been successful up to this
                  point, VMSINSTAL moves the new or modified files to their
                  target directories, updates help files, and updates DCL
                  tables, if necessary. If you chose to have files purged,
                  that work is done now.

               The following messages are displayed:

                    %DECWNL_NL-I-NOMORE, No more questions will be asked.
                    %DECWNL_NL-I-TIME, This installation will take 
                                 approximately 10 minutes
                    %VMSINSTAL-I-RESTORE, Restoring product save set B ...
                    %VMSINSTAL-I-SYSDIR, This product creates system disk 
                           directory VMI$ROOT:[DECW$DEFAULTS.SYSTEM.NL_NL]
                    %VMSINSTAL-I-SYSDIR, This product creates system disk 
                           directory VMI$ROOT:[SYSHLP.NL_NL]
                    %VMSINSTAL-I-SYSDIR, This product creates system disk 
                           directory VMI$ROOT:[SYSHLP.EXAMPLES.NL_NL]
                    %VMSINSTAL-I-SYSDIR, This product creates system disk 
                           directory VMI$ROOT:[SYSLIB.NL_NL]
                    %VMSINSTAL-I-SYSDIR, This product creates system disk 
                           directory VMI$ROOT:[SYSMSG.NL_NL]
                    %VMSINSTAL-I-SYSDIR, This product creates system disk 
                           directory VMI$ROOT:[VUE$LIBRARY.SYSTEM.NL_NL]
                    %VMSINSTAL-I-SYSDIR, This product creates system disk 
                           directory VMI$ROOT:[DECW$DEFAULTS.USER.NL_NL]
                    %VMSINSTAL-I-SYSDIR, This product creates system disk 
                           directory VMI$ROOT:[VUE$LIBRARY.USER.NL_NL]
                    %VMSINSTAL-I-MOVEFILES, files will now be moved to their
                                            target directories...

















               2-8  Installing VMS DECwindows V2.1 Language Variants

 












                  2.2.4  Completing the Installation Procedure

                  The following messages indicate that the entire installation
                  procedure is complete:

                       Installation of DECWNL_NL V2.1 completed at 11:55

                       VMSINSTAL procedure done at 11:55

                  You can now log out of the privileged account:

                    $ LOGOUT
                    SYSTEM     logged out at 16-SEP-1991 11:57:24.14

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


               2.3  Error Recovery

                  If errors occur during the installation, VMSINSTAL displays
                  failure messages. If the installation fails, you see the
                  following message:

                    %VMSINSTAL-E-INSFAIL, The installation of DECWNL_NL V2.1 
                         has failed.

                  Errors can occur during the installation if any of the
                  following conditions exist:

                   _ The operating system version is incorrect

                   _ Disk space necessary for successful installation is
                     insufficient

                   _ Quotas necessary for successful installation are
                     insufficient

                   _ System parameter values for successful installation are
                     insufficient

                   _ The VMS help library is currently in use



                          Installing VMS DECwindows V2.1 Language Variants  2-9

 











                  For descriptions of the error messages generated by these
                  conditions, refer to the VMS documentation on system
                  messages, recovery procedures, and VMS software installation.
                  If you are notified that any of these conditions exist,
                  you should take the appropriate action as described in
                  the message. (You might need to change a system parameter
                  or increase an authorized quota value.) For information on
                  installation requirements, refer to Chapter 1.






































               2-10  Installing VMS DECwindows V2.1 Language Variants

 

















                                                                              3
               ________________________________________________________________

                         After Installing VMS DECwindows V2.1 Language Variants




                  After installing a language variant, you must perform the
                  following tasks:

                   _ Edit the system startup file

                   _ Amend the LIBRARY.DECW$BOOKSHELF file

                   _ Check the installation

                   _ Run the language variant

               3.1  Editing the System Startup File

                  You must edit the system startup file to provide for
                  automatic startup of VMS DECwindows V2.1 Language Variants
                  when your system is rebooted.

                  Add the command line that starts the language variant to the
                  system startup file, SYS$MANAGER:SYSTARTUP_V5.COM.

                  The VMS DECwindows V2.1 Language Variants cannot start until
                  after the network has started. You must put this new command
                  line after the line that invokes the network startup command
                  procedure.

                  The following example shows the startup command lines for the
                  network followed by the VMS DECwindows V2.1 Language Variants
                  startup command line:

                    $ @SYS$MANAGER:STARTNET.COM
                         .
                         .
                    $ @SYS$MANAGER:DECW$STARTI18N.COM parameter1 parameter2

                    After Installing VMS DECwindows V2.1 Language Variants  3-1

 











                  parameter1
                  This is the list of all the language variants which are
                  available on the system. If you specify more than one
                  language variant, you must separate the variants with commas.
                  Table 3-1 shows the possible values for this parameter.

                  Table 3-1    Parameter values

                  _____________________________________________________________
                  Language
                  variant__________Parameter_values____________________________

                  Dutch            NL_NL

                  French           FR_FR

                  French Canadian  FR_CA

                  German           DE_DE

                  Italian          IT_IT

                  Norwegian        NO_NO

                  Swedish          SV_SE

                  Swiss French     FR_CH

                  Swiss German     DE_CH

                  Swiss_Italian____IT_CH_______________________________________

                  It is not necessary to include English in the list of
                  language variant parameters.

                  parameter2
                  This is an optional parameter which defines a system-wide
                  default language variant for all users. You cannot specify
                  more than one value for this parameter. Table 3-1 shows the
                  possible values for this parameter.








               3-2  After Installing VMS DECwindows V2.1 Language Variants

 











               3.2  Amending the LIBRARY.DECW$BOOKSHELF file

                  You must include a reference to the translated language
                  version of the online book Using the Bookreader in the main
                  library bookshelf file. The main library bookshelf file is
                  called LIBRARY.DECW$BOOKSHELF and it is in the directory
                  SYS$COMMON:[DECW$BOOK].

                  This does not apply to the Norwegian language variant, which
                  has no translated online documentation.

                  To include the reference to Using the Bookreader in the file
                  LIBRARY.DECW$BOOKSHELF, follow these instructions:

                  Use the DCL APPEND command to append the file which contains
                  the reference to the appropriate language version of Using
                  the Bookreader to the file LIBRARY.DECW$BOOKSHELF. For more
                  information about the APPEND command, refer to the VMS DCL
                  Dictionary.

                  Table 3-2 lists the file for each language variant which
                  contains the reference to Using the Bookreader. This file is
                  in the directory SYS$COMMON:[DECW$BOOK].

                  Table 3-2    Language variant bookshelf files

                  _____________________________________________________________
                  Language
                  variant__________File_name___________________________________

                  Dutch            DECWNL_NL021BOOKREADER.DECW$BOOKSHELF

                  French           DECWFR_FR021BOOKREADER.DECW$BOOKSHELF

                  French Canadian  DECWFR_CA021BOOKREADER.DECW$BOOKSHELF

                  German           DECWDE_DE021BOOKREADER.DECW$BOOKSHELF

                  Italian          DECWIT_IT021BOOKREADER.DECW$BOOKSHELF

                  Norwegian        No translated online documentation available

                  Swedish          DECWSV_SE021BOOKREADER.DECW$BOOKSHELF

                  Swiss French     DECWFR_CH021BOOKREADER.DECW$BOOKSHELF

                                                       (continued on next page)

                    After Installing VMS DECwindows V2.1 Language Variants  3-3

 











                  Table 3-2 (Cont.)    Language variant bookshelf files

                  _____________________________________________________________
                  Language
                  variant__________File_name___________________________________

                  Swiss German     DECWDE_CH021BOOKREADER.DECW$BOOKSHELF

                  Swiss_Italian____DECWIT_CH021BOOKREADER.DECW$BOOKSHELF_______


               3.3  Checking the Installation

                  To make sure that the language variant has installed
                  successfully, check that all the necessary files are
                  installed on your system in the correct directories. The
                  files are listed in Section B.2.

                  If all the files are in the correct directories, invoke and
                  run the language variant according to the instructions in
                  Section 3.4.

                  If all the files listed in Section B.2 are not installed, or
                  if your language variant does not run correctly, report this
                  to Digital. Refer to Section 3.5 for more information.

               3.4  Invoking and Running a Language Variant

                  If you did not specify a system-wide default language
                  variant (parameter2) on the startup command line in the file
                  SYS$MANAGER:SYSTARTUP_V5.COM, you must tell all users how to
                  start up the language variant which you have installed. Refer
                  to Section 3.1 for more information on the startup command
                  line.

                  To start up the language variant, each user must do the
                  following:

                   1 Choose Language . .. from the Session Manager's Customize
                     menu.

                     The Session Manager displays the Customize Language dialog
                     box.

                   2 Scroll through the list of languages and choose the
                     language which corresponds to the language variant
                     installed.

               3-4  After Installing VMS DECwindows V2.1 Language Variants

 











                     The next application which the user starts is displayed in
                     the selected language. If the application is not available
                     on your system in the selected language, it is displayed
                     in American English.

                   3 Choose Save Current Settings from the Session Manager's
                     Customize menu.

                     When the user starts a new DECwindows session, the
                     DECwindows environment will appear in the selected
                     language.

               3.5  Determining and Reporting Problems

                  If you encounter a problem while using VMS DECwindows V2.1
                  Language Variants, 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:

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

                   _ Submit a Software Performance Report (SPR).

                   _ Fill out and submit a Reader's Comments form if
                     the problem has to do with the VMS DECwindows V2.1
                     documentation. There are Reader's Comments forms at the
                     back of each manual. Use the form from the manual in which
                     you found the error. Include the section and page number.

                  Review the Software Product Description (SPD) and Warranty
                  Addendum for an explanation of warranty. 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.











                    After Installing VMS DECwindows V2.1 Language Variants  3-5

 

















                                                                              A
               ________________________________________________________________

                                                            Sample Installation




                  This appendix contains a sample installation of one language
                  variant. This sample was run on a system that had no previous
                  version of that language variant installed.

                  The sample installation assumes that no users are logged on
                  to your system.

               $ @SYS$UPDATE:VMSINSTAL DECWDE_DE021 MTA0: OPTIONS N

                VAX/VMS Software Product Installation Procedure V5.4

               It is 20-SEP-1991 at 12:05

               Enter a question mark (?) at any time for help.
               * Are you satisfied with the backup of your system 
                      disk [YES]? YES

               Please mount the first volume of the set on MTA0:.
               * Are you ready? YES
               %MOUNT-I-MOUNTED, DECWDE_DE mounted on _$$MTA0:

               The following products will be processed:

                 DECWDE_DE V2.1

                Beginning installation of DECWDE_DE V2.1 at 12:06

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

               Release notes included with this kit are always copied 
                     to SYS$HELP.



                                                       Sample Installation  A-1

 











               Additional Release Notes Options:

                1.  Display release notes
                2.  Print release notes
                3.  Both 1 and 2
                4.  None of the above

               * Select option [2]: 2

               * Queue name [SYS$PRINT]: LASER
               Job 810 (queue LASER, entry 1295) started on LASER
               * Do you want to continue the installation [NO]?: YES
               %VMSINSTAL-I-RELMOVED, The product's release notes have been
                                              successfully moved to SYS$HELP.

               %DECWDE_DE-I-INTRO, Installing VMS DECwindows German language 
                      support.
               * Do you want to purge files replaced by this 
                      installation [YES]? YES
               %DECWDE_DE-I-NOMORE, No more questions will be asked.
               %DECWDE_DE-I-TIME, This installation will take approximately 
                      10 minutes.
               %MVSINSTAL-I-RESTORE, Restoring product save set B ...
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                                    VMI$ROOT:[DECW$DEFAULTS.SYSTEM.DE_DE]
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                                    VMI$ROOT:[SYSHLP.DE_DE]
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                                    VMI$ROOT:[SYSHLP.EXAMPLES.DE_DE]
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                                    VMI$ROOT:[SYSLIB.DE_DE]
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                                    VMI$ROOT:[SYSMSG.DE_DE]
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                                    VMI$ROOT:[VUE$LIBRARY.SYSTEM.DE_DE]
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                                    VMI$ROOT:[DECW$DEFAULTS.USER.DE_DE]
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
                                    VMI$ROOT:[VUE$LIBRARY.USER.DE_DE]
               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their
                                                         target directories...

                       Installation of DECWDE_DE V2.1 completed at 12:14

                       VMSINSTAL procedure done at 12:14


               A-2  Sample Installation

 

















                                                                              B
               ________________________________________________________________

                               Files and Logical Names Installed on Your System




                  The installation procedure for the VMS DECwindows V2.1
                  Language Variants creates directories on your system,
                  installs a number of files and defines some logical names.
                  Section B.1 lists the directories. Section B.2 lists the
                  files installed. Section B.3 lists the logical names that are
                  added to the system logical name table.

               B.1  Directories

                  The following directories are created on your system when a
                  language variant is installed:

                   _ SYS$SYSROOT:[DECW$DEFAULTS.USER.x]

                   _ SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM.x]

                   _ SYS$SYSROOT:[SYSHLP.x]

                   _ SYS$SYSROOT:[SYSHLP.EXAMPLES.X]

                   _ SYS$SYSROOT:[SYSLIB.x]

                   _ SYS$SYSROOT:[SYSMSG.x]

                   _ SYS$SYSROOT:[VUE$LIBRARY.USER.x]

                   _ SYS$SYSROOT:[VUE$LIBRARY.SYSTEM.x]

               x represents one of the names in Table B-1.





                          Files and Logical Names Installed on Your System  B-1

 











                  Table B-1    Directory values

                  _____________________________________________________________
                  Language
                  variant__________Directory_name______________________________

                  Dutch            NL_NL

                  French           FR_FR

                  French Canadian  FR_CA

                  German           DE_DE

                  Italian          IT_IT

                  Norwegian        NO_NO

                  Swedish          SV_SE

                  Swiss French     FR_CH

                  Swiss German     DE_CH

                  Swiss_Italian____IT_CH_______________________________________

                  For example, the directories created when the Swedish
                  language variant is installed are:

                   _ SYS$SYSROOT:[DECW$DEFAULTS.USER.SV_SE]

                   _ SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM.SV_SE]

                   _ SYS$SYSROOT:[SYSHLP.SV_SE]

                   _ SYS$SYSROOT:[SYSHLP.EXAMPLES.SV_SE]

                   _ SYS$SYSROOT:[SYSLIB.SV_SE]

                   _ SYS$SYSROOT:[SYSMSG.SV_SE]

                   _ SYS$SYSROOT:[VUE$LIBRARY.USER.SV_SE]

                   _ SYS$SYSROOT:[VUE$LIBRARY.SYSTEM.SV_SE]




               B-2  Files and Logical Names Installed on Your System

 











               B.2  Files

                  Table B-2 contains the names of all files installed on your
                  system when a language variant is installed.












































                          Files and Logical Names Installed on Your System  B-3

 











               Table B-2    New files installed

               ________________________________________________________________
               Directory_________________________Filename______________________

               SYS$SYSROOT:                      DDIF$VIEW.UID
               :[DECW$DEFAULTS.SYSTEM.x]
                                                 DDIF$VIEWWGT.UID

                                                 DECW$BOOKREADER.DAT

                                                 DECW$BOOKREADER.UID

                                                 DECW$CALC.DAT

                                                 DECW$CALC.UID

                                                 DECW$CALENDAR.DAT

                                                 DECW$CALENDAR.UID

                                                 DECW$CARDFILER.DAT

                                                 DECW$CARDFILER.UID

                                                 DECW$CLOCK.DAT

                                                 DECW$CLOCK.UID

                                                 DECW$LOGIN.DAT

                                                 DECW$LOGIN.UID

                                                 DECW$MAIL.DAT

                                                 DECW$MAIL_MAIN.UID

                                                 DECW$MAIL_MISC.UID

                                                 DECW$MAIL_READ.UID

                                                 DECW$MAIL_SEND.UID

                                                       (continued on next page)




               B-4  Files and Logical Names Installed on Your System

 











               Table B-2 (Cont.)    New files installed

               ________________________________________________________________
               Directory_________________________Filename______________________

                                                 DECW$NOTEPAD.DAT

                                                 DECW$NOTEPAD.UID

                                                 DECW$PAINT.DAT

                                                 DECW$PAINT.UID

                                                 DECW$PRINTWGT_UI.UID

                                                 DECW$PUZZLE.UID

                                                 DECW$PUZZLE.DAT

                                                 DECW$SESSION.DAT

                                                 DECW$SESSION.UID

                                                 DECW$SM_BW.DAT

                                                 DECW$SM_COLOR.DAT

                                                 DECW$SM_GENERAL.DAT

                                                 DECW$SM_GRAY.DAT

                                                 DECW$TERMINAL.DAT

                                                 DECW$TERMINAL.UID

                                                 DECW$WINMGR.DAT

                                                 DECW$WINMGR.UID

                                                 VUE$MASTER.UID

                                                       (continued on next page)






                          Files and Logical Names Installed on Your System  B-5

 











               Table B-2 (Cont.)    New files installed

               ________________________________________________________________
               Directory_________________________Filename______________________

               SYS$SYSROOT:[SYSHLP]              DECWx021.RELEASE_NOTES. See
                                                 Table 2-1.

               SYS$SYSROOT:[SYSHLP.x]            DDIF$VIEW.HLB

                                                 DECW$BOOKREADER.HLB

                                                 DECW$CALC.HLB

                                                 DECW$CALENDAR.HLB

                                                 DECW$CARDFILER.HLB

                                                 DECW$CLOCK.HLB

                                                 DECW$HELPHELP.HLB

                                                 DECW$MAIL.HLB

                                                 DECW$NOTEPAD.HLB

                                                 DECW$PAINT.HLB

                                                 DECW$PRINTWGT.HLB

                                                 DECW$PUZZLE.HLB

                                                 DECW$SESSION.HLB

                                                 DECW$TERMINAL.HLB

                                                 DECW$VUE.HLB

               SYS$SYSROOT:[SYSMGR]              DECW$STARTI18N.COM

               SYS$SYSROOT:[SYSMSG.x]            DDIF$VIEWMSG.EXE

                                                       (continued on next page)





               B-6  Files and Logical Names Installed on Your System

 











               Table B-2 (Cont.)    New files installed

               ________________________________________________________________
               Directory_________________________Filename______________________

                                                 DECW$DWTERRDB.DAT

                                                 DECW$TERMINALMSG.EXE

                                                 DECW$XLIBERRDB.DAT

               SYS$SYSROOT:[VUE$LIBRARY.SYSTEM.x]VUE$COMPARE.COM

                                                 VUE$COMPILE.COM

                                                 VUE$COPY.COM

                                                 VUE$CREATE_DIRECTORY.COM

                                                 VUE$CREATE_PUBLIC_PROFILE.COM

                                                 VUE$DELETE.COM

                                                 VUE$EDIT.COM

                                                 VUE$LINK.COM

                                                 VUE$PURGE.COM

                                                 VUE$RENAME.COM

                                                 VUE$RUN.COM

                                                 VUE$SEARCH.COM

                                                 VUE$SET_PROTECTION.COM

                                                 VUE$SHOW.COM

                                                 VUE$SYSTEM_PROFILE.VUE$DAT

                                                 VUE$TYPE.COM

                                                       (continued on next page)




                          Files and Logical Names Installed on Your System  B-7

 











               Table B-2 (Cont.)    New files installed

               ________________________________________________________________
               Directory_________________________Filename______________________

               SYS$COMMON:[DECW$BOOK]       DECWx021BOOKREADER.DECW$BOOKSHELF.
                                                 See Table 3-2.[1]

                                                 DECWx021BOOKREADER.DECW$BOOK.
                                                 The language version of Using
                                                 the Bookreader.[1]
               ________________________________________________________________
               [1]These files are not installed with the Norwegian language
               variant, which has no Norwegian online documentation.
               ________________________________________________________________

               B.3  Logical Names

                  The following logical names are entered into the system
                  logical name table when you invoke a language variant. These
                  names are stored in the product's startup file. They are
                  automatically entered into the system logical name table
                  whenever the system reboots or whenever the software is
                  invoked.

                  The logical name XNL$LANG is only created when you specify
                  a value for both parameter1 and parameter2 in the system
                  startup file. Refer to Section 3.1 for more information about
                  these parameters.

                   _ DECW$SYSTEM_DEFAULTS_x

                   _ SYS$EXAMPLES_x

                   _ SYS$HELP_x

                   _ SYS$LIBRARY_x

                   _ SYS$MESSAGE_x

                   _ VUE$LIBRARY_x

                   _ XNL$LANG

                  x represents one of the values in Table B-3.



               B-8  Files and Logical Names Installed on Your System

 











                  Table B-3    Logical name values

                  _____________________________________________________________
                  Language
                  variant__________Values______________________________________

                  Dutch            NL_NL

                  French           FR_FR

                  French Canadian  FR_CA

                  German           DE_DE

                  Italian          IT_IT

                  Norwegian        NO_NO

                  Swedish          SV_SE

                  Swiss French     FR_CH

                  Swiss German     DE_CH

                  Swiss_Italian____IT_CH_______________________________________























                          Files and Logical Names Installed on Your System  B-9

 











               For example, the logical names for the Italian language variant
               are:

                   _ DECW$SYSTEM_DEFAULTS_IT_IT

                   _ SYS$EXAMPLES_IT_IT

                   _ SYS$HELP_IT_IT

                   _ SYS$LIBRARY_IT_IT

                   _ SYS$MESSAGE_IT_IT

                   _ VUE$LIBRARY_IT_IT

                   _ XNL$LANG
































               B-10  Files and Logical Names Installed on Your System

 




















               ___________________________________________________________


                                                                      Index



               A                               Contents of media kit, 1-1

               Aborting the installation,      CTRL/Y, 2-3

                  2-3                          D

               Account quotas, 1-4             Device name, 2-4
               Amending the bookshelf          Disk space, 1-3
                  file, 3-3
               APPEND command, 3-3             E
               Authorize utility, 1-4
                                               Editing the system startup
               B                                  file, 3-1
                                               Error messages, 2-10   
               Backing up the system disk,     Error recovery, 2-10
                  1-5                          
               Bill of materials, 1-1          F
               Bookshelf file, 3-3             
                                               Files created on the system,
               C                                  2-2, B-1
                                               Free disk blocks, 1-3   
               Checking the installation,      
                  3-4                          I
               Completing the installation,
                  2-9                          Informational messages, 2-7

                                                                    Index-1

 






          Installation                    Privileges, 1-2
            aborting, 2-3                 Problems, 3-5
            checking, 3-4                 
            procedure, 2-1, 2-3           Q
            questions, 2-5                
            requirements, 1-2, 1-5        Quotas
            starting, 2-3                   setting, 1-4
          Installation names, 2-3
          Installation verification       R
             procedure, 2-2               
          Invoking language variants,     Release notes, 1-1
             3-4                            accessing, 2-1
          IVP, 2-2                          reading, 2-6
                                          Reporting problems, 3-5
          L                               Running language variants,
                                             3-4
          Library bookshelf file, 3-3     
          Logical names, B-8              S
                                          
          M                               Sample installation, A-1
                                          Saveset names, 2-3
          Media kit, 1-1                  SETPRV, 1-2
          Messages                        SHOW DEVICE command, 1-4
            error, 2-10                   Software product
            informational, 2-7               description (SPD), 1-2
          Mounting the media, 2-6         Starting the installation,
                                             2-3
          O                               Startup file, 3-1
                                          System disk, 1-5
          Online documentation, 3-3       System software addendum
          Online release notes, 1-1          (SSA), 1-2
            accessing, 2-1                V
            reading, 2-6
          OPTIONS, 2-1, 2-4               VMS DECwindows V2.1, 1-2
                                          VMSINSTAL
          P                                 command line, 2-3
                                            invoking, 2-3
          Preparing for the                 OPTIONS, 2-1, 2-4
             installation, 1-1              requirements, 1-4
          Prerequisite software, 1-2      VMS V5.4, 1-2

          Index-2
