SirTune introduction - Revision history

JAL: use template for installation info

2017-08-11T19:43:49Z

use template for installation info

@@ Line 33: / Line 33: @@
 ==Installation==
-SirTune consists of an object file (for data collecting) as well as SOUL files (for reporting).
+{{Template:SirTune installation}}
 ==SirTune topics==

JAL: add the installation page content

2017-08-11T19:30:39Z

add the installation page content

@@ Line 18: / Line 18: @@
 The part of <var class="product">SirTune</var> that summarizes and produces reports is called the <b>reporting</b> portion, the <code>SIRTUNEREPORT</code> SOUL program, distributed in the <var class="product">[[RKTools]]</var> <code>SIRIUS</code> file (prior to RKTools 7.7) or the <code>M204PROC</code> file (as of RKTools 7.7).</p></li>
 </ol>
 ==System requirements==
 <var class="product">SirTune</var> requires the following components to run:
 <ul>
-<li>Mainframe operating systems &mdash; one of the following:</li>
+<li>Mainframe operating systems &mdash; one of the following:
 <ul>
 <li>z/OS</li>
@@ Line 40: / Line 30: @@
 <li><var class="product">Model 204</var> V6R1 or later, running
 in its Online or IFAM4 configuration.</li>
-<li>For versions of <var class="product">SirTune</var> after 7.0:</li>
+==Installation==
 <ul>
-<li>The <var class="product">SirTune</var> data collector is integrated with the <var class="product">Sirius Mods</var>, and you <b>must</b> install the <var class="product">Sirius Mods</var>.</li>
+<li>If your site uses <var class="product">RKTools</var>, verify that file <code>SIRIUS</code> or <code>M204PROC</code> contains the program <code>SIRTUNEREPORT</code>. If the RKTools version is 7.7 or higher, you can use the [[RKWeb]] interface to view SirTune report output on your browser. [[RKTools installation]] has information about RKTools and RKWeb installation. </li>
-<li>The <var class="product">RKTools</var> [[SIRIUS file|file SIRIUS]] must be downloaded to make the <code>SIRTUNEREPORT</code> program available for reporting.</li>
+<li>On the [http://m204.rocketsoftware.com/ Rocket M204 Customer Care] page, find the appropriate row for your version of RKTools, and click the "Download Procfile" link. </li>
-</ul></li>
+</ol>
 </ul>

JAL: add M204PROC info

2017-06-08T00:13:19Z

add M204PROC info

← Older revision		Revision as of 00:13, 8 June 2017
Line 1:		Line 1:
	~~<!--Page automatically generated by CMSTOWIK EXEC and will be~~		The primary function of <var class="product">SirTune</var> is to provide information to User Language ([[SOUL]]) programmers to make it easy for them to
	automatically replaced -- any manual edits will be lost.
	~~You've been warned. .. (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->~~
	~~<!-- Page name: SirTune introduction-->~~
	The primary function of <var class="product">SirTune</var> is to provide information
	to User Language ([[SOUL]]) programmers to make it easy for them to
	improve the performance of their programs.		improve the performance of their programs.
	This is accomplished in two stages:		This is accomplished in two stages:
Line 21:		Line 16:
	detail (for example, individual lines of code in a procedure).		detail (for example, individual lines of code in a procedure).
	<p>		<p>
	The part of <var class="product">SirTune</var> that summarizes and produces reports is called the <b>reporting</b> portion, ~~which consists of a SOUL program named~~ <code>SIRTUNEREPORT</code>, distributed in the ~~<code>SIRIUS</code> file as part of~~ <var class="product">[[RKTools]]</var>.</p></li>		The part of <var class="product">SirTune</var> that summarizes and produces reports is called the <b>reporting</b> portion, the <code>SIRTUNEREPORT</code> SOUL program, distributed in the <var class="product">[[RKTools]]</var> <code>SIRIUS</code> file (prior to RKTools 7.7) or the <code>M204PROC</code> file (as of RKTools 7.7).</p></li>
	</ol>		</ol>

JAL: link repair

2017-04-18T15:00:39Z

link repair

← Older revision		Revision as of 15:00, 18 April 2017
Line 60:		Line 60:
	For information about product changes and Model 204 feature		For information about product changes and Model 204 feature
	support per <var class="product">SirTune</var> version, see		support per <var class="product">SirTune</var> version, see
	the [[M204wiki main page#Release notes~~, wishlists, and punch lists~~\|release notes]].		the [[M204wiki main page#Release notes\|release notes]].

	For information about product error messages, see [[:Category:SirTune data collector messages\|SirTune data collector messages]].		For information about product error messages, see [[:Category:SirTune data collector messages\|SirTune data collector messages]].

JAL: /* System requirements */ add link

2017-02-27T18:54:38Z

System requirements: add link

← Older revision		Revision as of 18:54, 27 February 2017
Line 50:		Line 50:
	<li>The <var class="product">SirTune</var> data collector is integrated with the <var class="product">Sirius Mods</var>, and you <b>must</b> install the <var class="product">Sirius Mods</var>.</li>		<li>The <var class="product">SirTune</var> data collector is integrated with the <var class="product">Sirius Mods</var>, and you <b>must</b> install the <var class="product">Sirius Mods</var>.</li>

	<li>The <var class="product">RKTools</var> file ~~<code>~~SIRIUS~~</code>~~ must be downloaded to make the <code>SIRTUNEREPORT</code> program available for reporting.</li>		<li>The <var class="product">RKTools</var> [[SIRIUS file\|file SIRIUS]] must be downloaded to make the <code>SIRTUNEREPORT</code> program available for reporting.</li>
	</ul></li>		</ul></li>
	</ul>		</ul>

JAL: RKTools replaces UL/SPF

2015-10-23T22:24:24Z

RKTools replaces UL/SPF

← Older revision		Revision as of 22:24, 23 October 2015
Line 21:		Line 21:
	detail (for example, individual lines of code in a procedure).		detail (for example, individual lines of code in a procedure).
	<p>		<p>
	The part of <var class="product">SirTune</var> that summarizes and produces reports is called the <b>reporting</b> portion, which consists of a SOUL program named <code>SIRTUNEREPORT</code>, distributed in the <code>SIRIUS</code> file as part of <var class="product">~~UL/SPF~~</var>.</p></li>		The part of <var class="product">SirTune</var> that summarizes and produces reports is called the <b>reporting</b> portion, which consists of a SOUL program named <code>SIRTUNEREPORT</code>, distributed in the <code>SIRIUS</code> file as part of <var class="product">[[RKTools]]</var>.</p></li>
	</ol>		</ol>

Line 50:		Line 50:
	<li>The <var class="product">SirTune</var> data collector is integrated with the <var class="product">Sirius Mods</var>, and you <b>must</b> install the <var class="product">Sirius Mods</var>.</li>		<li>The <var class="product">SirTune</var> data collector is integrated with the <var class="product">Sirius Mods</var>, and you <b>must</b> install the <var class="product">Sirius Mods</var>.</li>

	<li>The <var class="product">~~UL/SPF~~</var> file <code>SIRIUS</code> must be downloaded to make the <code>SIRTUNEREPORT</code> program available for reporting.</li>		<li>The <var class="product">RKTools</var> file <code>SIRIUS</code> must be downloaded to make the <code>SIRTUNEREPORT</code> program available for reporting.</li>
	</ul></li>		</ul></li>
	</ul>		</ul>

JAL: misc formatting

2015-07-16T16:38:21Z

misc formatting

← Older revision		Revision as of 16:38, 16 July 2015
Line 10:		Line 10:
	<li>Data is collected in a running Online region.		<li>Data is collected in a running Online region.
	This data is obtained by "polling."		This data is obtained by "polling."
	That is, at regular intervals <var class="product">SirTune</var> examines the state of the Online.		That is, at regular intervals <var class="product">SirTune</var> examines the state of the Online region and records data pertinent to this state.
	region and records data pertinent to this state.
	<p>		<p>
	The part of <var class="product">SirTune</var> that collects this data is called the		The part of <var class="product">SirTune</var> that collects this data is called the
	<b~~><i~~>data collection~~</i>~~</b> portion, which		<b>data collection</b> portion, which was integrated with the [[Sirius Mods]] prior to version 7.5 of <var class="product">Model 204</var>.</p>
	was integrated with the [[Sirius Mods]] prior to version 7.5 of <var class="product">Model 204</var>.</p>
	<p>		<p>
	Occasionally in the SirTune documentation, the product name "<var class="product">SirTune</var>" is also used to refer to just the data collection portion of the product.</li>		Occasionally in the SirTune documentation, the product name "<var class="product">SirTune</var>" is also used to refer to just the data collection portion of the product.</p></li>

	<li>After this data is collected, it is summarized and presented in a set of reports that indicate to a SOUL programmer the potential performance problem areas.		<li>After this data is collected, it is summarized and presented in a set of reports that indicate to a SOUL programmer the potential performance problem areas.
	These problem areas can generally be refined to an arbitrary level of		These problem areas can generally be refined to an arbitrary level of
	detail (for example, individual lines of code in a procedure).~~</p>~~		detail (for example, individual lines of code in a procedure).
	<p>		<p>
	The part of <var class="product">SirTune</var> that summarizes and produces reports is called the		The part of <var class="product">SirTune</var> that summarizes and produces reports is called the <b>reporting</b> portion, which consists of a SOUL program named <code>SIRTUNEREPORT</code>, distributed in the <code>SIRIUS</code> file as part of <var class="product">UL/SPF</var>.</p></li>
	<b~~><i~~>reporting~~</i>~~</b> portion, which consists of a SOUL program named SIRTUNEREPORT, distributed in the SIRIUS file as part of <var class="product">UL/SPF</var>.</p></li>
	</ol>		</ol>

Line 51:		Line 48:
	<li>For versions of <var class="product">SirTune</var> after 7.0:</li>		<li>For versions of <var class="product">SirTune</var> after 7.0:</li>
	<ul>		<ul>
	<li>The <var class="product">SirTune</var> data collector is integrated with the [[Sirius Mods]],		<li>The <var class="product">SirTune</var> data collector is integrated with the <var class="product">Sirius Mods</var>, and you <b>must</b> install the <var class="product">Sirius Mods</var>.</li>
	and you <b>must</b> install the Sirius Mods.</li>

	<li>The <var class="product">UL/SPF</var> file SIRIUS must be downloaded to make the SIRTUNEREPORT		<li>The <var class="product">UL/SPF</var> file <code>SIRIUS</code> must be downloaded to make the <code>SIRTUNEREPORT</code> program available for reporting.</li>
	program available for reporting.</li>
	</ul></li>		</ul></li>
	</ul>		</ul>

JAL: minor cleanup

2015-07-02T18:05:48Z

minor cleanup

JAL: minor formatting

2015-07-02T18:02:50Z

minor formatting

← Older revision		Revision as of 18:02, 2 July 2015
Line 3:		Line 3:
	You've been warned. .. (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->		You've been warned. .. (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->
	<!-- Page name: SirTune introduction-->		<!-- Page name: SirTune introduction-->

	The primary function of <var class="product">SirTune</var> is to provide information		The primary function of <var class="product">SirTune</var> is to provide information
	to User Language (SOUL) programmers to make it easy for them to		to User Language (SOUL) programmers to make it easy for them to
Line 13:		Line 12:
	That is, at regular intervals <var class="product">SirTune</var> examines the state of the Online.		That is, at regular intervals <var class="product">SirTune</var> examines the state of the Online.
	region and records data pertinent to this state.		region and records data pertinent to this state.
	<~~p></~~p>		<p>
	The part of <var class="product">SirTune</var> that collects this data is called the		The part of <var class="product">SirTune</var> that collects this data is called the
	<b><i>data collection</i></b> portion, which		<b><i>data collection</i></b> portion, which
	was integrated with the [[Sirius Mods]] prior to version 7.5 of <var class="product">Model 204</var>.		was integrated with the [[Sirius Mods]] prior to version 7.5 of <var class="product">Model 204</var>.</p>
	<p></p>		<p>
	Occasionally in this document, the product name "<var class="product">SirTune</var>" is also		Occasionally in this document, the product name "<var class="product">SirTune</var>" is also
	used to refer to just the data collection portion of the product.		used to refer to just the data collection portion of the product.</li>
	<li>After this data is collected, it is summarized and presented
	in a set of reports that indicate to a User Language programmer the		<li>After this data is collected, it is summarized and presented in a set of reports that indicate to a User Language programmer the potential performance problem areas.
	potential performance problem areas.
	These problem areas can generally be refined to an arbitrary level of		These problem areas can generally be refined to an arbitrary level of
	detail (for example, individual lines of code in a procedure).		detail (for example, individual lines of code in a procedure).</p>
	<p></p>		<p>
	The part of <var class="product">SirTune</var> that summarizes and produces reports is called the		The part of <var class="product">SirTune</var> that summarizes and produces reports is called the
	<b><i>reporting</i></b> portion, which consists of a User Language program		<b><i>reporting</i></b> portion, which consists of a User Language program named SIRTUNEREPORT, distributed in the SIRIUS file as part of <var class="product">UL/SPF</var>.</p></li>
	named SIRTUNEREPORT, distributed in the SIRIUS file as part of <var class="product">UL/SPF</var>.
	</ol>		</ol>

Line 35:		Line 32:
	Any documented feature or facility that requires a later version		Any documented feature or facility that requires a later version
	of <var class="product">SirTune</var> will be clearly marked to indicate this.		of <var class="product">SirTune</var> will be clearly marked to indicate this.
	~~<p></p>~~
	For example, a statement that is only available in versions 7.5 and		For example, a statement that is only available in versions 7.5 and
	later of <var class="product">SirTune</var> will have a sentence in its documentation		later of <var class="product">SirTune</var> will have a sentence in its documentation
	such as, "This statement		such as, "This statement is only available in version 7.5 or later of <var class="product">SirTune</var>."
	is only available in version 7.5 or later of <var class="product">SirTune</var>."		If a feature or parameter is not indicated as requiring any specific version of the <var class="product">SirTune</var>, it can be assumed that it is available in all versions covered by this
	If a feature or parameter is not
	indicated as requiring any specific version of the <var class="product">SirTune</var>, it can
	be assumed that it is available in all versions covered by this
	document: that is, versions 7.4 and later of <var class="product">SirTune</var>.		document: that is, versions 7.4 and later of <var class="product">SirTune</var>.

Admin: minor cleanup

2015-07-02T17:51:42Z

minor cleanup

← Older revision		Revision as of 17:51, 2 July 2015
Line 3:		Line 3:
	You've been warned. .. (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->		You've been warned. .. (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->
	<!-- Page name: SirTune introduction-->		<!-- Page name: SirTune introduction-->
	~~<p></p>~~
	The primary function of <var class="product">SirTune</var> is to provide information		The primary function of <var class="product">SirTune</var> is to provide information
	to User Language (SOUL) programmers to make it easy for them to		to User Language (SOUL) programmers to make it easy for them to
Line 9:		Line 9:
	This is accomplished in two stages:		This is accomplished in two stages:
	<ol>		<ol>
	<li>Data is collected in a running ~~&ONLINE.~~ region.		<li>Data is collected in a running Online region.
	This data is obtained by "polling."		This data is obtained by "polling."
	That is, at regular intervals <var class="product">SirTune</var> examines the state of the ~~&ONLINE~~.		That is, at regular intervals <var class="product">SirTune</var> examines the state of the Online.
	region and records data pertinent to this state.		region and records data pertinent to this state.
	<p></p>		<p></p>
	The part of <var class="product">SirTune</var> that collects this data is called the		The part of <var class="product">SirTune</var> that collects this data is called the
	<b><i>data collection</i></b> portion, which		<b><i>data collection</i></b> portion, which
	was integrated with the ~~&SIRMODS.~~ prior to version 7.5 of <var class="product">Model 204</var>.		was integrated with the [[Sirius Mods]] prior to version 7.5 of <var class="product">Model 204</var>.
	<p></p>		<p></p>
	Occasionally in this document, the product name "<var class="product">SirTune</var>" is also		Occasionally in this document, the product name "<var class="product">SirTune</var>" is also
Line 30:		Line 30:
	named SIRTUNEREPORT, distributed in the SIRIUS file as part of <var class="product">UL/SPF</var>.		named SIRTUNEREPORT, distributed in the SIRIUS file as part of <var class="product">UL/SPF</var>.
	</ol>		</ol>

	==Versions==		==Versions==
	~~This document, the <i>Rocket Model 204~~ SirTune ~~Reference Manual</i>,~~		The SirTune documentation assumes that a site is running <var class="product">SirTune</var> version 7.4 or later.
	assumes that a site is running <var class="product">SirTune</var> version 7.4 or later.
	Any documented feature or facility that requires a later version		Any documented feature or facility that requires a later version
	of <var class="product">SirTune</var> will be clearly marked to indicate this.		of <var class="product">SirTune</var> will be clearly marked to indicate this.
Line 44:		Line 44:
	be assumed that it is available in all versions covered by this		be assumed that it is available in all versions covered by this
	document: that is, versions 7.4 and later of <var class="product">SirTune</var>.		document: that is, versions 7.4 and later of <var class="product">SirTune</var>.

	==System requirements==		==System requirements==
	~~<p></p>~~
	<var class="product">SirTune</var> requires the following components to run:		<var class="product">SirTune</var> requires the following components to run:
	<ul>		<ul>
	<li>Mainframe operating systems — one of the following:		<li>Mainframe operating systems — one of the following:</li>
	<ul>		<ul>
	<li>z/OS		<li>z/OS</li>
	<li>CMS (releases currently supported by IBM) under z/VM		<li>CMS (releases currently supported by IBM) under z/VM</li>
	</ul>		</ul></li>

	<li><var class="product">Model 204</var> V6R1 or later, running		<li><var class="product">Model 204</var> V6R1 or later, running
	in its ~~&ONLINE.~~ or &IFAM4. configuration.		in its Online or IFAM4 configuration.</li>
	<li>For versions of <var class="product">SirTune</var> after 7.0:
			<li>For versions of <var class="product">SirTune</var> after 7.0:</li>
	<ul>		<ul>
	<li>The <var class="product">SirTune</var> data collector is integrated with the ~~&SIRMODS.~~,		<li>The <var class="product">SirTune</var> data collector is integrated with the [[Sirius Mods]],
	and you <b>must</b> install the ~~&SIRMODS.~~.		and you <b>must</b> install the Sirius Mods.</li>

	<li>The <var class="product">UL/SPF</var> file SIRIUS must be downloaded to make the SIRTUNEREPORT		<li>The <var class="product">UL/SPF</var> file SIRIUS must be downloaded to make the SIRTUNEREPORT
	program available for reporting.		program available for reporting.</li>
	</ul>		</ul></li>
	</ul>		</ul>

← Older revision		Revision as of 18:05, 2 July 2015
Line 4:		Line 4:
	<!-- Page name: SirTune introduction-->		<!-- Page name: SirTune introduction-->
	The primary function of <var class="product">SirTune</var> is to provide information		The primary function of <var class="product">SirTune</var> is to provide information
	to User Language (SOUL) programmers to make it easy for them to		to User Language ([[SOUL]]) programmers to make it easy for them to
	improve the performance of their programs.		improve the performance of their programs.
	This is accomplished in two stages:		This is accomplished in two stages:
Line 17:		Line 17:
	was integrated with the [[Sirius Mods]] prior to version 7.5 of <var class="product">Model 204</var>.</p>		was integrated with the [[Sirius Mods]] prior to version 7.5 of <var class="product">Model 204</var>.</p>
	<p>		<p>
	Occasionally in ~~this document~~, the product name "<var class="product">SirTune</var>" is also		Occasionally in the SirTune documentation, the product name "<var class="product">SirTune</var>" is also used to refer to just the data collection portion of the product.</li>
	used to refer to just the data collection portion of the product.</li>

	<li>After this data is collected, it is summarized and presented in a set of reports that indicate to a ~~User Language~~ programmer the potential performance problem areas.		<li>After this data is collected, it is summarized and presented in a set of reports that indicate to a SOUL programmer the potential performance problem areas.
	These problem areas can generally be refined to an arbitrary level of		These problem areas can generally be refined to an arbitrary level of
	detail (for example, individual lines of code in a procedure).</p>		detail (for example, individual lines of code in a procedure).</p>
	<p>		<p>
	The part of <var class="product">SirTune</var> that summarizes and produces reports is called the		The part of <var class="product">SirTune</var> that summarizes and produces reports is called the
	<b><i>reporting</i></b> portion, which consists of a ~~User Language~~ program named SIRTUNEREPORT, distributed in the SIRIUS file as part of <var class="product">UL/SPF</var>.</p></li>		<b><i>reporting</i></b> portion, which consists of a SOUL program named SIRTUNEREPORT, distributed in the SIRIUS file as part of <var class="product">UL/SPF</var>.</p></li>
	</ol>		</ol>

	==Versions==		==Versions==
	The SirTune documentation assumes that a site is running <var class="product">SirTune</var> version 7.4 or later.		The SirTune documentation assumes that a site is running <var class="product">SirTune</var> version 7.4 or later. Any documented feature or facility that requires a later version
	Any documented feature or facility that requires a later version
	of <var class="product">SirTune</var> will be clearly marked to indicate this.		of <var class="product">SirTune</var> will be clearly marked to indicate this.