We’ll occasionally place various small utilities and tools on this page, free for the taking. We provide no warranty for these tools, nor do we provide any support. (If you have a problem or suggestion, please let us know and we may pursue it if we have time.) The utilities and tools have no copyright, and we request that you not attempt to sell them for profit. Click on the heading of each item to read more about the tool.
IMPORTANT MESSAGES Health Check
How many times have you experienced a serious outage, only to discover that there was a warning message on the console, informing you of the impending doom? Of course, you only discover the message after the outage. Or even worse, when you discover the message, a colleague says “Oh, I saw that message, but I didn’t think it was important.” Grrr.
We’ve all been there. But to try to reduce the number of these occasions in the future, our colleague Mario Bezzi wrote an IMPORTANT_MESSAGES health check that runs under the IBM Heath Checker for z/OS infrastructure. The program checks console messages as they are issued against a pre-defined list of messages. The package includes a list of messages that have been identified as being really important by the product owner, or in a Redbook, or an IBM presentation, or an IBM Techdoc. You can also add your own messages. If any of the messages in the list are issued, Mario’s health check will generate a Health Checker exception. This gives you a single place (the SDSF CK option, for example) to check whenever your system starts misbehaving.
The package also includes sample jobs to allow you to add messages from your own applications or non-IBM products that you may be using. To obtain the package, please fill out the form below.
We plan on updating the list of messages over time, based on new information from IBM, new products, and feedback from other users of this health check. We may also extend the health check to provide critical messages for non-IBM products. For these reasons, we are requiring all users of this package to provide contact information so that we can send you updates as they become available.
When you click on Submit, you will be sent an email containing a link that can be used to download the zip file containing the files and documentation for this package. If you have any questions or problems, please email us.
SMFSCRUB – Report Contents of SMF Data Set
This zip file contains the load module for a program called SMFSCRUB. SMFSCRUB reads a sequential data set containing SMF records and produces a report that shows the following information for each record type, subtype, and system found in the input file:
- The number of records
- The number of bytes
- The minimum and maximum record length
- The date and time of the earliest record
- The data and time of the latest record
The report looks similar to the standard IFASMFDP report, but is a lot more detailed. The zip file also contains sample JCL to run the program, and sample output from a run of the program. Upload the XMIT file in BIN format to an FB80 data set on z/OS and then run a TSO RECEIVE against that data set to create the load library. Here’s a link to the zip file. PLEASE NOTE: We are considering an article describing typical breakout and sizes of SMF data by subtype, so if you’re willing to share your output once, just send it via an email to technical@watsonwalker.com. All information will be kept confidential.
Convert GRS SMF 87.1 Records to CSV Format
This zip file contains a Rexx program to convert SMF type 87.1 records, created by GRS, into CSV format. These records contain information about issuers of generic GQSCAN requests, a potential cause of high CPU consumption by GRS. The package includes JCL to run the Exec, and a sample output file. For more information, refer to the article titled ‘Inspector Clouseau Meets GRS’ in Tuning Letter 2018 No. 1. Here’s a link to the program.
Displaying an LPAR’s Topology
We’d like to thank Rolf Bruner of SIX Group Services and Klaus Wolf of IBM Deutschland for providing this Assembler program to display an LPAR’s topology (processor chips and vertical CP status). Subscribers can find more about this in the Tuning Letter 2016 No. 1 issue. Here’s a link to the program.
Memory Allocation on SCM-Capable CPC
When z/OS is IPLed on a zEC12 or zBC12 or later (any CPC that support Storage Class Memory), the Real Storage Manager (RSM) component automatically allocates an amount of memory that is the preferred location for pageable 1MB pages. This area is known as the Pageable Large Area (PLAREA). You have no control over the size of this area. The size is calculated dynamically by z/OS based on the total amount of memory in the LPAR less the amount of memory that is put aside for the QUAD area.
To help you understand how the memory in your z/OS LPAR is divided, Alain Maneville wrote and kindly provided us with this very help and easy-to-use little spreadsheet. You simply enter the number of GBs of memory in the LPAR in cell C4, and the LFAREA from your IEASYSxx member in cell C5, and the spreadsheet will report the size of your QUAD and PLAREA. Given the current lack of metrics or tools to help you manage the PLAREA, this spreadsheet is a very valuable tool to give you insight into how your z/OS memory is being used.
Determining RNI and LSPR Workload
If you collect SMF type 113 records, and you run MXG, then you can run either of these two freeware programs to determine which workload should be used for zPCR analysis and in our BoxScore workload analysis. IBM made a change to the RNI calculation in July 2012. You should use MXG 30.07 to get the updated calculation in the $RNIRPTS program, and/or you should download the updated RNIHINT program.
SAS Program to Report SMF Record Counts
In our ongoing Tuning Letter series on SMF records, we have been trying to accumulate statistics by SMF subtype, in addition to SMF types. Because most sites do not get that information, we included an article about some programs to accomplish that. Here is a link to that article. If you are willing to send us information about the SMF subtypes that you collect, we would certainly appreciate it.
The following is a SAS program that extracts information about SMF record types and subtypes from the MXG PDB.ID file, and produces a tabular report and a CSV file. It was written by Scott Barry of SBBWorks, Inc. and is offered to our readers for public, unwarranted use. There are four files associated with this:
- SAS Program JCL, Source, and Documentation (5 KB)
- Sample Tabular Report
- Excel Spreadsheet (in ZIP format) (1.8 MB)
- Excel PivotPlot Example Created from the Excel Spreadsheet (1.6 MB)
PLEASE NOTE: Cheryl would like a copy of the CSV file from any site which uses this because she is trying to analyze the breakout and typical size of SMF data by subtype. Just send it via an email to technical at watsonwalker.com. All information will be kept confidential.
Cheryl’s Quickstart Service Policy
Provides a standard set of service classes and goals that you can easily use to create your initial Workload Manager goal mode policy.