Oracle Enterprise Manager Application Developer's Guide Release 1.4.0 A53701_01 |
|
This preface describes the purpose and organization of the Oracle Enterprise Manager Application Developer's Guide. It also illustrates the conventions used in this guide. The preface contains the following information:
This guide presents a general overview of developing applications that integrate into Oracle Enterprise Manager (OEMGR). It also discusses common services and using Tcl and OraTcl to write job and event scripts.
Information in this guide applies to Oracle Enterprise Manager running on the Windows NT 32 Bit platforms.
This guide is written for software developers who wish to integrate their applications into Oracle Enterprise Manager.
Throughout this book there are references to source code files where you can find examples of the functionality that is being discussed. The code examples are included in the Enterprise Manager Software Developer's Kit (SDK) installation option that is available with the Oracle Enterprise Manager release. For information about installing Oracle Enterprise Manager components, see the Oracle Enterprise Manager Installation Guide.
The installed code samples are installed in subdirectories of the ORACLE_HOME\SYSMAN\SDK
directory. Microsoft Visual C++ 4.2 makefiles have been included with the code, allowing you to build and debug the application yourself. You may need to make minor modifications to the makefiles to successfully build the sample application. See the SDK readme
file in the ORACLE_HOME\SYSMAN\SDK
directory for information on how to modify the makefiles and install the application after it is built.
This guide assumes you are familiar with the Oracle Enterprise Manager and the common administrative tasks that you wish to perform. If you are not, refer to the Oracle Enterprise Manager documentation set. This documentation set describes the tasks that you can perform with Enterprise Manager tools. In addition, the Oracle Server documentation set provides specific and thorough descriptions of the database administration tasks and recommendations on how to administer your database optimally.
This guide also assumes that you are familiar with the operation of Microsoft Windows NT, Microsoft's Object Linking and Embedding (OLE) technology, the Microsoft Foundation Classes (MFC) 4.2 and the Microsoft Visual C++ 4.2 language. Please refer to the appropriate Microsoft documentation, if necessary.
This guide is divided into the following chapters.
This chapter describes the components of Oracle Enterprise Manager, the common services, and some programming considerations.
Chapter 2, "Tool Palette and Menu Integration"
This chapter describes how to register and launch an application from the Enterprise Manager Console.
Chapter 3, "General Coding Techniques"
This chapter describes initializing an application's document object, initializing dispatch drivers, and error handling.
Chapter 4, "Repository Control Integration"
This chapter describes how to store and retrieve Enterprise Manager repository information.
Chapter 5, "Navigator and Map Integration"
This chapter describes how to integrate with the Navigator and Map components.
Chapter 6, "Discovery Cache Integration"
This chapter describes how to retrieve information from the discovery cache.
Chapter 7, "Job Scheduling Integration"
This chapter describes how to integrate with the Job Scheduling system.
Chapter 8, "Event Management Integration"
This chapter describes how to integrate with the Event Management system.
Chapter 9, "Jobs and Events Scripts"
This chapter describes how to write job and event scripts using the Tcl language.
This appendix lists the National Language Support codes.
Refer to the Oracle7 and Oracle8 publications for more information about Oracle products.
This section explains the conventions used in this guide.
Special words are provided to alert you to particular information within the body of this guide and within other manuals.
Alerts you of important information.
References other guides and operating system-specific documentation.
Highlights information that is important to remember.
Signifies helpful suggestions and practical hints.
Indicates information that you should be aware of before you perform the action described.
Code examples are shown in the following font:
command
When describing the syntax of code examples, arguments in square brackets `[option1|option2]
' are optional. The `|' signifies the `or' condition.
We value and appreciate your comments as an Oracle user and reader of the manuals. As we write, revise, and evaluate our documentation, your opinions are the most important input we receive. At the back of our printed manuals is a Reader's Comment Form, which we encourage you to use to tell us what you like and dislike about this manual or other Oracle manuals. If the form is not available, please use the following address or FAX number.