MustGather: How to collect and review the SYSTEMHEAPS macro output from system service tools

Resolving The Problem

1. STRSST <enter>
2. Specify credentials <enter>
3. 1. Start a service tool <enter>
4. 4. Display/Alter/Dump <enter>
5. 2. Dump to printer  <enter>
6. 2. Licensed Internal Code (LIC) data  <enter>
7. 14. Advanced analysis  <enter>
8. Specify an option of 1 and the command SYSTEMHEAPS <enter>
9. On the Options screen press <enter>  
10. Specify a dump title <enter>
11. Exit system service tools by pressing F3 <exit> and watch for one of these messages:  
    If the following message appears, then take option 7. Display dump status  and wait until the dump completes.
    Dumps still incomplete.  Press F3=Exit or F12=Cancel to end.
    
    If the following message appears, then continue to press F3 <exit> and <enter> to exit System Service Tools
    Dump completed normally          -SAMPLE 1

1. WRKJOB OPTION(*SPLF)  <enter> 
2. Locate the spooled file named QPCSMPRT and take option 5=Display <enter>
3. See the details and examples below to understand the output.

• Multiple SYSTEMHEAPS can be taken over time to determine if the heaps are increasing in size.
• A heap can have at most 100 control segments.  Both the Resident heap and System heap below show 'Number of control segments' of 1.
• A recovery action will be required when a heap reaches 100 control segments. 
  - An IPL will be required if either System heap or Resident heap reach 100 control segments.
  - A wide variety of failures with an impact to a large number of jobs is possible when a heap reaches 100 control segments.  
  - Heap is temporary storage and an IPL will generate a new heap.
• There are two primary sections in the output.  These sections start and end with the text shown below in Section 1 and Section 2.
• The most interesting part of Section 1 is the "Total resident storage used...", which is the current size of all the heaps in this section.
• The most interesting part of Section 2 is the "Total pageable storage used...", which is the current size of all the heaps in this second.
• All sizes are stated in pages.  A page is 4096 bytes.

1. Section 1:
   Dumping NONPAGEABLE heaps.....       
   ...
   ...
   Total resident storage used by above heaps = <number> pages. 
    
2. Section 2:
   Dumping PAGEABLE heaps.....    
   ...
   ...
   Total pageable storage used by above heaps = <number> pages.       
    
3. Example Heap Details:
   Both sections will have multiple heaps listed, but all have the same format.  
   • Control Segment #0 is the address of the heap.  C000F36A38 and D01224D24B in the two examples.
   • Current heap size is the size of the particular heap in pages.
   • Max. size reached is the maximum size the heap has reached in pages.