CONTENTS Title Page Copyright Page Information Map Information Table Preface Technical Changes and New Features Part I Managing the ACMS System and ACMS Applications 1 Introduction to Application Management 1.1 ACMS Authorization Tools 1.2 Controlling ACMS Operations 1.3 Monitoring an ACMS System 1.4 Tuning an ACMS System 1.5 ACMS Application Management Tools 1.6 Learning to Manage an ACMS System 2 Authorizing and Controlling Terminals 2.1 How DDU Works 2.2 How to Run DDU 2.3 Creating a DDU Definition 2.4 Copying DDU Definitions 2.5 Modifying DDU Definitions 2.5.1 Enabling Autologin Terminals 2.5.2 Using the /PRINTFILE Qualifier 2.6 Renaming Device Names in DDU Definitions 2.7 Removing DDU Definitions 2.8 DDU DEFAULT Definition 2.9 Displaying DDU Definitions 2.10 Defining ACMS-Controlled Terminals 2.11 Authorizing LAT Terminal Ports as Controlled Terminals 2.12 Controlling LAT Terminals 2.12.1 LAT Setup for an Applications Port 2.12.2 LAT Setup for a Dedicated Service Port 2.12.2.1 Setup Of The Terminal Server Port 2.12.2.2 Creation of a Service 2.12.2.3 Creation of Dedicated Service Ports 2.12.2.4 Association of the Dedicated Service Port with the Desired Service 2.12.2.5 Terminal Setup 2.12.2.6 Using a Dedicated Service Port 2.13 Enabling Automatic User Logins 2.14 Summary of DDU Commands and Qualifiers 3 Authorizing Users 3.1 How UDU Works 3.2 How to Run UDU 3.3 Running UDU the First Time 3.4 Authorizing New Users 3.4.1 Authorizing Users with ADD, COPY, DEFAULT, and $ALL 3.4.2 Defining User Initial and Final Tasks 3.4.3 Defining the Initial Menu Display 3.4.4 Specifying a Language for a User 3.4.5 Specifying a Printfile for a User 3.4.6 Authorizing User Names as Agents 3.5 Working with Existing UDU Definitions 3.5.1 Looking at UDU Definitions with SHOW and LIST 3.5.2 Deleting UDU Definitions 3.5.3 Renaming UDU Definitions 3.6 Summary of UDU Commands and Qualifiers 4 Authorizing Applications 4.1 How AAU Works 4.2 How to Run AAU 4.3 Before Authorizing Applications 4.4 Authorizing New Applications 4.4.1 Authorizing All Applications with $ALL 4.4.2 Authorizing Individual Applications 4.4.3 Authorizing Applications with /[NO]WILD_SUFFIX 4.5 Working with Existing AAU Authorizations 4.5.1 Looking at AAU Authorizations with SHOW and LIST 4.5.2 Deleting Authorizations from ACMSAAF.DAT 4.5.3 Renaming AAU Authorizations 4.6 Summary of AAU Commands and Qualifiers 5 Creating and Managing Queues 5.1 How ACMSQUEMGR Works 5.2 How to Run ACMSQUEMGR 5.3 Managing Task Queues 5.3.1 Creating Task Queues 5.3.2 Setting the Characteristics of Task Queues 5.3.3 Modifying Task Queues 5.3.4 Deleting Task Queues 5.3.5 Displaying Task Queue Information 5.4 Managing Queued Task Elements 5.4.1 Setting the Characteristics of Queued Task Elements 5.4.2 Deleting Queued Task Elements 5.4.3 Displaying Queued Task Elements 5.5 Backing Up Task Queue Files Online 5.6 Summary of ACMSQUEMGR Commands and Qualifiers 6 Using Distributed Forms Processing 6.1 What Is Distributed Forms Processing? 6.2 Preparing Your System for Distributed Forms Processing 6.2.1 Common Setup Tasks for Distributed Forms Processing 6.2.2 Actions Required on Submitter Nodes 6.2.3 Actions Required on Application Nodes 6.2.3.1 Assigning Individual Proxy Accounts 6.2.3.2 Assigning a Default Submitter User Name Account 6.2.3.3 Assigning Proxy Accounts in a VAXcluster Environment 6.2.4 File Protection for Application and Form Files 6.3 Defining Application Specifications 6.3.1 Using Logical Names for Applications 6.3.2 Search Lists and Primitive Failover 6.3.3 Redirecting Users to Other Applications at Run Time 6.4 Distributed Operations ACMS Performs Automatically 6.4.1 Automatic File Distribution 6.4.2 ACMS Systemwide Cache Directory 6.5 Tailoring ACMS Distributed Forms Processing to Your Site 6.5.1 Manually Distributing Applications 6.5.2 Creating Agent-Specific Cache Directories 6.5.3 Accessing Remote Application Files 6.6 Managing and Caching DECforms Escape Routine Files 6.6.1 Making Escape Routines Available to the CP Agent 6.6.2 Privileged Agents That Execute Escape Routines 7 Controlling the ACMS System 7.1 Starting the ACMS System 7.1.1 Starting ACMS Automatically 7.1.2 Starting ACMS Interactively 7.2 Stopping the ACMS System 7.2.1 Stopping ACMS Automatically 7.2.2 Stopping ACMS Interactively 7.3 Displaying System Information 7.4 Terminal Subsystem Controller 7.4.1 Starting the TSC 7.4.2 Stopping the TSC 7.5 Operator Terminals 7.5.1 Enabling Operator Terminals 7.5.2 Disabling Operator Terminals 7.6 Queued Task Initiator 7.6.1 Starting the QTI 7.6.2 Stopping the QTI 7.6.3 Displaying QTI Information 7.7 Task Queues 7.7.1 Starting Task Queues 7.7.2 Stopping Task Queues 7.7.3 Displaying Task Queue Information 7.8 Canceling ACMS Users 7.8.1 Canceling Users with the ACMS/CANCEL USER Command 7.8.2 Canceling Users with ACMSCANCEL.COM 7.8.3 Displaying User Information 7.9 Summary of Operator Commands and Qualifiers 8 Installing and Managing Applications 8.1 Installing Applications 8.2 Removing Applications 8.3 Starting Applications 8.4 Stopping Applications 8.5 Displaying Application Information 8.5.1 Displaying Static Information 8.5.2 Displaying Dynamic Information 8.6 Modifying Active Applications 8.6.1 Modifying Application Attributes 8.6.2 Modifying Server Attributes 8.6.3 Modifying Task Attributes 8.7 Replacing a Server Image 8.8 Maintaining Application Availability 8.9 Canceling Tasks 8.10 Displaying Task Information 9 Setting ACMS Quotas, Parameters, and Privileges 9.1 Introduction 9.2 Calculating Parameters and Quotas with ACMSPARAM.COM 9.2.1 Running ACMSPARAM.COM 9.2.1.1 GENVAR Phase of ACMSPARAM.COM 9.2.1.2 GENPAR Phase of ACMSPARAM.COM 9.2.1.3 WRITEPAR Phase of ACMSPARAM.COM 9.2.2 Supplying Variable Values for ACMSPARAM.COM 9.2.2.1 Supplying Variables with ACMS$MONITOR.COM 9.2.2.2 Editing ACMVARINI.DAT to Supply Variables to ACMSPARAM.COM 9.3 Calculating EXC Process Quotas with ACMEXCPAR.COM 9.3.1 Running ACMEXCPAR.COM 9.3.2 Supplying Variable Values for ACMEXCPAR.COM 9.3.3 Modifying Variable Values for Use by ACMEXCPAR.COM 10 Changing ACMS Parameter Values with the ACMSGEN Utility 10.1 How ACMSGEN Works 10.2 How to Run the ACMSGEN Utility 10.3 Types of Parameter Values 10.4 Changing Parameter Values 10.4.1 Changing Current Values 10.4.2 Changing Active Values 10.5 Using a Parameter Work File 10.6 Displaying Parameter Values 10.7 ACMS Parameters 10.7.1 Types of ACMS Parameters 10.7.2 Parameter Descriptions 10.7.3 Parameter Values 10.8 Summary of ACMSGEN Commands and Qualifiers 11 Auditing Applications with the Audit Trail Logger 11.1 Understanding the Audit Trail Logger 11.2 Using the Audit Trail Log File 11.3 Events Recorded by the Audit Trail Logger 11.4 Running the ATR Utility 11.5 Creating Log Reports 11.5.1 Creating Full Log Reports 11.5.2 Creating Brief Log Reports 11.6 Selecting Audit Trail Records 11.6.1 Selecting Records by Submitter and Task Identification Code 11.6.2 Selecting Application Information 11.6.3 Selecting Task Information 11.6.4 Selecting User Information 11.6.5 Creating an Audit Trail Record for the QTI Process 11.6.6 Creating an Audit Trail Record for Application Modification 11.6.7 Creating an Audit Trail Record for Server Process Dump 11.6.8 Audit Trail Record for Server Replacement 11.6.9 Creating an Audit Trail Record for Insufficient Workspace Pool 11.7 Auditing the System 11.7.1 Auditing on the Submitter Node 11.7.2 Auditing on the Application Node 11.7.3 Auditing on Remote Nodes 11.8 System Messages from Other Products 11.9 Summary of the ATR Commands and Qualifiers 12 Logging Software Events 12.1 How SWLUP Works 12.2 How to Run SWLUP 12.3 Summary of SWLUP Commands and Qualifiers 13 Tuning Your Application 13.1 Major Issues in ACMS Application Performance 13.2 Monitoring Tools 13.3 ACMS Processes That Affect Performance 13.4 Configuration of Hardware 13.4.1 Estimating Memory Requirements 13.4.2 Estimating CPU Requirements 13.4.3 Estimating Disk Requirements 13.4.4 Sample Configuration 13.5 Configuring the Command Process 13.6 Configuring the Application Execution Controller 13.7 Configuring the Server Process 13.8 Tuning and Maintaining the Queued Task Facility 13.8.1 Configuring the QTI Process 13.8.2 QTI Task Execution Threads 13.8.3 Tuning Task Queue Files 13.8.4 Maintaining Task Queue Files 13.9 Tuning Checklist 14 Using DECtrace with ACMS Applications 14.1 Overview of DECtrace 14.2 Improving Application Management with DECtrace 14.3 Collecting Event Data for ACMS 14.3.1 Describing ACMS Events and Items 14.3.2 Registering the Facility Definition 14.3.3 Creating a Selection 14.3.4 Scheduling Data Collection 14.3.5 Using Registration IDs 14.4 Creating a Report Based on Collected Data 14.4.1 Formatting and Merging Data Files 14.4.2 Generating a Report 14.4.3 Creating a Customized Report 14.5 ACMS Database Relations Part II Reference Section 15 DDU Commands 15.1 ADD Command (DDU>) 15.2 COPY Command (DDU>) 15.3 DEFAULT Command (DDU>) 15.4 EXIT Command (DDU>) 15.5 HELP Command (DDU>) 15.6 LIST Command (DDU>) 15.7 MODIFY Command (DDU>) 15.8 REMOVE Command (DDU>) 15.9 RENAME Command (DDU>) 15.10 SHOW Command (DDU>) 16 UDU Commands 16.1 ADD Command (UDU>) 16.2 COPY Command (UDU>) 16.3 DEFAULT Command (UDU>) 16.4 EXIT Command (UDU>) 16.5 HELP Command (UDU>) 16.6 LIST Command (UDU>) 16.7 MODIFY Command (UDU>) 16.8 REMOVE Command (UDU>) 16.9 RENAME Command (UDU>) 16.10 SHOW Command (UDU>) 17 AAU Commands 17.1 ADD Command (AAU>) 17.2 COPY Command (AAU>) 17.3 DEFAULT Command (AAU>) 17.4 EXIT Command (AAU>) 17.5 HELP Command (AAU>) 17.6 LIST Command (AAU>) 17.7 MODIFY Command (AAU>) 17.8 REMOVE Command (AAU>) 17.9 RENAME Command (AAU>) 17.10 SHOW Command (AAU>) 18 ACMSQUEMGR Commands 18.1 CREATE QUEUE Command (ACMSQUEMGR>) 18.2 DELETE ELEMENT Command (ACMSQUEMGR>) 18.3 DELETE QUEUE Command (ACMSQUEMGR>) 18.4 EXIT Command (ACMSQUEMGR>) 18.5 HELP Command (ACMSQUEMGR>) 18.6 MODIFY QUEUE Command (ACMSQUEMGR>) 18.7 SET ELEMENT Command (ACMSQUEMGR>) 18.8 SET QUEUE Command (ACMSQUEMGR>) 18.9 SHOW ELEMENT Command (ACMSQUEMGR>) 18.10 SHOW QUEUE Command (ACMSQUEMGR>) 19 Operator Commands 19.1 ACMS/CANCEL TASK Command 19.2 ACMS/CANCEL USER Command 19.3 ACMS/ENTER Command 19.4 ACMS/INSTALL Command 19.5 ACMS/MODIFY APPLICATION Command 19.6 ACMS/REPLACE SERVER Command 19.7 ACMS/REPROCESS APPLICATION_SPEC Command 19.8 ACMS/RESET AUDIT Command 19.9 ACMS/RESET TERMINALS Command 19.10 ACMS/SET QUEUE Command 19.11 ACMS/SET SYSTEM Command 19.12 ACMS/SHOW APPLICATION Command 19.13 ACMS/SHOW APPLICATION/CONTINUOUS Command 19.14 ACMS/SHOW QTI Command 19.15 ACMS/SHOW QUEUE Command 19.16 ACMS/SHOW SERVER Command 19.17 ACMS/SHOW SYSTEM Command 19.18 ACMS/SHOW TASK Command 19.19 ACMS/SHOW USER Command 19.20 ACMS/START APPLICATION Command 19.21 ACMS/START QTI Command 19.22 ACMS/START QUEUE Command 19.23 ACMS/START SYSTEM Command 19.24 ACMS/START TERMINALS Command 19.25 ACMS/STOP APPLICATION Command 19.26 ACMS/STOP QTI Command 19.27 ACMS/STOP QUEUE Command 19.28 ACMS/STOP SYSTEM Command 19.29 ACMS/STOP TERMINALS Command 20 ACMSGEN Commands 20.1 EXIT Command (ACMSGEN>) 20.2 HELP Command (ACMSGEN>) 20.3 SET Command (ACMSGEN>) 20.4 SHOW Command (ACMSGEN>) 20.5 USE Command (ACMSGEN>) 20.6 USE ACTIVE Command (ACMSGEN>) 20.7 USE CURRENT Command (ACMSGEN>) 20.8 USE DEFAULT Command (ACMSGEN>) 20.9 WRITE Command (ACMSGEN>) 20.10 WRITE ACTIVE Command (ACMSGEN>) 20.11 WRITE CURRENT Command (ACMSGEN>) 21 ATR Commands 21.1 EXIT Command (ATR>) 21.2 HELP Command (ATR>) 21.3 LIST Command (ATR>) 22 SWLUP Commands 22.1 @ (At sign) Command (SWLUP>) 22.2 EDIT Command (SWLUP>) 22.3 EXIT Command (SWLUP>) 22.4 HELP Command (SWLUP>) 22.5 LIST Command (SWLUP>) 22.6 RENEW Command (SWLUP>) 22.7 SAVE Command (SWLUP>) 22.8 SET [NO]LOG Command (SWLUP>) 22.9 SET [NO]VERIFY Command (SWLUP>) 22.10 SHOW CURRENT Command (SWLUP>) 22.11 SHOW LOG Command (SWLUP>) 22.12 SHOW VERSION Command (SWLUP>) 22.13 STOP Command (SWLUP>) A Parameter and Quota Calculations A.1 Calculating VMS SYSGEN Parameters Affected by ACMS A.1.1 Calculating Quotas for VMS User Names of ACMS Processes A.1.1.1 User Name Setup for the ACC A.1.1.2 User Name Setup for the TSC A.1.1.3 User Name Setup for the CP A.1.1.4 User Name Setup for the QTI A.1.1.5 User Name Setup for the EXC A.1.2 Calculating Quotas for ACMS Server Processes A.2 Calculating Quotas for Using the ADU Utility A.3 Calculating Quotas for Using the ACMS Task Debugger A.4 Calculating Values for Certain ACMSGEN Parameters A.4.1 Calculating the Value of MAX_LOGINS A.4.2 Calculating the Value of MSS_MAXOBJ A.4.3 Calculating the Value of MSS_MAXBUF A.4.4 Calculating the Value of MSS_POOLSIZE A.4.5 Calculating the Value of MSS_PROCESS_POOL A.4.6 Calculating the Value of PERM_CPS A.4.7 Calculating ACMS Workspace Pools A.4.7.1 Types of Workspace Pools A.4.7.2 Workspace Pool Allocation Failures A.4.7.3 ACMS Workspace Pool Requirements A.4.7.3.1 Task Instance Workspace Pool Requirements A.4.7.3.2 Task Instance Control Pool Requirements A.4.7.3.3 Group Workspace Pool Requirements A.4.7.3.4 User Workspace Pool Requirements A.4.7.4 Calculating Workspace Pool Sizes A.4.7.4.1 Calculating the Value of TWS_POOLSIZE and TWSC_POOLSIZE A.4.7.4.2 Calculating the Value of WS_POOLSIZE and WSC_POOLSIZE B Error Messages B.1 ACMS Error Messages B.2 Error Messages from Other Products C Requirements for Successful ACMS Logins C.1 ACMS Login Requirements EXAMPLES 2-1 DDU SHOW Command 4-1 AAU SHOW Command 5-1 ACMSQUEMGR SHOW QUEUE Command 5-2 ACMSQUEMGR SHOW ELEMENT/FULL 6-1 Using a Logical Name for a Node 6-2 Using a Logical Name for an Application 7-1 ACMS/SHOW SYSTEM Command 7-2 ACMS/SHOW SYSTEM/POOL Command 7-3 ACMS/SHOW QTI Command 7-4 ACMS/SHOW QUEUE Command 7-5 ACMS/SHOW USER/FULL Command 8-1 ACMS/SHOW APPLICATION Command 8-2 ACMS/SHOW APPLICATION/POOL TEST Command 8-3 ACMS/SHOW APPLICATION/CONTINUOUS Command 8-4 ACMS/SHOW TASK Command 9-1 Modified Variable Values in the ACMVARINI.DAT File 9-2 Variables in ACMEXCPAR_GENVAR.DAT Template 10-1 ACMSGEN SHOW/ALL Command 10-2 ACMSGEN SHOW/TSC Command 11-1 ATR LIST Command 11-2 ATR LIST/BRIEF Command 11-3 ATR LIST/TYPE=TASK Command 11-4 ATR LIST/USERNAME/TYPE Command 11-5 QTI Audit Entry 11-6 Application Modification Audit Entry 11-7 Server Process Dump Audit Entry 11-8 Server Process Dump Failure Audit Entry 11-9 Server Replacement Audit Entry 11-10 Insufficient Workspace Audit Entry 11-11 Authentication Request Record 11-12 Authentication Success Record 11-13 Audited Authentication Failure Record 14-1 Summary Report for ACMS Event Data 14-2 Using Reporting Options to Generate a Customized Report 14-3 Sample DECtrace Customized Report Based on ACMS Data FIGURES 4-1 AAU Application Authorization Process 4-2 Conditions for Installing an Application 6-1 Distributed Forms Processing 8-1 Process of Installing an Application 9-1 Setting System Parameters and Process Quotas with ACMSPARAM.COM 9-2 Setting EXC Process Quotas with ACMEXCPAR.COM 13-1 Sample Distributed ACMS Configuration