Compaq ACMS for OpenVMS

Compaq ACMS for OpenVMS

Remote Systems Management Guide

Order Number: AA-RJXRB-TE


July 2001

The Remote Manager is a process for remotely managing Compaq ACMS for OpenVMS systems. This manual describes the features of the Remote Manager, how to use those features, and how to manage the Remote Manager.

Revision/Update Information: This document supersedes the
Compaq ACMS for OpenVMS Remote Systems Management Guide, Version 4.3.

Operating System: Compaq OpenVMS Alpha, Version 6.2, 7.2--1, or 7.3
Compaq OpenVMS VAX, Version 6.2, 7.2, or 7.3

Software Version: Compaq ACMS for OpenVMS, Version 4.4



Compaq Computer Corporation
Houston, Texas


© 2001 Compaq Computer Corporation

Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office.

ACMS, DECforms, DECnet, DECset, OpenVMS, PATHWORKS, and Tru64 are trademarks of the Compaq Information Technologies Group, L.P. in the United States and other countries.

Motif is a registered trademark of The Open Group in the United States and other countries.

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

Confidential computer software. Valid license from Compaq 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.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statments accompanying such products. Nothing herein should be construed as constituting an additional warranty.

ZK6615

The Compaq OpenVMS documentation set is available on CD-ROM.

This document was prepared using VAX DOCUMENT, Version V3.2n.

Contents Index


Preface

This manual explains how to use the Remote Manager to manage local and remote systems running Compaq ACMS for OpenVMS (ACMS) software. The manual describes the features of the Remote Manager and explains how to use those features to manage ACMS systems as well as the Remote Manager itself. It also provides reference information for the utilities and commands you use in working with the Remote Manager.

Intended Audience

This manual is intended for ACMS system managers.

Operating System Information

Information about the versions of the OpenVMS operating system and other software compatible with this version of ACMS is included in Compaq ACMS for OpenVMS Version 4.4 Installation Guide.

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

Document Structure

The chapters in this manual are grouped into two main sections (parts). The first part describes the installation, configuration, and use of the Remote Manager application (through the supported interfaces) and the Remote Manager web agent. The second part contains associated API and command reference information.
Part 1 Introduction
Chapter 1 Introduces the architecture, implementation, and capabilities of ACMS remote management.
Chapter 2 Describes how to get started using the Remote Manager including preparation and startup of the server and client nodes; setting up TCP/IP; setting up SNMP; and troubleshooting the Remote Manager.
Chapter 3 Describes how to get started using the Remote Manager web agent including installation of the web agent and associated software, overview of the browser interface, and general troubleshooting tips.
Chapter 4 Describes how to manage the ACMS Remote Manager including configuring startup; starting, stopping, and logging in to the Remote Manager; starting and stopping interfaces; and modifying management parameters and log files.
Chapter 5 Describes how to use the Remote Manager to manage ACMS, including managing data collection, displaying collected data, and modifying ACMS systems.
Chapter 6 Describes how programmers can use the Open Network Computing (ONC) remote procedure call (RPC) interface to the ACMS Remote Manager to develop their own programs for managing ACMS systems.
Chapter 7 Describes how programmers can use the Simple Network Management Protocol (SNMP) interface to the ACMS Remote Manager to develop their own programs for managing ACMS systems.
Part 2 Reference Information
Chapter 8 Provides reference information about the ACMS remote management APIs, which are procedures that are intended to be called from ONC RPC clients.
Chapter 9 Provides reference information about data types and tables for the ACMS Remote Manager.
Chapter 10 Provides reference information about the commands of the ACMSCFG utility for performing operations on the Remote Manager configuration file.
Chapter 11 Provides reference information about the commands of the ACMSMGR utility for performing operations on running ACMS systems.
Chapter 12 Provides reference information about the commands of the ACMSSNAP utility for performing operations on Remote Manager data snapshot files.
Appendixes  
Appendix A Contains information about the logical names used by the Remote Manager server and the Remote Manager client (ACMSMGR utility).
Appendix B Contains information providing cross-references of remote procedure call (RPC) procedures to rights identifiers.
Appendix C Lists all error messages related to the Remote Manager server process, as well as the ACMSCFG, ACMSMGR, and ACMSSNAP utilities.

ACMS Help

ACMS and its components provide extensive online help.

Related Documents

The following table lists the books in the Compaq ACMS for OpenVMS documentation set.
ACMS Information Description
Compaq ACMS for OpenVMS Version 4.4 Release Notes+ Information about the latest release of the software
Compaq ACMS for OpenVMS Version 4.4 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 online 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:


http://www.compaq.com/openvms 

Reader's Comments

Compaq welcomes your comments on this manual.

Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:
Internet openvmsdoc@compaq.com
Fax 603 884-0120, Attention: OSSG Documentation, ZKO3-4/U08
Mail Compaq Computer Corporation
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.compaq.com/openvms 

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 HTML 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 a 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, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets must be included, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.)
[|] In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, several, or all of the options.
{ } In command format descriptions, braces indicate required elements; you must choose one of the options listed.
[| |] 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 Compaq ACMS for OpenVMS Alpha, and Compaq ACMS for OpenVMS VAX
Ada Compaq Ada for OpenVMS Alpha Systems, and Compaq Ada for OpenVMS VAX Systems
BASIC Compaq BASIC for OpenVMS, and Compaq BASIC for OpenVMS
C Compaq C for OpenVMS Alpha Systems, and Compaq C for OpenVMS VAX Systems
CDD Oracle CDD/Administrator, and Oracle CDD/Repository
COBOL Compaq COBOL for OpenVMS Alpha Systems, and Compaq COBOL for OpenVMS VAX Systems
DATATRIEVE Compaq DATATRIEVE for OpenVMS Alpha, and Compaq DATATRIEVE for OpenVMS VAX
DBMS Oracle CODASYL DBMS
DECforms Compaq DECforms for OpenVMS
FORTRAN Compaq Fortran for OpenVMS Alpha Systems, and Compaq Fortran for OpenVMS VAX Systems
OpenVMS The Compaq OpenVMS Alpha operating system, and the Compaq OpenVMS VAX operating system
Pascal Compaq Pascal for OpenVMS Alpha, and Compaq Pascal for OpenVMS VAX
PL/I PL/I for OpenVMS Systems
Rdb Oracle Rdb
SQL The SQL interface to Oracle Rdb
TDMS Compaq TDMS for OpenVMS VAX


Next Contents Index