4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 04103: Hourly CICS Capacity Limit Objective Exceeded

04103: Hourly CICS Capacity Limit Objective Exceeded

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

SEVERITY:  Critical             (SEVERITY='C')
MANAGEMENT AREA:  Performance   (MGMTAREA='PERFORMANCE')

PURPOSE:  Identifies those hours when the installation-
defined capacity limit is exceeded.

RATIONALE:  Poor performance will result when CICS capacity,
measured in service units, exceeds the configuration limit.
This can be caused by growth in the number of CICS users, in
which case system reconfiguration or CICS restriction will be
required to meet service objectives.  It is also possible
that this condition can be caused by a a program that is in a
loop or by a few users who are putting an exceptional load on
the CICS system.

If installation management's objective is to restrict CICS
resource consumption to the defined capacity limit, the
detection of this exception may indicate the need to do one
or more of the following:

    o  Lower the service objectives for CICS work.

    o  Limit the number of concurrent CICS users by maxtask
       or transaction class controls.

    o  Adjust priorities for certain CICS transactions.

DEFINITION:  This exception is detected when the hourly
service unit consumption 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.


************************************************************;
*
**  04103
**  HOURLY CICS CAPACITY LIMIT OBJECTIVE EXCEEDED
*;
IF CSYSERVU > service-units
THEN DO;
EXCCODE='04103'; SEVERITY='C'; MGMTAREA='PERFORMANCE';
EXCDESC1='HOURLY CICS CAPACITY LIMIT OBJECTIVE EXCEEDED';
EXCDESC2='UPTIME(HH:MM:SS)= '
        || PUT(CSYUPTM,TIME.) ||
        ', AVG USERS=' || PUT(CSYAVUSR,3.) ||
        ', SUS=' || PUT(CSYSERVU,8.);
LINK HIT;
END;

THRESHOLD MODIFICATION:  Modify the value used for service
units according to the following convention:

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

          CSYSERVU > 12000000