                                   '              VAX FMS Installation Guide   &              Order Number: AA-MK64A-TE                      February 1989  L              This manual describes the VAX FMS installation and verification              procedures.          .              OPERATING SYSTEM:             VMS  >              SOFTWARE VERSION:             VAX FMS Version 2.4                    *              digital equipment corporation#              maynard, massachusetts                        @              ___________________________________________________  J              The information in this document is subject to change withoutJ              notice and should not be construed as a commitment by DigitalL              Equipment Corporation. Digital Equipment Corporation assumes noL              responsibility for any errors that may appear in this document.  I              The software described in this document is furnished under a J              license and may be used or copied only in accordance with the#              terms of such license.   M              No responsibility is assumed for the use or reliability of soft- H              ware on equipment that is not supplied by Digital Equipment5              Corporation or its affiliated companies.   F              (c) Digital Equipment Corporation 1983, 1984, 1986, 1989.  !              All Rights Reserved.               Printed in U.S.A.  M              The postpaid Reader's Comments forms at the end of this document K              request your critical evaluation to assist in preparing future               documentation.   K              The following are trademarks of Digital Equipment Corporation:   -              ALL-IN-1        EduSystem     RT 1              DEC             IAS           ULTRIX 1              DEC/CMS         MASSBUS       UNIBUS .              DEC/MMS         PDP           VAX5              DECnet          PDT           VAXcluster .              DECmate         P/OS          VMS-              DECsystem-10    Professional  VT 9              DECSYSTEM-20    Q-bus         Work Processor $              DECUS           Rainbow!              DECwriter       RSTS 2              DIBOL           RSX           DIGITAL                                     O                                                                        Contents O           _____________________________________________________________________     X           Preface .................................................................   vi    O           _____________________________________________________________________ 1           Chapter 1  Preparing to Install VAX FMS   Q                1.1  Required Operating System Components....................  1-1   Q                1.2  Prerequisite and Optional Software......................  1-2   S                1.3  Prerequisite Hardware.....................................  1-2   R                1.4  VMS License Management Facility .........................  1-2  Q                1.5  Installation Procedure Requirements.....................  1-3 U                      1.5.1  Restrictions........................................  1-3 V                      1.5.2  Time.................................................  1-3U                      1.5.3  Privileges..........................................  1-4 U                      1.5.4  Disk Space..........................................  1-4 T                      1.5.5  System Parameters..................................  1-5P                            1.5.5.1Checking System Parameter Values ........  1-5I                            1.5.5.2Calculating the Values for GBLPAGES and S                                   GBLSECTIONS.................................  1-6 G                            1.5.5.3Changing System Parameter Values with T                                   AUTOGEN .....................................  1-7S                      1.5.6  Process Account Quotas............................  1-8     O                                                                             iii                    S                      1.5.7  VMSINSTAL Requirements............................  1-9 R                      1.5.8  Backing Up Your System Disk...................... 1-10    O           _____________________________________________________________________ '           Chapter 2  Installing VAX FMS   T                2.1  General Information .......................................  2-1Q                      2.1.1  Accessing the Online Release Notes..............  2-1 I                      2.1.2  Determining the Files and Logical Names Added T                            to the System ......................................  2-2A                      2.1.3  Running the Installation Verification T                            Procedure...........................................  2-2S                      2.1.4  Aborting the Installation ........................  2-2   S                2.2  The Installation Procedure ...............................  2-3 T                      2.2.1  Invoking VMSINSTAL.................................  2-3S                      2.2.2  Installation Questions............................  2-4 S                      2.2.3  Informational Messages............................  2-8 A                      2.2.4  Running the Installation Verification T                            Procedure...........................................  2-9Q                      2.2.5  Completing the Installation Procedure .......... 2-10   U                2.3  Error Recovery ............................................. 2-10     O           _____________________________________________________________________ -           Chapter 3  After Installing VAX FMS   S                3.1  Editing the System Files..................................  3-1   S                3.2  User Account Requirements ................................  3-2 U                      3.2.1  Privileges..........................................  3-2 T                      3.2.2  User Account Quotas ...............................  3-2  T                3.3  Running the IVP............................................  3-4  T                3.4  Special Requirements ......................................  3-4               iv                   R                3.5  Enhancing VAX FMS Performance............................  3-4  Q                3.6  Determining and Reporting Problems......................  3-5     O           _____________________________________________________________________ >           Chapter 4  Verifying the Form Editor and Form Tester    O           _____________________________________________________________________ (           Appendix A Sample Installation  T                A.1  Full Development Kit ......................................  A-1  U                A.2  Run-Time Kit................................................  A-4     O           _____________________________________________________________________ ;           Appendix B Using the Sample Applications Programs   @                B.1  Files Associated with the Sample ApplicationW                      Programs ....................................................  B-2   C                B.2  Running the Sample Application on Bisynchronous V                      Terminals...................................................  B-5  >                B.3  Running the Sample Application on MicroVAXV                      Workstations................................................  B-6    O           _____________________________________________________________________ 3           Appendix C Files Installed on Your System                   O                                                                               v                      O           _____________________________________________________________________            TablesS                1-1  Disk Space Requirements...................................  1-4 R                1-2  Required System Parameter Values ........................  1-5O                1-3  Process Account Quotas for the Installing Account ....  1-8 Q                3-1  User Account Quotas for Using VAX FMS ..................  3-3 R                B-1  FMS Sample Application Programs .........................  B-1T                B-2  FMS Definition Files ......................................  B-3T                B-3  FMS Source Files...........................................  B-4T                B-4  FMS Command Files..........................................  B-4                                                                 vi                                   O                                                                         Preface O           _____________________________________________________________________       M              This manual describes how to install VAX Forms Management System B              (FMS) Version 2.4 and how to verify the installation.  F           ____________________________________________________________           Intended Audience   O              This manual is intended for those who install and maintain VAX FMS M              software. You should read this manual before installing VAX FMS.   N              To install VAX FMS, you must have access to a privileged account.M              To run the postinstallation Installation Verification Procedure, J              you must use a VT100- or VT200-series terminal or one that is              VT100-compatible.  F           ____________________________________________________________&           Operating System Information  D              VAX FMS Version 2.4 requires VMS Version 5.0 or higher.                           vi                 F           ____________________________________________________________           Structure   E              This manual contains four chapters and three appendixes:   N              Chapter 1   Describes the preparations and requirements necessary,                          for installing FMS.  B              Chapter 2   Describes the FMS installation procedure.  M              Chapter 3   Describes the tasks to perform after installing FMS.   @              Chapter 4   Describes the FMS postinstallation IVP.  M              Appendix A  Reproduces typical installation sessions and postin- 1                          stallation IVP sessions.   L              Appendix B  Describes the optional sample applications programs,                          available with FMS.  J              Appendix C  Details the files that are installed or modified.  F           ____________________________________________________________           Related Manuals   K              For additional information on installing FMS, refer to the VMS 3              system documentation for these topics:   $               o  VMSINSTAL procedure                  o  INSTALL Utility  1               o  System management and operations                 O                                                                             vii                  F           ____________________________________________________________           Conventions   8              This manual uses the following conventions:  M              <RETURN>  This symbol indicates the RETURN key. Unless otherwise O                        stated, end all user input lines in examples by pressing &                        the RETURN key.  :              Color     Color in examples shows user input.  N              $         The dollar sign represents the DIGITAL Command LanguageJ                        (DCL) prompt. (The DCL prompt on your system may be"                        different.)                                                               viii                                         T                                                                            Chapter 1    T                                                         Preparing to Install VAX FMST                _____________________________________________________________________      T                   This chapter discusses the preparations and requirements necessary)                   for installing VAX FMS.   R                   This manual applies to Version 2.4 of VAX FMS and all subsequentL                   maintenance releases up to the next major product release.  N                   Your bill of materials (BOM) and indented bills report (BIL)R                   specify the number and contents of your media. Be sure to verifyP                   the contents of your kit with this information. If your kit isS                   damaged or if you find that parts of it are missing, contact your )                   DIGITAL representative.   P                   VAX FMS provides online release notes. DIGITAL strongly recom-R                   mends that you read the release notes before proceeding with the                   installation.   K                ____________________________________________________________ 8                1.1  Required Operating System Components  Q                   VAX FMS supports the following list of VMS Version 5.0 classes:   *                    o  VMS Required Saveset  (                    o  Programming Supprt                      o  Utilities                 T                                                    Preparing to Install VAX FMS  1-1                           K                ____________________________________________________________ 6                1.2  Prerequisite and Optional Software  P                   This section discusses the software you must have installed onR                   your system before installing VAX FMS. The section also includesT                   information about software that you can use together with VAX FMS.S                   Please refer to the System Software Addendum (SSA) for a complete Q                   list of compatible products and their required version numbers. L                   The SSA is part of the Software Product Description (SPD).  I                   VAX FMS Version 2.4 requires VMS Version 5.0 or higher.   T                   If the optional software uses the VAX CDD/Plus, or if the VAX DBMSP                   is to be part of the system, you should install those softwareT                   products before you install VAX FMS. Note that CDDSHR.EXE must al-T                   ways be installed using the Install Utility (see Section 1.5.5.2).  K                ____________________________________________________________ )                1.3  Prerequisite Hardware   Q                   To run the postinstallation Installation Verification Procedure O                   (IVP), you must have a video terminal. See Chapter 4 for more :                   information on the postinstallation IVP.  K                ____________________________________________________________ 3                1.4  VMS License Management Facility   S                   The VMS License Management Facility is available with Version 5.0 Q                   of the VMS operating system. If you are installing VAX FMS on a S                   VMS Version 5.0 or higher system, you must register your software                    license. [1]  S                   The license registration information you need is contained in the S                   Product Authorization Key (PAK) that is shipped with VAX FMS. The P                   PAK is a paper certificate that contains information about theH                   license you own to run a particular piece of software.  S                   During the installation, you are asked if you have registered the S                   VAX FMS license and loaded the appropriate authorization key. You R                   must register and load your license for VAX FMS before you startP                   the installation in order to run the IVP and use the software.$                _____________________N              [1] VAX FMS can be installed without registering the FMS license.Q                  However, the IVP is not executed without a license registration. O                  In addition, the FMS utilities and applications using the form K                  driver are not run until a license is properly registered.X  0                1-2  Preparing to Install VAX FMS A  K                        R                   To register a license under VMS Version 5.0, first log in to theQ                   system manager's account, SYSTEM. You then have a choice of two 3                   ways to perform the registration:   U                    o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it promptsnM                      you for information, respond with data from your Productc-                      Authorization Key (PAK).-  U                    o  Issue the DCL command LICENSE REGISTER with the qualifiers that :                      correspond to information on the PAK.  N                   For complete information on using LMF, see the manual on theJ                   License Management Utility in the VMS documentation set.  K                ____________________________________________________________.7                1.5  Installation Procedure Requirements   T                   The following sections discuss various requirements for installing                   VAX FMS.  K                _____________________________________________________________"                1.5.1  Restrictions  T                   No users should be logged into the system while you are installingT                   FMS. You can use the REPLY command to send a message to users, for                   example:  E                     $ REPLY/ALL "Please log off now. Installing FMS."c  O                   If VMSINSTAL detects any users on the system, it gives you anMT                   opportunity to stop the installation procedure by prompting you toR                   continue. If you want to stop the installation, press the RETURN                   key.  K                ____________________________________________________________                 1.5.2  Time  R                   The installation takes approximately 15 to 60 minutes, dependingE                   on the type of media and your system configuration.r  S                   Installing VAX FMS and running the IVP on a standalone VAXstation -                   II system takes 17 minutes.           T                                                    Preparing to Install VAX FMS  1-3    T                      K                ____________________________________________________________p                 1.5.3  Privileges  Q                   To install VAX FMS, you must be logged into an account that hasb>                   SETPRV or at least the following privileges:                      o  CMKRNL                      o  WORLD                       o  SYSPRV  T                   Note that VMSINSTAL turns off BYPASS privilege at the start of the                   installation.   K                ____________________________________________________________o                 1.5.4  Disk Space  Q                   Installing VAX FMS requires a certain amount of free disk spacetR                   during the installation. Once VAX FMS is installed, less storageR                   space is required. Table 1-1 summarizes the storage requirements                   for VAX FMS.  4                   Table 1-1: Disk Space RequirementsT                   __________________________________________________________________3                                       Blocks DuringoT                   Kit_________________Installation_____Blocks_After_Installation____;                   VAX FMS Version     3000             2650_                   2.4_  :                   VAX FMS FDV         350              300                   Version 2.4lT                   __________________________________________________________________  S                   To determine the number of free disk blocks on the current systempF                   disk, enter the following command at the DCL prompt:  /                     $ SHOW DEVICE SYS$SYSDEVICE                     0                1-4  Preparing to Install VAX FMS                           K                ____________________________________________________________t'                1.5.5  System Parameters   P                   Installing VAX FMS requires certain system parameter settings.N                   Table 1-2 lists the minimum required system parameter valuesN                   for the installation. Depending on the kinds of programs andQ                   applications running at your site, you might need higher values_$                   for some settings.  =                   Table 1-2: Required System Parameter Values T                   __________________________________________________________________T                   System_Parameter___________Value__________________________________4                   GBLPAGES[1]                n + 250  2                   GBLSECTIONS[1]             n + 4T                   __________________________________________________________________R                   [1]The n variable refers to the system parameter values that areS                   currently in use. To install VAX FMS, you must raise those values A                   by the number indicated. (See Section 1.5.5.2.)AT                   __________________________________________________________________  O                   The following sections show you how to check system parameterlR                   values, calculate values for the GBLPAGES and GBLSECTIONS systemN                   parameters, and change parameter values with the VMS AUTOGEN$                   command procedure.  K                ____________________________________________________________ 8                1.5.5.1  Checking System Parameter ValuesT                   To check the values of your system parameters, enter the followingT                   command at the DCL prompt to invoke the System Generation Utility:  +                     $ RUN SYS$SYSTEM:SYSGEN_                     SYSGEN>   T                   At the SYSGEN> prompt, enter the SHOW command to display the valueT                   of a system parameter. The values displayed should equal or exceedT                   the the value of each parameter listed in Table 1-2. The followingO                   command displays the value for the GBLPAGES system parameter:r  )                     SYSGEN> SHOW GBLPAGES   Q                   After you finish checking the parameters with the SHOW command, S                   you can enter the EXIT command at the SYSGEN> prompt to return toA                   DCL level.        T                                                    Preparing to Install VAX FMS  1-5 i  h                      K                ____________________________________________________________ K                1.5.5.2  Calculating the Values for GBLPAGES and GBLSECTIONS-Q                   To install and run VAX FMS, you must set the correct values for2A                   the GBLPAGES and GBLSECTIONS system parameters._  O                   The n shown in the Table 1-2 represents the current number ofrR                   unused global pages or global sections available on your system.T                   For the installation to execute successfully, you must raise theseN                   values by the amount indicated. To calculate how many unusedO                   global pages and global sections your system has, perform thel"                   following steps:  S                    1. Run the VMS Install Utility (INSTALL) using the following DCLo                      command:t  6                        $ INSTALL LIST /GLOBAL /SUMMARY  O                      The Install Utility displays a summary of global pages and P                      global sections used by your system, as well as the current@                      number of unused global pages. For example:  O                                         Summary of Local Memory Global Sectionsi  U                        258 Global Sections Used,  22580/3420 Global Pages Used/Unusedw  Q                    2. Determine if the number of unused global pages (3420 in theeO                      example) is equal to or greater than 250. If the number ofnR                      unused pages is less than 250, you need to increase the value"                      for GBLPAGES.  P                    3. Note the amount shown for Global Sections Used (258 in the                      example).  S                    4. Run the System Generation Utility and use the SHOW command tohP                      determine how many global sections have been allocated. For                      example:c  .                        $ RUN SYS$SYSTEM:SYSGEN/                        SYSGEN> SHOW GBLSECTIONSX  `                        Parameter Name        Current   Default   Minimum   Maximum Unit  Dynamic`                        --------------        -------   -------   -------   ------- ----  -------[                        GBLSECTIONS               512       250        20      4095 Sections   S                    5. Subtract the amount shown in the summary (258 in the example) Q                      from the amount allocated. If the difference is less than 4, Q                      you need to increase the value of the GBLSECTIONS parameter.i      0                1-6  Preparing to Install VAX FMS                             O                   Section 1.5.5.3 describes the procedures for increasing these R                   values as well as those of other system parameters. Refer to theP                   VMS documentation on system management and operations for more                   information.  K                ____________________________________________________________ E                1.5.5.3  Changing System Parameter Values with AUTOGENsT                   You use the AUTOGEN command procedure to change system parameters.N                   AUTOGEN automatically adjusts values for parameters that areO                   associated with the ones you reset manually. To change system P                   parameters with AUTOGEN, you must edit the the following file:  ,                     SYS$SYSTEM:MODPARAMS.DAT  R                   Use an editor to access the file. If you need to change a param-R                   eter value that is already in the SYS$SYSTEM:MODPARAMS.DAT file,T                   simply delete the current value associated with that parameter and&                   enter the new value.  T                   To add a new value, add a line to the MODPARAMS.DAT file. The lineP                   contains the name of the parameter and its value. For example:  %                     GBLSECTIONS = 128   Q                   You can also modify incremental parameters in the MODPARAMS.DATQR                   file. The following example increases the global page setting by                   2000:   '                     ADD_GBLPAGES = 2000L  T                   After you have made all your changes, run the AUTOGEN procedure toT                   recalculate your system parameters. Enter the following command at!                   the DCL prompt:   8                     $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT  S                   AUTOGEN performs an automatic system shutdown and reboots when it_T                   has finished. Rebooting your system makes the new parameter values                   active.e  M                   When you reboot a system under VMS Version 5.0, the AutogeniS                   Utility automatically adjusts some of the SYSGEN parameters basediR                   on the consumption of resources since the last reboot. If you doR                   not want to take advantage of this automatic adjustment, includeH                   the /NOFEEDBACK qualifier on the AUTOGEN command line.        T                                                    Preparing to Install VAX FMS  1-7 1  2                        P                   For more information about using AUTOGEN, see the instructionsS                   on modifying system parameters in the VMS documentation on system.,                   management and operations.  K                ____________________________________________________________ ,                1.5.6  Process Account Quotas  T                   The account you use to install VAX FMS must have sufficient quotasQ                   to enable you to perform the installation. Table 1-3 summarizes.K                   the process quotas required for the installation account.s  N                   Table 1-3: Process Account Quotas for the Installing AccountT                   __________________________________________________________________T                   Account_Quota____Value____________________________________________%                   ASTLM            24   %                   BIOLM            18   )                   BYTLM            18,000.  %                   DIOLM            18a  %                   ENQLM            30.  %                   FILLM            20_T                   __________________________________________________________________  T                   User account quotas are stored in the file SYSUAF.DAT. You use theQ                   VMS Authorize Utility to verify and change user account quotas..P                   First set your directory to SYS$SYSTEM and then run AUTHORIZE:  ,                     $ SET DEFAULT SYS$SYSTEM#                     $ RUN AUTHORIZE                      UAF>  S                   At the Authorize Utility prompt (UAF>), use the SHOW command with.M                   an account name to check a particular account. For example:i  #                     UAF> SHOW SMITH.  O                   To change a quota, use the MODIFY command at the UAF> prompt..2                   MODIFY has the following format:  <                         MODIFY account-name /quota-name=nnnn      0                1-8  Preparing to Install VAX FMS .  .                        Q                   The following example changes the FILLM quota for the SMITH ac- B                   count and then exits from the Authorize Utility:  /                     UAF> MODIFY SMITH /FILLM=50.                     UAF> EXIT   S                   After you exit from the utility, the VMS system displays messages T                   indicating whether or not changes were made. Once the changes haveT                   been made, you must log out and log in again for the new quotas to                   take effect.  T                   For more information on modifying account quotas, see the descrip-M                   tion of the Authorize Utility in the VMS documentation set..  K                ____________________________________________________________.,                1.5.7  VMSINSTAL Requirements  E                   When you invoke VMSINSTAL, it checks the following:   O                    o  Whether you have set your default device and directory to                       SYS$UPDATE.  G                    o  Whether you are logged in to a privileged account   G                    o  Whether you have adequate quotas for installation.  6                    o  Whether DECnet is up and running  C                    o  Whether any users are logged in to the system_  T                   VMSINSTAL requires that the installation account have a minimum of'                   the following quotas:                         ASTLM = 24_                      BIOLM = 18_#                      BYTLM = 18,000n                      DIOLM = 18                       ENQLM = 30.                      FILLM = 20   O                   If VMSINSTAL detects any problems during the installation, it-R                   notifies you of the problem and asks if you want to continue theT                   installation. In some instances, you can enter YES to continue. ToP                   stop the installation process and correct the situation, enterN                   NO or press RETURN. Then correct the problem and restart the                   installation.         T                                                    Preparing to Install VAX FMS  1-9    5                      K                ____________________________________________________________n1                1.5.8  Backing Up Your System DiskB  R                   At the beginning of the installation, VMSINSTAL asks if you haveN                   backed up your system disk. DIGITAL recommends that you do aQ                   system disk backup before installing any software on top of the #                   operating system._  T                   Use the backup procedures that have been established at your site.T                   For details on performing a system disk backup, see the section onB                   the Backup Utility in the VMS documentation set.                                                                      1                1-10  Preparing to Install VAX FMS     m                                    T                                                                            Chapter 2    T                                                                   Installing VAX FMST                _____________________________________________________________________      Q                   This chapter describes how to install VAX FMS. Section 2.2 con-eQ                   tains a step-by-step description of the installation procedure.   K                ____________________________________________________________n'                2.1  General Information-  R                   This section includes information about accessing release notes,S                   determining files and logical names added to your system, running 9                   the IVP, and aborting the installation.e  K                ____________________________________________________________s8                2.1.1  Accessing the Online Release Notes  S                   VAX FMS provides online release notes. You must specify OPTIONS NlR                   when you invoke VMSINSTAL if you want the installation procedureS                   to give you an opportunity to display or print the online releaseoT                   notes. This question comes near the beginning of the installation.  R                   You should review the release notes in case they contain any in-T                   formation about changes in the installation procedure. If you haveP                   already reviewed the release notes, you do not need to specify                   OPTIONS N.  S                   Once VAX FMS has been installed, the release notes are located inr%                   the following file:d  4                     SYS$HELP:VAXFMS024.RELEASE_NOTES            T                                                              Installing VAX FMS  2-1    $                        S                   Online help also directs you to the release notes file. After the Q                   installation, you can enter the following command to review the :                   release notes through the HELP Facility:  ,                     $ HELP FMS RELEASE_NOTES  K                ____________________________________________________________RQ                2.1.2  Determining the Files and Logical Names Added to the Systems  T                   The files added, replaced, or modified on your system when VAX FMSR                   is installed are listed in Appendix C. They can also be found in9                   Appendix A of the online release notes.y  Q                   VAX FMS adds only one logical name--FMS$EXAMPLES--to the system N                   when it is installed. The files associated with FMS$EXAMPLESQ                   are listed in Appendix C as well as in Appendix A of the online                     release notes.  K                ____________________________________________________________UE                2.1.3  Running the Installation Verification Procedure   O                   The IVP for VAX FMS verifies the installation. During the in- Q                   stallation, you are asked if you want to run the IVP as part ofiR                   the installation. If you respond YES, VMSINSTAL runs the IVP. ItP                   is recommended that you run the IVP to be sure that VAX FMS is&                   installed correctly.  R                   After VAX FMS is installed, you can run the IVP independently toQ                   verify that the software is available on your system. You might Q                   also want to run the IVP after a system failure to be sure that +                   users can access VAX FMS.f  S                   Because of their interactive nature, the Form editor and the FormeP                   Tester must be tested manually on a VT100- or VT200-compatibleR                   terminal. To verify the installation of the Form Editor and FormC                   Tester, see the procedure explained in Chapter 4.   K                ____________________________________________________________ /                2.1.4  Aborting the Installationt  P                   To abort the installation procedure at any time, press CTRL/Y.O                   When you press CTRL/Y, the installation procedure deletes allhO                   files it has created up to that point and exits. You can then_/                   start the installation again.n      &                2-2  Installing VAX FMS _  _                      K                ____________________________________________________________ .                2.2  The Installation Procedure  R                   The VAX FMS installation procedure consists of a series of ques-R                   tions and informational messages. The following sections explainO                   how to invoke VMSINSTAL and answer the installation procedurei                   questions.  K                ____________________________________________________________ (                2.2.1  Invoking VMSINSTAL  S                   To start the installation, invoke the VMSINSTAL command procedureYR                   from a privileged account, such as the SYSTEM account. VMSINSTALQ                   is in the SYS$UPDATE directory. You use the following syntax to #                   invoke VMSINSTAL:a  P                         @SYS$UPDATE:VMSINSTAL product-name device-name OPTIONS N                     product-nameO                   The installation name for the component. For VAX FMS, use thei.                   following installation name:  !                         VAXFMS024                      device-nameaR                   The name of the device on which you plan to mount the media. ForO                   example, MTA0: is the device name for a tape drive. It is notsT                   necessary to use the console drive for this installation. However,S                   if you do use the console drive, you should replace any media youV<                   removed once the installation is complete.                     OPTIONS NOQ                   An optional parameter that indicates you want to be see the re-nO                   lease notes question. If you do not include the OPTIONS N pa-oN                   rameter, VMSINSTAL does not ask you about the release notes.P                   You should review the release notes before proceeding with theQ                   installation in case they contain new information about the in-M                   stallation.   P                   There are several other options you can select when you invokeS                   VMSINSTAL. See the VMS documentation on software installation forS/                   information on these options.r            T                                                              Installing VAX FMS  2-3 s  l                        P                   The following example displays the command to invoke VMSINSTALO                   to install VAX FMS from tape drive MTA0: and shows the systemnS                   response. This example uses the OPTIONS N release note parameter.   E                     $ @SYS$UPDATE:VMSINSTAL VAXFMS024 MTA0: OPTIONS N   N                           VAX/VMS Software Product Installation Procedure V5.0    /                     It is 14-NOV-1988 at 10:15. C                     Enter a question mark (?) at any time for help.o  R                   If you do not supply either the product name or the device name,T                   VMSINSTAL prompts you for this information later on in the instal-R                   lation procedure. VMSINSTAL does not prompt you for any options,R                   so be sure to include OPTIONS N on the VMSINSTAL command line toC                   access the release notes during the installation.   K                ____________________________________________________________ ,                2.2.2  Installation Questions  Q                   This section discusses the questions that appear during the in-DQ                   stallation. Appendix A contains a sample installation procedureo<                   showing how the questions can be answered.  R                   Each question in the installation is marked with an asterisk (*)O                   at the beginning of the line. Some questions show the default Q                   response in brackets, for example [YES]. If you want to use the 9                   default response, press the RETURN key.e  #                    1. DECnet statusU  T                      VMSINSTAL notifies you if DECnet is running and displays a listR                      of all active processes. It then asks if you want to continueQ                      the installation. You should install VAX FMS on a standalone O                      system or cluster with DECnet shut down. NO is the default .                      response to the question.  R                        %VMSINSTAL-W-DECNET, Your DECnet network is up and running.                           .r                           .                            . =                        * Do you want to continue anyway [NO]?o        &                2-4  Installing VAX FMS A  M                        #                    2. System backup_  Q                      VMSINSTAL asks if you are satisfied with your system backup.sQ                      You should always back up your system disk before performingYR                      an installation. If you are satisfied with the backup of yourR                      system disk, press RETURN. Otherwise, enter NO to discontinueR                      the installation. After you back up your system disk, you can.                      restart the installation.  U                        * Are you satisfied with the backup of your system disk [YES]?t  (                    3. Mounting the media  R                      You should now mount the first distribution volume on the de-S                      vice you specified when you invoked VMSINSTAL. The device nameyQ                      appears in the line preceding the question "Are you ready?".mR                      VMSINSTAL then asks you if you are ready to continue with the"                      installation.Q                      If you respond YES to indicate that you are ready, VMSINSTAL R                      displays a message that the media containing VAX FMS has beenR                      mounted on the specified device and that the installation has(                      begun. For example:  I                        Please mount the first volume of the set on MTA0:. +                        * Are you ready? YESeD                        %MOUNT-I-MOUNTED, VAX FMS MOUNTED ON _$$MTA0:@                        The following products will be processed:%                          VAX FMS V2.4t  J                            Beginning installation of VAX FMS V2.4 at 10:30  K                        %VMSINSTAL-I-RESTORE, Restoring product saveset A...e  T                      If you entered the wrong device name when you invoked VMSINSTALR                      and need to restart the installation, enter NO in response toQ                      the "Are you ready?" question. To abort the installation for 1                      other reasons, press CTRL/Y.   #                    4. Release Notes   S                      If you specified OPTIONS N when you invoked VMSINSTAL, you are R                      now asked to choose one of the five options for reviewing the#                      release notes.l          T                                                              Installing VAX FMS  2-5                             -                        Release Notes Options:   1                         1.  Display release notes_/                         2.  Print release notes (                         3.  Both 1 and 2:                         4.  Copy release notes to SYS$HELPG                         5.  Do not display, print or copy release notes   +                        * Select option [2]:   Q                      If you select option 1, VMSINSTAL displays the release notes S                      immediately on your terminal. You can terminate the display at 1                      any time by pressing CTRL/C. R                      If you select option 2, VMSINSTAL prompts you for the name of:                      the print queue that you want to use:  0                        * Queue name [SYS$PRINT]:  P                      You can press RETURN to send the file to the default outputF                      print device or you can enter another queue name.Q                      If you select option 3, VMSINSTAL displays the release notes_S                      immediately on the console terminal and then prompts you for at8                      queue name for the printed version.R                      Option 4 causes the installation to copy the release notes toP                      the help directory. Even if you do not select option 4, theT                      release notes for VAX FMS are copied to the SYS$HELP directory.T                      Select option 5 if you have already reviewed the release notes.  1                    5. Continuing the installationt  T                      The installation procedure now asks if you want to continue theS                      installation. To continue, enter YES. Otherwise, press RETURN.sR                      In either case, the release notes are copied to a file in the5                      SYS$HELP directory. For example:   K                        * Do you want to continue the installation [N]?: YES S                        %VMSINSTAL-I-RELMOVED, The product's release notes have been_6                        successfully moved to SYS$HELP.  I                      The release notes are located in the following file:m  7                        SYS$HELP:VAXFMS024.RELEASE_NOTESe  7                                                    NOTE   H                          The name of the release notes file installed byP                          VMSINSTAL consists of the current product name and ver-  &                2-6  Installing VAX FMS e  l                        N                          sion number. Do not delete release notes for previous-                          versions of VAX FMS.i  *                    6. License Registration  R                      The installation procedure displays license information aboutQ                      your product and then asks if you have registered and loadedeE                      your authorization key for VAX FMS. For example:   -                        Product:       VAX FMS )                        Producer:      DEC )                        Version:       2.4 1                        Release Date:  14-NOV-1988_  [                        * Does this product have an authorization key registered and loaded?C  R                      If you have not registered and loaded your authorization key,R                      you must answer NO to this question. You have to register andQ                      load your product authorization key to successfully complete S                      the installation. If you have not done so, you should stop the T                      installation, register and load your product authorization key,7                      and then restart the installation.n  -                    7. Choosing to run the IVPa  O                      The installation procedure now asks if you want to run the T                      Installation Verification Procedure. The IVP for VAX FMS checksQ                      to be sure that the installation is successful. It is recom-Y1                      mended that you run the IVP.y  Q                        * Do you want to run the IVP after the installation [YES]?y  -                    8. Choosing to purge files   Q                      You have the option to purge files from previous versions of N                      VAX FMS that are superseded by this installation. PurgingP                      is recommended; however, if you need to keep files from theL                      previous version, enter NO in response to the question.  X                        * Do you want to purge files replaced by this installation [YES]?  *                    9. Installation Options  R                      You are now asked to choose your installation options. If youS                      answer YES to the prompt, the VAX FMS modifiable message files ;                      and sample applications are installed.W        T                                                              Installing VAX FMS  2-7                             Z                        * Do you wish to install Sample Application Programs and Modifiable5                        Message File Procedures [YES]?_  L                      The Sample Application Programs are used throughout theM                      VAX FMS documentation as examples of VAX FMS programmingnN                      techniques. The files relating to the sample applicationsO                      are found in the FMS$EXAMPLES: directory and are listed ineP                      Appendix C. The VAX FMS installation and start-up procedureQ                      (SYS$STARTUP:FMSTARTUP.COM) defines a system logical for thes-                      FMS$EXAMPLES: directory. P                      See Appendix A for more detailed information concerning the1                      Sample Application Programs.oQ                      The Modifiable Message File Procedure creates a subdirectory R                      containing the sources for the FMS Message Files and instruc-T                      tions on how to modify the text of the messages in the FMS FormQ                      Driver and FMS Utilities. The message files are found in the4P                      subdirectory SYS$SYSROOT:[SYSHLP.EXAMPLES.FMS.MESSAGE]. TheQ                      instructions for modifying the message files are in the FMS_e;                      MESSAGE.MEM file in that subdirectory.u  .                    10.Additional media volumes  L                      If your installation kit contains more than one volume,T                      VMSINSTAL prompts you to insert the additional volumes and thenT                      asks you to indicate that you are ready for the installation to                      proceed.   P                        %BACKUP-I-READYREAD, mount volume 2 on _MTA0: for reading  .                        Enter "YES" when ready:  K                ____________________________________________________________e,                2.2.3  Informational Messages  P                   At this point, the installation procedure displays a number ofO                   informational messages that report on the progress of the in- Q                   stallation. There are no further questions. If the installation Q                   procedure has been successful up to this point, VMSINSTAL moves P                   the new or modified files to their target directories, updatesT                   help files, and updates DCL tables, if necessary. If you asked forR                   files to be purged, that is done now. The following messages are                   displayed:  b                     %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories...      &                2-8  Installing VAX FMS l  i                        R                   If the installation procedure is successful, the following files6                   are moved to their target directory:  +                    o  SYS$SYSTEM:FMSFAA.EXEu  +                    o  SYS$SYSTEM:FMSFCV.EXE   +                    o  SYS$SYSTEM:FMSFED.EXEV  +                    o  SYS$SYSTEM:FMSFLG.EXEa  +                    o  SYS$SYSTEM:FMSFLI.EXE   +                    o  SYS$SYSTEM:FMSFTE.EXEn  +                    o  SYS$SYSTEM:FMSFUU.EXE   U                   In addition, the SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE R                   files are updated to include the new version of the VAX FMS HELPQ                   text and the FMS command line definition, respectively. The VAX Q                   FMS release notes are copied to the SYS$HELP:VAXFMS024.RELEASE_                    NOTES file.   T                   For a complete list of files that have been created or modified by=                   the installation procedure, see Appendix C.   K                ____________________________________________________________dE                2.2.4  Running the Installation Verification Procedure   Q                   If you chose to run the IVP, VMSINSTAL runs it now. You see the $                   following display:  D                     Beginning VAX FMS V2.4 Installation Procedure...  R                   If VAX FMS has been successfully installed, the IVP displays the$                   following message:  R                     VAXFMS V2.4 Installation Verification Procedure was successfulT                     Refer to the VAX FMS Installation Guide for further verification                      procedures..  P                   You can run the IVP separately any time after FMS has been in-E                   stalled. To run the IVP, use the following command:e  ;                     @SYS$SYSDEVICE:[SYS$TEST.FMS]VAXFMS$IVPd            T                                                              Installing VAX FMS  2-9                           K                ____________________________________________________________s;                2.2.5  Completing the Installation Procedure   N                   The following messages indicate that the entire installation(                   procedure is complete:  F                        Installation of VAX FMS V2.4 completed at 11:03  8                        VMSINSTAL procedure done at 11:17  @                   You can now log out of the privileged account:                       $ LOGOUTD                     SYSTEM     logged out at 14-NOV-1988 11:24:32.40  S                   VMSINSTAL deletes or changes entries in the process symbol tablesaR                   during the installation. Therefore, if you are going to continueR                   using the system manager's account and you want to restore these?                   symbols, you should log out and log in again.   K                ____________________________________________________________."                2.3  Error Recovery  S                   If errors occur during the installation itself or when the IVP is.S                   running, VMSINSTAL displays failure messages. If the installation 7                   fails, you see the following message:l  V                     %VMSINSTAL-E-INSFAIL, The installation of VAX FMS V2.4 has failed.  ;                   If the IVP fails, you see these messages:   P                     The VAX FMS V2.4 Installation Verification Procedure failed.  N                     %VMSINSTAL-E-IVPFAIL, The IVP for VAX FMS V2.4 has failed.  R                   Errors can occur during the installation if any of the following#                   conditions exist:   @                    o  The operating system version is incorrect.  T                    o  Quotas necessary for successful installation are insufficient.  T                    o  System parameter values for successful installation are insuf-                      ficient.   ?                    o  The VMS help library is currently in use.   M                    o  The product license has not been registered and loaded.       '                2-10  Installing VAX FMSn o  d                        P                   For descriptions of the error messages generated by these con-Q                   ditions, see the VMS documentation on system messages, recoverytP                   procedures, and VMS software installation. If you are notifiedS                   that any of these conditions exist, you should take the appropri-oS                   ate action as described in the message. (You might need to change P                   a system parameter or increase an authorized quota value.) ForJ                   information on installation requirements, see Chapter 1.                                                                            T                                                             Installing VAX FMS  2-11 n  e                                    T                                                                            Chapter 3    T                                                             After Installing VAX FMST                _____________________________________________________________________      T                   After installing VAX FMS, you need to perform the following tasks:  4                    o  Edit the system startup files.  .                    o  Set user account quotas.    K                ____________________________________________________________ ,                3.1  Editing the System Files  R                   You must edit two system start-up files to provide for automaticB                   startup of VAX FMS when your system is rebooted:  T                    1. Add the command line that starts VAX FMS to the system startupS                      file, SYS$MANAGER:SYSTARTUP_V5.COM. VAX FMS cannot start until P                      the network has started. You must position this new commandQ                      line after the line that invokes the network startup command O                      procedure. The following example shows the network startup S                      command line followed by the startup command line for VAX FMS:   2                        $ @SYS$MANAGER:STARTNET.COM                             .                              .L                             .e3                        $ @SYS$STARTUP:FMSTARTUP.COMl    R                    2. The FMS start-up command procedure contains several VMS com-S                      mands. The first command assigns the logical name FMS$EXAMPLES R                      to the directory that contains the VAX FMS Version 2.4 Sample*                      Application Programs.    T                                                        After Installing VAX FMS  3-1 h  e                        R                      The last commands in the command procedure install FDVSHR andQ                      FDVMSG as known shared images. To improve the performance of S                      FMS application programs further, you can remove the followinge-                      line from FMSTARTUP.COM:   N                        $ EXIT         ! Remove this line to install the images  T                      If you have made any changes to the FMSTARTUP.COM file, use theS                      SHUTDOWN procedure to stop the current system, and rebootstrap                        the system.    K                ____________________________________________________________i-                3.2  User Account Requirements   N                   To work with VAX FMS, user accounts on your system must haveN                   certain privileges and quotas. The next two sections containP                   information on these requirements. The third section discusses'                   special requirements.n  K                ____________________________________________________________a                 3.2.1  Privileges  R                   To use VAX FMS, each account must have at least the TMPMBX priv-Q                   ilege. Use the VMS Authorize Utility to determine whether users 3                   have the privileges they require.S  K                ____________________________________________________________w)                3.2.2  User Account Quotast  S                   You must make sure that the appropriate user accounts have suffi-eR                   cient quotas to be able to use VAX FMS. Table 3-1 summarizes the/                   required user account quotas.r                          ,                3-2  After Installing VAX FMS i  a                        B                   Table 3-1: User Account Quotas for Using VAX FMST                   __________________________________________________________________T                   Account_Quota____Value____________________________________________%                   ASTLM            24   %                   BIOLM            18   %                   DIOLM            18e  %                   ENQLM            30a  %                   FILLM            20mT                   __________________________________________________________________  T                   User account quotas are stored in the file SYSUAF.DAT. You use theQ                   VMS Authorize Utility to verify and change user account quotas.mP                   First set your directory to SYS$SYSTEM and then run AUTHORIZE:  ,                     $ SET DEFAULT SYS$SYSTEM#                     $ RUN AUTHORIZEe                     UAF>  P                   At the Authorize Utility prompt (UAF>), enter the SHOW commandR                   with an account name to check that particular account. For exam-                   ple:  #                     UAF> SHOW SMITH   O                   To change a quota, use the MODIFY command at the UAF> prompt. 2                   MODIFY has the following syntax:  <                         MODIFY account-name /quota-name=nnnn  Q                   The following example changes the ENQLM quota for the SMITH ac- 8                   count and then exits from the utility:  /                     UAF> MODIFY SMITH /ENQLM=50l                     UAF> EXIT   S                   After you exit from the utility, the VMS system displays messages Q                   indicating whether or not changes were made. Once you have fin- S                   ished making the changes, the users must log out and log in againu4                   for the new quotas to take effect.  T                   For more information on modifying account quotas, see the descrip-M                   tion of the Authorize Utility in the VMS documentation set.       T                                                        After Installing VAX FMS  3-3                           K                ____________________________________________________________L#                3.3  Running the IVPD  T                   When FMS is installed, the IVP is automatically placed in the fol-R                   lowing location: SYS$SYSDEVICE:[SYS$TEST.FMS]VAXFMS$IVP.COM. TheR                   IVP is placed there even if you chose not to run it at installa-                   tion time.  Q                   You can run the IVP at any time after FMS has been installed by 0                   issuing the following command:  ;                     @SYS$SYSDEVICE:[SYS$TEST.FMS]VAXFMS$IVPe  K                ____________________________________________________________ (                3.4  Special Requirements  T                   To prevent data loss, users should set their terminals to HOSTSYNCR                   and TYPAHEAD before using VAX FMS. For more information, see the'                   online release notes.e  K                ____________________________________________________________ 1                3.5  Enhancing VAX FMS Performances  Q                   This section includes information on system tuning and explainsh;                   how to install VAX FMS as a shared image.   Q                   The VAX FMS Version 2.4 Form Driver is built as a shared image. P                   If several users who run FMS applications at the same time areQ                   on your system, each user has a copy of the Form Driver in mem-oR                   ory. If you install the Form Driver as a known shared image, theQ                   users share a single copy of the Form Driver in memory when FMS '                   applications are run.e  R                   A known shared image reduces memory requirements and can improve%                   system performance.   P                   To install VAX FMS as a known shared image on a system that isQ                   currently running, use the VMS Install Utility (INSTALL). It is P                   recommended that you perform the install operation on a systemT                   that has just been bootstrapped because the available space in theD                   global page table is less likely to be fragmented.            ,                3-4  After Installing VAX FMS r  t                        S                   To install VAX FMS as a shared image, first, determine the numberoS                   of available global pages and global sections on your system. SeeSQ                   Section 1.5.5.2 for information on how to verify and modify thelT                   number of global pages and global sections. Table 1-2 contains the7                   required values for these parameters.   Q                   Once you have reset the system parameter values, invoke the VMS T                   Install Utility from a privileged account and then install VAX FMS$                   as a shared image:                       $ INSTALL C                     INSTALL> ADD SYS$SHARE:FDVSHR.EXE /OPEN /SHARED E                     INSTALL> ADD SYS$MESSAGE:FDVMSG.EXE /OPEN /SHAREDa!                     INSTALL> EXIT   P                   You must now add the following lines to the appropriate systemS                   startup command file so that each time the system is started, VAX S                   FMS is available as a shared image. (If your site has modularizedfR                   its startup procedures, be sure you add the lines to the correctO                   file. The default startup command file for VMS Version 5.0 is 0                   SYS$MANAGER:SYSTARTUP_V5.COM.)                       $ INSTALL C                     INSTALL> ADD SYS$SHARE:FDVSHR.EXE /OPEN /SHAREDcD                     INSTALL> ADD SYS$MESSAGEFDVMSG.EXE /OPEN /SHARED!                     INSTALL> EXIT   Q                   When you install VAX FMS as a shared image you need to increasenR                   the global pages and global sections parameters. Increase globalQ                   pages (GBLPAGES) by 250 pages and global sections (GBLSECTIONS)aS                   by 4 sections. Refer to Section 1.5.5 for information on changing$#                   these parameters.   K                ____________________________________________________________ 6                3.6  Determining and Reporting Problems  P                   If an error occurs while VAX FMS is being used and you believeQ                   that the error is caused by a problem with VAX FMS, take one ofE(                   the following actions:  O                    o  If you have a BASIC or DECsupport Software Agreement, younS                      should call your Customer Support Center. With these services,nT                      you receive telephone support that provides high-level advisory-                      and remedial assistance.       T                                                        After Installing VAX FMS  3-5                             P                    o  If you have a Self-Maintenance Software Agreement, you can@                      submit a Software Performance Report (SPR).  T                    o  If you purchased VAX FMS within the past 90 days and you thinkP                      the problem is caused by a software error, you can submit a7                      Software Performance Report (SPR).s  O                   If you find an error in the VAX FMS documentation, you should_S                   fill out and submit the Reader's Comments form at the back of theVT                   document in which the error occurred. Include the section and page2                   number where the error occurred.                                                                      ,                3-6  After Installing VAX FMS                                         T                                                                            Chapter 4    T                                            Verifying the Form Editor and Form TesterT                _____________________________________________________________________      S                   Because of their interactive nature, the Form Editor and the Form_P                   Tester must be tested manually on a VT100- or VT200-compatibleT                   terminal. The following procedure verifies the installation of the2                   Form Editor and the Form Tester.  I                    1. Log in using a VT100- or VT200-compatible terminal.   <                    2. Create a form to test the Form Editor.  Q                      Issue the SET TERMINAL/INQUIRE command to request a responseVT                      sequence from your terminal. To create a form, specify the nameP                      of a file that does not exist in the current directory. (InP                      this example, the file is called testfile.frm.) The default'                      file type is .FRM.   .                        $  SET TERMINAL/INQUIRE/                        $  FMS/EDIT testfile.frm   7                    3. Select a Form Editor Menu option._  Q                      After you have entered the Form Editor, select LAYOUT at theST                      Phase Choice prompt. The screen is cleared and the Layout PhaseF                      status line appears at the bottom of your screen.  +                        Phase Choice: LAYOUT   2                    4. Type some text. For example:  -                        This is a test of FMS.             T                                       Verifying the Form Editor and Form Tester  4-1    o                        T                      You have just entered text into your form. If you want to enterR                      field mode, press the PF1 key and then the keypad 8 key. TypeM                      the letter x six times to indicate a field. For example:                   <PF1>                         <KP8>                         XXXXXXh  +                    5. Exit the Form Editor.   S                      Press the PF1 key and the keypad 7 key to exit from the LayoutMQ                      Phase of the Form Editor. The Form Editor Menu reappears; atf<                      the prompt, type EXIT and press RETURN.                  <PF1>                         <KP7>c)                        Phase Choice: EXITa  $                    6. Save the form.  R                      After you have exited Layout Phase, the Editor prompts you toB                      save the file. Press RETURN to save the form.  7                        $ Do you want to save this form?tQ                         %FMS-I-FORMSAVED, Form testfile.frm saved in testfile.frm   $                    7. Test the form.  -                        $FMS/TEST testfile.frm_  Q                      FMS displays your form. Type any seven characters. Note that T                      the seventh character does not echo on the screen. The terminalQ                      bell rings and an error message indicating that the field isOS                      full is displayed at the bottom of your terminal screen. Pressa7                      RETURN. The system prompt appears.o                          123456e                <RETURN>b                          $  +                    8. Delete the form file.   .                        $ DELETE testfile.frm;*  R                      The test is complete. If any errors occurred during the test,<                      follow the instructions in Section 2.3.        =                4-2  Verifying the Form Editor and Form Tester     A                                    T                                                                           Appendix A    T                                                                  Sample InstallationT                _____________________________________________________________________      O                   This appendix contains sample installations of VAX FMS. These R                   samples were run on a system that had no previous version of VAX                    FMS installed.  Q                   The sample installation assumes that DECnet has been shut down,eN                   that no users are logged on to your system, and that OPTIONSM                   N is specified to print the release notes. The InstallationiS                   Verification Procedure (IVP) runs at the end of the installation.r  K                ____________________________________________________________c(                A.1  Full Development Kit  R                   This section contains a sample installation for the VAX FMS full"                   development kit.  (                     $ SET DEF SYS$UPDATE                      $ @VMSINSTALI                      VAX/VMS Software Product Installation Procedure V5.0   /                     It is 29-NOV-1988 at 17:35.aC                     Enter a question mark (?) at any time for help.tV                     * Are you satisfied with the backup of your system disk [YES]? YESK                     * Where will the distribution volumes be mounted: MUA0:i                    T                                                             Sample Installation  A-1 e                           ^                     Enter the products to be processed from the first distribution volume set.)                     * Products: VAXFMS024s                      * Options: NG                     Please mount the first volume of the set on  MUA0:. (                     * Are you ready? YES>                     %MOUNT-I-MOUNTED, VAXFMS mounted on _MUA0:=                     The following products will be processed: !                       VAXFMS V2.4 C                      Beginning installation of VAXFMS V2.4 at 17:37   I                     %VMSINSTAL-I-RESTORE, Restoring product saveset A ...   .                         Release Notes Options:  .                      1.  Display release notes,                      2.  Print release notes%                      3.  Both 1 and 2d7                      4.  Copy release notes to SYS$HELPaD                      5.  Do not display, print or copy release notes  *                     * Select option [2]: 4C                     * Do you want to continue the installation? YESVQ                     %VMSINSTAL-I-RELMOVED , The product's release notes have been 3                     successfully moved to SYS$HELP.S  8                                   Product:       VAX FMS4                                   Producer:      DEC4                                   Version:       2.4<                                   Release Date:  14-NOV-1988  \                     * Does this product have an authorization key registered and loaded? YESR                     * Do you want to run the IVP after the installation [YES]? YESY                     * Do you want to purge files replaced by this installation [YES]? YES     [                       If you wish to save space on your system disk you may  choose  not torX                       install the Sample Application Programs and the Modifiable Messagec                       File Procedures.  You may later install them by installing VAXFMS V2.4 again.   _                     * Do you wish to install Sample Application Programs and Modifiable MessageA*                     File Procedures [YES]?I                     %VMSINSTAL-I-RESTORE, Restoring product saveset B ..._I                     %VMSINSTAL-I-RESTORE, Restoring product saveset C ... I                     %VMSINSTAL-I-RESTORE, Restoring product saveset D ... ^                     %VAXFMS-I-CONTINUE, All inquiries have been requested. If no errors occur,_                     -VAXFMS-I-CONTINUE, the installation will be completed in about 20 minutes.de                     %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.FMS].     '                A-2  Sample Installation                              \                         If you intend to execute this layered product on other nodes in your[                         VAXcluster, and you have the appropriate software license, you mustN[                         prepare the system-specific roots on the other nodes by issuing the ]                         following command on each node (using a suitably privileged account):   K                      $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.FMS]e  #                     System Manager:   H                          Upon completion of this installation, please beH                          sure  to  edit  the  system  startup  files  asE                          described in the VAX FMS Installation Guide.   Y                     %VAXFMS-S-FMSBUILT, VAXFMS V2.4 has built successfully, continuing... a                     %VAXFMS-I-STARTSAMP, Starting the Sample Application Programs installation... k                     %VAXFMS-S-SAMPBUILT, Sample Application Programs have built successfully, continuing...Sd                     %VAXFMS-I-CONTINUE, Starting Modifiable Message File Procedures installation ...m                     %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.FMS.MESSAGE].s  \                         If you intend to execute this layered product on other nodes in your[                         VAXcluster, and you have the appropriate software license, you must [                         prepare the system-specific roots on the other nodes by issuing thec]                         following command on each node (using a suitably privileged account):   g                      $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.FMS.MESSAGE]/PROT=(S:RWED,O,G,W)bb                     %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  T                     Beginning the VAXFMS V2.4 Installation Verification Procedure...  R                     VAXFMS V2.4 Installation Verification Procedure was successfulb                     Refer to the VAX FMS Installation Guide for further verification procedures...  C                      Installation of VAXFMS V2.4 completed at 17:54d  ]                     Enter the products to be processed from the next distribution volume set. $                     * Products: EXIT6                      VMSINSTAL procedure done at 17:55                     $_                        T                                                             Sample Installation  A-3 d                         K                ____________________________________________________________                  A.2  Run-Time Kit  R                   This section contains a sample installation for the VAX FMS run-                    time only kit.  (                     $ SET DEF SYS$UPDATE                      $ @VMSINSTALK                      VAX/VMS Software Product Installation Procedure V5.0-2O  /                     It is 29-NOV-1988 at 17:23.eC                     Enter a question mark (?) at any time for help. V                     * Are you satisfied with the backup of your system disk [YES]? YESK                     * Where will the distribution volumes be mounted: MUA0:   ^                     Enter the products to be processed from the first distribution volume set.)                     * Products: FMSFDV024                      * Options:G                     Please mount the first volume of the set on  MUA0:.e(                     * Are you ready? YES>                     %MOUNT-I-MOUNTED, FMSFDV mounted on _MUA0:=                     The following products will be processed: !                       FMSFDV V2.4tC                      Beginning installation of FMSFDV V2.4 at 17:25f  I                     %VMSINSTAL-I-RESTORE, Restoring product saveset A ...l  8                                   Product:       VAX FMS4                                   Producer:      DEC4                                   Version:       2.4<                                   Release Date:  14-NOV-1988  \                     * Does this product have an authorization key registered and loaded? YESN                     * Do you want to run the IVP after the installation [YES]?U                     * Do you want to purge files replaced by this installation [YES]?   #                     System Manager:   H                          Upon completion of this installation, please beH                          sure  to  edit  the  system  startup  files  asH                          described in the  VAX  FMS  INSTALLATION GUIDE.  Y                     %FMSFDV-S-FDVBUILT, FMSFDV V2.4 has built successfully, continuing...i  T                     Beginning the FMSFDV V2.4 Installation Verification Procedure...  U                     FMSFDV V2.4 Installation Verification Procedure was successful...h  C                      Installation of FMSFDV V2.4 completed at 17:28     '                A-4  Sample Installationm t  e                        6                      VMSINSTAL procedure done at 17:29                     $                                                                                       T                                                             Sample Installation  A-5                                         T                                                                           Appendix B    T                                               Using the Sample Applications ProgramsT                _____________________________________________________________________      M                   The VAX FMS Version 2.4 installation and start-up procedureeQ                   SYS$STARTUP:FMSTARTUP.COM defines a system logical name for the T                   FMS$EXAMPLES: directory. This directory contains files relating toF                   the VAX FMS Version 2.4 Sample Application Programs.  Q                   If you are planning to run the Sample Application Programs on ae?                   bisynchronous terminal, refer to Section B.2.   N                   VAX FMS Version 2.4 provides the Sample Application Programs&                   listed in Table B-1.  <                   Table B-1: FMS Sample Application ProgramsT                   __________________________________________________________________T                   Language____Program_Name_____Executable_Image_____________________7                   BASIC       SAMP.BAS         SAMP.EXE   :                   BLISS       SAMPBLI.BLI      SAMPBLI.EXE  9                   C           SAMPCC.C         SAMPCC.EXE.  :                   COBOL       SAMPCOB.COB      SAMPCOB.EXE  :                   FORTRAN     SAMPFOR.FOR      SAMPFOR.EXE  :                   PASCAL      SAMPPAS.PAS      SAMPPAS.EXE  :                   PL/I        SAMPPLI.PLI      SAMPPLI.EXET                   __________________________________________________________________  Q                   To run the BASIC Sample Application Program, type the followingy                   command:  T                                          Using the Sample Applications Programs  B-1 e  e                        +                     $ RUN FMS$EXAMPLES:SAMP   O                   If, while you are running the Sample Application Program, yourR                   choose to write checks, a data file called SAMPCH.DAT is createdS                   in your default directory when you press the PF4 key to write ther                   check.  K                ____________________________________________________________II                B.1  Files Associated with the Sample Application Programsp  Q                   Files that help you generate the Sample Application Program areuR                   included in the FMS$EXAMPLES: directory. These files are as fol-                   lows:p  6                    o  Files associated with SAMP formsN                      The Sample Application Program forms are stored in a form'                      library, SAMP.FLB.wN                      Two additional forms are provided to successfully run theO                      Sample Application on either a bisynchronous terminal or anO                      MicroVAX Workstation. The forms are contained in the filesdS                      BISYNC_REGIST.FRM and LONG_REGIST.FRM, and are designed to re-eT                      place the REGISTER form in the Sample Application form library,P                      SAMP.FLB. The BISYNC_REGIST.FRM file enables you to run theQ                      Sample Application successfully on a bisynchronous terminal.rS                      The LONG_REGIST.FRM enables you to produce and display 55-linee4                      forms on MicroVAX Workstations.  @                    o  Files produced by the FMS Application AidsN                      The memory-resident form file, SMPMEMRES.OBJ, and the UARO                      vector file, SMPVECTOR.OBJ, are included in a link commandi9                      to produce an executable SAMP image.   )                    o  SAMP data base filenO                      The SAMP.DAT file provides the account data for the SampleS*                      Application Programs.  O                    o  Source files that contain FMS definitions (see Table B-2)sQ                      The FMS definition files provide definitions for Form Driver S                      symbols used in the Sample Application Programs. Many of these R                      files are used directly by the appropriate language constructR                      (INCLUDE, COPY, REQUIRE, ENVIRONMENT, and so forth) to defineT                      the symbols in the programs. You may want to use these files asO                      examples that you can tailor to fit your own applications.T      :                B-2  Using the Sample Applications Programs                                 1                   Table B-2: FMS Definition FilesPT                   __________________________________________________________________T                   Language_________Definition_File__________________________________-                   BASIC            FDVDEF.BAS   -                   BLISS            FDVDEF.REQo  +                   C                FDVDEF.H   -                   COBOL            FDVDEF.LIBs  -                   FORTRAN          FDVDEF.FOR   -                   PASCAL           FDVDEF.PASL  I                   PL/I             FDVDEFCAL.PLI (definition using calls)I  M                   PL/I             FDVDEFFNC.PLI (definition using functions) T                   __________________________________________________________________  K                    o  Additional source files for languages (see Table B-3) S                      Some of the Sample Application Programs have source files con-uT                      taining convenient definitions that relate only to a particular                      language.                                      T                                          Using the Sample Applications Programs  B-3 L  o                        -                   Table B-3: FMS Source Files T                   __________________________________________________________________T                   Language_________Files____________________________________________.                   COBOL            SAMPCOB.LIB  0                                    SMPCOBUAR.LIB      /                   FORTRAN          SMPACCOM.FOR   0                                    SMPREGCOM.FOR  0                                    SMPSTATUS.FOR  .                                    SMPWORK.FORT                   __________________________________________________________________  P                    o  Command files that compile and link the Sample ApplicationB                      Programs for a given language (see Table B-4)  .                   Table B-4: FMS Command FilesT                   __________________________________________________________________T                   Language_________Command_File_____________________________________.                   BASIC            SAMPBAS.COM  .                   BLISS            SAMPBLI.COM  -                   C                SAMPCC.COM   .                   COBOL            SAMPCOB.COM  .                   FORTRAN          SAMPFOR.COM  .                   PASCAL           SAMPPAS.COM  .                   PL/I             SAMPPLI.COMT                   __________________________________________________________________              :                B-4  Using the Sample Applications Programs                           K                ____________________________________________________________4M                B.2  Running the Sample Application on Bisynchronous Terminals   N                   If you do not plan to run the Sample Application Programs onE                   bisynchronous terminals, you can skip this section.Y  R                   The Sample Application Programs can be run on bisynchronous ter-N                   minals with no modifications to the programs. Because of theO                   bisynchronous terminal's width restrictions, a form modifica-iS                   tion is required. The form that is used on asynchronous terminalsMS                   (VT52, VT100, VT2xx, and so forth) to display the check register,lL                   REGISTER, will not fit on a bisynchronous terminal screen.  R                   The FMS Version 2.4 kit provides a replacement form for REGISTERT                   that will fit on the bisynchronous terminal screen. This form willR                   work on aysnchronous terminals as well. The form is contained inQ                   the form file named BISYNC_REGIST.FRM located in FMS$EXAMPLES:.   Q                   Before running the Sample Application Programs on bisynchronous S                   terminals, follow these steps to replace the REGISTER form in thep<                   Sample Application form library, SAMP.FLB:  <                    1. Log into the system manager's account.  U                    2. Type the following FMS DCL command to save the current REGISTERpI                      form in a form file named FMS$EXAMPLES:REGISTER.FRM._  -                        $ FMS/LIBRARY/EXTRACT- Z                        _$ FMS$EXAMPLES:SAMP/FORM=REGISTER/OUTPUT=FMS$EXAMPLES:REGISTER.FRM    S                    3. Type the following FMS DCL command to insert the new REGISTERM                      form.  Y                        $ FMS/LIBRARY/REPLACE FMS$EXAMPLES:SAMP FMS$EXAMPLES:BISYNC_REGISTP  S                   After successfully executing this command, the Sample ApplicationsR                   Programs may be run as documented here on either asynchronous or*                   bisynchronous terminals.  P                   The REGISTER form now has a different appearance and differentP                   field attributes than those of the original REGISTER form doc-N                   umented in Introduction to VAX-11 FMS. These differences areP                   required so that the form will fit on the bisynchronous termi-Q                   nal screen. These differences will have no effect on the form'sS;                   function or interaction with the program.S      T                                          Using the Sample Applications Programs  B-5 O  A                      K                ____________________________________________________________ K                B.3  Running the Sample Application on MicroVAX Workstationsw  N                   If you do not plan to run the Sample Application Programs onC                   MicroVAX Workstations, you can skip this section.o  U                   The Sample Application Programs can be run on MicroVAX WorkstationseP                   with no modifications to the programs. However, to take advan-R                   tage of the increased size of the VT100 and VT200 windows on theO                   Workstation, a modification has been made to one of the forms P                   in the Sample Application. The REGISTER form, which contains aR                   scrolled region to display the check register, has been modifiedP                   to take advantage of a 55-line window. The FMS Version 2.4 kitR                   provides this form in the file named LONG_REGIST.FRM, located in                    FMS$EXAMPLES:.  S                   To take advantage of the 55-line Workstation window, follow theserS                   steps to replace the REGISTER form in the Sample Application form $                   library, SAMP.FLB:  =                    1. Log in to the system manager's account.k  U                    2. Type the following FMS DCL command to save the current REGISTER I                      form in a form file named FMS$EXAMPLES:REGISTER.FRM.   -                        $ FMS/LIBRARY/EXTRACT- Z                        _$ FMS$EXAMPLES:SAMP/FORM=REGISTER/OUTPUT=FMS$EXAMPLES:REGISTER.FRM  S                    3. Type the following FMS DCL command to insert the new REGISTER                       form.  W                        $ FMS/LIBRARY/REPLACE FMS$EXAMPLES:SAMP FMS$EXAMPLES:LONG_REGIST_  R                    4. Type the following DCL command to set the Workstation window&                      size to 55 lines.  -                        $ SET TERMINAL/PAGE=55   S                   After successfully executing this command, the Sample ApplicationlN                   Programs may be run as documented on a MicroVAX Workstation.  R                   The Sample Application will not run on standard terminals (VT52,S                   VT100, VT2xx, and so forth) with the form LONG_REGIST in the form $                   library, SAMP.FLB.            :                B-6  Using the Sample Applications Programs y                                       T                                                                           Appendix C    T                                                       Files Installed on Your SystemT                _____________________________________________________________________      R                   The following is a list of files added, replaced, or modified onB                   your system by VAX FMS Version 2.4 installation:  T                   __________________________________________________________________T                   File_Name__________Function_______________________________________T                   [SYSHLP]_(SYS$HELP)_______________________________________________T                   __________________________________________________________________N                   HELPLIB.HLB        Module FMS added/replaced in help library  M                   VAXFMS024.RELEASE_ Online release notes for FMS Version 2.4h                   NOTESo  T                   __________________________________________________________________T                   [SYSEXE]_(SYS$SYSTEM)_____________________________________________T                   __________________________________________________________________F                   FMSFAA.EXE         FMS Form Application Aids Utility  ?                   FMSFCV.EXE         FMS Form Converter Utilitye  <                   FMSFED.EXE         FMS Form Editor Utility  I                   FMSFLG.EXE         FMS Form Language Translator Utilityp  ?                   FMSFLI.EXE         FMS Form Librarian Utility   <                   FMSFTE.EXE         FMS Form Tester Utility  =                   FMSFUU.EXE         FMS Form Upgrade Utilityu          T                                                  Files Installed on Your System  C-1 U  t                      T                   __________________________________________________________________T                   File_Name__________Function_______________________________________T                   [SYSLIB]_(SYS$SHARE)______________________________________________T                   __________________________________________________________________@                   FDVSHR.EXE         Form Driver shareable image  T                   __________________________________________________________________T                   [SYSLIB]_(SYS$LIBRARY)____________________________________________T                   __________________________________________________________________Q                   DCLTABLES.EXE      DCL command FMS added/replaced in DCL tablesf  T                   HLL11.OBJ          PDP-11 compatibility high level language inter-)                                      faceu  L                   IMAGELIB.OLB       Module FDVSHR added/replaced in library  P                   STARLET.OLB        Module FDV$PLITRM added/replaced in library  T                   __________________________________________________________________T                   [SYSMGR]_(SYS$MANAGER)____________________________________________T                   __________________________________________________________________:                   FMSTARTUP.COM      FMS startup procedure  T                   __________________________________________________________________T                   [SYSMGR]_(SYS$MESSAGE)____________________________________________T                   __________________________________________________________________=                   FDVMSG.EXE         Form Driver message filem  ?                   FMSMSG.EXE         FMS utilities message filee                                      2                C-2  Files Installed on Your System d                         T                   __________________________________________________________________T                   __________________________________________________________________T                   [SYSHLP.EXAMPLES.FMS]_(FMS$EXAMPLES)______________________________T                   __________________________________________________________________Q                   FDVDEF.BAS         Form Driver symbol definition file for BASICN  S                   FDVDEF.FOR         Form Driver symbol definition file for FORTRANt  M                   FDVDEF.H           Form Driver symbol definition file for CS  Q                   FDVDEF.LIB         Form Driver symbol definition file for COBOL   R                   FDVDEF.PAS         Form Driver symbol definition file for PASCAL  Q                   FDVDEF.REQ         Form Driver symbol definition file for BLISSd  P                   FDVDEFCAL.PLI      Form Driver symbol definition file for PL/I  P                   FDVDEFFNC.PLI      Form Driver symbol definition file for PL/I  T                   MESSAGE.DIR________Directory_for_Modifiable_Message_Procedures____  U                   In addition, if the system manager requested the Sample ApplicationoP                   Programs to be installed, the following files will also exist:  T                   __________________________________________________________________T                   File_Name__________Function_______________________________________T                   [SYSHLP.EXAMPLES.FMS]_(FMS$EXAMPLES)______________________________T                   __________________________________________________________________P                   BISYNC_REGIST.FRM  Sample Application REGISTER form to be used:                                      with bisync terminals  P                   LONG_REGIST.FRM    Sample Application REGISTER form to be used?                                      with MicroVAX Workstations   D                   SAMP.BAS           BASIC Sample Application source  A                   SAMP.DAT           Sample Application data fileA  N                   SAMP.EXE           BASIC Sample Application executable image  D                   SAMP.FLB           Sample Application form library        T                                                  Files Installed on Your System  C-3 v  o                      T                   __________________________________________________________________T                   File_Name__________Function_______________________________________T                   [SYSHLP.EXAMPLES.FMS]_(FMS$EXAMPLES)______________________________T                   __________________________________________________________________M                   SAMPBAS.COM        BASIC Sample Application build procedure   D                   SAMPBLI.BLI        BLISS Sample Application source  M                   SAMPBLI.COM        BLISS Sample Application build procedurei  Q                   SAMPBLI.EXE        BLISS Sample Application executable image[1]-  @                   SAMPCC.C           C Sample Application source  I                   SAMPCC.COM         C Sample Application build procedure   M                   SAMPCC.EXE         C Sample Application executable image[1]o  D                   SAMPCOB.COB        COBOL Sample Application source  M                   SAMPCOB.COM        COBOL Sample Application build proceduree  Q                   SAMPCOB.EXE        COBOL Sample Application executable image[1]m  E                   SAMPCOB.LIB        COBOL Sample Application library   O                   SAMPFOR.COM        FORTRAN Sample Application build procedure   F                   SAMPFOR.FOR        FORTRAN Sample Application source  S                   SAMPFOR.EXE        FORTRAN Sample Application executable image[1]t  N                   SAMPPAS.COM        PASCAL Sample Application build procedure  R                   SAMPPAS.EXE        PASCAL Sample Application executable image[1]  E                   SAMPPAS.PAS        PASCAL Sample Application source   L                   SAMPPLI.COM        PL/I Sample Application build procedure  P                   SAMPPLI.EXE        PL/I Sample Application executable image[1]  T                   __________________________________________________________________L                   [1]Present only if the language is available on the sytem.    2                C-4  Files Installed on Your System                           T                   __________________________________________________________________T                   File_Name__________Function_______________________________________T                   [SYSHLP.EXAMPLES.FMS]_(FMS$EXAMPLES)______________________________T                   __________________________________________________________________C                   SAMPPLI.PLI        PL/I Sample Application source   L                   SMPACCOM.FOR       FORTRAN Sample Application include file  E                   SMPCOBUAR.LIB      COBOL Sample Application library   O                   SMPMEMRES.OBJ      Memory resident form module for the Sample 1                                      Applicationsn  L                   SMPREGCOM.FOR      FORTRAN Sample Application include file  L                   SMPSTATUS.FOR      FORTRAN Sample Application include file  R                   SMPVECTOR.OBJ      UAR vector module for the Sample Applications  L                   SMPWORK.FOR        FORTRAN Sample Application include file  T                   __________________________________________________________________T                   [SYSHLP.EXAMPLES.FMS.MESSAGE]_____________________________________T                   __________________________________________________________________M                   COMMSG.MSG         Message file common to all FMS utilitiese  G                   FAAMSG.MSG         Form Application Aids message filee  @                   FCVMSG.MSG         Form Converter message file  =                   FDVMSG.MSG         Form Driver message file_  =                   FEDMSG.MSG         Form Editor message file_  :                   FIOMSG.MSG         File I/O message file  J                   FLGMSG.MSG         Form Language Translator message file  @                   FLIMSG.MSG         Form Librarian message file  >                   FMSLIT.MSG         FMS message file literals  I                   FMS_MESSAGE.MEM    Guide to modifying FMS message filesE      T                                                  Files Installed on Your System  C-5 r  i                      T                   __________________________________________________________________T                   File_Name__________Function_______________________________________T                   [SYSHLP.EXAMPLES.FMS.MESSAGE]_____________________________________T                   __________________________________________________________________=                   FTEMSG.MSG         Form Tester message file_  F                   FUUMSG.MSG         Form Upgrade Utility message file  T                   MSGBLD.COM_________Message_file_build_procedure___________________                                                                          2                C-6  Files Installed on Your System