4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 00202: Prime-Time TSO System Resource Objective Missed

00202: Prime-Time TSO System Resource Objective Missed

FILE              TSO System Activity File
SAS FILE NAME     DAYS.TSOTSO01
SOURCE LOCATION   sharedprefix.MICS.SOURCE(DYTSOEXC)

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

PURPOSE      Identifies the prime-time TSO hours when less
             than the installation defined service units were
             consumed.

RATIONALE    An installation can set a resource consumption
             for prime time.  If for any reason this level of
             usage is not delivered, the cause should be
             identified.  Some of the causes may be:  shared
             DASD reserves, long ENQUEUE on critical
             resources, lost interrupts on I/O devices, CPU
             stopped by operator, etc.

             You can further research this problem by
             scanning the MVS Performance Group and Period
             (SCPPGA and SCPPPA) files in the data base to
             determine if the TSO objective was missed
             because other higher priority work prevented TSO
             from using system resources.

             If installation management's objective is to
             increase TSO resource availability, the IPS may
             need revision to do one or more of the
             following:

               A) Raise the service objectives for TSO work.

               B) Raise the number of concurrent TSO users by
                  domain controls.

               C) Provide higher dispatching priorities for
                  TSO.

               D) Use time slice groups (MVS/SE only) to
                  improve the total service provided to TSO
                  relative to other work categories.

DEFINITION   This exception is detected when all users
             service units consumed falls below the
             installation objective.

EXCEPTION    The SAS statements identifying the exception
STATEMENTS   situation and describing the condition are
             stored in the source member named in SOURCE
             LOCATION and are described below:

************************************************************;
*
**  00202
**  PRIME-TIME TSO SYSTEM RESOURCE OBJECTIVE MISSED
*;
IF TSOUPTM > uptime
 AND TSOSERVU < service-units
 AND (hh1<=HOUR AND HOUR<=hh2)
 AND (  DAYNAME='MON' OR DAYNAME='TUE' OR DAYNAME='WED'
     OR DAYNAME='THU' OR DAYNAME='FRI' )
 THEN DO;
  EXCCODE='00202'; SEVERITY='I'; MGMTAREA='PERFORMANCE';
  EXCDESC1='PRIME-TIME TSO SYSTEM RESOURCE OBJECTIVE MISSED';
  EXCDESC2='UPTIME(HH:MM:SS)= '
           || PUT(TSOUPTM,TIME.) ||
           ', AVG USERS=' || PUT(TSOAVUSR,3.) ||
           ', SUS=' || PUT(TSOSERVU,7.);
  LINK HIT;
END;

THRESHOLD     Modify the value of uptime, service units, and
MODIFICATION  prime time, according to the following
              conventions:

    uptime         The minimum amount of time during the hour
                   that TSO was available is specified.  This
                   check is made so that exceptions are not
                   produced when TSO was not available.  A
                   threshold of 57 minutes of uptime would
                   appear as:

                      TSOUPTM > HMS(0,50,00)

    service-units  The number of service units is specified.
                   A threshold of 3000000 service units would
                   appear as:

                      TSOSERVU < 3000000

    prime time     The hour range and days of the week to be
                   included in the exception are specified.
                   The hour of the day must be within the hh1
                   through hh2 range.  Prime time specified
                   as 8 a.m. through 6:59 p.m. (18:59) would
                   appear as:

                      AND ( 8 <=HOUR AND HOUR<= 18 )

                   The days of the week are represented by
                   the first three characters of their names.
                   They must be enclosed in quotes and
                   separated with ORs.  Prime time specified
                   as MONDAY through FRIDAY would appear as:

         AND (DAYNAME='MON' OR DAYNAME='TUE' OR DAYNAME='WED'
         OR DAYNAME='THU' OR DAYNAME='FRI' )