______________________________________________ ALL-IN-1/Hanzi Version 3.2 Installation Guide Order Number: AA-PS7RB-TE June 1996 This manual provides information on the installa- tion of ALL-IN-1/Hanzi Version 3.2. Operating System & OpenVMS/Hanzi VAX Version Version: 6.1 and OpenVMS/Hanzi Alpha Version 6.1 Software Version: ALL-IN-1/Hanzi Version 3.2 __________________________________________________________ June 1996 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. Possession, use, duplication, or dissemination of the software described in this document is authorized only pursuant to a valid written license from Digital or the third-party owner of the software copyright. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation. © Digital Equipment Hong Kong Limited 1996 All rights reserved. Printed in Singapore. The following are trademarks of Digital Equipment Corporation: ALL-IN-1, CDA, DECdx/RSTS, DECmail, DECnet, DECpage, DECtalk, DECwindows, DX, EDT, MicroVAX, TOPS-20, VAX, VAXcluster, VAX DATATRIEVE, VAX FMS, VAX Notes, VAX RALLY, VAX TEAMDATA, VAX VTX, VMS, WPS-PLUS, and the DIGITAL logo. ACMS is a trademark of McDonnell Douglas H.I.S. Division. Bell is a trademark of Bell telephone companies. Ethernet is a trademark of Xerox Corporation. PostScript is a registered trademark of Adobe Systems, Inc. Vadic is a trademark of Racal-Vadic. Motif is a registered trademark of Open Software Foundation, Inc. WordPerfect is a trademark of WordPerfect Corp. This document was prepared using VAX DOCUMENT, Version 2.1. ________________________________________________________________ Contents Preface.................................................. vii Part I BASE INSTALLATION 1 Preparing to Install ALL-IN-1/Hanzi V3.2 1.1 Installation Types.............................. 1-1 1.2 Software Prerequisites.......................... 1-2 1.3 Registering the ALL-IN-1/Hanzi Version 3.2 License......................................... 1-3 1.4 Installation Order.............................. 1-3 1.5 Update of ALL-IN-1 V3.2 to ALL-IN-1/Hanzi V3.2.. 1-5 1.6 Installing Additional Languages................. 1-6 2 Migration Tools 3 Installation Procedure 4 Post Installation Procedure 4.1 Executing the ALL-IN-1 Startup Command Procedure....................................... 4-1 4.2 Setting WPS-PLUS attribute...................... 4-1 4.3 Setting Queue Characteristics for Printers...... 4-1 4.4 Converting WPS-PLUS/Hanzi Documents to ALL-IN-1........................................ 4-1 iii Part II Language and Market Installation 5 Hanzi Language Installation 5.1 Distribution Media.............................. 5-1 5.2 Useful Information for the Hanzi Language Component....................................... 5-2 5.3 Optional Products............................... 5-3 5.4 PRC Market/Country Component.................... 5-3 5.4.1 Useful Information for the PRC Market/Country Component..................................... 5-4 5.5 Modems Supported................................ 5-5 6 English Language Installation 6.1 Distribution Media.............................. 6-1 6.2 Useful Information for the English Language Component....................................... 6-2 6.3 Market/Country component........................ 6-3 Part III DEC FMS/Hanzi Installation 7 Preparing to Install Hanzi FMS Software 7.1 Prerequisite and Optional Software.............. 7-1 7.2 Prerequisite Hardware........................... 7-1 7.3 License Registration............................ 7-2 7.4 Installation Procedure Requirements............. 7-2 7.4.1 Restrictions ................................. 7-2 7.4.2 Time ......................................... 7-3 7.4.3 Privileges ................................... 7-3 7.4.4 Disk Space ................................... 7-3 7.4.5 System Parameters ............................ 7-4 7.4.6 Process Account Quotas ....................... 7-4 7.4.7 VMSINSTAL Requirements ....................... 7-5 7.4.8 Backing Up Your System Disk .................. 7-5 iv 8 Installing Hanzi FMS Software 8.1 General Information............................. 8-1 8.1.1 Accessing the Online Release Notes ........... 8-1 8.1.2 Determining the Files and Logical Names Added to the System................................. 8-2 8.1.3 Running the Installation Verification Procedure..................................... 8-2 8.1.4 Ending the Installation Abnormally ........... 8-2 8.2 Installation Procedure.......................... 8-2 8.2.1 Invoking VMSINSTAL ........................... 8-3 8.2.2 Answering Installation Questions ............. 8-4 8.2.3 Informational Messages ....................... 8-9 8.2.4 Running the Installation Verification Procedure..................................... 8-10 8.2.5 Completing the Installation Procedure ........ 8-11 8.3 Error Recovery.................................. 8-11 9 After Installing Hanzi FMS Software 9.1 Editing the System Files........................ 9-1 9.2 User Account Requirements....................... 9-2 9.3 Running the IVP................................. 9-2 9.4 Special Requirements............................ 9-3 9.5 Enhancing Hanzi FMS Performance................. 9-3 9.6 Determining and Reporting Problems.............. 9-4 10 Verifying the Form Editor and Form Tester A CFMS Sample Installation B CFMS Related Files Installed on Your System v Tables 1-1 Prerequistic Software ........................ 1-2 5-1 Useful Information for the Hanzi Language Component..................................... 5-2 5-2 Disk Space Required on the System Disk or AWD(Blocks) .................................. 5-2 5-3 Useful Information for the PRC Market/Country Component..................................... 5-4 5-4 Autodial Modems Supported by ALL-IN-1 ........ 5-5 6-1 Useful Information for the English Language Component..................................... 6-2 6-2 Disk Space Required on the System Disk or AWD(Blocks) .................................. 6-3 7-1 CFMS Disk Space Requirements ................. 7-3 7-2 CFMS Required System Parameter Values ........ 7-4 7-3 CFMS Process Account Quotas for the Installing Account....................................... 7-4 9-1 User Account Quotas for Using CFMS Software .. 9-2 vi ________________________________________________________________ Preface Product Description ALL-IN-1/Hanzi is a customizable, menu-oriented software product that provides generic office applications and a facility for integrating with other business-oriented applications. Purpose of this Guide The purpose of this Guide is to provide information on the installation of the ALL-IN-1/Hanzi V3.2 software product. Please note that this Guide, by itself, does not provide complete information on installation. Section 5 gives a roadmap on all manuals related to ALL-IN-1/Hanzi V3.2 installation. Related Documents Other documents related to ALL-IN-1/Hanzi V3.2 are : o ALL-IN-1/Hanzi V3.2 Release Notes o ALL-IN-1/Hanzi User's Guide o ALL-IN-1/Hanzi V3.2 Read Me First o Keyboard Reference Card o Keyboard Diagram vii Document Structure This Installation Guide is divided into three main parts. Part I, BASE INSTALLATION This part describes only specifics of ALL-IN-1/Hanzi V3.2 installation. To successfully install ALL-IN-1/Hanzi V3.2, you must first read ALL-IN-1 Installation: Guide from the standard ALL-IN-1 V3.2 documentation set. viii Part II, LANGUAGE AND MARKET INSTALLATION This part contains language-specific information on the Hanzi and American English language components that you are installing. It also contains information on the PRC Market component which overrides ALL-IN-1 Installation: Language and Market Supplement that belongs to the standard ALL-IN-1 V3.2 documentation set. Part III, DEC FMS/Hanzi INSTALLATION This part describes installation of DEC FMS/Hanzi V2.4. Note that you must install this product before you install ALL-IN-1/Hanzi on an Alpha machine. Installation Roadmap To fully understand and successfully install ALL-IN-1 /Hanzi V3.2, all of the following manuals are required. Before installation, make sure you read these in the following recommended order: - ALL-IN-1 Overview and Planning Guide - ALL-IN-1 Installation: Guide - ALL-IN-1/Hanzi V3.2 Installation Guide (this manual) ix Part I ________________________________________________________________ BASE INSTALLATION This is Part I of three parts. See the section on document structure. It describes the installation differences between ALL-IN-1/Hanzi V3.2 and standard ALL-IN-1 V3.2. To carry out the installation of the product, you should first read ALL-IN-1 Installation: Guide. 1 ________________________________________________________________ Preparing to Install ALL-IN-1/Hanzi V3.2 1.1 Installation Types The following types of installation are supported in this release. o Full installation of ALL-IN-1/Hanzi Version 3.2 on a VAX or an Alpha System. o Upgrade installation of ALL-IN-1/Hanzi Version 3.0 to ALL-IN-1/Hanzi Version 3.2 on a VAX. o Upgrade installation of standard ALL-IN-1 Version 3.1 to ALL-IN-1/Hanzi Version 3.2 on a VAX or an Alpha System. o Addition of VAX or Alpha architecture support for ALL-IN-1/Hanzi Version 3.2 on a different architeture in the same VMXcluster. ________________________Note ________________________ You can only upgrade to ALL-IN-1/Hanzi V3.2 using the same default language as that on your current system. This means that if your current system is running ALL-IN-1 V3.1, the default language would be English. In this case, you must install ALL-IN-1 /Hanzi V3.2 using English as the main installation language (the default language). Hanzi will be installed as an additional language. _____________________________________________________ Preparing to Install ALL-IN-1/Hanzi V3.2 1-1 Preparing to Install ALL-IN-1/Hanzi V3.2 1.2 Software Prerequisites 1.2 Software Prerequisites The following software must be installed on your system: Table_1-1_Prerequistic_Software___________________________ Supplied Software VAX Alpha With Product__________Version__VersionKit?___Notes_____________ OpenVMS/Hanzi 6.1 - N Prerequisite for VAX installation on VAX. Must be a full untailored system OpenVMS/Hanzi - 6.1 N Prerequisite for Alpha installation on Alpha. Must be a full untailored system DECnet Phase IV 5.5 1.5 N Prerequisite or DECnet OSI for 6.2 6.2 N Prerequisite OpenVMS VAX Forms 2.3 - Y Prerequisite Management System (CFMS)+ DEC Forms - 2.4 Y Prerequisite Management System (CFMS)++ +See_the_VAX_CFMS_Installation_Guide_and_Release_Notes____ ++See Part III of this guide. Note that CFMS V2.4 is not a released product. __________________________________________________________ 1-2 Preparing to Install ALL-IN-1/Hanzi V3.2 Preparing to Install ALL-IN-1/Hanzi V3.2 1.3 Registering the ALL-IN-1/Hanzi Version 3.2 License 1.3 Registering the ALL-IN-1/Hanzi Version 3.2 License You must ensure that you have an ALLIN1-UI-HANZI license registered. If you are installing a new ALL-IN-1/Hanzi Version 3.2 system, then register your ALLIN1-UI-HANZI Version 3.2 software license using the VMS License Management Facility (LMF). The license registration information you need is in the Product Authorization Key (PAK) supplied with ALL-IN-1 /Hanzi Version 3.2. The PAK is a paper certificate that contains information about the license you must have in order to run a particular piece of software. You must register your ALLIN1-UI-HANZI Version 3.2 license before you perform the installation. During the installation, you are asked if you have registered and loaded the ALLIN1-UI-HANZI Version 3.2 license. The ALL-IN-1/Hanzi Version 3.2 installation checks for a registered license when it begins. If a license is not found, the installation terminates. ________________________Note ________________________ You cannot use the Register Licenses for Prerequisite Products (RL) option offered at the beginning of the installation procedure, unless you have a valid ALLIN1-UI-HANZI license registered. _____________________________________________________ For complete information on using LMF, see the manual on the License Management Utility in the VMS documentation set. 1.4 Installation Order The following installation order is recommended: 1. Install Hanzi FMS Version 2.3 and its accompanied MUPA, if it is not already installed on your VAX system. 2. Install Hanzi FMS V2.4 if it is not already installed on your Alpha system. 3. Install ACMS Version 3.1, or higher, if you want to incorporate it with ALL-IN-1/Hanzi Version 3.2. Preparing to Install ALL-IN-1/Hanzi V3.2 1-3 Preparing to Install ALL-IN-1/Hanzi V3.2 1.4 Installation Order 4. Install DATATRIEVE Version 6.1, or higher, if you want to incorporate it with ALL-IN-1/Hanzi Version 3.2. 5. Install Message Router Version 3.3A, if you want to send and receive messages to and from other systems, or you want to use Mail directory addressing, or you want to send mail to VMSmail users, either on the local system or to remote systems. 6. Configure Message Router Version 3.3A, if it is installed and not yet configured. 7. Install Message Router VMSmail Gateway Version 3.3, if you want to send mail to VMSmail users, either on the local system or remotely. 8. Configure Message Router VMSmail Gateway Version 3.3, if it is installed and not yet configured. 9. Install CDA Converter Library Version 2.2(VAX only). 10.Install the CDA Interoperability kit, CDAPAT022. 11.Install VAX Notes Version 2.5. 12.Install ALL-IN-1/Hanzi Version 3.2. 13.Configure exception reporting routines for ALL-IN-1 /Hanzi Version 3.2 Electronic Messaging subsystem. ________________________Note ________________________ WPS-PLUS/Hanzi Version 4.2 is supplied with ALL-IN-1 /Hanzi. If you choose to integrate WPS-PLUS with ALL-IN-1/Hanzi, it is available as the default editor in ALL-IN-1/Hanzi. _____________________________________________________ Make sure that the following shareable images and message files are installed on your system before installing ALL-IN-1/Hanzi: o SYS$MESSAGE:CFDVMSG.EXE o SYS$MESSAGE:CFDVMSGE.EXE o SYS$SHARE:HSYSHR.EXE o SYS$SHARE:CONVSHR.EXE 1-4 Preparing to Install ALL-IN-1/Hanzi V3.2 Preparing to Install ALL-IN-1/Hanzi V3.2 1.4 Installation Order o SYS$SHARE:FDLSHR.EXE o SYS$SHARE:CFDVSHR.EXE o SYS$SHARE:LBRSHR.EXE o SYS$SHARE:MTHRTL.EXE for a MicroVAX II, or a MicroVAX 2000, the file is SYS$SHARE:UVMTHRTL.EXE o SYS$SHARE:NMLSHR.EXE o SYS$SHARE:PASRTL.EXE o SYS$SHARE:SCNRTL.EXE o SYS$SHARE:SCRSHR.EXE o SYS$SHARE:VMSRTL.EXE o SYS$SHARE:VAXCRTL.EXE o SYS$SHARE:HEDTSHR.EXE o SYS$SHARE:DNS$SHARE.EXE o SYS$SHARE:DNS$RTL.EXE ________________________Note ________________________ If the images CFDVMSG.EXE, CFDVMSGE.EXE and CFDVSHR.EXE are not installed, execute the command procedure SYS$MANAGER:CFMSTARTUP.COM. If the image HSYSHR.EXE is not installed, execute the command procedure SYS$MANAGER:HANZISTARTUP.COM. _____________________________________________________ 1.5 Update of ALL-IN-1 V3.2 to ALL-IN-1/Hanzi V3.2 If you are going to perform the update installation, do the following after you have completed the installation checklist described in ALL-IN-1 Installation: Guide. a. Log into the ALLIN1 account Preparing to Install ALL-IN-1/Hanzi V3.2 1-5 Preparing to Install ALL-IN-1/Hanzi V3.2 1.5 Update of ALL-IN-1 V3.2 to ALL-IN-1/Hanzi V3.2 b. Rename all OA$LIB_SHARE:WPLCURR_*_*.MSG to OA$LIB_ SHARE:OLD_WPLCURR_*_*.MSG eg. RENAME OA$LIB_SHARE:WPLCURR_US_ENGLISH.MSG - OA$LIB_SHARE:OLD_WPLCURR_US_ENGLISH.MSG c. Rename all OA$LIB_SHARE:WPLDATES_*_*.MSG to OA$LIB_ SHARE:OLD_WPLDATES_*_*.MSG eg. RENAME OA$LIB_SHARE:WPLDATES_US_ENGLISH.MSG - OA$LIB_SHARE:OLD_WPLDATES_US_ENGLISH.MSG d. Rename all OA$LIB_SHARE:OAFORM_*_*.FLB to OA$LIB_ SHARE:OLD_OAFORM_*_*.FLB eg. RENAME OA$LIB_SHARE:OAFORM_US_ENGLISH.FLB - OA$LIB_SHARE:OLD_OAFORM_US_ENGLISH.FLB 1.6 Installing Additional Languages ALL-IN-1/Hanzi V3.2 kit is supplied with the Hanzi and English language components. You can install either one or both. If it is a new installation, you can install the languages in any order. The language that you install when the main ALL-IN-1/Hanzi V3.2 kit is installed becomes the default language of your system. If you are upgrading/updating to ALL-IN-1/Hanzi V3.2, you can only upgrade/update using the same default language as that on your current system. 1-6 Preparing to Install ALL-IN-1/Hanzi V3.2 2 ________________________________________________________________ Migration Tools If you are upgrading from a previous version of ALL-IN-1 which is customized, you need to run the Conflict Checking and Resolution Tool (CART) before installing ALL-IN-1 /Hanzi V3.2 in order to save your customization. For detailed information on CART, refer to Chapter 6 of ALL-IN-1 Overview and Planning Guide. Migration Tools 2-1 3 ________________________________________________________________ Installation Procedure You must have DEC FMS/Hanzi installed before installing ALL-IN-1/Hanzi on an Alpha machine. Please refer to part III of this book for a full FMS/Hanzi installation. Refer to the standard ALL-IN-1 Installation: Guide for the full installation procedure of the installation type that you are to perform. Installation Procedure 3-1 4 ________________________________________________________________ Post Installation Procedure After the system has been successfully installed, attend to the post installation procedure described in Chapter 5 of ALL-IN-1 Installation: Guide. 4.1 Executing the ALL-IN-1 Startup Command Procedure In addition to the standard procedures, make sure the ALL-IN-1 startup command procedure, A1V32START.COM, is executed after SYS$MANAGER:HANZISTARTUP.COM and SYS$MANAGER:CFMSTARTUP.COM. 4.2 Setting WPS-PLUS attribute For all ALL-IN-1 users who use WPS-PLUS as the default editor, SYS$MANAGER:A1WPSPLUS_LOGIN.COM must be executed before starting ALL-IN-1/Hanzi. To automate the step, the following line should be added to SYS$MANAGER:SYLOGIN.COM : $@SYS$MANAGER:A1WPSPLUS_LOGIN.COM 4.3 Setting Queue Characteristics for Printers To set up your Hanzi printers, follow the instructions described in ALL-IN-1 Installation: Guide. 4.4 Converting WPS-PLUS/Hanzi Documents to ALL-IN-1 If your system is currently running WPS-PLUS/Hanzi and users want to access documents created with WPS-PLUS/Hanzi from within ALL-IN-1, each user must do the following: ________________________Note ________________________ You must give each ALL-IN-1 user who wants to convert their WPS-PLUS/Hanzi documents the ALL-IN-1 Post Installation Procedure 4-1 Post Installation Procedure 4.4 Converting WPS-PLUS/Hanzi Documents to ALL-IN-1 DCL and CMD privileges. See ALL-IN-1 Management Guide for details of setting these privileges. If you normally restrict this access, reset it after the conversion is complete. _____________________________________________________ 1. Check that the directory containing the WPS-PLUS/Hanzi File Cabinet exists by entering the following command: $ DIRECTORY/PROTECTION disk:[username.CWPSPLUS...]*.* where: - disk is the name of the user's VMS disk - username is the VMS username The above command lists all the files in the WPS-PLUS /Hanzi account belonging to the user. 2. Make sure that all files have the following minimum protection: (S:RWD,O:RWE,,) 3. Run ALL-IN-1. 4. Enter WP to display the Word and Document Processing menu. 5. Enter the following command: : When the conversion is complete, ALL-IN-1 returns you to the Word and Document Processing menu. 9. To convert your User Defined Process [.UDP] files, do the following: a. From the Word and Document Processing menu, enter $. ALL-IN-1 places you in the sub-process. b. Enter the following command: $ COPY/LOG [username.CWPSPLUS]*.UDP [.UDP]*.* where username is the VMS user's directory, as recorded in the SYS$SYSTEM:SYSUAF.DAT file. c. When the copying is finished, press EXIT to return to ALL-IN-1. ________________________Note ________________________ If you want to use the converted documents when using ALL-IN-1, your default editor must be WPS-PLUS. _____________________________________________________ Post Installation Procedure 4-3 Part II ________________________________________________________________ Language and Market Installation This part describes information specific to your ALL-IN-1 /Hanzi V3.2 Hanzi and English language components. Each language component can be installed either as part of the main ALL-IN-1/Hanzi installation proce- dure or as an additional language. For details, see ALL-IN-1 Installation: Guide and Part I of this book. ALL-IN-1 Installation: Guide refers to information contained in this document. 5 ________________________________________________________________ Hanzi Language Installation 5.1 Distribution Media Your ALL-IN-1/Hanzi V3.2 Hanzi language kit contains the Hanzi language component. The software for the ALL-IN-1/Hanzi Hanzi Language kit is on the distribution media labeled: ALL-IN-1/Hanzi V3.2 Hanzi BIN media_type LANGUAGE COMPONENT (c) 1996 Digital Equipment Corp. where media_type is 16MT9 for tape and TK50 for a TK50 cartridge. The ALL-IN-1/Hanzi V3.2 Hanzi Language kit contains: __________________________________________________________ Saveset___________Description_____________________________ A1LHA032.A ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.B ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.C ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.D ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.E ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.F ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.G ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.H ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.I ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.J ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.K ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.L ALL-IN-1/Hanzi V3.2 Hanzi Language kit A1LHA032.M________ALL-IN-1/Hanzi_V3.2_Hanzi_Language_kit__ Hanzi Language Installation 5-1 Hanzi Language Installation 5.2 Useful Information for the Hanzi Language Component 5.2 Useful Information for the Hanzi Language Component Table 5-1 lists useful information for the Hanzi language version of ALL-IN-1/Hanzi V3.2 and where the information is used and Table 5-2 lists the disk space requirement on the System Disk for different installation types. Table 5-1 Useful Information for the Hanzi Language __________Component_______________________________________ Information_____Value_________Use_________________________ Product name A1LHA032 Installation Language name Hanzi File, directory and logical names, and for the /LANGUAGE qualifier Language code HA During installation Language 50,000 VAX Installation component kit 55,000 Alpha Installation size_(blocks)_____________________________________________ Table 5-2 Disk Space Required on the System Disk or __________AWD(Blocks)_____________________________________ Installation Type VAX Alpha Non- Non- _________________Safety_____safety_____Safety_____safety__ Hanzi as 165 000 40 000 220 000 60 000 the primary language Addition of 55 000 30 000 125 000 60 000 architecture support for Hanzi as the primary language (continued on next page) 5-2 Hanzi Language Installation Hanzi Language Installation 5.2 Useful Information for the Hanzi Language Component Table 5-2 (Cont.) Disk Space Required on the System Disk __________________or_AWD(Blocks)__________________________ Installation Type VAX Alpha Non- Non- _________________Safety_____safety_____Safety_____safety__ Hanzi as an 77 000 30 000 83 000 30 000 additional language Addition of 12 000 10 000 20 000 14 000 architecture support for Hanzi as an additional language__________________________________________________ 5.3 Optional Products You can integrate the following optional products with ALL-IN-1/Hanzi: o VAX Grammar Checker Version 1.0 (VAX Only) o American Business Lexicon for OpenVMS o American Medical Lexicon for OpenVMS See Language and Specialized Lexicons Installation Guide for instructions on installing the lexicons and the Software Product Description for the supported versions. 5.4 PRC Market/Country Component The PRC market/country component contains: __________________________________________________________ Saveset___________Description_____________________________ A1CPR032.A ALL-IN-1/Hanzi V3.2 PRC market/country kit A1CPR032.B ALL-IN-1/Hanzi V3.2 PRC market/country kit Hanzi Language Installation 5-3 Hanzi Language Installation 5.4 PRC Market/Country Component __________________________________________________________ Saveset___________Description_____________________________ AICPR032.C ALL-IN-1/Hanzi V3.2 PRC market/country __________________kit_____________________________________ 5.4.1 Useful Information for the PRC Market/Country Component Table 5-3 lists the useful information for the PRC market /country component of ALL-IN-1/Hanzi V3.2. Table 5-3 Useful Information for the PRC Market/Country __________Component_______________________________________ Information_____Value_________Use_________________________ Product name A1CPR032 Installation and naming of savesets Market name PRC Media labeling Market code PR During installation ALL-IN-1 date format: Alphanumeric DD-MMM-YYYY ALL-IN-1 Numeric MM/DD/YY ALL-IN-1 WPS-PLUS date DD.MM.YY WPS-PLUS format WPS-PLUS time colon(:) WPS-PLUS separator Currency format: Currency $ ALL-IN-1 symbol Decimal dot (.) ALL-IN-1 separator Thousand comma (,) ALL-IN-1 separator Page_size_______66____________Printer_settings____________ 5-4 Hanzi Language Installation Hanzi Language Installation 5.5 Modems Supported 5.5 Modems Supported The autodial feature of the modems listed in Table 5-4 is supported. You can disable this feature by customizing OAMARKET.BLI. Table_5-4_Autodial_Modems_Supported_by_ALL-IN-1___________ Manufacturer____Model_Number______________________________ Digital DF02-AC Digital DF03-AC Digital DF100 series Case 440/12 Racal-Milgo MPS1222-AD Racal-Milgo MPS1222 with Racal-Vadic ________________VA811_____________________________________ In addition, all BELL 212A/103 compatible modems and modems meeting CCITT V21 and V22 recommendations are supported as manual-dial modems. Refer to the manuals provided with the modems for information on installing and using modems. Hanzi Language Installation 5-5 6 ________________________________________________________________ English Language Installation 6.1 Distribution Media Your ALL-IN-1/Hanzi V3.2 English language kit contains the American English language component of the ALL-IN-1/Hanzi V3.2 kit. It includes the American Language Lexicon. ________________________Note ________________________ ALLIN1-UI-HANZI license enables you to run English language variant of ALL-IN-1/Hanzi without a separate license. _____________________________________________________ The software for the ALL-IN-1/Hanzi English Language component kit is on the distribution media labeled: ALL-IN-1/Hanzi V3.2 ENGLISH BIN media_type LANGUAGE COMPONENT (c) 1996 Digital Equipment Corp. where media_type is 16MT9 for tape and TK50 for a TK50 cartridge. ALL-IN-1 Release Notes Part 1 English Language is also included on the above distribution media. This Release Notes contains information on the standard ALL-IN-1 V3.2 software only. For release notes information on the Hanzi specific features, refer to ALL-IN-1/Hanzi V3.2 Release Notes. The ALL-IN-1/Hanzi V3.2 English Language kit contains: __________________________________________________________ Saveset_____Description___________________________________ A1LUS032.A ALL-IN-1/Hanzi V3.2 English Language kit English Language Installation 6-1 English Language Installation 6.1 Distribution Media __________________________________________________________ Saveset_____Description___________________________________ A1LUS032.B ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.C ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.D ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.E ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.F ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.G ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.H ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.I ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.J ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.K ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.L ALL-IN-1/Hanzi V3.2 English Language kit A1LUS032.M__ALL-IN-1/Hanzi_V3.2_English_Language_kit______ 6.2 Useful Information for the English Language Component Table 6-1 lists the useful information for the American English language component of ALL-IN-1/Hanzi V3.2 and where the information is used. Table 6-1 Useful Information for the English Language __________Component_______________________________________ Information_____Value_________Use_________________________ Product name A1LUS032 Installation Language name English File, directory and logical names, and for the /LANGUAGE qualifier Language code US During installation Language 50,000 VAX Installation component kit 55,000 Alpha Installation size_(blocks)_____________________________________________ 6-2 English Language Installation English Language Installation 6.2 Useful Information for the English Language Component Table 6-2 Disk Space Required on the System Disk or __________AWD(Blocks)_____________________________________ Installation Type VAX Alpha Non- Non- _________________Safety_____safety_____Safety_____safety__ English as 165 000 40 000 230 000 60 000 the primary language Addition of 55 000 30 000 125 000 60 000 architecture support for English as the primary language English as 77 000 30 000 83 000 30 000 an additional language Addition of 12 000 10 000 20 000 14 000 architecture support for English as an additional language__________________________________________________ 6.3 Market/Country component The English language component of ALL-IN-1/Hanzi V3.2 use the same PRC Market component as the Hanzi language. Refer to section 5.4 of this manual. English Language Installation 6-3 Part III ________________________________________________________________ DEC FMS/Hanzi Installation This section describes how to install Hanzi Forms Management System (CFMS) for OpenVMS/Alpha Version 2.4. Please read the online realease notes for new features, bug fixes and restrictions of DEC FMS/Hanzi for OpenVMS /Alpha Version 2.4. You should read this section before installing Hanzi FMS software. To install Hanzi FMS software, you must have access to a privileged account. To run the Installation Verification Procedure (IVP), you must use a VT100, VT200 or VT382 Hanzi-series terminal or one that is VT100-compatible. This part consists of four chapters and two appendices: Chapter 7 describes the preparations and requirements necessary for installing Hanzi FMS software. Chapter 8 describes the Hanzi FMS installation procedure. Chapter 9 describes the tasks to perform after installing Hanzi FMS software. Chapter 10 describes the postinstallation IVP. Appendix A reproduces typical installation and IVP sessions. Appendix B details the files that are installed or modified. 7 ________________________________________________________________ Preparing to Install Hanzi FMS Software This chapter discusses the preparations and requirements necessary to install Hanzi FMS software. Hanzi FMS provides online release notes. You can read and print the release notes before the Hanzi FMS installation begins, when you first run the installation procedure. Digital Equipment Corporation strongly recommends that you read the release notes before proceeding with the installation. 7.1 Prerequisite and Optional Software This section discusses the software you must have installed on your system before installing Hanzi FMS software. The section also includes information about software that you can use together with Hanzi FMS software. DEC FMS/Hanzi Version 2.4 requires OpenVMS/Hanzi for Alpha Version 6.1 operating system. If the optional software uses CDD/Plus software, or if DBMS software is to be part of the system, you should install those products before you install Hanzi FMS. CDDSHR.EXE must always be installed using the Install Utility. 7.2 Prerequisite Hardware To run the IVP, you must have a video terminal. See Chapter Chapter 9 for more information on the postin- stallation IVP. Preparing to Install Hanzi FMS Software 7-1 Preparing to Install Hanzi FMS Software 7.3 License Registration 7.3 License Registration The VMS License Management Facility (LMF) is available with OpenVMS/Hanzi Alpha Version 6.1 operating system. If you are installing Hanzi FMS on a OpenVMS/Hanzi Alpha Version 6.1 system, you must register your software license. [1] The license registration information you need is contained in the Product Authorization Key (PAK) that is shipped with ALL-IN-1/Hanzi. The PAK is a paper certificate that contains information about the license you own to run a particular piece of software. During the installation, you are asked if you have registered the required ALL-IN-1 license, namely ALLIN1- UI-HANZI. You must register and load this license for Hanzi FMS before you start the installation in order to run the IVP and use the software. 7.4 Installation Procedure Requirements The following sections discuss various requirements for installing Hanzi FMS software. 7.4.1 Restrictions No users should be logged in to the system while you are installing Hanzi FMS software. You can use the REPLY command to send a message to users. For example: $ REPLY/ALL "Please log off now. Installing CFMS." If VMSINSTAL detects any users on the system, it gives you an opportunity to stop the installation procedure by prompting you to continue. To stop the installation, press RETURN. ___________________ [1]Hanzi FMS software can be installed without regis- tering the CFMS license. However, the IVP is not executed without a license registration. In addition, the CFMS utilities and applications using the Form Driver are not run until a license is properly registered. 7-2 Preparing to Install Hanzi FMS Software Preparing to Install Hanzi FMS Software 7.4 Installation Procedure Requirements 7.4.2 Time The installation takes approximately 5 to 10 minutes, depending on the type of media and your system configura- tion. 7.4.3 Privileges To install Hanzi FMS, you must be logged in to an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV VMSINSTAL turns off BYPASS privilege at the start of the installation. 7.4.4 Disk Space Installing Hanzi FMS requires a certain amount of free disk space during the installation. Once Hanzi FMS is installed, less storage space is required. Table 7-1 summarizes the storage requirements. Table_7-1_CFMS_Disk_Space_Requirements____________________ Blocks During Blocks After kit___________________Installation__Installation__________ DEC FMS/Hanzi 3000 2650 Version 2.4 Hanzi FMS FDV 350 300 Version_2.4_______________________________________________ To determine the number of free disk blocks on the current system disk, enter the following command: $ SHOW DEVICE SYS$SYSDEVICE Preparing to Install Hanzi FMS Software 7-3 Preparing to Install Hanzi FMS Software 7.4 Installation Procedure Requirements 7.4.5 System Parameters Installing Hanzi FMS requires certain system parameter settings. Table 7-2 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings. Table_7-2_CFMS_Required_System_Parameter_Values___________ System_Parameter______Value_______________________________ GBLPAGES[1] n + 250 GBLSECTIONS[1] n + 4 [1]The_n_variable_refers_to_the_system_parameter_values___ currently in use. To install Hanzi FMS software, you must raise those values by the number indicated. __________________________________________________________ To check the values of your system parameters, invoke the System Generation Utility. 7.4.6 Process Account Quotas The account you use to install Hanzi FMS software must have sufficient quotas to enable you to perform the installation. Table 7-3 summarizes the process quotas required for the installation account. Table 7-3 CFMS Process Account Quotas for the Installing __________Account_________________________________________ Account_Quota_________Value_______________________________ ASTLM 24 BIOLM 18 BYTLM 18,000 DIOLM 18 ENQLM 30 FILLM_________________20__________________________________ 7-4 Preparing to Install Hanzi FMS Software Preparing to Install Hanzi FMS Software 7.4 Installation Procedure Requirements User account quotas are stored in the file SYSUAF.DAT. You use the VMS Authorize Utility to verify and change user account quotas. For more information on modifying account quotas, see the description of the Authorize Utility in the VMS documentation set. 7.4.7 VMSINSTAL Requirements When you invoke VMSINSTAL, it checks whether: o You have set your default device and directory to SYS$UPDATE o You are logged in to a privileged account o You have adequate process account quotas for installa- tion o DECnet software is up and running o Any users are logged in to the system VMSINSTAL requires that the installation account have a minimum of quotas as tabulated in Table 7-3. If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can enter YES to continue. To stop the installation and correct the situation, enter NO or press RETURN. Correct the problem and restart the installation. 7.4.8 Backing Up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Digital recommends that you back up your system disk before installing any software. Use the backup procedures that have been established at your site. For details on backing up a system disk, see the section on the Backup Utility in the VMS documentation set. Preparing to Install Hanzi FMS Software 7-5 8 ________________________________________________________________ Installing Hanzi FMS Software This chapter describes how to install Hanzi FMS software. Section 8.2 contains a step-by-step description of the installation procedure. 8.1 General Information This section includes information about accessing release notes, determining what files and logical names are added to your system, running the Installation Verification Procedure (IVP), and ending the installation abnormally. 8.1.1 Accessing the Online Release Notes Hanzi FMS provides online release notes. You should review the release notes in case they contain any information about changes in the installation procedure. If you want the installation procedure to give you an opportunity to display or print the online release notes, you must specify OPTIONS N when you invoke VMSINSTAL. This question comes near the beginning of the installation. Once Hanzi FMS has been installed, the release notes are located in the following file: SYS$HELP:DECFMS024.RELEASE_NOTES Online help also directs you to the release notes file. After the installation, you can enter the following command to review the release notes through the Help Facility: $ HELP CFMS RELEASE_NOTES Installing Hanzi FMS Software 8-1 Installing Hanzi FMS Software 8.1 General Information 8.1.2 Determining the Files and Logical Names Added to the System Appendix A and Appendix B of the online release notes list the files added, replaced, or modified on your system when Hanzi FMS is installed. Hanzi FMS adds only one logical name CFMS$EXAMPLES to the system when it is installed. Appendix A as well as Appendix A of the online release notes list the files associated with CFMS$EXAMPLES. 8.1.3 Running the Installation Verification Procedure The IVP for Hanzi FMS verifies the installation. During the installation, you are asked if you want to run the IVP as part of the installation. If you respond YES, VMSINSTAL runs the IVP. It is recommended that you run the IVP to be sure that Hanzi FMS is installed correctly. After Hanzi FMS is installed, you can run the IVP independently to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access Hanzi FMS. Because of their interactive nature, the Form Editor and the Form Tester must be tested manually on a VT382 Hanzi- compatible terminal. To verify the installation of the Form Editor and Form Tester, see the procedure explained in Chapter Chapter 10. 8.1.4 Ending the Installation Abnormally To end the installation procedure abnormally at any time, press CTRL/Y. When you press CTRL/Y, the installation procedure deletes all files it has created and exits. You then can start the installation again. 8.2 Installation Procedure The Hanzi FMS installation procedure consists of a series of questions, prompts, and informational messages. The following sections explain how to invoke VMSINSTAL and answer the installation questions. These sections also explain the informational messages displayed by the procedure. 8-2 Installing Hanzi FMS Software Installing Hanzi FMS Software 8.2 Installation Procedure 8.2.1 Invoking VMSINSTAL To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. To invoke VMSINSTAL, enter a command with the following syntax: @SYS$UPDATE:VMSINSTAL product-name device-name OPTIONS N product-name The installation name for the product. For Hanzi FMS software, use the following installation name: CFMS024 device-name The name of the device on which you plan to mount the media. For example, DKA400: is the device name for a CD- ROM drive. It is not necessary to use the console drive for this installation. However, if you do use the console drive, you should replace any media you have removed once the installation is complete. OPTIONS N An optional parameter that indicates you want to see the question on the release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. There are several other options you can select when you invoke VMSINSTAL. For information on these options, see the VMS documentation on software installation The following example displays the command that invokes VMSINSTAL to install Hanzi FMS from CD-ROM drive DKA400: and shows the system response. This example uses the OPTIONS N parameter. $ @SYS$UPDATE:VMSINSTAL CFMS024 DKA400: OPTIONS N OpenVMS ALPHA Software Product Installation Procedure V6.1-1H1 It is 14-NOV-1995 at 10:15. Enter a question mark (?) at any time for help. If you omit either the product name or the device name, VMSINSTAL asks you for this information later. Installing Hanzi FMS Software 8-3 Installing Hanzi FMS Software 8.2 Installation Procedure 8.2.2 Answering Installation Questions This section discusses the questions that appear during the installation. Appendix A contains a sample installation procedure showing how the questions can be answered. An asterisk (*) marks the beginning of each question. Some questions show the default response in brackets, for example, [YES]. To use the default response, press RETURN. 8-4 Installing Hanzi FMS Software Installing Hanzi FMS Software 8.2 Installation Procedure 1. Shut down DECnet. %VMSINSTAL-W-DECNET, Your DECnet network is up and running. . . . * Do you want to continue anyway [NO]? You should install Hanzi FMS on a standalone system or cluster with DECnet shut down. VMSINSTAL notifies you if DECnet is running and displays a list of all active processes. The procedure then asks if you want to continue the installation. NO is the default response to the question. 2. Confirm system backup. * Are you satisfied with the backup of your system disk [YES]? VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press RETURN. Otherwise, enter NO to stop the installation. After you back up your system disk, you can restart the installation. 3. Mount the media. Please mount the first volume of the set on DKA400:. * Are you ready? YES %MOUNT-I-MOUNTED, DECCFMS MOUNTED ON _$$DKA400: The following products will be processed: CFMS V2.4 Beginning installation of CFMS V2.4 at 10:30 %VMSINSTAL-I-RESTORE, Restoring product saveset A... You should now mount the first distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question "Are you ready?". VMSINSTAL then asks you if you are ready to continue with the installation. If you respond YES to indicate that you are ready, VMSINSTAL displays a message that the media containing Hanzi FMS has been mounted on the specified device and that the installation has begun. Installing Hanzi FMS Software 8-5 Installing Hanzi FMS Software 8.2 Installation Procedure If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the "Are you ready?" question. To end the installation abnormally for other reasons, press CTRL/Y. 4. Select a release notes option. Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. Copy release notes to SYS$HELP 5. Do not display, print or copy release notes * Select option [2]: If you specified OPTIONS N when you invoked VMSINSTAL, you have five options for reviewing the release notes. If you select option 1, VMSINSTAL displays the release notes immediately on your terminal. To terminate the display at any time, press CTRL/C. If you select option 2, VMSINSTAL asks you for the name of the print queue that you want to use: * Queue name [SYS$PRINT]: You can press RETURN to print the release notes on the default output print device or you can enter another queue name. Option 2 is the default. If you select option 3, VMSINSTAL displays the release notes immediately on the terminal and then asks you for a queue name for the printed version. If you select option 4, the installation copies the release notes to the Help directory. Even if you do not select option 4, the release notes for Hanzi FMS are copied to the SYS$HELP directory. Select option 5 if you have already reviewed the release notes. 8-6 Installing Hanzi FMS Software Installing Hanzi FMS Software 8.2 Installation Procedure 5. Continue the installation. * Do you want to continue the installation [N]?: YES %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. To continue, enter YES. Otherwise, press RETURN. In either case, the release notes are copied to the following file in the SYS$HELP directory. The release notes are located in the following file: SYS$HELP:DECFMS024.RELEASE_NOTES Installing Hanzi FMS Software 8-7 Installing Hanzi FMS Software 8.2 Installation Procedure ________________________Note ________________________ The name of the release notes file installed by VMSINSTAL consists of the current product name and version number. Do not delete release notes for previous versions of Hanzi FMS software. _____________________________________________________ 6. Register your license. This is a special FMS/Hanzi kit which comes with ALL-IN-1/Hanzi kit and requires ALLIN1-UI-HANZI license to operate. Product: ALLIN1-UI-HANZI Producer: DEC Version: 3.2 Release Date: 17-OCT-1995 * Does this product have an authorization key registered and loaded? As FMS/Hanzi V2.4 is not a released product, the installation procedure displays license information about ALL-IN-1/Hanzi and then asks if you have registered and loaded the authorization key. If you have not registered and loaded your authoriza- tion key, you must answer NO to this question. You have to register and load your product authorization key to complete the installation. If you have not done so, you should stop the installation, register and load your product authorization key, and restart the installation. 7. Run the IVP. * Do you want to run the IVP after the installation [YES]? The installation procedure now asks if you want to run the Installation Verification Procedure (IVP). The IVP for Hanzi FMS software checks to be sure that the installation is successful. It is recommended that you run the IVP. 8-8 Installing Hanzi FMS Software Installing Hanzi FMS Software 8.2 Installation Procedure 8. Purge files. * Do you want to purge files replaced by this installation dir[YES]? You have the option to purge files from previous ver- sions of Hanzi FMS that this installation supercedes. Purging is recommended; however, to save files from the previous version, enter NO in response to the question. 9. Choose installation options. * Do you wish to install Sample Application Programs and Modifiable Message File Procedures [YES]? You are now asked to choose your installation options. If you answer YES to the prompt, the Hanzi FMS modifiable message files and sample applications are installed. The files relating to the sample applications are found in the CFMS$EXAMPLES: directory. The Hanzi FMS installation and start-up procedure (SYS$STARTUP:CFMSTARTUP.COM) defines a system logical for the CFMS$EXAMPLES: directory. The Modifiable Message File Procedures create a subdirectory containing the sources for the CFMS Message Files and instructions on how to modify the text of the messages in the CFMS Form Driver and CFMS Utilities. The message files are found in the subdirec- tory SYS$SYSROOT:[SYSHLP.EXAMPLES.CFMS.MESSAGE]. The instructions for modifying the message files are in the CFMS_MESSAGE.MEM file in that subdirectory. 8.2.3 Informational Messages The installation procedure displays a number of infor- mational messages that report on the progress of the installation. There are no further questions. If the installation has been successful, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. If you asked for files to be purged, that is done now. The procedure displays the following message: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... Installing Hanzi FMS Software 8-9 Installing Hanzi FMS Software 8.2 Installation Procedure If the installation procedure is successful, the following files are moved to their target directory: o SYS$SYSTEM:CFMSFAA.EXE o SYS$SYSTEM:CFMSFED.EXE o SYS$SYSTEM:CFMSFLG.EXE o SYS$SYSTEM:CFMSFLI.EXE o SYS$SYSTEM:CFMSFTE.EXE o SYS$SYSTEM:CFMSFUU.EXE In addition, the SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files are updated to include the new version of the Hanzi FMS HELP text and the CFMS command line definition, respectively. The Hanzi FMS release notes are copied to the SYS$HELP:DECFMS024.RELEASE_NOTES file. For a complete list of files that have been created or modified by the installation procedure, see Appendix Appendix B. 8.2.4 Running the Installation Verification Procedure If you have chosen to run the IVP, VMSINSTAL runs it now. The procedure displays the following message: Beginning CFMS V2.4 Installation Verification Procedure... If Hanzi FMS has been installed, the IVP displays the following message: CFMS V2.4 Installation Verification Procedure was successful Refer to the Hanzi FMS Installation Guide for further verification procedures.. You can run the IVP separately any time after Hanzi FMS software has been installed. To run the IVP, enter the following command: @SYS$SYSDEVICE:[SYS$TEST.CFMS]CFMS$IVP 8-10 Installing Hanzi FMS Software Installing Hanzi FMS Software 8.2 Installation Procedure 8.2.5 Completing the Installation Procedure The following messages indicate that the installation is complete: Installation of CFMS V2.4 completed at 11:03 VMSINSTAL procedure done at 11:17 You can now log out of the privileged account as follows: $ LOGOUT The following message is displayed: SYSTEM logged out at 14-NOV-1995 11:24:32.40 VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, to continue using the system manager's account and to restore these symbols, log out and log in again. 8.3 Error Recovery If errors occur during the installation itself or when the IVP is running, VMSINSTAL displays failure messages. If the installation fails, the procedure displays the following message: %VMSINSTAL-E-INSFAIL, The installation of CFMS V2.4 has failed. If the IVP fails, the procedure displays the following messages: The CFMS V2.4 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for CFMS V2.4 has failed. Errors can occur during the installation if any of the following conditions exists: o The version of the operating system is incorrect. o Quotas are insufficient. o System parameter values are insufficient. o The VMS Help library is being used. o Your disk contains insufficient disk space o The product license has not been registered and loaded. Installing Hanzi FMS Software 8-11 Installing Hanzi FMS Software 8.3 Error Recovery For descriptions of the error messages generated by these conditions, see the VMS documentation on system messages, recovery procedures, and software installation. If you are notified that any of these conditions exists, you should take the appropriate action as described in the message. (You might need to change a system parameter or increase an authorized quota value.) For information on installation requirements, see Chapter 7. 8-12 Installing Hanzi FMS Software 9 ________________________________________________________________ After Installing Hanzi FMS Software After installing Hanzi FMS software, you need to perform the following tasks: o Edit the system startup files. o Set user account quotas. 9.1 Editing the System Files To provide for automatic startup of Hanzi FMS when your system is restarted, you must edit two system files. To edit these startup files, use the following procedure: 1. Add the command line that starts Hanzi FMS to the system startup file, SYS$MANAGER:SYSTARTUP_VMS.COM. Hanzi FMS software cannot start until the network has started. You must put this new command line after the network startup command line. The following example shows the network startup command line followed by the startup command line for Hanzi FMS: $ @SYS$MANAGER:STARTNET.COM . . . $ @SYS$STARTUP:CFMSTARTUP.COM 2. The CFMS start-up command procedure contains several VMS commands. The first command assigns the logical name CFMS$EXAMPLES to the directory that contains the sample application programs for DEC FMS/Hanzi Version 2.4. After Installing Hanzi FMS Software 9-1 After Installing Hanzi FMS Software 9.1 Editing the System Files The last commands in the command procedure install CFDVSHR and CFDVMSG as known shared images. To improve the performance of CFMS application programs, you can remove the following line from CFMSTARTUP.COM: $ EXIT ! Remove this line to install the images If you have made any changes to the CFMSTARTUP.COM file, use the SHUTDOWN procedure to stop the current system, and restart the system. 9.2 User Account Requirements To work with Hanzi FMS, user accounts on your system must have at least the TMPMBX privilege. The accounts must also have the quotas shown in Table 9-1. Table_9-1_User_Account_Quotas_for_Using_CFMS_Software_____ Account_Quota_________Value_______________________________ ASTLM 24 BIOLM 18 DIOLM 18 ENQLM 30 FILLM_________________20__________________________________ User account privileges and quotas are stored in the file SYSUAF.DAT. To verify and change user account quotas, use the VMS Authorize Utility. For more information on modifying account privileges and quotas, see the description of the Authorize Utility in the System Management Utilities Reference Manaul 9.3 Running the IVP When CFMS is installed, the IVP is automatically placed in the following location: SYS$SYSDEVICE:[SYS$TEST.CFMS]CFMS$IVP.COM. The IVP is placed there even if you have chosen not to run it at installation time. 9-2 After Installing Hanzi FMS Software After Installing Hanzi FMS Software 9.3 Running the IVP You can run the IVP at any time after CFMS has been installed by entering the following command: @SYS$SYSDEVICE:[SYS$TEST.CFMS]CFMS$IVP 9.4 Special Requirements To prevent data loss, users should set their terminals to HOSTSYNC and TYPAHEAD before using Hanzi FMS software. For more information, see the online release notes. 9.5 Enhancing Hanzi FMS Performance This section includes information on system tuning and explains how to install Hanzi FMS as a shared image. The Form Driver for DEC FMS/Hanzi Version 2.4 is built as a shared image. If several users who run Hanzi FMS applications at the same time are on your system, each user has a copy of the Form Driver in memory. If you install the Form Driver as a known shared image, the users share a single copy of the Form Driver in memory when Hanzi FMS applications are run. A known shared image reduces memory requirements and can improve system performance. To install Hanzi FMS as a known shared image on a system that is currently running, use the VMS Install Utility (INSTALL). It is recommended that you perform the install operation on a system that has just been started because the available space in the global page table is less likely to be fragmented. To install Hanzi FMS as a shared image, use the following procedure: 1. Determine the number of available global pagelets and global sections on your system. Refer to System Manager's Manual for information on how to verify and modify the number of global pagelets and global sections. Table 7-3 contains the required values for these parameters. After Installing Hanzi FMS Software 9-3 After Installing Hanzi FMS Software 9.5 Enhancing Hanzi FMS Performance 2. Once you have reset the system parameter values, invoke the VMS Install Utility from a privileged account and install Hanzi FMS as a shared image, as follows: $ INSTALL INSTALL> ADD SYS$SHARE:CFDVSHR.EXE /OPEN /SHARED INSTALL> ADD SYS$MESSAGE:CFDVMSG.EXE /OPEN /SHARED INSTALL> ADD SYS$MESSAGE:CFDVMSGE.EXE /OPEN /SHARED INSTALL> EXIT 3. Add the following lines to the appropriate system startup command file so that each time the system is started, Hanzi FMS software is available as a shared image. (If your site has modularized its startup procedures, be sure you add the lines to the correct file. The default startup command file for VMS Alpha Version 6.1 operating system is SYS$MANAGER:SYSTARTUP_VMS.COM.) $RUN SYS$SYSTEM:INSTALL SYS$SHARE:CFDVSHR /OPEN /SHARED SYS$MESSAGE:CFDVMSG /OPEN /SHARED SYS$MESSAGE:CFDVMSGE /OPEN /SHARED 4. When you install Hanzi FMS as a shared image, you need to increase the global pagelets (GBLPAGES) by 250 and global sections (GBLSECTIONS) by 4. Refer to System Manager's Manual for information on changing these parameters. 9.6 Determining and Reporting Problems If an error occurs while Hanzi FMS is being used and you believe that the error is caused by a problem with Hanzi FMS, call your Customer Support Center. 9-4 After Installing Hanzi FMS Software 10 ________________________________________________________________ Verifying the Form Editor and Form Tester Because of their interactive nature, the Form Editor and the Form Tester must be tested manually on a VT382 Hanzi- compatible terminal. The following procedure verifies the installation of the Form Editor and the Form Tester. 1. Log in using a VT382 Hanzi-compatible terminal. 2. Enter the SET TERMINAL/INQUIRE command to request a response sequence from your terminal, as follows: $ SET TERMINAL/INQUIRE 3. Create a form to test the Form Editor. To create a form, specify the name of a file that does not exist in the current directory. (In this example, the file is called testfile.frm.) The default file type is .FRM. For example: $ CFMS/EDIT testfile.frm 4. Select a Form Editor Menu option. After you have entered the Form Editor, select LAYOUT at the Phase Choice prompt. The screen is cleared and the Layout Phase status line appears at the bottom of your screen. Phase Choice: LAYOUT 5. Enter text into your form. For example: This is a test of CFMS. To enter field mode, press the PF1 key and then the keypad 8 key. Type the letter x six times to indicate a field. For example: XXXXXX Verifying the Form Editor and Form Tester 10-1 Verifying the Form Editor and Form Tester 6. Exit the Form Editor. Press the PF1 key and the keypad 7 key to exit the Layout Phase of the Form Editor. The Form Editor Menu reappears; at the prompt, type EXIT and press RETURN. Phase Choice: EXIT 7. Save the form. After you have exited Layout Phase, the Editor prompts you to save the file. Press RETURN to save the form. $ Do you want to save this form? %FMS-I-FORMSAVED, Form testfile.frm saved in testfile.frm 8. Test the form, as follows: $ CFMS/TEST testfile.frm Hanzi FMS displays your form. Type any 4 Hanzi characters. The fourth character does not echo on the screen. The terminal bell rings and an error message indicating that the field is full is displayed at the bottom of your terminal screen. Press RETURN. The system prompt is displayed. 123456 $ 9. Delete the form file, as follows: $ DELETE testfile.frm;* The test is complete. If any errors have occurred during the test, follow the instructions in Section 8.3. 10-2 Verifying the Form Editor and Form Tester A ________________________________________________________________ CFMS Sample Installation This appendix contains sample installations of Hanzi FMS software. These samples have been run on a system that has no previous version of Hanzi FMS installed. The sample installation assumes that DECnet has been shut down, that no users are logged in to your system, and that OPTIONS N is specified to print the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation. $ SET DEF SYS$UPDATE $ @VMSINSTAL OpenVMS ALPHA Software Product Installation Procedure V6.1-1H1 It is 29-NOV-1995 at 17:35. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? YES * Where will the distribution volumes be mounted: DKA400: Enter the products to be processed from the first distribution volume set. * Products: CFMS024 * Options: N Please mount the first volume of the set on DKA400:. * Are you ready? YES %MOUNT-I-MOUNTED, DECCFMS mounted on DKA400: The following products will be processed: CFMS V2.4 Beginning installation of CFMS V2.4 at 17:37 %VMSINSTAL-I-RESTORE, Restoring product saveset A ... Release Notes Options: CFMS Sample Installation A-1 CFMS Sample Installation 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. Copy release notes to SYS$HELP 5. Do not display, print or copy release notes * Select option [2]: 4 * Do you want to continue the installation? YES %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. This is a special FMS/Hanzi kit which comes with ALL-IN-1/Hanzi kit and requires ALLIN1-UI-HANZI license to operate. Product: ALLIN1-UI-HANZI Producer: DEC Version: 3.2 Release Date: 17-OCT-1995 * Does this product have an authorization key registered and loaded? YES * Do you want to run the IVP after the installation [YES]? YES * Do you want to purge files replaced by this installation [YES]? YES If you wish to save space on your system disk you may choose not to install the Sample Application Programs and the Modifiable Message File Procedures. You may later install them by installing CFMS V2.4 again. * Do you wish to install Sample Application Programs and Modifiable Message File Procedures [YES]? %VMSINSTAL-I-RESTORE, Restoring product saveset B ... %VMSINSTAL-I-RESTORE, Restoring product saveset C ... %VMSINSTAL-I-RESTORE, Restoring product saveset D ... %CFMS-I-CONTINUE, All inquiries have been requested. If no errors occur, -CFMS-I-CONTINUE, the installation will be completed in about 20 minutes. %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.CFMS]. A-2 CFMS Sample Installation CFMS Sample Installation If you intend to execute this layered product on other nodes in your VAXcluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.CFMS] System Manager: Upon completion of this installation, please be sure to edit the system startup files as described in the Hanzi FMS Installation Guide. %CFMS-S-FMSBUILT, CFMS V2.4 has built successfully, continuing... %CFMS-I-STARTSAMP, Starting the Sample Application Programs installation... %CFMS-S-SAMPBUILT, Sample Application Programs have built successfully, continuing... %CFMS-I-CONTINUE, Starting Modifiable Message File Procedures installation ... %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.CFMS.MESSAGE]. If you intend to execute this layered product on other nodes in your VAXcluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.CFMS.MESSAGE] /PROT=(S:RWED,O,G,W) %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Beginning the CFMS V2.4 Installation Verification Procedure... CFMS V2.4 Installation Verification Procedure was successful Refer to the Hanzi FMS Installation Guide for further verification procedures... Installation of CFMS V2.4 completed at 17:54 CFMS Sample Installation A-3 CFMS Sample Installation Enter the products to be processed from the next distribution volume set. * Products: EXIT VMSINSTAL procedure done at 17:55 $ A-4 CFMS Sample Installation B ________________________________________________________________ CFMS Related Files Installed on Your System The following is a list of files added, replaced, or modified on your system by the installation of DEC FMS /Hanzi Version 2.4 software. __________________________________________________________ File_Name________Function_________________________________ ___________________[SYSHLP]_(SYS$HELP)____________________ HELPLIB.HLB Module CFMS (English version) added or replaced in help library DECFMS024.RELEASEOnline release notes for DEC FMS Version NOTES 2.4 __________________________________________________________ ______________________[SYSHLP.HANZI]______________________ HELPLIB.HLB Module CFMS (Hanzi version) added or replaced in help library __________________________________________________________ __________________[SYSEXE]_(SYS$SYSTEM)___________________ CFMSFAA.EXE CFMS Form Application Aids Utility CFMSFED.EXE CFMS Form Editor Utility CFMSFLG.EXE CFMS Form Language Translator Utility CFMSFLI.EXE CFMS Form Librarian Utility CFMSFTE.EXE CFMS Form Tester Utility CFMSFUU.EXE CFMS Form Upgrade Utility __________________________________________________________ ___________________[SYSLIB]_(SYS$SHARE)___________________ CFDVSHR.EXE Form Driver shareable image CFMS Related Files Installed on Your System B-1 CFMS Related Files Installed on Your System __________________________________________________________ File_Name________Function_________________________________ __________________[SYSLIB]_(SYS$LIBRARY)__________________ DCLTABLES.EXE DCL command CFMS added or replaced in DCL tables HLL11.OBJ PDP-11 compatibility high level language interface HSYIMGLIB.OLB Module HFDVSHR added or replaced in library HSYOBJLIB.OLB Module FDV$PLITRM added or replaced in library __________________________________________________________ __________________[SYSMGR]_(SYS$MANAGER)__________________ CFMSTARTUP.COM CFMS startup procedure for full development kit CFDVSTRTUP.COM CFMS startup procedure for run-time kit __________________________________________________________ __________________[SYSMGR]_(SYS$MESSAGE)__________________ CFDVMSG.EXE Form Driver message file (Hanzi) CFDVMSGE.EXE Form Driver message file (English) CFMSMSG.EXE CFMS utilities message file (Hanzi) CFDVMSGE.EXE CFMS utilities message file (English) B-2 CFMS Related Files Installed on Your System CFMS Related Files Installed on Your System __________________________________________________________ __________________________________________________________ __________[SYSHLP.EXAMPLES.CFMS]_(CFMS$EXAMPLES)__________ FDVDEF.BAS Form Driver symbol definition file for BASIC FDVDEF.FOR Form Driver symbol definition file for FORTRAN FDVDEF.H Form Driver symbol definition file for C FDVDEF.LIB Form Driver symbol definition file for COBOL FDVDEF.PAS Form Driver symbol definition file for PASCAL FDVDEF.REQ Form Driver symbol definition file for BLISS FDVDEFCAL.PLI Form Driver symbol definition file for PL/I FDVDEFFNC.PLI Form Driver symbol definition file for PL/I MESSAGE.DIR Directory for modifiable message _________________procedures_______________________________ In addition, if the system manager has requested the sample application programs to be installed, the following files also exist. __________________________________________________________ File_Name________Function_________________________________ __________[SYSHLP.EXAMPLES.CFMS]_(CFMS$EXAMPLES)__________ BISYNC_ Sample application REGISTER form to be REGIST.FRM used with bisync terminals LONG_REGIST.FRM Sample application REGISTER form to be used with MicroVAX workstations SAMP.BAS BASIC sample application source SAMP.DAT Sample application data file SAMP.EXE BASIC sample application executable image SAMP.FLB Sample application form library CFMS Related Files Installed on Your System B-3 CFMS Related Files Installed on Your System __________________________________________________________ File_Name________Function_________________________________ __________[SYSHLP.EXAMPLES.CFMS]_(CFMS$EXAMPLES)__________ SAMPBAS.COM BASIC sample application build procedure SAMPBLI.BLI BLISS sample application source SAMPBLI.COM BLISS sample application build procedure SAMPBLI.EXE BLISS sample application executable image[1] SAMPCC.C C sample application source SAMPCC.COM C sample application build procedure SAMPCC.EXE C sample application executable image[1] SAMPCOB.COB COBOL sample application source SAMPCOB.COM COBOL sample application build procedure SAMPCOB.EXE COBOL sample application executable image[1] SAMPCOB.LIB COBOL sample application library SAMPFOR.COM FORTRAN sample application build procedure SAMPFOR.FOR FORTRAN sample application source SAMPFOR.EXE FORTRAN sample application executable image[1] SAMPPAS.COM PASCAL sample application build procedure SAMPPAS.EXE PASCAL sample application executable image[1] SAMPPAS.PAS PASCAL sample application source SAMPPLI.COM PL/I sample application build procedure SAMPPLI.EXE PL/I sample application executable image[1] SAMPPLI.PLI PL/I sample application source SMPACCOM.FOR FORTRAN sample application include file SMPCOBUAR.LIB COBOL sample application library SMPMEMRES.OBJ Memory resident form module for the sample applications [1]Present_only_if_the_language_is_available_on_the_______ system. B-4 CFMS Related Files Installed on Your System CFMS Related Files Installed on Your System __________________________________________________________ File_Name________Function_________________________________ __________[SYSHLP.EXAMPLES.CFMS]_(CFMS$EXAMPLES)__________ SMPREGCOM.FOR FORTRAN sample application include file SMPSTATUS.FOR FORTRAN sample application include file SMPVECTOR.OBJ UAR vector module for the sample applications SMPWORK.FOR FORTRAN sample application include file __________________________________________________________ ______________[SYSHLP.EXAMPLES.CFMS.MESSAGE]______________ CCOMMSG.MSG Hanzi message file common to all CFMS utilities FAAMSG.MSG Form application aids message file FCVMSG.MSG Form converter message file CFDVMSG.MSG Hanzi Form driver message file CFEDMSG.MSG Hanzi Form editor message file FIOMSG.MSG File I/O message file FLGMSG.MSG Form language translator message file FLIMSG.MSG Form librarian message file FMSLIT.MSG Hanzi FMS message file literals CFMS_ Guide to modifying Hanzi FMS message MESSAGE.MEM files FTEMSG.MSG Form Tester message file FUUMSG.MSG Form Upgrade Utility message file HMSGBLD.COM______Hanzi_Message_file_build_procedure_______ CFMS Related Files Installed on Your System B-5