Solstice Enterprise Manager 4.1 C++ API Reference

Preface

The C++ API Reference provides an extensive list of the classes and member methods (functions) defined in the Portable Management Interface (PMI) used to communicate with the Solstice Enterprise Manager^TM (Solstice EM) Management Information Server (MIS).

Who Should Use This Book

This document is intended for programmers developing applications running with the Solstice EM MIS. A thorough working knowledge of C++ and experience using complex programmatic interfaces is assumed.

Before You Read This Book

If you have just acquired the Solstice EM product, read the Managing Your Network for an overview of the Solstice EM product functions, features, and components. Read the Release Notes for information on installing and starting the product, compatibility issues, minimum hardware and software requirements, known problems, an inventory of the product components, and late breaking information. Also refer the books listed in Related Books section for relevant information.

How This Book Is Organized

This document is organized as follows:

Chapter 1 Application Programming Interface describes the Application Programming Interfaces, Viewer, and Grapher APIs.

Chapter 2 Common API describes the classes, methods, and data members that are useful when using the low- or high-level portions of the PMI.

Chapter 3 High-Level PMI describes the classes and methods used for the high-level PMI.

Chapter 4 Low-Level PMI describes the classes and methods used for the low-level PMI.

Chapter 5 Access Control API describes the classes and methods used for the Access Control Class.

Chapter 6 Access Control Engine API describes the classes and methods used for Access Control Engine Class.

Chapter 7 Nerve Center Interface describes the classes and methods that make up the Request Interface Library, which allows your application to build, send, and receive requests.

Chapter 8 Topology API explains how to use this tool to create applications without learning the details of the MIT naming tree.

Chapter 9 Object Services API explains how developers who implement object classes can use this API to describe how and when a notice is sent after receiving an event.

Related Books

Following is a list of related books:

• Developing C++ Applications
• Customizing Guide
• Managing Your Network

What Typographic Changes Mean

The following table describes the typographic changes used in this book.

TABLE P-1   Typographic Conventions 

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories; on-screen computer output	Edit your .login file. Use ls -a to list all files. machine_name% You have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	machine_name% su Password:
AaBbCc123	Command-line placeholder: replace with a real name or value	To delete a file, type rm filename.
AaBbCc123	Book titles, new words or terms, or words to be emphasized	Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

TABLE P-2   Shell Prompts

Shell	Prompt
C shell prompt	machine_name%
C shell superuser prompt	machine_name#
Bourne shell and Korn shell prompt	$
Bourne shell and Korn shell superuser prompt	#

Accessing Sun Documentation Online

The docs.sun.comsm web site enables you to access Sun technical documentation on the Web. You can browse the docs.sun.com archive or search for a specific book title or subject at http://www.oracle.com/technetwork/indexes/documentation/index.html.

Also, you can view the online documentation by pointing your browser to the following URL, file:/opt/SUNWconn/em/docs/SEMDOCHP/index.html

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. You can send your comments by email to docfeedback@sun.com.

Please include the part number of your document in the subject line of your email.