CONTENTS Title Page Copyright Page Information Map Information Table Preface 1 Introduction 1.1 Before You Begin 1.2 Application Development Life Cycle 1.3 ACMS Application Development Concepts 1.3.1 Writing ACMS Definitions 1.3.2 Composition of ACMS Definitions 1.4 ACMS Integration with DECforms 1.4.1 DECforms Concepts 1.4.2 ACMS Interaction with DECforms 1.5 ACMS Integration with Resource Managers 1.5.1 Accessing a Database or a Master File 1.5.2 ACMS Interaction with a Resource Manager 1.6 Defining Fields and Records in CDD/Plus 2 Developing the Data Entry Task 2.1 Defining a CDD/Plus Environment 2.2 Defining a CDD/Plus Record 2.3 Creating a Form Using DECforms 2.3.1 Creating a Basic Form 2.3.2 Creating a Panel 2.3.3 Editing the Form IFDL Source File 2.3.4 Creating the Binary Form File 2.3.5 Defining Additional CDD/Plus Records 2.4 Defining the Data Entry Task 2.4.1 Defining the First Exchange Step 2.4.2 Defining the Processing Step 2.4.3 Defining the Second Exchange Step 2.4.4 Defining the Block Step and Workspaces 2.5 Compiling the Task Definition in ADU 2.6 Defining a System Logical for Your Tutorial Directory 2.7 Defining the Data Entry Procedure 2.7.1 Identification Division 2.7.2 Environment Division 2.7.3 Data Division 2.7.4 Procedure Division 2.7.5 Compiling the COBOL Procedure 3 Developing the Inquiry/Update Task 3.1 Defining a DECforms Form for Inquiry/Update 3.2 Defining the Inquiry/Update Task 3.2.1 Defining the First Exchange Step 3.2.2 Defining the First Processing Step 3.2.3 Defining the Second Exchange Step 3.2.4 Defining the Second Processing Step 3.2.5 Defining the Third Exchange Step 3.2.6 Completing the Task Definition 3.3 Compiling the Task Definition 3.4 Defining COBOL Procedures 3.4.1 Defining the Retrieval Procedure 3.4.2 Compiling the Retrieval Procedure 3.4.3 Defining the Update Procedure 3.4.4 Compiling the Update Procedure 4 Building the Task Group 4.1 Defining Startup and Cleanup Procedures 4.1.1 Defining the Initialization Procedure 4.1.2 Defining the Termination Procedure 4.1.3 Defining the Cancellation Procedure 4.2 Defining and Building the Task Group 4.2.1 Naming Forms 4.2.2 Naming the Tasks in the Task Group 4.2.3 Naming the Procedure Server and Workspaces 4.2.4 Compiling the Task Group Definition 4.2.5 Building the Task Group 4.3 Linking the Server Image 4.4 Testing a Task in the ACMS Task Debugger 5 Defining and Building the Application 5.1 Defining the Application 5.1.1 Application Characteristics 5.1.2 Server Characteristics 5.1.3 Task Characteristics 5.2 Compiling the Application Definition 5.3 Building the Application 6 Defining and Building the Menu 6.1 Defining the Menu 6.2 Compiling the Menu Definition 6.3 Building the Menu 7 System Management Requirements for the Tutorial Application 7.1 System Management Overview 7.2 Creating the EMPL_SERVER and EMPLOYEE_EXC Accounts 7.3 Authorizing ACMS Users 7.4 Authorizing ACMS Terminals 7.5 Authorizing ACMS Applications 7.6 Defining the ACMS$DIRECTORY Logical 8 Installing and Running the Application 8.1 Installing the Application 8.2 Starting the Application 8.3 Running the Application 8.4 Stopping the Application and the ACMS System A Utilities for Solving Problems in an ACMS Application A.1 How ACMS Runs a Task A.2 Audit Trail Log A.3 Software Event Log A.4 DECforms Trace Facility A.5 ACMS Help Facility B Source Files Used in the Tutorial B.1 Source Files B.2 Accessing the Source Files EXAMPLES 2-1 COBOL Data Entry Procedure 3-1 COBOL Retrieval Procedure 3-2 COBOL Update Procedure 4-1 COBOL Initialization Procedure 4-2 COBOL Termination Procedure 4-3 COBOL Cancellation Procedure FIGURES 1-1 Application Development Life Cycle 1-2 Execution Flow of an ACMS Task Definition 1-3 ACMS Application Components 1-4 Panels and Viewports 1-5 DECforms Interaction with ACMS 1-6 A Resource Manager Interacting with ACMS 2-1 DECforms LAYOUT Screen 2-2 FDE Main Menu 2-3 Choose/Create Panel Menu 2-4 Create Panel Screen 2-5 Sample DECforms Panel 2-6 Create Field Menu 2-7 Data Type Character Window 2-8 Sample Panel with One Data Field Picture 2-9 Sample Panel with Data Field Pictures 3-1 Employee Number Panel 8-1 Selection Menu A-1 Databases in an ACMS Application