SirAud parameters - Revision history

Tom: /* NCP parameter */

2022-02-24T21:38:44Z

NCP parameter

← Older revision		Revision as of 21:38, 24 February 2022
Line 147:		Line 147:

	This parameter sets the number of channel programs to use for the input journal.		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.		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==

Tom: /* NCP parameter */

2022-02-24T21:37:28Z

NCP parameter

← Older revision		Revision as of 21:37, 24 February 2022
Line 147:		Line 147:

	This parameter sets the number of channel programs to use for the input journal.		This parameter sets the number of channel programs to use for the input journal.
	A higher value can improve 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.		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.

	==NFILES parameter==		==NFILES parameter==

Tom: /* NCP parameter */

2022-02-24T16:01:38Z

NCP parameter

← Older revision		Revision as of 16:01, 24 February 2022
Line 147:		Line 147:

	This parameter sets the number of channel programs to use for the input journal.		This parameter sets the number of channel programs to use for the input journal.
	A higher value can improve 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.		A higher value can improve 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.

	==NFILES parameter==		==NFILES parameter==

Tom at 15:59, 24 February 2022

2022-02-24T15:59:40Z

← Older revision		Revision as of 15:59, 24 February 2022
Line 141:		Line 141:
	to facilitate running <var class="product">SirAud</var> with newer releases of <var class="product">Model 204</var>,		to facilitate running <var class="product">SirAud</var> with newer releases of <var class="product">Model 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 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.

	==NFILES parameter==		==NFILES parameter==

Admin: /* ALLPR and NOPR */ link repair

2016-10-24T20:26:18Z

ALLPR and NOPR: link repair

← Older revision		Revision as of 20:26, 24 October 2016
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==

JAL: add "SirAud default customization"

2016-10-24T20:20:31Z

add "SirAud default customization"

@@ Line 18: / Line 18: @@
 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==
@@ Line 278: / Line 278: @@
 See [[#allpr|ALLPR and NOPR]] for a discussion of these and the other
 report selection parameters.
 ==See also==

JAL: add links

2016-10-13T21:39:12Z

add links

← Older revision		Revision as of 21:39, 13 October 2016
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 146:		Line 146:
	<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 154:

	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 161:

	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 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
	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 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
	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 181:
	<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 190:
	<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 205:
	<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 255:
	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 263:
	<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 273:
	<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>

JAL: misc cleanup

2016-10-12T20:12:33Z

misc cleanup

Show changes

Admin: 1 revision: SirAud pages

2016-10-10T23:00:37Z

1 revision: SirAud pages

← Older revision	Revision as of 23:00, 10 October 2016
(No difference)

JAL: add "topics"

2016-10-10T21:27:29Z

add "topics"

New page

<var class="product">SirAud</var> has a set of parameters you can use to restrict the size of some
reports or otherwise configure the <var class="product">SirAud</var> run.
These parameters must be provided in either of these ways:
<ul>
<li>As a PARM on the EXEC card in MVS, for example:
<nowiki>//SIRAUD EXEC PGM=SIRAUD,PARM='NSUBS=10 ALLPR'
</nowiki>

<li>As options on the M204CMS command in CMS, for example:
<nowiki>M204CMS SIRAUD ( NSUBS 10 ALLPR %
</nowiki>
</ul>

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

This page describes the parameter settings that are available for <var class="product">SirAud</var>.
Note: You can change the default setting for some of the parameters; see [[Customization of defaults]]. 

==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 <var class="product">SirAud</var> to be written to the SYSPRINT output file, rather than
having each of <var class="product">SirAud</var>'s reports written to a separate output file.
If any report selection parameter is specified, all of the <var class="product">SirAud</var>
report output is written to SYSPRINT, and only to there.

The report selection parameters are ALLPR, NOPR, and the following:
<ul>
<li>FILERP and NOFILERP
<li>PERFRP and NOPERFRP
<li>PROCRP and NOPROCRP
<li>SUBRP and NOSUBRP
<li>UTBLRP and NOUTBLRP
<li>UTBLSM and NOUTBLSM
</ul>
Any of the above individual report parameters beginning with <code>NO</code> is called the "negative" form of
the parameter, and it indicates that the given report should not be produced
The form without <code>NO</code> 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 UTBLR in this example is superfluous):
PARM=(NOPROCRP,UTBLRP)


You may customize your <var class="product">SirAud</var> load module so that ALLPR is the default; see
[[Customization of defaults#cszallp|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:
<table>
<tr><th>yyddd</th>
<td>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.</td></tr>

<tr><th>time</th><td>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 <code>time</code> 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.</td></tr>

<tr><th nowrap>yyddd time</th>
<td>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.
<blockquote class="note">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 [[Additional SirAud files#sysin|SYSIN]]). Under MVS, the format is:
...,PARM=' ... FROM=yyddd time ... '

</blockquote></td></tr>
</table>

Also see the [[#toparm|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, <var class="product">SirAud</var> examines the beginning part of the journal, through the following message:
<code>M204.0075: INITIALIZATION COMPLETED. BUFFERS = n</code>.
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 <var class="product">Model 204</var> activity.
For example, <var class="product">[[SirTune]]</var> can show ratios for running procedure A versus other procedures:
Assume that a <var class="product">SirTune</var> 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, <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
<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.

==FILERP and NOFILERP==
The FILERP and NOFILERP parameters have two effects:
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Producing (FILERP) or suppressing (NOFILERP) the FILEREPT report.
</ul>

See [[#allpr|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 <var class="product">SirAud</var> with newer releases of <var class="product">Model 204</var>,
compensating for changes in the journal format.

==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 <var class="term">n</var> subsystems by server size.

==PERFRP and NOPERFRP parameters==
The PERFRP and NOPERFRP parameters have two effects:
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Producing (PERFRP) or suppressing (NOPERFRP) the PERFREPT report.
</ul>

See [[#allpr|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:
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Producing (PROCRP) or suppressing (NOPROCRP) the PROCREPT report.
</ul>

See [[#allpr|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:
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Producing (SUBRP) or suppressing (NOSUBRP) the SUBREPT report.
</ul>

See [[#allpr|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:
<table>
<tr><th>yyddd</th>
<td>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.</td></tr>

<tr><th>time</th>
<td>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 <code>time</code> 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.</td></tr>

<tr><th nowrap>yyddd time</th>
<td>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.

<blockquote class="note">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 [[Additional SirAud files#sysin|SYSIN]]).
Under MVS, the format is:
...,PARM=' ... TO=yyddd time ... '

</blockquote></td></tr>
</table>

Also see the [[#from|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 <var class="product">SirAud</var>.

==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:
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Producing (UTBLRP) or suppressing (NOUTBLRP) the UTBLREPT report.
</ul>

See [[#allpr|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:
<ul>
<li>Forcing all report output to the SYSPRINT file
<li>Producing (UTBLSM) or suppressing (NOUTBLSM) the UTBLSUMM report.
</ul>

See [[#allpr|ALLPR and NOPR]] for a discussion of these and the other
report selection parameters.

==See also==
{{Template:SirAud topic list}}

[[Category:SirAud]]