4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 03051: Program Swapping Rate Exceeds Limit

03051: Program Swapping Rate Exceeds Limit

FILE:             Batch User Program Activity
SAS FILE NAME:    DETAIL.BATPGM01
SOURCE LOCATION:  prefix.MICS.USER.SOURCE(DYSMFEXC)

SEVERITY:  Warning              (SEVERITY='I')
MANAGEMENT AREA:  Workload      (MGMTAREA='WORKLOAD')

PURPOSE:  Identifies programs which incurred a high level of
swapping activity.

RATIONALE:  Programs experiencing a high degree of swapping
indicate a period of excessive system load.  You should
examine the time period in which the excessive swapping
occurs to find ways of lowering the multiprogramming level.

DEFINITION:    This exception is detected when the program
swapping rate exceeds the installation-defined value.

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.

*
** 03051
** PROGRAM SWAPPING RATE EXCEEDS LIMIT
*;
RATE=0;
IF PGMEXCTM > 0 THEN RATE=PGMSWAPS/PGMEXCTM;
IF RATE > swapping-rate-per-second
          AND PGMEXCTM > execution-time
          AND PGMSWAPS > total-swaps
 THEN DO;
  MGMTAREA='WORKLOAD'; EXCCODE='03051'; SEVERITY='W';
  EXCDESC1='PROGRAM SWAP RATE EXCEEDS LIMIT';
  EXCDESC2='SWAP RATE/SEC=' || PUT(RATE,5.)
           || ' TOTAL SWAPS=' || PUT(PGMSWAPS,6.)
           || ' ELAPSED TIME=' || PUT(PGMEXCTM,TIME.);
  LINK HIT;
END;

THRESHOLD MODIFICATION:  Modify the values used for
swapping-rate-per-sec, execution-time, and total-swaps as
follows:

    swapping-rate-per-sec  -  The number of swaps per second.
       A threshold of 10 per second appears as:

          RATE > 10

    execution-time - The total execution time.  A threshold
       of 5 minutes appears as:

          PGMEXCTM > HMS(00,05,00)

    total-swaps  -  The total number of swaps A threshold of
       1000 appears as:

          PGMSWAPS > 1000