4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 04005: CICS Application Exceeds Avg Residency Time Limit

04005: CICS Application Exceeds Avg Residency Time Limit

FILE:             CICS Application Unit Activity File
SAS FILE NAME:    DAYS.CICCAU01
SOURCE LOCATION:  prefix.MICS.USER.SOURCE(DYCICEXC)

SEVERITY:  Warning              (SEVERITY='W')
MANAGEMENT AREA:  Service       (MGMTAREA='SERVICE')

PURPOSE:  Identifies those CICS applications whose average
residency time totalled more than the installation-defined
residency time objective.

RATIONALE:  An installation can set a service objective for
application residency time.  Setting the service objective
this way recognizes the importance of servicing a large
number of individual requests, while identifying CICS
applications that reserve valuable resources for extended
periods.

DEFINITION:  This exception is detected when an individual
application's average residency time exceeds the
installation's residency time objective.

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.

************************************************************;
*
**  04005
**  CICS APPLICATION EXCEEDS AVG RESIDENCY TIME LIMIT
*;
SECONDS=seconds;
IF CAUTRANS > 0 THEN AVG=CAURESTM/CAUTRANS; ELSE AVG=0;
IF AVG > SECONDS
THEN DO;
EXCCODE='04005'; SEVERITY='W'; MGMTAREA='SERVICE';
EXCDESC1=
'CICS APPLICATION EXCEEDS AVG RESIDENCY TIME LIMIT';
EXCDESC2= 'APPL=' || CICAPU ||
        ', AVG RESIDENCY TIME=' ||
        PUT(AVG,TIME.);
  LINK HIT;
END;

THRESHOLD MODIFICATION:  Modify the value of seconds to
define your installation's residency time objective according
to the following convention:

    seconds = The number of seconds for the service
       objective.  An objective of 60 seconds appears as:

          SECONDS = 60;