VSI OpenVMS Introduction to VSI FMS Document Number: DO-FMSINT-01A Publication Date: June 2021 Revision Update Information: This is a new manual. Operating System and Version: VSI OpenVMS x86-64 Version 9.0 VSI OpenVMS I64 Version 8.4-1H1 VSI OpenVMS Alpha Version 8.4-2L1 Software Version: VSI FMS Version 2.6 or higher VMS Software, Inc. (VSI) Burlington, Massachusetts, USA Introduction to VSI FMS Copyright © 2021 VMS Software, Inc. (VSI), Burlington, Massachusetts, USA Legal Notice Confidential computer software. Valid license from VSI required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for VSI products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. VSI shall not be liable for technical or editorial errors or omissions contained herein. HPE, HPE Integrity, HPE Alpha, and HPE Proliant are trademarks or registered trademarks of Hewlett Packard Enterprise. DEC, DEC/CMS, DEC/MMS, DECnet, DECsystem-10, DECSYSTEM-20, DECUS, DECwriter, MASSBUS, MICRO/PDP-11, Micro/ RSX, MicroVMS, PDP, PDT, RSTS, RSX, TOPS-20, UNIBUS, VAX, VMS, VT, and mm are trademarks or registered trademarks of Hewlett Packard Enterprise. ii Introduction to VSI FMS Preface ................................................................................................................................... vii 1. About VSI .................................................................................................................... vii 2. Document Structure ...................................................................................................... vii 3. Intended Audience ....................................................................................................... viii 4. VSI Encourages Your Comments .................................................................................. viii 5. OpenVMS Documentation ............................................................................................ viii 6. Conventions ................................................................................................................. viii Chapter 1. Overview of FMS ............................................................................................... 1 1.1. FMS Components ........................................................................................................ 2 1.1.1. Form Editor ...................................................................................................... 2 1.1.2. Form Language Translator ................................................................................. 2 1.1.3. Form Librarian .................................................................................................. 2 1.1.4. Form Driver ...................................................................................................... 2 1.1.5. Sample Application ........................................................................................... 3 1.1.6. Form Tester ....................................................................................................... 3 1.1.7. Form Application Aids ...................................................................................... 3 1.2. FMS Application Development ..................................................................................... 3 1.3. Reading Path for the FMS Document Set ...................................................................... 9 Chapter 2. Running the Sample Application Program .................................................... 11 2.1. Setting Up Your Terminal ........................................................................................... 11 2.2. Starting the Sample Application .................................................................................. 11 2.3. Printing SAMPCH.DAT .............................................................................................. 17 Chapter 3. Creating Forms ................................................................................................. 19 3.1. Setting Up Your Terminal ........................................................................................... 19 3.2. Examining Two Forms from the Sample Application .................................................... 19 3.2.1. MENU Form ................................................................................................... 20 3.2.2. DEPOSIT Form ............................................................................................... 21 3.3. Creating MENU and DEPOSIT .................................................................................. 22 3.3.1. Creating MENU .............................................................................................. 24 3.3.1.1. Assigning Form Attributes: The Form Phase .......................................... 25 3.3.1.2. Laying Out the Form: The Layout Phase ................................................ 25 3.3.1.3. Assigning Field Attributes: The Assign Phase ......................................... 30 3.3.1.4. Testing a Form: The Test Phase ............................................................. 32 3.3.1.5. Saving a Form: The Exit Phase ............................................................. 32 3.3.2. Creating DEPOSIT .......................................................................................... 32 3.3.2.1. Assigning Form Attributes: The Form Phase .......................................... 33 3.3.2.2. Laying Out the Form: The Layout Phase ................................................ 34 3.3.2.3. Assigning Field Attributes to DEPOSIT: The Assign Phase ..................... 36 3.3.2.4. Alternative Method of Assigning Field Attributes ................................... 37 3.3.2.5. Testing a Form: The Test Phase ............................................................. 37 3.3.2.6. Saving a Form: The Exit Phase ............................................................. 37 3.4. Creating a Help Form ................................................................................................. 38 3.4.1. Creating HELP_MENU ................................................................................... 38 3.4.2. Associating HELP_MENU with MENU ........................................................... 39 Chapter 4. Creating a Form Library ................................................................................ 41 4.1. Create a Library File .................................................................................................. 41 4.2. Obtain a Library Directory Listing .............................................................................. 42 4.3. Interpret a Form Description ....................................................................................... 43 4.4. Obtain a Form Image ................................................................................................. 44 Chapter 5. Writing an Application .................................................................................... 47 iii Introduction to VSI FMS 5.1. Form Driver Concepts ................................................................................................ 47 5.1.1. Form Driver Calls ........................................................................................... 48 5.1.1.1. Functional Division of Calls .................................................................. 48 5.1.1.2. Form Driver Calls Used in the Subset Application .................................. 49 5.1.2. String Handling ............................................................................................... 49 5.2. Sample Application Subset ......................................................................................... 50 5.2.1. The Main Program .......................................................................................... 50 5.2.2. Subset Subroutines .......................................................................................... 51 5.2.3. Preparing the Main Program ............................................................................ 51 5.2.3.1. Initializing Calls ................................................................................... 52 5.2.3.2. Coding the Body of the Main Module .................................................... 54 5.2.3.3. Closing Calls ........................................................................................ 54 5.2.4. Coding the INACCT Subroutine ....................................................................... 55 5.2.5. Coding the MENU Subroutine ......................................................................... 56 5.2.6. Coding the WRITCH Subroutine ...................................................................... 59 5.2.7. Coding the MAKDEP Subroutine ..................................................................... 59 5.2.8. Coding Subroutines VUEREG and VUEACT ................................................... 61 5.2.9. Coding Subroutine GETSTA ............................................................................ 62 Chapter 6. Compiling, Linking, and Running an Application ........................................ 65