5. FILES › 5.2 TSO Information Area Files › 5.2.5 TSO Terminal Activity File (TSO_TA) › 5.2.5.3 Usage Considerations

5.2.5.3 Usage Considerations

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

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

1.  The TSO_TA file is derived from the TSOTSU file, so it
    has many of the same data element names, labels, and
    formats.

2.  To activate the TSO_TA file, refer to data base file
    tailoring discussion in Chapter 6 of the CA MICS System
    Modification Guide.

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

    sharedprefix.MICS.PARMS(SYSID)
        CPUMODEL - CPU Model Identification

    TSO/MON Options
        TSMRVAL1:TSMRVAL8 - Response Distribution Limits
        TSMERESP - Excessive Response Time Threshold

4.  STARTTS and ENDTS in the DAYS, 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.

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

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 yesterday's average TSO session time by hour
    for terminal PULU001:

    DATA;
    SET &PTSOD..TSO_TA01;
    IF TERMID='PULU001';
    PROC PRINT; VAR SYSID HOUR TSUAVCTM;

2.  Print the average TSO session time by zone for the
    terminal id's beginning with CP, RE, and OI, over
    the last six months:

    DATA;
    SET &PTSOM..TSO_TA01 &PTSOM..TSO_TA02
        &PTSOM..TSO_TA03 &PTSOM..TSO_TA04
        &PTSOM..TSO_TA05 &PTSOM..TSO_TA06;
    IF TERMID=:'CP' OR TERMID=:'RE' OR TERMID=:'OI';
    TERMID=SUBSTR(TERMID,1,2);
    LENGTH KEYID $7.;
    KEYID=PUT(YEAR,2.) '/' PUT(MONTH,2.) '-'
          ZONE;
    PROC FREQ; TABLES KEYID*TERMID / WEIGHT TSUAVCTM;