4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 02802: Multiprogramming Level Exceeds Max

02802: Multiprogramming Level Exceeds Max

    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 exceeds standards.

    RATIONALE:  The setting of maximum and minimum MPLs is a
primary means of controlling system activity in order to meet
service objectives.  An MPL in excess of the expected maximum
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 exceeds 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:

  /* ********************************************
  **  02802 MULTIPROGRAMMING LEVEL EXCEEDS MAX **
  ******************************************** */
IF (PERFGRP=perfgrp1 AND PGAMPL > count1) OR
   (PERFGRP=perfgrp2 AND PGAMPL > count2)
 THEN DO;
  EXCCODE='02802'; SEVERITY='I'; MGMTAREA='PERFORMANCE';
  EXCDESC1='MULTIPROGRAMMING LEVEL EXCEEDS MAX';
  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 to be examined.

    count - The maximum MPL for the performance group.

    A test for an MPL greater than 15 for performance group 1
would appear as:

    (PERFGRP=1 AND PGAMPL > 15)