4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 04102: Hourly CICS System Resource Overload

04102: Hourly CICS System Resource Overload

FILE:             CICS System Activity File
SAS FILE NAME:    DAYS.CICCSY01
SOURCE LOCATION:  prefix.MICS.USER.SOURCE(DYCICEXC)

SEVERITY:  Impacting            (SEVERITY='I')
MANAGEMENT AREA:  Performance   (MGMTAREA='PERFORMANCE')

PURPOSE:  Identifies those hours when the CICS workload is so
large that service may be impacted.

RATIONALE:  Poor performance will result when the CICS
workload exceeds the configuration limit.  It is possible for
one or more CICS users to cause degraded response for all by
consuming large amounts of CPU time or by doing large numbers
of I/Os.  At times this may be the result of a program which
is in an infinite loop.

It may be necessary to:

    o  Review the heaviest user's work for efficiency
       improvements.

    o  Have some users run at a lower priority.

    o  Defer some of the CICS work until off-hours.

If the installation wishes to provide some overall
distribution of service between major subsystems, e.g.,
batch, TSO, CICS, IMS, etc., then, if MVS/SE is installed,
time slice groups may be used to achieve this.

DEFINITION:  This exception is detected when the hourly CICS
CPU time or I/O exceeds the installation-defined limits.

EXCEPTION STATEMENTS:  The SAS statements identifying the
exception situation and describing the condition are stored
in the source member named in SOURCE LOCATION and are
described below.

************************************************************;
*
**  04102
**  HOURLY CICS SYSTEM RESOURCE OVERLOAD
*;
IF CSYCPUTM > cpu-time
OR CSYSERVU > service-units
OR CSYEXCPS > excps
THEN DO;
EXCCODE='04102'; SEVERITY='I'; MGMTAREA='PERFORMANCE';
EXCDESC1='HOURLY CICS SYSTEM RESOURCE OVERLOAD';
EXCDESC2='CPU TIME(HH:MM:SS)= '
        || PUT(CSYCPUTM,TIME.) ||
        ', EXCPS=' || PUT(CSYEXCPS,7.) ||
        ', SUS=' || PUT(CSYSERVU,8.);
LINK HIT;
END;

THRESHOLD MODIFICATION:  Modify the values used for CPU time,
service units, and EXCPs according to the following
conventions:

    cpu-time - the amount of CPU time is described as hours,
       minutes, and seconds.  A threshold of 3 minutes and 20
       seconds appears as:

          CSYCPUTM > HMS(0,3,20)

    service-units - the number of service units.  A threshold
       of 9000000 service units appears as:

          CSYSERVU > 9000000

    excps - the number of EXCPs (I/O).  A threshold of
       150000 EXCPs appears as:

          CSYEXCPS > 150000