gtps3m0l | System Performance and Measurement Reference |
A TPF system analyst has a number of uses for the program reports:
- One use for the program reports is to track program usage over time as an
indirect gauge of the growth of the load on the system.
Every Enter does not represent an identical load on the system.
Different entry points may have different instruction path lengths.
Such differences tend to cancel one another out when aggregates of programs
are considered instead of individual programs.
To assist the study of aggregates of programs, the OPTIONS file allows
definition of packages of programs through program naming patterns.
- Another use of the program reports is to compare packages of
programs. The purpose of this comparative study is to roughly gauge the
relative share of packages on system load. Alternatively, differences
in the design and implementation of the respective packages can be roughly
gauged.
For example, the TPF analyst may want to investigate the reasons underlying
an observation that a package of programs has a comparatively high mean
nesting level but a comparatively low percentage of ENTNCs and ENTDCs in favor
of ENTRCs. One explanation may be that classical structured programming
guidelines were followed too literally for the TPF environment. A high
mean nesting level but a low percentage of ENTNCs or ENTDCs can mean that the
package is holding on to more nested system resources than necessary and that
the package is placing an unnecessarily large load on the system.
The TPF analyst can use the program reports to look for significant
differences between packages and between subsystems, and then try to account
for those differences.
The Program Names and Enters Report shows which of the programs of a
subsystem actually received control while the program data was being collected
(see Figure 45).
Figure 45. Program Names and Enters Report
PROGRAM NAMES AND ENTERS BASIC SUB SY
PROGRAM NAMES AND ENTERS BSS SUBSYSTEM
PROG CAT #ENTERS PROG CAT #ENTERS PROG CAT #ENTERS PROG CAT #ENTE
==== --- --------- ==== --- --------- ==== --- --------- ==== --- -----
CEL5 F31 0
CLEN F31 1
CLER F31 0
CLEZ F31 18
COAB C31 1
COLI F31 0
CSA0 C31 0
CSA7 C31 2
CSHA C31 0
CSHB C31 2
CSHC C31 1
CSHD C31 2
CVIQ C31 1
CYC3 C31 1
JCD2 F31 1
JCF0 F31 300
XLDD C31 1
XLII C31 1
|
The report identifies the programs that received control as a result of
Enter or Back events.
An Enter event is the execution of an ENTRC, ENTNC, or ENTDC macro. A
Back event is the execution of a BACKC macro.
The Program Details Report provides a detailed view of the Enter/Back
activity of those subsystem programs that actually received control (see Figure 46).
Figure 46. Program Details Report
PROGRAM DETAILS BSS SUBSYSTEM
PROG CAT #EVENTS #ENTERS #RETURNS %DLMFC %ENTRC %ENTNC %ENTDC %DLMR %BACKC %F
==== --- -------- -------- -------- ------ ------ ------ ------ ------ ------ --
ARPK C31 74 74 0 0.00 0.00 100.00 0.00 0.00 0.00
ARPT C31 146 71 75 0.00 0.00 100.00 0.00 0.00 100.00
CAPB C31 4 4 0 0.00 0.00 100.00 0.00 0.00 0.00
CAPP C31 17 8 9 0.00 0.00 100.00 0.00 0.00 100.00
CAPQ C31 9 9 0 0.00 100.00 0.00 0.00 0.00 0.00
CAPR C31 9 9 0 0.00 0.00 100.00 0.00 0.00 0.00
CBC3 C31 2 2 0 0.00 0.00 100.00 0.00 0.00 0.00
CBL0 C31 11 5 6 0.00 0.00 100.00 0.00 0.00 100.00
CBPK C31 2 2 0 0.00 100.00 0.00 0.00 0.00 0.00
CBW0 C31 18 18 0 0.00 33.33 66.67 0.00 0.00 0.00
CDTF C31 20 20 0 0.00 0.00 100.00 0.00 0.00 0.00
CELM F31 72 72 0 0.00 100.00 0.00 0.00 0.00 0.00
CELT F31 178 178 0 0.00 100.00 0.00 0.00 0.00 0.00
CELV F31 177 76 101 0.00 100.00 0.00 0.00 0.00 100.00
CELW F31 250 26 224 0.00 100.00 0.00 0.00 0.00 100.00
CEL5 F31 418 23 395 0.00 0.00 100.00 0.00 0.00 100.00
CHKA C31 4 4 0 0.00 100.00 0.00 0.00 0.00 0.00
CIAA C31 4 4 0 0.00 0.00 100.00 0.00 0.00 0.00
CINN C31 4 4 0 0.00 0.00 100.00 0.00 0.00 0.00
CLDA F31 26 26 0 0.00 100.00 0.00 0.00 0.00 0.00
CLEG F31 26 26 0 0.00 100.00 0.00 0.00 0.00 0.00
CLEK F31 48 48 0 0.00 100.00 0.00 0.00 0.00 0.00
CLEM F31 1667 705 962 0.00 100.00 0.00 0.00 0.00 100.00
CLEN F31 257 257 0 0.00 100.00 0.00 0.00 0.00 0.00
CLER F31 2236 26 2210 0.00 100.00 0.00 0.00 0.00 100.00
CLES F31 62 62 0 0.00 100.00 0.00 0.00 0.00 0.00
CLET F31 20 10 10 0.00 100.00 0.00 0.00 0.00 100.00 2
· · ·
CYYM C31 74 74 0 0.00 100.00 0.00 0.00 0.00 0.00
JCD2 F31 120 40 80 0.00 0.00 100.00 0.00 0.00 100.00
JCD3 F31 40 40 0 0.00 100.00 0.00 0.00 0.00 0.00 1
JCP0 F31 40 40 0 0.00 100.00 0.00 0.00 0.00 0.00
PROGRAM DETAILS BSS SUBSYSTEM
PROG CAT #EVENTS #ENTERS #RETURNS %DLMFC %ENTRC %ENTNC %ENTDC %DLMR %BACKC %F
==== --- -------- -------- -------- ------ ------ ------ ------ ------ ------ --
· · ·
UOP1 C31 36 36 0 0.00 100.00 0.00 0.00 0.00 0.00
WGR1 C31 3 3 0 0.00 100.00 0.00 0.00 0.00 0.00
XLAA C31 32 32 0 0.00 0.00 100.00 0.00 0.00 0.00
XLII C31 35 35 0 0.00 0.00 100.00 0.00 0.00 0.00
XLJJ C31 40 40 0 0.00 0.00 100.00 0.00 0.00 0.00
TOTALS: 75274 45265 30009 13.46 62.16 17.38 7.00 23.84 76.16
|
When no packages of programs are defined in the OPTIONS file, the report
generated encompasses all of the programs in the subsystem being
reduced.
The Cumulative Program Enters report provides a concise view of the
programs that received control most often as a result of Enter events (see Figure 47). The report stops identifying programs when the
cumulative percentage cutoff is exceeded. The default cutoff is
90%.
When no packages of programs are defined in the OPTIONS file, the report
generated encompasses all of the programs in the subsystem being
reduced.
Figure 47. Cumulative Program Enters Report
CUMULATIVE PROGRAM ENTERS FOR PACKAGE: XXXXXXXX BASIC SUB SY
CUMULATIVE PROGRAM ENTERS BSS SUBSYSTEM
PROG CAT #ENTERS ENTERS RATE ESREL% ESCUM%
---- --- ======== =========== ====== ******
JCF0 F31 300 104.91 90.36 90.36
CLEZ F31 18 6.13 5.42 95.78
CSA7 C31 2 0.53 0.60 96.38
CSHB C31 2 0.53 0.60 96.99
CSHD C31 2 0.53 0.60 97.59
CLEN F31 1 0.18 0.30 97.89
COAB C31 1 0.18 0.30 98.19
CSHC C31 1 0.18 0.30 98.49
CVIQ C31 1 0.18 0.30 98.79
CYC3 C31 1 0.18 0.30 99.10
JCD2 F31 1 0.18 0.30 99.40
XLDD C31 1 0.18 0.30 99.70
XLII C31 1 0.18 0.30 100.00
CEL5 F31 0 0.00 0.00 100.00
CLER F31 0 0.00 0.00 100.00
COLI F31 0 0.00 0.00 100.00
CSA0 C31 0 0.00 0.00 100.00
CSHA C31 0 0.00 0.00 100.00
TOTALS: 332 116.12
|
The Cumulative Program On-File Enters report provides a concise view of the
programs that received control most often as a result of Enter events that
caused program retrieval references to VFA or to DASD (see Figure 48). The report stops identifying programs when the
cumulative percentage cutoff is exceeded. The default cutoff is
90%.
When no packages of programs were defined in the OPTIONS file, the report
is generated once for all of the programs in the subsystem being
reduced.
Figure 48. Cumulative Program On-File Enters Report
CUMULATIVE PROGRAM ON-FILE ENTERS BSS SUBSYSTEM
PROG CAT #FILE FILE RATE FSREL% FSCUM%
---- --- ======== =========== ====== ******
CEL5 F31 0 0.00 0.00 0.00
CLEN F31 0 0.00 0.00 0.00
CLER F31 0 0.00 0.00 0.00
CLEZ F31 0 0.00 0.00 0.00
COAB C31 0 0.00 0.00 0.00
COLI F31 0 0.00 0.00 0.00
CSA0 C31 0 0.00 0.00 0.00
CSA7 C31 0 0.00 0.00 0.00
CSHA C31 0 0.00 0.00 0.00
CSHB C31 0 0.00 0.00 0.00
CSHC C31 0 0.00 0.00 0.00
CSHD C31 0 0.00 0.00 0.00
CVIQ C31 0 0.00 0.00 0.00
CYC3 C31 0 0.00 0.00 0.00
JCD2 F31 0 0.00 0.00 0.00
JCF0 F31 0 0.00 0.00 0.00
XLDD C31 0 0.00 0.00 0.00
XLII C31 0 0.00 0.00 0.00
TOTALS: 0 0.00
|
The Package Details report provides a detailed view of the Enter/Back
activity of the packages of programs defined in the OPTIONS file for the
subsystem (see Figure 49).
Figure 49. Package Details Report
PACKAGE DETAILS BSS SUBSYSTEM
PACKAGE #EVENTS #ENTERS #RETURNS %DLMFC %ENTRC %ENTNC %ENTDC %DLMR %BACKC %F
======== -------- -------- -------- ------ ------ ------ ------ ------ ------ --
A 47 31 16 0.00 0.00 100.00 0.00 0.00 100.00
B 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
C 7098 3908 3190 0.00 66.63 33.29 0.08 0.00 100.00
D 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
E 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
F 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
G 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
H 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
I 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
J 97 52 45 0.00 88.46 11.54 0.00 0.00 100.00
K 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
L 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
M 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
N 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
O 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
P 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
Q 244543 157041 87502 19.87 53.63 19.48 9.76 35.66 64.34
R 79803 57238 22565 22.38 53.08 6.69 15.71 56.76 43.24
S 15584 7882 7702 9.63 89.71 3.39 0.00 9.85 90.14
T 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
U 200 200 0 0.00 100.00 0.00 0.00 0.00 0.00
V 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
W 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
X 20 20 0 0.00 0.00 100.00 0.00 0.00 0.00
Y 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
Z 0 0 0 0.00 0.00 0.00 0.00 0.00 0.00
|
The Cumulative Package Enters report provides a concise view of the
packages that received control most often as a result of Enter events (see Figure 50).
Figure 50. Cumulative Package Enters Report
CUMULATIVE PACKAGE ENTERS BSS SUBSYSTEM
PACKAGE #ENTERS ENTERS RATE ESREL% ESCUM%
-------- ======== =========== ====== ******
J 301 105.26 90.66 90.66
C 29 9.98 8.73 99.40
X 2 0.53 0.60 100.00
A 0 0.00 0.00 100.00
B 0 0.00 0.00 100.00
D 0 0.00 0.00 100.00
E 0 0.00 0.00 100.00
F 0 0.00 0.00 100.00
G 0 0.00 0.00 100.00
H 0 0.00 0.00 100.00
I 0 0.00 0.00 100.00
K 0 0.00 0.00 100.00
L 0 0.00 0.00 100.00
M 0 0.00 0.00 100.00
N 0 0.00 0.00 100.00
O 0 0.00 0.00 100.00
P 0 0.00 0.00 100.00
Q 0 0.00 0.00 100.00
R 0 0.00 0.00 100.00
S 0 0.00 0.00 100.00
T 0 0.00 0.00 100.00
U 0 0.00 0.00 100.00
V 0 0.00 0.00 100.00
W 0 0.00 0.00 100.00
Y 0 0.00 0.00 100.00
Z 0 0.00 0.00 100.00
|
The Cumulative Package On-File Enters report provides a concise view of the
packages that received control most often as a result of Enter events that
caused program-retrieval references to VFA or to DASD (see Figure 51).
Figure 51. Cumulative Package On-File Enters Report
CUMULATIVE PACKAGE ON-FILE ENTERS BSS SUBSYSTEM
PACKAGE #FILE FILE RATE FSREL% FSCUM%
-------- ======== =========== ====== ******
A 0 0.00 0.00 0.00
B 0 0.00 0.00 0.00
C 0 0.00 0.00 0.00
D 0 0.00 0.00 0.00
E 0 0.00 0.00 0.00
F 0 0.00 0.00 0.00
G 0 0.00 0.00 0.00
H 0 0.00 0.00 0.00
I 0 0.00 0.00 0.00
J 0 0.00 0.00 0.00
K 0 0.00 0.00 0.00
L 0 0.00 0.00 0.00
M 0 0.00 0.00 0.00
N 0 0.00 0.00 0.00
O 0 0.00 0.00 0.00
P 0 0.00 0.00 0.00
Q 0 0.00 0.00 0.00
R 0 0.00 0.00 0.00
S 0 0.00 0.00 0.00
T 0 0.00 0.00 0.00
U 0 0.00 0.00 0.00
V 0 0.00 0.00 0.00
W 0 0.00 0.00 0.00
X 0 0.00 0.00 0.00
Y 0 0.00 0.00 0.00
Z 0 0.00 0.00 0.00
|
The Program Legend report defines the column headings used in most of the
program reports (see Figure 52).
Figure 52. Program Legend Report
PROGRAM LEGEND BSS SUBSYSTEM
COLUMN DESCRIPTION
=========== ------------------------------------------------------------------
#COME THE NUMBER OF ENTERS THAT HAD TO AWAIT INCOMING I/O IN ORDER TO RE
#ENTERS THE NUMBER OF GENERIC ENTERS
#EVENTS THE NUMBER OF GENERIC ENTERS OR GENERIC RETURNS
#FILE THE NUMBER OF ENTERS THAT HAD TO ACCESS THE VFA OR DASD IN ORDER T
#IN THE NUMBER OF ENTERS THAT FOUND THE PROGRAM BEING ENTERED ALREADY
#OTHER THE NUMBER OF ENTERS THAT DID NOT HAVE TO ACCESS THE VFA OR DASD I
#RETURNS THE NUMBER OF GENERIC RETURNS
%BACKCS THE PERCENTAGE OF RETURNS THAT WERE BACKCS
%COME THE PERCENTAGE OF ENTERS THAT HAD TO AWAIT INCOMING I/O IN ORDER T
%DLMFC THE PERCENTAGE OF ENTERS THAT WERE DLM EXTERNAL FUNCTION CALLS
%DLMR THE PERCENTAGE OF RETURNS THAT WERE DLM RETURNS
%ENTDC THE PERCENTAGE OF ENTERS THAT WERE ENTDCS
%ENTNC THE PERCENTAGE OF ENTERS THAT WERE ENTNCS
%ENTRC THE PERCENTAGE OF ENTERS THAT WERE ENTRCS
%FILE THE PERCENTAGE OF ENTERS THAT HAD TO ACCESS THE VFA OR DASD IN ORD
%I1 %I2 ... THE PERCENTAGE OF GENERIC ENTERS OR GENERIC RETURNS THAT OCCURRED
%IN THE PERCENTAGE OF ENTERS THAT FOUND THE PROGRAM BEING ENTERED ALRE
%OTHER THE PERCENTAGE OF ENTERS THAT DID NOT HAVE TO ACCESS THE VFA OR DA
CAT THE PROGRAM CATEGORIES:
*** - INDETERMINATE PROGRAMS
C24 - CORE RESIDENT, 24-BIT PROGRAMS
C31 - CORE RESIDENT, 31-BIT PROGRAMS
F24 - FILE RESIDENT, 24-BIT PROGRAMS
F31 - FILE RESIDENT, 31-BIT PROGRAMS
X24 - CORE RESIDENT CONVERTED TO FILE RESIDENT, 24-BIT PROGRAMS
X31 - CORE RESIDENT CONVERTED TO FILE RESIDENT, 31-BIT PROGRAMS
ENTERS RATE THE NUMBER OF GENERIC ENTERS PER SECOND
ESCUM% THE CUMULATIVE PERCENTAGE OF THE SUBSYSTEM'S ENTERS
ESREL% THE RELATIVE PERCENTAGE OF THE SUBSYSTEM'S ENTERS
FILE RATE THE NUMBER OF ENTERS, THAT HAD TO ACCESS THE VFA OR DASD IN ORDER
FSCUM% THE CUMULATIVE PERCENTAGE OF THE SUBSYSTEMS'S ENTERS THAT HAD TO A
FSREL% THE RELATIVE PERCENTAGE OF THE SUBSYSTEMS'S ENTERS THAT HAD TO AC
PACKAGE THE NAME OF THE PACKAGE OF PROGRAMS
PROG THE NAME (OR NUMBER) OF THE PROGRAM ('OTHER' IS A SPECIAL PROGRAM-
SUBSYS THE NAME OF THE SUBSYSTEM
|
The Weighted-Message Rate Report (see Figure 53) shows you how many Enter events occurred per second, per
weighted message.
Figure 53. Weighted-Message Rate Report
WEIGHTED-MESSAGE RATE BSS SUBSYSTEM 04 FEB 14:44:57 PROGRAM PAGE 2
THERE WERE 6.12 ENTERS PER WEIGHTED MESSAGE.
#WEIGHTED-MESSAGES = (#HIGHSPEED - #ROUTED) + ( 5.00 * #LOWSPEED) + ( 0.30 * #ROUTED) + #TCP/IP = 897.92 WEIGHTED-MESSAGES.
|