SirAud parameters: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (misc cleanup)
 
(6 intermediate revisions by 3 users not shown)
Line 18: Line 18:


This page describes the parameter settings that are available for <var class="product">SirAud</var>.
This page describes the parameter settings that are available for <var class="product">SirAud</var>.
<p class="note"><b>Note:</b> You can change the default setting for some of the parameters; see [[SirAud default customization]]. </p>
<p class="note"><b>Note:</b> You can change the default setting for some of the parameters; see [[#SirAud default customization|SirAud default customization]], below. </p>


==<b id="allpr"></b>ALLPR and NOPR==
==<b id="allpr"></b>ALLPR and NOPR==
Line 64: Line 64:


You may customize your <var class="product">SirAud</var> load module so that <var>ALLPR</var> is the default; see
You may customize your <var class="product">SirAud</var> load module so that <var>ALLPR</var> is the default; see
[[SirAud default customization#cszallp|ALLPR parameter customization]].
[[SirAud parameters#cszallp|ALLPR parameter customization]].


==<b id="from"></b>FROM parameter==
==<b id="from"></b>FROM parameter==
Line 117: Line 117:
After the changes, <var class="product">SirTune</var> on a new busy period might show procedure A CPU goes up to 12%.
After the changes, <var class="product">SirTune</var> on a new busy period might show procedure A CPU goes up to 12%.
One way to check the effectiveness of your changes is to use
One way to check the effectiveness of your changes is to use
<var class="product">SirAud</var> PROCREPT reports with date/time ranges to see if this increase in CPU correlates to an increased number of invocations between the two busy times.
<var class="product">SirAud</var> [[SirAud report contents#PROCREPT|PROCREPT]] reports with date/time ranges to see if this increase in CPU correlates to an increased number of invocations between the two busy times.


==FILERP and NOFILERP==
==FILERP and NOFILERP==
Line 123: Line 123:
<ul>
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Forcing all report output to the SYSPRINT file
<li>Producing (<var>FILERP</var>) or suppressing (<var>NOFILERP</var>) the FILEREPT report.
<li>Producing (<var>FILERP</var>) or suppressing (<var>NOFILERP</var>) the [[SirAud report contents#FILEREPT|FILEREPT]] report.
</ul>
</ul>


Line 141: Line 141:
to facilitate running <var class="product">SirAud</var> with newer releases of <var class="product">Model&nbsp;204</var>,
to facilitate running <var class="product">SirAud</var> with newer releases of <var class="product">Model&nbsp;204</var>,
compensating for changes in the journal format.
compensating for changes in the journal format.
==NCP parameter==
Syntax:
<p class="syntax">NCP = <span class="term">1-255</span> </p>
This parameter sets the number of channel programs to use for the input journal.
A higher value can improve journal I/O performance. If this parameter not specified, the value specified in the JOURNAL DD statement is used, otherwise the default of 22 is used. Under CMS, this parameter is allowed but ignored, and the value is set to 1.


==NFILES parameter==
==NFILES parameter==
Line 146: Line 153:
<p class="syntax">NFILES = <span class="term">n</span> </p>
<p class="syntax">NFILES = <span class="term">n</span> </p>


This parameter is used to restrict the number of files summarized in FILEREPT
This parameter is used to restrict the number of files summarized in [[SirAud report contents#FILEREPT|FILEREPT]]
to the top <var class="term">n</var> files by total disk I/O.
to the top <var class="term">n</var> files by total disk I/O.


Line 154: Line 161:


This parameter is used to restrict the number of procedures summarized in
This parameter is used to restrict the number of procedures summarized in
PROCREPT to the top <var class="term">n</var> procedures by total CPU.
[[SirAud report contents#PROCREPT|PROCREPT]] to the top <var class="term">n</var> procedures by total CPU.


==NSUBS parameter==
==NSUBS parameter==
Line 161: Line 168:


This parameter is used to restrict the number of subsystems summarized in
This parameter is used to restrict the number of subsystems summarized in
SUBREPT to the top <var class="term">n</var> subsystems by total CPU.
[[SirAud report contents#SUBREPT|SUBREPT]] to the top <var class="term">n</var> subsystems by total CPU.


==NUTBLS parameter==
==NUTBLS parameter==
Line 168: Line 175:


This parameter is used to restrict the number of subsystems summarized in
This parameter is used to restrict the number of subsystems summarized in
UTBLREPT to the top <var class="term">n</var> subsystems by server size.
[[SirAud report contents#UTBLREPT|UTBLREPT]] to the top <var class="term">n</var> subsystems by server size.


==NUSUMM parameter==
==NUSUMM parameter==
Line 175: Line 182:


This parameter is used to restrict the number of subsystems summarized in
This parameter is used to restrict the number of subsystems summarized in
UTBLSUMM to the top <var class="term">n</var> subsystems by server size.
[[SirAud report contents#UTBLSUMM|UTBLSUMM]] to the top <var class="term">n</var> subsystems by server size.


==PERFRP and NOPERFRP parameters==
==PERFRP and NOPERFRP parameters==
Line 181: Line 188:
<ul>
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Forcing all report output to the SYSPRINT file
<li>Producing (<var>PERFRP</var>) or suppressing (<var>NOPERFRP</var>) the PERFREPT report.
<li>Producing (<var>PERFRP</var>) or suppressing (<var>NOPERFRP</var>) the [[SirAud report contents#PERFREPT|PERFREPT]] report.
</ul>
</ul>


Line 190: Line 197:
<ul>
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Forcing all report output to the SYSPRINT file
<li>Producing (<var>PROCRP</var>) or suppressing (<var>NOPROCRP</var>) the PROCREPT report.
<li>Producing (<var>PROCRP</var>) or suppressing (<var>NOPROCRP</var>) the [[SirAud report contents#PROCREPT|PROCREPT]] report.
</ul>
</ul>


Line 205: Line 212:
<ul>
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Forcing all report output to the SYSPRINT file
<li>Producing (<var>SUBRP</var>) or suppressing (<var>NOSUBRP</var>) the SUBREPT report.
<li>Producing (<var>SUBRP</var>) or suppressing (<var>NOSUBRP</var>) the [[SirAud report contents#SUBREPT|SUBREPT]] report.
</ul>
</ul>


Line 255: Line 262:
This parameter is used to specify the number of standard deviations a server table
This parameter is used to specify the number of standard deviations a server table
highwater mark for an individual procedure is allowed to vary from the
highwater mark for an individual procedure is allowed to vary from the
mean for the subsystem before the procedure is flagged for UTBLREPT.
mean for the subsystem before the procedure is flagged for [[SirAud report contents#UTBLREPT|UTBLREPT]].


The default is 2.
The default is 2.
Line 263: Line 270:
<ul>
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Forcing all report output to the SYSPRINT file
<li>Producing (<var>UTBLRP</var>) or suppressing (<var>NOUTBLRP</var>) the UTBLREPT report.
<li>Producing (<var>UTBLRP</var>) or suppressing (<var>NOUTBLRP</var>) the [[SirAud report contents#UTBLREPT|UTBLREPT]] report.
</ul>
</ul>


Line 273: Line 280:
<ul>
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Forcing all report output to the SYSPRINT file
<li>Producing (<var>UTBLSM</var>) or suppressing (<var>NOUTBLSM</var>) the UTBLSUMM report.
<li>Producing (<var>UTBLSM</var>) or suppressing (<var>NOUTBLSM</var>) the [[SirAud report contents#UTBLSUMM|UTBLSUMM]] report.
</ul>
</ul>


See [[#allpr|ALLPR and NOPR]] for a discussion of these and the other
See [[#allpr|ALLPR and NOPR]] for a discussion of these and the other
report selection parameters.
report selection parameters.
You can change some of the <var class="product">SirAud</var> defaults by applying zaps any time after you have installed the load module.
This page contains the customizations you can perform.
==SirAud default customization==
===<b id="cszallp"></b>ALLPR parameter customization===
Apply the following zap to make the <var>[[SirAud parameters#allpr|ALLPR]]</var> parameter the default:
<p class="code">NAME SIRAUD JCUST
VER 08 00
REP 08 80  ALLPR is default
</p>
<!-- .*!UNPUB Keep DEBUG info private:
.* NAME SIRAUD JCUST
.* VER 38 00
.* REP 38 80  Produce GETNEXT trace of journal location/time -->


==See also==
==See also==

Latest revision as of 21:38, 24 February 2022

SirAud has a set of parameters you can use to restrict the size of some reports or otherwise configure the SirAud run. These parameters must be provided in either of these ways:

  • As a PARM on the EXEC card in MVS, for example:

    //SIRAUD EXEC PGM=SIRAUD,PARM='NSUBS=10 ALLPR'

  • As options on the M204CMS command in CMS, for example:

    M204CMS SIRAUD ( NSUBS 10 ALLPR %

Under MVS, parameters are specified either by a parameter name alone or by a parameter name followed by an equal sign (=) followed by the parameter value. Under CMS, parameters are specified by a parameter name followed by a space and a percent sign (%), or by a parameter name followed by a space and a parameter value.

This page describes the parameter settings that are available for SirAud.

Note: You can change the default setting for some of the parameters; see SirAud default customization, below.

ALLPR and NOPR

These are two of the report selection parameters. The report selection parameters determine which reports are produced. They also direct all of the report output of SirAud to be written to the SYSPRINT output file, rather than having each of SirAud's reports written to a separate output file. If any report selection parameter is specified, all of the SirAud report output is written to SYSPRINT, and only to there.

The report selection parameters are ALLPR, NOPR, and the following:

  • FILERP and NOFILERP
  • PERFRP and NOPERFRP
  • PROCRP and NOPROCRP
  • SUBRP and NOSUBRP
  • UTBLRP and NOUTBLRP
  • UTBLSM and NOUTBLSM

Any of the above individual report parameters beginning with NO is called the "negative" form of the parameter, and it indicates that the given report should not be produced The form without NO is called the "positive" form, and it indicates the given report should be produced.

ALLPR is a shorthand for a list of all of the positive forms of the individual report parameters. NOPR is a shorthand for a list of all of the negative forms of the individual report parameters.

The effect of the report selection parameters is cumulative, and the specification of any of them can override the effect of a preceding specification. If the first report selection parameter specified is a positive individual report parameter, an implicit NOPR precedes that. If the first report selection parameter specified is a negative individual report parameter, an implicit ALLPR precedes that.

Thus, for example, the following produces all reports except PERFREPT and FILEREPT:

PARM=(NOPERFRP,NOFILERP)

The following produces only the UTBLSUMM and SUBREPT reports:

PARM=(UTBLSM,SUBRP)

And the following produces all reports except PROCREPT (the UTBLRP in this example is superfluous):

PARM=(NOPROCRP,UTBLRP)

You may customize your SirAud load module so that ALLPR is the default; see ALLPR parameter customization.

FROM parameter

This parameter is used to restrict the analysis of the journal to those journal blocks that contain records that are at or after the indicated date and time. If the time on the journal block's trailer is greater than or equal to the FROM specification, the records in that block are included in the report analysis. Consequently, some records that are earlier than the FROM setting may be included.

The FROM syntax is:

FROM = yyddd | time | yyddd time

The FROM parameter options are:

yyddd Indicates the date, in Julian format, where the FROM century is such that the start of the time period is within 40 years of the start date of the journal.

The analysis starts at the first journal record in the first journal block on or after the indicated day.

time Indicates the 24-hour time in the format hh:mm[:ss]; ss defaults to 00.

The analysis starts at the first journal record in the first journal block on or after the indicated time of the first day of the journal. If the time value is less than the time of the first journal block, the analysis starts at the first journal record in the first journal block on or after the indicated time of the day after the first day of the journal.

yyddd time Indicates the date, in Julian format, where the FROM century is such that the start of the time period is within 40 years of the start date of the journal, and the 24-hour time in the format hh:mm[:ss] (where ss defaults to 00).

The analysis starts at the first journal record in the first journal block on or after the indicated time of the indicated day.

Note: This format cannot be passed as a command line program parameter under CMS, although it may be used in a SYSIN file record (see SYSIN). Under MVS, the format is:

...,PARM=' ... FROM=yyddd time ... '

Also see the TO parameter, which can be used to specify the end of the date/time range for analysis.

Regardless of any date range restriction specified by FROM or TO, SirAud examines the beginning part of the journal, through the following message: M204.0075: INITIALIZATION COMPLETED. BUFFERS = n. The histogram of journal record types will include totals from this initialization section of the journal as well as from the date range selected for analysis.

A date range can be useful to provide a reference for interpreting other measures of Model 204 activity. For example, SirTune can show ratios for running procedure A versus other procedures: Assume that a SirTune report over some busy time period shows procedure A using 11% of the CPU in that period, and then you change the procedure. After the changes, SirTune on a new busy period might show procedure A CPU goes up to 12%. One way to check the effectiveness of your changes is to use SirAud PROCREPT reports with date/time ranges to see if this increase in CPU correlates to an increased number of invocations between the two busy times.

FILERP and NOFILERP

The FILERP and NOFILERP parameters have two effects:

  • Forcing all report output to the SYSPRINT file
  • Producing (FILERP) or suppressing (NOFILERP) the FILEREPT report.

See ALLPR and NOPR for a discussion of these and the other report selection parameters.

MAXBLK parameter

Syntax:

MAXBLK = n

This parameter is used to specify the number of journal blocks to process.

NAMEOFF parameter

Syntax:

NAMEOFF = n

This can be used, under the direction of Technical Support, to facilitate running SirAud with newer releases of Model 204, compensating for changes in the journal format.

NCP parameter

Syntax:

NCP = 1-255

This parameter sets the number of channel programs to use for the input journal. A higher value can improve journal I/O performance. If this parameter not specified, the value specified in the JOURNAL DD statement is used, otherwise the default of 22 is used. Under CMS, this parameter is allowed but ignored, and the value is set to 1.

NFILES parameter

Syntax:

NFILES = n

This parameter is used to restrict the number of files summarized in FILEREPT to the top n files by total disk I/O.

NPROCS parameter

Syntax:

NPROCS = n

This parameter is used to restrict the number of procedures summarized in PROCREPT to the top n procedures by total CPU.

NSUBS parameter

Syntax:

NSUBS = n

This parameter is used to restrict the number of subsystems summarized in SUBREPT to the top n subsystems by total CPU.

NUTBLS parameter

Syntax:

NUTBLS = n

This parameter is used to restrict the number of subsystems summarized in UTBLREPT to the top n subsystems by server size.

NUSUMM parameter

Syntax:

NUSUMM = n

This parameter is used to restrict the number of subsystems summarized in UTBLSUMM to the top n subsystems by server size.

PERFRP and NOPERFRP parameters

The PERFRP and NOPERFRP parameters have two effects:

  • Forcing all report output to the SYSPRINT file
  • Producing (PERFRP) or suppressing (NOPERFRP) the PERFREPT report.

See ALLPR and NOPR for a discussion of these and the other report selection parameters.

PROCRP and NOPROCRP parameters

The PROCRP and NOPROCRP parameters have two effects:

  • Forcing all report output to the SYSPRINT file
  • Producing (PROCRP) or suppressing (NOPROCRP) the PROCREPT report.

See ALLPR and NOPR for a discussion of these and the other report selection parameters.

SKIPBLK parameter

Syntax:

SKIPBLK = n

This parameter is used to specify a number of journal blocks to skip.

SUBRP and NOSUBRP parameters

The SUBRP and NOSUBRP parameters have two effects:

  • Forcing all report output to the SYSPRINT file
  • Producing (SUBRP) or suppressing (NOSUBRP) the SUBREPT report.

See ALLPR and NOPR for a discussion of these and the other report selection parameters.

TO parameter

Syntax:

TO = yyddd | time | yyddd time

This parameter is used to restrict the analysis of the journal to those journal blocks that contain records that are at the indicated date and time. If the time on the journal block's header is less than or equal to the TO specification, the records in that block are included in the report analysis. Consequently, some records that are later than the TO setting may be included.

The TO parameter options are:

yyddd Indicates the date, in Julian format, where the TO century is such that the end of the time period is within 40 years of the start date of the journal.

The analysis ends with the last journal record in the last journal block on or before the indicated day.

time Indicates the 24-hour time in the hh:mm[:ss] format; ss defaults to 59.

The analysis ends with the last journal record in the last journal block on or before the indicated time of the starting day of analysis. If the time value is less than the starting time of analysis, the analysis ends with the last journal record in the last journal block on or before the indicated time of the day after the starting day of analysis.

The starting date and time of analysis is specified by the FROM parameter, if present, and otherwise is the date and time at the start of the journal.

yyddd time Indicates the date, in Julian format, where the TO century is such that the end of the time period is within 40 years of the start date of the journal, and the 24-hour time in the format hh:mm[:ss]; ss defaults to 59.

The analysis ends with the last journal record in the last journal block on or before the indicated time of the indicated day.

Note: This format cannot be passed as a command line program parameter under CMS, although it may be used in a SYSIN file record (see SYSIN).

Under MVS, the format is:

...,PARM=' ... TO=yyddd time ... '

Also see the FROM parameter, which can be used to specify the start of the date/time range for analysis. The description there also provides an example of one benefit of date/time range selection with SirAud.

UTBLRANG parameter

Syntax:

UTBLRANG = n

This parameter is used to specify the number of standard deviations a server table highwater mark for an individual procedure is allowed to vary from the mean for the subsystem before the procedure is flagged for UTBLREPT.

The default is 2.

UTBLRP and NOUTBLRP parameters

The UTBLRP and NOUTBLRP parameters have two effects:

  • Forcing all report output to the SYSPRINT file
  • Producing (UTBLRP) or suppressing (NOUTBLRP) the UTBLREPT report.

See ALLPR and NOPR for a discussion of these and the other report selection parameters.

UTBLSM and NOUTBLSM parameters

The UTBLSM and NOUTBLSM parameters have two effects:

  • Forcing all report output to the SYSPRINT file
  • Producing (UTBLSM) or suppressing (NOUTBLSM) the UTBLSUMM report.

See ALLPR and NOPR for a discussion of these and the other report selection parameters.

You can change some of the SirAud defaults by applying zaps any time after you have installed the load module. This page contains the customizations you can perform.

SirAud default customization

ALLPR parameter customization

Apply the following zap to make the ALLPR parameter the default:

NAME SIRAUD JCUST VER 08 00 REP 08 80 ALLPR is default

See also