4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 06028: PI Current Use Exceeds Standard

06028: PI Current Use Exceeds Standard

    FILE:            IMS System Activity
    SAS FILE NAME:   DETAIL.IMSISY01
    SOURCE LOCATION: sharedprefix.MICS.SOURCE(DYIMSEXC)

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

    PURPOSE:  Identifies that the PI pool may require
enlarging.

    RATIONALE:  Insufficient storage for this pool, which is
used to hold the program isolation enque table, will result
in IMS abending with a user 775.  Thus, there should always
be a margin of safety in allocating this pool.  The number
represented here is the percent of the total pool that the
current utilization represents.  Excessively high usage in
this pool is an indication that sync points are not being
reached frequently enough by application programs.  The size
of the pool required is directly proportional to the number
of PSTs.

    DEFINITION:  This exception is detected when the PI
current use percentage exceeds the installation-defined
limit.

    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:

*
**  06028
**  PI CURRENT USE MARK EXCEEDS STANDARD
*;
IF ((ISYPIUSE/ISYPIMAX) * 100) > current-use-percentage
 THEN DO;
  X = ((ISYPIUSE / ISYPIMAX) * 100);
  EXCCODE='06028'; SEVERITY='C'; MGMTAREA='PERFORMANCE';
  EXCDESC1=
  'PI POOL CURRENT USE EXCEEDS STANDARD';
  EXCDESC2='PI POOL USE ='
           || PUT(X,7.2) || '% OF AVAILABLE POOL ';
  LINK HIT;
END;

    THRESHOLD MODIFICATION:  Modify the PI pool
current-use-percentage to a value between 0 and 100.