SirTune report generation: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (remove preceding blanks)
m (remove pre-Mods 7.2 info)
Line 92: Line 92:
<li>Due to format changes in the sample data set in SirTune version 1.5, earlier releases of SIRTUNER cannot process a SirTune 1.5 or higher sample data set.</li>
<li>Due to format changes in the sample data set in SirTune version 1.5, earlier releases of SIRTUNER cannot process a SirTune 1.5 or higher sample data set.</li>
</ul>
</ul>
<div id="repsmvs"></div>
==Generating reports prior to Sirius Mods 7.2: MVS==
<!--Caution: <div> above-->
<p>
For pre-7.2 versions of the <var class="product">Sirius Mods</var>,
the report generation portion of <var class="product">SirTune</var> consists of a single load module called <code>SIRTUNER</code>.
To have SIRTUNER generate a report for a particular ONLINE job, code JCL that invokes SIRTUNER with appropriate DD cards. </p>
<p class="note"><b>Note:</b> Due to format changes in the sample data set, only releases 1.6 and later of SIRTUNER can process a <var class="product">SirTune</var> version 7.0 and later sample data set.
</p>
<p class="note"><b>Note:</b> Due to format changes in the sample data set in <var class="product">SirTune</var> version 1.5, earlier releases of SIRTUNER cannot process a <var class="product">SirTune</var> 1.5 or higher sample data set.
</p>
<p>
The DD names used by SIRTUNER are: </p>
<table class="thJustBold">
<tr><th>SIRTUNED</th>
<td>This DD should point to a sample data set generated by <var class="product">SirTune</var>. It corresponds to the SIRTUNED DD for the data collection part of <var class="product">SirTune</var>.
<p>
Sample data sets from multiple runs may be concatenated. In fact, sample data sets from multiple runs may even be concatenated sequentially into a single data set (with IEBGENER or an equivalent) and provided as a single data set to SIRTUNER.</p>
<p>
When multiple sample data sets are concatenated in any way, the [[SirTune Report Generator configuration#dsetlst|DATASET statement]] must be provided in SIRTUNEI to have SIRTUNER use any but the first sample data set in the concatenation. </p></td></tr>
<tr><th>SIRTUNEO</th><td>This DD is the data set that should receive SIRTUNER error messages or reports. It must have an LRECL greater than or equal to 80.</td></tr>
<tr><th>SIRTUNEI</th>
<td>This optional DD contains SIRTUNER statements that alter the SIRTUNER defaults. These statements allow control over which reports are produced and the time interval over which sample data is to be summarized. For a list of available statements, see [[SirTune Report Generator configuration]].
<p>
SIRTUNEI can have any format (RECFM=F or RECFM=V). </p></td></tr>
</table>
<p>
The following is an example of JCL used to generate a
report with SIRTUNER:</p>
<p class="code"><nowiki>//TUNER    JOB  (0),CLASS=C,MSGCLASS=A
//SIRTUNER EXEC PGM=SIRTUNER,REGION=8M
//STEPLIB  DD  DSN=SIRIUS.LOAD,DISP=SHR
//SIRTUNEI DD  *
REPORT STATE WDISK EVAL
/*
//SIRTUNED DD  DSN=SIRTUNE.SAMPLE.DATA,DISP=SHR
//SIRTUNEO DD  SYSOUT=*
//
</nowiki></p>
<div id="repscms"></div>
==Generating reports prior to Sirius Mods 7.2: CMS==
<!--Caution: <div> above-->
<p>
For pre-7.2 versions of the Sirius Mods, the report generation portion of <var class="product">SirTune</var> consists of a single load module: <code>SIRTUNER</code>.
To have SIRTUNER generate a report for a particular
ONLINE job, code an EXEC that invokes SIRTUNER
with appropriate FILEDEF commands.</p>
<p class="note"><b>Note:</b> Due to format changes in the sample data set, only releases 1.6 and later of SIRTUNER can process a <var class="product">SirTune</var> version 7.0 and later sample data set.
</p>
<p class="note"><b>Note:</b> Due to format changes in the sample data set in <var class="product">SirTune</var> version 1.5, earlier releases of SIRTUNER cannot process a <var class="product">SirTune</var> 1.5 or higher sample data set.
</p>
<p>
SIRTUNER can run under CMS or CMS/XA.
Under CMS/XA, most of the storage used by SIRTUNER is "above the line," so virtual storage constraints should not be an issue.</p>
<p>
The DD names used by SIRTUNER are:</p>
<table class="thJustBold">
<tr><th>SIRTUNED</th>
<td>This DD should point to a sample data set generated by <var class="product">SirTune</var>. It corresponds to the SIRTUNED DD for the data collection part of <var class="product">SirTune</var>.
<p>
Sample data sets from multiple runs may be concatenated. In fact, sample data sets from multiple runs can be concatenated sequentially into a single data set (with COPYFILE or an equivalent) and provided as a single data set to SIRTUNER.</p>
<p>
When multiple sample data sets are concatenated in any way, the [[SirTune Report Generator configuration#dsetlst|DATASET statement]] must be specified in SIRTUNEI to have SIRTUNER use any but the first sample data set in the concatenation.</p></td></tr>
<tr><th>SIRTUNEO</th>
<td>This DD is the data set that should receive SIRTUNER error message or reports. It must have an LRECL greater than or equal to 80.</td></tr>
<tr><th>SIRTUNEI</th>
<td>This optional DD contains SIRTUNER statements that alter the SIRTUNER defaults. These statements allow control over which reports are produced and the time interval over which sample data is to be summarized. For a list of available statements, see [[SirTune Report Generator configuration]].
<p>
SIRTUNEI must have fixed format, that is, <code>RECFM=F</code> or <code>RECFM=FB</code>.</p></td></tr>
</table>
<p>
The following sample EXEC can be used to generate a report with SIRTUNER:</p>
<p class="code"><nowiki>/* */
address command
"FILEDEF SIRTUNEI DISK SIRTUNER INPUT A"
"FILEDEF SIRTUNEO DISK SIRTUNER LISTING A"
"FILEDEF SIRTUNED DISK PRODONLN DATA W",
  "(LRECL 512 BLOCK 4000 RECFM VB"
"SIRTUNER"
exit rc
</nowiki></p>


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

Revision as of 23:33, 9 June 2017

The report generation portion of SirTune consists of two SOUL programs which are distributed in the RKTools SIRIUS file (prior to RKTools version 7.7) or the M204PROC file (as of RKTools 7.7).

The SOUL reporting programs of SirTune are:

SIRTUNEREPORT The "outer" SirTune report program.
SHARED_REPORT Report methods used by SIRTUNEREPORT.

To run SIRTUNEREPORT from a procedure file other than SIRIUS or M204PROC, move both these procedures to the new file, and update the single INCLUDE statement in SIRTUNEREPORT. A few UTABLE and environmental settings are executed at the top of SIRTUNEREPORT. These can be adjusted for performance or functional reasons at the client site.

SIRTUNEREPORT requires two input files, and it accepts an optional output file. These files, described below, may be specified as DD cards or ALLOCATE statements on the job running SIRTUNEREPORT:

TUNERPTI Input cards that specify the SirTune reports and other run characteristics.

This file may contain older style input, with REPORT, RANGE, RESOLUTION, and other statements, or it may contain newer-style input in XML format. If old-style card images are input, a subroutine in SIRTUNEREPORT converts them to XML. For detailed information about this input, see SirTune Report Generator configuration.

TUNERPTI is a required file.

The file format of TUNERPTI is not critical: Since input lines should be shorter than 80 characters, a fixed 80-character file works fine.

TUNERPTD This is the input data to SIRTUNEREPORT.

TUNERPTD is a required file.

This is the same file as SIRTUNED in the SirTune data collection run.

Sample data sets from multiple runs may be concatenated. In fact, sample data sets from multiple runs may even be concatenated sequentially into a single data set (with IEBGENER under MVS, or COPYFILE or an equivalent under CMS) and provided as a single data set to SIRTUNEREPORT.

When multiple sample data sets are concatenated in any way, the DATASET statement (DATaset list) must be provided in TUNERPTI to have TUNERPTR use any but the first sample data set in the concatenation.

TUNERPTO This is the output file for the SIRTUNEREPORT reports.

The SOUL code is currently set to output 72 characters per line, so a fixed or fixed-block file with 80-character records is recommended.

TUNERPTO is an optional file. If it is not present, report output is redirected to standard output; generally, CCAPRINT.

The names of these files are hard-coded in SIRTUNEREPORT, but they may be changed if you run SIRTUNEREPORT from another procedure file and decide to customize it. The names are chosen to differentiate them from the SIRTUNEx names used during SirTune data collection.

Generally, SIRTUNEREPORT is run as a standalone batch job, though it is perfectly acceptable, if perhaps a little resource-intensive, to dynamically allocate the TUNERPTx files and run it from inside an Online.

A basic TUNERPTR job under MVS would look like this:

get non-BATCH204 example!!

//TUNE JOB (0,0),CLASS=A,MSGCLASS=X //TUNERPT EXEC PGM=BATCH204,REGION=4096K, // PARM='SYSOPT=134,LIBUFF=1000,LOBUFF=1000',TIME=250 //CCASTAT DD DSN=M204.CCASTAT,DISP=SHR //CCATEMP DD DSN=M204.TEMP1,DISP=SHR //CCAJRNL DD DSN=M204.CCAJRNL,DISP=SHR //SIRIUS DD DSN=ULSPF700.SIRIUS,DISP=SHR //TUNERPTI DD DSN=SIRTUNER.REPORT.INPUT,DISP=SHR //TUNERPTD DD DSN=SIRTUNER.DATA.INPUT,DISP=SHR //TUNERPTO DD DSN=SIRTUNER.REPORT.OUTPUT,DISP=SHR //CCAPRINT DD SYSOUT=*,OUTLIM=50000 //CCAIN DD * NFILES=5,NDCBS=5,NDIR=5,MAXBUF=50,NGROUP=5,NORQS=4,LIBUFF=132, X LOBUFF=320,LPDLST=2400,LQTBL=1350,LSTBL=2000,LNTBL=1200 LOGON me mepassword O SIRIUS INCLUDE SIRTUNEREPORT /* //

Under CMS, a similar Batch204 EXEC can be used to invoke SIRTUNEREPORT.

get non-BATCH204 example!!

Compatibility notes:

  • As of release 7.2 of the Sirius mods, SirTune reports can only be generated using a SOUL program invoking a call to the SirTuneReport method of the Dataset class, as implemented in the SIRTUNEREPORT SOUL program described in SirTune Report Generator configuration and SirTune reports.
  • Due to format changes in the sample data set, only releases 1.6 and later of SIRTUNER can process a SirTune version 7.0 and later sample data set.
  • Due to format changes in the sample data set in SirTune version 1.5, earlier releases of SIRTUNER cannot process a SirTune 1.5 or higher sample data set.

See also

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=SirTune_report_generation&oldid=103384"