5. FILES › 5.2 TSO Information Area Files › 5.2.2 TSO User Activity File (TSOTSU) › 5.2.2.3 Usage Considerations

5.2.2.3 Usage Considerations

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

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

Before using the TSO batch files for accounting or capacity
planning, carefully consider these impacts:

o Data duplication can occur because resource utilization
  information for batch TSO jobs appears in both the CA MICS
  TSO Analyzer batch files and the Batch Information Area
  files of the CA MICS MVS Batch and Operations Analyzer.

  Please contact CA MICS Product Support before using the TSO
  batch files for these purposes.

o Accounting Considerations

  If both the TSO batch files and the MVS Batch and
  Operations Analyzer files are used for accounting, the
  redundant resource utilization data will result in
  duplicate accounting charges unless you account for
  different resource items from each information area.

  For example, if you account for command count from the TSO
  batch files and CPU time from the MVS Batch and Operations
  Analyzer files, you will not incur duplicate charges.

  If you charge for the same resource item (such as CPU time)
  in both information areas, you end up with duplicate
  charges to the same user.

o Capacity Planning Considerations

  If both the TSO Analyzer's batch files and the MVS Batch
  and Operations Analyzer's Batch Information Area files are
  used for capacity planning purposes, the duplication of
  resource data can skew workload utilization information.

  Consequently, do not use the TSO Analyzer's batch files for
  capacity planning purposes.

  Please note that this recommendation applies only to the
  batch files of the CA MICS TSO Analyzer and not to the
  online-oriented files.


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 TSOTSUnn file in the DETAIL time-span.
    They lose significance once summarization has been
    performed.  These data elements should only be
    referenced when using the TSOTSUnn file in the DETAIL
    time-span.

    PERFGRP  - Performance Group Number
    ASID     - Address Space Identification
    LOGTS    - LOGON Time-stamp
    TSUSOPTS - Response Option Flags

3.  The data element TSUCOST (Processing Charges) obtains its
    value from code you write in the user exit _USRSTSU.

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.

    sharedprefix.MICS.PARMS(SYSID)
        CPUMODEL - CPU Model Identification
        TSUCPUNI - Instructions Executed
    TSO/MON Options
        TSMRVAL1:TSMRVAL8 - Response Distribution Limits
        TSMERESP - Excessive Response Time Threshold

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 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 short response by hour for
    user CPM0001:

    DATA;
    SET &PTSOD..TSOTSU01;
    IF USER='CPM0001';
    PROC PRINT; VAR SYSID HOUR TSOAVSTM;

2.  Print the average total response time by zone for the
    departments CPM, REG, and OIL, over the last six
    months:

    DATA;
    SET &PTSOM..TSOTSU01 &PTSOM..TSOTSU02
        &PTSOM..TSOTSU03 &PTSOM..TSOTSU04
        &PTSOM..TSOTSU05 &PTSOM..TSOTSU06;
    IF USER=:'CPM' OR USER=:'REG' OR USER=:'OIL';
    USER=SUBSTR(USER,1,3);
    LENGTH KEYID $7.;
    KEYID=PUT(YEAR,2.) '/' PUT(MONTH,2.) '-'
          ZONE;
    PROC FREQ; TABLES KEYID*USER / WEIGHT TSUAVTTM;

3.  Total the service units used by department REG for
    last month by system (SYSID):

    %LET BY = SYSID YEAR MONTH;
    %LET BREAK = MONTH;
    DATA FILE1;
    SET &PTSOM..TSOTSU01;
    IF USER=:'REG';
    DATA FILE1;
    SET FILE1;
    %TSUSUM;
    PROC PRINT; VAR SYSID YEAR MONTH USER TSUSERVU;

4.  Total the service units used by department REG for
    last month on all systems:

    %LET BY = YEAR MONTH;
    %LET BREAK = MONTH;
    DATA FILE1;
    SET &PTSOM..TSOTSU01;
    IF USER=:'REG';
    PROC SORT DATA=FILE1; BY &BY;
    DATA FILE1;
    SET FILE1;
    %TSUSUM;
    PROC PRINT; VAR YEAR MONTH USER TSUSERVU;