4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 04201: Hourly CICS User Resource Overload

04201: Hourly CICS User Resource Overload

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

SEVERITY:  Warning              (SEVERITY='W')
MANAGEMENT AREA:  Workload      (MGMTAREA='WORKLOAD')

PURPOSE:  Identifies those users whose hourly workload is
large enough to impact the service to other users.

RATIONALE:  It is possible for a CICS user to cause degraded
response for others by consuming large amounts of CPU time or
by doing a large number of I/Os.  At times this may be the
result of a program that is in an infinite loop. If this
user's workload is impacting others, 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.

    o  Alter the CICS system tuning parameters for a better
       handling of the user's resource drain.

DEFINITION:   This exception is detected when an individual
user's CPU time, I/O, or service units exceed 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.

************************************************************;
*
**  04201
**  HOURLY CICS USER RESOURCE OVERLOAD
*;
IF CSUCPUTM > cpu-time
OR CSUEXCPS > i/o
OR  CSUSERVU > service-units
THEN DO;
EXCCODE='04201'; SEVERITY='W'; MGMTAREA='WORKLOAD';
EXCDESC1='HOURLY CICS USER RESOURCE OVERLOAD';
EXCDESC2='CPU TIME(HH:MM:SS)= '
        || PUT(CSUCPUTM,TIME.) ||
        ', EXCPS=' || PUT(CSUEXCPS,6.) ||
        ', SU=' || PUT(CSUSERVU,7.);
LINK HIT;
END;

THRESHOLD MODIFICATION:  Modify the values used for CPU time,
I/O, and service units 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:

          CSUCPUTM > (0,3,20)

    i/o - The number of non-terminal I/O operations.   A
       threshold of 1000 EXCPs appears as:

          CSUEXCPS > 1000

    service-units - The number of service units.  A threshold
       of 35000 service units appears as:

          CSUSERVU > 35000