HP OpenVMS Systems Documentation

Content starts here

Compaq ACMS for OpenVMS

Managing Applications

Order Number: AA--N689J--TE

December 1999

This manual describes how to authorize, install, run, and manage Compaq ACMS for OpenVMS applications. It also provides information about controlling the Compaq ACMS for OpenVMS system and its components. For information about managing ACMS systems remotely across a network, see the Compaq ACMS for OpenVMS Remote Systems Management Guide.

Revision/Update Information: This manual supersedes Digital ACMS for OpenVMS Managing Applications Version 4.2.

Operating System: Compaq OpenVMS Alpha Version 6.2 and above, excluding Version 7.0
Compaq OpenVMS VAX Version 6.2 and above, excluding Version 7.0

Software Version: Compaq ACMS Version 4.3 for OpenVMS

Compaq Computer Corporation Houston, Texas

December 1999

Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital Equipment Corporation or an authorized sublicensor.

© Digital Equipment Corporation 1999. All rights reserved.

Compaq, the Compaq logo, and the DIGITAL logo are registered in the U.S. Patent and Trademark Office.

ACMS, ACMS Desktop, ALL-IN-1, Alpha, AlphaServer, DATATRIEVE, DEC, DECdesign, DECdtm, DECforms, DEC FORTRAN, DECnet, DECset, DIGITAL, MicroVAX, OpenVMS, PATHWORKS, Tru64, ULTRIX, VAX, VAX C, VAX COBOL, VAX DATATRIEVE, VAX DOCUMENT, VAX FMS, VAX FORTRAN, VAX RMS, VAX SMG, VAX 9000, VMS, VMScluster, VT, VT100, VT200, and VT300 are trademarks of Compaq Computer Corporation.

The following are third-party trademarks:

IBM is a registered trademark of International Business Machines, Inc.
Oracle is a registered trademark of Oracle Corporation.
Oracle CODASYL DBMS, Oracle CDD/Administrator, Oracle CDD/Repository, Oracle Rdb, Oracle SQL/Services, Oracle Trace, and Oracle Trace Collector are trademarks of Oracle Corporation.

Other product names mentioned herein may be the trademarks of their respective companies.


The OpenVMS documentation set is available on CD-ROM.

Contents Index


This manual explains how to manage the Compaq ACMS for OpenVMS (ACMS) software, and the applications running under ACMS. It also provides reference information for the utilities and commands you use in working with ACMS.

Intended Audience

Chapter 1 provides a general introduction to ACMS system and application management. This manual should be read by people responsible for:

  • Authorizing ACMS users, terminals, and applications
    See Chapter 2, Chapter 3, and Chapter 4. You should be familiar with the Compaq OpenVMS (OpenVMS) Authorize Utility. See the OpenVMS documentation for a description of the Authorize Utility.
  • Creating and managing ACMS task queues
    Chapter 5 describes how to create and manage ACMS task queues.
  • Preparing your ACMS system for distributed processing
    Chapter 6 describes how to set up and use ACMS as a distributed system.
  • Managing and operating an ACMS application system
    Chapter 8 describes how to start and stop the ACMS system and its components, as well as how to monitor system resources.
  • Installing and managing ACMS applications
    Chapter 9 describes the installation and management of ACMS applications.
  • Monitoring ACMS application and system use
    In addition to the system monitoring described in Chapter 8, Chapter 12 and Chapter 13 provide information on ACMS monitoring tools. Chapter 15 describes the use of DECtrace for collection of event-based data.
  • Tuning ACMS to improve system performance
    Chapter 10, Chapter 11, and Chapter 14 describe how to set OpenVMS and ACMS system parameters and ACMS run-time process quotas, and how to further tune the ACMS system to improve performance.

Document Structure

This manual contains 24 chapters, 3 appendixes, and an index. The chapters are grouped into two parts. The first part groups chapters in the order you would most likely use them as you prepare the ACMS environment for use. The second part contains reference chapters for each of the utilities used in managing and controlling the ACMS system and applications. An appendix section follows the second part.

Chapter 1 Introduces ACMS application management, explaining the activities that such management involves and the ACMS tools you use in managing applications.
Part 1 Managing the ACMS System and ACMS Applications
Chapter 2 Explains how to authorize terminals for access to ACMS with the Device Definition Utility (DDU) and how to define local terminals to log in directly to ACMS.
Chapter 3 Explains how to authorize users to access ACMS with the User Definition Utility (UDU).
Chapter 4 Explains how to use the Application Authorization Utility (AAU) to authorize ACMS applications.
Chapter 5 Describes how to create and manage ACMS task queues and queued task elements using the ACMS Queue Manager (ACMSQUEMGR) Utility.
Chapter 6 Describes how to set up ACMS for distributed processing.
Chapter 7 Describes how to use the data compression feature.
Chapter 8 Describes how to start and stop the ACMS system and its components, as well as monitor system resources.
Chapter 9 Describes how to install and run ACMS applications, cancel tasks, and modify active applications.
Chapter 10 Explains how to set and modify the values of ACMS system parameters, OpenVMS SYSGEN parameters affected by ACMS, and ACMS process quotas using the ACMSPARAM.COM and ACMEXCPAR.COM command procedures.
Chapter 11 Explains how to change the values of ACMS parameters with the ACMSGEN Utility, independent of the ACMSPARAM.COM command procedure. The second part of the chapter provides reference information for the ACMSGEN Utility commands.
Chapter 12 Explains how to get information about application and user activity by using the Audit Trail Report (ATR) Utility.
Chapter 13 Describes the ACMS Software Event Logger (SWL), which logs ACMS internal software errors. It also describes how to generate SWL reports by using the ACMS Software Event Log Utility Program(SWLUP).
Chapter 14 Describes the major issues in ACMS application performance, ACMS components that affect system performance, and tools for monitoring an ACMS system, and also provides a tuning checklist.
Chapter 15 Describes the use of DECtrace for collecting event-based data gathered from ACMS applications.
Chapter 16 Describes the kits and licenses available in ACMS. It also describes how to manage ACMS systems with concurrent-use licenses, unlimited-use licenses, or both.
Part 2 Reference Section
Chapter 17 Provides reference information for DDU commands.
Chapter 18 Provides reference information for UDU commands.
Chapter 19 Provides reference information for AAU commands.
Chapter 20 Provides reference information for ACMSQUEMGR Utility commands.
Chapter 21 Provides reference information for ACMS operator commands.
Chapter 22 Provides reference information for ACMSGEN Utility commands.
Chapter 23 Provides reference information for ATR Utility commands.
Chapter 24 Provides reference information for SWLUP commands.
Appendix A Describes the formulas used in the calculation of various parameters and quotas by ACMSPARAM.COM and ACMEXCPAR.COM, as well as further calculations that can be made to fine-tune the system.
Appendix B Explains how error message codes are returned by ACMS for the ACMS application management utilities and for messages returned at run time.
Appendix C Gives guidelines to ensure successful user logins.

Related Documents

The following table lists the books in the Compaq ACMS for OpenVMS documentation set.

ACMS Information Description
Compaq ACMS Version 4.3 for OpenVMS Release Notes+ Information about the latest release of the software
Compaq ACMS Version 4.3 for OpenVMS Installation Guide Description of installation requirements, the installation procedure, and postinstallation tasks.
Compaq ACMS for OpenVMS Getting Started Overview of ACMS software and documentation.
Tutorial for developing a simple ACMS application.
Description of the AVERTZ sample application.
Compaq ACMS for OpenVMS Concepts and Design Guidelines Description of how to design an ACMS application.
Compaq ACMS for OpenVMS Writing Applications Description of how to write task, task group, application, and menu definitions using the Application Definition Utility.
Description of how to write and migrate ACMS applications on an OpenVMS Alpha system.
Compaq ACMS for OpenVMS Writing Server Procedures Description of how to write programs to use with tasks and how to debug tasks and programs. Description of how ACMS works with the APPC/LU6.2 programming interface to communicate with IBM CICS applications. Description of how ACMS works with third-party database managers, with Oracle used as an example.
Compaq ACMS for OpenVMS Systems Interface Programming Description of using Systems Interface (SI) Services to submit tasks to an ACMS system.
Compaq ACMS for OpenVMS ADU Reference Manual Reference information about the ADU commands, phrases, and clauses.
Compaq ACMS for OpenVMS Quick Reference List of ACMS syntax with brief descriptions.
Compaq ACMS for OpenVMS Managing Applications Description of authorizing, running, and managing ACMS applications, and controlling the ACMS system.
Compaq ACMS for OpenVMS Remote Systems Management Guide Description of the features of the Remote Manager for managing ACMS systems, how to use the features, and how to manage the Remote Manager.
Online help+ Online help about ACMS and its utilities.

+Available on line only.

For additional information on the compatibility of other software products with this version of ACMS, refer to the Compaq ACMS for OpenVMS Software Product Description (SPD 25.50.xx).

For additional information about the Open Systems Software Group (OSSG) products and services, access the following OpenVMS World Wide Web address:



ACMS and its components provide extensive online help.

  • DCL-level help
    Enter HELP ACMS at the DCL prompt for complete help about the ACMS command and qualifiers, and for other elements of ACMS for which independent help systems do not exist. DCL-level help also provides brief help messages for elements of ACMS that contain independent help systems (such as the ACMS utilities) and for related products used by ACMS (such as DECforms or Oracle CDD/Repository).
  • ACMS utilities help
    Each of the following ACMS utilities has an online help system:
    ACMS Debugger
    ACMSGEN Utility
    ACMS Queue Manager (ACMSQUEMGR)
    Application Definition Utility (ADU)
    Application Authorization Utility (AAU)
    Device Definition Utility (DDU)
    User Definition Utility (UDU)
    Audit Trail Report Utility (ATR)
    Software Event Log Utility Program (SWLUP)

    The two ways to get utility-specific help are:
    • Run the utility and type HELP at the utility prompt.
    • Use the DCL HELP command. At the "Topic?" prompt, type @ followed by the name of the utility. Use the ACMS prefix, even if the utility does not have an ACMS prefix (except for SWLUP). For example:

      Topic? @ACMSQUEMGR
      Topic? @ACMSADU

      However, do not use the ACMS prefix with SWLUP:

      Topic? @SWLUP

    Note that if you run the ACMS Debugger Utility and then type HELP, you must specify a file. If you ask for help from the DCL level with @, you do not need to specify a file.
    Help for the command procedures that set parameters and quotas is a subset of the DCL-level help. You have access to this help from the DCL prompt, or from within the command procedures.
  • LSE help
    ACMS provides ACMS-specific help within the LSE templates that assist in the creation of applications, tasks, task groups, and menus. The ACMS-specific LSE help is a subset of the ADU help system. Within the LSE templates, this help is context-sensitive. Type HELP/IND (PF1-PF2) at any placeholder for which you want help.
  • Error help
    ACMS and each of its utilities provide error message help. Use HELP ACMS ERRORS from the DCL prompt for ACMS error message help. Use HELP ERRORS from the individual utility prompts for error message help for that utility.
  • Terminal user help
    At each menu within an ACMS application, ACMS provides help about terminal user commands, special key mappings, and general information about menus and how to select tasks from menus.
  • Forms help
    For complete help for DECforms or TDMS, use the help systems for these products.


This manual uses the following conventions:

Convention Description
new term New terms are highlighted in bold type.
italics Use of italic type indicates emphasis on a word or phrase. Titles of manuals are also italicized.
[Return] A key name in a box indicates that you press that key on the terminal keyboard.

In the HTML version of this document, this convention appears as brackets, rather than a box.

[Ctrl/x] This symbol indicates that you press the Ctrl (control) key and hold it down while pressing the specified key (indicated here by x).

In the HTML version of this document, this convention appears as brackets, rather than a box.

WORD Uppercase text indicates the name of a routine, the name of a file, the name of a file protection code, or the abbreviation for a system privilege.

In format descriptions, an uppercase word is an optional keyword

word In format descriptions, a lowercase word indicates a required element.
word In format descriptions, a lowercase word in angle brackets indicates a required clause or phrase.
In examples, a vertical ellipsis indicates that information not directly related to the example has been omitted.

References to Products

The ACMS documentation set to which this manual belongs often refers to certain products by abbreviated names:

Abbreviation Product
ACMS Compaq ACMS for OpenVMS Alpha, and Compaq ACMS for OpenVMS VAX
Ada DEC Ada for OpenVMS Alpha Systems, and DEC Ada for OpenVMS VAX Systems
C DEC C for OpenVMS Alpha Systems, and DEC C for OpenVMS VAX Systems
CDD Oracle CDD/Administrator, and Oracle CDD/Repository
COBOL DEC COBOL for OpenVMS Alpha Systems, and VAX COBOL for OpenVMS VAX Systems
DECforms Compaq DECforms
FORTRAN DEC Fortran for OpenVMS Alpha Systems, and DEC Fortran for OpenVMS VAX Systems
OpenVMS The Compaq OpenVMS Alpha operating system, and the Compaq OpenVMS VAX operating system
Pascal DEC Pascal, and VAX Pascal
Rdb Oracle Rdb
SQL The SQL interface to Oracle Rdb


The DECtrace product is the predecessor of the Oracle Trace product. Some information in the ACMS documentation, particularly in some examples, refers to DECtrace. Except where version-specific, the information applies to the Oracle Trace product as well. As you read the information, you can use the product name Oracle Trace instead of the product name DECtrace with no significant difference in meaning.

Next Contents Index