4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 01602: PR/SM LPAR Using Excessive Resources

01602: PR/SM LPAR Using Excessive Resources

FILE: PR/SM LPAR Config/Activity File
SAS FILE NAME: DAYS.HARLPC01
SOURCE LOCATION: prefix.MICS.USER.SOURCE(DYRMFEXC)

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

PURPOSE:  Detects a logical partition that uses an excessive
portion of the shared processor resources of the central
processor complex (CPC).

RATIONALE:  A single logical partition that dominates the
shared processor resources of the central processor complex
(CPC) may indicate a resource shortage that can result in
service objectives of other logical partitions to be missed.
Detection of excessive logical partition resource utilization
may identify a capacity constraint in the CPC, requiring
further investigation of the critical resources.

For additional information concerning interpretation and
usage of these values, refer to Section 6.8 of this guide.

DEFINITION:  This exception is detected when the logical
partition shared system utilization percentage is above the
site-defined maximum.

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.
******************************************************;
*** 01602 *** PR/SM LPAR USING EXCESSIVE RESOURCES ***;
******************************************************;
IF (SYSID EQ 'rsys')
 THEN IF ((HEXLPID EQ 'id1' AND LPCPCSSU GT percent1) OR
          (HEXLPID EQ 'id2' AND LPCPCSSU GT percent2) OR
          (HEXLPID EQ 'id3' AND LPCPCSSU GT percent3))
  THEN IF ((HOUR GE hh1 AND HOUR LE hh2) AND
           (DAYNAME NE 'SAT' AND DAYNAME NE 'SUN'))
   THEN DO;
     EXCCODE='01602'; SEVERITY='C'; MGMTAREA='PERFORMANCE';
     EXCDESC1='PR/SM LPAR USING EXCESSIVE RESOURCES.  ID='
              !! HEXLPID;
     EXCDESC2='LPAR ID=' !! HEXLPID !! ' WAS USING' !!
               PUT(LPCPCSSU,5.1) !! '% OF COMPLEX RESOURCES';
     LINK HIT;
   END;

THRESHOLD MODIFICATION:  Modify the recording SYSID, the LPAR
IDs, the percent values, and prime time according to the
following conventions:

rsys - The SYSID of the system whose measurements are to be
used to evaluate the exception condition.  If the evaluation
is to be made based on the information recorded by RMF
running in a system ID of SYS1, the statement would appear
as:

IF (SYSID EQ 'SYS1')

id - Specifies the logical partition ID, a two-character
hexadecimal number, with lead zero if applicable, in quotes.

percent - Specifies the maximum shared system utilization for
a particular LPAR.

A 30 percent threshold for LPAR ID 1, a 40 percent threshold
for LPAR ID 2, and a 50 percent threshold for LPAR ID C
appear as:

IF ((HEXLPID EQ '01' AND LPCPCSSU GT 30) OR
    (HEXLPID EQ '02' AND LPCPCSSU GT 40) OR
    (HEXLPID EQ '0C' AND LPCPCSSU GT 50))
prime time - Specifies the hour range and days of the week to
be included in the exception.  The hour of the day must be
within the hh1 through hh2 range.  The days of the week are
represented by the first three characters of their names.
Prime time specified as 8:00 am through 6:59 pm (18:59) on
weekdays only appears as:

IF ((HOUR GE 8 AND HOUR LE 18) AND
    (DAYNAME NE 'SAT' AND DAYNAME NE 'SUN'))

The time period to be included may already be defined by
means of the ZONE definition, which provides a simpler method
of selecting hours and days for processing.  If ZONE 1
corresponds to the desired time period, it appears as:

IF ZONE EQ '1'