# IBM_PROLOG_BEGIN_TAG 
# This is an automatically generated prolog. 
#  
# bos72L src/bos/usr/samples/ahafs/README 1.1.1.2 
#  
# Licensed Materials - Property of IBM 
#  
# Restricted Materials of IBM 
#  
# COPYRIGHT International Business Machines Corp. 2009,2017 
# All Rights Reserved 
#  
# US Government Users Restricted Rights - Use, duplication or 
# disclosure restricted by GSA ADP Schedule Contract with IBM Corp. 
#  
# IBM_PROLOG_END_TAG 
 THE SOURCE CODE EXAMPLES PROVIDED ARE ONLY INTENDED TO ASSIST IN THE
 DEVELOPMENT OF A WORKING SOFTWARE PROGRAM.  IN ADDITION, THE SOURCE
 CODE EXAMPLES MAY NOT COMPILE AND/OR BIND SUCCESSFULLY AS WRITTEN.

 INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THE SOURCE CODE
 EXAMPLES, BOTH INDIVIDUALLY AND AS ONE OR MORE GROUPS, "AS IS" WITHOUT
 WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
 LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
 PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE
 OF THE SOURCE CODE EXAMPLES, BOTH INDIVIDUALLY AND AS ONE OR MORE GROUPS,
 IS WITH YOU.  SHOULD ANY PART OF THE SOURCE CODE EXAMPLES PROVE
 DEFECTIVE, YOU (AND NOT IBM OR AN AUTHORIZED DEALER) ASSUME THE ENTIRE
 COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

 No warranty is given that the contents of the source code examples, whether
 individually or as one or more groups, will meet your requirements or that
 the source code examples are error-free.

Version: 1.0 for AIX6100-06-00-0000:
====================================
1) This directory contains the following files & directories:
    README
    bin/ 	   : Contains the user command "aha.pl".
    samplePrograms/: Contains the following:
             evMon/: Sample programs in C, Java and Perl to monitor for the
		     first occurrence of a single event.
        kextEvProd/: A sample kernel extension which provides a sample event
		     producer for the AIX Event Infrastructure.

2) If an instance of the AIX Event Infrastructure file system is not mounted,
   type the following commands to mount it at a MOUNT point (say /aha):
      mkdir /aha
      mount -v ahafs /aha /aha

   A subset of the file tree created at mount time is:
          /aha/
                evProds.list
                fs/
                        utilFs.monFactory/
                        modFile.monFactory/
                        modDir.monFactory/
                cpu/
                        schedo.monFactory/
                        waitTmCPU.monFactory/
                        pidProcessMon.monFactory/
                        processMon.monFactory/
                mem/
                        vmo.monFactory/
                        waitTmPgInOut.monFactory/
                        waitersFreePg.monFactory/

   A monitor factory (directory with suffix .monFactory) will be created for
   each event producer.

3) Now, you can use the command "bin/aha.pl" to monitor AIX Event 
   Infrastructure events easily. 

4) One can refer the sample codes under samplePrograms/evMon/ to write programs
   to monitor events.

5) The sample codes under samplePrograms/kexEvProd/ can help the programmer to
   add a custom event producer.
   
6) To unmount the AIX Event Infrastructure file system, type the following
   command:
      umount /aha

Updated on 2010/10/14.