4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 02004: Long Wait Swap Rate Exceeds Max

02004: Long Wait Swap Rate Exceeds Max

FILE: Paging Activity File
SAS FILE NAME: DAYS.SCPPAG01
SOURCE LOCATION: prefix.MICS.USER.SOURCE(DYRMFEXC)

SEVERITY: Warning              (SEVERITY='W')
MANAGEMENT AREA: Performance   (MGMTAREA='PERFORMANCE')

PURPOSE:  A high long wait swap rate can identify poorly
written software.

RATIONALE:  Normally, a long wait swap is a good event, since
it is issued intentionally by software that expects a
significant wait for a response (often from a console
operator or some form of human involvement).  Excessive use
of long wait could result from software that should be
examined to see if the response (and hence if the long wait)
is truly required.

DEFINITION:  This exception is detected when the long wait
swap rate exceeds the 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:

**  02004 LONG WAIT SWAP RATE EXCEEDS MAX
*;
RATE=PAGLWS / DURATION;
IF RATE GT rate
 THEN DO;
  EXCCODE='02004'; SEVERITY='W'; MGMTAREA='PERFORMANCE';
  EXCDESC1='LONG WAIT SWAP RATE EXCEEDS MAX';
  EXCDESC2='SWAP RATE=' !! PUT(RATE,5.1) !! '/SEC';
  LINK HIT;
END;

THRESHOLD MODIFICATION:  The user should modify the rate
value according to the following convention:

rate - The maximum rate of long wait swaps per second is
specified.  A rate of 2 threshold would appear as:

RATE GT 2