4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 02803: Multiprogramming Level Less than Min

02803: Multiprogramming Level Less than Min

    FILE: Performance Group Activity File
    SAS FILE NAME: DAYS.SCPPGA01
    SOURCE LOCATION: prefix.MICS.USER.SOURCE(DYRMFEXC)

    SEVERITY: Impacting            (SEVERITY='I')
    MANAGEMENT AREA: Performance   (MGMTAREA='PERFORMANCE')

    PURPOSE:  Identify situations where the multiprogramming
level (MPL) for a workload is less than expected.

    RATIONALE:  The setting of maximum and minimum MPLs is a
primary means of controlling system activity in order to meet
service objectives.  An MPL below the anticipated minimum can
mean that the wrong SYS1.PARMLIB member is being used to set
system resource management values, or that an operator
command has been issued at the system console to override the
values normally used.

    DEFINITION:  This exception is detected when the MPL for
selected performance groups is less than an
installation-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:

  /* **********************************************
  **  02803 MULTIPROGRAMMING LEVEL LESS THAN MIN **
  ********************************************** */
IF PGAMPL ^=.  THEN
IF (PERFGRP=perfgrp1 AND PGAMPL < count1) OR
   (PERFGRP=perfgrp2 AND PGAMPL < count2)
 THEN DO;
  EXCCODE='02803'; SEVERITY='I'; MGMTAREA='PERFORMANCE';
  EXCDESC1='MULTIPROGRAMMING LEVEL LESS THAN MIN';
  EXCDESC2='MPL=' || PUT(PGAMPL,5.1) ||
       ', GROUP=' || PUT(PERFGRP,3.) ||
        ', NAME=' || PERFGRPN;
  LINK HIT;
END;

    THRESHOLD MODIFICATION:  The user should modify the
perfgrp and count values according to the following
conventions:

    perfgrp - The performance group number to be examined.

    count - The minimum MPL for the performance group

    A test for an MPL less than 7 for performance group 112
would appear as:

    (PERFGRP=112 AND PGAMPL < 7)