Welcome to the System z Software Sub-Capacity Corner. This website describes details related to Sub-Capacity: terms & conditions, procedures and technology.
How SCRT Determines the Rolling 4-Hour Average per Hour
- SCRT determines which sub-capacity eligible products are executing in each LPAR on a machine and the rolling 4-hour average utilization of each LPAR on an hourly basis
- There were two factors that drove IBM to select hourly granularity 1) SMF89 records are generally cut once per hour and 2) customers generally cut SMF70 records at least once per hour
- Within each hour, there are 'n' number of SMF70 records, in each of those records, SCRT looks at the value in SMF70LAC which is the rolling 4-hour average utilization of the LPAR at the end of the interval. For example, In the case of 20 minute RMF intervals, for a given hour SCRT will read 3 SMF70 records per LPAR per hour
- Lastly, SCRT averages together all of the SMF70LAC values within the hour to get the "rolling 4-hour average utilization" for that hour
Illustrated Example of How SCRT Works
Under Sub-Capacity terms and conditions, IBM charges for Sub-Capacity eligible products on a machine based upon the rolling 4-hour average of the LPAR(s) on that machine where and when the product executes. This example, below, further explains the concept. In this example, you see that SCRT analyzes 720 hours of measurement, one for each day in the month. For each hour, SCRT looks at information about each LPAR on that machine, LPAR A and LPAR B. The information being considered by SCRT is 1) the rolling 4-hour average of that LPAR during that hour and 2) which sub-capacity eligible products are running in that LPAR during that hour.

SCRT will correctly identify z/OS's peak as 130 MSUs which occurs in hour 719 on that machine. SCRT will also identify DB2's peak on that machine as 75 MSUs which occurs in hour 2.
SCRT will not add the peak for LPAR A (100 MSUs) to the peak of LPAR B (50 MSUs) because those peaks do not occur in the same interval and SCRT only looks at simultaneous peaks for a product running in multiple LPARs on a machine. Likewise, SCRT will not choose LPAR A's peak of 100 MSUs for DB2 because DB2 was not executing during the interval when LPAR A reached that 100 MSU peak.
*all MSUs are rolling 4-hour average utilization, in MSUs, per LPAR, per machine.
Products in the Sub-Capacity Reporting Tool
SCRT reports on all sub-capacity eligible MLC products. It also reports on all Sub-Capacity IPLA (OTC) products which fall into the Execution-based category, such as WebSphere Application Server and many application development tools. These products are hardcoded into SCRT and the product list cannot be altered by the end user.
Each of these Sub-Capacity eligible IBM products may or may not generate SMF89 records. The SMF89 record serves many purposes but SCRT uses it solely to determine 1) where a product is executing and 2) when a product is executing.
- If the product generates SMF89 records (DB2, CICS, MQSeries, WebSphere, etc), then SCRT can automatically determine where/when the product is executing. So, for example, SCRT knows that DB2 ran in LPARA during every interval in the reporting period and DB2 ran in LPARB only from May 15 at 10:00 - May 23rd at 12:00.
- If the product does not generate SMF89 records (COBOL compiler, PL/1 compiler, Netview, Tivoli Workload Scheduler, OPC, etc), then SCRT cannot automatically determine where/when the product is executing. SCRT relies on customer input to determine where these "NO89" products are executing. The customer provides this input via the 'NO89 DD' statement in the SCRT's JCL. If a customer indicates that COBOL runs in LPARA, then SCRT assumes that COBOL was executing in all the intervals that LPARA was online. If a customer incorrectly lists NO89 products which are not executing or are not licensed, then the report will be incorrect. For example, if a customer accidentally listed 5648-A25 (COBOL for OS/390 and VM V2) when they really were actually running 5688-197 (AD Cycle COBOL/370), then IBM would contact the customer to ask whether the customer really wants a license for 5649-A25 on that machine.
Using Defined Capacity to Control LPAR Rolling 4-hour Average Utilization
Beginning with zSeries running z/OS in 64-bit mode in October 2000, IBM added another setting for customers to use when setting up their LPARs, called "Defined Capacity." Instead of using hardcaps, many Sub-Capacity customers choose to use the more flexible (and more appropriate) defined capacity. Defined capacity allows you to set a size of a partition, in MSUs. This setting is not relative to any other LPAR. Once you set a defined capacity, you are telling WLM to monitor the rolling 4-hour average utilization of that LPAR. If the rolling 4-hour average utilization of the LPAR is less than the defined capacity, then nothing happens. If the rolling 4-hour average utilization of the LPAR exceeds the defined capacity, then WLM signals to PR/SM and requests that something called 'softcapping' be initiated. Softcapping constrains the workload of the LPAR to the level of the defined capacity.
More information about LPARs and using Defined Capacity is available in the Understanding and Controlling LPARs White Paper (PDF, 245KB).
PDF files require Adobe® Reader®
Analyzing on an Interval-by-Interval Basis
You can view a per interval utilization (in MSUs) and a per interval rolling 4-hour average utilization (in MSUs) by using the Sub-Capacity Planning Tool, an SMF70 post-processor available for download from the web at http://ibm.com/zseries/swprice/scpt. This tool will provide information for each LPAR and also information for the entire machine. Instructions for using this tool are available on the website listed above. You may also be interested in some of the online monitoring abilities provided by RMF Monitor III. RMF has a Newsletter on their website which describes each of these monitors, available on the web at http://ibm.com/zseries/zos/rmf/rmfhtmls/rmfnws14.html (please ignore pricing information on this site).
Getting Help
For help with the Sub-Capacity Reporting Tool (SCRT) or questions related to Sub-Capacity pricing, please see the System z Software Pricing Help page.
Contact IBM
- Email IBM
- Find a Business Partner
-
Call IBM: 1-866-883-8901
Priority code: 101AS13W