TSO Command Summary Report


The TSO Command Summary Report graphically summarizes TSO command usage.

The frequency and average response time of each command are listed and plotted individually in this report.

The data is obtained from type 240-20 user records, which are generated by the Extractor TSODATA control statement. The TSO Command Summary Report is produced by using the Analyzer TSOPERF control statement.

A sample of the TSO Command Summary Report is shown in the following figure. In the TSODATA Extractor control statement at the CMDS parameter, either proper command names or TSO aliases (command short form) can be defined for sampling. For example, you can list either EDIT or E for the EDIT command.

The number of commands reported on is controlled by the LIMIT parameter of the TSOPERF control statement. When the number of commands is limited, the commands displayed are those most frequently used during the measurement interval. When the number of commands is not limited, all commands sampled are listed.

When a TSO user enters a command for which a response is never received, the Extractor stops response timing at five minutes. In this way, infinite response times are not collected.

TSO commands executed under SPF do not issue SYSEVENT ZERO; therefore, these commands are not timed under SPF. However, the EDIT and TEST subcommands under EDIT and TEST modes are counted and monitored. If FSE is being used and the subcommands are stacked, FSE replaces the last character of the subcommand with the character Z.

When executing programs in foreground, response times tend to be high. For this reason, use a value between 5 and 15 for the scale on this report so that the graphed data is more meaningful.

The following figure is an example of the TSO Command Summary Report.

PRODUCED BY CMF ANALYZER (v.r.mm  RSL yymm )                     TSO COMMAND SUMMARY REPORT                       RPTSEQ     9 PAGE     12
BMC SOFTWARE, INC.                                            XYZ COMPANY                              REPORT DATE: DD MMM YY 11.55
 ACTL 10 JUN YY 09.00.00  10 JUN YY 16.00.00             WORLDWIDE HEADQUARTERS                         SYSTEM ID: SJSE     Z v.rr.n


 BASED ON REC TYPE/# RECS/# SAMPLES/REC HOURS:  240-1/30/5,393/7.5  240-20/12/2,171/3
                                                      C O M M A N D  S U M M A R Y
           TSO          COMMAND        RESPONSE         0             USAGE          2,054      0.0          RESPONSE         11.22
         COMMAND         USAGE           TIME           +--+--+--+--+--+--+--+--+--+--+--+       +--+--+--+--+--+--+--+--+--+--+--+
         ALLOCATE       2,054            0.78           .*********************************       .*I                              .
         ATTRIB           100            0.12           .**                              .       . I                              .
         CONSOLE            3            0.23           .                                .       .*I                              .
         DEFINE             1           11.22           .                                .       .*I*******************************
         DSN               23            4.01           .                                .       .*I**********                    .
         DYNASTEP           1            0.11           .                                .       . I                              .
         END               13            4.18           .                                .       .*I**********                    .
         EXEC             385            0.49           .******                          .       .*I                              .
         EXECUTIL          11            0.12           .                                .       . I                              .
         FREE             337            0.11           .*****                           .       . I                              .
         IKJEFF76          64            0.31           .*                               .       .*I                              .
         IPCS               1            5.15           .                                .       .*I*************                 .
         ISPEXEC            1            0.20           .                                .       .*I                              .
         ISPF               8            0.70           .                                .       .*I                              .
         LISTALC            5            0.88           .                                .       .*I*                             .
         LOCATE             1            0.20           .                                .       .*I                              .
         PDF               73            2.12           .*                               .       .*I****                          .
         PMGLAUTH          12            1.80           .                                .       .*I***                           .
         PROFILE          172            0.10           .***                             .       . I                              .
         SYSPROG            1            0.44           .                                .       .*I                              .
         TAOINQ             1            0.52           .                                .       .*I                              .
         TEST              20 (1,862)    0.70           .                                .       .*I                              .
         TESTXA             2            0.08           .                                .       . I                              .
                                                        +--+--+--+--+--+--+--+--+--+--+--+       +--+--+--+--+--+--+--+--+--+--+--+
         TOTAL/AVG      3,289            0.68           0             USAGE          2,054      0.0          RESPONSE         11.22

TSO Command Summary Report field descriptions

The table below describes each field in the TSO Command Summary Report.

Field

Description

TSO COMMAND

all major TSO commands issued, or commands most frequently used during the measurement interval

COMMAND USAGE

total number of times command was used; for EDIT and TEST, the number of times a subcommand was issued is shown in parentheses

RESPONSE TIME

average command response time; defined internally as SYSEVENT ZERO (enter) to TPUT (screen); line speed and other external activities are not included; reported in seconds per command

USAGE

usage count for each command plotted on a self-scaling bar graph

RESPONSE

response time for each command plotted on a bar graph; the graph scales to the value specified, to the highest value encountered (if SCALE=999 is specified), or to the default of the TSOPERF statement

TOTAL/AVG

total count of all commands reported; average response time for all commands is reported


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*