Sub-Capacity Reporting Tool Frequently Asked Questions
What is the Sub-Capacity Reporting Tool?
The Sub-Capacity Reporting Tool (SCRT) supports sub-capacity software pricing for System z software running in the z/OS, z/TPF, and z/VSE environments. SCRT will analyze a month of data from one or more System z machines, including changes to LPAR sizes and movement/addition/deletion of products across LPARs. SCRT will output a report for each machine analyzed, called a "Sub-Capacity Report", and that report will indicate the required licensed capacity for each Sub-Capacity eligible software product from IBM.
For each System z machine, running z/OS, z/TPF or z/VSE in 64-bit mode, wishing to qualify for sub-capacity pricing:
How does the Sub-Capacity Reporting Tool work?
SCRT will process the following data:
SCRT uses the data sets specified in the JCL as input and has a single data set as output. The output can be:
For a Sub-Capacity Report for a particular System z machine to be considered valid for software billing purposes, the input stream must contain one entire reporting period of SMF or SCRT89 records for all the z/OS, z/TPF, and z/VSE images on a given System z machine, from both native LPARs and guests of z/VM.
For example, imagine that you have two System z processors (CECA with Serial Number 12345 and CECB with Serial Number 56789) and you wish to obtain sub-capacity charges for both machines. If CECA has LPARs SYSA and SYSB while CECB has LPARs SYSX and SYSZ, you should include in your input stream the SMF and/or SCRT89 records for an entire reporting period from SYSA, SYSB, SYSX and SYSZ.
If your output dataset is a PDS then each member in the PDS corresponds to a particular machine included in the input dataset. Each member will be a comma-separated-value (CSV) flat file, referred to as a Sub-Capacity Report. Given the example above, your output PDS dataset would include two members, #12345 for CECA and #56789 for CECB.
If your output dataset is a sequential data set then the comma-separated-value (CSV) flat file will contain the Sub-Capacity Reports for both CECA and CECB.
Each Sub-Capacity Report should be downloaded to a desktop machine and reviewed for accuracy (and edited, in some cases) using any spreadsheet package and re-saved in CSV format, prior to submission to IBM via the web or e-mail. See the Sub-Capacity Reporting Tool Instructions for more details.
How can I prepare for the Sub-Capacity Reporting Tool?
Required service and other pre-reqs are posted on the SCRT Maintenance Page.
What report formats will IBM accept?
IBM will accept reports in Comma Separated Values (CSV) or plain text (TXT) format.
Where do I send the Sub-Capacity Report?
Submit your report via the Internet as described on the Where to Send Reports page. Most customers will use the License Management Support (LMS) website or LMS e-mail interface.
Is the Sub-Capacity Reporting Tool supported? Is there a charge for using the Sub-Capacity Reporting Tool?
The Sub Capacity Reporting Tool must be downloaded from the Web site and as such it does not have a Product ID number. There are no charges associated with download and/or use of the Sub-Capacity Reporting Tool. The SCRT is a supported tool and problems may be reported as described on the “Ask Me” section of this website.
There is no warranty, but IBM will accept problems submitted via the Ask Me section of this website. Fixes to SCRT will be delivered by complete refresh of the tool on this Web site. There will be no PTFs for SCRT, a full program replace will be made available with each new release.
Do I have to manually update my Sub-Capacity Report?
Under certain circumstances a “(required)” comment placeholder may appear in your Sub-Capacity Report, such as when there is less than the required amount of data submitted. If a “(required)” comment placeholder appears you must replace it with an explanation. You may do this by editing the Sub-Capacity Report prior to submitting it to IBM, or you may choose to fill in the required comment on the appropriate LMS website panel. Please see the SCRT User's Guide (PDF, 2.9MB) for more details.
IBM strongly recommends that you always review your Sub-Capacity Report(s) before submitting them to IBM.
Which products are Sub-Capacity eligible? Which products do/do not have SMF89 records?
See the System z Software Contracts exhibits website for product-level information.