5. FILES › 5.2 TSO Information Area Files › 5.2.1 TSO System Activity File (TSOTSO) › 5.2.1.3 Usage Considerations

5.2.1.3 Usage Considerations

This section identifies any special considerations or
techniques related to using the TSOTSO file.  Additionally,
retrieval examples are provided to help you use this file.


In the examples, a SAS macro variable is used to specify the
DDname part of the CA MICS file name. These macro variables
are a standard part of CA MICS and are available for all
files. The macro variable name has the form &diiit, where d
is the database identifier, iii is the information area
name, and t is the timespan.  For the examples, a database
identifier of P is used.  The identifier is installation
dependent, so you should find out what the identifiers are at
your installation.

    Special Considerations/Techniques

    1.  The following data elements only have meaning when
        using the TSOTSOnn file in the DETAIL time-span.
        They lose significance once summarization has been
        performed.  These data elements should only be
        referenced when using the TSOTSOnn file in the DETAIL
        time-span.

        TSOSOPTS - TSO/MON Options Flag1
        TSOSOPT2 - TSO/MON Options Flag2
        TSOIPSS  - IPS Suffix When SU Algorithm in Use
        TSOIFLAG - IPS Flag Field
        TSOIPG1 :  TSOIPG10 - Performance Group Numbers
        TSOISS1 :  TSOISS10 - Short Service Thresholds
        TSOISM1 :  TSOISM10 - Medium Service Thresholds
        TSOIPF1 :  TSOIPF10 - Performance Group Flags

    2.  The following data elements are allowed for in this
        record but are reserved at this time.

        TSOPETTM - Pseudo Elapsed Time
        TSOSRU   - System Resource Units
        TSOCOST  - Processing Charges

    3.  The following data elements are user-defined option
        dependent, and should be used within the frame of
        reference of the option's definition.

        CA MICS PARMS SYSID
            CPUMODEL - CPU Model Identification
            TSOCPUNI - Instructions Executed
        TSO/MON Options
            TSMRVAL1:TSMRVAL8 - Response Distribution Limits
            TSMERESP - Excessive Response Time Threshold

    4.  The ENDTS and STARTTS, when appearing in the
        DAYS, WEEKS, MONTHS, or YEARS time-spans, bound the
        span of time over which the data has been summarized.
        STARTTS is the lowest date and time, and ENDTS is the
        highest date and time for the data summarized.  The
        data elements STARTTS and ENDTS have different
        meanings when used in the DETAIL time-span versus
        their role in the DAYS, WEEKS, MONTHS, and YEARS
        time-spans.  Their purpose in the DETAIL time-span is
        described below:

          o  STARTTS represents TSO/MON recording interval
             start time.
          o  ENDTS represents TSO/MON recording interval end
             time.

    Retrieval Examples

    1.  Print yesterday's average short response by hour:

        DATA;
        SET &PTSOD..TSOTSO01;
        PROC PRINT; VAR SYSID HOUR TSOAVSTM;

    2.  Print the average total response time for zone 1 for
        the last six months:

        DATA;
        SET &PTSOM..TSOTSO01 &PTSOM..TSOTSO02
            &PTSOM..TSOTSO03 &PTSOM..TSOTSO04
            &PTSOM..TSOTSO05 &PTSOM..TSOTSO06;
        IF ZONE='1';
        PROC PRINT; VAR SYSID YEAR MONTH TSOAVTTM;

    3.  Retrieve the detail minimum TIOC buffer count and
        display for each TSO/MON recording interval for the
        hours of 8-10 a.m.  yesterday:

        DATA;
        SET &PTSOX..TSOTSO01;
        IF HOUR=8 OR HOUR=9;
        PROC PRINT; VAR SYSID ENDTS TSOMTIOC;