____________________________________________________ HP OpenVMS/Hanzi Alpha Version 8.3 Release Notes Order Number: BA322-90049 August 2006 This document describes the software features, changes, and restrictions that apply to the HP OpenVMS/Hanzi Alpha Version 8.3 operating system. Revision/Update Information: This manual supersedes the HP OpenVMS/Hanzi Alpha Version 8.2 Release Notes. Hewlett-Packard Company Palo Alto, California ________________________________________________________________ First Printing, August 2006 © Copyright 2006 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 Singapore This document was prepared using DECdocument, Version 3.3- 1b. _________________________________________________________________ Contents Preface................................................... vii 1 Introduction 1.1 An Overview of HP OpenVMS/Hanzi Alpha......... 1-1 1.1.1 Unsupported HP OpenVMS/Hanzi Alpha Feature................................... 1-2 1.2 OpenVMS/Hanzi Alpha Environment............... 1-2 1.2.1 Processor Support......................... 1-2 1.2.2 HP OpenVMS Cluster Systems................ 1-4 1.2.3 HP COM for OpenVMS........................ 1-5 1.2.4 OpenVMS Galaxy Support.................... 1-5 1.2.5 On-Demand Loading Protocol Support........ 1-5 1.2.6 Printer Support........................... 1-5 1.2.6.1 Line/Text printer with Chinese character support................................. 1-6 1.2.6.2 PostScript printer with Chinese character support....................... 1-6 1.2.7 Terminal Support.......................... 1-6 1.3 OpenVMS/Hanzi Alpha Installation.............. 1-6 1.3.1 Installation Procedure.................... 1-7 2 General Release Notes 2.1 Asian Printing Support........................ 2-1 2.2 Character Manager (CMGR)...................... 2-2 2.2.1 Font Database Migration................... 2-3 2.3 Chinese Date and Time Support................. 2-4 2.4 Editors....................................... 2-4 2.5 Hmail Utility................................. 2-5 2.6 HTPU and HEVE Version 3.1 Notes............... 2-5 2.6.1 Invoking HTPU from DCL prompt............. 2-5 iii 2.6.2 HTPU and HEVE now support DECwindows Motif /Hanzi Environment........................ 2-6 2.6.2.1 Chinese input method handling........... 2-6 2.6.3 HTPU now supports buffer change journaling................................ 2-6 2.6.4 New HTPU built-in procedures.............. 2-7 2.6.4.1 GET_INFO (SCREEN, "display_cursor")..... 2-7 2.6.4.2 GET_INFO (window-var, "character_index")...................... 2-7 2.6.4.3 JUSTIFY................................. 2-7 2.6.4.4 SET (DISPLAY_CURSOR).................... 2-7 2.6.5 Newly modified HTPU built-in procedures... 2-8 2.6.5.1 SEARCH.................................. 2-8 2.6.5.2 SET (TEXT).............................. 2-8 2.6.6 New HEVE commands......................... 2-8 2.6.6.1 DRAW BOX................................ 2-8 2.6.6.2 FULLFORM WORD........................... 2-8 2.6.6.3 HALFFORM WORD........................... 2-9 2.6.6.4 LEFT ADJUST............................. 2-9 2.6.6.5 LEFT INDENT............................. 2-9 2.6.6.6 RIGHT ADJUST............................ 2-9 2.6.6.7 RIGHT INDENT............................ 2-9 2.6.6.8 SET [NO]DISPLAY CURSOR.................. 2-9 2.6.6.9 SET FIND commands....................... 2-10 2.6.6.10 SET KEYPAD HEDT......................... 2-10 2.6.7 New logical names......................... 2-10 2.6.8 New files in HTPU and HEVE................ 2-10 2.6.9 HTPU and HEVE Restrictions................ 2-11 2.7 Search Utility................................ 2-11 2.8 World-Wide PostScript Printing Subsystem...... 2-11 2.8.1 Restriction............................... 2-12 3 Programming and System Management Release Notes 3.1 DECwindows Motif/Hanzi........................ 3-1 3.1.1 DECwindows Motif/Hanzi Version 1.6 for HP OpenVMS................................... 3-1 3.1.2 Chinese Character Fonts for DECwindows Motif/Hanzi............................... 3-1 3.2 Debugger...................................... 3-2 3.2.1 User Environment Setup.................... 3-2 3.2.1.1 Character Cell User Interface........... 3-2 3.2.1.2 DECwindows Motif User Interface......... 3-3 iv 3.2.2 EXAMINE Command........................... 3-4 3.2.3 DEPOSIT Command........................... 3-4 3.3 License Management Facility (LMF)............. 3-4 3.4 Terminal I/O.................................. 3-4 3.4.1 Supplied Device Drivers................... 3-5 3.5 Run-Time Libraries for Chinese Processing..... 3-5 3.5.1 Chinese Processing (HSY$) Run-Time Library................................... 3-5 3.5.2 Chinese Screen Management (SMG$) Run-Time Library................................... 3-6 3.5.2.1 New features............................ 3-6 3.5.2.2 Character Set Parameter................. 3-8 3.5.2.3 Changed Routine Interface............... 3-9 3.5.2.4 SMG$DEFAULT_CHARACTER_SET logical name.................................... 3-10 3.5.2.5 Linking programs with Chinese SMG....... 3-11 3.5.3 Hanzi Text Processing Utility (TPU$) Run-Time Library.......................... 3-11 3.6 Translated Images and Other Related Files..... 3-12 3.7 Operating in a Networked Environment.......... 3-13 4 Problems Corrected 4.1 Correction in Hmail........................... 4-1 4.2 Correction in Chinese Screen Management (SMG$) Run-Time Library.............................. 4-1 4.3 Correction in PCSI Remove Procedure........... 4-1 4.4 Correction in HANZIGEN........................ 4-2 4.5 Correction in Terminal Driver................. 4-2 4.5.1 Read Verify............................... 4-2 4.5.2 Uppercasing............................... 4-2 4.5.3 Control Character......................... 4-2 4.6 Correction in DCL............................. 4-2 4.7 Correction in Sort and Merge.................. 4-3 4.8 Correction in Character Manager............... 4-3 4.8.1 Collating Attribute Database.............. 4-3 4.8.2 Help Message.............................. 4-3 4.9 Correction in Show............................ 4-3 4.10 Compatibility problem with ALLIN1/Hanzi....... 4-4 v 5 Restrictions and Known Problems 5.1 Restriction in HTPU Motif Interface........... 5-1 5.2 Known Problem in HTPU......................... 5-1 Tables 2-1 The Difference of Predefined Output Date and Time Format........................... 2-4 2-2 New HTPU and HEVE logical names........... 2-10 2-3 New HTPU and HEVE system files............ 2-11 3-1 Chinese Run-Time Libraries................ 3-5 vi _________________________________________________________________ Preface This manual describes the features, changes and restrictions of the HP OpenVMS/Hanzi Alpha Version 8.3 operating system. Intended Audience This manual is intended for general users, system managers, developers and programmers who use HP OpenVMS/Hanzi Alpha Version 8.3 (hereafter referred to as HP OpenVMS/Hanzi Alpha). Please read this manual before you install or use HP OpenVMS/Hanzi Alpha Version 8.3. Associated Documents o HP OpenVMS Version 8.3 for Alpha and Integrity Servers Release Notes o DECserver 200 V3.0 Release Notes o DECserver 300 V1.0 Release Notes o DECserver 500 V2.1 Release Notes o DECserver 700 V1.0 Release Notes o DECserver 90L V1.0 Release Notes o DECserver 90TL V1.0 Release Notes o HP OpenVMS Documentation set o HP OpenVMS/Hanzi Documentation set o HP OpenVMS/Hanzi Alpha Version 8.3 Installation Guide o Asian Printing Support for OpenVMS Version 1.0 Release Notes vii o Asian Printing Support for OpenVMS Version 1.0 Installation Guide Document Structure This guide is organized as follows: o Chapter 1 provides an overview of HP OpenVMS/Hanzi Alpha and some information about using HP OpenVMS/Hanzi Alpha. o Chapter 2 describes the changes, new features that affect some commonly used HP OpenVMS/Hanzi Alpha utilities, text processing utilities, and other aspects of the user environment. o Chapter 3 describes the changes, new features and restrictions that affect utilities used for system management, system maintenance, Chinese Run-Time Libraries and the Translated Image Environment. o Chapter 4 describes the problems corrected in this version of OpenVMS/Hanzi Alpha. o Chapter 5 describes the restrictions and known problems in this version of OpenVMS/Hanzi Alpha. Conventions The following conventions are used throughout this manual. The name of the OpenVMS/Hanzi AXP operating system has been changed to OpenVMS/Hanzi Alpha. Any references to OpenVMS/Hanzi AXP or AXP are synonymous with OpenVMS/Hanzi Alpha or Alpha. ___________________________________________________________ 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 . viii ___________________________________________________________ Convention_____________Meaning_____________________________ . Vertical ellipsis in an example . means that information not directly . related to the example has been omitted. UPPERCASE Indicates logical, file and command names. Vx.x Margin notes are used throughout this manual to indicate that the current and following section(s) are applicable starting from HP _______________________OpenVMS/Hanzi_Alpha_Version_x.x.____ ix 1 _________________________________________________________________ Introduction This chapter provides a brief overview of HP OpenVMS/Hanzi Alpha. 1.1 An Overview of HP OpenVMS/Hanzi Alpha V8.3 HP OpenVMS/Hanzi Alpha Version 8.3 is a maintenance of HP OpenVMS/Hanzi to support Chinese processing on Hewlett- Packard's Alpha series computers. In addition to the local features supported by HP OpenVMS/Hanzi Alpha Version 8.2, HP OpenVMS/Hanzi Alpha Version 8.3 provides the new features of OpenVMS Alpha Version 8.3. Refer to the following chapters for detailed descriptions of HP OpenVMS/Hanzi Alpha changes: o Chapter 2 describes the features, and changes that affect areas of the user environment, such as editors, Character Manager, HTPU and HEVE, Hmail, Date/Time Support, Search utility. o Chapter 3 describes the features, restrictions and changes that apply to items used for system management, maintenance, Chinese Run-Time Libraries and the Translated Image Environment. o Chapter 4 describes the problems that have been corrected in this version of OpenVMS/Hanzi Alpha. o Chapter 5 describes the restrictions and known problems in this version of OpenVMS/Hanzi Alpha. Introduction 1-1 Introduction 1.1 An Overview of HP OpenVMS/Hanzi Alpha 1.1.1 Unsupported HP OpenVMS/Hanzi Alpha Feature V1.5 HP OpenVMS/Hanzi Alpha does not support Asynchronous Communication Controllers for On-Demand Loading. 1.2 OpenVMS/Hanzi Alpha Environment 1.2.1 Processor Support HP OpenVMS/Hanzi Alpha Version 8.3 can run on the following Alpha servers: o TURBOChannel Bus Based Systems o DEC 3000 Models 300/300L/300LX/300X o DEC 3000 Models 400/400S o DEC 3000 Models 500/500S/500X o DEC 3000 Models 600/600S o DEC 3000 Models 700/700LX o DEC 3000 Models 800/800S o DEC 3000 Models 900/900LX o XMI Bus Based Systems o AlphaServer 8400 (All chip speeds) o DEC 7000 Model 600 o PCI Bus Based Systems o AlphaServer 300 (All chip speeds) o AlphaServer 800 (All chip speeds) o AlphaServer 1000 (All chip speeds) o AlphaServer 1000A (All chip speeds) o AlphaServer 1200 (All chip speeds) o AlphaServer 2100 (All chip speeds, except 5/375) o AlphaServer 2100A (All chip speeds, except 5/375) o AlphaServer 2100A LP (All chip speeds) o AlphaServer 4000 (All chip speeds) o AlphaServer 4100 (All chip speeds) o AlphaServer 8200 (All chip speeds) 1-2 Introduction Introduction 1.2 OpenVMS/Hanzi Alpha Environment o AlphaServer 8400 (All chip speeds) o AlphaServer DS10, DS10L, DS15 o AlphaServer DS20, DS20E, DS25 o AlphaServer ES40, ES45, ES47, ES80 o AlphaServer GS60, GS60E, GS80, GS140, GS160, GS320, GS1280 o Digital 2100 Server Model A500MP, A600MP o AlphaStation 200 (All chip speeds) o AlphaStation 250 (All chip speeds) o AlphaStation 255/233, 255/300 o AlphaStation 400 (All chip speeds) o AlphaStation 500/266, 500/333, 500/400, 500/500 o AlphaStation 600 (All chip speeds) o AlphaStation 600A (All chip speeds) o Digital Personal Workstation 433au, 500au, 600au o AlphaStation DS15 o AlphaStation DS20e, DS25 o AlphaStation ES40, ES47 o AlphaStation XP900/DS10 o AlphaStation XP1000 o Semiconductor microprocessor development reference boards o Alpha 21064/21064A PCI reference board (EB64+) o Alpha 21164 PCI reference board (EB164) o Alpha PC64 reference board (APC64) HP OpenVMS/Hanzi Alpha Version 7.3-1 is the final version to support the following: o DEC 2000 Models 300/500 o Tadpole ALPHAbook 1 Introduction 1-3 Introduction 1.2 OpenVMS/Hanzi Alpha Environment HP OpenVMS/Hanzi Alpha Version 8.2 is final version to support the following systems: o DSSI Bus-BASED Systems o DEC 4000 Model 600 o DEC 4000 Model 700 o XMI Bus-BASED Systems o DEC 10000 Model 600 o PCI Bus-BASED Systems o AlphaServer 400 o AlphaServer 2000 o Modular Computing Component o Alpha 4/233 PICMG SBC o Alpha 4/266 PICMG SBC o Alpha 5/366 PICMG SBC o Alpha 5/500 PICMG SBC o CompactPCI CS-1000 For details, please refer to HP OpenVMS Version 8.3 for Alpha and Integrity Servers Software Product Description (SPD 82.35.08). 1.2.2 HP OpenVMS Cluster Systems V8.3 HP OpenVMS Cluster configurations are supported in HP OpenVMS/Hanzi Alpha and are fully described in the following documents: o HP OpenVMS Version 8.3 for Alpha and Integrity Servers Software Product Description (SPD 82.35.08) o HP OpenVMS Cluster Software Product Description (SPD 29.78.xx) 1-4 Introduction Introduction 1.2 OpenVMS/Hanzi Alpha Environment 1.2.3 HP COM for OpenVMS V8.3 COM on HP OpenVMS/Hanzi Alpha is fully supported as described in the following documents: o HP OpenVMS Version 8.3 for Alpha and Integrity Servers Software Product Description (SPD 82.35.08) o HP COM for OpenVMS Software Product Description (SPD 70.45.xx). 1.2.4 OpenVMS Galaxy Support V8.3 OpenVMS Galaxy is fully supported under HP OpenVMS/Hanzi Alpha as described in the following documents. o HP OpenVMS Version 8.3 for Alpha and Integrity Servers Software Product Description (SPD 82.35.08) o OpenVMS Alpha Partitioning and Galaxy Guide. 1.2.5 On-Demand Loading Protocol Support V1.5 On-Demand Loading (ODL) protocol is supported for the following DECserver and printer products: o DECserver 200 o DECserver 300 o DECserver 500 o DECserver 700 o DECserver 90L o DECserver 90TL o LATprint ThinWire Ethernet Interface In order to perform On-Demand Loading of Chinese terminals and printers connected via server ports, make sure that you have installed the correct DECserver software, and have downline loaded the server software to the DECserver unit. 1.2.6 Printer Support Introduction 1-5 Introduction 1.2 OpenVMS/Hanzi Alpha Environment 1.2.6.1 Line/Text printer with Chinese character support V1.5 HP OpenVMS/Hanzi Alpha supports the LA88-C and LA380- C Chinese printers. On-Demand Loading of user-defined characters is supported on LA88-C and LA380-C Chinese printers connected to terminal servers listed in Section 1.2.5. 1.2.6.2 PostScript printer with Chinese character support There are two ways to support PostScript printing. These are described in the following paragraphs. V6.1 HP OpenVMS/Hanzi Alpha supports the following printers for high quality Chinese printing with the installation of Asian Printing Support for OpenVMS and DECprint Supervisor for OpenVMS (DCPS). Please refer to Asian Printing Support for OpenVMS Version 1.0 Release Notes for details. o DEClaser 1152 o DEClaser 5100 o PrintServer 17/600 V7.2 HP OpenVMS/Hanzi Alpha can also use all PostScript printers supported by DCPS Version 2.4 or higher with World-Wide PostScript Printing Subsystem to provide high quality Chinese printing service. 1.2.7 Terminal Support V1.5 HP OpenVMS/Hanzi Alpha supports the VT382-CB Chinese terminal. On-Demand Loading of user-defined characters is supported only on a VT382-CB Chinese terminal connected to terminal servers listed in Section 1.2.5. 1.3 OpenVMS/Hanzi Alpha Installation This guide contains brief installation procedures for the HP OpenVMS/Hanzi Alpha Version 8.3 operating system. For complete instructions on installing or upgrading the HP OpenVMS/Hanzi Alpha operating system, refer to the HP OpenVMS/Hanzi Alpha Version 8.3 Installation Guide which contains installation and operation information on AlphaServer computer families. V6.2 Starting from Version 6.2, HP OpenVMS/Hanzi Alpha will be installed using PCSI but not VMSINSTAL procedure. 1-6 Introduction Introduction 1.3 OpenVMS/Hanzi Alpha Installation 1.3.1 Installation Procedure V8.3 HP OpenVMS/Hanzi Alpha Version 8.3 requires HP OpenVMS Alpha Version 8.3 as the prerequisite software. Follow the steps below to install HP OpenVMS/Hanzi Alpha Version 8.3: 1. Prepare an HP OpenVMS Alpha Version 8.3 operating system. 2. Install the Chinese locale from the DEC-AXPVMS-VMSI18N- V0803--1.PCSI kit. If you are planning to use PostScript printers for printing, you are recommended to install the DECprint Supervisor for OpenVMS (DCPS) Version 2.4 or higher . 3. Use PCSI to install HP OpenVMS/Hanzi Alpha Version 8.3. Please refer to the HP OpenVMS/Hanzi Alpha Version 8.3 Installation Guide for details on installing the HP OpenVMS/Hanzi Alpha Version 8.3. On the media containing the HP OpenVMS/Hanzi Alpha Version 8.3 kit, there is a mup kit for HP OpenVMS/Hanzi Alpha Version 6.2 called AXPHZ062_MUP1. If you are upgrading from HP OpenVMS/Hanzi Alpha Version 6.2, you must install this mup kit before proceeding with any HP OpenVMS/Hanzi Alpha upgrade procedure. This mup kit has to be installed using PCSI. Please refer to the HP OpenVMS/Hanzi Alpha Version 8.3 Installation Guide for details. Also on the media containing the HP OpenVMS/Hanzi Alpha Version 8.3 kit, there is a sub-kit called ASPS010. It is used to install Asian Printing Support for OpenVMS Version 1.0. For details on the installation, please refer to Asian Printing Support for OpenVMS Version 1.0 Installation Guide. Introduction 1-7 2 _________________________________________________________________ General Release Notes This chapter contains information that is of interest to all users of the HP OpenVMS/Hanzi Alpha operating system. It includes information about commonly used utilities and text processing utilities. This chapter describes changes that affect the following areas of HP OpenVMS/Hanzi Alpha: o Asian Printing Support o Character Manager (CMGR) o Chinese Date and Time Support o Editors o Hmail utility o HTPU and HEVE o Search utility 2.1 Asian Printing Support V6.1 High quality Chinese printing for OpenVMS is provided by installing the Asian Printing Support sub-kit called ASPS010. It allows users to print Chinese text files and Chinese PostScript files with PostScript printers. For details on 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 ________________________ Chinese printing is only supported with the installation of DECprint Supervisor for OpenVMS (DCPS) Version 2.4 or higher. ______________________________________________________ General Release Notes 2-1 General Release Notes 2.2 Character Manager (CMGR) 2.2 Character Manager (CMGR) V1.5 Character Manager (CMGR) Version 2.0 is an integrated software component which is shipped with OpenVMS/Hanzi Alpha since Version 1.5. It is used to manage the attributes of Chinese characters, mainly the User-Defined Character of the DEC Hanzi Character Set. The attributes which users can manipulate include the font and collating characteristics. Character Manager allows users to create user-defined fonts and user-defined collating sequences, to manipulate the System Attribute Database, and to create user attribute listings such as font table or font bitmap listing for reference. CMGR Version 2.0 supports fonts of sizes 24x24, 32x32 and 40x40. It also supports more than one database, the CMGR_ DEFAULT database, the SONG database and the HEI database. Character Manager (CMGR) is invoked by the following DCL command: $ CHARACTER_MANAGER CMGR> or $ CHARACTER_MANAGER COPY FDCC F245 (This command invokes the CMGR and executes the COPY subcommand.) Users are recommended to define a foreign command like: $ CMGR == "$HSY$SYSTEM:CMGR" so that Character Manager can be simply invoked by: $ CMGR CMGR> 2-2 General Release Notes General Release Notes 2.2 Character Manager (CMGR) 2.2.1 Font Database Migration Users can migrate their existing font database on OpenVMS/Hanzi VAX to HP OpenVMS/Hanzi Alpha as follows: o OpenVMS/Hanzi VAX Version 5.5 or post-Version 5.5 users can use their existing CMGR database on HP OpenVMS/Hanzi Alpha. They should simply copy the following files under HSY$SYSTEM to the same directory on HP OpenVMS/Hanzi Alpha: HSY$SORTDB.CDB HSY$GLYPH_24X24_USER.GDB HSY$GLYPH_32X32_USER.GDB HSY$GLYPH_40X40_USER.GDB HSY$SONG_SORTDB.CDB HSY$SONG_24X24_USER.GDB HSY$SONG_32X32_USER.GDB HSY$SONG_40X40_USER.GDB HSY$HEI_SORTDB.CDB HSY$HEI_24X24_USER.GDB HSY$HEI_32X32_USER.GDB HSY$HEI_40X40_USER.GDB o OpenVMS/Hanzi VAX pre-Version 5.5 users must migrate from Font System to CMGR since there is no Font System on HP OpenVMS/Hanzi Alpha. Users should copy HSY$SYSTEM:FONT1.DAT (old font database) to the same directory on HP OpenVMS/Hanzi Alpha, and execute the CONVERT DATABASE command of CMGR. This will read the fonts defined in the old Font System, convert to CMGR format, and store in the current CMGR database (The current database is set by the SET DATABASE command). For details about migration from Font System to CMGR, please refer to Chapter 3 of Character Manager (CMGR) User's Guide. It is important to note that users should copy their database from OpenVMS/Hanzi VAX to HP OpenVMS/Hanzi Alpha only after the installation of HP OpenVMS/Hanzi Alpha. It is also important to note that the database should be copied to Alpha with the same file protection as on VAX. For details about the Character Manager, please refer to Character Manager (CMGR) User's Guide. General Release Notes 2-3 General Release Notes 2.2 Character Manager (CMGR) Please note that the Font Editor of Character Manager V2.0 only supports VT382 terminal and Hanzi DECterm. 2.3 Chinese Date and Time Support V6.1 The logical names of predefined Chinese date and time format have been changed, as follows: Table 2-1 The Difference of Predefined Output Date and Time __________Format___________________________________________ New logical (since ___________V6.1)__________________Old_logical_(in_V1.5)____ Predefined LIB$DATE_FORMAT_042 LIB$DATE_FORMAT_501 output date format LIB$DATE_FORMAT_043 LIB$DATE_FORMAT_502 Predefined LIB$TIME_FORMAT_021 LIB$TIME_FORMAT_501 output time format_____________________________________________________ 2.4 Editors V1.5 The default editor for the EDIT command has been changed to HTPU from TPU. Therefore, when you enter the EDIT command, HTPU is invoked rather than the TPU editor. The EDIT command now invokes HTPU with the HEVE section file. For details, see HTPU and HEVE Version 3.1 notes. V6.2 ________________________ Note ________________________ The HEDT editor is still included as part of the OpenVMS/Hanzi Alpha operating system. Starting from version 6.2, HEDT is an Alpha native image, instead of translated image. ______________________________________________________ 2-4 General Release Notes General Release Notes 2.5 Hmail Utility 2.5 Hmail Utility V1.5 The default editor for the Hmail utility has been changed to HTPU from HEDT. Therefore, when you enter the EDIT command in the Hmail utility, the Hanzi Extensible Versatile Editor (HEVE) is invoked rather than the HEDT editor. For more information about this change, refer to OpenVMS/Hanzi User Guide for information about selecting an editor. V7.1 Hmail supports the following new features: o Signature File o /PAGE qualifier o /NEXT qualifier These new features are identical to those that are in the OpenVMS Mail utility. For a detailed description of these features, please refer to the OpenVMS Version 7.0 New Features Manual. 2.6 HTPU and HEVE Version 3.1 Notes V1.5 HTPU is an enhancement of DECTPU Version 3.1 to support Chinese text processing, which includes built-in procedures and callable interfaces, for OpenVMS applications. HEVE is a full-screen editor developed with HTPU to support Chinese text editing on the HP OpenVMS/Hanzi Alpha operating system. See HEVE User Guide for more information on using HEVE. 2.6.1 Invoking HTPU from DCL prompt HTPU is invoked with the following command: $ EDIT/HTPU or simply $ EDIT HTPU is now the default editor on OpenVMS/Hanzi. General Release Notes 2-5 General Release Notes 2.6 HTPU and HEVE Version 3.1 Notes 2.6.2 HTPU and HEVE now support DECwindows Motif /Hanzi Environment You can now start up HTPU using DECwindows Motif /Hanzi V1.1 or higher, as follows: $ SET DISPLAY/CREATE/NODE= $ EDIT/HTPU/INTERFACE=DECWINDOWS In this case, HEVE will start up its own DECwindows Motif /Hanzi interface and select the language of its pull down and pop up menus according to the current setting of DECwindows Motif /Hanzi. 2.6.2.1 Chinese input method handling You can start the Chinese input method in HTPU DECwindows Motif /Hanzi interface by pressing on LK201 keyboard or on LK401 keyboard. After starting up the input method, it behaves the same as that in your terminal. One exception is that if you want to terminate the input method, you have to use the same sequence that you use to start it up. During your editing session, the input method process of DECwindows may be terminated. In this case, simply restarting the process does not make HTPU use the Chinese input method. You also need to reset the input method handling of HTPU. HEVE provides a menu item "Reset Input Method" under the "Option" menu. You can use this command to reset the input method of HTPU. 2.6.3 HTPU now supports buffer change journaling HTPU is now enhanced to support buffer change journaling. Buffer change journaling is the default journaling mechanism of HTPU, and is enabled by default. The journal file is located in the directory pointed to by HTPU$JOURNAL. By default, HTPU$JOURNAL is defined as SYS$SCRATCH which is pointing to your login directory. The journal file naming algorithm follows that of DECTPU. 2-6 General Release Notes General Release Notes 2.6 HTPU and HEVE Version 3.1 Notes 2.6.4 New HTPU built-in procedures 2.6.4.1 GET_INFO (SCREEN, "display_cursor") The built-in returns the current state of the display- cursor mode of HTPU. The syntax is as follows: {ON | OFF} := GET_INFO (SCREEN, "display_cursor") 2.6.4.2 GET_INFO (window-var, "character_index") This built-in returns the distance between the internal cursor position of HTPU and the position of the screen cursor. This is useful when display-cursor mode is turned ON so that you can determine if the internal cursor and screen cursor are at the screen position. The syntax is as follows: integer := GET_INFO (window-variable, "character_index") 2.6.4.3 JUSTIFY JUSTIFY reformats the text in the specified buffer or range so that the lines of the text can be indented to either left margin, right margin or both. The syntax of the built-in is as follows: JUSTIFY ({buffer, range} [,keyword [,left_margin [,right_margin [,first_line_indent]]]]) You can specify the following values to the keyword parameter: JUSTIFY_LEFT JUSTIFY_RIGHT JUSTIFY_BOTH JUSTIFY first calls the FILL built-in, and then inserts spaces into the lines of the buffer or range to achieve the requested indentation. 2.6.4.4 SET (DISPLAY_CURSOR) HTPU now supports display-cursor mode. You can turn ON or OFF the display-cursor mode using this built-in. The syntax is as follows: General Release Notes 2-7 General Release Notes 2.6 HTPU and HEVE Version 3.1 Notes SET (DISPLAY_CURSOR, {ON, OFF}) When display-cursor mode is ON, the screen cursor is always on the first byte of any character. If display-cursor mode is OFF, HTPU behaves the same as in the previous version. 2.6.5 Newly modified HTPU built-in procedures 2.6.5.1 SEARCH The SEARCH built-in now separates form-size sensitivity and case sensitivity. You can specify the following values, or their combination, to the integer parameter of the SEARCH built-in: TPU$K_SEARCH_CASE TPU$K_SEARCH_FORM TPU$K_SEARCH_CASE and TPU$K_SEARCH_FORM turn on case and form-size sensitivities of search respectively. They can be combined by adding them together. ________________________ Note ________________________ Note that HTPU does not support TPU$K_SEARCH_ DIACRITICAL. ______________________________________________________ 2.6.5.2 SET (TEXT) The SET (TEXT) built-in procedure can now set the text resource of CSText widget to support Chinese characters. 2.6.6 New HEVE commands 2.6.6.1 DRAW BOX You can now directly start up DRAW BOX mode of HEVE using the DRAW BOX command instead of entering indirectly from the DRAW LINE mode. 2.6.6.2 FULLFORM WORD This command changes all 1-byte ASCII characters in the current word or highlighted text to fullform characters. 2-8 General Release Notes General Release Notes 2.6 HTPU and HEVE Version 3.1 Notes 2.6.6.3 HALFFORM WORD This command changes all fullform characters in the current word or highlighted text to halfform characters (that is ASCII letters). 2.6.6.4 LEFT ADJUST This command shifts the lines of your selected text to align with the left margin of the current buffer by trimming off the leading spaces of the lines. 2.6.6.5 LEFT INDENT This command reformats the currently selected range so that maximum number of words fit on a line starting from the starting column of the range, and ending on the right margin of the buffer. 2.6.6.6 RIGHT ADJUST This command shifts the lines of your selected text to align with the right margin of the current buffer by inserting spaces at the start of lines. 2.6.6.7 RIGHT INDENT This command reformats the currently selected range so that maximum number of words fit on a line starting from the starting column of the range, and ending on the right margin of the buffer. It makes sure the lines all end on the right margin of the buffer by inserting spaces into the lines. 2.6.6.8 SET [NO]DISPLAY CURSOR This command set ON or OFF the display-cursor mode of HTPU. With the display-cursor mode turned ON, the problem of continual left shifting of screen cursor when the cursor is being moved up and down in your text buffer is fixed. The display-cursor mode is turned ON by HEVE by default. General Release Notes 2-9 General Release Notes 2.6 HTPU and HEVE Version 3.1 Notes 2.6.6.9 SET FIND commands You can now separately select form-size and case sensitivities during the FIND operation of HEVE. The two sensitivities are turned on or off using the following commands: o SET FIND FORM [NO]EXACT - Turns ON or OFF form-size sensitivity o SET FIND CASE [NO]EXACT - Turns ON or OFF case sensitivity o SET FIND EXACT - Turns ON both form-size and case sensitivities o SET FIND GENERAL - Turns OFF both form-size and case sensitivities 2.6.6.10 SET KEYPAD HEDT This command sets the keys of HEDT. You can refer to the documentation on the EDT keypads for more information since all keys defined in the EDT keypads are defined within the HEDT keypad. 2.6.7 New logical names The following table shows the new logical names used in HTPU and HEVE. Table_2-2_New_HTPU_and_HEVE_logical_names__________________ New_logical_name______Description__________________________ HEVE$KEYPAD___________Keypad_logical_of_HEVE_______________ 2.6.8 New files in HTPU and HEVE The following table shows the new system files of HTPU and HEVE. 2-10 General Release Notes General Release Notes 2.6 HTPU and HEVE Version 3.1 Notes Table_2-3_New_HTPU_and_HEVE_system_files___________________ File_name_____________Description__________________________ HTPU.DAT HTPU default resource file for DECwindows Motif interface HEVE.DAT HEVE default resource file for ______________________DECwindows_Motif_interface___________ 2.6.9 HTPU and HEVE Restrictions The following lists out the restrictions of HTPU and HEVE Version 3.1 with respect to DECTPU and EVE Version 3.1: o MCS characters are not supported. o /CHARACTER_SET qualifier ignored. 2.7 Search Utility V1.5 The Search utility of HP OpenVMS/Hanzi Alpha supports Chinese character searching. Users can enter a combination of Chinese characters and ASCII characters in the search string. 2.8 World-Wide PostScript Printing Subsystem V7.3 The World-Wide PostScript Printing Subsystem (WWPPS) is bundled into OpenVMS starting with Version 7.3. The new release of WWPPS supports more character sets in addition to the existing capabilities. To invoke the utility, you can use the following command in response to the DCL prompt: $ RUN SYS$SYSTEM:WWPPS The utility responds with the following prompt: $ WWPPS> Also, you can abbreviate the invocation by defining a foreign command as follows: $ WWPPS :== $SYS$SYSTEM:WWPPS General Release Notes 2-11 General Release Notes 2.8 World-Wide PostScript Printing Subsystem For details on the features of WWPPS, please refer to OpenVMS User's Manual. ________________________ Note ________________________ The GB18030 Character Set is supported by WWPPS. ______________________________________________________ 2.8.1 Restriction Embedding font data in PostScript files may increase the size of the file beyond printer memory support. If this happens, the WWPPS appends an error page to the end of printed output to notify the user that the file size exceeded printer capacity. 2-12 General Release Notes 3 _________________________________________________________________ Programming and System Management Release Notes This chapter provides release notes about system management, maintenance, writing programs for Chinese processing and the Translated Image Environment. 3.1 DECwindows Motif/Hanzi 3.1.1 DECwindows Motif/Hanzi Version 1.6 for HP OpenVMS V8.3 Hewlett-Packard offers a new DECwindows Motif/Hanzi Version 1.6 for customers who desire a DECwindows environment. DECwindows Motif support is provided by OpenVMS/Hanzi in conjunction with DECwindows Motif/Hanzi. For details, please refer to DECwindows Motif/Hanzi V1.6 Release Notes. ________________________ Note ________________________ DECwindows Motif/Hanzi Version 1.6 allows users to input and display Chinese characters based on GB18030 code set using its utilities. ______________________________________________________ 3.1.2 Chinese Character Fonts for DECwindows Motif/Hanzi The kit of HP OpenVMS/Hanzi Alpha contains Chinese character font files for DECwindows Motif/Hanzi. If you are planning to install DECwindows Motif/Hanzi on your system in the future, it is recommended that you install these font files during the installation of HP OpenVMS/Hanzi Alpha. Users are recommended to install HP OpenVMS/Hanzi Alpha before installing DECwindows Motif/Hanzi. See HP OpenVMS/Hanzi Alpha Version 8.3 Installation Guide for details. Programming and System Management Release Notes 3-1 Programming and System Management Release Notes 3.2 Debugger 3.2 Debugger V7.1 The OpenVMS Debugger is a symbolic debugger. It is the preferred debugger for debugging user-mode code. It supports the symbolic debugging of all OpenVMS programming languages via either a character cell user interface or a graphic (DECwindows Motif) user interface. Both user interfaces now support the DEC Hanzi Character Set for input and display. Chinese characters in program variables, source code comments or OpenVMS Debugger error messages are displayed correctly. ________________________ Note ________________________ The DEC Hanzi Character Set support in the OpenVMS Debugger is implemented with the XPG4 internationalization model. This requires an XPG4 locale database for the DEC Hanzi Character Set. This locale database can be found in the DEC-AXPVMS- VMSI18N-V0803--1.PCSI saveset that is shipped with HP OpenVMS Alpha Version 8.3. This saveset must be installed separately using VMSINSTAL procedure. ______________________________________________________ 3.2.1 User Environment Setup 3.2.1.1 Character Cell User Interface The character cell user interface of the OpenVMS Debugger uses Chinese SMG together with DEC C's XPG4 localization utilities to support the DEC Hanzi Character Set. The following logical names must be defined to enable this support: o DBG$SMGSHR This logical name defines the name of the SMG shareable image that the OpenVMS Debugger uses to support screen mode. To enable support for the DEC Hanzi Character Set, define this logical name as follows: $ DEFINE/JOB DBG$SMGSHR HSMGSHR o SMG$DEFAULT_CHARACTER_SET 3-2 Programming and System Management Release Notes Programming and System Management Release Notes 3.2 Debugger This logical name defines the default character set that Chinese SMG supports. To enable support for the DEC Hanzi Character Set, define this logical name as follows: $ DEFINE/JOB SMG$DEFAULT_CHARACTER_SET HANZI o LANG This logical name defines the default locale settings for all the locale categories of DEC C's XPG4 localization utilities and run time library. To enable DEC Hanzi Character Set support in the OpenVMS Debugger, define this logical name as follows: $ DEFINE/JOB LANG ZH_CN_DECHANZI 3.2.1.2 DECwindows Motif User Interface The DECwindows Motif user interface of the OpenVMS Debugger can display characters in the DEC Hanzi Character Set. The debugger's resource file, VMSDEBUG.DAT, found in the directory DECW$SYSTEM_DEFAULT or DECW$USER_DEFAULTS, can explicitly specify fonts for each of the debugger's windows. In VMSDEBUG.DAT, the DebugDefault.font resource specifies a default font for all of the debugger's windows. Each window can also use a font that is different from this default. For details please refer to the VMSDEBUG.DAT file. To enable DEC Hanzi Character Set support in an OpenVMS Debugger window, the window must use a DEC Hanzi Character Set font. The font is specified in one of the following ways: 1. Explicitly specified by the resource for the debugger window; 2. Specified by the debugger's default font resource DebugDefault.font, when a font is not explicitly specified as above; 3. Specified by the system default font resource, when neither the debugger's default font resource nor the debugger window's font resource specify a font. Programming and System Management Release Notes 3-3 Programming and System Management Release Notes 3.2 Debugger 3.2.2 EXAMINE Command The EXAMINE command supports a new qualifier /WCHAR_ T:n. This command interprets and displays each examined entity as a multi-byte file code sequence of n longwords (n characters). The default value for n is 1. When converting the examined string, the OpenVMS Debugger uses the locale database of the process in which the debugger runs. The default is C locale. 3.2.3 DEPOSIT Command The DEPOSIT command supports a new qualifier /WCHAR_T:n. This command deposits up to n longwords of a converted multi-byte file code sequence into the specified location. The default value for n is 1. When converting the string that is specified with the DEPOSIT command, the OpenVMS Debugger uses the locale database of the process in which the debugger runs. The default is C locale. 3.3 License Management Facility (LMF) V1.5 Product Authorization Keys (PAKs) are available for HP OpenVMS/Hanzi Alpha. Availability PAKs for the VAX system (availability PAKs without the ALPHA option) will not load on the Alpha system. Only those availability PAKs containing the ALPHA option will load on the Alpha system. 3.4 Terminal I/O V1.5 The terminal I/O subsystem currently supports line editing on character basis (multi-byte line editing) including: o Delete o Insert o Overstrike o Cursor movement o Automatic line wrapping 3-4 Programming and System Management Release Notes Programming and System Management Release Notes 3.4 Terminal I/O 3.4.1 Supplied Device Drivers V6.2 The names of all device drivers supplied on HP OpenVMS/Hanzi Alpha are changed as shown in the following table. ___________________________________________________________ On_OpenVMS/Hanzi_VAX_______On_HP_OpenVMS/Hanzi_Alpha_______ ASDRIVER.EXE HSY$ASDRIVER.EXE FHDRIVER.EXE_______________HSY$FHDRIVER.EXE________________ 3.5 Run-Time Libraries for Chinese Processing V1.5 All Run-Time Libraries for Chinese processing that are available in OpenVMS/Hanzi Alpha and VAX are available in this version of HP OpenVMS/Hanzi Alpha. The Run-Time Libraries for Chinese processing listed in the following table are included in this version of HP OpenVMS/Hanzi Alpha: Table_3-1_Chinese_Run-Time_Libraries_______________________ HSYSHR Chinese Processing (HSY$) Run-Time Library HSMGSHR Chinese Screen Management (SMG$) Run-Time Library HTPUSHR HTPU callable interface library SORTSHR Chinese processing capability of the Sort/Merge ____________callable_interface_library_____________________ 3.5.1 Chinese Processing (HSY$) Run-Time Library V1.5 The HSY$ facility of OpenVMS/Hanzi Run-Time Library is the new name for the Multi-Byte Processing Run-Time Library HSYSHR, and is referenced as HSYSHR in short. In this version of HSYSHR, a new set of routines prefixed with HSY$ has been added. These routines are functionally equivalent to the corresponding routines prefixed with JSY$ and JLB$. o All routines prefixed with JSY$ will have their equivalent routines with the JSY$ prefix replaced by HSY$ (e.g. HSY$CH_NEXT is functionally equivalent to JSY$CH_NEXT). Programming and System Management Release Notes 3-5 Programming and System Management Release Notes 3.5 Run-Time Libraries for Chinese Processing o All routines prefixed with JLB$ will have their equivalent routines with the JLB$ prefix replaced by HSY$DX_ (e.g. HSY$DX_TRA_SYMBOL is functionally equivalent to JLB$TRA_SYMBOL). The original JSY$ and JLB$ routines are still provided in HSYSHR, but users are encouraged to use the new set of routines for the same functions provided in the JSY$ and JLB$ routines. For detailed information on HSYSHR, please refer to the new OpenVMS/Hanzi RTL Chinese Processing (HSY$) Manual which supersedes the Introduction to Multi-Byte Processing Run Time Library HSYSHR manual. The new manual only describes routines prefixed with HSY$. For information about the routines prefixed with JSY$ or JLB$, please see the routine descriptions of their equivalent HSY$ routines. 3.5.2 Chinese Screen Management (SMG$) Run-Time Library V1.5 Chinese Screen Management (Chinese SMG) is the localized version of HP OpenVMS Alpha Screen Management Facility to handle Chinese characters. It supports all features released in Chinese SMG on OpenVMS/Hanzi VAX Version 5.4-2. In addition, it supports some new features. 3.5.2.1 New features New routines are supported as follows: o Viewport routines o SMG$CHANGE_VIEWPORT o SMG$CREATE_VIEWPORT o SMG$DELETE_VIEWPORT o SMG$GET_VIEWPORT_CHAR o SMG$SCROLL_VIEWPORT o Menu routines o SMG$CREATE_MENU o SMG$DELETE_MENU o SMG$SELECT_FROM_MENU 3-6 Programming and System Management Release Notes Programming and System Management Release Notes 3.5 Run-Time Libraries for Chinese Processing o Line drawing/erasing routines o SMG$DRAW_CHAR o SMG$DRAW_LINE o SMG$DRAW_RECTANGLE o SMG$REMOVE_LINE o Wide/Highwide routines o SMG$PUT_CHARS_HIGHWIDE o SMG$PUT_CHARS_WIDE o SMG$PUT_LINE_HIGHWIDE o SMG$PUT_LINE_WIDE o Display update batching routines o SMG$BEGIN_DISPLAY_UPDATE o SMG$END_DISPLAY_UPDATE o Pasteboard update batching routines o SMG$BEGIN_PASTEBOARD_UPDATE o SMG$END_PASTEBOARD_UPDATE o Miscellaneous routines o SMG$CHANGE_RENDITION o SMG$COPY_VIRTUAL_DISPLAY o SMG$ERASE_COLUMN o SMG$GET_CHAR_AT_PHYSICAL_CURSOR o SMG$INVALIDATE_DISPLAY o SMG$LIST_PASTEBOARD_ORDER o SMG$LOAD_VIRTUAL_DISPLAY o SMG$PUT_CHARS_MULTI o SMG$PUT_HELP_TEXT o SMG$PUT_LINE_MULTI o SMG$PUT_STATUS_LINE o SMG$REPAINT_SCREEN Programming and System Management Release Notes 3-7 Programming and System Management Release Notes 3.5 Run-Time Libraries for Chinese Processing o SMG$REPLACE_INPUT_LINE o SMG$RESTORE_PHYSICAL_SCREEN o SMG$RETURN_INPUT_LINE o SMG$SAVE_PHYSICAL_SCREEN o SMG$SAVE_VIRTUAL_DISPLAY o SMG$SCROLL_DISPLAY_AREA o SMG$SET_DISPLAY_SCROLLING_REGION For details of the features supported by Chinese SMG, please refer to OpenVMS/Hanzi RTL Chinese Screen Management (SMG$) Manual. ________________________ Note ________________________ Not all SMG routines of OpenVMS are supported in Chinese SMG. Refer to the reference manual for a list of supported routines. ______________________________________________________ 3.5.2.2 Character Set Parameter In order to process Chinese characters with Chinese SMG, programs will have to specify the character set parameter in any SMG routine call. The supported character set values are: ___________________________________________________________ Value_________________Character_Set________________________ SMG$C_ASCII ASCII SMG$C_SPEC_GRAPHICS DEC Special Graphics SMG$C_HANZI___________DEC_Hanzi____________________________ These literals are defined in the STARLET library of the system. 3-8 Programming and System Management Release Notes Programming and System Management Release Notes 3.5 Run-Time Libraries for Chinese Processing 3.5.2.3 Changed Routine Interface All Chinese SMG routines have the same name and accept the same parameters as the corresponding SMG routines of HP OpenVMS Alpha with the following exceptions: o SMG$DELETE_CHARS The number-of-characters parameter is changed to number-of-columns to denote the number of columns to be deleted. o SMG$ERASE_CHARS The number-of-characters parameter is changed to number- of-columns to denote the number of columns to be erased. o SMG$GET_CHAR_AT_PHYSICAL_CURSOR The character-code parameter is renamed to byte- code to receive the character's ASCII code of the cursor position. Two new parameters, character- code and character-set, are added to the end of the parameter list. The character-code parameter receives the character which the physical cursor is on. The character-set parameter receives the character set for the current physical cursor position. o SMG$PUT_HELP_TEXT The character-set parameter is added to the end of the parameter list to specify the character set to be used when writing out the help text. The help topic string pointed to by the help-topic parameter must be composed of ASCII characters. If the help topic is not composed of ASCII characters, the help-topic parameter is ignored and the help facility is just invoked. o SMG$PUT_STATUS_LINE The character-set parameter is added to the end of the parameter list to specify the character set to be used when writing out the text to the hardware status line. o SMG$READ_COMPOSED_LINE The character-set parameter is added to the end of the parameter list to specify the character set of the characters to be read. o SMG$READ_FROM_DISPLAY Programming and System Management Release Notes 3-9 Programming and System Management Release Notes 3.5 Run-Time Libraries for Chinese Processing The character-set-string parameter is added to the end of the parameter list to show the corresponding character set for the respective bytes in the text string in the display. o SMG$READ_STRING The character-set parameter is added to the end of the parameter list to specify the character set of the characters to be read. o SMG$REPLACE_INPUT_LINE The character-set parameter is added to the end of the parameter list to specify the character set of the replace-string. If this parameter is omitted, the default character set value is SMG$C_UNKNOWN. o SMG$RETURN_INPUT_LINE The character-set parameter is added to the end of the parameter list to receive the character set of the requested line from the recall buffer. If the character set is undefined, it receives SMG$C_UNKNOWN. 3.5.2.4 SMG$DEFAULT_CHARACTER_SET logical name This is a new feature introduced by Chinese SMG. Chinese SMG uses the SMG$DEFAULT_CHARACTER_SET logical name to define the default character set. Valid values for the SMG$DEFAULT_CHARACTER_SET logical name are as follows: ___________________________________________________________ Value_________________Character_Set________________________ ASCII ASCII SPEC_GRAPHICS DEC Special Graphics HANZI_________________DEC_Hanzi____________________________ If an invalid character set name is assigned to the SMG$DEFAULT_CHARACTER_SET logical name, or if the logical name is not defined, the default character set name is UNKNOWN. Three routines will use the SMG$DEFAULT_CHARACTER_SET logical name to define the default character set when it is not specified explicitly. They are listed as follows: o SMG$CREATE_VIRTUAL_DISPLAY 3-10 Programming and System Management Release Notes Programming and System Management Release Notes 3.5 Run-Time Libraries for Chinese Processing o SMG$READ_COMPOSED_LINE o SMG$READ_STRING For SMG$CREATE_VIRTUAL_DISPLAY, it uses SMG$DEFAULT_ CHARACTER_SET to define the default character set without character-set argument specification. For SMG$READ_COMPOSED_LINE and SMG$READ_STRING, the character-set argument is the character set of characters to be input. If it is not specified, the default character set of the specified display-id is used. If no display- id is specified, SMG$DEFAULT_CHARACTER_SET is used. If SMG$DEFAULT_CHARACTER_SET logical is not defined, the default character set is UNKNOWN. 3.5.2.5 Linking programs with Chinese SMG In order to make use of the features provided by Chinese SMG, programs must be linked with the Chinese SMG shareable image HSMGSHR.EXE in SYS$SHARE. This is illustrated in the following example: $ LINK myprog.obj,SYS$INPUT/OPT SYS$SHARE:HSMGSHR.EXE/SHARE $ or use an option file: $ CREATE hsmgshropt.opt SYS$SHARE:HSMGSHR.EXE/SHARE $ LINK myprog.obj,hsmgshropt.opt/OPT $ 3.5.3 Hanzi Text Processing Utility (TPU$) Run-Time Library V1.5 HTPU now provides a callable interface for using HTPU editing capabilities from within user-written programs. It supports the same simplified and full callable interfaces of DECTPU. To use the HTPU callable interface, you should link SYS$SHARE:HTPUSHR.EXE with your program. Please refer to OpenVMS/Hanzi User Guide for an example of using HTPU callable interface. For details of the DECTPU callable interfaces, see Chapter 14 of OpenVMS Callable Utilities Reference Manual. Programming and System Management Release Notes 3-11 Programming and System Management Release Notes 3.6 Translated Images and Other Related Files 3.6 Translated Images and Other Related Files V1.5 HP OpenVMS/Hanzi Alpha provides translated image support, which allows any translated image to run on the Translated Image Environment (TIE). OpenVMS/Hanzi VAX applications translated by the VAX Environment Software Translator (VEST) can run on the HP OpenVMS/Hanzi Alpha operating system. V6.2 In order to facilitate the translation of applications in OpenVMS/Hanzi VAX, the following Image Information Files (IIF) are provided, and the system logicals are defined in the HP OpenVMS/Hanzi Alpha operating system: o Image Information File (IIF) in SYS$LIBRARY HEDTSHR.IIF HSYSHR.IIF HSORTSHR.IIF HTPUSHR.IIF HSMGSHR.IIF o System logicals HEDTSHR_TV=HEDTSHR HSMGSHR_TV=HSMGSHR HSYSHR_TV=HSYSHR HTPUSHR_TV=HTPUSHR HSORTSHR_TV=SORTSHR ________________________ Note ________________________ HEDT and HEDTSHR are native Alpha images since HP OpenVMS/Hanzi Alpha Version 6.2. ______________________________________________________ For more information on translating VAX images, refer to the DECmigrate for OpenVMS Alpha manual called DECmigrate for OpenVMS AXP Systems Translating Images. 3-12 Programming and System Management Release Notes Programming and System Management Release Notes 3.7 Operating in a Networked Environment 3.7 Operating in a Networked Environment V1.5 In a networked environment where OpenVMS systems are linked by DECnet, a user can connect from the local system to a remote system using the SET HOST command. In such an environment, the user's terminal will hang (i.e. it appears to stop responding to any user action) in the following situation: 1. The user logs in to a local terminal on a system running OpenVMS VAX or OpenVMS/Hanzi VAX Version 5.5 or higher, or any OpenVMS Alpha or OpenVMS/Hanzi Alpha versions; 2. The user uses the SET HOST command to connect to a remote session on a system running a version of OpenVMS/Hanzi VAX that is lower than Version 5.5; 3. On the remote session, the user invokes the HANZIGEN utility and sets the terminal's input type to HANZI, as follows: $ RUN HSY$SYSTEM:HANZIGEN HANZIGEN> SET/INPUT=HANZI An ECO kit, called AVMS_RTPAD_ECO032033000, is available to fix this problem. This kit is shipped with the HP OpenVMS/Hanzi Alpha Version 8.3. Please contact HP's Customer Services if you cannot find the ECO kit on the HP OpenVMS/Hanzi Alpha Version 8.3 distribution media. ________________________ Note ________________________ The ECO kit should only be installed on systems running any version of OpenVMS/Hanzi VAX that is lower than Version 5.5. ______________________________________________________ Use the following DCL command to install the ECO kit: $ @SYS$UPDATE:VMSINSTAL AVMS_RTPAD_ECO032033000 source-device where : AVMS_RTPAD_ refers to the kit. ECO032033000 Programming and System Management Release Notes 3-13 Programming and System Management Release Notes 3.7 Operating in a Networked Environment source-device is the device on which the kit's distribution media is mounted. 3-14 Programming and System Management Release Notes 4 _________________________________________________________________ Problems Corrected This chapter provides information on the problems corrected in this version of HP OpenVMS/Hanzi Alpha. 4.1 Correction in Hmail V7.3 In the previous versions of OpenVMS/Hanzi Alpha, HMAIL does not correctly work on expanding KEYNODEF for keys from F6 through F14 as mentioned in HMAIL>HELP DEFINE Parameters. This problem has been corrected in this version of HP OpenVMS/Hanzi Alpha. Starting with Version 7.0, if a user attempts to forward a foreign file, the FORWARD command fails and the user is returned to the HMAIL> prompt. No message of any kind is displayed. This has been modified to correctly allow forwarding of foreign files in this version of HP OpenVMS/Hanzi Alpha. 4.2 Correction in Chinese Screen Management (SMG$) Run-Time Library V7.1 Applications that are linked with HSMGSHR.EXE of HP OpenVMS/Hanzi Alpha Versions 6.1, 6.2 and 7.0 may experience access violation problems that occur in the Chinese SMG routines. This problem has been fixed in this version of HP OpenVMS/Hanzi Alpha. 4.3 Correction in PCSI Remove Procedure V7.0 The PCSI Remove procedure for HP OpenVMS/Hanzi Alpha Version 6.2 removes the CMGR database from the system. Any data stored in the database are removed and cannot be recovered. This problem is corrected in Version 7.0. The PCSI Remove procedure for HP OpenVMS/Hanzi Alpha Version 8.3 will preserve the CMGR database so that it can be restored later. Problems Corrected 4-1 Problems Corrected 4.4 Correction in HANZIGEN 4.4 Correction in HANZIGEN V7.0 The OpenVMS/Hanzi User Guide Version 1.5 AXP and Version 6.0 VAX states that the /SYSTEM qualifier of the HANZIGEN utility requires PHY_IO privilege. Similarly, the help text in the HANZIGEN utility also states this requirement. This is incorrect. The required privileges should be PHY_ IO and SYSPRV. The HANZIGEN utility help text has been corrected in Version 7.0; the OpenVMS/Hanzi User Guide will be corrected in a future version of the manual. 4.5 Correction in Terminal Driver The following problems for terminal I/O have been corrected in this version of HP OpenVMS/Hanzi Alpha. 4.5.1 Read Verify V6.1 In the previous version of OpenVMS/Hanzi Alpha, the system will crash if an application reads data from the terminal using the read verify and noecho features of the terminal driver, while the user deletes a Chinese character. This situation typically occurs with applications that uses DECforms/Hanzi. 4.5.2 Uppercasing V6.1 The uppercasing feature of the terminal driver transforms lowercase Latin characters (e.g. lower case characters in the English alphabet) to their uppercase equivalents. In the previous version of OpenVMS/Hanzi Alpha, Chinese characters are transformed incorrectly when the terminal I/O is performed in NOECHO and NOFILTER mode. 4.5.3 Control Character V7.2 In the pervious version of OpenVMS/Hanzi Alpha, the system will crash when terminal driver deals with some single byte control characters under certain conditions. 4.6 Correction in DCL V6.1 In OpenVMS/Hanzi Alpha V1.5, programs which call the library routines LIB$DELETE_SYMBOL, LIB$GET_SYMBOL, and LIB$SET_SYMBOL will not work properly and access violation may occur. In OpenVMS/Hanzi Alpha V6.1, this problem has been fixed and all such programs will work properly. 4-2 Problems Corrected Problems Corrected 4.7 Correction in Sort and Merge 4.7 Correction in Sort and Merge V6.2 In previous versions of OpenVMS/Hanzi Alpha, when multiple Chinese sort keys and descending order are specified, the sort results for the last key remain in ascending order. This problem has been fixed in this version of OpenVMS/Hanzi Alpha. 4.8 Correction in Character Manager 4.8.1 Collating Attribute Database V7.2 In OpenVMS/Hanzi Alpha Version 7.1, in using the collating attribute database of CMGR, an error message will appear as shown below and the respective operation will fail. %CMGR-F-NOCDBIND, Collating database index file not found In order to solve this problem, the user must define a logical name as shown below. $ DEFINE DECC$DEFAULT_UDF_RECORD 1 If users want to correct the problem system wide, the logical name must be defined in the system logical name table. 4.8.2 Help Message V6.1 In previous versions of HP OpenVMS/Hanzi Alpha, the CMGR online help and the section of Character Manager (CMGR) User's Guide on the CONVERT FONT_SIZE command have misleadingly described the choice of preload sequence when the input file(s) contain more than one preload sequence of the same code. It should be the last preload sequence "with size closest to the output font size" that will be used for conversion. The CMGR online help has been corrected in this version of HP OpenVMS/Hanzi Alpha. Character Manager (CMGR) User's Guide will be corrected in a future version. 4.9 Correction in Show V6.2 In the previous versions of OpenVMS/Hanzi Alpha, SHOW QUEUE/FULL command would display incorrect working set information. This problem has been corrected in this version of HP OpenVMS/Hanzi Alpha. Problems Corrected 4-3 Problems Corrected 4.10 Compatibility problem with ALLIN1/Hanzi 4.10 Compatibility problem with ALLIN1/Hanzi V7.2 The installation of the ALLIN1/Hanzi Alpha will fail when ALLIN1/Hanzi Alpha Version 3.2 is installed into OpenVMS/Hanzi Alpha Version 7.2. Therefore, starting from Version 7.2, ALLIN1/Hanzi Alpha is not supported in OpenVMS/Hanzi Alpha. 4-4 Problems Corrected 5 _________________________________________________________________ Restrictions and Known Problems This chapter describes the restrictions and known problems in this version of OpenVMS/Hanzi Alpha. 5.1 Restriction in HTPU Motif Interface Currently, the HTPU Motif interface is available in English only. There is no Hanzi HTPU Motif interface provided. The Chinese output message setting under Hanzigen utility has no effect on the HTPU Motif interface. It means that you cannot change the languages of the HTPU Motif interface between English and Chinese. The Hanzi HTPU Motif interface will be provided in the future release. 5.2 Known Problem in HTPU When HTPU is invoked using DECwindows Motif /Hanzi interface ($ HTPU/INTERFACE=MOTIF), it will fail to invoke the Chinese input method and the following error message will be displayed. That is, Chinese characters (except ASCII characters) input will be disabled. Users are recommended to use terminal interface if Chinese characters input is required. %HTPU-I-RIMP_NOT_EXIST, RIMP for input method does not exist The problem will be fixed in the next future release. Restrictions and Known Problems 5-1