CONTENTS Title Page Copyright Page Preface 1 Introduction 1.1 Description of the VAX OPS5 Development Environment 1.2 Concepts and Terms 1.3 Overview of the Program Development Process 1.3.1 New Session, New Program 1.3.2 New Session, Existing Program 1.3.3 Existing Session 1.4 DECwindows Applications and Individual Working Style 1.5 Overview of Windows 2 Getting Started 2.1 Preparing to Use the Development Environment 2.2 Starting the Development Environment 2.2.1 Creating a New Session and a New Program 2.2.2 Creating a Session from an Existing VAX OPS5 Program 2.2.3 Starting an Existing Session 2.3 Obtaining Online Help 2.4 Exiting 3 Working with Sessions 3.1 Using the Session Window 3.2 Creating a Session 3.3 Selecting a Session 3.3.1 Shortcut 3.4 Saving a Session 3.5 Deleting a Session 3.6 Reverting to the Last Saved Session 3.7 Rebuilding the Image 3.8 Relinking the Image 3.9 Exiting 4 Working with Modules 4.1 Using the Session Window 4.2 Listing Module Names 4.3 Interpreting Module Status Codes 4.4 Selecting a Module 4.5 Creating a Module 4.6 Renaming a Module 4.7 Searching for a String 4.8 Using the Find Report 4.8.1 Working with Modules 4.8.2 Shortcut 4.8.3 Working with Constructs 4.8.4 Shortcut 4.8.5 Obtaining Online Help 4.9 Editing a Module 4.10 Editing Efficiently 4.10.1 Using EVE 4.10.2 Using an Editor Other Than EVE 4.10.3 Using QuickEdit 4.11 Opening a Module to List Construct Names 4.11.1 Shortcut 4.12 Clearing a Module's Contents 4.13 Deleting a Module 4.14 Recovering a Deleted Module 4.15 Reverting to the Last Saved Module 4.16 Copying VMS Files to Modules (Importing) 4.17 Copying Modules to VMS Files (Exporting) 4.17.1 Using the Session Window 4.17.2 Using the OPS5 DCL Command 5 Working with the Construct Database 5.1 Using the Construct Menu 5.2 Listing Construct Names 5.2.1 Shortcut 5.3 Interpreting Construct Status and Type Codes 5.4 Selecting a Construct 5.5 Creating a Construct 5.5.1 Adding a New Construct to a Module 5.5.2 Adding a New Construct to an Existing Construct 5.6 Searching for a String 5.7 Using the Find Report 5.7.1 Working with Modules 5.7.2 Shortcut 5.7.3 Working with Constructs 5.7.4 Shortcut 5.7.5 Obtaining Online Help 5.8 Viewing and Changing a Construct 5.8.1 Viewing a Construct 5.8.2 Shortcut 5.8.3 Changing a Construct in QuickEdit Mode 5.9 Viewing a Reference Construct 5.10 Editing a Construct 5.11 Editing Efficiently 5.11.1 Using EVE 5.11.2 Using an Editor Other Than EVE 5.11.3 Using QuickEdit 5.12 Deleting a Construct 5.13 Recovering a Deleted Construct 5.14 Reverting to the Last Saved Construct 6 Running and Debugging a Program 6.1 Preparing to Run a Program 6.2 Using the Listener Window 6.3 Running a Program 6.4 Debugging a Program 6.4.1 Tracing Execution 6.4.2 Modifying Source Code 6.4.3 Scrolling Text 6.4.4 Restarting 6.4.5 Editing Single Lines of Text 6.4.6 Cutting and Pasting Text 6.4.7 Choosing Items from Menus 6.5 Halting a Program 6.6 Stepping Through a Program 6.7 Issuing VAX OPS5 Commands 6.7.1 Online Help for Commands 6.7.2 Commands Modified in the Development Environment 6.7.2.1 DISABLE HALT 6.7.2.2 EXIT 6.7.2.3 RUN 6.7.2.4 WATCH 6.7.3 Commands Available on Menus 6.7.4 Command and Menu Item Difference 6.8 Setting and Deleting Breakpoints 6.9 Displaying Matches 6.10 Excising Productions 6.11 Displaying WMEs 6.11.1 Shortcut 6.12 Removing WMEs 6.13 Restarting a Program 6.13.1 Restarting a Live Program 6.13.2 Restarting a Program after the OPS5 Process Exits 6.14 Editing Constructs 6.15 Manipulating Constructs 6.16 Using the Trace Window 6.16.1 Opening a Trace Window 6.16.2 Setting Trace Levels 6.16.3 Opening Additional Trace Windows 7 Customizing the Development Environment 7.1 Using a Terminal Window for Program I/O 7.2 Changing the Font (Type Size) 7.3 Selecting the Actions You Want Confirmed 7.4 Linking to External Routines 7.5 Linking with the VAX OPS5 Object Library 7.6 Using the Defaults Files 7.7 Using and Customizing the EVE Editor 7.7.1 Using a Section File 7.7.2 Using an Initialization File 7.7.3 Using a Command File 7.7.4 Establishing Input Focus 7.8 Using a Text Editor Other Than EVE 7.9 Customizing the FileView Applications Menu to Invoke the Development Environment 8 Managing a Multiperson Project 8.1 Planning, Organizing, and Communicating 8.2 Keeping Information Current A Using DECwindows A.1 Using the Mouse A.2 Starting a Session A.3 What Are Windows? A.4 Selecting Windows A.5 Moving Windows A.6 Changing the Size of Windows A.7 Shrinking Windows A.8 Expanding Icons to Windows A.9 Stacking Overlapping Windows A.9.1 Making Stacked Windows Stick in Place A.9.2 Releasing Windows Locked in the Stacking Order A.10 Choosing Items from Pull-Down Menus A.11 Choosing Items from Submenus A.12 Choosing Items from Pop-Up Menus A.13 Choosing Items from Option Menus A.14 Supplying Information in Dialog Boxes A.14.1 Moving and Changing Settings in a Dialog Box A.14.2 Making Selections from List Boxes A.15 Scrolling A.16 Editing Text A.16.1 Selecting Text A.16.2 Copying Text A.16.3 Moving Text Between Windows A.16.4 Deleting Text with Pending Delete A.16.5 Text Editing Key Definitions A.17 Composing Special Characters A.18 Getting Help A.18.1 Invoking Help A.18.2 Navigating in Help A.18.3 Searching Help for Titles and Keywords A.18.4 Exiting from Help A.19 Putting a Session on Hold A.20 Ending a Session B Troubleshooting B.1 Recognizing and Correcting Common Problems B.2 Interpreting System Messages C Summary of Files Glossary FIGURES 1-1 Current and Reference Construct Databases 1-2 Session Window 1-3 Listener Window 1-4 Find Report 1-5 Module Window 1-6 Trace Window 1-7 Construct Window 1-8 Reference Construct Window 1-9 Editor Window 1-10 Program I/O Window 3-1 Session Window with Session and Help Menus 3-2 Sample Select Session Dialog Box 4-1 Session Window with Module, File, and Help Menus 4-2 Session with List of Modules 4-3 Find Dialog Box 4-4 Find Report 4-5 Editor Window with a Module 4-6 Module with List of Constructs 5-1 Module Window with Construct and Help Menus 5-2 Module with List of Constructs 5-3 Find Dialog Box 5-4 Find Report 5-5 Construct Window with a Construct 5-6 Reference Construct Window with a Construct 5-7 Editor Window with a Construct 6-1 Listener Window with Construct, WME, and Help Menus 6-2 Trace Window with Construct, WME and Help Menus 7-1 Session Window with Customize and Help Menus 7-2 Customize Windows Dialog Box 7-3 Customize Confirmations Dialog Box 7-4 Customize Link Dialog Box 7-5 FileView Verbs and Menus Dialog Box TABLES 4-1 Module Status Codes 5-1 Construct Status Codes 5-2 Construct Type Codes 6-1 Trace Buttons and Events B-1 Common Problems and Their Remedies C-1 Development Environment Files