SirTune introduction: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (add the installation page content)
m (use template for installation info)
 
Line 33: Line 33:


==Installation==
==Installation==
SirTune consists of an object file (for data collecting) as well as SOUL files (for reporting).
{{Template:SirTune installation}}
As of SirTune 7.1, the object code  was integrated into [[Sirius Mods]], and as of Model 204 7.5, Sirius Mods was integrated into the Model 204 nucleus. Thus, if you are running Model 204 7.5 or later and you are authorized to use SirTune, the necessary object code is already installed into Model 204.
 
In addition to the object code, you need to download and install the SirTune SOUL files to run SirTune reports, and this is covered in the following section.”
 
===SirTune object file===
If you are running a pre-7.5 version of Model 204 and want to refresh the SirTune object file, you can download the "Sirius Mods" object file from the Rocket Software
website "Rocket M204 Customer Care" page ([http://m204.rocketsoftware.com/ http://m204.rocketsoftware.com]).
 
The SirTune object file is integrated into the Sirius Mods object file <i>until</i> Model&nbsp;204 7.5; thereafter it is part of the Model&nbsp;204 object.
The download process requires a Model&nbsp;204 user ID and password.
<ol>
<li>On the "Rocket M204 Customer Care" page, go to the "Downloads and Uploads" section and click the "Download object files" link.
<p>
After providing Model&nbsp;204 login credentials, you access the "Download object files" page, which contains a dynamically-generated list of the various Model&nbsp;204 object files that you are authorized to download. </p></li>
 
<li>Select the Sirius Mods row for the version you require, and click the "Download object file" link. </li>
</ol>
 
===SirTune SOUL files===
SirTune report generation is performed by a [[SOUL]] program
that is distributed as part of the <var class="product">[[RKTools]]</var> product family in the <code>SIRIUS</code> file (for versions of RKTools prior to 7.7) or the <code>M204PROC</code> file (as of RKTools 7.7).
<ul>
<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>If your site is not licensed for <var class="product">RKTools</var>, you are still authorized (as a user of <var class="product">SirTune</var>) to download the <code>SIRIUS</code> or <code>M204PROC</code> file.
You can download the file from the Rocket website:
<ol>
<li>On the "SOUL files" page, click the "SOUL files" link in the "Downloads and Uploads" section. </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>
</ol>
<p>
You don't need to do the entire <var class="product">RKTools</var> installation: just download and restore the <code>SIRIUS</code> or <code>M204PROC</code> file, and make it available to your [[SirTune reports|SirTune report]] jobs. </p></li>
</ul>


==SirTune topics==
==SirTune topics==

Latest revision as of 19:43, 11 August 2017

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:

  1. 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 the SirTune documentation, the product name "SirTune" is also used to refer to just the data collection portion of the product.

  2. 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 detail (for example, individual lines of code in a procedure).

    The part of SirTune that summarizes and produces reports is called the reporting portion, the SIRTUNEREPORT SOUL program, distributed in the RKTools SIRIUS file (prior to RKTools 7.7) or the M204PROC file (as of RKTools 7.7).

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.

Installation

SirTune consists of an object file (for data collecting) as well as SOUL files (for reporting). As of SirTune 7.1, the object code was integrated into Sirius Mods, and as of Model 204 7.5, Sirius Mods was integrated into the Model 204 nucleus. Thus, if you are running Model 204 7.5 or later and you are authorized to use SirTune, the necessary object code is already installed into Model 204.

In addition to the object code, you need to download and install the SirTune SOUL files to run SirTune reports, and this is covered in the following section.

SirTune object file

If you are running a pre-7.5 version of Model 204 and want to refresh the SirTune object file, you can download the "Sirius Mods" object file from the Rocket Software website "Rocket M204 Customer Care" page (http://m204.rocketsoftware.com).

The SirTune object file is integrated into the Sirius Mods object file until Model 204 7.5; thereafter it is part of the Model 204 object. The download process requires a Model 204 user ID and password.

  1. On the "Rocket M204 Customer Care" page, go to the "Downloads and Uploads" section and click the "Download object files" link.

    After providing Model 204 login credentials, you access the "Download object files" page, which contains a dynamically-generated list of the various Model 204 object files that you are authorized to download.

  2. Select the Sirius Mods row for the version you require, and click the "Download object file" link.

SirTune SOUL files

SirTune report generation is performed by a SOUL program that is distributed as part of the RKTools product family in the SIRIUS file (for versions of RKTools prior to 7.7) or the M204PROC file (as of RKTools 7.7).

  • If your site uses RKTools, verify that file SIRIUS or M204PROC contains the program SIRTUNEREPORT. 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.
  • If your site is not licensed for RKTools, you are still authorized (as a user of SirTune) to download the SIRIUS or M204PROC file. You can download the file from the Rocket website:
    1. On the "SOUL files" page, click the "SOUL files" link in the "Downloads and Uploads" section.
    2. On the Rocket M204 Customer Care page, find the appropriate row for your version of RKTools, and click the "Download Procfile" link.

    You don't need to do the entire RKTools installation: just download and restore the SIRIUS or M204PROC file, and make it available to your SirTune report jobs.

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.