 
















             VMS__________________________________________________
             DECwindows V2.1 Language Variants Installation Guide




             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

 















          ________________________________________________________________


                                                                  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 - Einführung

              _ VMS DECwindows - Benutzerhandbuch

























                                                                       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.










































      2-8  Installing VMS DECwindows V2.1 Language Variants

 



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



                 Installing VMS DECwindows V2.1 Language Variants  2-9

 



      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

         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 prob-

            lem 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.

      Additional Release Notes Options:

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

                                              Sample Installation  A-1

 



      * 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:[DECW$DEFAULTS.SYSTEM.DDIF$VIEW.UID

                                        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
      B                               Editing the system startup
                                         file, 3-1
      Backing up the system disk,     Error messages, 2-10
         1-5                          Error recovery, 2-10

      Bill of materials, 1-1          F
      Bookshelf file, 3-3
      C                               Files created on the system
                                         , 2-2, B-1
      Checking the installation,      Free disk blocks, 1-3

         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                 Q
            procedure, 2-1, 2-3
            questions, 2-5                Quotas
            requirements, 1-2, 1-5          setting, 1-4
            starting, 2-3                 R
          Installation names, 2-3
          Installation verification       Release notes, 1-1
             procedure, 2-2                 accessing, 2-1
          Invoking language variants,       reading, 2-6
             3-4                          Reporting problems, 3-5
          IVP, 2-2                        Running language variants,

          L                                  3-4

          Library bookshelf file, 3-3     S

          Logical names, B-8              Sample installation, A-1

          M                               Saveset names, 2-3
                                          SETPRV, 1-2
          Media kit, 1-1                  SHOW DEVICE command, 1-4
          Messages                        Software product
            error, 2-10                      description (SPD), 1-2
            informational, 2-7            Starting the installation,
          Mounting the media, 2-6            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

          P                               VMSINSTAL
                                            command line, 2-3
          Preparing for the                 invoking, 2-3
             installation, 1-1              OPTIONS, 2-1, 2-4
          Prerequisite software, 1-2        requirements, 1-4

          Index-2

 






          VMS V5.4, 1-2







































                                                              Index-3
