OA40130: NEW VSM HEALTH CHECK

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New VSM Health check for largest free CSA block
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of z/OS V1R12 (HBB7770) and above      *
  *                 who use IBM Health Checker for z/OS.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function APAR to add a new VSM      *
  *                      Health Check to IBM Health Checker      *
  *                      for z/OS.                               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Enhancement to add the new VSM_CSA_LARGEST_FREE health
  check to IBM Health Checker for z/OS. This check will monitor
  the size of the largest contiguous free CSA/ECSA block
  against the installation-specified or default minimum value.
  

Problem conclusion

Temporary fix

Comments

• New VSM health check VSM_CSA_LARGEST_FREE is added to
  monitor the size of the largest contiguous free block of
  CSA/ECSA against the installation-specified or default
  minimum value. An exception is generated if the size falls
  below the minimum value. The check also generates a report on
  the five largest contiguous free blocks for each supported
  area.
  
  This support adds the following messages:
  IGVH111I
  IGVH112E
  IGVH504I
  
  +--- PUBLICATION AFFECTED ------------------------------------+
  |                                                             |
  | IBM Health Checker for z/OS User's Guide, SA22-7994-xx      |
  |                                                             |
  +-------------------------------------------------------------+
  Chapter on Check Descriptions, section on VSM Checks (IBMVSM)
  will be updated to add a new check.
  
  | VSM_CSA_LARGEST_FREE
  |
  | Description:
  |   Monitor the current size of the largest contiguous free
  |   block of CSA/ECSA against the installation-specified or
  |   default minimum value.
  |
  | Reason for check:
  |   If the system is unable to satisfy storage-obtain requests
  |   for large blocks of common storage due to issues like
  |   storage fragmentation, a system outage may occur. This
  |   check provides an advanced warning about such common
  |   storage problem so the system programmers can take
  |   appropriate action.
  |
  | z/OS releases the check applies to:
  |    z/OS V1R12 and later.
  |
  | Parameters accepted:
  |    Yes, the following parameters are accepted:
  |      o The minimum size of the largest contiguous free block
  |        of CSA required on the system (keyword: CSA). This
  |        can be specified as a percentage (an integer, 0-100,
  |        followed by a percent sign '%') of total CSA, or a
  |        value in bytes with an optional suffix (K,M).
  |      o The minimum size of the largest contiguous free block
  |        of ECSA required on the system (keyword: ECSA). This
  |        can be specified as a percentage (an integer, 0-100,
  |        followed by a percent sign '%') of total ECSA, or a
  |        value in bytes with an optional suffix (K,M).
  |      o Default: CSA(5%),ECSA(5%)
  |
  | User override of IBM values:
  |    The following shows keywords you can use to override check
  |    values on either a POLICY statement in the HZSPRMxx
  |    parmlib member or on a MODIFY command. This statement may
  |    be copied and modified to override the check defaults:
  |
  |    UPDATE
  |    CHECK(IBMVSM,VSM_CSA_LARGEST_FREE)
  |    INTERVAL(00:15)
  |    SEVERITY(HIGH)
  |    PARM('CSA(5%),ECSA(5%)')
  |    DATE('20120821')
  |
  | Debug support:
  |    No.
  |
  | Verbose support:
  |    No.
  |
  | Reference:
  |    For more information, see z/OS MVS Initialization and
  |    Tuning Reference.
  |
  | Messages:
  |    This check issues the following messages:
  |      o IGVH111I
  |      o IGVH112E
  |      o IGVH504I
  |
  |    See IGVH Messages in z/OS MVS System Messages Vol 9
  |    (IGF-IWM).
  |
  | SECLABEL recommended for multilevel security users:
  |    SYSLOW - see z/OS Planning for Multilevel Security and the
  |    Common Criteria for information on using SECLABELs.
  
  +--- PUBLICATION AFFECTED ------------------------------------+
  |                                                             |
  | z/OS MVS System Messages, Vol 9 (IGF-IWM), SA22-7639-xx     |
  |                                                             |
  +-------------------------------------------------------------+
  Chapter on IGVH Messages will be updated to include the
  following new message sections:
  
  | IGVH111I The current size of the largest contiguous free
  | block of <area> is <size>, and satisfies the owner specified
  | minimum of <minimum> for this area.
  |
  | Explanation: CHECK(IBMVSM,VSM_CSA_LARGEST_FREE) ran
  | successfully and found no exceptions. It determined the size
  | of the largest contiguous free common storage block is greater
  | than the specified minimum.
  |
  | In the message text:
  |   <area>
  |     Indicates the area being reported on (CSA or ECSA).
  |  <size>
  |     Specifies the size of the indicated area, rounded up to
  |     the nearest 1K boundary.
  |  <minimum>
  |     The installation-specified or default minimum size of the
  |     largest contiguous free block of the indicated area,
  |     rounded up to the nearest 1K boundary.
  |
  | System Action: The system continues processing.
  |
  | Operator Response: N/A
  |
  | System Programmer Response: N/A
  |
  | Problem Determination: N/A
  |
  | Source: Virtual Storage Manager
  |
  | Reference Documentation: N/A
  |
  | Automation: N/A
  |
  | Detecting Module: IGVHCHK1
  |
  | Routing Code: See note 35
  |
  | Descriptor Code: N/A
  
  
  | IGVH112E Largest contiguous free <area> block is below minimum
  |
  | Explanation: CHECK(IBMVSM,VSM_CSA_LARGEST_FREE) determined
  | that the size of the largest contiguous free <area> block is
  | <size>, which is less than the specified minimum of
  | <minimum>.
  |
  | If the free contiguous common storage blocks are too small,
  | the system may not be able to satisfy all storage obtain
  | requests, which could eventually lead to system failure.
  |
  | In the message text:
  |   <area>
  |     Indicates the area being reported on (CSA or ECSA).
  |  <size>
  |     Specifies the size of the indicated area, rounded up to
  |     the nearest 1K boundary.
  |  <minimum>
  |     The installation-specified or default minimum size of the
  |     largest contiguous free block of the indicated area,
  |     rounded up to the nearest 1K boundary.
  |
  | System Action: The system continues processing. However,
  | eventual action may need to be taken to ensure the system can
  | continue to satisfy storage obtain requests made by critical
  | applications.
  |
  | Operator Response: Please report this problem to the system
  | programmer.
  |
  | System Programmer Response: Review usage data provided by RMF
  | and other VSM health checks to determine whether any
  | applications are consuming large amount of common storage
  | abnormally. For example, the Five Highest Users reports
  | provided by the VSM_CSA_THRESHOLD check show the five highest
  | users of various common storage areas. It may be necessary to
  | cancel one or more of these applications to alleviate the
  | problem. Check the settings for (E)CSA in IEASYSxx to ensure
  | that appropriate sizes are specified for these common storage
  | areas.
  |
  | Problem Determination: N/A
  |
  | Source: Virtual Storage Manager
  |
  | Reference Documentation: z/OS MVS Initialization and Tuning
  | Reference
  |
  | Automation: N/A
  |
  | Detecting Module: IGVHCHK1
  |
  | Routing Code: See note 35
  |
  | Descriptor Code: 12 is the default set by this check.
  
  
  | IGVH504I Five Largest Contiguous Free Blocks of <area>
  |
  | Explanation: This message serves as a header for the five
  | largest contiguous free blocks report.
  |
  | For each of the reported common storage areas, this report
  | specifies the current sizes, starting addresses, and ending
  | addresses of the five largest contiguous free blocks in the
  | area.
  |
  | In the message text:
  |   <area>
  |     Indicates the area being reported on (CSA or ECSA).
  |
  | System Action: N/A
  |
  | Operator Response: N/A
  |
  | System Programmer Response: N/A
  |
  | Problem Determination: N/A
  |
  | Source: Virtual Storage Manager
  |
  | Reference Documentation: z/OS MVS Initialization and Tuning
  | Reference
  |
  | Automation: N/A
  |
  | Detecting Module: IGVHCHK1
  |
  | Routing Code: See note 35
  |
  | Descriptor Code: N/A
   KEYWORDS: HCHECKER/K
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UA68022 UA68023 UA68024 UA68025 UA68026

Modules/Macros

• IGVHCADC IGVHCHK1 IGVHCMSG IGVVSHEN IGVVSHJP
  

Fix information

• Fixed component name

  VSM - VIRT STOR

• Fixed component ID

  5752SC1CH

Applicable component levels

• R770 PSY UA68022

     UP13/02/27 P F302

• R780 PSY UA68023

     UP13/02/27 P F302

• R77J PSN UA68024

     UP13/02/27 P F302

• R78H PSN

     UP

• R78J PSN UA68026

     UP13/02/27 P F302

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.