4. EXCEPTIONS › 4.3 Detailed Exception Descriptions › 00102: Warning TSO TIOC Buffer Level Detected

00102: Warning TSO TIOC Buffer Level Detected

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

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

PURPOSE      Identifies intervals during which TSO approached
             a buffer shortage.

RATIONALE    When the number of Terminal Input / Output
             Coordinator (TIOC) buffers falls below the
             Reserve Buffer (RESVBUF) value specified in
             SYS1.PARMLIB(IKJPRM00), all terminals are locked
             for input.  This is done to ensure a reserve of
             free buffers for output.  No external warning is
             given for this condition except that TSO users
             may experience long response times.  For a
             discussion of the meaning and use of the TIOC
             parameters, see OS/VS2 MVS SYSTEM PROGRAMMING
             LIBRARY:  INSTALLATION AND TUNING GUIDE, GC28-
             0681, Part 3:  System Initialization, Member
             Name:  IKJPRM00.

DEFINITION   This exception is detected when the number of
             TIOC buffers falls within the range that
             approaches the critical limit when terminal
             input lockup will occur.

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:

************************************************************;
*
** 00102
** WARNING TSO TIOC BUFFER LEVEL DETECTED
*;
IF TSOUPTM > 0
 AND (tioc-buffers1 <=TSOMTIOC AND TSOMTIOC<= tioc-buffers2)
 THEN DO;
  EXCCODE='00102'; SEVERITY='W'; MGMTAREA='PERFORMANCE';
  EXCDESC1='WARNING TSO TIOC BUFFER LEVEL DETECTED';
  EXCDESC2='MINIMUM TIOC BUFFERS=' || PUT(TSOMTIOC,4.);
  LINK HIT;
END;

THRESHOLD     Modify the value for the TIOC buffer range that
MODIFICATION  approaches the critical RESVBUF value,
              according to the following conventions:

    tioc-buffers  The number of buffers or less which will
                  cause performance degradation.  A RESVBUF
                  of 50 with a warning range of 51 through
                  100 would appear as:

                     ( 51 <=TSOMTIOC AND TSOMTIOC<= 100)

                  NOTE:  The TIOC buffer range for this
                  exception should be coordinated with
                  exception number 00101, which is the
                  critical level exception.