SirTune introduction: Difference between revisions
m (1 revision: SirTune doc) |
m (minor cleanup) |
||
| 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 9: | Line 9: | ||
This is accomplished in two stages: | This is accomplished in two stages: | ||
<ol> | <ol> | ||
<li>Data is collected in a running | <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 | 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 | 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== | ||
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== | ||
<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 | 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 | <li>The <var class="product">SirTune</var> data collector is integrated with the [[Sirius Mods]], | ||
and you <b>must</b> install the | 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> | ||
Revision as of 17:51, 2 July 2015
The primary function of SirTune is to provide information
to User Language (SOUL) programmers to make it easy for them to
improve the performance of their programs.
This is accomplished in two stages:
- Data is collected in a running Online region.
This data is obtained by "polling."
That is, at regular intervals SirTune examines the state of the Online.
region and records data pertinent to this state.
The part of SirTune that collects this data is called the data collection portion, which was integrated with the Sirius Mods prior to version 7.5 of Model 204.
Occasionally in this document, the product name "SirTune" is also used to refer to just the data collection portion of the product.
- 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.
These problem areas can generally be refined to an arbitrary level of
detail (for example, individual lines of code in a procedure).
The part of SirTune that summarizes and produces reports is called the reporting portion, which consists of a User Language program named SIRTUNEREPORT, distributed in the SIRIUS file as part of UL/SPF.
Versions
The SirTune documentation assumes that a site is running SirTune version 7.4 or later. Any documented feature or facility that requires a later version of SirTune will be clearly marked to indicate this.
For example, a statement that is only available in versions 7.5 and later of SirTune will have a sentence in its documentation such as, "This statement is only available in version 7.5 or later of SirTune." If a feature or parameter is not indicated as requiring any specific version of the SirTune, it can be assumed that it is available in all versions covered by this document: that is, versions 7.4 and later of SirTune.
System requirements
SirTune requires the following components to run:
- Mainframe operating systems — one of the following:
- z/OS
- CMS (releases currently supported by IBM) under z/VM
- Model 204 V6R1 or later, running in its Online or IFAM4 configuration.
- For versions of SirTune after 7.0:
- The SirTune data collector is integrated with the Sirius Mods, and you must install the Sirius Mods.
- The UL/SPF file SIRIUS must be downloaded to make the SIRTUNEREPORT program available for reporting.
SirTune topics
The SirTune 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 SirTune version, see the release notes.
For information about product error messages, see SirTune data collector messages.
- SirTune introduction
- SirTune data collection under MVS
- SirTune data collection under CMS
- SirTune data collection statements
- SirTune MODIFY and SMSG commands
- SirTune report generation
- SirTune reports
- SirTune user states
- SirTune and Model 204 quad types
- SirTune statement wildcards
- SirTune date processing