PreviousNextIndex

About This Guide


This guide describes the Cluster Information Program (Clinfo) client application programming interfaces (APIs) and the Management Information Base (MIB) supplied with the AIX 5L High Availability Cluster Multi-Processing v.5.3 software.

Applications can access information about an HACMP cluster that is stored in the HACMP for AIX 5L MIB. They can do this directly by making Simple Network Management Protocol (SNMP) requests, or indirectly by using the Clinfo C or C++ APIs.

The following table provides version and manual part numbers for Programming Client Applications.

HACMP Version
Book Name
Book Number
5.4
Programming Client Applications
SC23-4865-09
5.3 update 7/2006
Programming Client Applications
SC23-4865-08
5.3 update 8/2005
Programming Client Applications
SC23-4865-07
5.3
Programming Client Applications
SC23-4865-06
5.2 last update 10/2005
Programming Client Applications
SC23-4865-05
5.1 last update 6/2004
Programming Client Applications
SC23-4865-02

Who Should Use This Guide

This guide is intended for application developers who want to write highly available applications that run in an HACMP for AIX 5L clustered environment or applications that want information about the cluster components. The guide assumes the reader knows the C or C++ programming language and is familiar with networking concepts.

README File

For additional information about the Clinfo API(s), see the /usr/es/sbin/cluster/samples/clinfo/README file that accompanies the product.

Highlighting

This guide uses the following highlighting conventions:

Italic
Identifies new terms or concepts, or indicates emphasis.
Bold
Identifies routines, commands, keywords, files, directories, menu items, and other items whose actual names are predefined by the system.
Monospace
Identifies examples of specific data values, examples of text similar to what you might see displayed, examples of program code similar to what you might write as a programmer, messages from the system, or information that you should actually type.

ISO 9000

ISO 9000 registered quality systems were used in the development and manufacturing of this product.

HACMP Publications

The HACMP software comes with the following publications:

  • HACMP for AIX 5L Release Notes in /usr/es/sbin/cluster/release_notes describe issues relevant to HACMP on the AIX platform: latest hardware and software requirements, last-minute information on installation, product usage, and known issues.
  • HACMP on Linux Release Notes in /usr/es/sbin/cluster/release_notes.linux/ describe issues relevant to HACMP on the Linux platform: latest hardware and software requirements, last-minute information on installation, product usage, and known issues.
  • HACMP for AIX 5L: Administration Guide, SC23-4862
  • HACMP for AIX 5L: Concepts and Facilities Guide, SC23-4864
  • HACMP for AIX 5L: Installation Guide, SC23-5209
  • HACMP for AIX 5L: Master Glossary, SC23-4867
  • HACMP for AIX 5L: Planning Guide, SC23-4861
  • HACMP for AIX 5L: Programming Client Applications, SC23-4865
  • HACMP for AIX 5L: Troubleshooting Guide, SC23-5177
  • HACMP on Linux: Installation and Administration Guide, SC23-5211
  • HACMP for AIX 5L: Smart Assist Developer’s Guide, SC23-5210
  • IBM International Program License Agreement.
  • HACMP/XD Publications

    The HACMP Extended Distance (HACMP/XD) software solutions for disaster recovery, added to the base HACMP software, enable a cluster to operate over extended distances at two sites. HACMP/XD publications include the following:

  • HACMP/XD for Geographic LVM (GLVM): Planning and Administration Guide, SA23-1338
  • HACMP/XD for HAGEO Technology: Concepts and Facilities Guide, SC23-1922
  • HACMP/XD for HAGEO Technology: Planning and Administration Guide, SC23-1886
  • HACMP/XD for Metro Mirror: Planning and Administration Guide, SC23-4863.
  • HACMP Smart Assist Publications

    The HACMP Smart Assist software helps you quickly add an instance of certain applications to your HACMP configuration so that HACMP can manage their availability. The HACMP Smart Assist publications include the following:

  • HACMP Smart Assist for DB2 User’s Guide, SC23-5179
  • HACMP Smart Assist for Oracle User’s Guide, SC23-5178
  • HACMP Smart Assist for WebSphere User’s Guide, SC23-4877
  • HACMP for AIX 5L: Smart Assist Developer’s Guide, SC23-5210
  • HACMP Smart Assist Release Notes.
  • IBM AIX 5L Publications

    The following publications offer more information about IBM technology related to or used by HACMP:

  • RS/6000 SP High Availability Infrastructure, SG24-4838
  • IBM AIX 5L v.5.3 Security Guide, SC23-4907
  • IBM Reliable Scalable Cluster Technology for AIX 5L and Linux: Group Services Programming Guide and Reference, SA22-7888
  • IBM Reliable Scalable Cluster Technology for AIX 5L and Linux: Administration Guide, SA22-7889
  • IBM Reliable Scalable Cluster Technology for AIX 5L: Technical Reference, SA22-7890
  • IBM Reliable Scalable Cluster Technology for AIX 5L: Messages, GA22-7891.
  • Accessing Publications

    Use the following Internet URLs to access online libraries of documentation:

    AIX 5L, IBM eServer pSeries, and related products:

    http://www.ibm.com/servers/aix/library

    AIX 5L v.5.3 publications:

    http://www.ibm.com/servers/eserver/pseries/library/

    WebSphere Application Server publications:

    Search the IBM website to access the WebSphere Application Server Library

    DB2 Universal Database Enterprise Server Edition publications:

    http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/v8pubs.d2w/en_main#V8PDF

    Tivoli Directory Server publications:

    http://publib.boulder.ibm.com/tividd/td/IBMDirectoryServer5.1.html

    IBM Welcomes Your Comments

    You can send any comments via e-mail to hafeedbk@us.ibm.com. Make sure to include the following in your comment or note:

  • Title and order number of this book
  • Page number or topic related to your comment.
  • When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

    Trademarks

    The following terms are trademarks of International Business Machines Corporation in the United States or other countries:

  • AFS
  • AIX
  • AIX 5L
  • DFS
  • eServer Cluster 1600
  • Enterprise Storage Server
  • HACMP
  • IBM
  • NetView
  • pSeries
  • RS/6000
  • Scalable POWERParallel Systems
  • Shark
  • SP
  • xSeries
  • WebSphere
  • Red Hat Enterprise Linux (RHEL)
  • SUSE Linux Enterprise Server
  • RPM Package Manager for Linux and other Linux trademarks.
  • UNIX is a registered trademark in the United States and other countries and is licensed exclusively through The Open Group.

    Linux is a registered trademark in the United States and other countries and is licensed exclusively through the GNU General Public License.

    Other company, product, and service names may be trademarks or service marks of others.


    PreviousNextIndex