The SCRT tool is a program that IBM uses to track program license capacity. IBM has recently made SCRT available for use by z Systems independent software vendors (ISVs)... So - if you are an ISV that is interested in understanding more about how clients are using your products - and in particular the sub-capacity values for those products - check out this pitch!

1. © 2017 IBM Corporation
SCRT Enablement for ISV Products
Andrew M. Sica
andrewsi@us.ibm.com

2. 2 © 2017 IBM Corporation
Trademarks
The following are trademarks of the International Business Machines Corporation in the United States and/or other countries.
BigInsights
BlueMix
CICS*
COGNOS*
DB2*
DFSMSdfp
IMS
Language Environment*
MQSeries*
Parallel Sysplex*
PartnerWorld*
DFSMSdss
DFSMShsm
DFSORT
DS6000*
DS8000*
* Registered trademarks of IBM Corporation
The following are trademarks or registered trademarks of other companies.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel
Corporation or its subsidiaries in the United States and other countries.
IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce.
ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.
Java and all Java based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo are trademarks of HP, IBM Corp. and Quantum in the U.S. and
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
OpenStack is a trademark of OpenStack LLC. The OpenStack trademark policy is available on the OpenStack website.
TEALEAF is a registered trademark of Tealeaf, an IBM Company.
Windows Server and the Windows logo are trademarks of the Microsoft group of countries.
Worklight is a trademark or registered trademark of Worklight, an IBM Company.
UNIX is a registered trademark of The Open Group in the United States and other countries.
* Other product and service names might be trademarks of IBM or other companies.
FICON*
GDPS*
HyperSwap
IBM*
IBM (logo)*
RACF*
Rational*
Redbooks*
REXX
SmartCloud*
System z10*
Tivoli*
UrbanCode
WebSphere*
z13
zEnterprise*
z/OS*
zSecure
z Systems
z/VM*

3. 3 © 2017 IBM Corporation
Session Overview
▪ Topics:
▪ SCRT Overview
▪ Plan to support non-IBM products.
▪ ISV enablement requirements:
▪ Develop a license file.
▪ JCL requirements.
▪ ISV Reporting: Reporting Process end to end overview.
▪ Customer Collection and Reporting Actions.
▪ SCRT Analysis.
▪ ISV Report output.
▪ Licensing Process.
▪ Availability
▪ Tool Notes.

4. 4 © 2017 IBM Corporation
Sub-Capacity Reporting Tool (SCRT) - Overview
▪ SCRT is the Sub-Capacity Reporting Tool.
▪ It is a no charge tool that reports required license capacity for sub-capacity eligible IBM
products.
▪ Capacity is reported in MSUs.
▪ SCRT analyzes at most one month of data at a time.
▪ Analysis requires certain SMF data types for the entire reporting month.
▪ SMF type 70 subtype 1. (RMF LPAR, PR/SM data).
▪ SMF type 89 subtypes 1 and 2. (Product records).
▪ Customer needs to provide other input (contact info, parameters, etc.).
▪ The result of SCRT execution is a Sub-capacity Report.

5. 5 © 2017 IBM Corporation
Plan to Support non-IBM Products
▪ Overview:
– IBM has received multiple requirements from both ISVs and mutual customers to
enhance SCRT to support ISV products.
• Sub-capacity pricing models are popular with the IBM customer set.
• Provide a standard mechanism for “sub-capacity” reporting.
– SCRT support will allow participating ISVs to better understand:
• Where products are running – by CPC and LPAR / VM.
• When products are running – per hour.
• The concurrent peak rolling four hour average MSU value of the LPAR when their
product was active.

6. 6 © 2017 IBM Corporation
Plan to Support non-IBM Products (continued)
▪ Requirements for SCRT ISV Processing.
– The set of products it should report on must be defined.
• This is the “product catalog”.
– Indication of where to look for product activity data.
• SMF record -> Product activity recorded in SMF 89.
• NO89 statement -> Product not instrumented for SMF 89.
– Need other information used for report processing and generation.
• Customer info.
• “Business as usual” input for SCRT processing.

7. 7 © 2017 IBM Corporation
Customer Process for IBM SCRT Report Creation
SMF
Type 70(1)
And
Type 89 (1,2)
SCRT JCL
//SMF DD ….
//SPECIAL DD *
…
//PARMS DD *
..
IBM SCRT
Report OutputProcessing

8. 8 © 2017 IBM Corporation
Customer Process for ISV SCRT Report Creation
SMF
Type 70(1)
And
Type 89 (1,2)
SCRT JCL
//SMF DD ….
//SPECIAL DD *
…
//PARMS DD *
..
//ISVLIB DD …
ISV Specific
SCRT Report
Processing
ISV Definition File
- ISV Info.
- Product
definitions.
Simple addition
of ISVLIB
statement and
data triggers
ISV Report.

9. 9 © 2017 IBM Corporation
ISV Enablement Requirements

10. 10 © 2017 IBM Corporation
Develop a library file.
▪ An XML format file.
▪ This is developed by the ISV for customers.
– Not intended to be customer specific.
– Provides SCRT the complete “product library”.
▪ Defines vendor wide info to SCRT, including:
• Product Owner
– - Must match value specified on IFAUSAGE or IFAEDREG.
• Company Name
– - Used for report output.
• Optional legal text.
▪ Defines ISV product catalog to SCRT, including:
– Key product attributes:
• Product Identifier.
• Product flags (i.e. z/OS, z/VSE, NO89, ENAB).
• Product description (product name reported).

11. 11 © 2017 IBM Corporation
JCL requirements – SCRT ISV
▪ SCRT generally runs as a batch job.
– We will support vendor processing in alternate platform tools.
▪ Ideally, customer will have a separate JCL per ISV using SCRT reporting.
▪ Differences between SCRT for IBM and SCRT for ISV reporting.
– New DD statement for input ISV license / product file.
– NO89 statements.
• IBM NO89 products not required in ISV JCL.
• Only ISV NO89 products must be defined here.
– - Customer tells SCRT whether it runs and where it runs (which LPARs).
– Customer Parameters:
• Customer number does not have to meet IBM SCRT guidelines.
▪ Everything else should be unchanged.
– Same set of SMF data provided.
– Exclude, other function supported.
▪ ISV should provide a customer modifiable JCL based on the SCRT JCL samples.

12. 12 © 2017 IBM Corporation
Reporting Process End to End Overview.

13. 13 © 2017 IBM Corporation
Customer Collection and Reporting Actions.
▪ Customer executes SCRT once per report needed.
– Provides isolation between IBM and ISV <–> ISV product analysis and reporting.
– Standard SCRT tool deliverable is used.
▪ Customer not required to gather additional SMF data.
– Requirement same as today for IBM reports.
• SCRT Type 70 Subtype 1
• SCRT Type 89 Subtypes 1 and 2.
▪ Customer can follow their existing SCRT process.
▪ Each report is unique (IBM and per ISV).
– Report can be handled according to IBM or ISV guidelines / process.
– No product “cross pollination” between ISV reports.

14. 14 © 2017 IBM Corporation
SCRT Analysis
▪ SCRT product analysis for ISV products is equivalent functionally to current
reporting.
– Same scope, same data.
▪ SMF generating products are assigned the simultaneous peak 4 hour rolling average
across the LPARs where the products run.
– For hours when the product is active according to SMF data.
▪ NO89 products are assigned the simultaneous peak 4 hour rolling average across
the LPARs where they are assigned.
– NO89 products are considered to always be active.

15. 15 © 2017 IBM Corporation
SCRT ISV Report Output
▪ When a vendor license file is specified, SCRT will generate an ISV specific report.
▪ The ISV report will contain the same report sections as the IBM SCRT report.
▪ The ISV report may contain the following products:
– Any enablement products defined in the ISV license file and found in the SMF data.
– Any ISV NO89 products assigned by the customer.
– Any IBM operating system (z/OS, z/VSE) version.
• The operating system product lines will match those shown on the IBM SCRT
report.
▪ The ISV report will contain a hash value for use as a checksum.
– Intended to protect report from tampering.
– IBM will provide a utility assist with report validation.

16. 16 © 2017 IBM Corporation

17. 17 © 2017 IBM Corporation

18. 18 © 2017 IBM Corporation
Report Output - Notes
▪ The ISV report will also contain sections:
– H5 -> Detail Data Collection
• % Data collected, by LPAR.
– M5 -> SMF / SCRT89 Input Data Stats
– N5 -> Detail LPAR Data Section
– P5 -> Product Max Contributors.
• Shows each LPARs contributions to the product peak.
– Q5 -> Product Grid Snapshot
– U5 / S5 -> Capping information.
– Optionally, V5 -> Detailed product data.
• An hour by hour breakdown of product sub-capacity values per LPAR.

19. 19 © 2017 IBM Corporation
Licensing Process
▪ SCRT ISV reporting capability will require a license agreement with IBM.
▪ With agreement, ISV receives:
– Interface documentation for developing ISV license file.
– Materials (tooling) to assist in the validation of report hash.
▪ SCRT ISV Support Process
– Transitioned to a standard (Service Request) service process in November 2016.
– Either the ISV or ISV client can open a service request for the SCRT tool, provided they
have a z/OS license.
▪ SCRT ISV support is intended to produce a ISV product usage report.
– Billing questions should be directed to the ISV, not IBM.
▪ Tool documentation and resources made available via Dallas ISV portal.

20. 20 © 2017 IBM Corporation
Thank You!
Any questions?