3. REPORTS › 3.1 Standard Analysis Reports › 3.1.1 TSO Summary Reports › 3.1.1.5 Running the TSO Summary Reports › 3.1.1.5.2 Report Options and Control Statements
3.1.1.5.2 Report Options and Control Statements
You specify report options through a summary statement that
resides in the data set specified via the SUMIN DD card
(generally, prefix.MICS.PARMS(TPSPARMS)). Syntax rules for
the summary statement are:
1. A summary statement is composed of keywords,
subkeywords, value parameters, and lists.
2. The input is free-form, using the SAS NAMED INPUT
rules. Blanks are delimiters while commas, quotes, and
parentheses are not.
3. Columns 1-72 are scanned for input, and columns 73-80
are ignored.
4. Keywords may not be abbreviated.
5. Comments may not appear in the summary statement input.
6. A summary statement can contain as many lines as
required; however, a keyword value or list must fit on
one line.
7. A continued line must end with a slash (/).
SUMMARY CONTROL STATEMENTS
The basic report statement is: SYSTEM=Y
Each execution of the TSO Summary Report program processes
one summary statement, which may produce a TSO System Summary
Report, a set of TSO User or Group Summary Reports, or a set
of TSO Application Summary Reports. This section defines the
report options and gives an example of their use.
The following list gives the keywords available with the
summary statement and their use.
KEYWORD DESCRIPTION
------------- ----------------------------------------
APPL Specifies that the TSO Application Summary
Reports are to be run.
BASE Specifies the month to use for computing
the percentage change values.
BREAK Specifies the length of the userid prefix
to be used in user/group summarization.
DROP Specifies report lines to be excluded.
LONG Specifies which long response distribution
values are to be reported.
MONTH Selects the starting month and year.
MEDIUM Specifies which medium response
distribution values are to be reported.
ABBR Selects the abbreviated form of the report.
SYSID Specifies the SYSID for reporting.
SYSTEM Selects the TSO System Summary Report.
SHORT Specifies which short response distribution
values are to be reported.
USER Specifies that a report for all TSO users
is to be generated.
ZONEADD Specifies that the report is to accumulate
the selected time zones.
ZONE1,ZONE2, Specifies the standard time zones to be
ZONE3,ZONE4, reported.
ZONE5,ZONE6,
ZONE7,ZONE8,
ZONE9
KEYWORD SYNTAX
The following table summarizes the options and syntax of each
keyword.
KEYWORD DEFAULT NOTE
------------------- ---------------------------- ----
ABBR=Y or N Generate the long form report
APPL=macro_name or Y No application reports 1
BASE=monyy The 3rd previous month 2
BREAK=value 8
DROP=list No
LONG=list Use 1st and 2nd values
MONTH=monyy Use the 1st month found 2
MEDIUM=list Use 1st and 2nd values
SYSID=sysid Report all systems
SYSTEM=Y or N Default report
SHORT=list Use 1st and 2nd values
USER=macro_name or Y No user selection 1
ZONEADD=Y or N No
ZONE1=Y or N Include zone 1
ZONE2=Y or N Include zone 2
ZONE3=Y or N Include zone 3
ZONE4=Y or N Include zone 4
ZONE5=Y or N Include zone 5
ZONE6=Y or N Include zone 6
ZONE7=Y or N Include zone 7
ZONE8=Y or N Include zone 8
ZONE9=Y or N Include zone 9
____________________________________________
NOTES: 1. Macro_name refers to a SAS macro coded by the
user.
2. monyy is a SAS date format of month and year.
SYNTAX SPECIFICATIONS
ABBR=Y or N
This keyword specifies the short form of the selected
reports. The standard report format contains the current and
the three previous months. The short form displays data for
the starting and base months only.
EXAMPLE: ABBR=Y
APPL=Y or macro_name
This keyword specifies Application Summary Reports.
BASE=monyy
The BASE keyword specifies which months from the data base to
use as the base for calculating the percentage of change from
the current month. You enter the base value in a month year
format. The year value may range from 70-99. The month
value uses a three character abbreviation of standard SAS
formats.
When you do not specify the base, the report will use the
third previous month as the base month.
Note: If the input does not include the base month
specified, the report will not perform the percentage
change calculation.
EXAMPLE: BASE=JUN86
BREAK=n
This keyword specifies that a single report combine all
userids with a common prefix of n characters. You may
specify BREAK (as an integer from 1-8) with the USER keyword
when you do not require specific user selection. You do not
use the BREAK value if the USER keyword has a macro name
instead of just Y.
EXAMPLE: BREAK=4 USER=Y specifies that the system will
select all userids and group them by the first four
characters of the userid.
DROP=list
You use the DROP keyword to tailor the output of the summary
reports by specifying which MANAGEMENT INDICATOR elements
the report should not display. The system assigns a number
to each line or line group in the summary reports as defined
in the table below.
MANAGEMENT INDICATOR NUMBER TABLE
01 AVG RESPONSE TIME (ALL FUNCTIONS)
02 ALL FUNCTIONS RESPONSE WITHIN n SECONDS
03 AVG RESPONSE TIME (SHORT)
04 SHORT RESPONSE WITHIN n SECONDS
05 AVG RESPONSE TIME (MEDIUM)
06 MEDIUM RESPONSE WITHIN n SECONDS
07 AVG RESPONSE TIME (LONG)
08 LONG RESPONSE WITHIN n SECONDS
09 AVG USER THINK TIME
10 SAMPLED NETWORK DELAY TIME
15 NUMBER OF COMMANDS
16 NUMBER OF SHORT RESPONSES
17 NUMBER OF MEDIUM RESPONSES
18 NUMBER OF LONG RESPONSES
19 COMMAND TCB CPU TIME (HH:MM)
20 COMMAND SRB CPU TIME (HH:MM)
21 COMMAND RESIDENCY TIME
22 NON TERMINAL I/O (EXCPS)
23 TERMINAL I/O (TGET/TPUT)
24 SERVICE UNITS
25 NUMBER OF ENDED SRM TRANSACTIONS
29 COMMANDS PER HOUR
30 ENDED SRM TRANSACTIONS PER HOUR
31 SERVICE UNITS PER HOUR
32 NON TERMINAL I/O PER HOUR
33 CPUTIME PER HOUR(TCB+SRB) (MM:SS)
41 TARGET AVAILABLE HOURS (HH:MM)
42 ACTUAL AVAILABLE HOURS (HH:MM)
43 AVAILABILITY
44 NUMBER OF SYSTEM IPLS
47 NUMBER OF USER LOGONS
48 TERMINAL CONNECT HOURS (HH:MM)
49 AVG NUMBER OF CONCURRENT USERS
50 MAX NUMBER OF CONCURRENT USERS
EXAMPLES: DROP=3,4,7,8,23,24,25
SHORT=list
MEDIUM=list
LONG=list
These keywords allow selection of response distribution
values other than the default slots (first and second
values). You may select from the distributions specified
when TSO/MON was installed. The data has been collected
based on those distributions, and any attempt to refit the
data into new user-specified distributions will result in
erroneous data. You may enter up to seven values for any of
the response types, but the total number of response values
cannot exceed 13. Note that the SHORT keyword also specifies
the number of distribution values to print for the total
response category. If you exceed this limit, the system will
give a diagnostic (user ABEND 998).
EXAMPLE:
If you do not define your prime TSO service period by zone 1,
or if the two and five second distribution values are not the
first two that TSO/MON defines, you must explicitly specify
these parameters. The following statements illustrate how
this is done:
SYSTEM=Y SHORT=2,5 MEDIUM=2,5 LONG=2,5
SYSTEM=Y SHORT=2,5 MEDIUM=2,5 LONG=2,5 /
ZONE1=Y ZONE2=Y ZONEADD=Y
MONTH=monyy
The MONTH keyword specifies the month to use as the starting
month. This month and the previous three months will be
selected from the monthly cycles defined by variables
&TSOTSO, &TSOTSU, and &TSOTSI as input. The default value is
the current previous month when run.
EXAMPLES: MONTH=SEP85
MONTH=DEC86
SYSID=xxxx
This keyword specifies that the report show the CA MICS
logical system id 'xxxx'. Use of the default will produce a
report for each logical SYSID in the MONTHs time-span.
EXAMPLE: SYSID=PROD
SYSTEM=Y or N
This keyword specifies generation of the TSO System Summary
Report. Since this is the default, it is necessary to
specify this keyword only if you specify the user or group
option and you do not wish to generate the TSO System Summary
Report.
EXAMPLE: USER=Y SYSTEM=N
USER=Y or macro_name
This keyword specifies generation of a TSO User Summary
Report for all userids in the data base.
ZONE Specification: ZONEn, ZONEADD
The ZONE keyword specifies which time zones to report. The
default is to report time zone 1. When you select specific
time zones, the output will show only those zones.
ZONEADD specifies accumulation of statistics for the
specified zones. If you do not specify any zones, all time
zones defined by CA MICS will be accumulated.
EXAMPLES: ZONE1=Y
ZONEADD=Y ZONE1=Y ZONE2=Y
