Sub-Capacity Reporting Tool

For Reporting on System z Software License Requirements

Pricing

MLC

zIPLA

Sub-Capacity

Sysplex

Reference

	Sub-Capacity Corner   |   Ts & Cs    |   Procedures    |   Technology    |   z/OS    |   z/TPF    |   z/VSE    |   SCRT    |   SCPT    |   SCRT89RU

Overview   Maintenance   Submit   FAQ   Instructions   Country   What's New   Download   Ask Me

SCRT Guidance

For best results, read the Sub-Capacity Reporting Tool User Guide (PDF, 1,26MB) to learn about collecting the correct SMF records, creating the correct input dataset, running the SCRT, interpreting the Sub-Capacity Report and submitting the Sub-Capacity Report to IBM.
 

SCRT System z Configuration Requirements

SCRT relies on LPAR rolling 4-hour average utilization and requires a WLM SPE (OW55509, which is now closed and PTFs are available) to enable z/OS to collect and record rolling 4-hour average utilization data for native z/OS partitions.

Before the PTFs were available, IBM had recommended temporary workaround. The temporary workaround is no longer necessary. Please proceed to the SCRT Support Page to read more about APAR OW55509, which applies to z/OS V1 Release 1 - Release 4.

How to Dynamically Set Defined Capacity

You are able to set and/or change an LPAR's defined capacity non-distruptively, without requiring either an IPL or an LPAR deactivate/activate. Here are the steps:

• From the Hardware Management Console (HMC), use the Change LPAR Controls Task available from the CPC Operational Customization
• The panel on the HMC is titled Change Logical Partition Controls
• All the partition names are listed in the first column, defined capacity is in the third column
• Press the Change Running System button, once you make the necessary defined capacity changes
• Consider also adding a defined capacity to your activation profile, so that defined capacity would still be enabled if you re-IPL the system

For more information, see the PR/SM Planning Guide. Page 5-5 shows the panel on the HMC that you should use to change defined capacity on the currently running system.

Sub-Capacity Reporting Tool Overview Instructions

STEP ONE:
Launch the tool (scrttool.exe) on your PC to de-compress the file; the decompressed file will be named scrttool.bin

STEP TWO:
Upload the file (Scrttool.bin) to your host system. Use binary transfer and move the file to a 80 byte fixed dataset. Here's how to upload the file:

• 2a. Create a Dataset On the Host
  
• • ISPF 3.2 to allocate a new 80 byte fixed dataset called userid.TOOL.JCL
  • Record Format = FB for Fixed Block
  • Record Length = 80
  • Directory Blocks = 0
  • Block Size = 0 (system determined block size)
• 2b. Upload to the Host From Your PC
  
• • Begin FTP Session (command is "ftp hostname")
  • Change FTP mode to binary transfer (command is "bin")
  • Put the scrttool.bin file onto the host, overwriting the new MVS file called userid.TOOL.JCL (command is "put scrttool.bin TOOL.JCL")

STEP THREE:
Customize and run the job to run on your host system.

• 3a. edit the jobcard to fit your environment
  //SCRTTOOL JOB (????,????),MSGCLASS=O,NOTIFY= userid,REGION=5M
  
  
• 3b. enter parameters in PARMS DD * and NO89 DD *
  See comments in JCL for required data and more details
  
  
• 3c. change SMF DD to point to your SMF dataset(s)
  //SMF DD DISP=SHR,DSN=HLQ.SMF.DATA
  
  
• 3d. change the output dataset name to fit your environment
  NOTE: since the LRECL for this dataset is unusual, you might be better off sending the output to a new dataset
  //OUTPUT DD DISP=(,CATLG),DSN= userid.SCRTTOOL.CSV,UNIT=SYSDA,
  // SPACE=(TRK,(15,15,15))
  
  
• 3e. update the DD1 DD (used in intial cleanup job step) to also point to your output dataset.
  //DD1 DD DSN= userid.SCRTTOOL.CSV,DISP=(MOD,DELETE),
  
  
• 3f. submit the job and check the output of SYSPRINT DD for any error messages that may have been generated during execution. Each machine encountered in the input dataset will generate its own member in the ouput dataset (Note: Each member in the output dataset is named according to the machine serial number, prefixed with a pound sign ('#').)
  
  

STEP FOUR:
Download the job output (a text file) from your host system to your PC.

• 4a. Begin FTP Session (command is "ftp hostname")
• 4b. Verify the FTP mode is set to text transfer (command is "ascii")
• 4c. Get the output file, userid.SCRTTOOL.CSV(#serial), from the host
  (command is "get SCRTTOOL.CSV(#serial) serial.csv")

STEP FIVE:
View the downloaded output file, scrt.csv, with any spreadsheet or text editor that recognizes the "comma separated values" file format.

STEP SIX:
Add comments or make changes to the report in any field marked with 'ZZZZZ'. Then submit your report via the Internet as described on the Where to Send Reports page.