4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 00103: Interval TSO System Resource Overload

00103: Interval TSO System Resource Overload

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

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

PURPOSE      Identifies the intervals when the TSO workload
             is so large that service may be impacted.

RATIONALE    Poor performance results when the TSO workload
             exceeds the configuration limit.  It is possible
             for one or a few TSO users to cause degraded
             response for all users by consuming large
             amounts of CPU time or by doing large numbers of
             I/Os.  At times, this may result from a program
             or CLIST that is in an infinite loop.

             It may be necessary to:

               A) Review the heaviest users' work for
                  efficiency improvements.

               B) Have some users run at a lower priority.

               C) Submit some of the TSO work to batch.

DEFINITION   This exception is detected when the interval TSO
             CPU time, I/O, or service units exceed the
             installation defined limits.

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:

************************************************************;
*
** 00103
** INTERVAL TSO SYSTEM RESOURCE OVERLOAD
*;
IF TSOCPUTM > cpu-time
 OR TSOEXCPS > i/o
 OR TSOSERVU > service-units
 THEN DO;
  EXCCODE='00103'; SEVERITY='I'; MGMTAREA='PERFORMANCE';
  EXCDESC1='INTERVAL TSO SYSTEM RESOURCE OVERLOAD';
  EXCDESC2='CPU TIME(HH:MM:SS)= '
           || PUT(TSOCPUTM,TIME.) ||
           ', EXCPS=' || PUT(TSOEXCPS,6.) ||
           ', SU=' || PUT(TSOSERVU,7.);
  LINK HIT;
END;

THRESHOLD     Modify the values used for CPU time, I/O, and
MODIFICATION  service units, according to the following
              conventions:

    cpu-time       The amount of CPU time is described as
                   hours, minutes, and seconds.  A threshold
                   of 2 minutes and 30 seconds would appear
                   as:

                      TSOCPUTM > HMS(0,2,30)

    i/o            The number of EXCPs is specified.  A
                   threshold of 15000 EXCPs would appear as:

                      TSOEXCPS > 15000

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

                      TSOSERVU > 1000000