                           " 	      DEC FMS for OpenVMS Systems? 	      --------------------------------------------------------  	      Installation Guide     '               Order Number: AA-MK64A-TE                    December 1992   I               DEC Forms Management System (FMS) is a character-cell based G               forms management system for interactive applications that I               use video forms as the user interface. DEC FMS[TM] provides H               application programmers with a set of development tools toH               create and maintain forms-based user interfaces and a run-G               time system for displaying and managing the application's /               user interface at execution time.   G               All references to VMS[TM] systems and OpenVMS[TM] systems I               refer to OpenVMS Alpha AXP[TM] and Open VMS VAX[TM] systems )               unless otherwise specified.               ?               Software Version:             DEC FMS Version 2.4   E               Operating System:             OpenVMS VAX, Version 5.0   					    or later E                                             OpenVMS AXP, Version 1.0   					    or later                         +               Digital Equipment Corporation $               Maynard, Massachusetts                 N               ________________________________________________________________               November 1992   C               The information in this document is subject to change H               without notice and should not be construed as a commitmentA               by Digital Equipment Corporation. Digital Equipment G               Corporation assumes no responsibility for any errors that *               may appear in this document.  H               The software described in this document is furnished underI               a license and may be used or copied only in accordance with (               the terms of such license.  E               No responsibility is assumed for the use or reliability F               of software on equipment that is not supplied by Digital@               Equipment Corporation or its affiliated companies.  G               Restricted Rights: Use, duplication, or disclosure by the H               U.S. Government is subject to restrictions as set forth inE               subparagraph (c)(1)(ii) of the Rights in Technical Data A               and Computer Software clause at DFARS 252.227-7013.   3                Digital Equipment Corporation 1992.   "               All Rights Reserved.  E               The postpaid Reader's Comments forms at the end of this D               document request your critical evaluation to assist in-               preparing future documentation.   ?               The following are trademarks of Digital Equipment G               Corporation: ALL-IN-1, Alpha AXP, CDD, CDD/Plus, DEC, DEC F               FMS, Microvax, OpenVMS, VAX, VAXstation, VMS, VT, VT100,*               VT200, and the DIGITAL logo.  I                                                                    ZK4798   3               This document is available on CD-ROM.   I               This document was prepared using VAX DOCUMENT, Version 2.1.                                  F      _________________________________________________________________  F                                                               Contents      F      Preface...................................................     vi  -      1  Preparing to Install DEC FMS Software   F            1.1   Required Operating System Components..........    1-1F            1.2   Prerequisite and Optional Software............    1-2F            1.3   Prerequisite Hardware.........................    1-2F            1.4   License Registration..........................    1-2F            1.5   Installation Procedure Requirements...........    1-3F            1.5.1     Restrictions..............................    1-3F            1.5.2     Time......................................    1-3F            1.5.3     Privileges................................    1-4F            1.5.4     Disk Space................................    1-4F            1.5.5     System Parameters.........................    1-4F            1.5.5.1     Checking System Parameter Values........    1-5>            1.5.5.2     Calculating the Values for GBLPAGES andF                        GBLSECTIONS.............................    1-5<            1.5.5.3     Changing System Parameter Values withF                        AUTOGEN.................................    1-7F            1.5.6     Process Account Quotas....................    1-8F            1.5.7     VMSINSTAL Requirements....................    1-9F            1.5.8     Backing Up Your System Disk...............   1-10  #      2  Installing DEC FMS Software   F            2.1   General Information...........................    2-1F            2.1.1     Accessing the Online Release Notes........    2-1<            2.1.2     Determining the Files and Logical NamesF                      Added to the System.......................    2-2:            2.1.3     Running the Installation VerificationF                      Procedure.................................    2-2F            2.1.4     Ending the Installation Abnormally........    2-2F            2.2   Installation Procedure........................    2-2              F                                                                    iii                   I               2.2.1     Invoking VMSINSTAL........................    2-3 I               2.2.2     Answering Installation Questions..........    2-4 I               2.2.3     Informational Messages....................    2-8 =               2.2.4     Running the Installation Verification I                         Procedure.................................    2-9 I               2.2.5     Completing the Installation Procedure.....    2-9 I               2.3   Error Recovery................................   2-10   ,         3  After Installing DEC FMS Software  I               3.1   Editing the System Files......................    3-1 I               3.2   User Account Requirements.....................    3-2 I               3.3   Running the IVP...............................    3-3 I               3.4   Special Requirements..........................    3-3 I               3.5   Enhancing DEC FMS Performance.................    3-3 I               3.6   Determining and Reporting Problems............    3-5   4         4  Verifying the Form Editor and Form Tester             A  Sample Installation  I               A.1   Full Development Kit..........................    A-1 I               A.2   Run-Time Kit..................................    A-3   1         B  Using the Sample Applications Programs   @               B.1   Files Associated with the Sample ApplicationI                     Programs......................................    B-2 5               B.2   Running the Sample Application on I                     Bisynchronous Terminals.......................    B-4 >               B.3   Running the Sample Application on MicroVAXI                     Workstations..................................    B-5   )         C  Files Installed on Your System                                     
         iv                            Tables  I               1-1       Disk Space Requirements...................    1-4   I               1-2       Required System Parameter Values..........    1-5   A               1-3       Process Account Quotas for the Installing I                         Account...................................    1-8   =               3-1       User Account Quotas for Using DEC FMS I                         Software..................................    3-2   I               B-1       FMS Sample Application Programs...........    B-1   I               B-2       FMS Definition Files......................    B-3   I               B-3       FMS Source Files..........................    B-3   I               B-4       FMS Command Files.........................    B-3                                                                   I                                                                         v                             I         _________________________________________________________________   I                                                                   Preface       <               This manual describes how to install DEC FormsG               Management System (FMS) Version 2.4 and how to verify the                installation.   !         Who Should Use This Guide   H               This manual is intended for those who install and maintainB               DEC FMS software. You should read this manual before*               installing DEC FMS software.  D               To install DEC FMS software, you must have access to aF               privileged account. To run the Installation VerificationD               Procedure (IVP), you must use a VT100- or VT200-series7               terminal or one that is VT100-compatible.            Structure of This Guide   F               This manual contains four chapters and three appendixes:  C               Chapter 1 describes the preparations and requirements 8               necessary for installing DEC FMS software.  E               Chapter 2 describes the DEC FMS installation procedure.   G               Chapter 3 describes the tasks to perform after installing                DEC FMS software.   ;               Chapter 4 describes the postinstallation IVP.   @               Appendix A reproduces typical installation and IVP               sessions.   C               Appendix B describes the optional sample applications 7               programs available with DEC FMS software.   @               Appendix C details the files that are installed or               modified.             
         vi                            For More Information  H               For additional information on installing DEC FMS software,E               refer to the VMS system documentation for these topics:   $               o  VMSINSTAL procedure                  o  INSTALL Utility  1               o  System management and operations   H               See the following documents for more information about DEC               FMS software:   F               o  DEC FMS for OpenVMS Systems Mini-Reference - ProvidesH                  quick reference information for FMS utilities, commandsF                  and qualifiers, attributes, key functions, and so on.  F               o  DEC FMS for OpenVMS Systems Language Interface ManualE                  - Describes language interface issues for FMS (Forms C                  Management System) application programs. Languages F                  discussed include BASIC, BLISS-32, C, COBOL, FORTRAN,F                  PASCAL, and PL/I. Language-independent information isG                  also provided for programmers writing in languages not +                  documented in this manual.   F               o  DEC FMS for OpenVMS Systems Introduction - IntroducesE                  the FMS (Forms Management System). Examples from the I                  Sample Application Program show how to create and run an                   FMS program.   I               o  DEC FMS for OpenVMS Systems Utilities Reference Manual - G                  Describes the FMS (Forms Management System) utilities, H                  invoked through DCL commands, used to create and manage*                  forms and form libraries.  I               o  DEC FMS for OpenVMS Systems Form Driver Reference Manual G                  - Describes how the Form Driver component of the Forms G                  Management System (FMS) works on the OpenVMS operating E                  system. It provides language-independent information F                  required to design forms and to develop programs thatA                  use FMS forms for gathering and displaying data.                       I                                                                       vii                             Conventions   @               This following conventions are used in this guide:  E               Ctrl/X                In procedures, a sequence such as G                                     Ctrl/X indicates that you must hold G                                     down the key labeled Ctrl while you 6                                     press another key.  I               KPn                   Key names that begin with KP indicate E                                     keys on the numeric keypad on the H                                     right side of the terminal keyboard.H                                     For example, KP4 and KP. are keys on7                                     the numeric keypad.   F               PF1-X                 A sequence such as PF1-X indicatesI                                     that you must first press and release G                                     the key labeled PF1, and then press <                                     and release another key.  F                . . .                In examples, a horizontal ellipsisB                                     indicates one of the following2                                     possibilities:  I                                     o  Additional optional arguments in a C                                        statement have been omitted.   I                                     o  The preceding item or items can be B                                        repeated one or more times.  H                                     o  Additional parameters, values, orH                                        other information can be entered.  E                                     A vertical ellipsis indicates the A                   .                 omission of items from a code B                   .                 example or command format; theF                   .                 items are omitted because they areD                                     not important to the topic being.                                     discussed.  G               ()                    In format descriptions, parentheses E                                     indicate that, if you choose more I                                     than one option, you must enclose the ;                                     choices in parentheses.                            viii                     D               []                    In format descriptions, bracketsI                                     indicate that whatever is enclosed is G                                     optional; you can select none, one, :                                     or all of the choices.  B               {}                    In format descriptions, bracesA                                     surround a required choice of G                                     options; you must choose one of the 3                                     options listed.   F               user input            For online versions, user input is2                                     shown in bold.  C               $                     The default user prompt is your C                                     system name followed by a right E                                     angle bracket (>).The dollar sign F                                     is used to indicate the DCL promptH                                     om VMS systems. This prompt might be=                                     different on your system.   H               UPPERCASE             Literal strings that appear in text,F                                     examples, syntax descriptions, andG                                     function descriptions must be typed 5                                     exactly as shown.   G               lowercase             In commands and examples, indicates F                                     variables for which the user is to?                                     substitute a word or value.   I               -                     A hyphen is used to connect multiword I                                     names that describe a single item, as 2                                     in input-file.  H               All references to VMS systems and OpenVMS systems refer toF               OpenVMS Alpha AXP systems and OpenVMS VAX systems unless"               otherwise specified.                                I                                                                        ix  S                    I                                                                         1sI         _________________________________________________________________o  I                                     Preparing to Install DEC FMS Software     F               This chapter discusses the preparations and requirements4               necessary to install DEC FMS software.  C               This manual applies to Version 2.4 of DEC FMS and all B               subsequent maintenance releases up to the next major               product release.  D               Your bill of materials (BOM) and indented bills reportB               (BIL) specify the number and contents of your media.B               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.   E               DEC FMS provides online release notes. You can read and E               print the release notes before the DEC FMS installation_D               begins, when you first run the installation procedure.D               Digital Equipment Corporation strongly recommends thatC               you read the release notes before proceeding with thed               installation.   0         1.1 Required Operating System Components  E               DEC FMS supports the following VMS Version 5.0 classes:a  %               o  VMS required savesetm  $               o  Programming support                 o  Utilities                              I                                 Preparing to Install DEC FMS Software 1-1  m  f      -         Preparing to Install DEC FMS Softwarea.         1.2 Prerequisite and Optional Software    .         1.2 Prerequisite and Optional Software  I               This section discusses the software you must have installed D               on your system before installing DEC FMS software. TheG               section also includes information about software that younI               can use together with DEC FMS software. Refer to the System G               Software Addendum (SSA) for a complete list of compatible E               products and their required version numbers. The SSA ish=               part of the Software Product Description (SPD).r  F               Version 2.4 of DEC FMS requires Version 5.0 or higher of'               the VMS operating system.n  I               If the optional software uses CDD/Plus software, or if DBMSiF               software is to be part of the system, you should installC               those products before you install DEC FMS. CDDSHR.EXEoE               must always be installed using the Install Utility (see                Section 1.5.5.2).   !         1.3 Prerequisite Hardware   A               To run the IVP, you must have a video terminal. See D               Chapter 4 for more information on the postinstallation               IVP.            1.4 License Registration  D               The VMS License Management Facility (LMF) is availableF               with Version 5.0 of the VMS operating system. If you areG               installing DEC FMS on a Version 5.0 or higher VMS system,o:               you must register your software license. [1]  H               The license registration information you need is containedD               in the Product Authorization Key (PAK) that is shippedH               with DEC FMS. The PAK is a paper certificate that containsG               information about the license you own to run a particulard                piece of software.  "               ____________________I               [1]   DEC FMS software can be installed without registering.F                     the FMS license.  However, the IVP is not executedI                     without a license registration.  In addition, the FMS.H                     utilities and applications using the Form Driver areC                     not run until a license is properly registered.m                  1         1-2 Preparing to Install DEC FMS Softwarel           I                                     Preparing to Install DEC FMS Software1I                                                  1.4 License Registration     @               During the installation, you are asked if you haveG               registered the DEC FMS license and loaded the appropriate H               authorization key. You must register and load your licenseG               for DEC FMS before you start the installation in order tot/               run the IVP and use the software.r  F               To register a license under Version 5.0 or higher of theH               VMS operating system, first log in to the system manager'sD               account, SYSTEM. You then have a choice of two ways to'               perform the registration:   F               o  Run the SYS$UPDATE:VMSLICENSE.COM procedure. When theI                  procedure prompts you for information, respond with dataE;                  from your Product Authorization Key (PAK).2  @               o  Enter the DCL command LICENSE REGISTER with theF                  qualifiers that correspond to information on the PAK.  F               For complete information on using LMF, see the manual onE               the License Management Utility in the VMS documentationa               set.  /         1.5 Installation Procedure Requirements   E               The following sections discuss various requirements for *               installing DEC FMS software.           1.5.1 Restrictions  F               No users should be logged in to the system while you areH               installing DEC FMS software. You can use the REPLY command6               to send a message to users. For example:  ?               $ REPLY/ALL "Please log off now. Installing FMS."F  D               If VMSINSTAL detects any users on the system, it givesF               you an opportunity to stop the installation procedure byH               prompting you to continue. To stop the installation, press               RETURN..           1.5.2 Time  D               The installation takes approximately 15 to 60 minutes,<               depending on the type of media and your system               configuration.  D               Installing DEC FMS and running the IVP on a standalone4               VAXstation II system takes 17 minutes.          I                                 Preparing to Install DEC FMS Software 1-3. .  .      -         Preparing to Install DEC FMS Softwareo/         1.5 Installation Procedure Requirementst             1.5.3 Privileges  E               To install DEC FMS, you must be logged in to an account-C               that has SETPRV or at least the following privileges:                  o  CMKRNLm                 o  WORLD                 o  SYSPRV.  F               VMSINSTAL turns off BYPASS privilege at the start of the               installation..           1.5.4 Disk Space  G               Installing DEC FMS requires a certain amount of free disk G               space during the installation. Once DEC FMS is installed, F               less storage space is required. Table 1-1 summarizes the#               storage requirements.s  /               Table 1-1 Disk Space Requirementss  ?                                   Blocks During    Blocks Aftern?               Kit                 Installation     Installation   7               DEC FMS Version     3000             2650                2.4.  6               DEC FMS FDV         350              300               Version 2.4aB               ____________________________________________________  H               To determine the number of free disk blocks on the current7               system disk, enter the following command:   )               $ SHOW DEVICE SYS$SYSDEVICE.           1.5.5 System Parameters   A               The following sections show you how to check system E               parameter values, calculate values for the GBLPAGES and H               GBLSECTIONS system parameters, and change parameter values5               with the VMS AUTOGEN command procedure.   B               Installing DEC FMS requires certain system parameterC               settings. Table 1-2 lists the minimum required system E               parameter values for the installation. Depending on the F               kinds of programs and applications running at your site,=               you might need higher values for some settings.       1         1-4 Preparing to Install DEC FMS Software  n  l      I                                     Preparing to Install DEC FMS SoftwareeI                                   1.5 Installation Procedure Requirementsi    8               Table 1-2 Required System Parameter Values  .               System_Parameter           Value  0               GBLPAGES[1]                n + 250  .               GBLSECTIONS[1]             n + 4  E               [1]The n variable refers to the system parameter values @               currently in use. To install DEC FMS software, youC               must raise those values by the number indicated. (SeeM               Section 1.5.5.2.) I               ___________________________________________________________   0         1.5.5.1 Checking System Parameter Values  D               To check the values of your system parameters, use the"               following procedure:  A               1. Enter the following command to invoke the Systemt$                  Generation Utility:  (                  $ RUN SYS$SYSTEM:SYSGEN                  SYSGEN>  I               2. At the SYSGEN> prompt, enter the SHOW command to display F                  the value of a system parameter. The values displayedG                  should equal or exceed the the value of each parameter H                  listed in Table 1-2. The following command displays the9                  value for the GBLPAGES system parameter:S  &                  SYSGEN> SHOW GBLPAGES  G                  After you finish checking the parameters with the SHOWoG                  command, you can enter the EXIT command at the SYSGEN> /                  prompt to return to DCL level.v  C         1.5.5.2 Calculating the Values for GBLPAGES and GBLSECTIONSo  C               To install and run DEC FMS software, you must set the D               correct values for the GBLPAGES and GBLSECTIONS system               parameters.   F               The n variable shown in Table 1-2 represents the currentA               number of unused global pagelets or global sections G               available on your system. For the installation to executePE               successfully, you must raise these values by the amounta               indicated.          I                                 Preparing to Install DEC FMS Software 1-5            -         Preparing to Install DEC FMS Softwares/         1.5 Installation Procedure Requirementse    C               To calculate the number of unused global pagelets andh?               global sections on your system, use the following                procedure:  @               1. Run the VMS Install Utility (INSTALL) using the#                  following command:u  0                  $ INSTALL LIST /GLOBAL /SUMMARY  A                  The Install Utility displays a summary of globalrE                  pagelets and global sections used by your system, asrF                  well as the current number of unused global pagelets.                  For example:   3 	           Summary of Local Memory Global Sections   I         258 Global Sections Used,  22580/3420 Global Pagelets Used/Unused   H               2. Determine if the number of unused global pagelets (3420H                  in the example) is equal to or greater than 250. If theH                  number of unused pagelets is less than 250, you need to1                  increase the value for GBLPAGES.   G               3. Note the amount shown for Global Sections Used (258 in                   the example).  C               4. Run the System Generation Utility and use the SHOW H                  command to determine how many global sections have been(                  allocated. For example:       $ RUN SYS$SYSTEM:SYSGEN      SYSGEN> SHOW GBLSECTIONS  J     Parameter Name     Current   Default   Minimum   Maximum Unit  DynamicJ     --------------     -------   -------   -------   ------- ----  -------E     GBLSECTIONS            512       250        20      4095 Sections   E               5. Subtract the amount shown in the summary (258 in the F                  example) from the amount allocated. If the differenceF                  is less than 4, you need to increase the value of the'                  GBLSECTIONS parameter.   E               Section 1.5.5.3 describes the procedures for increasingeG               these values as well as those of other system parameters. E               Refer to the VMS documentation on system management and .               operations for more information.              1         1-6 Preparing to Install DEC FMS Softwaret :         I                                     Preparing to Install DEC FMS Software I                                   1.5 Installation Procedure Requirements     =         1.5.5.3 Changing System Parameter Values with AUTOGEN   D               You use the AUTOGEN command procedure to change systemB               parameters. AUTOGEN automatically adjusts values forD               parameters that are associated with the ones you reset               manually.   I               To change system parameters with AUTOGEN, use the following                procedure:  -               1. Edit the the following file:   )                  SYS$SYSTEM:MODPARAMS.DAT   H                  Use an editor to access the file. If you need to changeH                  a parameter value in the SYS$SYSTEM:MODPARAMS.DAT file,H                  delete the current value associated with that parameter)                  and enter the new value.   D                  To add a new value, add a line to the MODPARAMS.DATF                  file. The line contains the name of the parameter and(                  its value. For example:  "                  GBLSECTIONS = 128  B                  You also can modify incremental parameters in theD                  MODPARAMS.DAT file. The following example increases1                  the global page setting by 2000:   $                  ADD_GBLPAGES = 2000  F               2. After you have made all your changes, run the AUTOGENG                  procedure to recalculate your system parameters. Enter '                  the following command:u  5                  $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT   B                  AUTOGEN performs an automatic system shutdown andF                  restarts when it has finished. Restarting your system4                  activates the new parameter values.  D               When you restart a system under Version 5.0 of the VMSI               operating system, the Autogen Utility automatically adjustsoD               some of the SYSGEN parameters based on the consumptionG               of resources since the last reboot. If you do not want tocF               take advantage of this automatic adjustment, include the@               /NOFEEDBACK qualifier on the AUTOGEN command line.  ?               For more information about using AUTOGEN, see thetD               instructions on modifying system parameters in the VMS@               documentation on system management and operations.    I                                 Preparing to Install DEC FMS Software 1-7l   s  n      -         Preparing to Install DEC FMS Software /         1.5 Installation Procedure Requirements     $         1.5.6 Process Account Quotas  B               The account you use to install DEC FMS software mustA               have sufficient quotas to enable you to perform the C               installation. Table 1-3 summarizes the process quotas 4               required for the installation account.  I               Table 1-3 Process Account Quotas for the Installing Accountt  $               Account Quota    Value  !               ASTLM            24   !               BIOLM            18f  %               BYTLM            18,000   !               DIOLM            18   !               ENQLM            30   !               FILLM            20   H               User account quotas are stored in the file SYSUAF.DAT. YouE               use the VMS Authorize Utility to verify and change user                account quotas.n  I               To verify and change user account quotas, use the followingp               procedure:  F               1. Set your directory to SYS$SYSTEM and run AUTHORIZE as                  follows:i  )                  $ SET DEFAULT SYS$SYSTEMs                   $ RUN AUTHORIZE                  UAF>   E               2. At the Authorize Utility prompt (UAF>), use the SHOWiC                  command with an account name to check a particulare&                  account. For example:                     UAF> SHOW SMITH  F               3. To change a quota, use the MODIFY command at the UAF>9                  prompt. MODIFY has the following format:r  5                  MODIFY account-name /quota-name=nnnn             1         1-8 Preparing to Install DEC FMS Software            I                                     Preparing to Install DEC FMS SoftwarehI                                   1.5 Installation Procedure Requirementsn    I               The following example changes the FILLM quota for the SMITHs@               account and then exits from the Authorize Utility:  )               UAF> MODIFY SMITH /FILLM=50                UAF> EXITu  F               After you exit from the utility, the VMS system displaysH               messages indicating whether or not changes were made. OnceE               the changes have been made, you must log out and log in 6               again for the new quotas to take effect.  C               For more information on modifying account quotas, seeiA               the description of the Authorize Utility in the VMSa                documentation set.  $         1.5.7 VMSINSTAL Requirements  ;               When you invoke VMSINSTAL, it checks whether:D  B               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 fors                  installation   2               o  DECnet software is up and running  6               o  Any users are logged in to the system  E               VMSINSTAL requires that the installation account have ah.               minimum of the following quotas:                    ASTLM = 24o                  BIOLM = 18f                  BYTLM = 18,000                   DIOLM = 18                   ENQLM = 30                   FILLM = 20f  H               If VMSINSTAL detects any problems during the installation,B               it notifies you and asks if you want to continue theC               installation. In some instances, you can enter YES to @               continue. To stop the installation and correct theF               situation, enter NO or press RETURN. Correct the problem+               and restart the installation.             I                                 Preparing to Install DEC FMS Software 1-9h M  p      -         Preparing to Install DEC FMS SoftwareD/         1.5 Installation Procedure Requirements     )         1.5.8 Backing Up Your System Diske  I               At the beginning of the installation, VMSINSTAL asks if younF               have backed up your system disk. Digital recommends thatI               you backup your system disk before installing any software.i  E               Use the backup procedures that have been established ataI               your site. For details on backing up a system disk, see the I               section on the Backup Utility in the VMS documentation set.                                                                                         2         1-10 Preparing to Install DEC FMS Software M                       I                                                                         2oI         _________________________________________________________________-  I                                               Installing DEC FMS Software     E               This chapter describes how to install DEC FMS software. D               Section 2.2 contains a step-by-step description of the%               installation procedure.d           2.1 General Informationr  G               This section includes information about accessing releasetG               notes, determining what files and logical names are addedMC               to your system, running the Installation VerificationhF               Procedure (IVP), and ending the installation abnormally.  0         2.1.1 Accessing the Online Release Notes  F               DEC FMS provides online release notes. You should reviewD               the release notes in case they contain any information:               about changes in the installation procedure.  C               If you want the installation procedure to give you anyG               opportunity to display or print the online release notes,tH               you must specify OPTIONS N when you invoke VMSINSTAL. ThisD               question comes near the beginning of the installation.  D               Once DEC FMS has been installed, the release notes are,               located in the following file:  .               SYS$HELP:DECFMS024.RELEASE_NOTES  E               Online help also directs you to the release notes file. I               After the installation, you can enter the following command D               to review the release notes through the Help Facility:  &               $ HELP FMS RELEASE_NOTES                        I                                           Installing DEC FMS Software 2-1c a         #         Installing DEC FMS Softwareo         2.1 General InformationL    I         2.1.2 Determining the Files and Logical Names Added to the Systemc  H               Appendix C and Appendix A of the online release notes listH               the files added, replaced, or modified on your system when#               DEC FMS is installed.   D               DEC FMS adds only one logical name-FMS$EXAMPLES-to theI               system when it is installed. Appendix C as well as AppendixpE               A of the online release notes list the files associated                 with FMS$EXAMPLES.  =         2.1.3 Running the Installation Verification Procedure1  G               The IVP for DEC FMS verifies the installation. During theDG               installation, you are asked if you want to run the IVP asSE               part of the installation. If you respond YES, VMSINSTAL H               runs the IVP. It is recommended that you run the IVP to be7               sure that DEC FMS is installed correctly.s  =               After DEC FMS is installed, you can run the IVP D               independently to verify that the software is availableH               on your system. You might also want to run the IVP after aF               system failure to be sure that users can access DEC FMS.  F               Because of their interactive nature, the Form Editor andD               the Form Tester must be tested manually on a VT100- orC               VT200-compatible terminal. To verify the installationmC               of the Form Editor and Form Tester, see the procedure %               explained in Chapter 4.   0         2.1.4 Ending the Installation Abnormally  G               To end the installation procedure abnormally at any time, C               press CTRL/Y. When you press CTRL/Y, the installation G               procedure deletes all files it has created and exits. You_4               then can start the installation again.  "         2.2 Installation Procedure  E               The DEC FMS installation procedure consists of a seriesiD               of questions, prompts, and informational messages. TheD               following sections explain how to invoke VMSINSTAL andD               answer the installation questions. These sections alsoA               explain the informational messages displayed by thet               procedure.                '         2-2 Installing DEC FMS Softwareu           I                                               Installing DEC FMS Software I                                                2.2 Installation Proceduree              2.2.1 Invoking VMSINSTAL  E               To start the installation, invoke the VMSINSTAL command E               procedure from a privileged account, such as the SYSTEMsC               account. VMSINSTAL is in the SYS$UPDATE directory. To B               invoke VMSINSTAL, enter a command with the following               syntax:   F               @SYS$UPDATE:VMSINSTAL product-name device-name OPTIONS N                 product-name@               The installation name for the product. For DEC FMS<               software, use the following installation name:                 DECFMS024]                 device-name C               The name of the device on which you plan to mount the E               media. For example, MTA0: is the device name for a tape E               drive. It is not necessary to use the console drive for C               this installation. However, if you do use the console_F               drive, you should replace any media you removed once the'               installation is complete.                  OPTIONS NuF               An optional parameter that indicates you want to see theF               question on the release notes. If you do not include theG               OPTIONS N parameter, VMSINSTAL does not ask you about theE               release notes.  E               There are several other options you can select when youvI               invoke VMSINSTAL. For information on these options, see theq8               VMS documentation on software installation  E               The following example displays the command that invokes D               VMSINSTAL to install DEC FMS from tape drive MTA0: andH               shows the system response. This example uses the OPTIONS N               parameter.  A               $ @SYS$UPDATE:VMSINSTAL VAXFMS024 DKA400: OPTIONS N   H                     VAX/VMS Software Product Installation Procedure V5.0  )               It is 14-NOV-1992 at 10:15.o=               Enter a question mark (?) at any time for help.                 I                                           Installing DEC FMS Software 2-3  a  e      #         Installing DEC FMS Softwaren"         2.2 Installation Procedure    E               If you omit either the product name or the device name, <               VMSINSTAL asks you for this information later.  .         2.2.2 Answering Installation Questions  E               This section discusses the questions that appear during I               the installation. Appendix A contains a sample installation B               procedure showing how the questions can be answered.  C               An asterisk (*) marks the beginning of each question.mG               Some questions show the default response in brackets, for G               example [YES]. To use the default response, press RETURN.R  !               1. Shutdown DECnet.u  ?     %VMSINSTAL-W-DECNET, Your DECnet network is up and running.$        .        .        .*     * Do you want to continue anyway [NO]?  E                  You should install DEC FMS on a standalone system or B                  cluster with DECnet shut down. VMSINSTAL notifiesD                  you if DECnet is running and displays a list of allI                  active processes. The procedure then asks if you want tonI                  continue the installation. NO is the default response toi                  the question.  '               2. Confirm system backup.x  D       * Are you satisfied with the backup of your system disk [YES]?  E                  VMSINSTAL asks if you are satisfied with your systemsC                  backup. You should always back up your system diskfH                  before performing an installation. If you are satisfiedC                  with the backup of your system disk, press RETURN. D                  Otherwise, enter NO to stop the installation. AfterB                  you back up your system disk, you can restart the                  installation.  !               3. Mount the media.D                        '         2-4 Installing DEC FMS Software- -         I                                               Installing DEC FMS Software2I                                                2.2 Installation Procedureo    C                  Please mount the first volume of the set on MTA0:. %                  * Are you ready? YES >                  %MOUNT-I-MOUNTED, DEC FMS MOUNTED ON _$$MTA0::                  The following products will be processed:                    DEC FMS V2.4r  D                      Beginning installation of DEC FMS V2.4 at 10:30  E                  %VMSINSTAL-I-RESTORE, Restoring product saveset A...t  F                  You should now mount the first distribution volume onI                  the device you specified when you invoked VMSINSTAL. The G                  device name appears in the line preceding the question E                  "Are you ready?". VMSINSTAL then asks you if you aret9                  ready to continue with the installation.t  C                  If you respond YES to indicate that you are ready,aG                  VMSINSTAL displays a message that the media containingsE                  DEC FMS has been mounted on the specified device ands1                  that the installation has begun.a  F                  If you entered the wrong device name when you invokedI                  VMSINSTAL and need to restart the installation, enter NO I                  in response to the "Are you ready?" question. To end thefI                  installation abnormally for other reasons, press CTRL/Y.Y  /               4. Select a release notes option.h  '                  Release Notes Options:t  +                   1.  Display release notes )                   2.  Print release notesa"                   3.  Both 1 and 24                   4.  Copy release notes to SYS$HELPA                   5.  Do not display, print or copy release notes   %                  * Select option [2]:Y  G                  If you specified OPTIONS N when you invoked VMSINSTAL,SG                  you have five options for reviewing the release notes.a  G                  If you select option 1, VMSINSTAL displays the release E                  notes immediately on your terminal. To terminate the 3                  display at any time, press CTRL/C.                   I                                           Installing DEC FMS Software 2-5T A  B      #         Installing DEC FMS Softwaren"         2.2 Installation Procedure    H                  If you select option 2, VMSINSTAL asks you for the name9                  of the print queue that you want to use:   *                  * Queue name [SYS$PRINT]:  G                  You can press RETURN to print the release notes on the E                  default output print device or you can enter anotheru5                  queue name. Option 2 is the default.t  G                  If you select option 3, VMSINSTAL displays the releasejH                  notes immediately on the terminal and then asks you for6                  a queue name for the printed version.  D                  If you select option 4, the installation copies theD                  release notes to the Help directory. Even if you doG                  not select option 4, the release notes for DEC FMS area2                  copied to the SYS$HELP directory.  I                  Select option 5 if you have already reviewed the releasei                  notes..  +               5. Continue the installation.c  ?            * Do you want to continue the installation [N]?: YESsG            %VMSINSTAL-I-RELMOVED, The product's release notes have beenn*            successfully moved to SYS$HELP.  A                  To continue, enter YES. Otherwise, press RETURN. D                  In either case, the release notes are copied to the:                  following file in the SYS$HELP directory.  E                  The release notes are located in the following file:   1                  SYS$HELP:DECFMS024.RELEASE_NOTES   F                 ________________________ Note ________________________  ?                 The name of the release notes file installed by.B                 VMSINSTAL consists of the current product name and?                 version number. Do not delete release notes forv6                 previous versions of DEC FMS software.F                 ______________________________________________________                      '         2-6 Installing DEC FMS Software            I                                               Installing DEC FMS Software I                                                2.2 Installation ProcedureS    '               6. Register your license.t       Product:       DEC FMS     Producer:      DEC     Version:       2.4     Release Date:  14-NOV-1988  H     * Does this product have an authorization key registered and loaded?  H                  The installation procedure displays license informationH                  about your product and then asks if you have registered?                  and loaded your authorization key for DEC FMS.   I                  If you have not registered and loaded your authorization F                  key, you must answer NO to this question. You have toD                  register and load your product authorization key toH                  complete the installation. If you have not done so, youE                  should stop the installation, register and load your I                  product authorization key, and restart the installation.i                 7. Run the IVP.w  >     * Do you want to run the IVP after the installation [YES]?  G                  The installation procedure now asks if you want to run.C                  the Installation Verification Procedure (IVP). TheeD                  IVP for DEC FMS software checks to be sure that theG                  installation is successful. It is recommended that yous                  run the IVP.k                 8. Purge files.   E     * Do you want to purge files replaced by this installation [YES]?   A                  You have the option to purge files from previousrG                  versions of DEC FMS that this installation supercedes.oH                  Purging is recommended; however, to save files from theH                  previous version, enter NO in response to the question.  -               9. Choose installation options.   G     * Do you wish to install Sample Application Programs and Modifiable:"     Message File Procedures [YES]?  G                  You are now asked to choose your installation options. H                  If you answer YES to the prompt, the DEC FMS modifiableE                  message files and sample applications are installed.t            I                                           Installing DEC FMS Software 2-7  t  a      #         Installing DEC FMS Softwaret"         2.2 Installation Procedure    D                  The sample application programs are used throughoutA                  the DEC FMS documentation as examples of DEC FMSlI                  programming techniques. The files relating to the sampleDF                  applications are found in the FMS$EXAMPLES: directoryG                  and are listed in Appendix C. The DEC FMS installation C                  and start-up procedure (SYS$STARTUP:FMSTARTUP.COM)o?                  defines a system logical for the FMS$EXAMPLES:c                  directory.t  H                  See Appendix A for more detailed information concerning1                  the sample application programs.p  @                  The Modifiable Message File Procedures create a@                  subdirectory containing the sources for the FMS@                  Message Files and instructions on how to modifyD                  the text of the messages in the FMS Form Driver andB                  FMS Utilities. The message files are found in theH                  subdirectory SYS$SYSROOT:[SYSHLP.EXAMPLES.FMS.MESSAGE].H                  The instructions for modifying the message files are in?                  the FMS_MESSAGE.MEM file in that subdirectory.   1               10.Insert additional media volumes.   J                  %BACKUP-I-READYREAD, mount volume 2 on _MTA0: for reading  (                  Enter "YES" when ready:  H                  If your installation kit contains more than one volume,G                  VMSINSTAL prompts you to insert the additional volumesnI                  and then asks you to indicate that you are ready for ther)                  installation to proceed.n  $         2.2.3 Informational Messages  =               The installation procedure displays a number of.C               informational messages that report on the progress of F               the installation. There are no further questions. If theG               installation has been successful, VMSINSTAL moves the newuI               or modified files to their target directories, updates helpnG               files, and updates DCL tables, if necessary. If you askedyE               for files to be purged, that is done now. The procedureT-               displays the following message:   O  %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories...D  H               If the installation procedure is successful, the following8               files are moved to their target directory:  &               o  SYS$SYSTEM:FMSFAA.EXE        '         2-8 Installing DEC FMS Software            I                                               Installing DEC FMS SoftwarevI                                                2.2 Installation ProcedureS    &               o  SYS$SYSTEM:FMSFCV.EXE  &               o  SYS$SYSTEM:FMSFED.EXE  &               o  SYS$SYSTEM:FMSFLG.EXE  &               o  SYS$SYSTEM:FMSFLI.EXE  &               o  SYS$SYSTEM:FMSFTE.EXE  &               o  SYS$SYSTEM:FMSFUU.EXE  7               In addition, the SYS$HELP:HELPLIB.HLB andAH               SYS$LIBRARY:DCLTABLES.EXE files are updated to include theF               new version of the DEC FMS HELP text and the FMS commandF               line definition, respectively. The DEC FMS release notesF               are copied to the SYS$HELP:DECFMS024.RELEASE_NOTES file.  D               For a complete list of files that have been created orE               modified by the installation procedure, see Appendix C.   =         2.2.4 Running the Installation Verification Procedure   E               If you chose to run the IVP, VMSINSTAL runs it now. Thea7               procedure displays the following message:   4     Beginning DEC FMS V2.4 Installation Procedure...  7     If DEC FMS has been installed, the IVP displays thet     following message:  B     DECFMS V2.4 Installation Verification Procedure was successfulD     Refer to the DEC FMS Installation Guide for further verification     procedures..  C               You can run the IVP separately any time after DEC FMSiD               software has been installed. To run the IVP, enter the                following command:  5               @SYS$SYSDEVICE:[SYS$TEST.FMS]DECFMS$IVP,  3         2.2.5 Completing the Installation Proceduret  F               The following messages indicate that the installation is               complete:t  @                  Installation of DEC FMS V2.4 completed at 11:03  2                  VMSINSTAL procedure done at 11:17        I                                           Installing DEC FMS Software 2-9o r  d      #         Installing DEC FMS Software "         2.2 Installation Procedure    G               You can now log out of the privileged account as follows:a                 $ LOGOUT  1               The following message is displayed:   >               SYSTEM     logged out at 14-NOV-1988 11:24:32.40  H               VMSINSTAL deletes or changes entries in the process symbolD               tables during the installation. Therefore, to continueE               using the system manager's account and to restore theses0               symbols, log out and log in again.           2.3 Error Recovery  H               If errors occur during the installation itself or when theI               IVP is running, VMSINSTAL displays failure messages. If the F               installation fails, the procedure displays the following               message:  F     %VMSINSTAL-E-INSFAIL, The installation of DEC FMS V2.4 has failed.  D               If the IVP fails, the procedure displays the following               messages:   @     The DEC FMS V2.4 Installation Verification Procedure failed.  >     %VMSINSTAL-E-IVPFAIL, The IVP for DEC FMS V2.4 has failed.  D               Errors can occur during the installation if any of the*               following conditions exists:  B               o  The version of the operating system is incorrect.  )               o  Quotas are insufficient.   :               o  System parameter values are insufficient.  4               o  The VMS Help library is being used.  ;               o  Your disk contains insufficient disk spaceh  H               o  The product license has not been registered and loaded.  G               For descriptions of the error messages generated by these G               conditions, see the VMS documentation on system messages, H               recovery procedures, and software installation. If you areF               notified that any of these conditions exists, you shouldF               take the appropriate action as described in the message.F               (You might need to change a system parameter or increaseI               an authorized quota value.) For information on installation *               requirements, see Chapter 1.  (         2-10 Installing DEC FMS Software                         I                                                                         3tI         _________________________________________________________________a  I                                         After Installing DEC FMS Software     H               After installing DEC 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  C               To provide for automatic startup of DEC FMS when your E               system is restarted, you must edit two system files. To D               edit these startup files, use the following procedure:  G               1. Add the command line that starts DEC FMS to the systemtE                  startup file, SYS$MANAGER:SYSTARTUP_VMS.COM. DEC FMSmI                  software cannot start until the network has started. YouoI                  must put this new command line after the network startup F                  command line. The following example shows the networkE                  startup command line followed by the startup command "                  line for DEC FMS:  ,                  $ @SYS$MANAGER:STARTNET.COM                       .                        .                        .o-                  $ @SYS$STARTUP:FMSTARTUP.COM   H               2. The FMS start-up command procedure contains several VMSE                  commands. The first command assigns the logical nametG                  FMS$EXAMPLES to the directory that contains the sample A                  application programs for Version 2.4 of DEC FMS.                           I                                     After Installing DEC FMS Software 3-1            )         After Installing DEC FMS Softwares$         3.1 Editing the System Files    C                  The last commands in the command procedure install E                  FDVSHR and FDVMSG as known shared images. To improveqE                  the performance of FMS application programs, you can >                  remove the following line from FMSTARTUP.COM:  H                  $ EXIT         ! Remove this line to install the images  H                  If you have made any changes to the FMSTARTUP.COM file,G                  use the SHUTDOWN procedure to stop the current system,w(                  and restart the system.  %         3.2 User Account Requirementse  E               To work with DEC FMS, user accounts on your system mustyH               have at least the TMPMBX privilege. The accounts must also1               have the quotas shown in Table 3-1.   F               Table 3-1 User Account Quotas for Using DEC FMS Software  $               Account Quota    Value  !               ASTLM            24   !               BIOLM            18l  !               DIOLM            18   !               ENQLM            30   !               FILLM            20e    G               User account privileges and quotas are stored in the fileAG               SYSUAF.DAT. To verify and change user account quotas, use 4               the VMS Authorize Utility, as follows:  G               1. Set your directory to SYS$SYSTEM and run the AuthorizeE                  Utility:v  )                  $ SET DEFAULT SYS$SYSTEM                    $ RUN AUTHORIZE                  UAF>t  G               2. At the Authorize Utility prompt (UAF>), enter the SHOWdF                  command with an account name to check that particular&                  account. For example:                     UAF> SHOW SMITH  I               3. To change a privilege or quota, enter the MODIFY command )                  in the following format:     -         3-2 After Installing DEC FMS Softwarec a  n      I                                         After Installing DEC FMS Software I                                             3.2 User Account Requirementse    F                  The following example changes the ENQLM quota for the5                  SMITH account and exits the utility:   ,                  UAF> MODIFY SMITH /ENQLM=50                  UAF> EXIT  E                  After you exit the utility, the VMS operating system H                  displays messages indicating whether changes were made.G                  Once you have made the changes, users must log out and @                  log in again for the new quotas to take effect.  F               For more information on modifying account privileges andI               quotas, see the description of the Authorize Utility in the $               VMS documentation set.           3.3 Running the IVPi  D               When FMS is installed, the IVP is automatically placed               in the followingC               location: SYS$SYSDEVICE:[SYS$TEST.FMS]DECFMS$IVP.COM. E               The IVP is placed there even if you chose not to run it #               at installation time.s  @               You can run the IVP at any time after FMS has been:               installed by entering the following command:  5               @SYS$SYSDEVICE:[SYS$TEST.FMS]DECFMS$IVPo            3.4 Special Requirements  G               To prevent data loss, users should set their terminals torF               HOSTSYNC and TYPAHEAD before using DEC FMS software. For=               more information, see the online release notes.l  )         3.5 Enhancing DEC FMS Performanceo  D               This section includes information on system tuning and@               explains how to install DEC FMS as a shared image.  F               The Form Driver for Version 2.4 of DEC FMS is built as aI               shared image. If several users who run DEC FMS applicationshG               at the same time are on your system, each user has a copylC               of the Form Driver in memory. If you install the FormyF               Driver as a known shared image, the users share a singleI               copy of the Form Driver in memory when DEC FMS applications                are run.              I                                     After Installing DEC FMS Software 3-3  .  n      )         After Installing DEC FMS Softwarea)         3.5 Enhancing DEC FMS Performance     F               A known shared image reduces memory requirements and can)               improve system performance.   D               To install DEC FMS as a known shared image on a systemD               that is currently running, use the VMS Install UtilityG               (INSTALL). It is recommended that you perform the install F               operation on a system that has just been started becauseI               the available space in the global page table is less likely_               to be fragmented._  E               To install DEC FMS as a shared image, use the following                procedure:  F               1. Determine the number of available global pagelets andH                  global sections on your system. See Section 1.5.5.2 forF                  information on how to verify and modify the number ofH                  global pagelets and global sections. Table 1-2 contains:                  the required values for these parameters.  H               2. Once you have reset the system parameter values, invokeF                  the VMS Install Utility from a privileged account and?                  install DEC FMS as a shared image, as follows:e                    $ INSTALL@                  INSTALL> ADD SYS$SHARE:FDVSHR.EXE /OPEN /SHAREDB                  INSTALL> ADD SYS$MESSAGE:FDVMSG.EXE /OPEN /SHARED                  INSTALL> EXIT  B               3. Add the following lines to the appropriate systemE                  startup command file so that each time the system isSC                  started, DEC FMS software is available as a sharedhA                  image. (If your site has modularized its startupoE                  procedures, be sure you add the lines to the correctzG                  file. The default startup command file for Version 5.0 F                  of the VMS operating system is SYS$MANAGER:SYSTARTUP_                  VMS.COM.)                    $ INSTALL@                  INSTALL> ADD SYS$SHARE:FDVSHR.EXE /OPEN /SHAREDA                  INSTALL> ADD SYS$MESSAGEFDVMSG.EXE /OPEN /SHARED                   INSTALL> EXIT  D               4. When you install DEC FMS as a shared image you needB                  to increase the global pagelets (GBLPAGES) by 250A                  and global sections (GBLSECTIONS) by 4. Refer tot@                  Section 1.5.5 for information on changing these                  parameters.            -         3-4 After Installing DEC FMS Softwaree y  i      I                                         After Installing DEC FMS SoftwaremI                                    3.6 Determining and Reporting Problemse    .         3.6 Determining and Reporting Problems  D               If an error occurs while DEC FMS is being used and youI               believe that the error is caused by a problem with DEC FMS,t0               take one of the following actions:  F               o  If you have a BASIC or DECsupport Software Agreement,3                  call your Customer Support Center.l  C               o  If you have a Self-Maintenance Software Agreement, <                  submit a Software Performance Report (SPR).  I               o  If you purchased DEC FMS within the past 90 days and you I                  think a software error is causing the problem, submit anC                  SPR.   I               If you find an error in the DEC FMS documentation, fill outaF               and submit the Reader's Comments form at the back of theI               document in which you formed the error. Include the sectiont+               and page number of the error.i                                                                  I                                     After Installing DEC FMS Software 3-5s t                      I                                                                         4XI         _________________________________________________________________o  I                                 Verifying the Form Editor and Form Testero    F               Because of their interactive nature, the Form Editor andD               the Form Tester must be tested manually on a VT100- orI               VT200-compatible terminal. The following procedure verifies F               the installation of the Form Editor and the Form Tester.  D               1. Log in using a VT100- or VT200-compatible terminal.  7               2. Create a form to test the Form Editor.   G                  To create a form, specify the name of a file that does F                  not exist in the current directory. (In this example,H                  the file is called testfile.frm.) The default file type&                  is .FRM. For example:  )                  $  FMS/EDIT testfile.frm   D               3. Enter the SET TERMINAL/INQUIRE command to request aB                  response sequence from your terminal, as follows:  (                  $  SET TERMINAL/INQUIRE  2               4. Select a Form Editor Menu option.  I                  After you have entered the Form Editor, select LAYOUT atsG                  the Phase Choice prompt. The screen is cleared and the G                  Layout Phase status line appears at the bottom of your                   screen.  %                  Phase Choice: LAYOUT   8               5. Enter text into your form. For example:  '                  This is a test of FMS.t  D                  To enter field mode, press the PF1 key and then theH                  keypad 8 key. Type the letter x six times to indicate a$                  field. For example:                I                             Verifying the Form Editor and Form Tester 4-1  m  d      1         Verifying the Form Editor and Form Testeri                        <PF1> <KP8>                  XXXXXX   &               6. Exit the Form Editor.  C                  Press the PF1 key and the keypad 7 key to exit thetF                  Layout Phase of the Form Editor. The Form Editor MenuF                  reappears; at the prompt, type EXIT and press RETURN.                    <PF1> <KP7>#                  Phase Choice: EXITS                 7. Save the form.   G                  After you have exited Layout Phase, the Editor prompts E                  you to save the file. Press RETURN to save the form.E  1                  $ Do you want to save this form? K                   %FMS-I-FORMSAVED, Form testfile.frm saved in testfile.frmR  +               8. Test the form, as follows:e  (                  $ FMS/TEST testfile.frm  G                  DEC FMS displays your form. Type any seven characters.TG                  The seventh character does not echo on the screen. The0D                  terminal bell rings and an error message indicatingE                  that the field is full is displayed at the bottom ofoI                  your terminal screen. Press RETURN. The system prompt ist                  displayed.                     123456V 	         <RETURN>                  $  2               9. Delete the form file, as follows:  (                  $ DELETE testfile.frm;*  H                  The test is complete. If any errors occurred during the>                  test, follow the instructions in Section 2.3.                        5         4-2 Verifying the Form Editor and Form Testere i  i                    I                                                                         A I         _________________________________________________________________   I                                                       Sample Installation$    D               This appendix contains sample installations of DEC FMSF               software. These samples were run on a system that had no4               previous version of DEC FMS installed.  G               The sample installation assumes that DECnet has been shuttH               down, that no users are logged in to your system, and thatD               OPTIONS N is specified to print the release notes. TheG               Installation Verification Procedure (IVP) runs at the end "               of the installation.            A.1 Full Development Kit  I               This section contains a sample installation for the DEC FMSg#               full development kit.        $ SET DEF SYS$UPDATE     $ @VMSINSTAL  8     VAX/VMS Software Product Installation Procedure V5.0       It is 29-NOV-1992 at 17:35.e3     Enter a question mark (?) at any time for help.dF     * Are you satisfied with the backup of your system disk [YES]? YES=     * Where will the distribution volumes be mounted: DKA400:i  N     Enter the products to be processed from the first distribution volume set.     * Products: DECFMS024      * Options: N9     Please mount the first volume of the set on  DKA400:.      * Are you ready? YES/     %MOUNT-I-MOUNTED, DECFMS mounted on DKA400: -     The following products will be processed:P       DECFMS V2.4r3      Beginning installation of DECFMS V2.4 at 17:37   9     %VMSINSTAL-I-RESTORE, Restoring product saveset A ...e           Release Notes Options:            I                                                   Sample Installation A-1a n                  Sample Installation           A.1 Full Development Kit         1.  Display release notesy     2.  Print release notes      3.  Both 1 and 2&     4.  Copy release notes to SYS$HELP3     5.  Do not display, print or copy release notes        * Select option [2]: 43     * Do you want to continue the installation? YEScA     %VMSINSTAL-I-RELMOVED , The product's release notes have beene#     successfully moved to SYS$HELP.   '                  Product:       DEC FMSg#                  Producer:      DECd#                  Version:       2.4s+                  Release Date:  14-NOV-1992e  L     * Does this product have an authorization key registered and loaded? YESB     * Do you want to run the IVP after the installation [YES]? YESI     * Do you want to purge files replaced by this installation [YES]? YESc  I     If you wish to save space on your system disk you may  choose  not to.F     install the Sample Application Programs and the Modifiable MessageK     File Procedures.  You may later install them by installing DECFMS V2.4  
     again.  O     * Do you wish to install Sample Application Programs and Modifiable Message_     File Procedures [YES]?9     %VMSINSTAL-I-RESTORE, Restoring product saveset B ... 9     %VMSINSTAL-I-RESTORE, Restoring product saveset C ... 9     %VMSINSTAL-I-RESTORE, Restoring product saveset D ...mN     %VAXFMS-I-CONTINUE, All inquiries have been requested. If no errors occur,O     -VAXFMS-I-CONTINUE, the installation will be completed in about 20 minutes. ?     %VMSINSTAL-I-SYSDIR, This product creates system directory  B                                             [SYSHLP.EXAMPLES.FMS].  H     If you intend to execute this layered product on other nodes in yourG     VAXcluster, and you have the appropriate software license, you must G     prepare the system-specific roots on the other nodes by issuing theVI     following command on each node (using a suitably privileged account):h  ;      $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.FMS]n       System Manager:r  8          Upon completion of this installation, please be8          sure  to  edit  the  system  startup  files  as5          described in the DEC FMS Installation Guide.o                     A-2 Sample Installation: R  T      I                                                       Sample InstallationoI                                                  A.1 Full Development KitS    I     %VAXFMS-S-FMSBUILT, DECFMS V2.4 has built successfully, continuing...eB     %VAXFMS-I-STARTSAMP, Starting the Sample Application Programs J                                                            installation...@     %VAXFMS-S-SAMPBUILT, Sample Application Programs have built J                                                successfully, continuing...D     %VAXFMS-I-CONTINUE, Starting Modifiable Message File Procedures J                                                           installation ...?     %VMSINSTAL-I-SYSDIR, This product creates system directory wK                                              [SYSHLP.EXAMPLES.FMS.MESSAGE].t  H     If you intend to execute this layered product on other nodes in yourG     VAXcluster, and you have the appropriate software license, you mustlG     prepare the system-specific roots on the other nodes by issuing theAI     following command on each node (using a suitably privileged account):r  
     $ CREATE  O       /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.FMS.MESSAGE]/PROT=(S:RWED,O,G,W) D     %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target K                                                              directories...   D     Beginning the DECFMS V2.4 Installation Verification Procedure...  B     DECFMS V2.4 Installation Verification Procedure was successfulE     Refer to the DEC FMS Installation Guide for further verification  J                                                              procedures...  3      Installation of DECFMS V2.4 completed at 17:54   M     Enter the products to be processed from the next distribution volume set.l     * Products: EXIT&      VMSINSTAL procedure done at 17:55     $s           A.2 Run-Time Kit  I               This section contains a sample installation for the DEC FMSS                run-time only kit.       $ SET DEF SYS$UPDATE     $ @VMSINSTAL;      VAX/VMS Software Product Installation Procedure V5.0-2        It is 29-NOV-1992 at 17:23. 3     Enter a question mark (?) at any time for help.eF     * Are you satisfied with the backup of your system disk [YES]? YES=     * Where will the distribution volumes be mounted: DKA400:               I                                                   Sample Installation A-3o n                  Sample Installationo         A.2 Run-Time Kit    N     Enter the products to be processed from the first distribution volume set.     * Products: FMSFDV024S     * Options:9     Please mount the first volume of the set on  DKA400:.q     * Are you ready? YES/     %MOUNT-I-MOUNTED, FMSFDV mounted on DKA400:o-     The following products will be processed:e       FMSFDV V2.4 3      Beginning installation of FMSFDV V2.4 at 17:25   9     %VMSINSTAL-I-RESTORE, Restoring product saveset A ...t  (                   Product:       DEC FMS$                   Producer:      DEC$                   Version:       2.4,                   Release Date:  14-NOV-1992  L     * Does this product have an authorization key registered and loaded? YES>     * Do you want to run the IVP after the installation [YES]?E     * Do you want to purge files replaced by this installation [YES]?U       System Manager:   8          Upon completion of this installation, please be8          sure  to  edit  the  system  startup  files  as8          described in the  DEC  FMS  INSTALLATION GUIDE.  I     %FMSFDV-S-FDVBUILT, FMSFDV V2.4 has built successfully, continuing...   D     Beginning the FMSFDV V2.4 Installation Verification Procedure...  E     FMSFDV V2.4 Installation Verification Procedure was successful...   3      Installation of FMSFDV V2.4 completed at 17:28o  &      VMSINSTAL procedure done at 17:29     $[                                         A-4 Sample Installation                          I                                                                         BHI         _________________________________________________________________   I                                    Using the Sample Applications Programs   5               The installation and start-up procedureuI               SYS$STARTUP:FMSTARTUP.COM defines a system logical name for H               the FMS$EXAMPLES: directory. This directory contains filesI               relating to the sample application programs for Version 2.4 "               of DEC FMS software.  H               If you are planning to run the sample application programs@               on a bisynchronous terminal, refer to Section B.2.  D               Version 2.4 of DEC FMS provides the sample application+               programs listed in Table B-1.   7               Table B-1 FMS Sample Application Programs   ;               Language    Program_Name     Executable Image   3               BASIC       SAMP.BAS         SAMP.EXE   6               BLISS       SAMPBLI.BLI      SAMPBLI.EXE  5               C           SAMPCC.C         SAMPCC.EXE   6               COBOL       SAMPCOB.COB      SAMPCOB.EXE  6               FORTRAN     SAMPFOR.FOR      SAMPFOR.EXE  6               PASCAL      SAMPPAS.PAS      SAMPPAS.EXE  6               PL/I        SAMPPLI.PLI      SAMPPLI.EXE< 	      _____________________________________________________  D               To run the BASIC sample application program, enter the                following command:  %               $ RUN FMS$EXAMPLES:SAMP   I               If, while you are running a sample application program, you F               press the PF4 key to choose to write checks, a data fileE               called SAMPCH.DAT is created in your default directory.c            I                                Using the Sample Applications Programs B-1f           .         Using the Sample Applications ProgramsA         B.1 Files Associated with the Sample Application Programst    A         B.1 Files Associated with the Sample Application Programss  A               Files that help you generate the sample applicationaD               programs are included in the FMS$EXAMPLES: directory. " 	      These files are as follows:  1               o  Files associated with SAMP forms/  E                  The Sample Application Program forms are stored in a/(                  form library, SAMP.FLB.  B                  Two additional forms are provided to run a sampleB                  application on either a bisynchronous terminal orC                  a MicroVAX workstation. The forms are contained inhA                  the files BISYNC_REGIST.FRM and LONG_REGIST.FRM,oA                  and are designed to replace the REGISTER form inrC                  the sample application form library, SAMP.FLB. ThesE                  BISYNC_REGIST.FRM file enables you to run the sampleYD                  applications on a bisynchronous terminal. The LONG_F                  REGIST.FRM enables you to produce and display 55-line0                  forms on MicroVAX workstations.  ;               o  Files produced by the FMS application aidse  F                  The memory-resident form file, SMPMEMRES.OBJ, and theG                  UAR vector file, SMPVECTOR.OBJ, are included in a linke=                  command to produce an executable SAMP image.1  $               o  SAMP data base file  D                  The SAMP.DAT file provides the account data for the-                  sample application programs.   ?               o  Source files that contain FMS definitions (see                   Table B-2)6  F                  The FMS definition files provide definitions for FormH                  Driver symbols used in the sample application programs.I                  Many of these files are used directly by the appropriateiI                  language construct (INCLUDE, COPY, REQUIRE, ENVIRONMENT, E                  and so forth) to define the symbols in the programs. I                  You may want to use these files as examples that you cana5                  tailor to fit your own applications.   F               o  Additional source files for languages (see Table B-3)  D                  Some of the sample application programs have sourceI                  files containing convenient definitions that relate only *                  to a particular language.        2         B-2 Using the Sample Applications Programs e  a      I                                    Using the Sample Applications ProgramsdI                 B.1 Files Associated with the Sample Application Programsr    ?               o  Command files that compile and link the sample ?                  application programs for a given language (seew                  Table B-4)   ,               Table B-2 FMS Definition Files  .               Language         Definition File  )               BASIC            FDVDEF.BAS_  )               BLISS            FDVDEF.REQ   '               C                FDVDEF.He  )               COBOL            FDVDEF.LIBc  )               FORTRAN          FDVDEF.FOR   )               PASCAL           FDVDEF.PASa  E               PL/I             FDVDEFCAL.PLI (definition using calls)u  I               PL/I             FDVDEFFNC.PLI (definition using functions)TE  	      _____________________________________________________________r  (               Table B-3 FMS Source Files  $               Language         Files  *               COBOL            SAMPCOB.LIB  ,                                SMPCOBUAR.LIB  +               FORTRAN          SMPACCOM.FOR   ,                                SMPREGCOM.FOR  ,                                SMPSTATUS.FOR  *                                SMPWORK.FORC 	      ____________________________________________________________r  )               Table B-4 FMS Command Filesf  +               Language         Command_File   *               BASIC            SAMPBAS.COM  *               BLISS            SAMPBLI.COM  I                                                  (continued on next page)     I                                Using the Sample Applications Programs B-3  y         .         Using the Sample Applications ProgramsA         B.1 Files Associated with the Sample Application Programs     1               Table B-4 (Cont.) FMS Command Files   +               Language         Command File   )               C                SAMPCC.COM   *               COBOL            SAMPCOB.COM  *               FORTRAN          SAMPFOR.COM  *               PASCAL           SAMPPAS.COM  *               PL/I             SAMPPLI.COM?  	      _______________________________________________________e  E         B.2 Running the Sample Application on Bisynchronous TerminalsP  G               If you do not plan to run the sample application programs D               on bisynchronous terminals, you can skip this section.  <               You can run the sample application programs onB               bisynchronous terminals with no modifications to theE               programs. Because of the bisynchronous terminal's width:E               restrictions, a form modification is required. The formuI               that is used on asynchronous terminals (VT52, VT100, VT2xx,eI               and so forth) to display the check register, REGISTER, doest9               not fit on a bisynchronous terminal screen.o  >               The Version 2.4 kit of DEC FMS software provides>               a replacement form for REGISTER that fits on the?               bisynchronous terminal screen. This form works onhC               aysnchronous terminals as well. The form is containedhA               in the form file named BISYNC_REGIST.FRM located ine               FMS$EXAMPLES:.  ?               Before running the sample application programs on E               bisynchronous terminals, use the following procedure to F               replace the REGISTER form in the sample application form                library, SAMP.FLB:  8               1. Log in to the system manager's account.  I               2. Enter the following command to save the current REGISTERoE                  form in a form file named FMS$EXAMPLES:REGISTER.FRM:i                  2         B-4 Using the Sample Applications Programs i         I                                    Using the Sample Applications Programs I             B.2 Running the Sample Application on Bisynchronous Terminals_         $ FMS/LIBRARY/EXTRACT-G     _$ FMS$EXAMPLES:SAMP/FORM=REGISTER/OUTPUT=FMS$EXAMPLES:REGISTER.FRMs  G               3. Enter the following command to insert the new REGISTERf                  form:  F     $ FMS/LIBRARY/REPLACE FMS$EXAMPLES:SAMP FMS$EXAMPLES:BISYNC_REGIST  B               After executing this command, you can run the sample?               application programs as documented here on eitherh6               asynchronous or bisynchronous terminals.  B               The REGISTER form now has a different appearance andC               different field attributes than those of the original E               REGISTER form documented in Introduction to VAX-11 FMS. E               These differences are required so that the form fits on G               the bisynchronous terminal screen. These differences have F               no effect on the form's function or interaction with the               program.  C         B.3 Running the Sample Application on MicroVAX Workstations   G               If you do not plan to run the sample application programs B               on MicroVAX workstations, you can skip this section.  D               The sample application programs can be run on MicroVAXA               workstations with no modifications to the programs.fA               However, to take advantage of the increased size of ?               the VT100 and VT200 windows on the workstation, arC               modification has been made to one of the forms in thelE               sample application. The REGISTER form, which contains arE               scrolled region to display the check register, has been I               modified to take advantage of a 55-line window. The Version E               2.4 kit of DEC FMS provides this form in the file namedt8               LONG_REGIST.FRM, located in FMS$EXAMPLES:.  F               To take advantage of the 55-line workstation window, useI               the following procedure to replace the REGISTER form in the28               sample application form library, SAMP.FLB:  8               1. Log in to the system manager's account.  <               2. Enter the following FMS DCL command to save?                  the current REGISTER form in a form file named                   I                                Using the Sample Applications Programs B-5o t         .         Using the Sample Applications ProgramsC         B.3 Running the Sample Application on MicroVAX Workstations?         $ FMS/LIBRARY/EXTRACT-G     _$ FMS$EXAMPLES:SAMP/FORM=REGISTER/OUTPUT=FMS$EXAMPLES:REGISTER.FRMv  G               3. Enter the following command to insert the new REGISTERe                  form.  D     $ FMS/LIBRARY/REPLACE FMS$EXAMPLES:SAMP FMS$EXAMPLES:LONG_REGIST  C               4. Enter the following command to set the workstationa)                  window size to 55 lines.l  '                  $ SET TERMINAL/PAGE=55   B               After executing this command, the sample application=               programs may be run as documented on a MicroVAXR               workstation.  F               The sample applications do not run on standard terminalsD               (VT52, VT100, VT2xx, and so forth) with the form LONG_3               REGIST in the form library, SAMP.FLB.I                                                                  2         B-6 Using the Sample Applications Programs y  i                    I                                                                         CaI         _________________________________________________________________t  I                                            Files Installed on Your Systemn    B               The following is a list of files added, replaced, orE               modified on your system by the Version 2.4 installationp"               of DEC FMS software.  I               ___________________________________________________________b*               File Name           FunctionI               ___________________________________________________________ 3                                 [SYSHLP] (SYS$HELP)o  H               HELPLIB.HLB           Module FMS added or replaced in help+                                     library   D               DECFMS024.RELEASE_    Online release notes for DEC FMS/               NOTES                 Version 2.4 I               ___________________________________________________________P5                                 [SYSEXE] (SYS$SYSTEM)   E               FMSFAA.EXE            FMS Form Application Aids UtilityV  >               FMSFCV.EXE            FMS Form Converter Utility  ;               FMSFED.EXE            FMS Form Editor Utilitya  H               FMSFLG.EXE            FMS Form Language Translator Utility  >               FMSFLI.EXE            FMS Form Librarian Utility  ;               FMSFTE.EXE            FMS Form Tester Utility   <               FMSFUU.EXE            FMS Form Upgrade UtilityI               ___________________________________________________________t0                             [SYSLIB] (SYS$SHARE)  ?               FDVSHR.EXE            Form Driver shareable imageR                    I                                        Files Installed on Your System C-1V N  L      &         Files Installed on Your System    I               ___________________________________________________________i*               File Name           FunctionI               ___________________________________________________________t0                           [SYSLIB] (SYS$LIBRARY)  H               DCLTABLES.EXE         DCL command FMS added or replaced in.                                     DCL tables  C               HLL11.OBJ             PDP-11 compatibility high level 6                                     language interface  F               IMAGELIB.OLB          Module FDVSHR added or replaced in+                                     library   G               STARLET.OLB           Module FDV$PLITRM added or replaced .                                     in libraryI               ___________________________________________________________u6                                 [SYSMGR] (SYS$MANAGER)  B               FMSTARTUP.COM         FMS startup procedure for full3                                     development kit   F               FDVSTRTUP.COM         FMS startup procedure for run-time'                                     kit I               ___________________________________________________________ 6                                 [SYSMGR] (SYS$MESSAGE)  <               FDVMSG.EXE            Form Driver message file  >               FMSMSG.EXE            FMS utilities message file                                                *         C-2 Files Installed on Your System K  0      I                                            Files Installed on Your Systemn    I               ___________________________________________________________n*               File Name           FunctionI               ___________________________________________________________ <                         [SYSHLP.EXAMPLES.FMS] (FMS$EXAMPLES)  F               FDVDEF.BAS            Form Driver symbol definition file-                                     for BASICP  F               FDVDEF.FOR            Form Driver symbol definition file/                                     for FORTRANr  F               FDVDEF.H              Form Driver symbol definition file)                                     for C   F               FDVDEF.LIB            Form Driver symbol definition file-                                     for COBOLy  F               FDVDEF.PAS            Form Driver symbol definition file.                                     for PASCAL  F               FDVDEF.REQ            Form Driver symbol definition file-                                     for BLISSu  F               FDVDEFCAL.PLI         Form Driver symbol definition file,                                     for PL/I  F               FDVDEFFNC.PLI         Form Driver symbol definition file,                                     for PL/I  D               MESSAGE.DIR           Directory for modifiable message.                                     proceduresA 	      __________________________________________________________T  E               In addition, if the system manager requested the sample G               application programs to be installed, the following filesa               also exist.i  I               ___________________________________________________________ +               File Name            FunctionlI               ___________________________________________________________o=                          [SYSHLP.EXAMPLES.FMS] (FMS$EXAMPLES)p  G               BISYNC_REGIST.FRM     Sample application REGISTER form to A                                     be used with bisync terminalsa  G               LONG_REGIST.FRM       Sample application REGISTER form toBF                                     be used with MicroVAX workstations  C               SAMP.BAS              BASIC sample application source   @               SAMP.DAT              Sample application data file      I                                        Files Installed on Your System C-3     M      &         Files Installed on Your System    I               ____________________________________________________________,               File Name             FunctionI               ___________________________________________________________ G               SAMP.EXE              BASIC sample application executable )                                     image   C               SAMP.FLB              Sample application form library I               ___________________________________________________________ =                          [SYSHLP.EXAMPLES.FMS] (FMS$EXAMPLES)r  B               SAMPBAS.COM           BASIC sample application build-                                     procedureA  C               SAMPBLI.BLI           BLISS sample application sourceA  B               SAMPBLI.COM           BLISS sample application build-                                     proceduree  G               SAMPBLI.EXE           BLISS sample application executablew,                                     image[1]  ?               SAMPCC.C              C sample application source   H               SAMPCC.COM            C sample application build procedure  C               SAMPCC.EXE            C sample application executablea,                                     image[1]  C               SAMPCOB.COB           COBOL sample application sourceh  B               SAMPCOB.COM           COBOL sample application build-                                     proceduree  G               SAMPCOB.EXE           COBOL sample application executableA,                                     image[1]  D               SAMPCOB.LIB           COBOL sample application library  D               SAMPFOR.COM           FORTRAN sample application build-                                     procedure   E               SAMPFOR.FOR           FORTRAN sample application source   I               SAMPFOR.EXE           FORTRAN sample application executablee,                                     image[1]  C               SAMPPAS.COM           PASCAL sample application buildc-                                     procedure   H               SAMPPAS.EXE           PASCAL sample application executable,                                     image[1]  I               [1]Present only if the language is available on the system.a  *         C-4 Files Installed on Your System B  6      I                                            Files Installed on Your System     I               ___________________________________________________________ -               File Name              FunctionhI               ___________________________________________________________,D               SAMPPAS.PAS           PASCAL sample application source  A               SAMPPLI.COM           PL/I sample application build -                                     procedure   F               SAMPPLI.EXE           PL/I sample application executable,                                     image[1]  B               SAMPPLI.PLI           PL/I sample application source  F               SMPACCOM.FOR          FORTRAN sample application include(                                     file  D               SMPCOBUAR.LIB         COBOL sample application library  G               SMPMEMRES.OBJ         Memory resident form module for the 7                                     sample applicationsn  F               SMPREGCOM.FOR         FORTRAN sample application include(                                     file  F               SMPSTATUS.FOR         FORTRAN sample application include(                                     file  D               SMPVECTOR.OBJ         UAR vector module for the sample0                                     applications  F               SMPWORK.FOR           FORTRAN sample application include(                                     file  I               ___________________________________________________________a:                              [SYSHLP.EXAMPLES.FMS.MESSAGE]  B               COMMSG.MSG            Message file common to all FMS-                                     utilities_  F               FAAMSG.MSG            Form application aids message file  ?               FCVMSG.MSG            Form converter message file   <               FDVMSG.MSG            Form driver message file  <               FEDMSG.MSG            Form editor message file  9               FIOMSG.MSG            File I/O message file   I               FLGMSG.MSG            Form language translator message fileK    I               [1]Present only if the language is available on the system.   I                                        Files Installed on Your System C-5m d  l      &         Files Installed on Your System    I               ___________________________________________________________ ,               File Name             FunctionI               ___________________________________________________________ ?               FLIMSG.MSG            Form librarian message files  A               FMSLIT.MSG            DEC FMS message file literals   F               FMS_MESSAGE.MEM       Guide to modifying DEC FMS message)                                     files   <               FTEMSG.MSG            Form Tester message file  E               FUUMSG.MSG            Form Upgrade Utility message file   @               MSGBLD.COM            Message file build procedure                                                                              *         C-6 Files Installed on Your System