Template:SirTune installation: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (RKTools replaces UL/SPF)
m (typo)
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<!--Page automatically generated by CMSTOWIK EXEC and will be
SirTune consists of an object file (for data collecting) as well as SOUL files (for reporting).
** automatically replaced ** -- any manual edits will be lost.
As of SirTune 7.1, the object code  was integrated into [[Sirius Mods]], and as of Model&nbsp;204 7.5, Sirius Mods was integrated into the Model&nbsp;204 nucleus. Thus, if you are running Model&nbsp;204 7.5 or later and you are authorized to use SirTune, the necessary object code is already installed into Model&nbsp;204.
You've been warned.   .. (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->
<!-- Page name: SirTune installation-->


SirTune can be installed from a product tape or can be installed
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.
from an object deck downloaded from the Rocket Software web site.
Installation from tape is described in [[#mvsinst|MVS installation]] and [[#cms|CMS Installation]], while installation from the web is described in [[#web|Installation from the web]].
All SirTune distributions come with <i>all</i> maintenance pre-applied:
up to the time the tape was cut for tape installations, and up to the
time the object deck was downloaded for web installations.


Reporting is performed by a SOUL (User Language) program
===SirTune object file===
that is distributed in the SIRIUS file as part of the <var class="product">[[RKTools]]</var> product family. If your site uses <var class="product">RKTools</var>, verify that file SIRIUS contains the program SIRTUNEREPORT.
If you are running a pre-7.5 version of Model&nbsp;204 and want to refresh the SirTune object file, you can download the "Sirius Mods" object file from the Rocket Software
</ol>
website "Rocket M204 Customer Care" page ([http://m204.rocketsoftware.com/ http://m204.rocketsoftware.com]).  
 
If your site is not licensed for <var class="product">RKTools</var>, you are still authorized (as a user of <var class="product">Fast/Unload</var>) to download the SIRIUS file.
You can download the SIRIUS file from the Rocket website using the "Download
SOUL files" link on the Support page (http://sirius-software.com/support.html).
If you are not a <var class="product">RKTools</var> customer, you don't need to do the
entire <var class="product">RKTools</var> installation: just download and restore the SIRIUS file, and make it available to your SIRTUNE Report jobs.
 
If you are a user of a previous version of SirTune, see the
<var class="book">SirTune Release Notes</var> for the version you are installing.
This document is available on the Rocket Software web site Documentation page.
The Release Notes highlight changes in the new version, and they list any
compatibility issues with the previous version.
 
<div id="web"></div>
==Installation from the web==
<!--Caution: <div> above-->


You can download the SirTune object files from the Rocket Software
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.
web site (http://m204.rocketsoftware.com/).
The download process requires a Model&nbsp;204 user ID and password.
The download process requires a userid and password.
<ol>
<ol>
<li>Click the <code>Support</code> navigation link to go to the Customer
<li>On the "Rocket M204 Customer Care" page, go to the "Downloads and Uploads" section and click the "Download object files" link.
Service page (https://support.rocketsoftware.com/rsp-portal/rsp/login), a
public page that explains how to get the required userid and password and
that also contains links to the various download pages.</li>
 
<li>Click the <code>Download object files</code> link to go to a protected page
(https://m204.rocketsoftware.com/maint/objlist) that contains a dynamically-generated list of the various Model 204 add-on products that you may download.
</li>
 
<li>On the <code>Download object files</code> page, select
the link(s) to the currently available SirTune object file(s) for the version you require.
<p>
<p>
Clicking a link generates an object file for SirTune that is
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>  
pre-configured for your site, with all maintenance and authorization
ZAPs applied. The "Save As" dialog that displays lets you indicate where the
object files are to be saved.</p>
<blockquote class="note"><b>Note:</b> As of [[Sirius Mods]] version 6.9, the "SirTune" object file is integrated into the "Sirius Mods" object file, so to install the latest version of the <var class="product">SirTune</var> components:
<ol>
<li>Select the "Sirus Mods" link (V6.9 or higher) for the
appropriate version of <var class="product">Model 204</var>.</li>


<li>Select the most recent "SirTune Report Generator" link.</li>
<li>Select the Sirius Mods row for the version you require, and click the "Download object file" link. </li>
 
<li>If you are running under CMS, select the most recent "SirTune
Data Logger" link.</li>
</ol>
<p>
For earlier versions of the <var class="product">SirTune</var> components,
select the appropriate V1.<i>x</i> "SirTune" and "SirTune Report
Generator" links, and optionally, for CMS users, the V1.<i>x</i> "SirTune Data
Logger" link.</p>
<p>
Running an earlier version of <var class="product">SirTune</var> with Sirius Mods version
6.9 or later is <b>not</b> recommended, since older versions of <var class="product">SirTune</var> are not upgraded to work with new versions of Sirius Mods or <var class="product">Model 204</var>.</p>
</blockquote></li>
</ol>
</ol>


<div id="mvsinst"></div>
===SirTune SOUL files===
==MVS installation==
SirTune report generation is performed by a [[SOUL]] program
<!--Caution: <div> above-->
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).
 
<var class="product">SirTune</var> is distributed on a magnetic tape.
This magnetic tape has three standard labeled files.
These three tape files are:
<ul>
<li>SIRIUS.LIB
<li>SIRIUS.LOAD
<li>SIRIUS.ULSPF (this file is not used by <var class="product">SirTune</var>)
</ul>
 
To install <var class="product">SirTune</var>, load the files from tape
onto disk. The tape contains <var class="product">SirTune</var> and any other Sirius products
you have ordered. The space allocations are sufficient regardless of how many products you will be loading.
 
The following JCL performs the load:
<p class="code"><nowiki>//SIRTUNEL JOB  (0),'Bart Simpson',MSGCLASS=A,CLASS=C,NOTIFY=BART
//*
//*        Load Sirius products from tape
//*
//IEBCOPY  EXEC PGM=IEBCOPY,REGION=0M
//T1      DD  UNIT=TAPE,VOL=SER=SIRIUS,LABEL=(1,SL),DISP=(OLD,PASS),
//            DSN=SIRIUS.LIB
//T2      DD  UNIT=TAPE,VOL=SER=SIRIUS,LABEL=(2,SL),DISP=(OLD,PASS),
//            DSN=SIRIUS.LOAD
//T3      DD  UNIT=TAPE,VOL=SER=SIRIUS,LABEL=(3,SL),DISP=(OLD,PASS),
//            DSN=SIRIUS.ULSPF
//*
//D1      DD  DISP=(,CATLG),DSN=SIRIUS.LIB,UNIT=SYSDA,
//            SPACE=(CYL,(10,2,5))
//D2      DD  DISP=(,CATLG),DSN=SIRIUS.LOAD,UNIT=SYSDA,
//            SPACE=(CYL,(5,0,2))
//D3      DD  DISP=(,CATLG),DSN=SIRIUS.ULSPF,UNIT=SYSDA,
//            SPACE=(CYL,(25,0,2))
//SYSPRINT DD  SYSOUT=*
//SYSIN    DD  *
COPY I=T1,O=D1
COPY I=T2,O=D2
COPY I=T3,O=D3
/*
</nowiki></p>
The job card and possibly the output data set names must be changed to conform to local standards.
 
After loading the two tape files, <var class="product">SirTune</var> is ready to use.
The first tape file contains some sample jobs, object decks used in building
<var class="product">SirTune</var>, and a member called ZAP that contains a list of all ZAPs
that have been pre-applied to the object decks and load modules.
The sample jobs in SIRIUS.LIB are:
<table class="thJustBold">
<tr><th>LNKTUNE</th>
<td>A job that can be used to relink the SIRTUNE load module if necessary. A pre-linked version is shipped in SIRIUS.LOAD.</td></tr>
 
<tr><th>LNKTUNER</th>
<td>A job that can be used to relink the SIRTUNER load module if necessary. A pre-linked version is shipped in SIRIUS.LOAD This module is deprecated as of Version 7.2 because SIRTUNER is no longer supported.</td></tr>
 
<tr><th>RUNTUNER</th>
<td>A sample job that can be used to run SIRTUNER.</td></tr>
</table>
 
All these sample jobs should be modified to conform to local requirements.
 
As part of the installation process for <var class="product">SirTune</var> version 1.5 and earlier:
This module is deprecated as of Version 7.2 because SIRTUNER is no longer supported.
<ul>
<ul>
<li>It might be desirable to move the SIRTUNE load module in SIRIUS.LOAD into a library that will allow access from ONLINE jobs.</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>If the ONLINE(s) to be monitored run APF authorized, move SIRTUNE to an APF authorized library so SIRTUNE's monitoring of the ONLINE(s) does not remove the <var class="product">Model 204</var> load module's APF authorization. If SIRTUNE's RESTART command is to be available, both SIRTUNE and the <var class="product">Model 204</var> load module must be APF authorized.</li>
 
<li>If the ONLINE(s) to be monitored run non-swappable, add SIRTUNE
to the program properties table (defined in SCHEDxx in SYS1.PARMLIB)
as non-swappable, or rename SIRTUNE to something that is already non-swappable.</li>
 
<li>If SIRTUNE is to be used to monitor both swappable and non-swappable load modules, an alias
should be created for SIRTUNE. Either the name <code>SIRTUNE</code> or its alias must then be added to the program properties table as non-swappable. The name (SIRTUNE or its alias) that is added to the program properties table should be used to invoke SIRTUNE for the non-swappable load modules, and the other name should be used to invoke SIRTUNE for swappable load modules.</li>
</ul>
 
An object deck called IFINTF is distributed in SIRIUS.LIB that,
if linked with one or more IFAM2 programs, will allow the
IFCHUNK reports to be produced for any jobs using those IFAM2 programs.
 
<div id="cms"></div>
==CMS Installation==
<!--Caution: <div> above-->
 
<var class="product">SirTune</var> is distributed on a magnetic tape.
This magnetic tape has one physical file made up of multiple logical files.
The <var class="product">SirTune</var> distribution tape is in VMFPLC2 format.
 
To install <var class="product">SirTune</var>:
<ol>
<li>Allocate a minidisk with sufficient space to contain all the Sirius products
you ordered.
Refer to the tapemap shipped with your installation package for
the actual number of blocks required, or allocate a minidisk large enough to
hold all Rocket add-on products (about 3,400 4K blocks).</li>
 
<li>Mount the <var class="product">SirTune</var> distribution tape on a tape drive,
and attach that tape drive to the installing virtual machine as virtual address 181.</li>
 
<li>Access the <var class="product">SirTune</var> minidisk as A, then type
the following to load all the files required to run <var class="product">SirTune</var>:
<p class="code"><nowiki>TAPE REW
VMFPLC2 LOAD
</nowiki></p>
<p>
Included in the loaded
files are object decks (with filetype TXTTUNE), load modules (with
filetype MODULE), and installation and sample execs (with filetype EXEC).</p>
<p>
The execs on the distribution tape are listed below.</p>
<p class="note"><b>Note:</b> It is essential that the CMICONV exec (described below) be run before running SIRTUNE.
</p>
<table class="thJustBold">
<tr><th>BLDTUNE</th>
<td>An exec that can be used to relink the SIRTUNE load module, if necessary. A pre-linked version is shipped on the tape. Since SIRTUNE is linked for XA or ESA versions of CMS, run this exec if running a 370 version (Release 5 and earlier) of CMS.</td></tr>
 
<tr><th>BLDTUNED</th>
<td>An exec that can be used to relink the SIRTUNED load module, if necessary. A pre-linked version is shipped on the tape. Since SIRTUNED is linked for XA or ESA versions of CMS, run this exec if running a 370 version (Release 5 and earlier) of CMS.</td></tr>
 
<tr><th>BLDTUNER</th>
<td>An exec that can be used to relink the SIRTUNER load module, if necessary. A pre-linked version is shipped on the tape. Since SIRTUNER is linked for XA or ESA versions of CMS, run this exec if running a 370 version (Release 5 and earlier) of CMS. As SIRTUNER is no longer used as of Version 7.2, this feature is deprecated.</td></tr>
 
<tr><th>RUNTUNER</th><td>A sample exec that can be used to run SIRTUNER. As SIRTUNER is no longer used as of Version 7.2, this feature is deprecated.</td></tr>
 
<tr><th>SIRTUNED</th><td>A sample exec that can be used as the PROFILE EXEC for the SIRTUNED virtual machine.</td></tr>
 
<tr><th>SIRTUNEF</th><td>A sample exec that can be used on the SIRTUNED virtual machine. For more information, see [[SirTune data collection under CMS]].</td></tr>
 
<tr><th>SIRTUNEA</th><td>A sample exec that can be used on the SIRTUNED virtual machine. For more information, see [[SirTune data collection under CMS]].</td></tr>
<tr><th>CMICONV</th>
<td>An exec that modifies the load addresses of 'M204CMI TXTLIB' members. It must be run once, before you bring up <var class="product">SirTune</var>.
The TXTLIB created by this exec should replace the original, or it should be moved to a disk accessed before the original M204CMI TXTLIB.
<p> If SIRTUNE is run against a version 3.2 or later ONLINE without running CMICONV, a member from M204CMI TXTLIB will overlay part of the <var class="product">Model 204</var> load module, resulting in a likely 0C4 or 0C1.</p></td></tr>
</table></li>
 
<li> After loading the tape files:
<ol>
<li>If <var class="product">SirTune</var> is version 1.5 or earlier, move SIRTUNE MODULE to a disk that can be accessed by the <var class="product">Model 204</var> service machines.</li>
 
<li>Move SIRTUNER MODULE SIRTUNER is not used as of Version 7.2, so this is no longer necessary.
to a disk that can be accessed by any user that might wish to produce SIRTUNER reports.</li>
</ol></li>


<li>Create virtual machine SIRTUNED, and give it access to the appropriate load modules and execs.
<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>
<ol>
<li>SIRTUNED requires the following:</li>
<li>On the "SOUL files" page, click the "SOUL files" link in the "Downloads and Uploads" section. </li>
<ul>
<li>PROFILE EXEC (similar to SIRTUNED EXEC from the tape)</li>
<li>SIRTUNEA EXEC (similar to SIRTUNEA EXEC from the tape)</li>
<li>SIRTUNEF EXEC (similar to SIRTUNEF EXEC from the tape)</li>
<li>SIRTUNED MODULE</li>
</ul></li>


<li>To run SIRTUNED under the CMS interface (making it possible to write sample data to OS format minidisks), give SIRTUNED access to the M204CMS module shipped with <var class="product">Model&nbsp;204</var>.</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>
</ol>
<p>
<p>
For more details on setting up SIRTUNED, see [[SirTune data collection under CMS]].</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>
</ol>
</ul>
 
==See also==
{{Template:SirTune topic list}}
 
[[Category: SirTune]]

Latest revision as of 19:42, 11 August 2017

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.