SirAud: Difference between revisions
m (add "topics") |
m (misc formatting) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<var class="product">SirAud</var> reads a single journal file produced by <var class="product">Model 204</var> and it generates | <var class="product">SirAud</var> reads a single journal file produced by <var class="product">Model 204</var> and it generates a set of reports, using | ||
a set of reports, using | |||
statistics entries as well as other information in the journal. | statistics entries as well as other information in the journal. | ||
These reports are intended to provide an overview | These reports are intended to provide an overview | ||
of the resource usage for one <var class="product">Model 204</var> run. | of the resource usage for one <var class="product">Model 204</var> run. | ||
Each report summarizes a different aspect of the run. | Each report summarizes a different aspect of the run. | ||
| Line 11: | Line 10: | ||
The sections on this page give the report names and a brief description of the report contents. | The sections on this page give the report names and a brief description of the report contents. | ||
If a report is selected by specifying a <var class="product">SirAud</var> program parameter | If a report is selected by specifying a <var class="product">SirAud</var> program parameter (see [[SirAud parameters#allpr|ALLPR and NOPR]]), all reports are | ||
(see [[SirAud parameters#allpr|ALLPR and NOPR]]), all reports are | produced on the <code>SYSPRINT</code> file, and only there. | ||
produced on the SYSPRINT file, and only there. | Otherwise, the name of the report given in the following table is the same as the name of the DD statement (in MVS, or the FILEDEF command, in CMS) to which the report is written. | ||
Otherwise, the name of the report given in the | |||
is the same as the name of the DD statement | |||
(in MVS, or the FILEDEF command, in CMS) to which the report is written. | |||
== | <table class="thJustBold"> | ||
<caption>SirAud reports</caption> | |||
<tr class="head"><th>Report</th> | |||
<th>Description</th></tr> | |||
<tr><th>PERFREPT</th> | |||
This report summarizes | <td>This report summarizes system-level performance over each <var>[[ACCTIM parameter|ACCTIM]]</var> interval. | ||
<p> | |||
For more information about the report content, see [[SirAud report contents#PERFREPT|PERFREPT]]. </p></td></tr> | |||
= | <tr><th>FILEREPT</th> | ||
This report summarizes the resource utilization of each <var class="product">Model 204</var> procedure. | <td>This report summarizes the resource utilization of each <var class="product">Model 204</var> file. | ||
Files are reported in descending order by total disk I/O (<code>DKRD+DKWR</code>). | |||
<p> | |||
For more information about the report content, see [[SirAud report contents#FILEREPT|FILEREPT]]. </p></td></tr> | |||
<tr><th>PROCREPT</th> | |||
<td>This report summarizes the resource utilization of each <var class="product">Model 204</var> procedure. | |||
Procedures are reported by subsystem and file, in descending order by total CPU. | Procedures are reported by subsystem and file, in descending order by total CPU. | ||
<p> | |||
For more information about the report content, see [[SirAud report contents#PROCREPT|PROCREPT]]. </p> </td></tr> | |||
<tr><th>SUBREPT</th> | |||
This report summarizes the resource utilization of each <var class="product">Model 204</var> subsystem. | <td>This report summarizes the resource utilization of each <var class="product">Model 204</var> subsystem. Subsystems are reported in descending order by total CPU. | ||
Subsystems are reported in descending order by total CPU. | <p> | ||
For more information about the report content, see [[SirAud report contents#SUBREPT|SUBREPT]]. </p></td></tr> | |||
<tr><th>UTBLREPT</th> | |||
This report summarizes the current high water mark of each user-resettable server | <td>This report summarizes the current high water mark of each user-resettable server table on a subsystem basis. A set of "target" table settings is also presented. | ||
table on a subsystem basis. | Subsystems are reported in descending order by the largest server size needed to run all of the subsystem procedures executed during the run. | ||
A set of "target" table settings is also presented. | |||
Subsystems are reported in descending order by the | |||
largest server size needed to run all of the subsystem procedures executed during the run. | |||
A separate line is produced for each procedure in the subsystem that | A separate line is produced for each procedure in the subsystem that | ||
has a table high water mark that is above the "target" value. | has a table high water mark that is above the "target" value. | ||
<p> | |||
For more information about the report content, see [[SirAud report contents#UTBLREPT|UTBLREPT]]. </p></td></tr> | |||
<tr><th>UTBLSUMM</th> | |||
This report summarizes the current high water mark of each user-resettable server table for each subsystem. | <td>This report summarizes the current high water mark of each user-resettable server table for each subsystem. Subsystems are reported in descending order by the largest server size needed to run all of its procedures executed during the run. | ||
Subsystems are reported in descending order | <p> | ||
by the largest server size needed to run all of its procedures executed during the run. | For more information about the report content, see [[SirAud report contents#UTBLSUMM|UTBLSUMM]]. </p></td></tr> | ||
</table> | |||
==Additional SirAud files== | ==Additional SirAud files== | ||
===JOURNAL=== | ===JOURNAL=== | ||
This is the input <var class="product">Model 204</var> journal file. | This is the input <var class="product">Model 204</var> journal file. | ||
===<b id="syspr"></b>SYSPRINT=== | |||
Various information is written to this file; the following information | Various information is written to this file; the following information | ||
is always written to SYSPRINT: | is always written to SYSPRINT: | ||
<ul> | <ul> | ||
<li>Various <b>AUD</b>nnn messages, which are explained in | <li>Various <b>AUD</b><i>nnn</i> messages, which are explained in | ||
[[SirAud messages]]. | [[:Category:SirAud messages|SirAud messages]]. | ||
<li>Identification of the <var class="product">Model 204</var> run that created the JOURNAL file. | <li>Identification of the <var class="product">Model 204</var> run that created the <code>JOURNAL</code> file. | ||
<li>A list of pertinent run-time parameters as specified in the <var class="product">Model 204</var> run's EXEC, user 0, | <li>A list of pertinent run-time parameters as specified in the <var class="product">Model 204</var> run's EXEC, user 0, | ||
and user n parameters. | and user <var class="term">n</var> parameters. | ||
</ul> | </ul> | ||
Also, if any <var class="product">SirAud</var> reports are specified as program parameters, | Also, if any <var class="product">SirAud</var> reports are specified as program parameters, | ||
reports are contained in the SYSPRINT file, and only there; see [[SirAud parameters#allpr|ALLPR and NOPR]]. | reports are contained in the <code>SYSPRINT</code> file, and only there; see [[SirAud parameters#allpr|ALLPR and NOPR]]. | ||
===<b id="sysin"></b>SYSIN=== | ===<b id="sysin"></b>SYSIN=== | ||
Prior to version 1.05 of <var class="product">SirAud</var>, no SYSIN file contents were read by <var class="product">SirAud</var>. | Prior to version 1.05 of <var class="product">SirAud</var>, no SYSIN file contents were read by <var class="product">SirAud</var>. | ||
As of version 1.05, all <var class="product">SirAud</var> | As of version 1.05, all <var class="product">SirAud</var> [[SirAud parameters|program parameters]] may be specified on input records in the <code>SYSIN</code> data set, which is read and parsed under MVS and CMS. | ||
be specified on input records in the SYSIN | |||
under MVS and CMS. | |||
You can specify multiple parameters on one SYSIN record, | You can specify multiple parameters on one <code>SYSIN</code> record, and you can specify multiple records, but you | ||
and you can specify multiple records, but you | cannot specify a parameter on one record and "continue" its value(s) on another record. | ||
cannot specify a parameter on one record and "continue" | |||
its value(s) on another record. | |||
The following simple example of SYSIN content shows valid | The following simple example of <code>SYSIN</code> content shows valid SirAud parameter specifications: | ||
parameter specifications: | |||
<p class="code"><nowiki>FROM 04169 10:00 | <p class="code"><nowiki>FROM 04169 10:00 | ||
PERFRP | PERFRP | ||
Latest revision as of 22:16, 12 October 2016
SirAud reads a single journal file produced by Model 204 and it generates a set of reports, using statistics entries as well as other information in the journal. These reports are intended to provide an overview of the resource usage for one Model 204 run. Each report summarizes a different aspect of the run.
SirAud reports
A report is generated when a corresponding file is defined or when the report is requested by a SirAud program parameter. The sections on this page give the report names and a brief description of the report contents.
If a report is selected by specifying a SirAud program parameter (see ALLPR and NOPR), all reports are
produced on the SYSPRINT file, and only there.
Otherwise, the name of the report given in the following table is the same as the name of the DD statement (in MVS, or the FILEDEF command, in CMS) to which the report is written.
| Report | Description |
|---|---|
| PERFREPT | This report summarizes system-level performance over each ACCTIM interval.
For more information about the report content, see PERFREPT. |
| FILEREPT | This report summarizes the resource utilization of each Model 204 file.
Files are reported in descending order by total disk I/O ( For more information about the report content, see FILEREPT. |
| PROCREPT | This report summarizes the resource utilization of each Model 204 procedure.
Procedures are reported by subsystem and file, in descending order by total CPU. For more information about the report content, see PROCREPT. |
| SUBREPT | This report summarizes the resource utilization of each Model 204 subsystem. Subsystems are reported in descending order by total CPU.
For more information about the report content, see SUBREPT. |
| UTBLREPT | This report summarizes the current high water mark of each user-resettable server table on a subsystem basis. A set of "target" table settings is also presented.
Subsystems are reported in descending order by the largest server size needed to run all of the subsystem procedures executed during the run. A separate line is produced for each procedure in the subsystem that has a table high water mark that is above the "target" value. For more information about the report content, see UTBLREPT. |
| UTBLSUMM | This report summarizes the current high water mark of each user-resettable server table for each subsystem. Subsystems are reported in descending order by the largest server size needed to run all of its procedures executed during the run.
For more information about the report content, see UTBLSUMM. |
Additional SirAud files
JOURNAL
This is the input Model 204 journal file.
SYSPRINT
Various information is written to this file; the following information is always written to SYSPRINT:
- Various AUDnnn messages, which are explained in SirAud messages.
- Identification of the Model 204 run that created the
JOURNALfile. - A list of pertinent run-time parameters as specified in the Model 204 run's EXEC, user 0, and user n parameters.
Also, if any SirAud reports are specified as program parameters,
reports are contained in the SYSPRINT file, and only there; see ALLPR and NOPR.
SYSIN
Prior to version 1.05 of SirAud, no SYSIN file contents were read by SirAud.
As of version 1.05, all SirAud program parameters may be specified on input records in the SYSIN data set, which is read and parsed under MVS and CMS.
You can specify multiple parameters on one SYSIN record, and you can specify multiple records, but you
cannot specify a parameter on one record and "continue" its value(s) on another record.
The following simple example of SYSIN content shows valid SirAud parameter specifications:
FROM 04169 10:00 PERFRP TO 04170 12:00
SirAud topics
The SirAud documentation consists of the pages listed below. This list is also available as a "See also" link from each of the pages.
For information about product changes and Model 204 feature support per SirAud version, see the Model 204 release notes.
For information about product error messages, see SirAud messages.