____________________________________________________ HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers Installation Guide Order Number: BA322-90039 December 2005 This document contains installation information for the HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers operating system. Revision/Update Information: This is a new manual. Software Version: HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers Hewlett-Packard Company Palo Alto, California ________________________________________________________________ First Printing, December 2005 © Copyright 2005 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Printed in the US This document was prepared using DECdocument, Version 3.3- 1b. _________________________________________________________________ Contents Preface................................................... v 1 Preparing for HP OpenVMS/Hanzi for Integrity Servers 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 HP OpenVMS/Hanzi for Integrity Servers Upgrades.............................. 1-5 2 Installation Options 2.1 DECwindows Motif/Hanzi Fonts.................. 2-1 3 Installing HP OpenVMS/Hanzi for Integrity Servers 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-6 iii 4 After Installing HP OpenVMS/Hanzi for Integrity Servers 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-2 A HP OpenVMS/Hanzi Sample Installation using PCSI B HP OpenVMS/Hanzi Sample Installation Verification Procedure C HP OpenVMS/Hanzi 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-6 iv _________________________________________________________________ Preface Purpose of This Guide This guide describes how to install HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers (hereafter referred to as HP OpenVMS/Hanzi for Integrity Servers) on HP OpenVMS Version 8.2-1 for Integrity Servers. Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall HP OpenVMS/Hanzi for Integrity Servers for any other reasons. Intended Audience This guide is intended for HP OpenVMS/Hanzi for Integrity Servers system manager. It is assumed that users of this guide are experienced in installing and upgrading the HP OpenVMS operating system and are familiar with: o System Management o PCSI Associated Documents o HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers Release Notes o HP OpenVMS Version 8.2-1 for Integrity Servers Upgrade and Installation Manual o HP OpenVMS License Management Facility Manual o HP OpenVMS Documentation set o HP OpenVMS/Hanzi Documentation set v o DECprint Supervisor for OpenVMS Release Notes o DECprint Supervisor for OpenVMS Software 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 HP OpenVMS/Hanzi for Integrity Servers. o Chapter 2 describes the installation options available. o Chapter 3 describes how to install HP OpenVMS/Hanzi for Integrity Servers using PCSI. o Chapter 4 describes the steps to proceed after HP OpenVMS/Hanzi for Integrity Servers is installed. o Appendix A contains a log of a sample installation of HP OpenVMS/Hanzi for Integrity Servers using PCSI. o Appendix B contains a log of a sample execution of Installation Verification Procedure of HP OpenVMS/Hanzi for Integrity Servers. 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. ___________________________________________________________ Convention_____________Meaning_____________________________ Means pressing the key named inside the box. Carriage return. vi ___________________________________________________________ Convention_____________Meaning_____________________________ 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 HP OpenVMS/Hanzi for Integrity Servers Installation This chapter discusses the preparations and requirements necessary for installing HP OpenVMS/Hanzi for Integrity Servers. 1.1 Software Prerequisites 1.1.1 Required Base Operating System HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers requires the HP OpenVMS Version 8.2-1 for Integrity Servers operating system. HP OpenVMS Version 8.2-1 for Integrity Servers must be installed and running on the system before HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers is installed. HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers and World-Wide Postscript Printing Subsystem (WWPPS) utility also require the XPG4 locale database for the Chinese support and Unicode support. The databases are in the HP-I64VMS-VMSI18N-V0802-1-1.PCSI kit that is provided on the same media as the HP OpenVMS Version 8.2-1 for Integrity Servers operating system. It is not installed during the installation of HP OpenVMS Version 8.2-1 for Integrity Servers. To install this database, install the HP-I64VMS-VMSI18N-V0802-1-1.PCSI kit using PCSI Utility after the installation of HP OpenVMS Version 8.2-1 for Integrity Servers is complete. Be sure to answer YES to the questions "Chinese support [YES]" and "Unicode support [YES]". However, All locale databases will be installed if you select the defaults for all options. ________________________ Note ________________________ The Chinese locale database includes GB18030 support Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation 1-1 Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation 1.1 Software Prerequisites during the installation of the HP-I64VMS-VMSI18N- V0802-1-1.PCSI kit. ______________________________________________________ If you are planning to set up an international environment in your system, you must select other locale databases during the installation of the HP-I64VMS-VMSI18N-V0802- 1-1.PCSI kit. You can install the locale databases after the HP-I64VMS-VMSI18N-V0802-1-1.PCSI kit is installed if necessary. Please refer to the HP OpenVMS Version 8.2-1 for Integrity Servers Upgrade and Installation Manual for details. 1.1.2 Required Layered Product To utilize World-Wide PostScript Printing Subsystem feature provided by it requires the installation of the DECprint Supervisor for OpenVMS (DCPS). 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 HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers requires the following hardware: o Any valid system configuration supported by HP OpenVMS Version 8.2-1 for Integrity Servers o VT382-CB Chinese terminal 1.3 License Registration HP OpenVMS on Integrity servers is offered with a new license type, a Per-Processor License (PPL). HP OpenVMS for Integrity Servers licenses are also packaged different, using Operating Environment (OE) bundles. The OE bundles are groups of individual product offered together under a single license. 1-2 Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation 1.3 License Registration The HP OpenVMS/Hanzi for Integrity Servers is part of Operating Environment (OE) bundles and is licensed under HP OpenVMS package. No Product Authorization Keys (PAKs) for HP OpenVMS/Hanzi for Integrity Servers requests when the key for HP OpenVMS for Integrity Servers loads on the systems. 1.4 Installation Procedure Requirements The following sections discuss various requirements for installing HP OpenVMS/Hanzi for Integrity Servers. 1.4.1 Time The installation using PCSI takes approximately 3-10 minutes, depending on your system configuration. For example, installing HP OpenVMS/Hanzi for Integrity Servers on HP RX2600 Integrity server using PCSI takes about 3 minutes. 1.4.2 Privileges To install HP OpenVMS/Hanzi for Integrity Servers, 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 HP OpenVMS/Hanzi for Integrity Servers 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 HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers. Table_1-1_Disk_Space_Requirement___________________________ Maximum disk space utilization during installation with DECwindows Motif /Hanzi fonts 112,000 blocks (continued on next page) Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation 1-3 Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation 1.4 Installation Procedure Requirements Table_1-1_(Cont.)_Disk_Space_Requirement___________________ without DECwindows Motif /Hanzi 64,000 blocks fonts Net disk space utilization after installation with DECwindows Motif /Hanzi fonts 107,000 blocks without DECwindows Motif /Hanzi 52,000 blocks fonts______________________________________________________ 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. 112,000 blocks or 64,000 blocks, depending on whether or not you are going to install DECwindows Motif /Hanzi fonts. 1.5.1 System Parameters Installing HP OpenVMS/Hanzi for Integrity Servers 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 950 pagelets GBLSECTIONS___________2_sections___________________________ To determine the number of free global pages and global sections on the system: first you can use the SYSMAN utility to check the current value of global pages and global sections. For example: 1-4 Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation 1.5 Resources Requirement $ MCR SYSMAN SYSMAN> PARAMETERS SHOW GBLPAGES SYSMAN> PARAMETERS SHOW GBLSECTIONS SYSMAN> 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.5.2 Backing Up Your System Disk PCSI asks if you have backed up your system disk at the beginning of the installation. HP 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 HP OpenVMS documentation set. 1.6 Warning on HP OpenVMS/Hanzi for Integrity Servers Upgrades HP OpenVMS/Hanzi for Integrity Servers can only be installed on the corresponding version of HP OpenVMS for Integrity Servers. When you upgrade HP OpenVMS/Hanzi for Integrity Servers, you have to: o Upgrade the base HP OpenVMS for Integrity Servers. o Then, install the HP OpenVMS/Hanzi for Integrity Servers kit on the upgraded base HP OpenVMS for Integrity Servers. To upgrade the base HP OpenVMS for Integrity Servers, you have to: 1. Remove the HSY$STARTUP.COM startup command procedure of HP OpenVMS/Hanzi for Integrity Servers 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. Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation 1-5 Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation 1.6 Warning on HP OpenVMS/Hanzi for Integrity Servers Upgrades 2. If your system is running HP OpenVMS/Hanzi for Integrity Servers, you have to restore from HP OpenVMS/Hanzi for Integrity Servers to HP OpenVMS for Integrity Servers by entering the following command at the DCL prompt: $ PRODUCT REMOVE VMS_UI_HANZI This will remove HP OpenVMS/Hanzi for Integrity Servers from the system and the product database. 3. Reboot the system. 4. After the system has been rebooted, upgrade the base HP OpenVMS for Integrity Servers operating system. 1-6 Preparing for HP OpenVMS/Hanzi for Integrity Servers Installation 2 _________________________________________________________________ Installation Options This chapter describes the options provided with the installation. 2.1 DECwindows Motif/Hanzi Fonts During the installation of HP OpenVMS/Hanzi Version 8.2- 1 for Integrity Servers, you have the option to install DECwindows Motif/Hanzi fonts. If you are planning to install DECwindows Motif/Hanzi in the future, you must install this option; otherwise you do not need to select this option. If you want to install the fonts after HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers is installed, you must re-install the HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers by restoring the system to HP OpenVMS for Integrity Servers first. Please refer to Section 1.6 for details. Installation Options 2-1 3 _________________________________________________________________ Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI This chapter describes how to install the HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers 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 HP OpenVMS/Hanzi for Integrity Servers 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_HANZI /SOURCE=name [/HELP] [/TEST] VMS_UI_HANZI The product name of OpenVMS/Hanzi for Integrity Servers kit. /SOURCE=name The location of the OpenVMS/Hanzi for Integrity Servers 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 HP OpenVMS/Hanzi for Integrity Servers using PCSI 3-1 Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI 3.1 The Installation Procedure /HELP Controls whether PCSI utility displays detailed explanations of VMS_UI_HANZI options and informational text. /TEST Requests PCSI utility run the Installation Verification Procedure (IVP) for HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers. The following example displays the command to invoke to install HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers; and shows the system response: $ PRODUCT INSTALL VMS_UI_HANZI /SOURCE=DKA200:[KIT] /HELP /TEST The following product has been selected: HP I64VMS VMS_UI_HANZI V8.2-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: HP I64VMS VMS_UI_HANZI V8.2-1 Layered Product Do you want to continue? [YES] If product VMS_UI_HANZI 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/Hanzi I64 Version 8.2-1 kit. Do you want all the defaults for all options? [YES] 3-2 Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI Installing HP OpenVMS/Hanzi for Integrity Servers 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 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/Hanzi I64. Do you want to continue? [YES] CMKRNL, OPER and SYSPRV are required for installing HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers. 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] 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. Delete SYS$SPECIFIC files Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI 3-3 Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI 3.1 The Installation Procedure VMS_UI_HANZI puts its component files in the directories 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_HANZI 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. 6. DECwindows Motif/Hanzi fonts The savesets of HP OpenVMS/Hanzi for Integrity Servers contain the font files of DECwindows Motif/Hanzi. If you are planning to install DECwindows Motif/Hanzi V1.5 or above to your system, you are recommended to install the fonts by answering YES to the question: Do you want to install DECwindows Motif/Hanzi fonts? [NO] If you answer NO to the question, the font files will not be installed into your system. 7. 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. Do you want to install a new CMGR Database? [NO] 8. 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. 9. Review Options 3-4 Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI 3.1 The Installation Procedure 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. 10. 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: HP I64VMS VMS_UI_HANZI V8.2-1 DISK$V821:[SYS0.SYSCOMMON.] Portion Done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% 11. Ending of the Installation The following message indicates that the installation procedure is completed, and the IVP complete successfully. The following product has been installed: HP I64VMS VMS_UI_HANZI V8.2-1 Layered Product %PCSI-I-IVPEXECUTE, executing test procedure HP I64VMS VMS_UI_HANZI V8.2-1 ... %PCSI-I-IVPSUCCESS, test procedure completed successfully Finally, PCSI utility will display messages to remind you how to start VMS_UI_HANZI. HP I64VMS VMS_UI_HANZI V8.2-1: HP I64VMS VMS_UI_HANZI V8.2-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 Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI 3-5 Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI 3.1 The Installation Procedure By adding the following line in SYS$MANAGER:SYSTARTUP_VMS.COM $ @SYS$STARTUP:HSY$STARTUP.COM Please perform a system shutdown and restart. OpenVMS/Hanzi I64 V8.2-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.) 3-6 Installing HP OpenVMS/Hanzi for Integrity Servers using PCSI 4 _________________________________________________________________ After Installing HP OpenVMS/Hanzi for Integrity Servers After you have installed the HP OpenVMS/Hanzi for Integrity Servers 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 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 After Installing HP OpenVMS/Hanzi for Integrity Servers 4-1 After Installing HP OpenVMS/Hanzi for Integrity Servers 4.2 Running Installation Verification Procedure 4.2 Running Installation Verification Procedure Once the system is running again, you can invoke a command procedure to verify the installation of the HP OpenVMS/Hanzi for Integrity Servers. $ @SYS$COMMON:[SYSTEST.VMS-HANZI]VMS-HANZI$IVP This Installation Verification Procedure will be invoked by the installation procedure of this version of HP OpenVMS/Hanzi for Integrity Servers. 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 HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers 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 HP OpenVMS/Hanzi for Integrity Servers, 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_ HANZI. 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.4 Determining and Reporting Problems If you encounter a problem while using HP OpenVMS/Hanzi Version 8.2-1 for Integrity Servers, report it to HP. Depending on the nature of the problem and the type of support you have, you can take one of the following actions: 4-2 After Installing HP OpenVMS/Hanzi for Integrity Servers After Installing HP OpenVMS/Hanzi for Integrity Servers 4.4 Determining and Reporting Problems o Call HP 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) 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 HP for reporting SPD non-conformance problems. If you find an error in the OpenVMS/Hanzi Documentation set, fill out and submit the Reader's Comments form to HP. After Installing HP OpenVMS/Hanzi for Integrity Servers 4-3 A _________________________________________________________________ HP OpenVMS/Hanzi Sample Installation using PCSI The following is the log of a sample installation using PCSI. $ PRODUCT INSTALL VMS_UI_HANZI /SOURCE=DKA200:[KIT] /HELP /TEST The following product has been selected: HP I64VMS VMS_UI_HANZI V8.2-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. HP I64VMS VMS_UI_HANZI V8.2-1: HP I64VMS VMS_UI_HANZI V8.2-1 FULL COPYRIGHT (C) 1994-2005 -- All Rights Reserved. Hewlett-Packard Company Palo Alto, California USA Do you want the defaults for all options? [YES] NO HP I64VMS VMS V8.2-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/Hanzi I64. CMKRNL, OPER and SYSPRV privileges are required for installing OpenVMS/Hanzi I64 V8.2-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. HP OpenVMS/Hanzi Sample Installation using PCSI A-1 HP OpenVMS/Hanzi 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] 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/Hanzi V1.5 or higher, you are recommended to install the DECwindows Motif/Hanzi fonts. Do you want to install the DECwindows Motif/Hanzi fonts? [NO] 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 HP I64VMS VMS_UI_HANZI V8.2-1: HP I64VMS VMS_UI_HANZI V8.2-1 FULL HP I64PVMS VMS V8.2-1 [Installed] Do you want to delete the files in the SYS$SPECIFIC directory?: YES Do you want to install the DECwindows Motif/Hanzi fonts?: NO 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: HP I64VMS VMS_UI_HANZI V8.2-1 DISK$V821:[SYS0.SYSCOMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been installed: HP I64VMS VMS_UI_HANZI V8.2-1 Layered Product A-2 HP OpenVMS/Hanzi Sample Installation using PCSI HP OpenVMS/Hanzi Sample Installation using PCSI %PCSI-I-IVPEXECUTE, executing test procedure for HP I64VMS VMS_UI_HANZI V8.2-1 ... %PCSI-I-IVPSUCCESS, test procedure completed successfully HP I64VMS VMS_UI_HANZI V8.2-1: HP I64VMS VMS_UI_HANZI V8.2-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/Hanzi I64 V8.2-1 will become available when the system is up again. HP OpenVMS/Hanzi Sample Installation using PCSI A-3 B _________________________________________________________________ HP OpenVMS/Hanzi 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-HANZI]VMS-HANZI$IVP *********************************************************************** * * * OpenVMS/Hanzi I64 V8.2-1 * * INSTALLATION VERIFICATION PROCEDURE * * * * COPYRIGHT (C) 1993 - 2002, 2005 * * * * HEWLETT-PACKARD COMPANY * * PALO ALTO, CALIFORNIA. ALL RIGHTS RESERVED. * * * *********************************************************************** Starting OpenVMS/Hanzi I64 IVP ... OpenVMS/Hanzi I64 IVP completed successfully. $ HP OpenVMS/Hanzi Sample Installation Verification Procedure B-1 C _________________________________________________________________ HP OpenVMS/Hanzi Software Components and Defined System Logical Names The HP OpenVMS/Hanzi for Integrity Servers 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 HP OpenVMS/Hanzi for Integrity Servers is installed. Table_C-1_Component_File_List______________________________ Directory__________________File______________________Change [DECW$DEFAULTS.SYSTEM.ZH_ HEVE$WIDGETS_MOTIF.UID New CN] [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) OpenVMS/Hanzi Software Components and Defined System Logical Names C-1 HP OpenVMS/Hanzi Software Components and Defined System Logical Names Table_C-1_(Cont.)_Component_File_List______________________ Directory__________________File______________________Change [HSYEXE.HANZI0821] AVMS$PCSI_PUT_ADECW_ New FONT_HZ.COM [HSYEXE.HANZI0821] AVMS$PCSI_PUT_PROCEDURE_ New HZ.COM [HSYEXE.HANZI0821] AVMS$PCSI_REM_PROCEDURE_ New HZ.COM [HSYEXE.HANZI0821] AVMS$PCSI_REM_SPECIFIC_ New FILE_HZ.COM [HSYEXE.HANZI0821] EDIT.CLD Replace [HSYEXE.HANZI0821] EDIT_EN.HLP Replace [HSYEXE.HANZI0821] HELPLIB_HZ_ATSIGN.HLP New [HSYEXE.HANZI0821] SORT.CLD Replace [HSYEXE.HANZI0821] SORTMERGE_DCL.HLP Replace [HSYEXE] CMGR.EXE New [HSYEXE] FONTHANDL.EXE New [HSYEXE] HANZIGEN.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$DECGB2312_CODE_ New INFO.DAT [HSYEXE] HSY$GLYPH_24X24_USER.GDB New [HSYEXE] HSY$GLYPH_32X32_USER.GDB New [HSYEXE] HSY$GLYPH_40X40_USER.GDB New [HSYEXE] HSY$HEI_24X24_USER.GDB New [HSYEXE] HSY$HEI_32X32_USER.GDB New (continued on next page) C-2 HP OpenVMS/Hanzi Software Components and Defined System Logical Names HP OpenVMS/Hanzi Software Components and Defined System Logical Names Table_C-1_(Cont.)_Component_File_List______________________ Directory__________________File______________________Change [HSYEXE] HSY$HEI_40X40_USER.GDB New [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$PRC_SPECIFIC.DAT New [HSYEXE] HSY$SONG_24X24_USER.GDB New [HSYEXE] HSY$SONG_32X32_USER.GDB New [HSYEXE] HSY$SONG_40X40_USER.GDB New [HSYEXE] HSY$SONG_CHARACTER_ New INDEX.DAT [HSYEXE] HSY$SONG_SORTDB.CDB New [HSYEXE] HSY$SONG_SORT_INDEX.DAT New [HSYEXE] HSY$SORTDB.CDB New [HSYEXE] HSY$SORT_INDEX.DAT New [HSYEXE] HTPU.EXE New [HSYEXE] RECOVER.COM New [HSYHLP.HANZI] CMGREDIT.HLB New [HSYHLP.HANZI] CMGRHELP.HLB New [HSYHLP.HANZI] HANZIGEN.HLB New [HSYHLP.HANZI] HEDTHELP.HLB New [HSYHLP.HANZI] HEVE$HELP.HLB New [HSYHLP.HANZI] HEVE$KEYHELP.HLB New [HSYHLP.HANZI] HMAILHELP.HLB New [HSYHLP.HANZI] HTPUHELP.HLB New [HSYHLP.HANZI] HSYHLP.HLB New [HSYHLP] CMGREDIT.HLB New [HSYHLP] CMGRHELP.HLB New [HSYHLP] HANZIGEN.HLB New (continued on next page) OpenVMS/Hanzi Software Components and Defined System Logical Names C-3 HP OpenVMS/Hanzi Software Components and Defined System Logical Names Table_C-1_(Cont.)_Component_File_List______________________ Directory__________________File______________________Change [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.HANZI] TFF$TFUHELP.HLB New [SYSHLP.HANZI] HELPLIB.HLB New [SYSLIB] CMGRDISPSHR.EXE New [SYSLIB] CMGRSHR.EXE New [SYSLIB] HEDTSHR.EXE 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] HSYIMGLIB.OLB New [SYSLIB] HSYOBJLIB.OLB New (continued on next page) C-4 HP OpenVMS/Hanzi Software Components and Defined System Logical Names HP OpenVMS/Hanzi Software Components and Defined System Logical Names Table_C-1_(Cont.)_Component_File_List______________________ Directory__________________File______________________Change [SYSLIB] HSYSHR.EXE 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] LATSYM$SETUP.EXE New [SYSLIB] SORPRCDICT.EXE New [SYSLIB] SORTDTYPE.EXE New [SYSMSG.HANZI] CLIUTLMSG.EXE New [SYSMSG.HANZI] CMGRMSG.EXE New [SYSMSG.HANZI] HDUMPMSG.EXE New [SYSMSG.HANZI] HMAILMSG.EXE New [SYSMSG.HANZI] HTPUMSG.EXE New [SYSMSG.HANZI] SORTMSG.EXE New [SYSMSG] CLIUTLMSG.EXE Replace [SYSMSG] CMGRMSG.EXE New [SYSMSG] HDUMPMSG.EXE New [SYSMSG] HEDTMSG.EXE New [SYSMSG] HMAILMSG.EXE New [SYSMSG] HTPUMSG.EXE New [SYSTEST.VMS-HANZI] AVMSIVP.EXE New [SYSTEST.VMS-HANZI]________VMS-HANZI$IVP.COM_________New___ OpenVMS/Hanzi Software Components and Defined System Logical Names C-5 HP OpenVMS/Hanzi Software Components and Defined System Logical Names Table C-2 lists the system logical names defined by the HP OpenVMS/Hanzi for Integrity Servers 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.HANZI], SYS$SYSROOT:[HSYHLP] HSY$LIBRARY SYS$LIBRARY HSY$SYSTEM SYS$SYSROOT:[HSYEXE] HTPU$SECTION HEVE$SECTION HTPU$JOURNAL SYS$SCRATCH SYS$HELP SYS$SYSROOT:[SYSHLP.HANZI], SYS$SYSROOT:[SYSHLP] SYS$MESSAGE SYS$SYSROOT:[SYSMSG.HANZI], ________________SYS$SYSROOT:[SYSMSG]_______________________ C-6 HP OpenVMS/Hanzi Software Components and Defined System Logical Names