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