4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 03006: Job Data Set Enqueue Time Exceeded Limit

03006: Job Data Set Enqueue Time Exceeded Limit

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

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

PURPOSE:  Identifies jobs waiting a long time in initiation
due to a data set enqueue.

RATIONALE:  The amount of time that a job waits in data set
enqueue may be key to the analysis of poor job turnaround.  A
data set enqueue occurs as a result of a job attempting to
allocate a data set already allocated to another job.  As a
result, an initiator and associated resources are tied up
until the condition is cleared by the job being cancelled or
the data set being freed.

DEFINITION:    This exception is detected when a batch job's
data set enqueue time exceeds the installation-defined time
limit for a specified job group.

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.

*
**  03006
**  JOB DATA SET ENQUEUE TIME EXCEEDED LIMIT
*;
IF (JOBGROUP=jobgroup AND JOBENQTM > data-set-enqueue-time)
OR (JOBGROUP=jobgroup AND JOBENQTM > data-set-enqueue-time)
OR (JOBGROUP=jobgroup AND JOBENQTM > data-set-enqueue-time)
 THEN DO;
  EXCCODE='03006'; SEVERITY='I'; MGMTAREA='PERFORMANCE';
  EXCDESC1=
  'JOB DATA SET ENQUEUE TIME EXCEEDED LIMIT';
  EXCDESC2='JOBGROUP=' || PUT(JOBGROUP,3.)
           || ' DATA SET ENQUEUE TIME(H:M:S)='
           || PUT(JOBENQTM,TIME.);
  LINK HIT;
END;

THRESHOLD MODIFICATION:  Modify the values used for jobgroup
and data-set-enqueue-time as follows:

    jobgroup - The numeric value identifying the selected job
       category.  Group 3 appears as:

          JOBGROUP=3

    data-set-enqueue-time - The amount of data set enqueue
       time, described as hours, minutes, and seconds.  A
       threshold of 30 minutes appears as:

          JOBENQTM > HMS(00,30,00)