4. EXCEPTIONS › 4.2 Setting Exception Values

4.2 Setting Exception Values

Exception test routines contain tests that determine the
conditions and definitions that classify the exception for
reporting and analysis.  The following is a sample exception
test:

/*---------------------------------------------------------*/
/*  09001                                                  */
/*  AVAILABLE VTOC SPACE SHORTAGE                          */
/*---------------------------------------------------------*/

IF VOADSCB0 LT 25

  THEN DO;
  EXCCODE = '09001'; SEVERITY= 'I'; MGMTAREA= 'AVAILABILITY';
  EXCDESC1 = 'AVAILABLE VTOC DSCB SHORTAGE';
  EXCDESC2 = 'AVAILABLE DSCB COUNT=' || PUT(VOADSCB0,3.)
           || ', VOL=' || VOLSER;
  LINK HIT;
END;

This exception test is processed for each observation that is
in the latest cycle of the DETAIL Volume Allocation File
(VCAVOA).  The test is positive only when the number of
Format 0 DSCBs (VOADSCB0) is less than 25.

When the test is positive, the exception is categorized by
providing the appropriate values for EXCCODE, SEVERITY, and
MGMTAREA.  EXCDESC1 provides a consistent label for the
exception.  EXCDESC2 provides variable information for the
conditions that caused the test to be positive.  The LINK HIT
statement invokes a routine that causes the exception
condition eventually to be written to the Exception Activity
File (ADMEXC) for later processing by the standard reports or
MICF inquiries.

For most organizations, the exception limit used here would
either cause too many exceptions or too few exceptions to be
reported, which defeats one of the purposes of exception
processing:  to report on "out of the ordinary" conditions
that warrant attention.  Therefore, each organization must
determine and set its own exception value.

Furthermore, the values for some exception conditions should
be determined uniquely for different environments within a
single organization.  For example, a system paging rate that
would be excessive during the nightly batch processing may be
normal during the daytime hours, which have heavy interactive
usage.  Also, different processors can support different
paging rates.  Numbers used as exception values should not be
defined without some analysis of installation history,
performance, and user requirements.

The CA MICS database provides a most useful information base
for analyzing historical performance.  The exception value
analysis routine uses the CA MICS database to produce a
statistical analysis of the values used in the standard
exception tests distributed with the products.

Using the results of this analysis along with your
installation's internal political, security, or standards
policies, industry publications, and your own analysis of
data element behavior, you can determine how to modify each
exception test for your environment.  You can also modify the
exception test routine to add your own tests for additional
exception conditions not detected by the standard tests
delivered with the product.