CONTENTS Title Page Copyright Page Preface 1 Introduction 1.1 FMS Development Cycle 1.1.1 Create Forms 1.1.1.1 Form Editor 1.1.1.2 Form Language 1.1.2 Create Form Libraries or Memory-Resident Forms 1.1.3 Write the Application Program 1.1.4 Write User Action Routines 1.1.5 Create Object Modules 1.1.6 Test Forms 1.1.7 Link the Application 1.2 DCL Commands 2 Form Characteristics 2.1 Background Text 2.2 Fields 2.2.1 Field Picture 2.2.2 Date and Time Fields 2.2.3 Field Ordering 2.3 Named Data 2.4 Attributes 2.4.1 Field Attributes 2.4.1.1 Autotab 2.4.1.2 Blank Fill 2.4.1.3 Clear Character 2.4.1.4 Default Value 2.4.1.5 Display Only 2.4.1.6 Field Completion User Action Routine 2.4.1.7 Field Name 2.4.1.8 Fixed Decimal 2.4.1.9 Help Text 2.4.1.10 Indexed 2.4.1.11 Left Justify 2.4.1.12 Must Fill 2.4.1.13 No Echo 2.4.1.14 Response Required 2.4.1.15 Right Justify 2.4.1.16 Supervisor Only 2.4.1.17 Uppercase 2.4.1.18 Zero Fill 2.4.1.19 Zero Suppress 2.4.2 Form Attributes 2.4.2.1 Form Name 2.4.2.2 Help Form Name 2.4.2.3 Screen Background 2.4.2.4 Screen Width 2.4.2.5 Screen Character Set 2.4.2.6 Screen Area to Clear 2.4.2.7 Field Highlighting 2.4.2.8 Function Key User Action Routine 2.4.2.9 Pre-Help User Action Routine 2.4.2.10 Post-Help User Action Routine 2.4.3 Line Attributes 2.4.3.1 Double Size 2.4.3.2 Double Wide 2.4.3.3 Scrolled 2.4.4 Video Attributes 3 Form Editor-FMS/EDIT 3.1 Terminal Characteristics 3.1.1 Terminal Setup FMS/EDIT Command 3.2 FMS/EDIT Command 3.3 Form Editor Keys 3.4 Error Signaling in the Form Editor 3.5 Choosing a Phase 3.6 Form Phase 3.6.1 Form Name 3.6.2 Help Form Name 3.6.3 Screen Background 3.6.4 Screen Width 3.6.5 Screen Character Set 3.6.6 Screen Area to Clear 3.6.7 Field Highlighting 3.6.8 User Action Routine Names and Data 3.6.9 Initial Field Attributes 3.7 Layout Phase 3.7.1 Adjacent: Breaking a Field into Two Adjacent Fields 3.7.2 Cancel: Canceling a Select, Gold, or Scroll Operation 3.7.3 Center: Centering Characters on a Line 3.7.4 Characters: Changing Character Sets 3.7.5 Cursor: Moving the Cursor 3.7.6 Cut: Cutting Characters in a Select Area 3.7.7 Date: Defining a Date Field 3.7.8 Delete: Deleting Characters and Lines 3.7.9 Double Size: Making Lines Double Size 3.7.10 Double Wide: Making Lines Double Wide 3.7.11 Draw: Drawing Lines and Boxes 3.7.12 Field Attributes: Assigning Them in Layout 3.7.13 Insert: Inserting Blank Lines 3.7.14 Modes: Overstrike/Insert, Text/Field, and Terminal Bell/Quiet 3.7.15 Paste: Pasting Previously Cut Characters 3.7.16 Refresh: Redisplaying the Current Form 3.7.17 Repeat: Repeating Characters or Operations 3.7.18 Scroll: Making a Scrolled Area 3.7.19 Select: Defining a Select Area 3.7.20 Test Paste: Testing a Paste Operation 3.7.21 Time: Defining a Time Field 3.7.22 Video Attributes: Assigning Video Attributes 3.8 Assign Phase 3.8.1 Field Name 3.8.2 Index Value K of N (Creating Indexed Fields) 3.8.3 Attributes 3.8.4 Default Value 3.8.5 Help Text 3.8.6 Field Completion User Action Routines Questionnaire 3.9 Data Phase 3.10 Order Phase 3.11 Test Phase 3.12 Exit Phase 4 Form Language Translator-FMS/TRANSLATE 4.1 Form Language Concepts 4.1.1 Statement Items 4.1.1.1 Names 4.1.1.2 Coordinates 4.1.1.3 Text Strings 4.1.1.4 Attributes 4.1.2 Writing a Form Description 4.1.2.1 Statement Format 4.1.2.2 Restrictions 4.1.2.3 Abbreviations 4.1.2.4 Including Comments 4.2 Form Language Statements ATTRIBUTE_DEFAULTS 4.2.1 ATTRIBUTE_DEFAULTS Statement DRAW 4.2.2 DRAW Statement END_OF_FORM 4.2.3 END_OF_FORM Statement FIELD 4.2.4 FIELD Statement FORM 4.2.5 FORM Statement NAMED_DATA 4.2.6 NAMED_DATA Statement ORDER 4.2.7 ORDER Statement SCROLL 4.2.8 SCROLL Statement TEXT 4.2.9 TEXT Statement VIDEO 4.2.10 VIDEO Statement FMS/TRANSLATE 4.3 FMS/TRANSLATE Command 4.3.1 Sample Translation Listing 5 Form Librarian-FMS/LIBRARY FMS/LIBRARY/CREATE 5.1 FMS/LIBRARY/CREATE Command FMS/LIBARY/INSERT 5.2 FMS/LIBRARY/INSERT Command FMS/LIBRARY/REPLACE 5.3 FMS/LIBRARY/REPLACE Command FMS/LIBRARY/EXTRACT 5.4 FMS/LIBRARY/EXTRACT Command FMS/LIBRARY/DELETE 5.5 FMS/LIBRARY/DELETE Command 6 Form Application Aids FMS/DESCRIPTION 6.1 FMS/DESCRIPTION Command FMS/DIRECTORY 6.2 FMS/DIRECTORY Command FMS/OBJECT 6.3 FMS/OBJECT Command FMS/VECTOR 6.4 FMS/VECTOR Command 7 Form Tester-FMS/TEST 7.1 Terminal Setup FMS/TEST 7.2 FMS/TEST Command 8 TDMS to FMS Form Converter-FMS/CONVERT 8.1 TDMS to FMS Form Converter Functions 8.1.1 Functions Performed 8.1.2 TDMS Features Not Supported by FMS FMS/CONVERT 8.2 FMS/CONVERT Command 8.3 Conversion Example 9 Upgrading V1 Application Programs 9.1 Upgrading V1 Form Files and Form Libraries 9.2 Using the Form Upgrade Utility 9.3 Linking Existing Application Programs to the V2 Form Driver FMS/UPGRADE 9.4 FMS/UPGRADE Command 10 FMS V1 Compatibility 10.1 Form Editor 10.1.1 Keyboard Layout - Form Editor Keys 10.2 Form Utility 10.2.1 Comparison of V1 Form Utility Options and V2 Commands 10.2.2 FMS/DESCRIPTIONS/DECLARATIONS COBOL/DATATRIEVE Data Description 10.3 Installing VAX FMS V2 with VAX FMS V1 Present on the System A VAX FMS Software Messages A.1 Message Format A.2 Messages for Programmers A.3 Messages for Terminal Operators A.4 Suggestions to Follow if FMS Software Malfunctions A.5 FMS Utilities Messages A.6 Form Driver Messages for Programmers A.7 Form Driver Messages for Terminal Operators EXAMPLES 4-1 Sample Translation Listing 6-1 Brief Description 6-2 Data Description File 6-3 Full Description 8-1 TDMS List of the FCV_EXAMPLE Form 8-2 Converting the Form 8-3 Full Description of the FMS Form File FIGURES 2-1 Background Text and Fields in a Bank Check 2-2 Check Form from the Sample Application 2-3 Line Attributes 2-4 Reverse Video Attribute 2-5 Background Text, Field-Marker Characters, and Field-Validation Characters 2-6 Fixed Decimal Attribute 2-7 Underline Video Attribute 3-1 Form Editor Keys 3-2 Form Editor Menu 3-3 Assign Form Attributes Questionnaire 3-4 Assign Initial Field Attributes Questionnaire 3-5 Form User Action Routines Questionnaire 3-6 Layout Phase Status Line 3-7 Form in the Layout Phase 3-8 Date Field Menu 3-9 Select Area 3-10 Time Field Menu 3-11 Assign Menu 3-12 Field Attributes Questionnaire 3-13 Field Completion UARs Questionnaire 3-14 Data Phase 3-15 Ordering Field in a Scrolled Area 3-16 Exit Phase Query 4-1 Layout Sheet 5-1 Creating a Form Library 6-1 Printed Image of a Description 6-2 Video Image of a Description 6-3 Full Form File Directory 6-4 Full Form Library Directory 6-5 Creating Memory-Resident Forms 6-6 Creating Object Modules of UAR Vectors 7-1 Form Tester Displaying a Form 10-1 Form Editor Keys TABLES 1-1 Command Syntax Notation 1-2 Default File Types 1-3 FMS Commands and Qualifiers 2-1 Field-Validation Characters 2-2 Field-Marker Characters 2-3 Date Field Formats 2-4 Time Field Formats 3-1 VT200 3-2 Layout Phase Status Line Information 3-3 Order Phase Functions 4-1 Form Language Statement Types 4-2 ATTRIBUTE_DEFAULTS FIELD Attributes 4-3 ATTRIBUTE_DEFAULTS TEXT Attributes 4-4 FIELD Attributes 4-5 Attributes for Background Text 7-1 Form Driver Errors Ignored by the Form Tester 10-1 Comparison of V1 Form Utility Options and V2 Commands