HP OpenVMS Systems Documentation
Content starts here

HP ACMS for OpenVMS

Knowledge Modules

January 2006

This document provides an introduction to the HP ACMS for OpenVMS knowledge modules, which display information useful for managing an ACMS system.

Revision/Update Information: This is a revised document.

Operating System: OpenVMS Alpha Version 8.2
OpenVMS I64 Version 8.2-1

Software Version: HP ACMS for OpenVMS, Version 5.0



Hewlett-Packard Company
Palo Alto, California

© Copyright 2006 Hewlett-Packard Development Company, L.P.

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additonal warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Motif is a registered trademark of The Open Group.

Oracle is a registered US trademark of Oracle Corporation, Redwood City, California.

Oracle CODASYL DBMS, Oracle CDD/Administrator, Oracle CDD/Repository, Oracle Rdb, Oracle SQL/Services, Oracle Trace, and Oracle Trace Collector are registered US trademarks of Oracle Corporation, Redwood City, California.

Printed in the US

This document was prepared using DECdocument, Version V3.3-1e.

Contents

Preface

Intended Audience

This document describes the ACMS knowledge modules, which display information about the performance of an ACMS system.

This document is intended for anyone responsible for managing an ACMS system. This document assumes that the reader is familiar with ACMS remote systems management features. This document also assumes that the reader is familiar with the PATROL® product. Refer to the PATROL documentation for information about using PATROL consoles, loading knowledge modules, and connecting to PATROL agents (also known as hosts).

Document Structure

This document is organized as follows:

Chapter 1 Provides an overview of ACMS knowledge modules.
Chapter 2 Lists the knowledge modules that are included in HP ACMS for OpenVMS briefly describes their functions, and describes how to install the knowledge modules.
Chapter 3 Describes the stages of knowledge module operation.
Chapter 4 Describes the conventions used to identify the icons, collectors, and parameters of the ACMS knowledge modules.
Chapter 5 Describes briefly how the ACMS knowledge modules operate.
Chapter 6 Contains tables that list all ACMS knowledge module commands.
Chapter 7 Provides guidelines for modifying ACMS knowledge modules.
Chapter 8 Lists common problems and typical solutions.

Knowledge Module Documentation

The following table lists the formats and locations in which the latest version of this document can be found:

Format Location
PDF http://h71000.www7.hp.com/doc/
HTML http;//h71000.www7.hp.com/doc/

After you install ACMS on your PC, you can access the HTML and PDF versions of this document by clicking ACMS PATROL KMs on the Start menu.

ACMS Help

ACMS and its components provide extensive online help.

Note
Online Help for the ACMS knowledge modules is not available from within PATROL. Please refer to this document, which is available in PostScript, HTML, and PDF formats (see Knowledge Module Documentation).
  • 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.
  • ACMSPARAM.COM and ACMEXCPAR.COM help
    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 HP DECforms or HP TDMS, use the help systems for these products.

Related Documents

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

ACMS Information Description
HP ACMS Version 5.0 for OpenVMS Release Notes+ Information about the latest release of the software
HP ACMS Version 5.0 for OpenVMS Installation Guide Description of installation requirements, the installation procedure, and postinstallation tasks.
HP ACMS for OpenVMS Getting Started Overview of ACMS software and documentation.
Tutorial for developing a simple ACMS application.
Description of the AVERTZ sample application.
HP ACMS for OpenVMS Concepts and Design Guidelines Description of how to design an ACMS application.
HP 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.
HP 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.
HP ACMS for OpenVMS Systems Interface Programming Description of using Systems Interface (SI) Services to submit tasks to an ACMS system.
HP ACMS for OpenVMS ADU Reference Manual Reference information about the ADU commands, phrases, and clauses.
HP ACMS for OpenVMS Quick Reference List of ACMS syntax with brief descriptions.
HP ACMS for OpenVMS Managing Applications Description of authorizing, running, and managing ACMS applications, and controlling the ACMS system.
HP 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 HP 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: 


http://h71000.www7.hp.com/openvms

Reader's Comments

HP welcomes your comments on this manual.

Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:

Internet
Fax 603 884-0120, Attention: OSSG Documentation, ZKO3-4/U08
Mail Hewlett-Packard Company
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698

How To Order Additional Documentation

Use the following World Wide Web address for information about how to order additional documentation: 


http://www.hp.com/go/openvms/doc

To reach the OpenVMS documentation website, click the Documentation link.

If you need help deciding which documentation best meets your needs, call 1--800--ATCOMPA.

Conventions

The following conventions are used in this manual:

Ctrl/ x A sequence such as Ctrl/ x indicates that you must press and hold the key labeled Ctrl while you press another key or a pointing device button.
PF1 x A sequence such as PF1 x indicates that you must first press and release the key labeled PF1 and then press and release another key or a pointing device button.
[Return] In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.)

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

... A horizontal ellipsis in examples indicates one of the following possibilities:
  • Additional optional arguments in a statement have been omitted.
  • The preceding item or items can be repeated one or more times.
  • Additional parameters, values, or other information can be entered.
.
.
. 		A vertical ellipsis indicates the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.
Monospace text Monospace type indicates code examples and interactive screen displays.

In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example.

In the HMTL version of this document, this text style may appear as italics.

- A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.
numbers All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.
bold text Bold text represents the introduction of a new term or the name of an argument, an attribute, or a reason.

In the HMTL version of this document, this text style may appear as italics.

italic text Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type).
UPPERCASE 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 command format descriptions, uppercase text is an optional keyword.

UPPERCASE In command format descriptions, uppercase text that is underlined is required. You must include it in the statement if the clause is used.
lowercase In command format descriptions, a lowercase word indicates a required element.
<lowercase> In command format descriptions, lowercase text in angle brackets indicates a required clause or phrase.
( ) In command format descriptions, parentheses indicate that you must enclose the options in parentheses if you choose more than one.
[| |] In command format descriptions, vertical bars within square brackets indicate that you can choose any combination of the enclosed options, but you can choose each option only once.
{| |} In command format descriptions, vertical bars within braces indicate that you must choose one of the options listed, but you can use each option only once.

References to Products

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

Abbreviation Product
ACMS HP ACMS for OpenVMS Alpha, and HP ACMS for OpenVMS I64
Ada HP Ada for OpenVMS Alpha Systems, and HP Ada for OpenVMS I64 Systems
BASIC HP BASIC for OpenVMS
C HP C for OpenVMS Alpha Systems, and HP C for OpenVMS I64 Systems
CDD Oracle CDD/Administrator, and Oracle CDD/Repository
COBOL HP COBOL for OpenVMS Alpha Systems, and HP COBOL for OpenVMS I64 Systems
DATATRIEVE HP DATATRIEVE for OpenVMS Alpha, and HP DATATRIEVE for OpenVMS I64
DBMS Oracle CODASYL DBMS
DECforms HP DECforms
FORTRAN HP Fortran for OpenVMS Alpha Systems, and HP Fortran for OpenVMS I64 Systems
OpenVMS The OpenVMS Alpha operating system, and the OpenVMS I64 operating system
Pascal HP Pascal for OpenVMS Alpha, and HP Pascal for OpenVMS I64
Rdb Oracle Rdb
SQL The SQL interface to Oracle Rdb

Next Contents