DEC FMS/Hangul for OpenVMS AXP Installation Guide and Release Notes Order Number: AA-Q3S7A-TE December 1993 Hangul Forms Management System (HFMS) is a character-cell based forms management system for interactive applications that use video forms as the user interface. HFMS [TM] provides application programmers with a set of development tools to create and maintain forms-based user interfaces and a run-time system for displaying and managing the application's user interface at execution time. All references to VMS [TM] systems and OpenVMS [TM] systems refer to OpenVMS/Hangul Alpha AXP[TM] systems unless otherwise specified. Software Version: DEC FMS/Hangul Version 2.4 Operating System: OpenVMS/Hangul AXP Version 1.5 Note: For new features, enhancements, bug fixes and restrictions that are common to DEC FMS V2.4, please refer to DEC FMS V2.4 Release Notes. Digital Equipment Corporation Asia Region ________________________ December 1993 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. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. © Digital Equipment Korea Incorporated 1993 All rights reserved Printed in Korea The postpaid Reader's Comments forms at the end of this document request your critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: ALL-IN-1, Alpha AXP, CDD, CDD/Plus, DEC, Hangul FMS, Microvax, OpenVMS, VAX, VAXstation, VMS, VT, VT100, VT200, and the DIGITAL logo. ZK4798 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. ii __________________________________________________________ Contents _____________________________________________________ PREFACE vii __________________________________________________________ CHAPTER 1 PREPARING TO INSTALL HANGUL FMS SOFTWARE 1-1 _____________________________________________________ 1.1 REQUIRED OPERATING SYSTEM COMPONENTS 1-1 _____________________________________________________ 1.2 PREREQUISITE AND OPTIONAL SOFTWARE 1-2 _____________________________________________________ 1.3 PREREQUISITE HARDWARE 1-2 _____________________________________________________ 1.4 LICENSE REGISTRATION 1-2 _____________________________________________________ 1.5 INSTALLATION PROCEDURE REQUIREMENTS 1-3 1.5.1Restrictions _______________________ 1-3 1.5.2Time _______________________________ 1-4 1.5.3Privileges _________________________ 1-4 1.5.4Disk Space _________________________ 1-4 1.5.5System Parameters __________________ 1-5 1.5.5.1 Checking System Parameter Values o 1-6 1.5.5.2 Calculating the Values for GBLPAGES and GBLSECTIONS o 1-7 1.5.5.3 Changing System Parameter Values with AUTOGEN o 1-8 1.5.6Process Account Quotas _____________ 1-9 1.5.7VMSINSTAL Requirements _____________ 1-11 1.5.8Backing Up Your System Disk ________ 1-12 iii Contents __________________________________________________________ CHAPTER 2 INSTALLING HANGUL FMS SOFTWARE 2-1 _____________________________________________________ 2.1 GENERAL INFORMATION 2-1 2.1.1Accessing the Online Release Notes _ 2-1 2.1.2Determining the Files and Logical Names Added to the System __________ 2-2 2.1.3Running the Installation Verification Procedure __________________________ 2-2 2.1.4Ending the Installation Abnormally _ 2-2 _____________________________________________________ 2.2 INSTALLATION PROCEDURE 2-3 2.2.1Invoking VMSINSTAL _________________ 2-3 2.2.2Answering Installation Questions ___ 2-4 2.2.3Informational Messages _____________ 2-10 2.2.4Running the Installation Verification Procedure __________________________ 2-11 2.2.5Completing the Installation Procedure __________________________ 2-11 _____________________________________________________ 2.3 ERROR RECOVERY 2-12 __________________________________________________________ CHAPTER 3 AFTER INSTALLING HANGUL FMS SOFTWARE 3-1 _____________________________________________________ 3.1 EDITING THE SYSTEM FILES 3-1 _____________________________________________________ 3.2 USER ACCOUNT REQUIREMENTS 3-2 _____________________________________________________ 3.3 RUNNING THE IVP 3-3 _____________________________________________________ 3.4 SPECIAL REQUIREMENTS 3-3 _____________________________________________________ 3.5 ENHANCING HANGUL FMS PERFORMANCE 3-4 _____________________________________________________ 3.6 DETERMINING AND REPORTING PROBLEMS 3-5 iv Contents __________________________________________________________ CHAPTER 4 VERIFYING THE FORM EDITOR AND FORM TESTER 4-1 __________________________________________________________ CHAPTER 5 DEC FMS/HANGUL FOR OPENVMS AXP VERSION 2.4 RELEASE NOTES 5-1 _____________________________________________________ 5.1 FEATURES IN DEC FMS/HANGUL V2.4 5-1 5.1.1Hangul Form Editor _________________ 5-1 5.1.2Hangul Form Driver _________________ 5-3 _____________________________________________________ 5.2 HANGUL FORM LANGUAGE TRANSLATOR 5-4 _____________________________________________________ 5.3 RESTRICTIONS FOR DEC FMS/HANGUL V2.4 5-4 5.3.1Hangul error messages ______________ 5-4 5.3.2Alphanumeric, alphabet and numeric fields _____________________________ 5-4 5.3.3Multinational character support ____ 5-5 5.3.4Long form support __________________ 5-5 5.3.5LN03 and LN03 Plus printer image ___ 5-5 5.3.6Cursor Positioning using Hangul Form Driver Call (FDV$AFCX) _____________ 5-5 _____________________________________________________ 5.4 FORM MIGRATION FROM HANGUL FMS VAX TO HANGUL FMS AXP 5-5 _____________________________________________________ 5.5 MODIFICATION OF HANGUL FMS MESSAGES 5-6 _____________________________________________________ 5.6 LMF SUPPORT 5-6 __________________________________________________________ APPENDIX A SAMPLE INSTALLATION A-1 _____________________________________________________ A.1 FULL DEVELOPMENT KIT A-1 _____________________________________________________ A.2 RUN-TIME KIT A-4 v Contents __________________________________________________________ APPENDIX B USING THE SAMPLE APPLICATIONS PROGRAMS B-1 _____________________________________________________ B.1 FILES ASSOCIATED WITH THE SAMPLE APPLICATION PROGRAMS B-2 _____________________________________________________ B.2 RUNNING THE SAMPLE APPLICATION ON BISYNCHRONOUS TERMINALS B-4 __________________________________________________________ APPENDIX C FILES INSTALLED ON YOUR SYSTEM C-1 __________________________________________________________ TABLES 1-1 Disk Space Requirements _________________ 1-5 1-2 Required System Parameter Values ________ 1-6 1-3 Process Account Quotas for the Installing Account _________________________________ 1-10 3-1 User Account Quotas for Using Hangul FMS Software ________________________________ 3-2 B-1 FMS Sample Application Programs _________ B-1 B-2 HFMS Definition Files ___________________ B-3 B-3 HFMS Source Files _______________________ B-3 B-4 HFMS Command Files ______________________ B-4 vi __________________________________________________________ Preface This manual describes how to install Hangul Forms Management System (HFMS) for OpenVMS AXP Version 2.4, as well as the features and restrictions of DEC FMS/Hangul for OpenVMS AXP Version 2.4. __________________________________________________________ Who Should Use This Guide This manual is intended for those who install and maintain Hangul FMS software. You should read this manual before installing Hangul FMS software. To install Hangul 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 Hangul-series terminal or one that is VT100-compatible. __________________________________________________________ Structure of This Guide This manual contains four chapters and three appendices: Chapter 1 describes the preparations and requirements necessary for installing Hangul FMS software. Chapter 2 describes the Hangul FMS installation procedure. Chapter 3 describes the tasks to perform after installing Hangul FMS software. Chapter 4 describes the postinstallation IVP. Chapter 5 describes the features and restrictions of DEC FMS/Hangul Version 2.4. vii Preface Appendix A reproduces typical installation and IVP sessions. Appendix B describes the optional sample application programs available with Hangul FMS software. Appendix C details the files that are installed or modified. __________________________________________________________ For More Information For additional information on installing Hangul FMS software, refer to the VMS system documentation for these topics: o VMSINSTAL procedure o INSTALL Utility o System management and operations See the following documents for more information about Hangul FMS software: o FMS for OpenVMS Systems Mini-Reference Provides quick reference information on FMS utilities, commands and qualifiers, attributes, key functions, and so on. o FMS for OpenVMS Systems Language Interface Manual Describes language interface issues for FMS (Forms Management System) application programs. Languages discussed include BASIC, BLISS-32, C, COBOL, FORTRAN, PASCAL, and PL/I. Language- independent information is also provided for programmers writing in languages not documented in this manual. o FMS for OpenVMS Systems Introduction Introduces the FMS (Forms Management System). Examples from the Sample Application Program show how to create and run an FMS program. viii Preface o FMS for OpenVMS Systems Utilities Reference Manual Describes the FMS (Forms Management System) utilities, invoked through DCL commands, used to create and manage forms and form libraries. o FMS for OpenVMS Systems Form Driver Reference Manual Describes how the Form Driver component of the Forms Management System (FMS) works on the OpenVMS operating system. It provides language- independent information required to design forms and to develop programs that use FMS forms for gathering and displaying data. o VAX Hangul FMS V2.3 User Guide __________________________________________________________ Conventions This following conventions are used in this guide: Ctrl/X In procedures, a sequence such as Ctrl/X indicates that you must hold down the key labeled Ctrl while you press another key. KPn Key names that begin with KP indicate keys on the numeric keypad on the right side of the terminal keyboard. For example, KP4 and KP. are keys on the numeric keypad. PF1-X A sequence such as PF1-X indicates that you must first press and release the key labeled PF1, and then press and release another key. . . . In examples, a horizontal ellipsis indicates one of the following possibilities: ix Preface * Additional optional arguments in a statement have been omitted. * The preceding item or items can be repeated one or more times. * Additional parameters, values, or other information can be entered. . A vertical ellipsis indicates . the omission of items from a . code example or command format; the items are omitted because they are not important to the topic being discussed. () In format descriptions, parentheses indicate that, if you choose more than one option, you must enclose the choices in parentheses. [] In format descriptions, brackets indicate that whatever is enclosed is optional; you can select none, one, or all of the choices. {} In format descriptions, braces surround a required choice of options; you must choose one of the options listed. user input For online versions, user input is shown in bold. $ The default user prompt is your system name followed by a right angle bracket (>).The dollar sign is used to indicate the DCL prompt on VMS systems. This prompt might be different on your system. x Preface UPPERCASE Literal strings that appear in text, examples, syntax descriptions, and function descriptions must be typed exactly as shown. lowercase In commands and examples, indicates variables for which the user is to substitute a word or value. - A hyphen is used to connect multiword names that describe a single item, as in input-file. All references to VMS systems and OpenVMS systems refer to OpenVMS/Hangul Alpha AXP systems unless otherwise specified. xi __________________________________________________ 1 Preparing to Install Hangul FMS Software This chapter discusses the preparations and requirements necessary to install Hangul FMS software. This manual applies to DEC FMS/Hangul Version 2.4 and all subsequent maintenance releases up to the next major product release. Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Digital representative. Hangul FMS provides online release notes. You can read and print the release notes before the Hangul 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. __________________________________________________________ 1.1 Required Operating System Components Hangul FMS supports the following AXP VMS Version 1.5 classes: o VMS required saveset o Programming support o Utilities 1-1 Preparing to Install Hangul FMS Software __________________________________________________________ 1.2 Prerequisite and Optional Software This section discusses the software you must have installed on your system before installing Hangul FMS software. The section also includes information about software that you can use together with Hangul FMS software. Refer to the System Software Addendum (SSA) for a complete list of compatible products and their required version numbers. The SSA is part of the Software Product Description (SPD). DEC FMS/Hangul Version 2.4 requires OpenVMS /Hangul for AXP Version 1.5 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 Hangul FMS. CDDSHR.EXE must always be installed using the Install Utility (see Section 1.5.5.2). __________________________________________________________ 1.3 Prerequisite Hardware To run the IVP, you must have a video terminal. See Chapter 4 for more information on the postinstallation IVP. __________________________________________________________ 1.4 License Registration The VMS License Management Facility (LMF) is available with OpenVMS/Hangul AXP Version 1.5 operating system. If you are installing Hangul FMS on a OpenVMS/Hangul AXP Version 1.5 system, you must register your software license. [1] _________________ [1] Hangul FMS software can be installed without registering the HFMS license. However, the IVP is not executed without a license registration. In addition, the HFMS utilities and applications using the Form Driver are not run until a license is properly registered. 1-2 Preparing to Install Hangul FMS Software The license registration information you need is contained in the Product Authorization Key (PAK) that is shipped with Hangul FMS. 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 Hangul FMS license and loaded the appropriate authorization key. You must register and load your license for Hangul FMS before you start the installation in order to run the IVP and use the software. To register a license under the AXP VMS operating system Version 1.5 or higher, first log in to the system manager's account, SYSTEM. You then have a choice of two ways to perform the registration: o Run the SYS$UPDATE:VMSLICENSE.COM procedure. When the procedure prompts you for information, respond with data from your Product Authorization Key (PAK). o Enter the DCL command LICENSE REGISTER with the qualifiers that correspond to information on the PAK. o For complete information on using LMF, see the manual on the License Management Utility in the VMS documentation set. __________________________________________________________ 1.5 Installation Procedure Requirements The following sections discuss various requirements for installing Hangul FMS software. _____________________________ 1.5.1 Restrictions No users should be logged in to the system while you are installing Hangul FMS software. You can use the REPLY command to send a message to users. For example: 1-3 Preparing to Install Hangul FMS Software $ REPLY/ALL "Please log off now. Installing HFMS." 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.5.2 Time The installation takes approximately 15 to 60 minutes, depending on the type of media and your system configuration. _____________________________ 1.5.3 Privileges To install Hangul 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. _____________________________ 1.5.4 Disk Space Installing Hangul FMS requires a certain amount of free disk space during the installation. Once Hangul FMS is installed, less storage space is required. Table 1-1 summarizes the storage requirements. 1-4 Preparing to Install Hangul FMS Software __________________________________________________________ Table 1-1 Disk Space Requirements __________________________________________________ Blocks During Blocks After kit___________________Installation__Installation__ DEC FMS/Hangul 3000 2650 Version 2.4 Hangul 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 _____________________________ 1.5.5 System Parameters The following sections show you how to check system parameter values, calculate values for the GBLPAGES and GBLSECTIONS system parameters, and change parameter values with the VMS AUTOGEN command procedure. Installing Hangul FMS requires certain system parameter settings. Table 1-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. 1-5 Preparing to Install Hangul FMS Software __________________________________________________________ Table 1-2 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 Hangul FMS software, you must raise those values by the number indicated. (See Section 1.5.5.2.) __________________________________________________________ _____________________________ 1.5.5.1 Checking System Parameter Values To check the values of your system parameters, use the following procedure: 1 Enter the following command to invoke the System Generation Utility: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> 2 At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The values displayed should equal or exceed the value of each parameter listed in Table 1-2. The following command displays the value for the GBLPAGES system parameter: SYSGEN> SHOW GBLPAGES After you finish checking the parameters with the SHOW command, you can enter the EXIT command at the SYSGEN> prompt to return to DCL level. 1-6 Preparing to Install Hangul FMS Software _____________________________ 1.5.5.2 Calculating the Values for GBLPAGES and GBLSECTIONS To install and run Hangul FMS software, you must set the correct values for the GBLPAGES and GBLSECTIONS system parameters. The n variable shown in Table 1-2 represents the current number of unused global pagelets or global sections available on your system. For the installation to execute successfully, you must raise these values by the amount indicated. To calculate the number of unused global pagelets and global sections on your system, use the following procedure: 1 Run the VMS Install Utility (INSTALL) using the following command: $ INSTALL LIST /GLOBAL /SUMMARY The Install Utility displays a summary of global pagelets and global sections used by your system, as well as the current number of unused global pagelets. For example: Summary of Local Memory Global Sections 258 Global Sections Used,22580/3420 Global Pagelets Used/Unused 2 Determine if the number of unused global pagelets (3420 in the example) is equal to or greater than 250. If the number of unused pagelets is less than 250, you need to increase the value for GBLPAGES. 3 Note the amount shown for Global Sections Used (258 in the example). 4 Run the System Generation Utility and use the SHOW command to determine how many global sections have been allocated. For example: 1-7 Preparing to Install Hangul FMS Software $ RUN SYS$SYSTEM:SYSGEN SYSGEN> SHOW GBLSECTIONS Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- GBLSECTIONS 512 250 20 4095 Sections 5 Subtract the amount shown in the summary (258 in the example) from the amount allocated. If the difference is less than 4, you need to increase the value of the GBLSECTIONS parameter. Section 1.5.5.3 describes the procedures for increasing these values as well as those of other system parameters. Refer to the VMS documentation on system management and operations for more information. _____________________________ 1.5.5.3 Changing System Parameter Values with AUTOGEN You use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the ones you reset manually. To change system parameters with AUTOGEN, use the following procedure: 1 Edit the the following file: SYS$SYSTEM:MODPARAMS.DAT Use an editor to access the file. If you need to change a parameter value in the SYS$SYSTEM:MODPARAMS.DAT file, delete the current value associated with that parameter and enter the new value. To add a new value, add a line to the MODPARAMS.DAT file. The line contains the name of the parameter and its value. For example: GBLSECTIONS = 128 1-8 Preparing to Install Hangul FMS Software You also can modify incremental parameters in the MODPARAMS.DAT file. The following example increases the global page setting by 2000: ADD_GBLPAGES = 2000 2 After you have made all your changes, run the AUTOGEN procedure to recalculate your system parameters. Enter the following command: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT AUTOGEN performs an automatic system shutdown and restarts when it has finished. Restarting your system activates the new parameter values. When you restart a system under VMS AXP operating system Version 1.5, the Autogen Utility automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the /NOFEEDBACK qualifier on the AUTOGEN command line. For more information about using AUTOGEN, see the instructions on modifying system parameters in the VMS documentation on system management and operations. _____________________________ 1.5.6 Process Account Quotas The account you use to install Hangul FMS software must have sufficient quotas to enable you to perform the installation. Table 1-3 summarizes the process quotas required for the installation account. 1-9 Preparing to Install Hangul FMS Software __________________________________________________________ Table 1-3 Process Account Quotas for the Installing Account __________________________________________________ Account_Quota_________Value_______________________ ASTLM 24 BIOLM 18 BYTLM 18,000 DIOLM 18 ENQLM 30 ________FILLM_________________20__________________________ User account quotas are stored in the file SYSUAF.DAT. You use the VMS Authorize Utility to verify and change user account quotas. To verify and change user account quotas, use the following procedure: 1 Set your directory to SYS$SYSTEM and run AUTHORIZE as follows: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> 2 At the Authorize Utility prompt (UAF>), use the SHOW command with an account name to check a particular account. For example: UAF> SHOW SMITH 3 To change a quota, use the MODIFY command at the UAF> prompt. MODIFY has the following format: MODIFY account-name /quota-name=nnnn The following example changes the FILLM quota for the SMITH account and then exits from the Authorize Utility: UAF> MODIFY SMITH /FILLM=50 UAF> EXIT 1-10 Preparing to Install Hangul FMS Software After you exit from the utility, the VMS system displays messages indicating whether or not changes were made. Once the changes have been made, you must log out and log in again for the new quotas to take effect. For more information on modifying account quotas, see the description of the Authorize Utility in the VMS documentation set. _____________________________ 1.5.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 installation 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 the following quotas: ASTLM = 24 BIOLM = 18 BYTLM = 18,000 DIOLM = 18 ENQLM = 30 FILLM = 20 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. 1-11 Preparing to Install Hangul FMS Software _____________________________ 1.5.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. 1-12 __________________________________________________ 2 Installing Hangul FMS Software This chapter describes how to install Hangul FMS software. Section 2.2 contains a step-by-step description of the installation procedure. __________________________________________________________ 2.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. _____________________________ 2.1.1 Accessing the Online Release Notes Hangul 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 Hangul 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 HFMS RELEASE_NOTES 2-1 Installing Hangul FMS Software _____________________________ 2.1.2 Determining the Files and Logical Names Added to the System Appendix C and Appendix A of the online release notes list the files added, replaced, or modified on your system when Hangul FMS is installed. Hangul FMS adds only one logical name HFMS$EXAMPLES to the system when it is installed. Appendix C as well as Appendix A of the online release notes list the files associated with HFMS$EXAMPLES. _____________________________ 2.1.3 Running the Installation Verification Procedure The IVP for Hangul 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 Hangul FMS is installed correctly. After Hangul 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 Hangul FMS. Because of their interactive nature, the Form Editor and the Form Tester must be tested manually on a VT382 Hangul-compatible terminal. To verify the installation of the Form Editor and Form Tester, see the procedure explained in Chapter 4. _____________________________ 2.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. 2-2 Installing Hangul FMS Software __________________________________________________________ 2.2 Installation Procedure The Hangul 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. _____________________________ 2.2.1 Invoking VMSINSTAL To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. 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 Hangul FMS software, use the following installation name: HFMS024 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 2-3 Installing Hangul FMS Software The following example displays the command that invokes VMSINSTAL to install Hangul FMS from CD- ROM drive DKA400: and shows the system response. This example uses the OPTIONS N parameter. $ @SYS$UPDATE:VMSINSTAL HFMS024 DKA400: OPTIONS N OpenVMS ALPHA Software Product Installation Procedure V1.5-1H1 It is 14-NOV-1992 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. _____________________________ 2.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. 2-4 Installing Hangul FMS Software 1 Shut down DECnet. %VMSINSTAL-W-DECNET, Your DECnet network is up and running. . . . * Do you want to continue anyway [NO]? You should install Hangul 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, DECHFMS MOUNTED ON _$$DKA400: The following products will be processed: HFMS V2.4 Beginning installation of HFMS 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. 2-5 Installing Hangul FMS Software If you respond YES to indicate that you are ready, VMSINSTAL displays a message that the media containing Hangul FMS has been mounted on the specified device and that the installation has begun. 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. 2-6 Installing Hangul FMS Software 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 Hangul FMS are copied to the SYS$HELP directory. Select option 5 if you have already reviewed the release notes. 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 2-7 Installing Hangul FMS Software 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 Hangul FMS software. 6 Register your license. Product: FMS-UI-HANGUL Producer: DEC Version: 2.4 Release Date: 14-NOV-1988 * Does this product have an authorization key registered and loaded? The installation procedure displays license information about your product and then asks if you have registered and loaded your authorization key for Hangul FMS. If you have not registered and loaded your authorization 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 Hangul FMS software checks to be sure that the installation is successful. It is recommended that you run the IVP. 8 Purge files. * Do you want to purge files replaced by this installation dir[YES]? 2-8 Installing Hangul FMS Software You have the option to purge files from previous versions of Hangul 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 Hangul FMS modifiable message files and sample applications are installed. The sample application programs are used throughout the Hangul FMS documentation as examples of Hangul FMS programming techniques. The files relating to the sample applications are found in the HFMS$EXAMPLES: directory and are listed in Appendix C. The Hangul FMS installation and start-up procedure (SYS$STARTUP:HFMSTARTUP.COM) defines a system logical for the HFMS$EXAMPLES: directory. See Appendix A for more detailed information concerning the sample application programs. The Modifiable Message File Procedures create a subdirectory containing the sources for the HFMS Message Files and instructions on how to modify the text of the messages in the HFMS Form Driver and HFMS Utilities. The message files are found in the subdirectory SYS$SYSROOT:[SYSHLP.EXAMPLES.HFMS.MESSAGE]. The instructions for modifying the message files are in the HFMS_MESSAGE.MEM file in that subdirectory. 2-9 Installing Hangul FMS Software _____________________________ 2.2.3 Informational Messages The installation procedure displays a number of informational 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... If the installation procedure is successful, the following files are moved to their target directory: o SYS$SYSTEM:HFMSFAA.EXE o SYS$SYSTEM:HFMSFED.EXE o SYS$SYSTEM:HFMSFLG.EXE o SYS$SYSTEM:HFMSFLI.EXE o SYS$SYSTEM:HFMSFTE.EXE o SYS$SYSTEM:HFMSFUU.EXE In addition, the SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files are updated to include the new version of the Hangul FMS HELP text and the HFMS command line definition, respectively. The Hangul 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 C. 2-10 Installing Hangul FMS Software _____________________________ 2.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 HFMS V2.4 Installation Verification Procedure... If Hangul FMS has been installed, the IVP displays the following message: HFMS V2.4 Installation Verification Procedure was successful Refer to the Hangul FMS Installation Guide for further verification procedures.. You can run the IVP separately any time after Hangul FMS software has been installed. To run the IVP, enter the following command: @SYS$SYSDEVICE:[SYS$TEST.HFMS]HFMS$IVP _____________________________ 2.2.5 Completing the Installation Procedure The following messages indicate that the installation is complete: Installation of HFMS 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-1988 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. 2-11 Installing Hangul FMS Software __________________________________________________________ 2.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 HFMS V2.4 has failed. If the IVP fails, the procedure displays the following messages: The HFMS V2.4 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for HFMS 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. 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 1. 2-12 __________________________________________________ 3 After Installing Hangul FMS Software After installing Hangul FMS software, you need to perform the following tasks: o Edit the system startup files. o Set user account quotas. __________________________________________________________ 3.1 Editing the System Files To provide for automatic startup of Hangul 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 Hangul FMS to the system startup file, SYS$MANAGER:SYSTARTUP_ VMS.COM. Hangul 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 Hangul FMS: $ @SYS$MANAGER:STARTNET.COM . . . $ @SYS$STARTUP:HFMSTARTUP.COM 2 The HFMS start-up command procedure contains several VMS commands. The first command assigns the logical name HFMS$EXAMPLES to the directory that contains the sample application programs for DEC FMS/Hangul Version 2.4. 3-1 After Installing Hangul FMS Software The last commands in the command procedure install HFDVSHR and HFDVMSG as known shared images. To improve the performance of HFMS application programs, you can remove the following line from HFMSTARTUP.COM: $ EXIT ! Remove this line to install the images If you have made any changes to the HFMSTARTUP.COM file, use the SHUTDOWN procedure to stop the current system, and restart the system. __________________________________________________________ 3.2 User Account Requirements To work with Hangul FMS, user accounts on your system must have at least the TMPMBX privilege. The accounts must also have the quotas shown in Table 3-1. __________________________________________________________ Table 3-1 User Account Quotas for Using Hangul FMS 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, as follows: 1 Set your directory to SYS$SYSTEM and run the Authorize Utility: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> 3-2 After Installing Hangul FMS Software 2 At the Authorize Utility prompt (UAF>), enter the SHOW command with an account name to check that particular account. For example: UAF> SHOW SMITH 3 To change a privilege or quota, enter the MODIFY command in the following format. The following example changes the ENQLM quota for the SMITH account and exits the utility: UAF> MODIFY SMITH /ENQLM=50 UAF> EXIT After you exit the utility, the VMS operating system displays messages indicating whether changes have been made. Once you have made the changes, users must log out and log in again for the new quotas to take effect. For more information on modifying account privileges and quotas, see the description of the Authorize Utility in the VMS documentation set. __________________________________________________________ 3.3 Running the IVP When HFMS is installed, the IVP is automatically placed in the following location: SYS$SYSDEVICE:[SYS$TEST.HFMS]HFMS$IVP.COM. The IVP is placed there even if you have chosen not to run it at installation time. You can run the IVP at any time after HFMS has been installed by entering the following command: @SYS$SYSDEVICE:[SYS$TEST.HFMS]HFMS$IVP __________________________________________________________ 3.4 Special Requirements To prevent data loss, users should set their terminals to HOSTSYNC and TYPAHEAD before using Hangul FMS software. For more information, see the online release notes. 3-3 After Installing Hangul FMS Software __________________________________________________________ 3.5 Enhancing Hangul FMS Performance This section includes information on system tuning and explains how to install Hangul FMS as a shared image. The Form Driver for DEC FMS/Hangul Version 2.4 is built as a shared image. If several users who run Hangul 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 Hangul FMS applications are run. A known shared image reduces memory requirements and can improve system performance. To install Hangul 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 Hangul FMS as a shared image, use the following procedure: 1 Determine the number of available global pagelets and global sections on your system. See Section 1.5.5.2 for information on how to verify and modify the number of global pagelets and global sections. Table 1-2 contains the required values for these parameters. 2 Once you have reset the system parameter values, invoke the VMS Install Utility from a privileged account and install Hangul FMS as a shared image, as follows: $ INSTALL INSTALL> ADD SYS$SHARE:HFDVSHR.EXE /OPEN /SHARED INSTALL> ADD SYS$MESSAGE:HFDVMSG.EXE /OPEN /SHARED INSTALL> ADD SYS$MESSAGE:HFDVMSGE.EXE /OPEN /SHARED INSTALL> EXIT 3-4 After Installing Hangul FMS Software 3 Add the following lines to the appropriate system startup command file so that each time the system is started, Hangul 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 AXP Version 1.5 operating system is SYS$MANAGER:SYSTARTUP_VMS.COM.) $RUN SYS$SYSTEM:INSTALL SYS$SHARE:HFDVSHR /OPEN /SHARED SYS$MESSAGE:HFDVMSG /OPEN /SHARED SYS$MESSAGE:HFDVMSGE /OPEN /SHARED 4 When you install Hangul FMS as a shared image, you need to increase the global pagelets (GBLPAGES) by 250 and global sections (GBLSECTIONS) by 4. Refer to Section 1.5.5 for information on changing these parameters. __________________________________________________________ 3.6 Determining and Reporting Problems If an error occurs while Hangul FMS is being used and you believe that the error is caused by a problem with Hangul FMS, take one of the following actions: o If you have a BASIC or DECsupport Software Agreement, call your Customer Support Center. o If you have a Self-Maintenance Software Agreement, submit a Software Performance Report (SPR). o If you purchased Hangul FMS within the past 90 days and you think a software error is causing the problem, submit an SPR. If you find an error in the Hangul FMS documentation, fill out and submit the Reader's Comments form at the back of the document in which you found the error. Include the section and page number of the error. 3-5 __________________________________________________ 4 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 Hangul-compatible terminal. The following procedure verifies the installation of the Form Editor and the Form Tester. 1 Log in using a VT382 Hangul-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: $ HFMS/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 HFMS. 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: 4-1 Verifying the Form Editor and Form Tester XXXXXX 4-2 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: $ HFMS/TEST testfile.frm Hangul FMS displays your form. Type any 4 Hangul 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 2.3. 4-3 __________________________________________________ 5 DEC FMS/Hangul for OpenVMS AXP Version 2.4 Release Notes __________________________________________________________ 5.1 Features in DEC FMS/Hangul V2.4 DEC FMS/Hangul V2.4 provides billingual DCL help. To have Hangul DCL help for HFMS, you need to run HANGULGEN.EXE to set the output option to HANGUL. The following sections describe the DEC FMS /Hangul Version 2.4 new features of different components. _____________________________ 5.1.1 Hangul Form Editor The interactive Hangul Form Editor is used for creating and modifying Hangul and English video forms. In addition to the basic functions of DEC FMS V2.4, DEC FMS/Hangul V2.4 has the following capabilities to handle Hangul characters: 1 Hangul background text In Hangul FMS Form Editor, both Hangul and English characters are supported in OVERSTRIKE and INSERT modes. 2 Hangul character cursor movement The cursor in Hangul Form Editor moves one character at a time, therefore, it never stops at the middle of Hangul characters. 3 Hangul character deletion and undeletion The DELETE function deletes a Hangul or English character and stores it in the character buffer. The UNDELETE function always restores whatever has been most recently deleted. 4 Hangul block select 5-1 DEC FMS/Hangul for OpenVMS AXP Version 2.4 Release Notes A block of Hangul characters can be selected to form a non-rectangular select area. 5 Hangul block cut and paste The CUT and PASTE function can be done to a non-rectangular block of Hangul characters. 6 Hangul block center The CENTER function can center a non- rectangular block of Hangul characters. 7 Video attribute Video attribute can be assigned to a non- rectangular block of Hangul. 8 Dynamic switching of Hangul menu and questionnaires Default Form Editor menu and questionnaires depend on the output option of the terminal. If the HANGULGEN output option is HANGUL, the menu and questionnaires will be in Hangul, whereas they will be in English if the output option is ASCII. However, they can be changed dynamically from Hangul to English (and vice versa) by pressing the GOLD M keys. 9 Hangul error message Form Editor error messages can be in Hangul or in English depending on the HANGULGEN output option. If the output option is HANGUL, the error messages will be in Hangul whereas they will be in English if the output option is in ASCII. Unlike the Form Editor menu, help messages and questionnaires, Form Editor error messages cannot be switched dynamically using the GOLD M keys. To switch the error messages from Hangul to English and vice versa, you have to exit from the Hangul Form Editor to set the output option accordingly. 5-2 DEC FMS/Hangul for OpenVMS AXP Version 2.4 Release Notes _____________________________ 5.1.2 Hangul Form Driver Hangul Form Driver is the run-time component of Hangul FMS which handles terminal input and output, display of forms, manipulation of the screen, basic input validation and formatting, user action routines calling, and terminal operator's requests for help. In handling Hangul data, the Hangul Form Driver has the following capabilities: 1 Hangul character cursor movement within a field The cursor moves each character at a time, therefore, it never stops at the middle of Hangul characters. 2 Hangul data deletion in a field The DELETE key deletes Hangul as well as English characters. 3 Hangul field truncation A Hangul character will be ignored if the field does not have enough space to hold the character. 4 Hangul input and output for fields with mixed picture types and/or field marker characters 5 Hangul error messages Hangul Form Driver error messages can be in Hangul or in English depending on the HANGULGEN output option. If the output option is in HANGUL, the error messages will be in Hangul whereas they will be in English if the output option is in ASCII. In addition, the Hangul Form Driver has been enhanced to handle Hangul input and output efficiently in both OVERSTRIKE and INSERT modes. 5-3 DEC FMS/Hangul for OpenVMS AXP Version 2.4 Release Notes __________________________________________________________ 5.2 Hangul Form Language Translator Hangul Form Language Translator converts form description that you have created with a text editor, using Form Language statement, into binary form. You can create a source form description file with Hangul characters and convert the source file to DEC FMS/Hangul V2.4 form data structure using the Hangul Form Language Translator. __________________________________________________________ 5.3 Restrictions for DEC FMS/Hangul V2.4 Users should be aware of the following DEC FMS /Hangul V2.4 restrictions. _____________________________ 5.3.1 Hangul error messages The Form Editor and Form Driver error messages can be in Hangul or in English depending on the output option. You are advised to set the HANGULGEN output option according to the type of terminal you will be using to run Hangul FMS utilities and applications. Otherwise, Hangul error messages displayed on VT100- or VT200- compatible terminal screen will be meaningless. It is the user's responsibility to set the output option correctly. _____________________________ 5.3.2 Alphanumeric, alphabet and numeric fields Hangul data is designed not to be entered into alphanumeric, alphabet and numeric fields. Users should not enter Hangul into these fields, otherwise, unpredictable results will occur. Only fields with at least two consecutive "X" as the field validation characters are valid for Hangul input. 5-4 DEC FMS/Hangul for OpenVMS AXP Version 2.4 Release Notes _____________________________ 5.3.3 Multinational character support DEC FMS/Hangul V2.4 does not support multinational character set as background text and input to fields. _____________________________ 5.3.4 Long form support Long form support applies to both English and Hangul video forms, but only forms less than 100 lines can be created or modified by Hangul Form Editor. _____________________________ 5.3.5 LN03 and LN03 Plus printer image Laser printer image only applies to English video forms. Hangul video form image can be printed on DEC-recommended Hangul line printers. _____________________________ 5.3.6 Cursor Positioning using Hangul Form Driver Call (FDV$AFCX) In calling FDV$AFCX to position the cursor to a character of a field, programmers have to ensure that the position is at the beginning of a Hangul character. Otherwise, the data may be entered in an unpredictable way. Programmers are recommemded to use the HSYSHR routine to locate the correct position of the data and pass the position to the FDV$AFCX call as a parameter. __________________________________________________________ 5.4 Form Migration from Hangul FMS VAX to Hangul FMS AXP Binary forms (with extension .FRM) and form libraries (with extension .FLB) generated from Hangul FMS VAX V2.3 can be used in DEC FMS/Hangul for OpenVMS AXP. 5-5 DEC FMS/Hangul for OpenVMS AXP Version 2.4 Release Notes However, form objects produced by HFMS/OBJECT or HFMS/VECTOR on VAX platform cannot be used on FMS for OpenVMS AXP directly. The object needs to be rebuilt on Alpha platforms by invoking the Hangul FMS FAA tools, HFMS/OBJECT, with the original .FRM form files. __________________________________________________________ 5.5 Modification of Hangul FMS messages The Hangul version of HFMS message files can be modified as described in the following guide [SYSHLP.EXAMPLES.HFMS.MESSAGE]HFMS_MESSAGE.MEM . Users are recommended to read and understand the guide before any modifications are made. __________________________________________________________ 5.6 LMF Support DEC FMS/Hangul Version 2.4 supports the DIGITAL Software Licensing Architecture (DSLA) and the License Management Facility (LMF) required to run HFMS on OpenVMS/Hangul AXP Version 1.5 operating system. LMF is the software license management tool on the OpenVMS operating system. LMF includes the License Management Utility (LICENSE) and the command procedure VMSLICENSE.COM used to register, manage, and track software licenses online. To use HFMS on OpenVMS/Hangul for AXP Version 1.5, you must be registered in the LICENSE database. To register the license, you must have a Paper Authorization Key (PAK) containing the information necessary for the registration. The PAK is included as part of the DEC FMS/Hangul Version 2.4 kit. The registered license must then be activated to make it known to the system. If you do not have the necessary information or are otherwise unable to complete the registration of the PAK, you can continue with the installation, but you will not be able to run DEC FMS/Hangul Version 2.4 until the registration 5-6 DEC FMS/Hangul for OpenVMS AXP Version 2.4 Release Notes process has been completed. For more information on registration through the LMF, please see Chapter 1. For more information on using LMF, see the manual on the License Management Utility in the VMS documentation set. 5-7 __________________________________________________ A Sample Installation This appendix contains sample installations of Hangul FMS software. These samples have been run on a system that has no previous version of Hangul 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. __________________________________________________________ A.1 Full Development Kit This section contains a sample installation for the Hangul FMS full development kit. $ SET DEF SYS$UPDATE $ @VMSINSTAL OpenVMS ALPHA Software Product Installation Procedure V1.5-1H1 It is 29-NOV-1992 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: HFMS024 * Options: N Please mount the first volume of the set on DKA400:. * Are you ready? YES %MOUNT-I-MOUNTED, DECHFMS mounted on DKA400: The following products will be processed: HFMS V2.4 Beginning installation of HFMS V2.4 at 17:37 %VMSINSTAL-I-RESTORE, Restoring product saveset A ... A-1 Sample Installation 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]: 4 * Do you want to continue the installation? YES %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. Product: FMS-UI-HANGUL Producer: DEC Version: 2.4 Release Date: 14-NOV-1992 * 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 HFMS 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 ... %HFMS-I-CONTINUE, All inquiries have been requested. If no errors occur, -HFMS-I-CONTINUE, the installation will be completed in about 20 minutes. %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.HFMS]. 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): A-2 Sample Installation $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.HFMS] System Manager: Upon completion of this installation, please be sure to edit the system startup files as described in the Hangul FMS Installation Guide. %HFMS-S-FMSBUILT, HFMS V2.4 has built successfully, continuing... %HFMS-I-STARTSAMP, Starting the Sample Application Programs installation... %HFMS-S-SAMPBUILT, Sample Application Programs have built successfully, continuing... %HFMS-I-CONTINUE, Starting Modifiable Message File Procedures installation ... %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.HFMS.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.HFMS.MESSAGE] /PROT=(S:RWED,O,G,W) %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Beginning the HFMS V2.4 Installation Verification Procedure... HFMS V2.4 Installation Verification Procedure was successful Refer to the Hangul FMS Installation Guide for further verification procedures... Installation of HFMS V2.4 completed at 17:54 Enter the products to be processed from the next distribution volume set. * Products: EXIT VMSINSTAL procedure done at 17:55 $ A-3 Sample Installation __________________________________________________________ A.2 Run-Time Kit This section contains a sample installation for the Hangul FMS run-time only kit. $ SET DEF SYS$UPDATE $ @VMSINSTAL OpenVMS ALPHA Software Product Installation Procedure V1.5-1H1 It is 29-NOV-1992 at 17:23. 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: HFMSFDV024 * Options: Please mount the first volume of the set on DKA400:. * Are you ready? YES %MOUNT-I-MOUNTED, HFMSFDV mounted on DKA400: The following products will be processed: HFMSFDV V2.4 Beginning installation of HFMSFDV V2.4 at 17:25 %VMSINSTAL-I-RESTORE, Restoring product saveset A ... Product: FMS-RT-UI-HANGUL Producer: DEC Version: 2.4 Release Date: 14-NOV-1992 * Does this product have an authorization key registered and loaded? YES * Do you want to run the IVP after the installation [YES]? * Do you want to purge files replaced by this installation [YES]? System Manager: Upon completion of this installation, please be sure to edit the system startup files as described in the Hangul FMS INSTALLATION GUIDE. %HFMSFDV-S-FDVBUILT, HFMSFDV V2.4 has built successfully, continuing... A-4 Sample Installation Beginning the HFMSFDV V2.4 Installation Verification Procedure... HFMSFDV V2.4 Installation Verification Procedure was successful... Installation of HFMSFDV V2.4 completed at 17:28 VMSINSTAL procedure done at 17:29 $ A-5 __________________________________________________ B Using the Sample Applications Programs The installation and start-up procedure SYS$STARTUP:HFMSTARTUP.COM defines a system logical name for the HFMS$EXAMPLES: directory. This directory contains files relating to the sample application programs for DEC FMS/Hangul Version 2.4 software. If you are planning to run the sample application programs on a bisynchronous terminal, refer to Section B.2. DEC FMS/Hangul Version 2.4 provides the sample application programs listed in Table B-1. __________________________________________________________ Table B-1 FMS Sample Application Programs __________________________________________________ Executable Language_________Program_Name_____Image___________ BASIC SAMP.BAS SAMP.EXE BLISS SAMPBLI.BLI SAMPBLI.EXE C SAMPCC.C SAMPCC.EXE COBOL SAMPCOB.COB SAMPCOB.EXE FORTRAN SAMPFOR.FOR SAMPFOR.EXE PASCAL SAMPPAS.PAS SAMPPAS.EXE ________PL/I_____________SAMPPLI.PLI______SAMPPLI.EXE_____ To run the BASIC sample application program, enter the following command: $ RUN HFMS$EXAMPLES:SAMP If, while you are running a sample application program, you press the PF4 key to choose to write checks, a data file called SAMPCH.DAT is created in your default directory. B-1 Using the Sample Applications Programs __________________________________________________________ B.1 Files Associated with the Sample Application Programs Files that help you generate the sample application programs are included in the HFMS$EXAMPLES: directory. These files are as follows: o Files associated with SAMP forms The Sample Application Program forms are stored in a form library, SAMP.FLB. Two additional forms are provided to run a sample application on either a bisynchronous terminal or a MicroVAX workstation. The forms are contained in the files BISYNC_REGIST.FRM and LONG_REGIST.FRM, and are designed to replace the REGISTER form in the sample application form library, SAMP.FLB. The BISYNC_REGIST.FRM file enables you to run the sample applications on a bisynchronous terminal. The LONG_REGIST.FRM enables you to produce and display 55-line forms on MicroVAX workstations. o Files produced by FMS application aids The memory-resident form file, SMPMEMRES.OBJ, and the UAR vector file, SMPVECTOR.OBJ, are included in a link command to produce an executable SAMP image. o SAMP data base file The SAMP.DAT file provides the account data for the sample application programs. o Source files that contain HFMS definitions (see Table B-2) The HFMS definition files provide definitions for Form Driver symbols used in the sample application programs. Many of these files are used directly by the appropriate language construct (INCLUDE, COPY, REQUIRE, ENVIRONMENT, and so forth) to define the symbols in the programs. You may want to use these files as examples that you can tailor to fit your own applications. B-2 Using the Sample Applications Programs o Additional source files for languages (see Table B-3) Some of the sample application programs have source files containing convenient definitions that relate only to a particular language. o Command files that compile and link the sample application programs for a given language (see Table B-4) __________________________________________________________ Table B-2 HFMS Definition Files __________________________________________________ Language______________Definition_File_____________ BASIC FDVDEF.BAS BLISS FDVDEF.REQ C FDVDEF.H COBOL FDVDEF.LIB FORTRAN FDVDEF.FOR PASCAL FDVDEF.PAS PL/I FDVDEFCAL.PLI (definition using calls) PL/I FDVDEFFNC.PLI (definition ______________________________using_functions)____________ __________________________________________________________ Table B-3 HFMS Source Files __________________________________________________ Language______________Files_______________________ COBOL SAMPCOB.LIB SMPCOBUAR.LIB FORTRAN SMPACCOM.FOR SMPREGCOM.FOR SMPSTATUS.FOR ______________________________SMPWORK.FOR_________________ B-3 Using the Sample Applications Programs __________________________________________________________ Table B-4 HFMS Command Files __________________________________________________ Language______________Command_File________________ BASIC SAMPBAS.COM BLISS SAMPBLI.COM C SAMPCC.COM COBOL SAMPCOB.COM FORTRAN SAMPFOR.COM PASCAL SAMPPAS.COM ________PL/I__________________SAMPPLI.COM_________________ __________________________________________________________ B.2 Running the Sample Application on Bisynchronous Terminals If you do not plan to run the sample application programs on bisynchronous terminals, you can skip this section. You can run the sample application programs on bisynchronous terminals with no modifications to the programs. Because of the bisynchronous terminal's width restrictions, a form modification is required. The form that is used on asynchronous terminals (VT52, VT100, VT2xx, and so forth) to display the check register, REGISTER, does not fit on a bisynchronous terminal screen. The DEC FMS/Hangul Version 2.4 software kit provides a replacement form for REGISTER that fits on the bisynchronous terminal screen. This form works on aysnchronous terminals as well. The form is contained in the form file named BISYNC_ REGIST.FRM located in HFMS$EXAMPLES:. Before running the sample application programs on bisynchronous terminals, use the following procedure to replace the REGISTER form in the sample application form library, SAMP.FLB: 1 Log in to the system manager's account. B-4 Using the Sample Applications Programs 2 Enter the following command to save the current REGISTER form in a form file named HFMS$EXAMPLES:REGISTER.FRM: $ HFMS/LIBRARY/EXTRACT- _$ HFMS$EXAMPLES:SAMP/FORM=REGISTER _$/OUTPUT=HFMS$EXAMPLES:REGISTER.FRM 3 Enter the following command to insert the new REGISTER form: $ HFMS/LIBRARY/REPLACE HFMS$EXAMPLES:SAMP _$ HFMS$EXAMPLES:BISYNC_REGIST After executing this command, you can run the sample application programs as documented here on either asynchronous or bisynchronous terminals. The REGISTER form now has a different appearance and different field attributes than those of the original REGISTER form documented in Introduction to VAX-11 FMS.These differences are required so that the form fits on the bisynchronous terminal screen. These differences have no effect on the form's function or interaction with the program. B-5 __________________________________________________ C 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/Hangul Version 2.4 software. __________________________________________________ File_Name________Function_________________________ ________________[SYSHLP]_(SYS$HELP)_______________ HELPLIB.HLB Module HFMS (English version) added or replaced in help library DECFMS024.RELEASEOnline release notes for DEC FMS NOTES Version 2.4 __________________________________________________ __________________[SYSHLP.HANGUL]_________________ HELPLIB.HLB Module HFMS (Hangul version) added or replaced in help library __________________________________________________ _______________[SYSEXE]_(SYS$SYSTEM)______________ HFMSFAA.EXE HFMS Form Application Aids Utility HFMSFED.EXE HFMS Form Editor Utility HFMSFLG.EXE HFMS Form Language Translator Utility HFMSFLI.EXE HFMS Form Librarian Utility HFMSFTE.EXE HFMS Form Tester Utility HFMSFUU.EXE HFMS Form Upgrade Utility C-1 Files Installed on Your System __________________________________________________ __________________________________________________ _______________[SYSLIB]_(SYS$SHARE)_______________ HFDVSHR.EXE Form Driver shareable image __________________________________________________ ______________[SYSLIB]_(SYS$LIBRARY)______________ DCLTABLES.EXE DCL command HFMS 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)______________ HFMSTARTUP.COM HFMS startup procedure for full development kit HFDVSTRTUP.COM HFMS startup procedure for run- time kit __________________________________________________ ______________[SYSMGR]_(SYS$MESSAGE)______________ HFDVMSG.EXE Form Driver message file (Hangul) HFDVMSGE.EXE Form Driver message file (English) HFMSMSG.EXE HFMS utilities message file (Hangul) HFDVMSGE.EXE HFMS utilities message file (English) C-2 Files Installed on Your System __________________________________________________ __________________________________________________ ______[SYSHLP.EXAMPLES.HFMS]_(HFMS$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.HFMS]_(HFMS$EXAMPLES)______ BISYNC_ Sample application REGISTER form REGIST.FRM to be 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 C-3 Files Installed on Your System __________________________________________________ File_Name________Function_________________________ ______[SYSHLP.EXAMPLES.HFMS]_(HFMS$EXAMPLES)______ SAMP.FLB Sample application form library __________________________________________________ ______[SYSHLP.EXAMPLES.HFMS]_(HFMS$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] __________________________________________________ [1]Present only if the language is available on the system. C-4 Files Installed on Your System __________________________________________________ File_Name________Function_________________________ ______[SYSHLP.EXAMPLES.HFMS]_(HFMS$EXAMPLES)______ 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 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.HFMS.MESSAGE]__________ HCOMMSG.MSG Hangul message file common to all HFMS utilities FAAMSG.MSG Form application aids message file FCVMSG.MSG Form converter message file HFDVMSG.MSG Hangul Form driver message file HFEDMSG.MSG Hangul Form editor message file FIOMSG.MSG File I/O message file FLGMSG.MSG Form language translator message file __________________________________________________ C-5 Files Installed on Your System __________________________________________________ File_Name________Function_________________________ __________[SYSHLP.EXAMPLES.HFMS.MESSAGE]__________ FLIMSG.MSG Form librarian message file FMSLIT.MSG Hangul FMS message file literals HFMS_ Guide to modifying Hangul FMS MESSAGE.MEM message files FTEMSG.MSG Form Tester message file FUUMSG.MSG Form Upgrade Utility message file HMSGBLD.COM Hangul Message file build _________________procedure________________________ C-6