5. FILES › 5.2 TSO Information Area Files › 5.2.4 TSO User Interactive Usage File (TSOTSI) › 5.2.4.3 Usage Considerations

5.2.4.3 Usage Considerations

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

Special Considerations/Techniques
---------------------------------

1.  To populate account code data elements (TSOACTn),
    a. code the TSOACCT and TSOACRT parameters as described
       in sections 7.2.1 and 7.2.2 of this guide.
    b. change the COMP statement in TSOGENIN as described in
       section 7.2.3 of this guide.

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

    ASID     - Address Space Identification
    LOGTS    - LOGON Time-Stamp
    PERFGRP  - Performance Group Number
    TSISOPTS - Response Options

3.  The following data elements obtain their values from code
    you write in the user exit _USRSTSI:

    CLUSTER  - Workload Classification Number
    TSICOST  - Processing Charges

4.  The following data elements are user-defined or option
    dependent.  They should be used within the frame of
    reference of the option's definition.

    TSO/MON Options
        TSMRVAL1:TSMRVAL8 - Response Distribution Limits
        TSIBUF   - Command Buffer Area *
        TSIBUFL  - Command Buffer Area Content Length *
        TSIRCTYP - Command Activity Record Type *
        TSMERESP - Excessive Response Time Threshold

         * TSO/MON Commands Table command recording
           option dependent.

5.  To activate the VTAM/TCAM data elements, change the NAME
    statements in TSOGENIN from:

       NAME DEVTYPE      99  N N N N N .
       NAME TERMID       99  N N N N N .
       NAME LINETYPE     99  N N N N N .

    to:

       NAME DEVTYPE      99  0 N N N N .
       NAME TERMID       99  0 N N N N .
       NAME LINETYPE     99  0 N N N N .

6.  STARTTS and ENDTS in the MONTHS time-span bounds 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.

    In the DETAIL time-span, STARTTS represents TSO/MON
    recording interval start time and ENDTS represents
    TSO/MON recording interval end time.

7.  The data element COMPRIM identifies the type of the
    command (primary, TSO EDIT subcommand, etc.) based on
    the order in which the TSO/MON Commands Table has been
    defined.

8.  The data element COMMAND contains a value of '*UNKNOWN'
    if the command's abbreviation, COMABB, did not have a
    corresponding match in the TSO/MON Commands Table.

Retrieval Examples
------------------


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.

1.  Print the users who executed STARTREK yesterday:

    DATA;
    SET &PTSOX..TSOTSI01;
    IF PROGRAM='STARTREK';
    PROC PRINT; VAR SYSID USER STARTTS ENDTS TSISERVU;

2.  Display what programs user COM001 used for the last
    two months:

    DATA FILE1;
    SET &PTSOM..TSOTSI01 &PTSOM..TSOTSI02;
    IF USER='COM001';
    PROC SORT DATA=FILE1; BY PROGRAM;
    PROC FREQ; TABLES PROGRAM;