CONTENTS

  Title Page

  Copyright Page

  Information Map

  Information Table

  Preface

  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 Sign-ins
    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.1.1       How ACMS Searches for a User's Proxy
          6.2.3.1.2       Deciding Which Proxy to Use
          6.2.3.1.3       Setting Up the ACMS Proxy File
          6.2.3.1.4       Creating ACMS Proxies
          6.2.3.1.5       Creating OpenVMS Proxies
        6.2.3.2      Assigning a Default Submitter User Name Account
        6.2.3.3      Assigning Proxy Accounts in a VMScluster 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      Using Data Compression
    7.1 Overview of Data Compression
      7.1.1      Purpose of Data Compression
      7.1.2      How ACMS Uses Data Compression
      7.1.3      How Data Compression Works
    7.2 How to Use Data Compression
      7.2.1      Rules for Defining Logical Names
      7.2.2      Using Restricted and Unrestricted Modes
        7.2.2.1      Enabling Data Compression in Unrestricted Mode
        7.2.2.2      Enabling Data Compression in Restricted Mode
      7.2.3      Disabling Data Compression
      7.2.4      Enabling Logging of Data Compression
        7.2.4.1      Entries Written to the Audit Log When a New Process Is Started
        7.2.4.2      Entries Written to the Audit Log When Network Connection Is Established
      7.2.5      Disabling Logging of Network Connections
    7.3 Monitoring Data Compression

  8      Controlling the ACMS System
    8.1 Starting the ACMS System
      8.1.1      Starting ACMS Automatically
      8.1.2      Starting ACMS Interactively
    8.2 Stopping the ACMS System
      8.2.1      Stopping ACMS Automatically
      8.2.2      Stopping ACMS Interactively
    8.3 Displaying System Information
    8.4 Terminal Subsystem Controller
      8.4.1      Starting the TSC
      8.4.2      Stopping the TSC
    8.5 Operator Terminals
      8.5.1      Enabling Operator Terminals
      8.5.2      Disabling Operator Terminals
    8.6 Queued Task Initiator
      8.6.1      Starting the QTI
      8.6.2      Stopping the QTI
      8.6.3      Displaying QTI Information
    8.7 Task Queues
      8.7.1      Starting Task Queues
      8.7.2      Stopping Task Queues
      8.7.3      Displaying Task Queue Information
    8.8 Canceling ACMS Users
      8.8.1      Canceling Users with the ACMS/CANCEL USER Command
      8.8.2      Canceling Users with ACMSCANCEL.COM
      8.8.3      Displaying User Information
    8.9 Summary of Operator Commands and Qualifiers

  9      Installing and Managing Applications
    9.1 Installing Applications
    9.2 Removing Applications
    9.3 Starting Applications
    9.4 Stopping Applications
    9.5 Displaying Application Information
      9.5.1      Displaying Static Information
      9.5.2      Displaying Dynamic Information
    9.6 Modifying Active Applications
      9.6.1      Modifying Application Attributes
      9.6.2      Modifying Server Attributes
      9.6.3      Modifying Task Attributes
    9.7 Replacing a Server Image
    9.8 Maintaining Application Availability
    9.9 Canceling Tasks
    9.10 Displaying Task Information
    9.11 Directing TDMS Hardcopy

  10     Setting ACMS Quotas, Parameters, and Privileges
    10.1 Introduction
    10.2 Calculating Parameters and Quotas with ACMSPARAM.COM
      10.2.1     Running ACMSPARAM.COM
        10.2.1.1     GENVAR Phase of ACMSPARAM.COM
        10.2.1.2     GENPAR Phase of ACMSPARAM.COM
        10.2.1.3     WRITEPAR Phase of ACMSPARAM.COM
      10.2.2     Supplying Variable Values for ACMSPARAM.COM
        10.2.2.1     Supplying Variables with ACMS$MONITOR.COM
        10.2.2.2     Editing ACMVARINI.DAT to Supply Variables to ACMSPARAM.COM
    10.3 Calculating EXC Process Quotas with ACMEXCPAR.COM
      10.3.1     Running ACMEXCPAR.COM
      10.3.2     Supplying Variable Values for ACMEXCPAR.COM
      10.3.3     Modifying Variable Values for Use by ACMEXCPAR.COM

  11     Changing ACMS Parameter Values with the ACMSGEN Utility
    11.1 How ACMSGEN Works
    11.2 How to Run the ACMSGEN Utility
    11.3 Types of Parameter Values
    11.4 Changing Parameter Values
      11.4.1     Changing Current Values
      11.4.2     Changing Active Values
    11.5 Using a Parameter Work File
    11.6 Displaying Parameter Values
    11.7 ACMS Parameters
      11.7.1     Types of ACMS Parameters
      11.7.2     Parameter Descriptions
      11.7.3     Parameter Values
    11.8 Summary of ACMSGEN Commands and Qualifiers

  12     Auditing Applications with the Audit Trail Logger
    12.1 Understanding the Audit Trail Logger
    12.2 Using the Audit Trail Log File
    12.3 Events Recorded by the Audit Trail Logger
    12.4 Running the ATR Utility
    12.5 Creating Log Reports
      12.5.1     Creating Full Log Reports
      12.5.2     Creating Brief Log Reports
    12.6 Selecting Audit Trail Records
      12.6.1     Selecting Records by Submitter and Task Identification Code
      12.6.2     Selecting Application Information
      12.6.3     Selecting Task Information
      12.6.4     Selecting User Information
      12.6.5     Creating an Audit Trail Record for the QTI Process
      12.6.6     Creating an Audit Trail Record for Application Modification
      12.6.7     Creating an Audit Trail Record for Server Process Dump
      12.6.8     Audit Trail Record for Server Replacement
      12.6.9     Creating an Audit Trail Record for Insufficient Workspace Pool
    12.7 Auditing the System
      12.7.1     Auditing on the Submitter Node
      12.7.2     Auditing on the Application Node
      12.7.3     Auditing on Remote Nodes
    12.8 System Messages from Other Products
    12.9 Summary of the ATR Commands and Qualifiers

  13     Logging Software Events
    13.1 How SWLUP Works
    13.2 How to Run SWLUP
    13.3 Summary of SWLUP Commands and Qualifiers

  14     Tuning Your Application
    14.1 Major Issues in ACMS Application Performance
    14.2 Monitoring Tools
    14.3 ACMS Processes that Affect Performance
    14.4 Configuration of Hardware
      14.4.1     Estimating Memory Requirements
      14.4.2     Estimating CPU Requirements
      14.4.3     Estimating Disk Requirements
      14.4.4     Sample Configuration
    14.5 Configuring the Command Process
    14.6 Configuring the Application Execution Controller
    14.7 Configuring the Server Process
    14.8 Tuning and Maintaining the Queued Task Facility
      14.8.1     Configuring the QTI Process
      14.8.2     QTI Task Execution Threads
      14.8.3     Tuning Task Queue Files
      14.8.4     Maintaining Task Queue Files
    14.9 Tuning Checklist

  15     Using DECtrace with ACMS Applications
    15.1 Overview of DECtrace
    15.2 Improving Application Management with DECtrace
    15.3 Collecting Event Data for ACMS
      15.3.1     Describing ACMS Events and Items
        15.3.1.1     ACMS Events
        15.3.1.2     DECtrace and ACMS Items
        15.3.1.3     DECtrace Cross Facility Items
      15.3.2     How to Use Cross Facility Items
    15.4 ACMS Collection Classes
      15.4.1     Registering the Facility Definition
      15.4.2     Creating a Selection
      15.4.3     Collecting Cross Facility Items
      15.4.4     Scheduling Data Collection
      15.4.5     Using Registration IDs
    15.5 Creating a Report Based on Collected Data
      15.5.1     Formatting and Merging Data Files
      15.5.2     Generating a Report
      15.5.3     Generating a Report with Cross Facility Items
      15.5.4     Creating a Customized Report
    15.6 ACMS Database Relations

  16     Managing ACMS Licensing
    16.1 Overview of ACMS Kits and Licensing Options
      16.1.1     ACMS Kits
      16.1.2     ACMS License Types
    16.2 License Unit Allocation
      16.2.1     License Unit Allocation in Clusters
      16.2.2     Concurrent-Use Licenses with the QTI
      16.2.3     Concurrent-Use Licenses with Detached Tasks
    16.3 Managing Systems with Concurrent-Use Licenses
      16.3.1     Releasing License Units

  Part II    Reference Section

  17     DDU Commands
    17.1 ADD Command (DDU>)
    17.2 COPY Command (DDU>)
    17.3 DEFAULT Command (DDU>)
    17.4 EXIT Command (DDU>)
    17.5 HELP Command (DDU>)
    17.6 LIST Command (DDU>)
    17.7 MODIFY Command (DDU>)
    17.8 REMOVE Command (DDU>)
    17.9 RENAME Command (DDU>)
    17.10 SHOW Command (DDU>)

  18     UDU Commands
    18.1 ADD Command (UDU>)
    18.2 ADD /PROXY Command (UDU>)
    18.3 COPY Command (UDU>)
    18.4 CREATE /PROXY Command (UDU>)
    18.5 DEFAULT Command (UDU>)
    18.6 EXIT Command (UDU>)
    18.7 HELP Command (UDU>)
    18.8 LIST Command (UDU>)
    18.9 LIST /PROXY Command (UDU>)
    18.10 MODIFY Command (UDU>)
    18.11 REMOVE Command (UDU>)
    18.12 REMOVE /PROXY Command (UDU>)
    18.13 RENAME Command (UDU>)
    18.14 SHOW Command (UDU>)
    18.15 SHOW /PROXY Command (UDU>)

  19     AAU Commands
    19.1 ADD Command (AAU>)
    19.2 COPY Command (AAU>)
    19.3 DEFAULT Command (AAU>)
    19.4 EXIT Command (AAU>)
    19.5 HELP Command (AAU>)
    19.6 LIST Command (AAU>)
    19.7 MODIFY Command (AAU>)
    19.8 REMOVE Command (AAU>)
    19.9 RENAME Command (AAU>)
    19.10 SHOW Command (AAU>)

  20     ACMSQUEMGR Commands
    20.1 CREATE QUEUE Command (ACMSQUEMGR>)
    20.2 DELETE ELEMENT Command (ACMSQUEMGR>)
    20.3 DELETE QUEUE Command (ACMSQUEMGR>)
    20.4 EXIT Command (ACMSQUEMGR>)
    20.5 HELP Command (ACMSQUEMGR>)
    20.6 MODIFY QUEUE Command (ACMSQUEMGR>)
    20.7 SET ELEMENT Command (ACMSQUEMGR>)
    20.8 SET QUEUE Command (ACMSQUEMGR>)
    20.9 SHOW ELEMENT Command (ACMSQUEMGR>)
    20.10 SHOW QUEUE Command (ACMSQUEMGR>)

  21     Operator Commands
    21.1 ACMS/CANCEL TASK Command
    21.2 ACMS/CANCEL USER Command
    21.3 ACMS/DEBUG Command
    21.4 ACMS/ENTER Command
    21.5 ACMS/INSTALL Command
    21.6 ACMS/MODIFY APPLICATION Command
    21.7 ACMS/REPLACE SERVER Command
    21.8 ACMS/REPROCESS APPLICATION_SPEC Command
    21.9 ACMS/RESET AUDIT Command
    21.10 ACMS/RESET TERMINALS Command
    21.11 ACMS/SET QUEUE Command
    21.12 ACMS/SET SYSTEM Command
    21.13 ACMS/SHOW APPLICATION Command
    21.14 ACMS/SHOW APPLICATION/CONTINUOUS Command
    21.15 ACMS/SHOW QTI Command
    21.16 ACMS/SHOW QUEUE Command
    21.17 ACMS/SHOW SERVER Command
    21.18 ACMS/SHOW SYSTEM Command
    21.19 ACMS/SHOW TASK Command
    21.20 ACMS/SHOW USER Command
    21.21 ACMS/START APPLICATION Command
    21.22 ACMS/START QTI Command
    21.23 ACMS/START QUEUE Command
    21.24 ACMS/START SYSTEM Command
    21.25 ACMS/START TASK Command
    21.26 ACMS/START TERMINALS Command
    21.27 ACMS/STOP APPLICATION Command
    21.28 ACMS/STOP QTI Command
    21.29 ACMS/STOP QUEUE Command
    21.30 ACMS/STOP SYSTEM Command
    21.31 ACMS/STOP TERMINALS Command

  22     ACMSGEN Commands
    22.1 EXIT Command (ACMSGEN>)
    22.2 HELP Command (ACMSGEN>)
    22.3 SET Command (ACMSGEN>)
    22.4 SHOW Command (ACMSGEN>)
    22.5 USE Command (ACMSGEN>)
    22.6 USE ACTIVE Command (ACMSGEN>)
    22.7 USE CURRENT Command (ACMSGEN>)
    22.8 USE DEFAULT Command (ACMSGEN>)
    22.9 WRITE Command (ACMSGEN>)
    22.10 WRITE ACTIVE Command (ACMSGEN>)
    22.11 WRITE CURRENT Command (ACMSGEN>)

  23     ATR Commands
    23.1 EXIT Command (ATR>)
    23.2 HELP Command (ATR>)
    23.3 LIST Command (ATR>)

  24     SWLUP Commands
    24.1 @ (At sign) Command (SWLUP>)
    24.2 EDIT Command (SWLUP>)
    24.3 EXIT Command (SWLUP>)
    24.4 HELP Command (SWLUP>)
    24.5 LIST Command (SWLUP>)
    24.6 RENEW Command (SWLUP>)
    24.7 SAVE Command (SWLUP>)
    24.8 SET [NO]LOG Command (SWLUP>)
    24.9 SET [NO]VERIFY Command (SWLUP>)
    24.10 SHOW CURRENT Command (SWLUP>)
    24.11 SHOW LOG Command (SWLUP>)
    24.12 SHOW VERSION Command (SWLUP>)
    24.13 STOP Command (SWLUP>)

  A Parameter and Quota Calculations
    A.1 Calculating OpenVMS SYSGEN Parameters Affected by ACMS
      A.1.1      Calculating the Value of CHANNELCNT
      A.1.2      Calculating the Value of GBLPAGES
      A.1.3      Calculating the Value of GBLPAGFIL
      A.1.4      Calculating the Value of GBLSECTIONS
      A.1.5      Calculating the Value of LOCKIDTBL
      A.1.6      Task Debugger Parameters and Values
    A.2 Calculating Quotas for OpenVMS User Names of ACMS Processes
      A.2.1      User Name Setup for the ACC
        A.2.1.1      How ACMSPARAM.COM Calculates Values for the ACC
      A.2.2      User Name Setup for the TSC
        A.2.2.1      How ACMSPARAM.COM Calculates Values for the TSC
      A.2.3      User Name Setup for the CP
        A.2.3.1      How ACMSPARAM.COM Calculates Values for the CP
      A.2.4      User Name Setup for the QTI
        A.2.4.1      How ACMSPARAM.COM Calculates Values for the QTI
      A.2.5      User Name Setup for the EXC
        A.2.5.1      How ACMEXCPAR.COM Calculates Values for the EXC
      A.2.6      Calculating Quotas for ACMS Server Processes
    A.3 Calculating Quotas for Using the ADU Utility
    A.4 Calculating Quotas for Using the ACMS Task Debugger
    A.5 Calculating Values for Certain ACMSGEN Parameters
      A.5.1      Calculating the Value of MAX_LOGINS
      A.5.2      Calculating the Value of MSS_MAXOBJ
      A.5.3      Calculating the Value of MSS_MAXBUF
      A.5.4      Calculating the Value of MSS_POOLSIZE
      A.5.5      Calculating the Value of MSS_PROCESS_POOL
      A.5.6      Calculating the Value of PERM_CPS
      A.5.7      Calculating ACMS Workspace Pools
        A.5.7.1      Types of Workspace Pools
        A.5.7.2      Workspace Pool Allocation Failures
        A.5.7.3      ACMS Workspace Pool Requirements
          A.5.7.3.1      Task Instance Workspace Pool Requirements
          A.5.7.3.2      Task Instance Control Pool Requirements
          A.5.7.3.3      Group Workspace Pool Requirements
          A.5.7.3.4      User Workspace Pool Requirements
        A.5.7.4      Calculating Workspace Pool Sizes
          A.5.7.4.1      Calculating the Value of TWS_POOLSIZE and TWSC_POOLSIZE
          A.5.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 Sign-Ins
    C.1 ACMS Sign-In Requirements