Previous Topic: 10. MODIFICATION

Next Topic: 10.2 Exit Routine Considerations

10.1 Available User Exits


There are two types of user exits that can be used to modify
CA MICS logic:  general exits, which apply to all the
installed products, and product exits, which apply only to
the product for which they are provided.

General exits allow user routines to be used for all products
that process the raw SMF data.  General exits are briefly
described in this guide, and a more detailed description can
be found in Chapter 4 of the CA MICS System Modification
Guide.

Product exits are classified according to their purpose and
include input, work file, output, parameter-related, and
accounting exits.

o  Input exits are invoked as the raw input records are read.
   Output exits are invoked just before CA MICS writes an
   observation to the CA MICS database.

o  The CA MICS Web Analyzer provides the general input exit
   _USRSEL, which may be used to select or exclude data
   meeting special site-defined criteria, to add data
   elements, or to modify record fields as they are read.  In
   addition, the general exit, _USRIHL, is provided at the
   end of input processing to permit examination of the
   CA MICS Input History Log SAS file so that the user can
   terminate the DAILY run if critical data is missing.

o  An output exit routine is provided for each file and may
   be used to selectively block the writing of specified
   records, alter data elements in the records, or produce
   additional records for the target file or a user-defined
   file.

o  Parameter-related exits are also user exits, but are
   defined as part of the standard CA MICS installation
   process.  They are normally associated with other
   parameters or options.  For example, the Account Code
   Derivation Routine is a user exit routine for completing
   values for account codes that were defined in a separate
   but related member of prefix.MICS.PARMS, WEBACRT, the
   Account Code Definition parameter member.  These exits are
   identified in both this chapter and in Chapter 7.

o  Accounting exits are described in the CA MICS Accounting
   and Chargeback User Guide.

The user exits for the CA MICS Web Analyzer are identified
below:

o  Product Input Exits

   _USRSEL  - File Processing Selection
   _USRIHL  - Examine Input History Log

o  Product Output Exits

   USRSWPR - HTTP Performance File
   USRSSAF - WAS Server Activity File
   USRSSIF - WAS Server Interval File
   USRSMIJ - J2EE Method Interval File
   USRSHTP - HTTP Session Manager Interval File
   USRSSRV - WebContainer Servlet Interval File
   USRSHPI - JVM Heap Interval File
   USRSAGL - Agent Log File
   USRSERL - Error Messages Log File
   USRSRFL - Referer Log File
   USRSSAL - Server Access Log File

o  Product Parameter-Related Exits

    WEBACRT - Web Account Code Derivation Exit