______________________________________________ OpenVMS/Hanyu Alpha Version 7.3-1 Installation Guide Order Number: AA-PXH9H-TE September 2002 This document contains installation information for the OpenVMS/Hanyu Alpha Version 7.3-1 operating system. Revision/Update Information: This is a new manual. Software Version: OpenVMS/Hanyu Alpha Version 7.3-1 Compaq Computer Corporation Asia Region __________________________________________________________ First Printing, September 2002 Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor. Compaq conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community. © Compaq Computer Taiwan Limited 2002. All rights reserved. Printed in Singapore The following are trademarks of Compaq Computer Corporation: Alpha, AlphaGeneration, AlphaServer, AlphaStation, Bookreader, CDA, CI, Compaq DEC, DEC Ada, DEC BASIC, DEC Fortran, DEC Notes, DECdirect, DECdtm, DECevent, DECforms, DECmigrate, DECnet, DECpresent, DECterm, DECthreads, DECwindows, DIGITAL, HSC, HSC40, HSC70, HSJ, HSZ, InfoServer, LAT, LinkWorks, ManageWORKS, MSCP, OpenVMS, OpenVMS Cluster, PATHWORKS, POLYCENTER, RRD42, RZ, StorageWorks, TeamLinks, TMSCP, TURBOchannel, UETP, VAX, VMS, XUI, and the Compaq logo. The following are third-party trademarks: Microsoft, Windows, Windows NT, and MS-DOS are registered trademarks of Microsoft Corporation. Motif are registered trademarks of the Open Software Foundation, Inc. PostScript is a registered trademark of Adobe Systems Incorporated. All other trademarks and registered trademarks are the property of their respective holders. This document was prepared using VAX DOCUMENT Version 2.1. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing for OpenVMS/Hanyu Alpha Installation 1.1 Software Prerequisites....................... 1-1 1.1.1 Required Base Operating System........... 1-1 1.1.2 Required Layered Product................. 1-2 1.2 Hardware Prerequisite........................ 1-2 1.3 License Registration......................... 1-2 1.4 Installation Procedure Requirements.......... 1-3 1.4.1 Time..................................... 1-3 1.4.2 Privileges............................... 1-3 1.4.3 Disk Space............................... 1-3 1.5 Resources Requirement........................ 1-4 1.5.1 System Parameters........................ 1-4 1.5.2 Backing Up Your System Disk.............. 1-5 1.6 Warning on OpenVMS/Hanyu Alpha Upgrades...... 1-5 2 Installation Options 2.1 Asian Printing Support Sub-Kit............... 2-1 2.2 DECwindows Motif/Hanyu Fonts................. 2-1 3 Installing OpenVMS/Hanyu Alpha using PCSI 3.1 The Installation Procedure................... 3-1 3.1.1 Invoking PCSI............................ 3-1 3.1.2 Installation Questions................... 3-2 3.2 Error Recovery............................... 3-7 iii 4 After Installing OpenVMS/Hanyu Alpha 4.1 Rebooting System............................. 4-1 4.2 Running Installation Verification Procedure.................................... 4-2 4.3 Updating Individual Compilers' Libraries..... 4-2 4.4 Determining and Reporting Problems........... 4-3 A OpenVMS/Hanyu Alpha Sample Installation using PCSI B OpenVMS/Hanyu Alpha Sample Installation Verification Procedure C OpenVMS/Hanyu Alpha Software Components and Defined System Logical Names Tables 1-1 Disk Space Requirement................... 1-3 1-2 System Parameter Requirement............. 1-4 C-1 Component File List...................... C-1 C-2 Defined System Logical Names............. C-7 iv ________________________________________________________________ Preface Purpose of This Guide This guide describes how to install OpenVMS/Hanyu Alpha Version 7.3-1 (hereafter referred to as OpenVMS/Hanyu Alpha) on OpenVMS Alpha Version 7.3-1. Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall OpenVMS/Hanyu Alpha for any other reasons. Intended Audience This guide is intended for OpenVMS/Hanyu Alpha system manager. It is assumed that users of this guide are experienced in installing and upgrading the OpenVMS operating system and are familiar with: o System Management o PCSI o VMSINSTAL Associated Documents o OpenVMS/Hanyu Alpha Version 7.3-1 Release Notes o OpenVMS Alpha Version 7.3-1 Upgrade and Installation Manual o OpenVMS License Management Facility Manual o OpenVMS Documentation set o OpenVMS/Hanyu Documentation set v o DECprint Supervisor for OpenVMS Release Notes o DECprint Supervisor for OpenVMS Software Installation Guide o Asian Printing Support for OpenVMS Version 1.0 Release Notes o Asian Printing Support for OpenVMS Version 1.0 Installation Guide. o POLYCENTER Software Installation Utility User's Guide Document Structure This guide is organized as follows: o Chapter 1 describes the preparations and requirements necessary for installing OpenVMS/Hanyu Alpha. o Chapter 2 describes the installation options available. o Chapter 3 describes how to install OpenVMS/Hanyu Alpha using PCSI. o Chapter 4 describes the steps to proceed after OpenVMS /Hanyu Alpha is installed. o Appendix A contains a log of a sample installation of OpenVMS/Hanyu Alpha using PCSI. o Appendix B contains a log of a sample execution of Installation Verification Procedure of OpenVMS/Hanyu Alpha. o Appendix C contains a list of files and logical names created or modified by this installation procedure. Conventions The following conventions are used throughout this guide. The name of the OpenVMS/Hanyu AXP operating system has been changed to OpenVMS/Hanyu Alpha. Any references to OpenVMS/Hanyu AXP or AXP are synonymous with OpenVMS/Hanyu Alpha or Alpha. vi __________________________________________________________ Convention_____________Meaning____________________________ Means pressing the key named inside the box. Carriage return. CTRL The phrase CTRL/x indicates that you must press key labeled CTRL while you simultaneously press another key. For example, , and . . Vertical ellipsis in an example . means that information not directly . related to the example has been omitted. [] In format descriptions, brackets indicate that whatever is enclosed within the brackets is optional; you can select none, one or all of the choices. UPPERCASE Indicates logical, file and command _______________________names._____________________________ vii 1 ________________________________________________________________ Preparing for OpenVMS/Hanyu Alpha Installation This chapter discusses the preparations and requirements necessary for installing OpenVMS/Hanyu Alpha. 1.1 Software Prerequisites 1.1.1 Required Base Operating System OpenVMS/Hanyu Alpha Version 7.3-1 requires the OpenVMS Alpha Version 7.3-1 operating system. OpenVMS Alpha Version 7.3-1 must be installed and running on the system before OpenVMS/Hanyu Alpha Version 7.3-1 is installed. OpenVMS/Hanyu Alpha Version 7.3-1 also requires the XPG4 locale database for the DEC Hanyu Character Set. This database is in the ALPVMSI18N02_073 kit that is provided on the same media as the OpenVMS Alpha Version 7.3-1 operating system. It is not installed during the installation of OpenVMS Alpha Version 7.3-1. To install this database, install the ALPVMSI18N02_073 kit using VMSINSTAL procedure after the installation of OpenVMS Alpha Version 7.3-1 is complete. Be sure to answer YES to the question "Do you want Chinese support?" If you are planning to set up an international environment in your system, you must select other locale databases during the installation of the ALPVMSI18N02_073 kit. You can install the locale databases after the ALPVMSI18N02_ 073 kit is installed if necessary. Please refer to the OpenVMS Alpha Version 7.3-1 Upgrade and Installation Manual for details. Preparing for OpenVMS/Hanyu Alpha Installation 1-1 Preparing for OpenVMS/Hanyu Alpha Installation 1.1 Software Prerequisites 1.1.2 Required Layered Product To utilize World-Wide PostScript Printing Subsystem feature provided by OpenVMS Alpha, it requires the installation of the DECprint Supervisor for OpenVMS (DCPS) Version 1.0C or higher. For details on the installation of DECprint Supervisor for OpenVMS, please refer to DECprint Supervisor for OpenVMS Release Notes and DECprint Supervisor for OpenVMS Software Installation Guide. 1.2 Hardware Prerequisite OpenVMS/Hanyu Alpha Version 7.3-1 requires the following hardware: o Any valid Alpha configuration supported by OpenVMS Alpha Version 7.3-1 o VT382-D Chinese terminal 1.3 License Registration You must register and load your license for OpenVMS/Hanyu Alpha Version 7.3-1 before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software. To register a license under OpenVMS, first log in to the system manager's account, SYSTEM. You then have a choice of two ways to perform the registration: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK. o At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information. For complete information on using LMF, see OpenVMS License Management Utility Manual. 1-2 Preparing for OpenVMS/Hanyu Alpha Installation Preparing for OpenVMS/Hanyu Alpha Installation 1.4 Installation Procedure Requirements 1.4 Installation Procedure Requirements The following sections discuss various requirements for installing OpenVMS/Hanyu Alpha. 1.4.1 Time The installation using PCSI takes approximately 3-10 minutes, depending on your system configuration. For example, installing OpenVMS/Hanyu Alpha on DEC 3000 Model 400 using PCSI takes about 3 minutes. 1.4.2 Privileges To install OpenVMS/Hanyu Alpha, you must log in to the system manager's account or an account that has the SETPRV privilege. In addition, CMKRNL and OPER are also needed for the installation. 1.4.3 Disk Space Installing OpenVMS/Hanyu Alpha requires certain amount of free storage disk space during the installation. Once installed, less disk space will be required. Table 1-1 summarizes the disk space requirement for OpenVMS/Hanyu Alpha Version 7.3-1. Table_1-1_Disk_Space_Requirement__________________________ Maximum disk space utilization during installation with DECwindows Motif /Hanyu fonts 72,500 blocks without DECwindows Motif /Hanyu 43,500 blocks fonts Net disk space utilization after installation with DECwindows Motif /Hanyu fonts 62,500 blocks without DECwindows Motif /Hanyu 33,500 blocks fonts_____________________________________________________ Preparing for OpenVMS/Hanyu Alpha Installation 1-3 Preparing for OpenVMS/Hanyu Alpha Installation 1.5 Resources Requirement 1.5 Resources Requirement 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 The available free blocks must be greater than or equal to the maximum disk space required for installation, i.e. 72,500 blocks or 43,500 blocks, depending on whether or not you are going to install DECwindows Motif /Hanyu fonts. 1.5.1 System Parameters Installing OpenVMS/Hanyu Alpha requires certain system parameter available resources. Table 1-2 lists the minimum required system parameter values for installation. Table_1-2_System_Parameter_Requirement____________________ Parameter_name________Minimum_value_______________________ GBLPAGES 6,100 pagelets GBLSECTIONS___________40_sections_________________________ To determine the number of free global pages and global sections on the system: first you can use the SYSGEN utility to check the current value of global pages and global sections. For example: $ MCR SYSGEN SYSGEN> SHOW GBLPAGES SYSGEN> SHOW GBLSECTIONS SYSGEN> EXIT Then, enter the following command at DCL prompt to display global pages and global sections usage on the system. $ INSTALL LIST /GLOBAL /SUMMARY The difference of the two figures must be greater than or equal to the minimum values required for installation. 1-4 Preparing for OpenVMS/Hanyu Alpha Installation Preparing for OpenVMS/Hanyu Alpha Installation 1.5 Resources Requirement 1.5.2 Backing Up Your System Disk PCSI asks if you have backed up your system disk at the beginning of the installation. Compaq recommends that you do a system disk backup before installing any software. Use the backup procedures that have been established at your site. For details on performing a system disk backup, see the section on Backup utility in the OpenVMS documentation set. 1.6 Warning on OpenVMS/Hanyu Alpha Upgrades OpenVMS/Hanyu Alpha can only be installed on the corresponding version of OpenVMS Alpha. When you upgrade OpenVMS/Hanyu Alpha system, you have to: o Upgrade the base OpenVMS Alpha system. o Then, install the OpenVMS/Hanyu Alpha kit on the upgraded base OpenVMS Alpha system. To upgrade the base OpenVMS Alpha system, you have to: 1. Remove the HSY$STARTUP.COM startup command procedure of OpenVMS/Hanyu Alpha from the system startup sequence. In other words, SYS$STARTUP:HSY$STARTUP.COM should be taken out from SYS$MANAGER:SYSTARTUP_VMS.COM site specific startup command procedure or removed from the SYSMAN utility as a startup file. 2. If your system is running OpenVMS/Hanyu Alpha Version 6.2 or a later version, you have to restore from OpenVMS/Hanyu Alpha system to OpenVMS Alpha system by entering the following command at the DCL prompt: $ PRODUCT REMOVE VMS_UI_HANYU This will remove OpenVMS/Hanyu Alpha from the system and the product database. If your system is running OpenVMS/Hanyu Alpha Version 6.1 or a prior version, you have to execute the command procedure HSY$SYSTEM:RECOVER.COM to restore from OpenVMS/Hanyu Alpha system to OpenVMS Alpha system. Preparing for OpenVMS/Hanyu Alpha Installation 1-5 Preparing for OpenVMS/Hanyu Alpha Installation 1.6 Warning on OpenVMS/Hanyu Alpha Upgrades RECOVER.COM will replace some of the localized images with the original images. ___Upgrading from OpenVMS/Hanyu Alpha Version 6.2 ___ If you are upgrading from OpenVMS/Hanyu Alpha Version 6.2, you must install the AXPHY062_MUP1 mup kit before using PCSI to restore from OpenVMS/Hanyu Alpha Version 6.2 system to OpenVMS Alpha Version 6.2 system. Otherwise you will lose all data stored in the CMGR database for user defined characters. The mup kit, AXPHY062_MUP1, is shipped together with OpenVMS/Hanyu Alpha Version 7.3-1. To install the mup kit, use PCSI command as follows: $ PRODUCT INSTALL AXPHY062_MUP1 /SOURCE = ... where the /SOURCE is used to specify the lo- cation holding the PCSI mup kit, for example /SOURCE=DKA400:[OPENVMSAXP_TW0731.KIT]. Please read the AXPHY062_MUP1.RELEASE_NOTES for details. _____________________________________________________ 3. Reboot the system. ________________________Note ________________________ If you are upgrading from OpenVMS/Hanyu Alpha Version 6.1 and have not applied the AVMSMUP01_061 mup kit, you must reset the SYSGEN parameter LGI_ CALLOUTS to 0 before rebooting the system, as follows: $ RUN SYS$SYSTEM:SYSMAN SYSMAN> PARAMETER USE CURRENT SYSMAN> PARAMETER SET LGI_CALLOUTS 0 SYSMAN> PARAMETER WRITE CURRENT SYSMAN> EXIT Otherwise, you may not log into to your system after reboot. _____________________________________________________ 1-6 Preparing for OpenVMS/Hanyu Alpha Installation Preparing for OpenVMS/Hanyu Alpha Installation 1.6 Warning on OpenVMS/Hanyu Alpha Upgrades 4. After the system has been rebooted, upgrade the base OpenVMS Alpha operating system. Preparing for OpenVMS/Hanyu Alpha Installation 1-7 2 ________________________________________________________________ Installation Options This chapter describes the options provided with the installation. 2.1 Asian Printing Support Sub-Kit There is a separate sub-kit called ASPS010 provided in the media of OpenVMS/Hanyu Alpha Version 7.3-1. It is used to install the Asian Printing Support for OpenVMS Version 1.0. If you want to have high quality Chinese printing capabilities, please install this sub-kit after the installation of OpenVMS/Hanyu Alpha Version 7.3-1. For details on the installation and features of Asian Printing Support, please refer to Asian Printing Support for OpenVMS Version 1.0 Installation Guide and Asian Printing Support for OpenVMS Version 1.0 Release Notes. ________________________Note ________________________ High quality Chinese printing is only supported with the installation of DECprint Supervisor for OpenVMS (DCPS) Version 1.0C or higher. That is, in addition to the Asian Printing Support sub-kit, you must install DCPS V1.0C or higher if you want to have the Chinese printing supported. _____________________________________________________ 2.2 DECwindows Motif/Hanyu Fonts During the installation of OpenVMS/Hanyu Alpha Version 7.3-1, you have the option to install DECwindows Motif /Hanyu fonts. If you are planning to install DECwindows Motif/Hanyu in the future, you must install this option; otherwise you do not need to install this option. If you want to install the fonts after OpenVMS/Hanyu Alpha Installation Options 2-1 Installation Options 2.2 DECwindows Motif/Hanyu Fonts Version 7.3-1 is installed, you must re-install the OpenVMS/Hanyu Alpha Version 7.3-1 by restoring the system to OpenVMS Alpha first. Please refer to Section 1.6 for details. ________________________Note ________________________ Starting with Version 7.3, OpenVMS/Hanyu Alpha no longer supports DECwindows Motif/Hanyu Version 1.2-3 or earlier. _____________________________________________________ 2-2 Installation Options 3 ________________________________________________________________ Installing OpenVMS/Hanyu Alpha using PCSI This chapter describes how to install the OpenVMS/Hanyu Alpha Version 7.3-1 operating system using PCSI utility. Section 3.1.2 contains a step-by-step description of the installation procedure. 3.1 The Installation Procedure The OpenVMS/Hanyu Alpha installation process using PCSI utility consists of a series of questions and informational messages. Once PCSI utility has started its execution phase and you abort the installation procedure (such as pressing ), some files may be left on your system and the system could be in an inconsistent state. You are recommended not to abort the installation procedure once PCSI utility has started its execution phase. 3.1.1 Invoking PCSI To start the installation, invoke the PCSI utility from a privileged account, such as the SYSTEM account. You use the following syntax to invoke PCSI utility: $ PRODUCT INSTALL VMS_UI_HANYU /SOURCE=name [/HELP] [/TEST] VMS_UI_HANYU The product name of OpenVMS/Hanyu Alpha kit. /SOURCE=name The location of the OpenVMS/Hanyu Alpha kit. By default, PCSI utility searches the location defined by PCSI$SOURCE; if PCSI$SOURCE is not defined, the current default directory is searched. Installing OpenVMS/Hanyu Alpha using PCSI 3-1 Installing OpenVMS/Hanyu Alpha using PCSI 3.1 The Installation Procedure /HELP Controls whether PCSI utility displays detailed explana- tions of VMS_UI_HANYU options and informational text. /TEST Requests PCSI utility run the Installation Verification Procedure (IVP) for OpenVMS/Hanyu Alpha Version 7.3-1. The following example displays the command to invoke to install OpenVMS/Hanyu Alpha Version 7.3-1; and shows the system response: $ PRODUCT INSTALL VMS_UI_HANYU /SOURCE=DKA200:[KIT] /HELP /TEST The following product has been selected: DEC AXPVMS VMS_UI_HANYU V7.3-1 Layered Product 3.1.2 Installation Questions This section discusses questions that appear during the installation. Appendix A contains a sample installation log showing how the questions can be answered. Some questions show the default response in brackets, for example [YES]. If you want to use the default response, press . 1. Product Confirmation PCSI utility will display the product which you choose to install. It asks for reconfirmation using the following question: The following product has been selected: DEC AXPVMS VMS_UI_HANYU V7.3-1 Layered Product Do you want to continue? [YES] If product VMS_UI_HANYU is shown, press . Otherwise, enter NO to discontinue the installation. 2. Default Option Values The installation procedure will ask if you want all the defaults for all options in OpenVMS/Hanyu Alpha Version 7.3-1 kit. Do you want all the defaults for all options? [YES] 3-2 Installing OpenVMS/Hanyu Alpha using PCSI Installing OpenVMS/Hanyu Alpha using PCSI 3.1 The Installation Procedure Notes: When selecting options, please pay attentions to the followings: o If you want all the default values, press the key. If you want to select option individually, answer NO. The system will then prompt you for each group and subgroup of files. o In OpenVMS/Hanyu Alpha V6.2, the default answer to the question "Do you want to install a new CMGR Database?" was YES. In this version of OpenVMS/Hanyu Alpha, the default answer is NO. If you take this default answer, your existing CMGR Database will not be overwritten by the installation. o If you are not sure whether you want certain files, request help by entering a question mark (?) at the prompt for that option. o After you select all the files you want, you will have a chance to view your selections and make changes if necessary. 3. System Privileges The installation procedure reminds you to set CMKRNL, OPER and SYSPRV privileges before installation. CMKRNL, OPER and SYSPRV are required for installing OpenVMS/Hanyu Alpha. Do you want to continue? [YES] CMKRNL, OPER and SYSPRV are required for installing OpenVMS/Hanyu Alpha Version 7.3-1. If this process does not have these privileges, enter NO to abort and start installation after you set privileges. 4. System Backup The installation procedure asks if you are satisfied with your system backup using the following question: You are recommended to back up your system disk before installation. Do you want to continue? [YES] Installing OpenVMS/Hanyu Alpha using PCSI 3-3 Installing OpenVMS/Hanyu Alpha using PCSI 3.1 The Installation Procedure You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press to continue. Otherwise, enter NO to discontinue the installation. After backing up your system disk, you can restart the installation. 5. Product Authorization Key The installation procedure wants to make sure you have registered and loaded the product authorization key (PAK) of VMS_UI_HANYU. You should have registered and loaded this product's authorization key. Do you want to continue? [YES] If you do not register and load VMS_UI_HANYU's authorization key (PAK), the Installation Verification Procedure (IVP) will fail and you cannot use this product even though you have installed it. Enter YES to continue. Enter NO to quit installation. 6. Delete SYS$SPECIFIC files VMS_UI_HANYU puts its component files in the direc- tories under SYS$COMMON. However, if there are files under SYS$SPECIFIC possessing the same name, those files under SYS$SPECIFIC will be used instead of those under SYS$COMMON. So it is essential to delete those SYS$SPECIFIC files in order for VMS_UI_HANYU to run successfully. Do you want to delete the files in SYS$SPECIFIC directory? [YES] If you answer NO to the question, you then need to manually delete those files under SYS$SPECIFIC when their names are in conflict with the files created by this installation procedure. Appendix C lists the files created by this installation procedure. 7. DECwindows Motif/Hanyu fonts The savesets of OpenVMS/Hanyu Alpha contain the font files of DECwindows Motif/Hanyu. If you are planning to install DECwindows Motif/Hanyu V1.2-3 or above to your system, you are recommended to install the fonts by answering YES to the question: 3-4 Installing OpenVMS/Hanyu Alpha using PCSI Installing OpenVMS/Hanyu Alpha using PCSI 3.1 The Installation Procedure Do you want to install DECwindows Motif/Hanyu fonts? [NO] If you answer NO to the question, the font files will not be installed into your system. ________________________Note ________________________ If you choose to install the DECwindows Motif/Hanyu fonts, the installation procedure will display a warning message as follows: %COPY-W-INCOMPAT, VMI$ROOT:[SYSFONT.DECW.75DPI]DECW$FONT_ALIAS_GS.DAT (input) and VMI$ROOT:[SYSFONT.DECW.75DPI]DECW$FONT_ALIAS.DAT (output) have incompatible attributes This warning message can be safely ignored. _____________________________________________________ 8. Choose DTSCS or DRC character set OpenVMS/Hanyu Alpha supports DEC Hanyu Character Set, which contains DEC SICGCC and DEC Taiwan Supplemental Character Set (DTSCS), as the default character set. DEC Recommended Character Set (DRC) had been provided in pre-OpenVMS/Hanyu VAX Version 5.4. It is provided as an optional character set in OpenVMS/Hanyu Alpha so that applications dependent on DRC can migrate to the OpenVMS/Hanyu Alpha operating system from the OpenVMS /Hanyu VAX operating system. You will be prompted to choose one of those character sets as follows: What character set (DTSCS or DRC) will this kit support? Enter YES for DTSCS and NO for DRC. [YES] To choose DTSCS , enter YES. To choose DRC, enter NO. Make sure you choose the correct character set. Note that DTSCS is recommended. 9. CMGR Database If your system already has a CMGR Database, and you want the new database to replace the old one, enter YES. Otherwise enter NO if you want to keep the old database. Installing OpenVMS/Hanyu Alpha using PCSI 3-5 Installing OpenVMS/Hanyu Alpha using PCSI 3.1 The Installation Procedure Do you want to install a new CMGR Database? [NO] 10.Release Notes The installation procedure asks if you want to install the release notes into SYS$COMMON:[SYSHLP] Do you want to install release notes on to the system? [YES] Enter either YES or NO. 11.Review Options When you have answered all the prompts and selected the options you want installed, the system gives you the opportunity to review your selections (and make changes if necessary), then installs the products, and provides informational messages. Do you want to review the options? [NO] Enter YES to review the options and make necessary changes. Enter NO to continue installation. 12.Starting of Installation Procedure When PCSI utility starts installation, it will display a number of informational messages that report the progress of the installation as follows: Execution phase starting ... The following product will be installed to destination: DEC AXPVMS VMS_UI_HANYU V7.3-1 DISK$V0731:[SYS0.SYSCOMMON.] Portion Done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% ________________________Note ________________________ During the installation, the following information message will be prompted. Simple ignore the message. %PCSI-I-RETAIN, file [SYSMSG]SORTMSG.EXE was not replaced because file from kit has lower generation number _____________________________________________________ 13.Ending of the Installation 3-6 Installing OpenVMS/Hanyu Alpha using PCSI Installing OpenVMS/Hanyu Alpha using PCSI 3.1 The Installation Procedure The following message indicates that the installation procedure is completed, and the IVP complete success- fully. The following product has been installed: DEC AXPVMS VMS_UI_HANYU V7.3-1 Layered Product %PCSI-I-IVPEXECUTE, executing test procedure DEC AXPVMS VMS_UI_HANYU V7.3-1 ... %PCSI-I-IVPSUCCESS, test procedure completed successfully Finally, PCSI utility will display messages to remind you how to start VMS_UI_HANYU. DEC AXPVMS VMS_UI_HANYU V7.3-1: DEC AXPVMS VMS_UI_HANYU V7.3-1 FULL Execute SYS$STARTUP:HSY$STARTUP.COM at startup time The file SYS$STARTUP:HSY$STARTUP.COM must be executed at startup time. This can be done with SYSMAN as $RUN SYS$SYSTEM:SYSMAN SYSMAN> STARTUP ADD FILE HSY$STARTUP.COM - _SYSMAN> /PARAMETER=(P1,P2,P3,P4,P5,P6,P7,P8) - _SYSMAN> /PHASE=LPBEGIN OR By adding the following line in SYS$MANAGER:SYSTARTUP_VMS.COM $ @SYS$STARTUP:HSY$STARTUP.COM Please perform a system shutdown and restart. OpenVMS/Hanyu V7.3-1 will become available when the system is up again. 3.2 Error Recovery If errors occur during the installation, PCSI utility will display error messages. You can choose to terminate or continue the installation. (Note : Any interruption during installation will leave the system in an inconsistent state. You can correct this by reinstalling the product to a successful completion and then using the PRODUCT REMOVE command to deinstall the product. A product can be removed only if the installation is complete.) Installing OpenVMS/Hanyu Alpha using PCSI 3-7 4 ________________________________________________________________ After Installing OpenVMS/Hanyu Alpha After you have installed the OpenVMS/Hanyu Alpha operating system, you need to perform several important tasks to prepare the system for operation. This chapter describes these tasks in the following sections. 4.1 Rebooting System First, you have to reboot the system. You can use the SHUTDOWN command procedure as follows: $ @SYS$SYSTEM:SHUTDOWN Please be reminded that the file SYS$STARTUP:HSY$STARTUP.COM must be executed at startup time. This can be done by one of the following procedures: Procedure A By adding the following line to your site-specific OpenVMS startup procedure, SYS$MANAGER:SYSTARTUP_ VMS.COM $ @SYS$STARTUP:HSY$STARTUP.COM ________________________Note ________________________ If you plan to install layered products with Chinese capability, for example, Asian Printing Support for OpenVMS, you should add this layered product startup command procedure after the above line. Otherwise, the layered product would not startup properly. _____________________________________________________ After Installing OpenVMS/Hanyu Alpha 4-1 After Installing OpenVMS/Hanyu Alpha 4.1 Rebooting System Procedure B This can be done with SYSMAN as $ RUN SYS$SYSTEM:SYSMAN SYSMAN> STARTUP ADD FILE HSY$STARTUP.COM - _SYSMAN> /PARAMETER=(P1,P2,P3,P4,P5,P6,P7,P8) - _SYSMAN> /PHASE=LPBEGIN 4.2 Running Installation Verification Procedure Once the system is running again, you can invoke a command procedure to verify the OpenVMS/Hanyu Alpha installation. $ @SYS$COMMON:[SYSTEST.VMS-HANYU]VMS-HANYU$IVP This Installation Verification Procedure will be invoked by the installation procedure of this version of OpenVMS /Hanyu Alpha. Appendix B contains a sample log of the execution of the Installation Verification Procedure. 4.3 Updating Individual Compilers' Libraries Individual compilers have their own libraries. If you upgrade your system to OpenVMS/Hanyu Alpha Version 7.3-1 without re-building the corresponding libraries for individual compilers, those libraries will not automatically reflect the latest contents of the STARLET library. Using new symbols introduced in the latest version of the STARLET library will result in compilation errors. Therefore, after the system is installed or upgraded to OpenVMS/Hanyu Alpha, you are recommended to re-install or upgrade the compiler and choose to rebuild its library during installation. For example, Chinese SMG defines several new literals for supporting character set in the STARLET library of the system, such as SMG$C_ASCII, SMG$C_SPEC_GRAPHICS and SMG$C_HANYU. Users can specify the character set parameter in any SMG routine call with the new literals for processing Chinese characters in their application. Thus, you will have to re-install the compiler and rebuild its library. The program compilation will fail if the compiler library is not updated. 4-2 After Installing OpenVMS/Hanyu Alpha After Installing OpenVMS/Hanyu Alpha 4.4 Determining and Reporting Problems 4.4 Determining and Reporting Problems If you encounter a problem while using OpenVMS/Hanyu Alpha Version 7.3-1, report it to Compaq. Depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call Compaq if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). 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 alternative instructions provided by Compaq for reporting SPD non-conformance problems. If you find an error in the OpenVMS/Hanyu Documentation set, fill out and submit the Reader's Comments form to Compaq. After Installing OpenVMS/Hanyu Alpha 4-3 A ________________________________________________________________ OpenVMS/Hanyu Alpha Sample Installation using PCSI The following is the log of a sample installation using PCSI. $ PRODUCT INSTALL VMS_UI_HANYU /SOURCE=DKA200:[KIT] /HELP /TEST The following product has been selected: DEC AXPVMS VMS_UI_HANYU V7.3-1 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS VMS_UI_HANYU V7.3-1: DEC AXPVMS VMS_UI_HANYU V7.3-1 FULL COPYRIGHT (C) 1994-1999,2000,2001,2002 -- All Rights Reserved. Compaq Computer Corporation Houston, Texas, USA Do you want the defaults for all options? [YES] NO DEC AXPVMS VMS V7.3-1 [Installed] * Configuration options for this referenced product cannot * be changed now because the product is already installed. * (You can use PRODUCT RECONFIGURE later to change options.) CMKRNL, OPER and SYSPRV are required for installing OpenVMS/Hanyu Alpha. CMKRNL, OPER and SYSPRV privileges are required for installing OpenVMS/Hanyu Alpha V7.3-1. If this process does not have these privileges, enter NO to abort the installation. You can restart the installation with a process that has these privileges. Do you want to continue? [YES] You are recommended to back up your system disk before installation. OpenVMS/Hanyu Alpha Sample Installation using PCSI A-1 OpenVMS/Hanyu Alpha Sample Installation using PCSI You should always back up your system disk before performing an installation. If you are satisfied with the back up of your system disk, enter YES to continue; otherwise enter NO to discontinue the installation. You can restart the installation after backing up your system disk. Do you want to continue? [YES] You should have registered and loaded this product's authorization key. If you do not register and load this product's authorization key (PAK). You will fail the verification procedure (IVP) and you cannot use this product even though you have installed it. Enter YES to continue. Enter NO to quit installation. Do you want to continue? [YES] This kit will be installed under the SYS$COMMON directory of this node. If there are files in the SYS$SPECIFIC directory and they are not removed, those files will be used instead of the newly installed ones. Do you want to delete the files in the SYS$SPECIFIC directory? [YES] If you have installed or are planning to install DECwindows Motif/Hanyu V1.2-3 or higher, you are recommended to install the DECwindows Motif/Hanyu fonts. Do you want to install the DECwindows Motif/Hanyu fonts? [NO] To choose DTSCS, enter YES. To choose DRC, enter NO. Please make sure you choose the correct character set. What Character set (DTSCS or DRC) will this kit support? Enter YES for DTSCS, and NO for DRC. [YES] YES If a CMGR Database already exists on your system, do you want to replace it with a new one? Answer YES to this question only if you want to replace the the existing CMGR Database. Otherwise answer NO. Do you want to install a new CMGR Database? [NO] This option will install release notes into SYS$COMMON:[SYSHLP] Do you want to install release notes on to the system? [YES] Do you want to review the options? [NO] YES A-2 OpenVMS/Hanyu Alpha Sample Installation using PCSI OpenVMS/Hanyu Alpha Sample Installation using PCSI DEC AXPVMS VMS_UI_HANYU V7.3-1: DEC AXPVMS VMS_UI_HANYU V7.3-1 FULL DEC AXPVMS VMS V7.3-1 [Installed] Do you want to delete the files in the SYS$SPECIFIC directory?: YES Do you want to install the DECwindows Motif/Hanyu fonts?: NO What Character set (DTSCS or DRC) will this kit support? Enter YES for DTSCS, and NO for DRC.: YES Do you want to install a new CMGR Database? : NO Do you want to install release notes on to the system?: YES Are you satisfied with these options? [YES] Execution phase starting ... The following product will be installed to destination: DEC AXPVMS VMS_UI_HANYU V7.3-1 DISK$V731:[SYS0.SYSCOMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS VMS_UI_HANYU V7.3-1 Layered Product %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS VMS_UI_HANYU V7.3-1 ... %PCSI-I-IVPSUCCESS, test procedure completed successfully DEC AXPVMS VMS_UI_HANYU V7.3-1: DEC AXPVMS VMS_UI_HANYU V7.3-1 FULL Execute SYS$STARTUP:HSY$STARTUP.COM at startup time The file SYS$STARTUP:HSY$STARTUP.COM must be executed at startup time. This can be done with SYSMAN as $RUN SYS$SYSTEM:SYSMAN SYSMAN> STARTUP ADD FILE HSY$STARTUP.COM - _SYSMAN> /PARAMETER=(P1,P2,P3,P4,P5,P6,P7,P8) - _SYSMAN> /PHASE=LPBEGIN OR By adding the following line in SYS$MANAGER:SYSTARTUP_VMS.COM $ @SYS$STARTUP:HSY$STARTUP.COM Please perform a system shutdown and restart. OpenVMS/Hanyu Alpha V7.3-1 will become available when the system is up again. OpenVMS/Hanyu Alpha Sample Installation using PCSI A-3 B ________________________________________________________________ OpenVMS/Hanyu Alpha Sample Installation Verification Procedure This appendix contains a sample of the Installation Verification Procedure (IVP). Refer to Chapter 4 for information about running the IVP. $ @SYS$COMMON:[SYSTEST.VMS-HANYU]VMS-HANYU$IVP *********************************************************************** * * * OpenVMS/Hanyu Alpha V7.3-1 * * INSTALLATION VERIFICATION PROCEDURE * * * * COPYRIGHT (C) 1993 - 2001, 2002 * * * * COMPAQ COMPUTER CORPORATION * * HOUSTON, TEXAS. ALL RIGHTS RESERVED. * * * *********************************************************************** Starting OpenVMS/Hanyu Alpha IVP ... OpenVMS/Hanyu Alpha IVP completed successfully. $ OpenVMS/Hanyu Alpha Sample Installation Verification Procedure B-1 C ________________________________________________________________ OpenVMS/Hanyu Alpha Software Components and Defined System Logical Names The OpenVMS/Hanyu Alpha installation procedure installs a number of files on your system. Table C-1 contains the names of all files installed into SYS$COMMON directory of your system when OpenVMS/Hanyu Alpha is installed. Table_C-1_Component_File_List_____________________________ Directory__________________File______________________Change [DECW$DEFAULTS.SYSTEM.ZH_ HEVE$WIDGETS_MOTIF.UID New TW] [HSYEXE.EXAMPLE] CALLASMG$C.C New [HSYEXE.EXAMPLE] CALLASMG$FORTRAN.FOR New [HSYEXE.EXAMPLE] DATETIME.C New [HSYEXE.EXAMPLE] EXAM31.DAT New [HSYEXE.EXAMPLE] EXAM32.DAT New [HSYEXE.EXAMPLE] EXAMPLE.B32 New [HSYEXE.EXAMPLE] POET.DAT New [HSYEXE.EXAMPLE] SAMPLE.C New [HSYEXE.EXAMPLE] SAMPLE.FOR New [HSYEXE.EXAMPLE] SAMPLE.MAR New [HSYEXE.EXAMPLE] SAMPLE_HSYSHR.C New [HSYEXE.EXAMPLE] SAMPLE_MERGE.C New [HSYEXE.EXAMPLE] SAMPLE_SORT1.FOR New [HSYEXE.EXAMPLE] SAMPLE_SORT2.FOR New [HSYEXE.EXAMPLE] TEXT.IN New (continued on next page) Alpha Software Components and Defined System Logical Names C-1 OpenVMS/Hanyu Alpha Software Components and Defined System Logical Names Table_C-1_(Cont.)_Component_File_List_____________________ Directory__________________File______________________Change [HSYEXE.HANYU073] AVMS$PCSI_PUT_ADECW_ New FONT_HY.COM [HSYEXE.HANYU073] AVMS$PCSI_PUT_PROCEDURE_ New HY.COM [HSYEXE.HANYU073] AVMS$PCSI_REM_PROCEDURE_ New HY.COM [HSYEXE.HANYU073] AVMS$PCSI_REM_SPECIFIC_ New FILE_HY.COM [HSYEXE.HANYU073] EDIT.CLD Replace [HSYEXE.HANYU073] EDIT_EN.HLP Replace [HSYEXE.HANYU073] HELPLIB_HY_ATSIGN.HLP New [HSYEXE.HANYU073] SORT.CLD Replace [HSYEXE.HANYU073] SORTMERGE_DCL.HLP Replace [HSYEXE] CMGR.EXE New [HSYEXE] FONTHANDL.EXE New [HSYEXE] HANYUGEN.EXE New [HSYEXE] HDUMP.EXE New [HSYEXE] HEDT.EXE New [HSYEXE] HMAIL.EXE New [HSYEXE] HMAILEDIT.COM New [HSYEXE] HSY$CHARACTER_INDEX.DAT New [HSYEXE] HSY$CHARACTER_MASTER_ New INDEX.DAT [HSYEXE] HSY$DECHANYU_CODE_ New INFO.DAT [HSYEXE] HSY$GLYPH_24X24_USER.FDL New [HSYEXE] HSY$GLYPH_24X24_USER.GDB New [HSYEXE] HSY$GLYPH_32X32_USER.GDB New [HSYEXE] HSY$GLYPH_40X40_USER.GDB New [HSYEXE] HSY$HANYU_SOFT.GDB New (continued on next page) C-2 OpenVMS/Hanyu Alpha Software Components and Defined System Logical Names Alpha Software Components and Defined System Logical Names Table_C-1_(Cont.)_Component_File_List_____________________ Directory__________________File______________________Change [HSYEXE] HSY$HEI_24X24_USER.GDB New [HSYEXE] HSY$HEI_32X32_USER.GDB New [HSYEXE] HSY$HEI_40X40_USER.GDB New [HSYEXE] HSY$HEI_CHARACTER_ New INDEX.DAT [HSYEXE] HSY$HEI_CHARACTER_ New INDEX.DAT [HSYEXE] HSY$HEI_SORTDB.CDB New [HSYEXE] HSY$HEI_SORT_INDEX.DAT New [HSYEXE] HSY$INIT.EXE New [HSYEXE] HSY$PHRASE.DAT New [HSYEXE] HSY$PHRASE_CLASS.DAT New [HSYEXE] HSY$SORTDB.CDB New [HSYEXE] HSY$SORT_INDEX.DAT New [HSYEXE] HSY$SUNG_24X24_USER.GDB New [HSYEXE] HSY$SUNG_32X32_USER.GDB New [HSYEXE] HSY$SUNG_40X40_USER.GDB New [HSYEXE] HSY$SUNG_CHARACTER_ New INDEX.DAT [HSYEXE] HSY$SUNG_SORTDB.CDB New [HSYEXE] HSY$SUNG_SORT_INDEX.DAT New [HSYEXE] HSY$TAIWAN_SPECIFIC.DAT New [HSYEXE] HTPU.EXE New [HSYEXE] PHRASE.EXE New [HSYEXE] RECOVER.COM New [HSYHLP.HANYU] CMGREDIT.HLB New [HSYHLP.HANYU] CMGRHELP.HLB New [HSYHLP.HANYU] HANYUGEN.HLB New [HSYHLP.HANYU] HEDTHELP.HLB New (continued on next page) Alpha Software Components and Defined System Logical Names C-3 OpenVMS/Hanyu Alpha Software Components and Defined System Logical Names Table_C-1_(Cont.)_Component_File_List_____________________ Directory__________________File______________________Change [HSYHLP.HANYU] HEVE$HELP.HLB New [HSYHLP.HANYU] HEVE$KEYHELP.HLB New [HSYHLP.HANYU] HMAILHELP.HLB New [HSYHLP.HANYU] HTPUHELP.HLB New [HSYHLP.HANYU] HSYHLP.HLB New [HSYHLP] CMGREDIT.HLB New [HSYHLP] CMGRHELP.HLB New [HSYHLP] HANYUGEN.HLB New [HSYHLP] HEDTHELP.HLB New [HSYHLP] HEVE$HELP.HLB New [HSYHLP] HEVE$KEYHELP.HLB New [HSYHLP] HMAILHELP.HLB New [HSYHLP] HSYHLP.HLB New [HSYHLP] HTPUHELP.HLB New [SYS$LDR] HSY$ASDRIVER.EXE New [SYS$LDR] HSY$FHDRIVER.EXE New [SYS$STARTUP] HSY$CONFIG.COM New [SYS$STARTUP] HSY$STARTUP.COM New [SYS$STARTUP] HSYHLPSTARTUP.COM New [SYSEXE] DCL.EXE Replace [SYSEXE] SEARCH.EXE Replace [SYSEXE] SMGBLDTRM.EXE Replace [SYSEXE] SMGTERMS.TXT Replace [SYSEXE] TERMTABLE.EXE Replace [SYSHLP.HANYU] TFF$TFUHELP.HLB New [SYSHLP.HANYU] HELPLIB.HLB New [SYSLIB] CMGRDISPSHR.EXE New [SYSLIB] CMGRSHR.EXE New [SYSLIB] HEDTSHR.EXE New (continued on next page) C-4 OpenVMS/Hanyu Alpha Software Components and Defined System Logical Names Alpha Software Components and Defined System Logical Names Table_C-1_(Cont.)_Component_File_List_____________________ Directory__________________File______________________Change [SYSLIB] HEDTSHR.IIF New [SYSLIB] HEVE$SECTION.TPU$SECTION New [SYSLIB] HEVE$WIDGETS_MOTIF.UID New [SYSLIB] HEVE.DAT New [SYSLIB] HMAILSHR.EXE New [SYSLIB] HMAILSHRP.EXE New [SYSLIB] HSMGSHR.EXE New [SYSLIB] HSMGSHR.IIF New [SYSLIB] HSORTSHR.IIF New [SYSLIB] HSYIMGLIB.OLB New [SYSLIB] HSYOBJLIB.OLB New [SYSLIB] HSYSHR.EXE New [SYSLIB] HSYSHR.IIF New [SYSLIB] HTPU$CCTSHR.EXE New [SYSLIB] HTPU$DEBUG.TPU New [SYSLIB] HTPU$MOTIFSHR.EXE New [SYSLIB] HTPU.DAT New [SYSLIB] HTPUSHR.EXE New [SYSLIB] HTPUSHR.IIF New [SYSLIB] LATSYM$SETUP.EXE New [SYSLIB] SOR4BYTEDICT.EXE New [SYSLIB] SORTAIDICT.EXE New [SYSLIB] SORTDTYPE.EXE New [SYSMSG.HANYU] CLIUTLMSG.EXE New [SYSMSG.HANYU] CMGRMSG.EXE New [SYSMSG.HANYU] HDUMPMSG.EXE New [SYSMSG.HANYU] HMAILMSG.EXE New [SYSMSG.HANYU] HTPUMSG.EXE New [SYSMSG.HANYU] SORTMSG.EXE New (continued on next page) Alpha Software Components and Defined System Logical Names C-5 OpenVMS/Hanyu Alpha Software Components and Defined System Logical Names Table_C-1_(Cont.)_Component_File_List_____________________ Directory__________________File______________________Change [SYSMSG] CLIUTLMSG.EXE Replace [SYSMSG] CMGRMSG.EXE New [SYSMSG] HDUMPMSG.EXE New [SYSMSG] HEDTMSG.EXE New [SYSMSG] HMAILMSG.EXE New [SYSMSG] HTPUMSG.EXE New [SYSMSG] SORTMSG.EXE New [SYSTEST.VMS-HANYU] AVMSIVP.EXE New [SYSTEST.VMS-HANYU]________VMS-HANYU$IVP.COM_________New__ C-6 OpenVMS/Hanyu Alpha Software Components and Defined System Logical Names Alpha Software Components and Defined System Logical Names Table C-2 lists the system logical names defined by the OpenVMS/Hanyu Alpha startup procedure. Table_C-2_Defined_System_Logical_Names____________________ Logical_Name____Value_____________________________________ CMGR$MASTER HSY$SYSTEM:HSY$CHARACTER_MASTER_INDEX HSY$EXAMPLE SYS$SYSROOT:[HSYEXE.EXAMPLE] HSY$HELP SYS$SYSROOT:[HSYHLP.HANYU], SYS$SYSROOT:[HSYHLP] HSY$LIBRARY SYS$LIBRARY HSY$SYSTEM SYS$SYSROOT:[HSYEXE] HSY$SYSTEM_ HSY$SYSTEM PHRASE HSY$USER_ SYS$LOGIN PHRASE HTPU$SECTION HEVE$SECTION HTPU$JOURNAL SYS$SCRATCH SYS$HELP SYS$SYSROOT:[SYSHLP.HANYU], SYS$SYSROOT:[SYSHLP] SYS$MESSAGE SYS$SYSROOT:[SYSMSG.HANYU], SYS$SYSROOT:[SYSMSG] HEDTSHR_TV HEDTSHR HSMGSHR_TV HSMGSHR HSORTSHR_TV SORTSHR HSYSHR_TV HSYSHR HTPUSHR_TV______HTPUSHR___________________________________ Alpha Software Components and Defined System Logical Names C-7