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.
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 |
Related topics