Solstice Enterprise Manager 4.1 Developing C++ Applications Doc Set ContentsPreviousNextIndex


Preface

Developing C++ Applications explains how to use the C++ APIs of SolsticeTM Enterprise ManagerTM (Solstice EM) to develop network management applications. Use this book with the C++ API Reference.

Who Should Use This Book

This book is intended for software developers who are using Solstice EM to develop network management applications. Knowledge of C++, object-oriented design, and object-oriented programming are assumed.

This book assumes that you are familiar with the principles and concepts of network management and that you have had some experience managing or developing applications to manage a network.

Before You Read This Book

If you have just acquired the Solstice EM product, read the Customizing Guide 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.

How This Book Is Organized

This book is organized as follows:

Chapter 1 Introduction to the Solstice EM C++ Development Environment introduces the C++ APIs of Solstice EM. This chapter explains which types of applications you can develop with the C++ APIs of Solstice EM. This chapter also introduces the Solstice EM network management and programming models, and provides an overview of the application development process.

Chapter 2 Modeling Managed Objects explains how to write an object model by using Guidelines for the Definition of Managed Objects (GDMO) and Abstract Syntax Notation One (ASN.1). This chapter introduces the ISO management model on which Solstice EM is based. In addition, this chapter provides detailed instructions on how to fill out GDMO templates and write ASN.1 module specifications. This chapter also explains how to make your object model available to Solstice EM.

Chapter 3 Enabling Applications to Access Managed Objects explains how to connect an application to the management information server (MIS) to enable the application to access managed objects. This chapter also explains how to bypass the MIS to access Solstice EM databases directly.

Chapter 4 Handling Errors explains how to handle errors in function calls by using the operators and functions that Solstice EM provides for error handling.

Chapter 5 Performing Operations on Managed Objects explains how to perform management operations on individual managed objects to control and monitor managed resources in a network. This chapter also explains how to simulate an agent object.

Chapter 6 Performing Management Operations on Object Collections explains how to perform bulk operations on managed objects by selecting multiple managed objects to be the subject of a management operation.

Chapter 7 Handling Events explains how to enable an application to receive event notifications that are emitted by managed objects and process the information contained in event notifications.

Chapter 8 Performing Asynchronous Management Operations explains how to perform asynchronous operations on managed objects and object collections. This chapter also explains how to handle responses to asynchronous operations that an application receives.

Chapter 9 Encoding and Decoding Complex ASN.1 Values explains how to enable an application to encode complex ASN.1 values for transmission in management requests. This chapter also explains how to enable an application to decode complex ASN.1 values received in responses and event notifications.

Chapter 10 Developing Object Behaviors explains how to use the Solstice EM object development tools (ODT) to develop object behaviors.

Chapter 11 Writing Management Protocol Adaptors (MPAs) reviews some of the important concepts behind the MPAs of Solstice EM. This chapter uses the sample MPA implementation included with Solstice EM to illustrate the MPA interfaces and environments.

Chapter 12 Controlling Access to Applications and Data explains how to make applications and data secure by controlling access to applications, application features, managed objects, event notifications, and management protocol adapters (MPAs).

Chapter 13 Optimizing Performance explains how to tune an application to obtain optimum performance.

Chapter 14 Guidelines for Compiling and Linking Applications states the compiler version requirements for applications you develop by using the Solstice EM C++ APIs. It lists, for each class in the Solstice EM C++ APIs, the header files you need to include in your application code and the libraries you need to link your applications with. This chapter also explains the flags you must set when you compile applications developed by using the Solstice EM C++ APIs.

Chapter 15 Troubleshooting provides guidelines on how to troubleshoot errors specific to applications developed by using the Solstice EM C++ APIs. This chapter also explains how to obtain debug information from the Solstice EM platform.

Chapter 16 Integrating Applications With Solstice EM explains how to add new applications to the Network Tools and Administration windows of Solstice EM. This chapter also explains how to make new applications accessible by extending the menus of existing Solstice EM tools.

Chapter 17 Writing RPC Agents for Solstice EM provides guidance on how to write agents by using the Site/SunNet/Domain Manager (SNM) interfaces and libraries.

Appendix A Solstice EM C++ Source Code Examples introduces the C++ source code examples supplied with Solstice EM and provides guidelines for compiling these examples.

Appendix B Standards Reference and Further Reading lists the standards on which Solstice EM is based. In addition, this appendix provides a list of technical terms used in the Solstice EM environment with a reference for each term to the standard in which the term is defined. This appendix also provides a list of other books that explain concepts on which Solstice EM is based.

Appendix C GDMO Templates describes the templates defined by ITU-T X.722/ISO-10165-4 Guidelines for the Definition of Managed Objects (GDMO).

Typographic Conventions

The following table describes the typographic conventions 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.
prompt% 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

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
prompt%
C shell superuser prompt
prompt#
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.


Sun Microsystems, Inc.
Copyright information. All rights reserved.
Doc Set  |   Contents   |   Previous   |   Next   |   Index