Template:SirTune installation: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (misc formatting and section move)
m (remove old install sections for mvs and cms)
Line 1: Line 1:
SirTune can be installed from a product tape or from an object deck downloaded from the Rocket Software web site.
SirTune consists of an object file (for data collecting) as well as SOUL files (for reporting).
Installation from tape is described in the [[#mvsinst|MVS installation]] and [[#cms|CMS Installation]] sections on this page, while installation from the web is described in the [[#web|Installation from the web]] section.  
As of SirTune 7.1, the object code  was integrated into [[SirMods]], and as of Model 204 7.5, SirMods 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.


All SirTune distributions come with <i>all</i> maintenance pre-applied:
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.”
up to the time the tape was cut for tape installations, and up to the
time the object deck was downloaded for web installations.


==<b id="web"></b>Installation from the web==
You download a SirTune object file and SirTune SOUL files.


===SirTune object file===
==SirTune object file==
You can download the SirTune object files from the Rocket Software
You can download the SirTune object files from the Rocket Software
web site (http://m204.rocketsoftware.com/).
web site (http://m204.rocketsoftware.com/).
Line 16: Line 12:
<li>Click the <code>Support</code> navigation link to go to the Customer
<li>Click the <code>Support</code> navigation link to go to the Customer
Service page (https://support.rocketsoftware.com/rsp-portal/rsp/login), a
Service page (https://support.rocketsoftware.com/rsp-portal/rsp/login), a
public page that explains how to get the required userid and password and
public page that explains how to get the required user ID and password and
that also contains links to the various download pages.</li>
that also contains links to the various download pages.</li>


Line 25: Line 21:
<li>On the <code>Download object files</code> page, select
<li>On the <code>Download object files</code> page, select
the link(s) to the currently available object file for the version you require.  
the link(s) to the currently available object file for the version you require.  
Since the SirTune object file is integrated into the "Sirius Mods" object file.
Since the SirTune object file is integrated into the "Sirius Mods" object file, select the "Sirus Mods" link (V6.9 or higher) for the
select the "Sirus Mods" link (V6.9 or higher) for the
appropriate version of <var class="product">Model&nbsp;204</var>.  
appropriate version of <var class="product">Model&nbsp;204</var>.  
<p>
<p>
Line 37: Line 32:
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, RKTools, or <var class="product">Model&nbsp;204</var>.</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, RKTools, or <var class="product">Model&nbsp;204</var>.</p>


===SirTune SOUL files===
==SirTune SOUL files==
SirTune report generation is performed by a [[SOUL]] program
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 (prior to RKTools version 7.7) or the <code>M204PROC</code> file (as of RKTools 7.7).
that is distributed as part of the <var class="product">[[RKTools]]</var> product family in the <code>SIRIUS</code> file (prior to RKTools version 7.7) or the <code>M204PROC</code> file (as of RKTools 7.7).
Line 53: Line 48:
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>
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>
</ul>
==<b id="mvsinst"></b>MVS installation==
<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>
<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 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.
==<b id="cms"></b>CMS Installation==
<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">TAPE REW
VMFPLC2 LOAD </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.
<ol>
<li>SIRTUNED requires the following:</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>
</ol>
<p>
For more details on setting up SIRTUNED, see [[SirTune data collection under CMS]].</p>
</ol>


==See also==
==See also==

Revision as of 01:01, 9 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 SirMods, and as of Model 204 7.5, SirMods 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

You can download the SirTune object files from the Rocket Software web site (http://m204.rocketsoftware.com/). The download process requires a user ID and password.

  1. Click the Support navigation link to go to the Customer Service page (https://support.rocketsoftware.com/rsp-portal/rsp/login), a public page that explains how to get the required user ID and password and that also contains links to the various download pages.
  2. Click the Download object files 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.
  3. On the Download object files page, select the link(s) to the currently available object file for the version you require. Since the SirTune object file is integrated into the "Sirius Mods" object file, select the "Sirus Mods" link (V6.9 or higher) for the appropriate version of Model 204.

    Clicking a link generates an object file for SirTune that is 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.

Running an earlier version of SirTune with Sirius Mods version 6.9 or later is not recommended, since older versions of SirTune are not upgraded to work with new versions of Sirius Mods, RKTools, or Model 204.

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 (prior to RKTools version 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.

See also

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=Template:SirTune_installation&oldid=104076"