4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 02011: Enqueue Swap Rate Exceeds Max

02011: Enqueue Swap Rate Exceeds Max

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

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

PURPOSE:  Enqueue swapping results from enqueue conflicts
that should be eliminated whenever possible.

RATIONALE:  An enqueue swap occurs when an enqueue conflict
has been raised for a resource and the task owning the needed
resource is currently swapped out.  The System Resource
Manager (SRM) swaps in the owning task and keeps the owning
task in for an amount of service set by the ERV parameter.
In order to make room for the owning task, another task is
selected to be swapped out.  Thus, this exception reports
that a conflict for resources is occurring.  Exception 2600
can identify the resource involved and elimination can
possibly be addressed there.  It is possible that a low ERV
value can cause excessive (and unnecessary) enqueue swapping.

DEFINITION:  This exception is detected when the enqueue 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:

**  02011 ENQUEUE SWAP RATE EXCEEDS MAX
*;
RATE=PAGEES / DURATION;
IF RATE GT rate
 THEN DO;
  EXCCODE='02011';SEVERITY='I';MGMTAREA='PERFORMANCE';
  EXCDESC1='ENQUEUE 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 enqueue swaps per second is
specified.  A rate threshold of 1 would appear as:

RATE GT 1